ftp_paradise 1.4.5 → 1.5.3

data/lib/ftp_paradise/interactive_ftp/main_loop.rb

@@ -1,51 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'ftp_paradise/interactive_ftp/main_loop.rb'
-# =========================================================================== #
-module FtpParadise
-
-class InteractiveFtp # === FtpParadise::InteractiveFtp
-
-  # ========================================================================= #
-  # === enter_main_loop
-  # ========================================================================= #
-  def enter_main_loop
-    # ======================================================================= #
-    # Enter the remote directory htdocs if we are on ftpupload.net
-    # or on a similar host..
-    # ======================================================================= #
-    if remote_url?.include?('ftpupload.net')
-      remote_cd 'htdocs', :be_verbose
-    elsif remote_url?.include?('shevy.bplaced.net')
-      remote_cd 'www', :be_verbose
-    end
-    check_commandline_arguments # <- This will also query the menu() method.
-    show_welcome_message
-    display_prompt
-    loop {
-      begin
-        # =================================================================== #
-        # Obtain the user input:
-        # =================================================================== #
-        obtain_user_input
-        # =================================================================== #
-        # Pass the user input into the menu interface:
-        # =================================================================== #
-        result = menu
-        result = result.first if result.is_a? Array
-        case result
-        when *ARRAY_VALID_OPTIONS_FOR_EXITING_THE_SHELL, :break
-          break
-        when :exit
-          exit
-        end
-      rescue Interrupt
-        e 'In order to quit, please use "'+
-          steelblue('q')+'" instead.'
-      end
-    }
-  end; alias enter_loop enter_main_loop # === enter_loop
-
-end; end

data/lib/ftp_paradise/interactive_ftp/misc.rb

@@ -1,208 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'ftp_paradise/interactive_ftp/misc.rb'
-# =========================================================================== #
-module FtpParadise
-
-class InteractiveFtp
-
-  require 'ftp_paradise/interactive_ftp/directory_handling.rb'
-
-  require 'ftp_paradise/toplevel_methods/determine_user_dataset_from_this_hash.rb'
-
-  # ========================================================================= #
-  # === set_editor
-  # ========================================================================= #
-  def set_editor(
-      i, be_verbose = true
-    )
-    i = i.first if i.is_a? Array
-    if be_verbose
-      opnn; e "Now using the editor called `#{sfancy(i)}`."
-    end
-    @use_this_editor = i
-  end
-
-  # ========================================================================= #
-  # === report_which_editor_is_in_use
-  # ========================================================================= #
-  def report_which_editor_is_in_use
-    opnn; e "The editor in use is `#{sfancy(@use_this_editor)}`."
-  end
-
-  # ========================================================================= #
-  # === open_this_file_in_editor           (edit tag, editor tag, open tag)
-  #
-  # If you pass as first argument to this method the string 'ALL', we
-  # will try to open the (local) project files in your editor.
-  #
-  # To test this, do:
-  #
-  #   open ALL
-  #   open YAML
-  #
-  # ========================================================================= #
-  def open_this_file_in_editor(
-      this_file = @file
-    )
-    this_file = ARRAY_PROJECT_FILES if this_file.nil?
-    if this_file.is_a? Array
-      this_file.each {|entry| open_this_file_in_editor(entry) }
-    else
-      this_file = this_file.to_s
-      if this_file == 'TODO'
-        this_file = ARRAY_PROJECT_FILES.select {|entry| entry.include? 'TODO' }[0]
-      end
-      if this_file.to_s =~ /^\d+$/ # If only numbers were given.
-        this_file = Dir['*'].sort[this_file.to_i - 1]
-      end
-      this_file = NAME_OF_THIS_FILE if this_file.empty?
-      if this_file == 'ALL' and ! File.exist?('ALL')
-        open_this_file_in_editor(ARRAY_PROJECT_FILES)
-      elsif this_file == 'YAML' and ! File.exist?('YAML')
-        open_this_file_in_editor(YAML_FILE)
-      else
-        _ = @use_this_editor+" #{this_file}"
-        if File.exist?(this_file) && File.file?(this_file)
-          unless has_unwanted_file_suffix?(this_file)
-            e 'Loading '+sfile(this_file)+' in editor '+
-              'now as '+simp('USE_THIS_EDITOR')+' was set '+
-              'to true:'
-            e '  '+_+' &'
-            `#{_}`
-          end
-          set_file(this_file) # Since 24.12.2011 we also assign it.
-        else
-          e swarn('But the file `')+sfile(this_file)+
-            swarn('` does not exist.')
-        end
-      end
-    end
-  end; alias open_in_editor open_this_file_in_editor # === open_in_editor
-
-  # ========================================================================= #
-  # === determine_user_dataset_from_this_hash
-  #
-  # This method can set relevant entries from an input Hash.
-  # ========================================================================= #
-  def determine_user_dataset_from_this_hash(
-      i,
-      optional_use_this_entry = :default
-    )
-    if optional_use_this_entry
-      case optional_use_this_entry
-      # ===================================================================== #
-      # === :default
-      # ===================================================================== #
-      when :default
-        optional_use_this_entry = :bplaced
-      end
-    end
-    FtpParadise.determine_user_dataset_from_this_hash(i)
-  end
-
-  # ========================================================================= #
-  # === set_password
-  # ========================================================================= #
-  def set_password(
-      i, be_verbose = be_verbose?
-    )
-    i = i.to_s
-    if be_verbose
-      e "Setting password to #{sfancy(i)} now."
-    end
-    FtpParadise.set_password(i)
-  end
-
-  # ========================================================================= #
-  # === pass_commandline_arguments_into_the_menu
-  # ========================================================================= #
-  def pass_commandline_arguments_into_the_menu
-    menu(@commandline_arguments)
-  end
-
-  # ========================================================================= #
-  # === set_port
-  #
-  # Use this method to set the port.
-  # ========================================================================= #
-  def set_port(
-      i = 21, be_verbose = false
-    )
-    if be_verbose
-      e "Setting port to #{sfancy(i)} now."
-    end
-    ftp?.set_port(i)
-  end
-
-  # ========================================================================= #
-  # === remote_url?
-  # ========================================================================= #
-  def remote_url?
-    FtpParadise.remote_url?
-  end; alias remote_host? remote_url? # === remote_host?
-
-  # ========================================================================= #
-  # === remote_remove_file
-  # ========================================================================= #
-  def remote_remove_file(
-      i = @first_argument
-    )
-    if i.is_a? Array
-      i.each {|entry| remote_remove_file(entry) }
-    else
-      e "Trying to remove `#{sfile(i)}` next:"
-      @ftp.delete(i)
-    end
-  end; alias remote_remove_files remote_remove_file # === remote_remove_files
-
-  # ========================================================================= #
-  # === display_file
-  #
-  # Use this method to display a file in question.
-  # ========================================================================= #
-  def display_file(i)
-    if File.exist? i
-      _ = File.readlines(i).join
-      e _
-    else
-      ewarn "File #{sfile(i)} does not exist."
-    end
-  end
-
-  # ========================================================================= #
-  # === report_version
-  # ========================================================================= #
-  def report_version
-    e sfancy(FtpParadise::VERSION)
-  end
-
-  # ========================================================================= #
-  # === all_arguments?
-  #
-  # The alias a? may be an easier wrapper over @all_arguments.
-  # ========================================================================= #
-  def all_arguments?
-    @all_arguments
-  end; alias a? all_arguments? # === a?
-
-  # ========================================================================= #
-  # === try_to_chmod_this_remote_file
-  # ========================================================================= #
-  def try_to_chmod_this_remote_file(
-      filename, chmod_value_to_use = '0777'
-    )
-    e "Trying to chmod the remote file #{filename} next."
-    ftp?.sendcmd("SITE CHMOD #{chmod_value_to_use} #{filename}")
-  end
-
-  # ========================================================================= #
-  # === password?
-  # ========================================================================= #
-  def password?
-    FtpParadise.password?
-  end
-
-end; end

data/lib/ftp_paradise/interactive_ftp/mode.rb

@@ -1,124 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'ftp_paradise/interactive_ftp/mode.rb'
-# =========================================================================== #
-module FtpParadise
-
-class InteractiveFtp # === FtpParadise::InteractiveFtp
-
-  # ========================================================================= #
-  # === use_binary_mode
-  #
-  # This enables use the binary mode.
-  # ========================================================================= #
-  def use_binary_mode(
-      be_verbose = false
-    )
-    case be_verbose
-    when :be_quiet
-      be_verbose = false
-    when :be_verbose
-      be_verbose = true
-    end
-    e 'Using binary mode now.' if be_verbose
-    set_mode :binary
-  end; alias set_binary use_binary_mode # === set_binary
-
-  # ========================================================================= #
-  # === set_mode
-  #
-  # Set the mode here. We default to :ascii mode.
-  #
-  # There are only two valid modes:
-  #
-  #   :ascii
-  #   :binary
-  #
-  # ========================================================================= #
-  def set_mode(
-      i = :ascii
-    )
-    @mode = i
-    ftp?.set_transfer_mode(
-      @mode, :be_quiet # Cascade the variable down into ftp_lib.rb.
-    )
-  end
-
-  # ========================================================================= #
-  # === do_use_binary_mode
-  # ========================================================================= #
-  def do_use_binary_mode
-    use_binary_mode(:be_quiet)
-  end
-
-  # ========================================================================= #
-  # === change
-  #
-  # This method can be used to change the main transfer mode.
-  # ========================================================================= #
-  def change(i)
-    case i
-    # ======================================================================= #
-    # === mode
-    # ======================================================================= #
-    when 'mode' # Change the mode that we use.
-      use_binary_mode
-    end
-  end
-
-  # ========================================================================= #
-  # === set_run_mode
-  #
-  # This will set the run-mode. The run-mode can be either :standalone or
-  # :connected.
-  # ========================================================================= #
-  def set_run_mode(
-      i = :standalone
-    )
-    @run_mode = i
-  end
-
-  # ========================================================================= #
-  # === toggle_modes
-  # ========================================================================= #
-  def toggle_modes
-    if @mode == :ascii
-      set_mode :binary
-    else
-      set_mode :ascii
-    end
-    e mode?.to_s
-  end
-
-  # ========================================================================= #
-  # === use_ascii_mode
-  # ========================================================================= #
-  def use_ascii_mode(be_verbose = false)
-    e 'Using ascii mode now.' if be_verbose
-    set_mode :ascii
-  end
-
-  # ========================================================================= #
-  # === mode?
-  #
-  # @mode is a Symbol, hence we will not apply .to_s on it.
-  # ========================================================================= #
-  def mode?
-    return @mode
-  end
-
-  # ========================================================================= #
-  # === set_passive
-  # ========================================================================= #
-  def set_passive(
-      be_verbose = false
-    )
-    if be_verbose
-      e 'Enabling passive mode for FTP.'
-    end
-    ftp?.passive = true
-  end
-
-end; end

data/lib/ftp_paradise/interactive_ftp/readline.rb

@@ -1,113 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# The Readline component will belong to class FtpParadise::InteractiveFtp.
-#
-# It would  not make any sense to use it elsewhere within the FtpParadise
-# project, as we don't have other interactive elements elsewhere.
-# =========================================================================== #
-# require 'ftp_paradise/interactive_ftp/readline.rb'
-# =========================================================================== #
-module FtpParadise
-
-class InteractiveFtp # === FtpParadise::Interactive
-
-  begin
-    require 'readline'
-  rescue LoadError; end # Silent rescue.
-
-  # ========================================================================= #
-  # === use_readline?
-  # ========================================================================= #
-  def use_readline?
-    @use_readline
-  end; alias do_we_use_readline? use_readline? # === do_we_use_readline?
-
-  # ========================================================================= #
-  # === do_not_use_readline
-  # ========================================================================= #
-  def do_not_use_readline
-    @use_readline = false
-  end
-
-  # ========================================================================= #
-  # === enable_readline
-  # ========================================================================= #
-  def enable_readline
-    @use_readline = true
-    try_to_use_readline
-  end
-
-  # ========================================================================= #
-  # === try_to_use_readline
-  #
-  # This method ought to be called before we invoke the method menu().
-  # ========================================================================= #
-  def try_to_use_readline
-    if @use_readline
-      begin
-        require 'readline' # Using readline since August 2011.
-        setup_readline_completion
-      rescue LoadError
-        # =================================================================== #
-        # In this case the user can not use the readline-module.
-        # =================================================================== #
-        do_not_use_readline
-      end
-    end
-  end; alias consider_using_the_readline_module try_to_use_readline # === consider_using_the_readline_module
-
-  # ========================================================================= #
-  # === setup_readline_completion
-  #
-  # Call this method to invoke completion support.
-  # ========================================================================= #
-  def setup_readline_completion
-    Readline.completion_case_fold = true # Ignore case on tab-completion.
-    Readline.completer_word_break_characters = "\n"
-    Readline.completion_append_character = ' '
-    # ======================================================================= #
-    # Act on Readline's completion functionality here.         (readline tag)
-    #
-    # We will respond to these events specifically:
-    #
-    #   - rcd
-    #   - cd
-    #   - upload
-    #   - download
-    #
-    # ======================================================================= #
-    Readline.completion_proc = proc {|input|
-      _ = []
-      case input # case tag
-      # ===================================================================== #
-      # To test it, do:
-      #   rcd AUS<TAB>
-      # ===================================================================== #
-      when /^rcd/,
-           /^rcd /,
-           /^rc/,
-           'rchange_dir',
-           'lcd',
-           'remote_change_directory'
-        result = @_.return_directories # This will return the remote directories only.
-        _ << result.map {|entry| input+' '+entry}
-      # ===================================================================== #
-      # === cd
-      # ===================================================================== #
-      when /^cd/,/^cd / # Fetch only directories.
-        _ << @_.return_local_directories
-      when /^upload/    # Act on upload.
-        return_local_files.each { |array| _ << array }
-      when /^download/  # Act on download.
-        @_.array_file_listing.each { |array| _ << array.first }
-      else # Default.
-        # _ << return_local_files # Disabled in June 2014 because it gives completions to things I did not ask for.
-      end
-      _ = _.flatten
-      _ # Return it here finally.
-    }
-  end
-
-end; end

data/lib/ftp_paradise/interactive_ftp/remove.rb

@@ -1,97 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'ftp_paradise/interactive_ftp/remove.rb'
-# =========================================================================== #
-module FtpParadise
-
-class InteractiveFtp
-
-  # ========================================================================= #
-  # === remove_local
-  # ========================================================================= #
-  def remove_local(i)
-    delete(i)
-  end
-
-  # ========================================================================= #
-  # === remove_remote_directory
-  #
-  # Use this method to remove a remote directory.
-  # ========================================================================= #
-  def remove_remote_directory(i)
-    e "Removing remote directory `#{sdir(i)}` next."
-    # ======================================================================= #
-    # Delegate to ftp?. :force_remove so we remove even non-empty directories.
-    # ======================================================================= #
-    ftp?.remove_directory(i, :force_remove)
-  end
-
-  # ========================================================================= #
-  # === remote_remove
-  #
-  # Use this if you wish to remove a remote file or a remote directory.
-  # ========================================================================= #
-  def remote_remove(i)
-    if i.is_a? Array
-      i.each {|entry| remote_remove(entry) }
-    else
-      i = i.to_s.strip # Added as of July 2014.
-      i = File.basename(i) if i.include? '/'
-      # ===================================================================== #
-      # The user may input numbers. If the input is a number, we will try to
-      # find the corresponding entry - but only if no remote directory or
-      # remote file exists with that name. Some directories may be named,
-      # e. g. "123456".
-      # ===================================================================== #
-      unless this_remote_entry_exists? i
-        i = convert_number_to_file(i) if i =~ /^\d+$/
-      end
-      # ===================================================================== #
-      # Next check for user input. If the user did input a '*', then we
-      # will expand that.
-      # ===================================================================== #
-      if i.include?('*') or i.include?('*.')
-        i = ftp?.array_file_listing.select {|entry|
-          entry[0].include? i.delete('*')
-        }
-        i.reject! {|line|
-          line == '.' or line == '..' # Reject '.' and '..' entries.
-        }
-        i.map! {|entry|
-          File.basename(entry)
-        } # ^^^ This is a bit hackish.
-        remote_remove(i)
-      else
-        # =================================================================== #
-        # We try to find out whether we have a directory or a file next.
-        # =================================================================== #
-        if is_dir?(i)
-          remove_remote_directory(i)
-        else # Assume it is a file. 
-          remove_remote_file(i)
-        end
-      end
-    end
-  end
-
-  # ========================================================================= #
-  # === remove_remote_file
-  #
-  # Use this method to attempt remove a remote file.
-  # ========================================================================= #
-  def remove_remote_file(i)
-    i[0,1] = ''.dup if i.start_with? '/' # We don't like starting "/" characters here.
-    e "Removing remote file `#{sfile(i)}` next." # We remove the remote file here.
-    begin
-      result = ftp?.remove_file(i)
-      e "Successfully removed remote file `#{sfile(result)}`."
-    rescue Net::FTPPermError => error
-      e 'Can not remove file `'+sfile(i)+'` as you are not '\
-        'the owner. ('+simp('Net::FTPPermError')+')'
-      pp error
-    end
-  end
-
-end; end

data/lib/ftp_paradise/interactive_ftp/reset.rb

@@ -1,90 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'ftp_paradise/interactive_ftp/reset.rb'
-# =========================================================================== #
-module FtpParadise
-
-class InteractiveFtp # === FtpParadise::InteractiveFtp
-
-  require 'ftp_paradise/interactive_ftp/misc.rb'
-  require 'ftp_paradise/interactive_ftp/readline.rb'
-
-  # ========================================================================= #
-  # === reset                                                     (reset tag)
-  #
-  # Initialize and/or reset the variables used in this class.
-  # ========================================================================= #
-  def reset
-    super()
-    # ======================================================================= #
-    # The following check is for my home system.
-    # ======================================================================= #
-    if File.exist? FILE_ROEBE_FTP
-      dataset = YAML.load_file(FILE_ROEBE_FTP)
-      determine_user_dataset_from_this_hash(dataset, :default)
-    end
-    # ======================================================================= #
-    # === @user_input
-    #
-    # Must "initialize" @user_input.
-    # ======================================================================= #
-    @user_input = nil
-    # ======================================================================= #
-    # Which files we did download so far.
-    # ======================================================================= #
-    @array_downloaded_files = []
-    # ======================================================================= #
-    # === @array_all_input
-    # ======================================================================= #
-    @array_all_input = [] # Stores which was the input.
-    # ======================================================================= #
-    # === @history
-    # ======================================================================= #
-    @history = []
-    # ======================================================================= #
-    # === @array_history_remote_directories
-    #
-    # This array keeps a listing of all remote directories we rcd-ed into.
-    # ======================================================================= #
-    @array_history_remote_directories = []
-    # ======================================================================= #
-    # === @debug
-    #
-    # Whether we will debug or not, by default.
-    # ======================================================================= #
-    @debug = SHALL_WE_DEBUG
-    # ======================================================================= #
-    # === @are_we_connected
-    # ======================================================================= #
-    @are_we_connected = false
-    # ======================================================================= #
-    # === @pad
-    # ======================================================================= #
-    @pad = '  ' # The default padding to use.
-    # ======================================================================= #
-    # === @use_readline
-    #
-    # Initially we will try to make use of the Readline module.
-    # ======================================================================= #
-    @use_readline = true
-    # ======================================================================= #
-    # === @use_this_editor
-    #
-    # Specify which editor we may use - this can be overruled in the
-    # interactive menu by the user of the FtpParadise project.
-    # ======================================================================= #
-    @use_this_editor = USE_THIS_EDITOR
-    # ======================================================================= #
-    # Try to make use of the Readline module as well.
-    # ======================================================================= #
-    consider_using_the_readline_module
-    reset_instance_variables_that_hold_all_arguments
-    set_file
-    set_local_directory
-    load_config
-    initialize_ftp_object # Initialize the @ftp variable.
-  end
-
-end; end