rcfiles 1.1.1137

data/lib/rcfiles/constants/misc.rb

@@ -0,0 +1,75 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'rcfiles/constants/misc.rb'
+# =========================================================================== #
+module Rcfiles
+
+  require 'rcfiles/project/project.rb'
+
+  # ========================================================================= #
+  # === N
+  # ========================================================================= #
+  N = "\n"
+
+  # ========================================================================= #
+  # === HOME_DIR
+  # ========================================================================= #
+  HOME_DIR = '/home/'
+
+  # ========================================================================= #
+  # === DIRECTORY_CONTAINING_THE_RC_FILES_ON_MY_HOME_SYSTEM
+  #
+  # This constant is obviously not so useful for other people - it is
+  # for my home system only. The target is, in that case, hardcoded.
+  # ========================================================================= #
+  DIRECTORY_CONTAINING_THE_RC_FILES_ON_MY_HOME_SYSTEM =
+    "#{HOME_DIR}x/DATA/PC/OS/LINUX/yaml/"
+
+  # ========================================================================= #
+  # === LINUX_YAML_BASE_DIRECTORY
+  #
+  # Simply point to the environment variable $LINUX_YAML.
+  #
+  #   cd $LINUX_YAML
+  #
+  # ========================================================================= #
+  if ENV['LINUX_YAML']
+    LINUX_YAML_BASE_DIRECTORY = "#{ENV['LINUX_YAML']}/"
+  else
+    LINUX_YAML_BASE_DIRECTORY = DIRECTORY_CONTAINING_THE_RC_FILES_ON_MY_HOME_SYSTEM
+  end
+
+  # ========================================================================= #
+  # === Rcfiles::FILE_STORE_INTO_THIS_DIRECTORY
+  # ========================================================================= #
+  FILE_STORE_INTO_THIS_DIRECTORY =
+    "#{project_yaml_dir?}store_into_this_directory.yml"
+
+  # ========================================================================= #
+  # === CREATE_RCFILES_WHERE
+  #
+  # Where to put the RC files by default. Must be a directory. But,
+  # we must first check whether the file exists.
+  # ========================================================================= #
+  _ = FILE_STORE_INTO_THIS_DIRECTORY
+  if File.exist? _
+    # ======================================================================= #
+    # This clause is the default one.
+    # ======================================================================= #
+    CREATE_RCFILES_WHERE = File.read(_).strip # '/AUTOGENERATED/'
+  else
+    # ======================================================================= #
+    # This one is just a rescued-variant defaulting to the home directory
+    # as base-directory.
+    # ======================================================================= #
+    CREATE_RCFILES_WHERE = File.expand_path('~/AUTOGENERATED/')
+  end
+
+  # ========================================================================= #
+  # === RUBY_SRC_DIR_AT_HOME
+  # ========================================================================= #
+  RUBY_SRC_DIR_AT_HOME = "#{HOME_DIR}x/DATA/PROGRAMMING_LANGUAGES/RUBY/src/"
+
+end

data/lib/rcfiles/constants/namespace.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'rcfiles/constants/namespace.rb'
+# =========================================================================== #
+module Rcfiles
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  p Rcfiles.constants.sort
+end

data/lib/rcfiles/expand_cd_aliases/constants.rb

@@ -0,0 +1,50 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'rcfiles/expand_cd_aliases/constants.rb'
+# =========================================================================== #
+require 'rcfiles/files/file_cd_aliases.rb'
+
+module Rcfiles
+
+class ExpandCdAliases # === Rcfiles::ExpandCdAliases
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === Rcfiles::ExpandCdAliases::FILE_CD_ALIASES
+  #
+  # This constant, called FILE_CD_ALIASES, will store the path to the
+  # file called 'cd_aliases.yml'.
+  #
+  # We will query the toplevel module Rcfiles for the path to this file.
+  # ========================================================================= #
+  FILE_CD_ALIASES = ::Rcfiles.file_cd_aliases?
+
+  # ========================================================================= #
+  # === Rcfiles::ExpandCdAliases::NAME_OF_FILE
+  # ========================================================================= #
+  NAME_OF_FILE = 'expand_cd_aliases.rb'
+
+  # ========================================================================= #
+  # === Rcfiles::ExpandCdAliases::SHALL_WE_SHOW_EXCEPTIONS
+  # ========================================================================= #
+  SHALL_WE_SHOW_EXCEPTIONS = false
+
+  # ========================================================================= #
+  # === Rcfiles::ExpandCdAliases::DEFAULT_RUN_MODE
+  # ========================================================================= #
+  DEFAULT_RUN_MODE = false
+
+  # ========================================================================= #
+  # === EMPTY_STRING
+  #
+  # Dummy empty string object.
+  # ========================================================================= #
+  EMPTY_STRING = ''.dup
+
+end; end

data/lib/rcfiles/expand_cd_aliases/expand_cd_aliases.rb

@@ -0,0 +1,626 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Rcfiles::ExpandCdAliases
+#
+# The purpose of this class is to expand my cd-aliases, which are usually
+# stored in the file "cd_aliases.yml", which in turn is a part of the
+# Rcfiles project.
+#
+# For example, "pwdj" is an alias to cd into the directory "/Depot/j/" on
+# my home system(s).
+#
+# That way, we can provide these aliases to other ruby projects conveniently.
+# In fact, this has been a primary reason for creating this class - it
+# was to make all cd_aliases available within the DiamondShell project,
+# specifically.
+#
+# Specific Usage Example and the main API:
+#
+#   require 'rcfiles'
+#   expand_cd_aliases = Rcfiles::ExpandCdAliases.new(_)
+#   if Rcfiles::ExpandCdAliases.is_included? i # If we have thus found it.
+#     do_someting()
+#
+# =========================================================================== #
+# require 'rcfiles/expand_cd_aliases/expand_cd_aliases.rb'
+# =========================================================================== #
+require 'rcfiles/toplevel_methods/e.rb'
+require 'rcfiles/toplevel_methods/no_file_exists_at.rb'
+require 'rcfiles/toplevel_methods/save_file.rb'
+require 'rcfiles/version/version.rb'
+require 'rcfiles/constants/encodings.rb'
+require 'rcfiles/colours/colours.rb'
+require 'rcfiles/expand_cd_aliases/constants.rb'
+require 'rcfiles/expand_cd_aliases/run.rb'
+
+module Rcfiles
+
+class ExpandCdAliases # === Rcfiles::ExpandCdAliases
+
+  begin
+    require 'opn'
+  rescue LoadError; end
+
+  begin
+    require 'convert_global_env'
+  rescue LoadError; end
+
+  alias e puts
+
+  # ========================================================================= #
+  # === @cd_aliases
+  #
+  # This variable will hold the whole cd-aliases dataset. It should be
+  # kept as a Hash at all times.
+  #
+  # Do note that this variable will be an empty Hash by default. It will
+  # be filled only when we need to access the dataset; this should make
+  # the Rcfiles project a bit more lightweight by default.
+  # ========================================================================= #
+  @cd_aliases = {}
+
+  # ========================================================================= #
+  # === ExpandCdAliases.cd_aliases?
+  #
+  # Main getter over the cd-aliases. This will be our main datastructure.
+  # ========================================================================= #
+  def self.cd_aliases?
+    @cd_aliases
+  end
+
+  # ========================================================================= #
+  # === ExpandCdAliases.clear
+  #
+  # Reset the main Hash again.
+  # ========================================================================= #
+  def self.clear
+    @cd_aliases.clear
+  end
+
+  # ========================================================================= #
+  # === Rcfiles::ExpandCdAliases.register_sigint
+  # ========================================================================= #
+  def self.register_sigint
+    Signal.trap('SIGINT') { exit }
+  end
+
+  register_sigint # <- And call it at once.
+
+  # ========================================================================= #
+  # === @main_yaml_file
+  #
+  # This variable will keep track of the main yaml file, that is, the
+  # file that holds the dataset for "cd-aliases".
+  #
+  # It is nil initially here, but will be changed lateron through a method
+  # call.
+  # ========================================================================= #
+  @main_yaml_file = nil
+
+  # ========================================================================= #
+  # === ExpandCdAliases.set_main_yaml_file
+  #
+  # The user can modify which yaml file is to be used, via this method call.
+  # ========================================================================= #
+  def self.set_main_yaml_file(
+      i = :default
+    )
+    case i
+    when :default
+      i = FILE_CD_ALIASES
+    end
+    @main_yaml_file = i
+  end
+
+  # ========================================================================= #
+  # Define the main cd-aliases file next. The constant FILE_CD_ALIASES
+  # must be defined for this to work.
+  # ========================================================================= #
+  ExpandCdAliases.set_main_yaml_file(:default)
+
+  # ========================================================================= #
+  # === ExpandCdAliases.yaml_file?
+  # ========================================================================= #
+  def self.yaml_file?
+    @main_yaml_file
+  end
+
+  # ========================================================================= #
+  # === initialize
+  #
+  # The first argument is optional. If given then we will query for this
+  # particular key, aka whether it is a cd-alias or whether it is not.
+  # ========================================================================= #
+  def initialize(
+      optional_seek_this_key = nil,
+      run_already            = DEFAULT_RUN_MODE
+    )
+    reset
+    if block_given?
+      yielded = yield
+      case yielded
+      when :run
+        run_already = true
+      end
+    end
+    case run_already
+    when :do_not_report_errors
+      @report_errors = false
+      run_already = DEFAULT_RUN_MODE
+    when :be_silent
+      be_silent
+      run_already = DEFAULT_RUN_MODE
+    end # This block must run before sanitize_cd_aliases() is called.
+    if optional_seek_this_key
+      set_return_string(optional_seek_this_key)
+    end
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    @hash = {}
+    @return_string = nil # This is the return string. Nil on startup.
+    @seek_this_key = '' # The query-key that we are looking for.
+    # ======================================================================= #
+    # The next variable determines whether we will report errors or
+    # whether we will not. By default this class will report errors.
+    # ======================================================================= #
+    @report_errors = true
+    be_quiet # Do not be too noisy by default.
+  end
+
+  # ========================================================================= #
+  # === opnn
+  # ========================================================================= #
+  def opnn
+    super(NAMESPACE) if Object.const_defined? :Opn
+  end; alias opn opnn # === opn
+
+  # ========================================================================= #
+  # === verbose_points_to?
+  # ========================================================================= #
+  def verbose_points_to?(i)
+    i = i.to_s
+    if is_included? i
+      opnn; e "#{rev}Yes, the key `#{::Rcfiles.sfancy(i)}` is included."
+      opnn; e "#{rev}It points to the directory: #{sdir(@hash[i])}"
+    else
+      opnn; e "#{rev}No, the key `#{::Rcfiles.sfancy(i)}` is not "\
+              "included in the cd-aliases."
+    end
+  end
+
+  # ========================================================================= #
+  # === set_return_string
+  #
+  # Before this method is called, sanitize_cd_aliases() should have been
+  # called in order to initialize our dataset, and also set up the
+  # @hash variable properly.
+  #
+  # This method will assign to @seek_this_key and @return_string.
+  # ========================================================================= #
+  def set_return_string(i = '')
+    if @hash.empty?
+      # ===================================================================== #
+      # Initialize the main hash if it is empty.
+      # ===================================================================== #
+      initialize_main_hash
+    end
+    i = i.first if i.is_a? Array
+    i = i.to_s.dup
+    set_seek_this_key(i)
+    @return_string = @hash[i]
+  end; alias set set_return_string # === set
+
+  # ========================================================================= #
+  # === rev
+  # ========================================================================= #
+  def rev
+    if ::Rcfiles.use_colours?
+      ::Colours.rev
+    else
+      EMPTY_STRING
+    end
+  end
+
+  # ========================================================================= #
+  # === test
+  # ========================================================================= #
+  def test(i = @seek_this_key)
+    verbose_points_to?(i)
+  end
+
+  # ========================================================================= #
+  # === return_string?
+  # ========================================================================= #
+  def return_string?
+    @return_string # Return the expanded return string.
+  end; alias result? return_string? # === result?
+       alias _       return_string? # === _
+
+  # ========================================================================= #
+  # === size?
+  #
+  # Query how many keys we have.
+  # ========================================================================= #
+  def size?
+    @hash.keys.size
+  end; alias size size? # === size
+
+  # ========================================================================= #
+  # === seek_this_key?
+  # ========================================================================= #
+  def seek_this_key?
+    @seek_this_key
+  end
+
+  # ========================================================================= #
+  # === set_seek_this_key
+  # ========================================================================= #
+  def set_seek_this_key(i)
+    @seek_this_key = i
+  end
+
+  # ========================================================================= #
+  # === is_included?
+  #
+  # Query whether our expanded cd-aliases have the given key (first
+  # argument) included or whether they do not.
+  # ========================================================================= #
+  def is_included?(
+      i = @seek_this_key
+    )
+    @hash.has_key?(i)
+  end; alias has_key?                  is_included? # === has_key?
+       alias is_this_alias_included?   is_included? # === is_this_alias_included?
+       alias is_this_input_a_cd_alias? is_included? # === is_this_input_a_cd_alias?
+
+  # ========================================================================= #
+  # === report_to_user
+  #
+  # This is a "poor man's" debug variant.
+  # ========================================================================= #
+  def report_to_user
+    pp @hash
+  end
+
+  # ========================================================================= #
+  # === show_exceptions?
+  # ========================================================================= #
+  def show_exceptions?
+    SHALL_WE_SHOW_EXCEPTIONS
+  end
+
+  # ========================================================================= #
+  # === be_verbose
+  # ========================================================================= #
+  def be_verbose
+    @be_verbose = true
+  end
+
+  # ========================================================================= #
+  # === be_silent
+  # ========================================================================= #
+  def be_silent
+    @be_verbose = false
+  end; alias be_quiet be_silent # === be_quiet
+
+  # ========================================================================= #
+  # === version?
+  # ========================================================================= #
+  def version?
+    ::Rcfiles::VERSION
+  end
+
+  # ========================================================================= #
+  # === report_version
+  # ========================================================================= #
+  def report_version
+    e "The version is: #{sfancy(version?)}"
+  end
+
+  # ========================================================================= #
+  # === be_verbose?
+  # ========================================================================= #
+  def be_verbose?
+    @be_verbose
+  end
+
+  # ========================================================================= #
+  # === report_errors?
+  # ========================================================================= #
+  def report_errors?
+    @report_errors
+  end
+
+  # ========================================================================= #
+  # === sanitize_hash
+  #
+  # We make @hash better here, by sanitizing some value entries.
+  # ========================================================================= #
+  def sanitize_hash
+    _ = {}
+    @hash.each {|key, value|
+      if value.include? '/' # assume it is ok here
+      else # else work on it.
+        value = @hash[value] if hash?.has_key? value
+      end
+      _[key] = value
+    }
+    @hash = _
+  end
+
+  # ========================================================================= #
+  # === initialize_main_hash
+  #
+  # This method will do two things:
+  #
+  #   1) initialize the main dataset
+  #   2) sanitize this dataset (for use within this class)
+  #
+  # ========================================================================= #
+  def initialize_main_hash
+    # ======================================================================= #
+    # Initialize the main dataset if it has not been loaded up yet.
+    # ======================================================================= #
+    if ::Rcfiles::ExpandCdAliases.cd_aliases?.empty?
+      ::Rcfiles::ExpandCdAliases.load_dataset_from_main_file
+    end
+    sanitize_cd_aliases
+  end; alias initialize_main_dataset initialize_main_hash # === initialize_main_dataset
+
+  # ========================================================================= #
+  # === sanitize_cd_aliases
+  #
+  # We sanitize the whole dataset. At first, we correct all $ entries.
+  #
+  # In order for this method to work, the main dataset has to be set.
+  # ========================================================================= #
+  def sanitize_cd_aliases(
+      use_this_dataset = ::Rcfiles::ExpandCdAliases.cd_aliases?
+    )
+    hash = {}
+    # ======================================================================= #
+    # First, set up our new hash and also replace all $ found.
+    # ======================================================================= #
+    use_this_dataset.each {|key, value|
+      begin
+        unless value.to_s.encoding.to_s == MAIN_ENCODING_TO_USE
+          value = value.to_s.encode(MAIN_ENCODING_TO_USE) # Work with the main-encoding past this point.
+        end
+      rescue Encoding::InvalidByteSequenceError => error
+        if be_verbose? and show_exceptions? and report_errors?
+          opnn; e "#{NAME_OF_FILE}: An exception/error happened for -> #{simp(key.to_s)}"
+          opnn; e 'We will now feedback this error:'
+          pp error
+        end
+      end
+      # ===================================================================== #
+      # Next, work on all value-entries that include a '$' character.
+      # ===================================================================== #
+      if value.include? '$'
+        value = ConvertGlobalEnv.convert(value, report_errors?)
+      end
+      # ===================================================================== #
+      # Next, we must perform a few batch-gsubs, but we must be careful,
+      # as this could lead to bugs.
+      # ===================================================================== #
+      unless value.encoding.to_s == 'UTF-8'
+        # =================================================================== #
+        # First, we chop off trailing occurences of 'pwd', but as of May
+        # 2014, I decided that this is no longer wanted. Certain aliases
+        # such as "pwdusb4" would misfunction as a result of 
+        # the following .gsub:
+        #   value.gsub!(/pwd$/,'') if value.include? 'pwd'
+        # =================================================================== #
+        value.gsub!(/cd /,'')  if value.include? 'cd '
+        value.gsub!(/ ll/,'')  if value.include? ' ll'
+        value.gsub!(/ ls/,'')  if value.include? ' ls'
+        value.gsub!(/> \/dev\/null/,'') if value.include? '> /dev/null'
+        value.gsub!(/2>&1/,'') if value.include? '2>&1'
+        # =================================================================== #
+        # As of May 2014, we no longer get rid of ; characters.
+        # =================================================================== #
+        # value.gsub!(/;/,'')    if value.include? ';'
+        value = value.strip
+      end
+      hash[key] = value
+    }
+    @hash = hash
+    # ======================================================================= #
+    # Ok, at this point we have our hash data, and we also sanitized
+    # it a little bit already, by getting rid of the $ values.
+    # So now we call another method to further clean our hash. This
+    # is evidently totally hackish, but it also sort of works.
+    # ======================================================================= #
+    sanitize_hash
+    sanitize_hash
+    sanitize_hash
+    sanitize_hash
+  end
+
+  # ========================================================================= #
+  # === hash?
+  #
+  # Query the main hash.
+  # ========================================================================= #
+  def hash?
+    @hash
+  end; alias hash        hash? # === hash
+       alias cd_aliases? hash? # === cd_aliases?
+
+  # ========================================================================= #
+  # === []
+  # ========================================================================= #
+  def [](i)
+    @hash[i]
+  end
+  # ========================================================================= #
+  # === Rcfiles::ExpandCdAliases.is_included?
+  # ========================================================================= #
+  def self.is_included?(i)
+    _ = self.new(i)
+    return _.is_included?(i)
+  end; self.instance_eval { alias does_include? is_included? } # === Rcfiles::ExpandCdAliases.does_include?
+  # Rcfiles::ExpandCdAliases.include? # <-- This here would conflict, hence we can not use it.
+
+  # ========================================================================= #
+  # === Rcfiles::ExpandCdAliases.points_at?
+  # ========================================================================= #
+  def self.points_at?(i)
+    _ = self.new(i)
+    return _._
+  end
+
+  # ========================================================================= #
+  # === Load up the dataset next
+  #
+  # This determines the main cd-aliases file.
+  # ========================================================================= #
+  def self.load_dataset_from_main_file(
+      i = self.yaml_file?
+    )
+    if File.exist? i
+      begin
+        dataset = YAML.load_file(i) # This may be UTF-8 encoding.
+        # =================================================================== #
+        # Assign the cd-aliases via a toplevel method next:
+        # =================================================================== #
+        self.set_cd_aliases(dataset)
+      rescue Psych::SyntaxError => error
+        e 'A Psych::SyntaxError happened for the file `'+i+'`.'
+        pp error
+      end
+    else # Else use an empty dataset instead.
+      if is_on_roebe?
+        ::Rcfiles.no_file_exists_at(i)
+      end
+      self.set_cd_aliases {}
+    end
+  end
+
+  # ========================================================================= #
+  # === ExpandCdAliases.set_cd_aliases                  (set_cd_aliases tag)
+  #
+  # The @cd_aliases should always be a Hash. This is an explicit setter,
+  # though, so the user could always assign a non-Hash. No error will
+  # be raised in this case.
+  # ========================================================================= #
+  def self.set_cd_aliases(i = {})
+    @cd_aliases = i
+  end; self.instance_eval { alias set_cd_aliases= set_cd_aliases } # === ExpandCdAliases.set_cd_aliases=
+
+  # ========================================================================= #
+  # === ExpandCdAliases.n_entries?
+  #
+  # How many entries can be found in class ExpandCdAliases is answered
+  # by this toplevel method.
+  # ========================================================================= #
+  def self.n_entries?
+    @cd_aliases.keys.size
+  end
+
+  # ========================================================================= #
+  # === ExpandCdAliases.e
+  # ========================================================================= #
+  def self.e(i = '')
+    ::Rcfiles.e(i)
+  end
+
+  # ========================================================================= #
+  # === Rcfiles::ExpandCdAliases.is_this_alias_included?
+  # ========================================================================= #
+  def self.is_this_alias_included?(i)
+    self.new(i).is_included?
+  end; self.instance_eval { alias is_this_input_a_cd_alias? is_this_alias_included? } # === Rcfiles::ExpandCdAliases.is_this_input_a_cd_alias? 
+
+  # ========================================================================= #
+  # === Rcfiles::ExpandCdAliases[]
+  # ========================================================================= #
+  def self.[](i)
+    i = i.to_s
+    if self.is_this_alias_included? i
+      _ = self.new(i)
+      i = _.hash[i]
+    end
+    return i
+  end
+
+  # ========================================================================= #
+  # === Rcfiles::ExpandCdAliases.save_into_ruby_file
+  #
+  # This method will store the hash in a CONSTANT, into a file (normally
+  # a .rb file).
+  #
+  # The first argument to this method denotes where to store this file, so
+  # you have the possibility to save into some special location instead.
+  #
+  # The name of the hash is provided via the the second argument to
+  # this method.
+  # ========================================================================= #
+  def self.save_into_ruby_file(
+      store_into_this_file  = '/Depot/j/expand_cd_aliases_hash.rb',
+      name_of_the_main_hash = 'EXPAND_CD_ALIASES_HASH'
+    )
+    _ = ::Rcfiles::ExpandCdAliases.new
+    _.initialize_main_dataset
+    dataset = _.cd_aliases?
+    # ======================================================================= #
+    # First add the header:
+    # ======================================================================= #
+    what = '#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+'.dup
+    what << "#{name_of_the_main_hash} = {\n"
+    what = ::Rcfiles.ensure_main_encoding(what)
+    dataset.each_pair {|key, value|
+      key = key.to_s unless key.is_a? String
+      value = ConvertGlobalEnv.convert(value)
+      key = ::Rcfiles.ensure_main_encoding(key)
+      value = ::Rcfiles.ensure_main_encoding(value)
+      what << "  \"#{key}\": \"#{value}\",\n"
+    }
+    what << "}\n"
+    into = store_into_this_file
+    ::Rcfiles.write_what_into(what, into)
+  end; self.instance_eval { alias generate_cd_aliases save_into_ruby_file } # === ExpandCdAliases.generate_cd_aliases
+
+end
+
+# =========================================================================== #
+# === Rcfiles.expand_cd_aliases
+# =========================================================================== #
+def self.expand_cd_aliases(i)
+  ::Rcfiles::ExpandCdAliases.new(i)
+end; self.instance_eval { alias cd_alias expand_cd_aliases } # === Rcfiles.cd_alias
+
+# ========================================================================= #
+# === Rcfiles.is_this_alias_included?
+# ========================================================================= #
+def self.is_this_alias_included?(i)
+  ::Rcfiles::ExpandCdAliases.is_this_alias_included?(i)
+end; self.instance_eval { alias is_this_input_a_cd_alias? is_this_alias_included? } # === Rcfiles.is_this_input_a_cd_alias? 
+
+# =========================================================================== #
+# === Rcfiles.find_this_cd_alias[]
+# =========================================================================== #
+def self.find_this_cd_alias(i)
+  ::Rcfiles::ExpandCdAliases[i]
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME # Testing here.
+  expand_cd_aliases = Rcfiles::ExpandCdAliases.new(ARGV.first)
+  expand_cd_aliases.test
+  puts expand_cd_aliases._
+end # ecdaliases
+    # exda pwwdusr; exda pwddwwd
+    # exda pwdusb4