ftp_paradise 1.4.5

data/lib/ftp_paradise/connection/file_handling.rb

@@ -0,0 +1,174 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'ftp_paradise/connection/file_handling.rb'
+# =========================================================================== #
+module FtpParadise
+
+class Connection
+
+  # ========================================================================= #
+  # === create_remote_file                                        (touch tag)
+  #
+  # This "touches" a remote file.
+  # ========================================================================= #
+  def create_remote_file(
+      i,
+      be_verbose = be_verbose?
+    )
+    if i.is_a? Array
+      i.each {|entry| create_remote_file(entry, be_verbose) }
+    else
+      FileUtils.touch(i)
+      if be_verbose
+        notify_the_user_about(i, __method__)
+      end
+      upload_this_text_file(i, :be_quiet)
+      File.delete(i) if File.zero? i # And get rid of that file too.
+    end
+  end; alias touch create_remote_file # === touch
+
+  # ========================================================================= #
+  # === fancy_remote_listing
+  #
+  # This method will obtain the (remote) directory listing and then
+  # display it.
+  # ========================================================================= #
+  def fancy_remote_listing(
+      be_verbose = be_verbose?
+    )
+    update_file_listing
+    case be_verbose
+    when :be_silent,
+         :be_quiet
+      be_verbose = false
+    when :also_show_filesize
+      be_verbose = true
+    end
+    if be_verbose
+      e ('=' * 55)+' '+
+        FtpParadise.yellow('REMOTE FILES')+' '+('=' * 12)
+      if remote_directory_is_empty?
+        e "Remote `#{sdir(remote_path?)}` is empty."
+        e 'No files or directories can be found therein.'
+      else
+        e 'Remote content of `'+sdir(remote_path?)+'` is:'+N+N
+        e 'Index  Filename                           '\
+          '                                    Filesize'
+        show_remote_file_listing
+      end
+      cliner
+    end
+    return remote_directory_content
+  end
+
+  # ========================================================================= #
+  # === rename
+  #
+  # This method will attempt to rename a file on the remote server.
+  #
+  # Note that this is equivalent to moving a file, which is why the alias
+  # move_file can also be used. Any move-file actioni s simply a rename()
+  # action.
+  #
+  # The first argument passed to this method should be the name of an 
+  # existing (remote) file. The second second argument should be the
+  # new name of that file, or its full (remote) path.
+  #
+  # Also note that it seems as if the FTP protocol requires the full
+  # target location, otherwise errors such as the following might
+  # happen:
+  #
+  #   ftp.rb in `getresp': 451 Rename/move failure: Is a directory (Net::FTPTempError)
+  #
+  # The command used by .rename() command should be equivalent to this code:
+  #
+  #   SITE mv oldpath newpath
+  #
+  # Documentation for the functionality can be found here:
+  #
+  #   http://ruby-doc.org/stdlib/libdoc/net/ftp/rdoc/Net/FTP.html#method-i-rename
+  #        
+  # ========================================================================= #
+  def rename(
+      from,
+      to,
+      be_verbose = be_verbose?
+    )
+    to = to.first if to.is_a? Array
+    if from.is_a? Array # Support batch-transfer.
+      from.each {|entry| rename(entry, to) }
+    else
+      from = rds(from)
+      to   = rds(to)
+      begin
+        ftp_object?.rename(from, to)
+        if be_verbose
+          opnn; e "Renamed the remote entry `#{sfancy(from)}"\
+                  "` to `#{sfancy(to)}`."
+        end
+      rescue Net::FTPTempError => error
+        e "An error (#{simp('Net::FTPTempError')}) occurred "\
+          "in the method #{simp('rename()')}:"
+        pp error
+      end
+    end
+  end; alias rename_file        rename # === rename_file
+       alias move_file          rename # === move_file
+       alias rename_remote_file rename # === rename_remote_file
+
+  # ========================================================================= #
+  # === update_remote_file_listing
+  # ========================================================================= #
+  def update_remote_file_listing(
+      be_verbose = be_verbose?
+    )
+    case be_verbose
+    when :be_quiet
+      be_verbose = false
+    end
+    if is_connected?
+      begin
+        # =================================================================== #
+        # Make use of a method that will skip a few entries, such as
+        # "." or "..".
+        # =================================================================== #
+        @internal_hash[:raw_entries] = return_slightly_sanitized_entries_ignoring_a_few
+      rescue Exception => error
+        opnn; e swarn('An error happened in the method '\
+                'update_remote_file_listing(), at '\
+                'line: '+__LINE__.to_s+'.')
+        pp error.class
+        pp error
+      end
+    else
+      if be_verbose
+        opnn; e 'Can not update the remote file listing '\
+                'because we are not connected.'
+      end
+    end
+  end; alias update_file_listing update_remote_file_listing # === update_file_listing
+       alias update_raw_listing  update_remote_file_listing # === update_raw_listing
+       alias get_listing         update_remote_file_listing # === get_listing
+       alias get_remote_listing  update_remote_file_listing # === get_remote_listing
+       alias update              update_remote_file_listing # === update
+
+  # ========================================================================= #
+  # === does_this_remote_file_exist?
+  # ========================================================================= #
+  def does_this_remote_file_exist?(i)
+    i = File.basename(i).strip
+    array = return_all_remote_files
+    if array.is_a?(Array) and
+       array.first.is_a?(String)
+      array.map! {|entry|
+        entry = FtpParadise::Entry.new(entry)
+      }
+      array.select! {|entry| entry.is_a_file? }
+      array.map! {|entry| entry.filename? }
+    end
+    return array.include?(i)
+  end
+
+end; end

data/lib/ftp_paradise/connection/ftp_object.rb

@@ -0,0 +1,21 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'ftp_paradise/connection/ftp_object.rb'
+# =========================================================================== #
+module FtpParadise
+
+class Connection
+
+  # ========================================================================= #
+  # === ftp_object?
+  # ========================================================================= #
+  def ftp_object?
+    @ftp_object
+  end; alias net_ftp?   ftp_object? # === net_ftp?
+       alias ftp?       ftp_object? # === ftp?
+       alias ftp        ftp_object? # === ftp?
+       alias ftp_object ftp_object? # === ftp_object
+
+end; end

data/lib/ftp_paradise/connection/initialize.rb

@@ -0,0 +1,88 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'ftp_paradise/connection/initialize.rb'
+# =========================================================================== #
+module FtpParadise
+
+class Connection
+
+  require 'ftp_paradise/base/prototype.rb'
+  include ::FtpParadise::Base
+
+  require 'ftp_paradise/connection/constants.rb' # ← For the constant RUN_ALREADY
+  require 'ftp_paradise/connection/ftp_object.rb'
+  require 'ftp_paradise/connection/reset.rb'
+  require 'ftp_paradise/connection/run.rb'
+  require 'ftp_paradise/connection/set_input.rb'
+  require 'ftp_paradise/connection/remote_url.rb'
+  require 'ftp_paradise/connection/use_default_dataset.rb'
+
+  # ========================================================================= #
+  # === initialize
+  #
+  # The first argument to this method should be the remote host's URL.
+  # ========================================================================= #
+  def initialize(
+      i           = ARGV,
+      run_already = RUN_ALREADY
+    )
+    reset
+    # ======================================================================= #
+    # - If we pass in a Hash as the first argument, then we will use
+    #   set_data(), otherwise we will set individually it all individually.
+    # ======================================================================= #
+    if i.is_a? Hash
+      set_data(i)
+    else
+      set_input(i)
+    end
+    case i
+    when :dont_run_yet,
+         :do_not_run_yet
+      run_already = false
+    end
+    case run_already
+    when :dont_run_yet
+      run_already = false
+    end
+    if run_already.is_a? Hash
+      _ = run_already
+      if _.has_key? :connect_to_this_host
+        set_this_host(
+          _.delete(:connect_to_this_host)
+        )
+      end
+      run_already = RUN_ALREADY # Restore to the default in this case.
+    end
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # === :do_not_run_yet
+      # ===================================================================== #
+      when :do_not_run_yet
+        run_already = false
+      # ===================================================================== #
+      # The "default" dataset defaults to my personal FTP login dataset.
+      # ===================================================================== #
+      when :use_default_dataset,
+           :default_dataset,
+           :default
+        use_default_dataset
+      end
+    end
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === initialize_a_new_net_ftp_object_with_this_remote_url
+  #
+  # This method is the only one allowed to create a new Net::FTP instance.
+  # ========================================================================= #
+  def initialize_a_new_net_ftp_object_with_this_remote_url(i)
+    @ftp_object = Net::FTP.new(i) # ftp = Net::FTP.new(YAML.load_file(ENV['FTP_YAML_FILE'])['freehosting']['url'])
+  end; alias initialize_a_new_net_ftp_object initialize_a_new_net_ftp_object_with_this_remote_url # === initialize_a_new_net_ftp_object
+
+end; end

data/lib/ftp_paradise/connection/initialize_a_new_net_ftp_object_with_this_url.rb

@@ -0,0 +1,20 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'ftp_paradise/connection/initialize_a_new_net_ftp_object_with_this_url.rb'
+# =========================================================================== #
+module FtpParadise
+
+class Connection
+
+  require 'net/ftp'
+
+  # ========================================================================= #
+  # === initialize_a_new_net_ftp_object_with_this_url
+  # ========================================================================= #
+  def initialize_a_new_net_ftp_object_with_this_url(this_url)
+    @ftp_object = Net::FTP.new(this_url)
+  end
+
+end; end

data/lib/ftp_paradise/connection/is_connected.rb

@@ -0,0 +1,46 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'ftp_paradise/connection/is_connected.rb'
+# =========================================================================== #
+module FtpParadise
+
+class Connection
+
+  require 'ftp_paradise/connection/ftp_object.rb'
+
+  # ========================================================================= #
+  # === closed?
+  #
+  # Returns true if the connection to our remote host is closed.
+  # ========================================================================= #
+  def closed?
+    begin
+      ftp_object?.closed? if ftp_object?
+    rescue Net::FTPConnectionError
+      true
+    end
+  end
+
+  # ========================================================================= #
+  # === open?
+  #
+  # This method can also be used to determine whether we are still
+  # connected to the remote site.
+  #
+  # This method will return true if the connection is open.
+  #
+  # If you want to determine whether you are still connected to the
+  # remote host, you can alias use the alias are_we_connected? - it
+  # may read nicer.
+  # ========================================================================= #
+  def open?
+    !closed?
+  end; alias are_we_connected? open? # === are_we_connected?
+       alias is_connected?     open? # === is_connected?
+       alias is_connected      open? # === is_connected
+       alias connected?        open? # === connected?
+       alias did_we_connect?   open? # === did_we_connect?
+
+end; end

data/lib/ftp_paradise/connection/misc.rb

@@ -0,0 +1,474 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'ftp_paradise/connection/misc.rb'
+# =========================================================================== #
+module FtpParadise
+
+class Connection
+
+  require 'ftp_paradise/connection/directory_handling.rb'
+  require 'ftp_paradise/connection/download.rb'
+  require 'ftp_paradise/toplevel_methods/clear_user_dataset.rb'
+
+  # ========================================================================= #
+  # === dataset?
+  # ========================================================================= #
+  def dataset?
+    FtpParadise.data?
+  end
+
+  # ========================================================================= #
+  # === raw_list
+  # ========================================================================= #
+  def raw_list(i = '*')
+    ftp_object?.list(i)
+  end
+
+  # ========================================================================= #
+  # === return_slightly_sanitized_entries_ignoring_a_few
+  # ========================================================================= #
+  def return_slightly_sanitized_entries_ignoring_a_few(
+      i = '*'
+    )
+    ftp_object?.list(i).reject {|entry|
+      entry.to_s.strip.empty? or entry.end_with?(' .') or entry.end_with?(' ..')
+    }.map {|line|
+      if line.end_with? ':' # <- Some remote FTP-hosts use ':' for a directory.
+        line[-1,1] = '/'
+      end
+      line
+    }
+  end; alias list return_slightly_sanitized_entries_ignoring_a_few # === list
+
+  # ========================================================================= #
+  # === nlst?
+  #
+  # Returns an array of filenames in the remote directory. This will
+  # yield less information than the "ls -l" variant, aka list().
+  #
+  # Documentation:
+  #
+  #   https://ruby-doc.org/stdlib/libdoc/net/ftp/rdoc/Net/FTP.html#method-i-nlst
+  #
+  # ========================================================================= #
+  def nlst?
+    ftp_object?.nlst
+  end; alias nlst nlst? # === nlst
+
+  # ========================================================================= #
+  # === list?                                            (list tag)
+  #
+  # Returns an array of file information in the directory (the output
+  # is like `ls -l`). If a block is given, it iterates through the
+  # listing.
+  # ========================================================================= #
+  def list?(i = '*')
+    # ======================================================================= #
+    # We will also sanitize this a bit.
+    # ======================================================================= #
+    @internal_hash[:raw_entries] = return_slightly_sanitized_entries_ignoring_a_few
+    return @internal_hash[:raw_entries] # And return the result here.
+  end; alias ls                   list? # === ls
+       alias populate_raw_entries list? # === populate_raw_entries
+
+  # ========================================================================= #
+  # === passive=
+  # ========================================================================= #
+  def passive=(i = true)
+    if ftp_object?
+      ftp_object?.passive = i
+    else
+      e 'No ftp-object has been instantiated yet.'
+    end
+  end
+
+  # ========================================================================= #
+  # === list_content                                       (list tag, ls tag)
+  #
+  # List available data.
+  # ========================================================================= #
+  def list_content
+    report_current_remote_dir
+    result = list?
+    cliner { pp result }
+    _ = result.first[0, 1]
+    case _
+    when 'd'
+      e "Directory #{result.first}"
+      # @array_directories
+    when 'l'
+      e "Link #{result.first}"
+    else
+      e "File #{result.first}"
+    end
+  end; alias do_list_content list_content # === list
+       alias listing?        list_content # === listing?
+
+  # ========================================================================= #
+  # === file_listing_as_entries?
+  # ========================================================================= #
+  def file_listing_as_entries?
+    _ = remote_file_listing?
+    if _
+      return _.map {|entry| FtpParadise::Entry.new(entry) }
+    end
+    return nil
+  end
+
+  # ========================================================================= #
+  # === empty?
+  # ========================================================================= #
+  def empty?
+    array_remote_files.empty?
+  end
+
+  # ========================================================================= #
+  # === find_matches_for
+  #
+  # This method will return an array of files and directories that match
+  # to the provided input (which we will assume to be a query).
+  # ========================================================================= #
+  def find_matches_for(i)
+    i = i.delete '*'
+    update_file_listing
+    _ = return_remote_directory_content.map(&:first)
+    _ = _.grep(/#{i}/)
+    return _
+  end
+
+  # ========================================================================= #
+  # === output_sorted_by_time
+  #
+  # This method will output the remote content in a time-sorted manner.
+  # ========================================================================= #
+  def output_sorted_by_time
+    _ = sanitized_remote_directory_content?
+    sorted_result = _.sort_by {|array|
+      array.last
+    }.reverse
+    sorted_result.each_with_index {|array, index| index += 1
+      file_or_directory = array[1]
+      name_of_the_file = array.first
+      if file_or_directory == 'directory'
+        name_of_the_file << '/' unless name_of_the_file.end_with? '/'
+      end
+      index = simp( (index.to_s+') ').rjust(6))
+      e index+sfancy(name_of_the_file)
+    }
+  end
+
+  # ========================================================================= #
+  # === last_response
+  #
+  # The server's last response is available through this method here.
+  # ========================================================================= #
+  def last_response
+    ftp_object?.last_response
+  end; alias last_response?        last_response # === last_response?
+       alias last_server_response? last_response # === last_server_response?
+
+  # ========================================================================= #
+  # === raw_entries?
+  # ========================================================================= #
+  def raw_entries?
+    @internal_hash[:raw_entries]
+  end; alias remote_file_listing? raw_entries? # === remote_file_listing?
+       alias file_listing?        raw_entries? # === file_listing?
+       alias raw_listing?         raw_entries? # === raw_listing?
+
+  # ========================================================================= #
+  # === return_all_remote_files
+  #
+  # This method will return an Array with all remote files.
+  # ========================================================================= #
+  def return_all_remote_files
+    results = nil
+    if file_listing?
+      results = file_listing?.select {|entry|
+        if entry.is_a?(String) and !entry.empty?
+          entry = FtpParadise::Entry.new(entry)
+        end
+        entry.is_a_file?
+      }
+    end
+    return results
+  end; alias remote_file_listing?       return_all_remote_files # === remote_file_listing?
+       alias all_remote_files?          return_all_remote_files # === all_remote_files?
+       alias array_remote_files         return_all_remote_files # === array_remote_files
+       alias return_remote_files        return_all_remote_files # === return_remote_files
+       alias return_remote_file_listing return_all_remote_files # === return_remote_file_listing
+       alias remote_files?              return_all_remote_files # === remote_files
+       alias files?                     return_all_remote_files # === files?
+
+  # ========================================================================= #
+  # === status?
+  #
+  # Report the status here. This is equivalent to the STAT command.
+  # ========================================================================= #
+  def status?
+    ftp_object?.status.to_s
+  end; alias status status? # === status
+
+  # ========================================================================= #
+  # === return_local_directories
+  #
+  # Return all local directories.
+  # ========================================================================= #
+  def return_local_directories
+    Dir['*'].select {|entry| File.directory?(entry) }
+  end
+
+  # ========================================================================= #
+  # === modification_time_of?
+  #
+  # This method will give us the last modification time of a remote
+  # file, by issuing the mdtm() command.
+  #
+  # The format returned will be in YYYMMDDhhmmss.
+  #
+  # If you require a parsed Time instance, you can use mtime()
+  # on the ftp object.
+  #
+  # Symbols could also be used, such as "pp modification_time_of? :a".
+  # ========================================================================= #
+  def modification_time_of?(i)
+    if i.is_a? Array
+      i.each {|entry| modification_time_of(entry) } # <- Recursive call.
+    else
+      ftp_object?.mdtm(i.to_s)
+    end
+  end; alias mdtm modification_time_of? # === mdtm
+
+  # ========================================================================= #
+  # === set_file
+  #
+  # Use only this to modify the @file variable.
+  # ========================================================================= #    
+  def set_file(i = nil)
+    @internal_hash[:file] = i
+  end
+
+  # ========================================================================= #
+  # === is_file?
+  #
+  # This method will check whether the input is a file or not.
+  # It will call the method .is_directory?()
+  # ========================================================================= #
+  def is_file?(i)
+    !is_a_directory?(i)
+  end
+
+  # ========================================================================= #
+  # === logged_in?
+  # ========================================================================= #
+  def logged_in?
+    ftp_object?.instance_variable_get '@logged_in'
+  end
+
+  # ========================================================================= #
+  # === available_hosts?
+  # ========================================================================= #
+  def available_hosts?
+    @internal_hash[:array_available_hosts]
+  end; alias array_available_hosts  available_hosts? # === array_available_hosts
+       alias array_available_hosts? available_hosts? # === array_available_hosts?
+
+  # ========================================================================= #
+  # === open_timeout?
+  # ========================================================================= #
+  def open_timeout?
+    ftp_object?.open_timeout.to_s if ftp_object?.respond_to? :open_timeout
+  end
+
+  # ========================================================================= #
+  # === feedback_login_hosts
+  #
+  # Feedback all available login hosts, based on the information stored
+  # in the Array @array_available_hosts.
+  # ========================================================================= #
+  def feedback_login_hosts
+    opnn; e 'The followings hosts are easily available:'
+    e
+    available_hosts?.each { |host| e "  - #{sfancy(host)}" }
+    e
+  end
+
+  # ========================================================================= #
+  # === help?
+  # ========================================================================= #
+  def help?
+    ftp_object?.help
+  end; alias help help? # === help
+
+  # ========================================================================= #
+  # === close                                                     (close tag)
+  #
+  # Close the connection here.
+  #
+  # Further operations will be impossible until a new connection
+  # is opened up again, via connect().
+  # ========================================================================= #
+  def close
+    ftp_object?.close
+  end
+
+  # ========================================================================= #
+  # === mlsd
+  # ========================================================================= #
+  def mlsd(i)
+    ftp_object?.mlsd(i)
+  end
+
+  # ========================================================================= #
+  # === site
+  # ========================================================================= #
+  def site(i = nil)
+    ftp_object?.site(i)
+  end
+
+  # ========================================================================= #
+  # === file?
+  # ========================================================================= #
+  def file?
+    @internal_hash[:file]
+  end
+
+  # ========================================================================= #
+  # === system_command
+  #
+  # This will return system information from the remote host.
+  #
+  # Stuff like:
+  #   UNIX Type: L8
+  # ========================================================================= #
+  def system_command
+    ftp_object?.system
+  end; alias system system_command # === system
+
+  # ========================================================================= #
+  # === report_host_port_user_name_and_password
+  # ========================================================================= #
+  def report_host_port_user_name_and_password
+    ljust = 15
+    e '- Now trying to log in to '+simp(host?)+
+      ' (Port: '+swarn(port?)+') using:'
+    e '  '+('Login Name: ').ljust(ljust)+sfancy(user_name?)
+    e '  '+('Password: ').ljust(ljust)+sfancy(password?)
+  end
+
+  # ========================================================================= #
+  # === opnn
+  # ========================================================================= #
+  def opnn
+    super(NAMESPACE)
+  end
+
+  # ========================================================================= #
+  # === read_timeout=
+  #
+  # Setter-method for the #read_timeout attribute.
+  # ========================================================================= #
+  def read_timeout=(i)
+    ftp_object?.read_timeout = i
+  end
+
+  # ========================================================================= #
+  # === size?
+  #
+  # This method will return the size of the given (remote) filename.
+  # ========================================================================= #
+  def size?(i)
+    ftp_object?.size(i)
+  end; alias size size? # === size
+
+  # ========================================================================= #
+  # === padding?
+  # ========================================================================= #
+  def padding?
+    @internal_hash[:padding]
+  end
+
+  # ========================================================================= #
+  # === be_verbose?
+  # ========================================================================= #
+  def be_verbose?
+    @internal_hash[:be_verbose]
+  end
+
+  # ========================================================================= #
+  # === server_welcome_message?
+  #
+  # This method will return the remote server's welcome message.
+  # ========================================================================= #
+  def server_welcome_message?
+    ftp_object?.welcome
+  end; alias welcome? server_welcome_message? # === welcome?
+       alias welcome  server_welcome_message? # === welcome
+
+  # ========================================================================= #
+  # === noop
+  # ========================================================================= #
+  def noop
+    ftp_object?.noop
+  end
+
+  # ========================================================================= #
+  # === last_response_code?
+  #
+  # Return the server's last response code.
+  # ========================================================================= #
+  def last_response_code?
+    ftp_object?.last_response_code
+  end; alias last_response_code last_response_code? # === last_response_code
+
+  # ========================================================================= #
+  # === quit                                                       (quit tag)
+  #
+  # Use this to quit (and disconnect) from the FTP Connection again.
+  # ========================================================================= #
+  def quit
+    begin
+      if is_connected?
+        if ftp_object?
+          FtpParadise.clear_user_dataset
+          ftp_object?.quit
+        end
+      end
+    rescue Exception => error
+      opnn; e "An error happened in the method #{sfancy(__method__)}()"
+      pp error
+    end
+  end
+
+  # ========================================================================= #
+  # === []
+  # ========================================================================= #
+  def [](i)
+    update_file_listing
+    if i =~ /^\d+$/ # If is a number.
+      i = remote_file_listing.size if i.to_i > remote_file_listing.size
+      i = remote_file_listing[i.to_i - 1].first
+    end
+    return i
+  end
+
+  # ========================================================================= #
+  # === sendcmd
+  #
+  # Sends a command and returns the response of the server.
+  #
+  # This has to be rescued, because there are lots of different errors
+  # possible.
+  # ========================================================================= #
+  def sendcmd(i)
+    begin
+      ftp_object?.sendcmd(i)
+    rescue Exception => error
+      pp error
+      e '(This error may be due to the remote file not existing.)'
+    end
+  end
+
+end; end