=begin rdoc

= DOWNLOAD.RB

*Author*::      Tamara Temple <tamara@tamaratemple.com>
*Since*::       2013-05-27
*Copyright*::   (c) 2013 Tamara Temple Web Development
*License*::     MIT
  
=end

require 'mechanize'

module Scrapers

  module Download

    def self.download(url,dir=".",overwrite=false)
      # need a new agent each time!
      agent = Mechanize.new
      agent.pluggable_parser.default = Mechanize::Download
      @dir = validate_directory(dir)
      dl = agent.get(url)
      Dir.chdir(@dir) do |dir|
        if overwrite
          dl.save!(dl.filename)
        else
          dl.save()
        end
        
      end
      File.join(@dir,dl.filename)
    end

    def self.validate_directory(d)
      raise "#{d} is not a writable directory!" unless File.directory?(d) and File.writable?(d)
      d
    end

  end
  
end