ftp_paradise 1.3.8

data/lib/ftp_paradise/base/reset.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'ftp_paradise/base/reset.rb'
+# =========================================================================== #
+module FtpParadise
+
+class Base
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    # ======================================================================= #
+    # === @internal_hash
+    # ======================================================================= #
+    @internal_hash = {}
+    # ======================================================================= #
+    # === :use_colours
+    # ======================================================================= #
+    @internal_hash[:use_colours] = true
+    # ======================================================================= #
+    # === :be_verbose
+    # ======================================================================= #
+    @internal_hash[:be_verbose]  = true
+  end
+
+end; end

data/lib/ftp_paradise/colours/colours.rb

@@ -0,0 +1,141 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen-string-literal: true
+# =========================================================================== #
+# This file will add colour-related methods to the ftp_paradise project.
+# =========================================================================== #
+# require 'ftp_paradise/colours/colours.rb'
+# =========================================================================== #
+module FtpParadise
+
+  require 'ftp_paradise/colours/use_colours.rb'
+
+  # ========================================================================= #
+  # === rev
+  # ========================================================================= #
+  def rev
+    return Colours.rev if use_colours?
+    return ''
+  end
+
+  # ========================================================================= #
+  # === FtpParadise.sdir
+  # ========================================================================= #
+  def self.sdir(i)
+    return Colours.sdir(i) if use_colours?
+    i
+  end
+
+  # ========================================================================= #
+  # === FtpParadise.swarn
+  # ========================================================================= #
+  def self.swarn(i)
+    return Colours.swarn(i) if use_colours?
+    return i
+  end
+
+  # ========================================================================= #
+  # === FtpParadise.sfile
+  # ========================================================================= #
+  def self.sfile(i)
+    return Colours.sfile(i) if use_colours?
+    return i
+  end
+
+  # ========================================================================= #
+  # === FtpParadise.sfancy
+  # ========================================================================= #
+  def self.sfancy(i)
+    return Colours.sfancy(i) if use_colours? # Else we won't modify this at all.
+    return i
+  end
+
+  # ========================================================================= #
+  # === FtpParadise.simp
+  # ========================================================================= #
+  def self.simp(i)
+    return Colours.simp(i) if use_colours? # Else we won't modify this.
+    return i
+  end
+
+  # ========================================================================= #
+  # === sfancy
+  # ========================================================================= #
+  def sfancy(i)
+    FtpParadise.sfancy(i) # We can delegate here, because FtpParadise.sfancy() will take care of colours.
+  end
+
+  # ========================================================================= #
+  # === simp
+  # ========================================================================= #
+  def simp(i) # Link to FtpParadise.simp
+    FtpParadise.simp(i) # We can delegate here, because FtpParadise.sfancy will take care of colours.
+  end
+
+  # ========================================================================= #
+  # === sdir
+  # ========================================================================= #
+  def sdir(i)
+    FtpParadise.sdir(i)
+  end
+
+  # ========================================================================= #
+  # === sfile
+  # ========================================================================= #
+  def sfile(i)
+    FtpParadise.sfile(i)
+  end
+
+  # ========================================================================= #
+  # === swarn
+  # ========================================================================= #
+  def swarn(i)
+    FtpParadise.swarn(i)
+  end
+
+  # ========================================================================= #
+  # === FtpParadise.lightyellow
+  # ========================================================================= #
+  def self.lightyellow(i = '')
+    if use_colours?
+      return ::Colours.lightyellow(i)
+    end
+    return "#{Colours.yellow}#{i}#{Colours.rev}"
+  end; self.instance_eval { alias yellow lightyellow } # === FtpParadise.lightyellow
+
+  # ========================================================================= #
+  # === FtpParadise.royalblue
+  # ========================================================================= #
+  def self.royalblue(i = '')
+    if use_colours?
+      return ::Colours.royalblue(i)
+    end
+    return i
+  end
+
+  # ========================================================================= #
+  # === FtpParadise.slateblue
+  # ========================================================================= #
+  def self.slateblue(i = '')
+    if use_colours?
+      return ::Colours.slateblue(i)
+    end
+    return i
+  end
+
+  # ========================================================================= #
+  # === FtpParadise.testing_colours          (colour test, testing colours)
+  #
+  # This just is a test whether we use colours or whether we won't.
+  # ========================================================================= #
+  def self.testing_colours
+    e 'We will now test some colours.'
+    e "Will we use colours? #{FtpParadise.use_colours?.to_s}"
+    e 'Testing '+sfancy('sfancy')+' next.'
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  puts FtpParadise.swarn('Oh noes!')
+end

data/lib/ftp_paradise/colours/use_colours.rb

@@ -0,0 +1,74 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'ftp_paradise/colours/use_colours.rb'
+# =========================================================================== #
+module FtpParadise
+
+  require 'ftp_paradise/configuration/configuration.rb'
+
+  begin
+    require 'colours'
+  rescue LoadError; end
+
+  # ========================================================================= #
+  # Let's initialize the configuration here, if we have not yet
+  # done so.
+  # ========================================================================= #
+  if @configuration.nil?
+    FtpParadise.initialize_configuration if FtpParadise.respond_to? :initialize_configuration
+  end
+
+  # ========================================================================= #
+  # === FtpParadise.use_colours?
+  #
+  # This can be delegated towards the configuration object.
+  # ========================================================================= #
+  def self.use_colours?
+    if FtpParadise.respond_to?(:config?) and
+       FtpParadise.config?.respond_to?(:use_colours)
+      FtpParadise.config?.use_colours
+    else
+      true
+    end
+  end
+
+  # ========================================================================= #
+  # === FtpParadise.disable_colours
+  #
+  # Use this method to disable colours.
+  # ========================================================================= #
+  def self.disable_colours
+    FtpParadise.config?.use_colours = false
+  end
+
+  # ========================================================================= #
+  # === use_colours?
+  #
+  # Whether we will use colours or whether we will not.
+  # ========================================================================= #
+  def use_colours?
+    FtpParadise.use_colours?
+  end
+
+  # ========================================================================= #
+  # === If we use colours in this project
+  # ========================================================================= #
+  if use_colours?
+    # ======================================================================= #
+    # And we can also set the default-colours to use.
+    # ======================================================================= #
+    if Object.const_defined?(:Colours) and
+       Colours.respond_to?(:assign_new_colour_codes)
+      Colours.update_the_colour_codes_with({
+        default_colour: :green,
+        sfile:          :brown,
+        sdir:           :chocolate,
+        swarn:          :red,
+        simportant:     :bold_yellow,
+      })
+    end
+  end
+
+end

data/lib/ftp_paradise/configuration/configuration.rb

@@ -0,0 +1,49 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen-string-literal: true
+# =========================================================================== #
+# require 'ftp_paradise/configuration/configuration.rb'
+# =========================================================================== #
+module FtpParadise
+
+  require 'ftp_paradise/project/project.rb'
+
+  begin
+    require 'roebe/configuration/configuration.rb'
+  rescue LoadError; end
+
+  # ========================================================================= #
+  # === @configuration
+  # ========================================================================= #
+  @configuration = nil
+
+  # ========================================================================= #
+  # === FtpParadise.initialize
+  #
+  # This method will assign to the general configuration object stored
+  # in the variable @configuration.
+  # ========================================================================= #
+  def self.initialize
+    if Object.const_defined? :Roebe
+      # ===================================================================== #
+      # Load up all .yml files from the path to the yaml directory:
+      # ===================================================================== #
+      @configuration = ::Roebe::Configuration::Configuration.new(FtpParadise.yaml_directory?)
+    end
+  end; self.instance_eval { alias initialize_configuration initialize } # === FtpParadise.initialize_configuration
+
+  # ========================================================================= #
+  # === Initialize the Configuration object here
+  # ========================================================================= #
+  FtpParadise.initialize_configuration if @configuration
+
+  # ========================================================================= #
+  # === FtpParadise.config?
+  #
+  # Query method towards the Configuration object.
+  # ========================================================================= #
+  def self.config?
+    @configuration
+  end; self.class { alias configuration? config? } # === FtpParadise.configuration?
+
+end

data/lib/ftp_paradise/connection/README.md

@@ -0,0 +1 @@
+This directory contains code for an "FTP connection".

data/lib/ftp_paradise/connection/connection.rb

@@ -0,0 +1,35 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This is the "connection class". It will have methods that can be use
+# when we are connected to a remote site (via the FTP protocol).
+#
+# Rather than keeping FTP-related state within this class, such as remote
+# URL and such, we will instead use FtpParadise module methods.
+# =========================================================================== #
+# Possible errors and failures when we are trying to connect:
+#
+#   Net::FTPPermError: 530 Please login with USER and PASS.
+#
+#   Net::FTPConnectionError is raised if we are no longer connected to
+#   the remote FTP site.
+#
+#   Errno::ETIMEDOUT is raised when a timeout event occurred.
+# =========================================================================== #
+# The official documentation for Ruby-FTP can be found here:
+#
+#   https://ruby-doc.org/stdlib/libdoc/net/ftp/rdoc/Net/FTP.html
+#
+# =========================================================================== #
+require 'ftp_paradise/connection/initialize.rb'
+require 'ftp_paradise/connection/data.rb'
+require 'ftp_paradise/connection/debug.rb'
+require 'ftp_paradise/connection/misc.rb'
+require 'ftp_paradise/connection/notify.rb'
+require 'ftp_paradise/connection/remote_pwd.rb'
+require 'ftp_paradise/connection/remove.rb'
+require 'ftp_paradise/connection/show.rb'
+require 'ftp_paradise/connection/upload.rb'
+require 'ftp_paradise/version/version.rb'
+require 'ftp_paradise/configuration/configuration.rb'

data/lib/ftp_paradise/connection/constants.rb

@@ -0,0 +1,46 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'ftp_paradise/connection/constants.rb'
+# =========================================================================== #
+module FtpParadise
+
+class Connection < Base
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === BE_VERBOSE
+  # ========================================================================= #
+  BE_VERBOSE = true
+
+  # ========================================================================= #
+  # === DEFAULT_TRANSFER_MODE
+  # ========================================================================= #
+  DEFAULT_TRANSFER_MODE = :ascii # Which transfer mode to use by default.
+
+  # ========================================================================= #
+  # === DEFAULT_PORT
+  # ========================================================================= #
+  DEFAULT_PORT = 21
+
+  # ========================================================================= #
+  # === RUN_ALREADY
+  # ========================================================================= #
+  RUN_ALREADY = true
+
+  # ========================================================================= #
+  # === DEFAULT_USER_NAME
+  #
+  # In the past this was set to a String (the user name); but since as
+  # of October 2018, it will default to nil, so that we really initialize
+  # the whole project to a nil-state (as the default). This thus allows
+  # us to determine whether this has been changed, aka initialized.
+  # ========================================================================= # 
+  DEFAULT_USER_NAME = nil
+
+end; end

data/lib/ftp_paradise/connection/data.rb

@@ -0,0 +1,148 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'ftp_paradise/connection/data.rb'
+# =========================================================================== #
+module FtpParadise
+
+class Connection < FtpParadise::Base
+
+  require 'ftp_paradise/constants/roebe.rb'
+
+  # ========================================================================= #
+  # === set_data                                   (all in one, set_data tag)
+  #
+  # This method sets:
+  #
+  #   - host
+  #   - user name
+  #   - port and
+  #   - password
+  #
+  # This method is thus a nifty little convenience method. You can pass
+  # a hash to it too, which is the recommended way to use this method.
+  #
+  # You can also use an Array (with 4 elements), in which case we will
+  # process it one after the other. The reason for this procedure is
+  # because we can also use yaml files that way, that also use the
+  # exact order of elements.
+  #
+  # If you add a new entry to the case menu below, also add this to 
+  # ARRAY_AVAILABLE_HOSTS, please. That Array can be found in the
+  # file 'constants/roebe_ftp_constants.rb'.
+  # ========================================================================= #
+  def set_data(
+      i = 'default'
+    ) # set the default here.
+    if debug?
+      opnn; e 'We will debug next, as the @debug variable was set to true.'
+      pp i
+    end
+    # ========================================================================= #
+    # === Handle Hash as input first
+    # ========================================================================= #
+    if i.is_a? Hash # Hash is treated differently.
+      if   i.has_key? :host
+        set_host i.fetch(:host)
+      elsif i.has_key? :remote_host
+        set_host i.fetch(:remote_host)
+      elsif i.has_key? :to # :to is an alias to :host.
+        set_host i.fetch(:to)
+      end      
+
+      if    i.has_key? :user_name
+        set_user_name i.fetch(:user_name)
+      elsif i.has_key? :login_name
+        set_user_name i.fetch(:login_name)
+      end
+
+      if i.has_key? :password
+        set_password i.fetch(:password)
+      elsif i.has_key? :login_password
+        set_password i.fetch(:login_password)
+      end
+
+      if i.has_key? :port
+        set_port i.fetch(:port)
+      end
+    # ========================================================================= #
+    # === Handle Array as input next
+    # ========================================================================= #
+    elsif i.is_a? Array # Example-Array: ["ftp.byethost33.com", "b33_14144659", "1aaaaaa", 21]
+      set_host      i.first
+      set_user_name i[1]
+      set_password  i[2]
+      set_port      i[3]
+    # ========================================================================= #
+    # === Else, use simple toggle commands, such as 1,2,3,4,5 and so forth.
+    # ========================================================================= #
+    else # In the following case menu you can toggle your FTP.
+      case i.to_s # Work on strings only. Assumes shortcuts.
+      # ===================================================================== #
+      # === shevy
+      # ===================================================================== #
+      when '6',
+           /shevy/i,
+           'square',
+           'square7',
+           'bplaced',
+           'default',
+           'top' # Current default.
+        _ = FILE_ROEBE_FTP
+        if File.exist? _
+          data = YAML.load_file(_)['bplaced'] # 'bplaced'
+          set_host      data['url']
+          set_user_name data['user_name']
+          this_password = data['password']
+          this_password.chop! if this_password.end_with? '_'
+          set_password  this_password
+          set_port      data['port']
+        end
+      # ===================================================================== #
+      # === a1
+      # ===================================================================== #
+      when '1',
+           'a1',
+           'a1_ftp' # A1 FTP host. No longer in use but still kept.
+        set_host      A1.first
+        set_user_name A1[1]
+        set_password  A1[2]
+        set_port      A1[3]
+      # ===================================================================== #
+      # === zymix
+      # ===================================================================== #
+      when '2',
+           'zymix',
+           'standard'
+        set_host      ZYMIX.first
+        set_user_name ZYMIX[1]
+        set_password  ZYMIX[2]
+        set_port      ZYMIX[3]
+      # ===================================================================== #
+      # === uniwien
+      # ===================================================================== #
+      when '3',
+           'univie',
+           'uniwien' # Uni Wien FTP Account.
+        set_host      UNIVIE.first
+        set_user_name UNIVIE[1]
+        set_password  UNIVIE[2]
+        set_port      UNIVIE[3]
+      # ===================================================================== #
+      # === byte
+      # ===================================================================== #
+      when '4',
+           'byte',
+           'bytehost'
+        set_host      BYTEHOST.first
+        set_user_name BYTEHOST[1]
+        set_password  BYTEHOST[2]
+        set_port      BYTEHOST[3]
+      else
+        set_data(:default) # Go back to default again if not found.
+      end
+    end
+  end
+
+end; end