File: directory_saver.rb

package info (click to toggle)
ruby-mechanize 2.7.6-1%2Bdeb10u1
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 1,480 kB
  • sloc: ruby: 11,380; makefile: 5; sh: 4
file content (77 lines) | stat: -rw-r--r-- 2,045 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
##
# Unlike Mechanize::FileSaver, the directory saver places all downloaded files
# in a single pre-specified directory.
#
# You must register the directory to save to before using the directory saver:
#
#   agent.pluggable_parser['image'] = \
#     Mechanize::DirectorySaver.save_to 'images'

class Mechanize::DirectorySaver < Mechanize::Download

  @directory = nil
  @options = {}

  ##
  # Creates a DirectorySaver subclass that will save responses to the given
  # +directory+. If +options+ includes a +decode_filename+ value set to +true+
  # then the downloaded filename will be ran through +CGI.unescape+ before
  # being saved. If +options+ includes a +overwrite+ value set to +true+ then
  # downloaded file will be overwritten if two files with the same names exist.

  def self.save_to directory, options = {}
    directory = File.expand_path directory

    Class.new self do |klass|
      klass.instance_variable_set :@directory, directory
      klass.instance_variable_set :@options, options
    end
  end

  ##
  # The directory downloaded files will be saved to.

  def self.directory
    @directory
  end

  ##
  # True if downloaded files should have their names decoded before saving.

  def self.decode_filename?
    @options[:decode_filename]
  end

  ##
  # Checks if +overwrite+ parameter is set to true

  def self.overwrite?
    @options[:overwrite]
  end

  ##
  # Saves the +body_io+ into the directory specified for this DirectorySaver
  # by save_to.  The filename is chosen by Mechanize::Parser#extract_filename.

  def initialize uri = nil, response = nil, body_io = nil, code = nil
    directory = self.class.directory

    raise Mechanize::Error,
      'no save directory specified - ' \
      'use Mechanize::DirectorySaver.save_to ' \
      'and register the resulting class' unless directory

    super

    @filename = CGI.unescape(@filename) if self.class.decode_filename?
    path = File.join directory, @filename

    if self.class.overwrite?
      save! path
    else
      save path
    end
  end

end