rcfiles 1.2.46

data/lib/rcfiles/rcfiles/ps1_rc

@@ -0,0 +1,9 @@
+# =========================================================================== #
+# This file was automatically generated at: 03.10.2022
+#
+# The filename is:
+#
+#   /home/x/programming/ruby/src/rcfiles/lib/rcfiles/rcfiles/ps1_rc
+#
+# =========================================================================== #
+export PS1="\\033[48;5;0;38;5;3m"'${PWD%%*/}/'"\\033[0m"

data/lib/rcfiles/rcfiles/special_aliases_rc

@@ -0,0 +1,8 @@
+# =========================================================================== #
+# This file was automatically generated at: 04.07.2021
+#
+# The filename is:
+#
+#   /home/x/programming/ruby/src/rcfiles/lib/rcfiles/rcfiles/special_aliases_rc
+#
+# =========================================================================== #

data/lib/rcfiles/rcfiles/system_rc

@@ -0,0 +1,13 @@
+# =========================================================================== #
+# This file was automatically generated at: 03.10.2022
+#
+# The filename is:
+#
+#   /home/x/programming/ruby/src/rcfiles/lib/rcfiles/rcfiles/system_rc
+#
+# =========================================================================== #
+export computer_name="computer4"
+export distribution_name="HiveOS"
+export os_name="HiveOS"
+export email="shevy@inbox.lt"
+export create_image_gallery="false"

data/lib/rcfiles/rcfiles/system_settings_rc

@@ -0,0 +1,192 @@
+# =========================================================================== #
+# This file was automatically generated at: 03.10.2022
+#
+# The filename is:
+#
+#   /home/x/programming/ruby/src/rcfiles/lib/rcfiles/rcfiles/system_settings_rc
+#
+# =========================================================================== #
+export USERS="/home"
+export USERS_X="/home/x"
+export RSRC=""
+export IS_STD_SYSTEM="1"
+export ABIWORD_FONTPATH="/System/Fonts"
+export THEMES="$USR/share/themes"
+export FRAME_BUFFER0="/dev/fb0"
+export DEFAULT_DELAY_PLAYING_SONGS="2.2"
+export LANGUAGE="en_US"
+export SYSTEM_EDITOR="nano"
+export MY_SYSTEM="/System"
+export SYS="$MY_SYSTEM"
+export SYSTEM_DIR="$MY_SYSTEM"
+export MYSYSTEM="$MY_SYSTEM"
+export SYSTEM_LOGS="$MY_SYSTEM/Logs"
+export SYSTEM_LOG="$SYSTEM_LOGS"
+export MY_CDROM="$MOUNT/CDROM"
+export CDROM="$MY_CDROM"
+export RECIPES="$MY_SYSTEM/Recipes"
+export MY_FILES="$MY_SYSTEM# $MY_SYSTEM/Files"
+export DEPOT="/Depot"
+export DEPOT_DIR="$DEPOT"
+export SL="$MY_SYSTEM"
+export SLE="$SL/Index/bin"
+export SLB="$SLE"
+export SLL="$SL/Index/lib"
+export RBIN="/bin"
+export MY_BIN="$UBIN"
+export DEV="/dev"
+export BASE_LIB="/lib"
+export USR="/usr"
+export MY_ULIB="$USR/lib"
+export UBIN="$USR/bin"
+export USR_INCLUDE="$USR/include"
+export U_INC="$USR_INCLUDE"
+export USRINC="$USR_INCLUDE"
+export UINCLUDE="$USR_INCLUDE"
+export TMP_PREFIX="$USR/test"
+export MYTMPDIR="$DEPOT/jj"
+export DEST_DIR="$MYTMPDIR"
+export MY_TMP_DIR="$MYTMPDIR"
+export VAR="$MY_SYSTEM"
+export MY_CODECS="$MY_SYSTEM/Codecs/"
+export CODECSDIR="$MY_CODECS"
+export USRSRC="$USR/src"
+export FIREWIRE="$MY_MNT/Firewire"
+export MOUNT1="$USB1"
+export MOUNT2="$USB2"
+export MOUNT3="$USB3"
+export MOUNT4="$USB4"
+export MOUNT5="$USB5"
+export MOUNT6="$USB6"
+export SYSLOGS="$VAR/Logs"
+export SYSLOGLOG="$SYSLOGS"
+export SYSLOG="$SYSLOGS"
+export LOG="$SYSLOGS"
+export MY_SYSLIB_DIR="/usr/lib/"
+export MY_SYSLIBS="$MY_SYSLIB_DIR"
+export MY_SYSLIB="$MY_SYSLIB_DIR"
+export SYSLIB_DIR="$MY_SYSLIB_DIR"
+export MYSYSLIB="$MY_SYSLIB_DIR"
+export MY_SYSLIBRARIES="$MY_SYSLIB_DIR"
+export SYSLIBRARIES="$MY_SYSLIB_DIR"
+export MY_SYSL="$MY_SYSLIB_DIR"
+export SYSMAN="$SYSLINKS/Manuals"
+export TRADITIONAL_ETC="/etc"
+export INIT_DIR="$TRADITIONAL_ETC/init.d/"
+export SYS_SETTINGS="$MY_SYSTEM/Settings"
+export ETC="$SYS_SETTINGS"
+export SYSSET="$SYS_SETTINGS"
+export SYSTASKS="$SYSLINKS/Tasks"
+export MY_PKGCONFIG="/usr/lib/pkgconfig"
+export MYPKGCONFIG="$MY_PKGCONFIG"
+export PKGCONFIG_DIR="$MY_PKGCONFIG"
+export SYSPKGCONFIG="$MY_PKGCONFIG"
+export PKG="/usr/lib/pkgconfig"
+export DEPOT_PKG="$PKG_DIR"
+export MY_PACKAGES="$PKG_DIR"
+export PACKAGE_DIR="$PKG_DIR"
+export PACKAGES_DIR="$PKG_DIR"
+export MY_PKG="$PKG_DIR"
+export DEPOT_ISO="$DEPOT/ISOs"
+export DEP_ISO="$DEPOT_ISO"
+export SYSETC="$ETC"
+export FSTAB="/etc/fstab# hmm"
+export ULOCAL="$USR/local"
+export ULOC="$ULOCAL"
+export ULB="$ULOCAL/bin"
+export SHARED_FOLDER="$DEPOT/SharedFolder/"
+export SHAREDFOLDER="$SHARED_FOLDER"
+export ULOCALSHARE="$ULOCAL/share"
+export XINITTAB="/etc/inittab"
+export MY_SWAP="$DEV/sda2"
+export MY_MNT="/Mount"
+export MOUNT="$MY_MNT"
+export MY_MOUNT="$MY_MNT"
+export MY_ROOT="/root"
+export LOCAL_HOME="$USERS"
+export MY_FRAME_BUFFERING="/dev/fb0"
+export USING_LAPTOP="0"
+export MY_XORG="$MY_PROGRAMS/X11"
+export XCONFIG="/etc/X11/xorg.conf"
+export X11_CONFIG="$XCONFIG"
+export X11DOC="$MY_XORG/lib/X11/doc"
+export MODULES="$ETC/modules"
+export XORGLOG="/var/log/Xorg.0.log"
+export PASSWD="$TRADITIONAL_ETC/passwd"
+export SHADOW="$TRADITIONAL_ETC/shadow"
+export FIRMWARE_INSTALL_DIR="/lib/firmware"
+export LILO="/etc/lilo.conf"
+export UPDATE_TYPE="svn"
+export GRUBCONF="/boot/grub/grub.conf"
+export GRUBMENU="$GRUBCONF"
+export MY_GRUB="$GRUBCONF"
+export GRUBLIST="$GRUBCONF"
+export GRUB_MENU="$GRUBCONF"
+export GRUB="$GRUBCONF"
+export FESTPLATTE1="$MOUNT/HDD1"
+export FESTPLATTE2="$MOUNT/HDD2"
+export FIRST_HD="$FESTPLATTE1"
+export SECOND_HD="$FESTPLATTE2"
+export FEST1="$FESTPLATTE1"
+export FEST2="$SECOND_HD"
+export CDDEV="/dev/cdrom"
+export LIVECD="$MOUNT/LIVECD"
+export MY_LIVECD="$DEPOT/LIVECD"
+export MYLIVECD="$LIVECD"
+export DEPOT_VIDEO="$DEPOT/Video"
+export DEPVID="$DEPOT_VIDEO"
+export ACLOCAL_FLAGS="-I /usr/share/aclocal"
+export XCHATSHAREDIR="/usr/local/share/xchat"
+export KEYTABLE="de-latin1-nodeadkeys"
+export KEYBOARDTYPE="pc105"
+export KEYMAP="de-latin1"
+export PAGER="most"
+export SYSFONTS="$MY_SYSTEM/Fonts"
+export MY_FONTS="$SYSFONTS"
+export INPUTRC="/etc/inputrc"
+export IS_ON_GOBOLINUX="0"
+export MY_SYSSHARE_DIR="$SYSLINKS/Shared"
+export SYSSHARED="$MY_SYSSHARE_DIR"
+export SYSSHARE="$MY_SYSSHARE_DIR"
+export SYSSHARE_DIR="$MY_SYSSHARE_DIR"
+export MY_SYSSHARED="$MY_SYSSHARE_DIR"
+export SYSLINKS="$MY_SYSTEM"
+export SYSLINK="$SYSLINKS"
+export SYSDAEMONS="$SYSLINKS/Daemons"
+export SYSENV="$SYSLINKS/Environment"
+export MY_SYSBINARIES="$MY_SYSBIN"
+export MY_SYSBIN_DIR="/usr/bin"
+export MY_SYSBIN="$MY_SYSBIN_DIR"
+export SYSEXEC="$MY_SYSBIN_DIR"
+export SYSBIN_DIR="$MY_SYSBIN_DIR"
+export SYSBINARIES="$MY_SYSBIN_DIR"
+export MY_SYSHEADERS="/usr/include"
+export SYSINC="$MY_SYSHEADERS"
+export SYSINC_DIR="$MY_SYSHEADERS"
+export MY_SYSINCLUDE_DIR="$MY_SYSHEADERS"
+export SYSINCLUDEE="$MY_SYSHEADERS"
+export MY_SYSINCLUDE="$MY_SYSHEADERS"
+export MY_SYSINC="$MY_SYSHEADERS"
+export SYSI="$MY_SYSHEADERS"
+export CHARSET="UTF-8"
+export TZ="Etc/UTC+2"
+export MY_TEMP="/home/Temp"
+export TMPDIR="$MY_TEMP"
+export TEMP_DIR="$MY_TEMP"
+export PROGRAMS_DIR="$USERS/Programs"
+export MY_PROGRAMS="$PROGRAMS_DIR"
+export P="$PROGRAMS_DIR"
+export USB1="$MY_MNT/USB1"
+export MOUNT_USB1="$USB1"
+export USB2="$MY_MNT/USB2"
+export MOUNT_USB2="$USB2"
+export USB3="$MY_MNT/USB3"
+export MOUNT_USB3="$USB3"
+export USB4="$MY_MNT/USB4"
+export MOUNT_USB4="$USB4"
+export USB5="$MY_MNT/USB5"
+export MOUNT_USB5="$USB5"
+export USB6="$MY_MNT/USB6"
+export COOKBOOK_DIRECTORY="/home/x/programming/ruby/src/rbt/lib/rbt/yaml/"
+export REAL_COOKBOOK_DIRECTORY="$COOKBOOK_DIRECTORY/cookbooks"
+export LC_ALL="en_US.utf8"

data/lib/rcfiles/rcfiles/term_rc

@@ -0,0 +1,9 @@
+# =========================================================================== #
+# This file was automatically generated at: 03.10.2022
+#
+# The filename is:
+#
+#   /home/x/programming/ruby/src/rcfiles/lib/rcfiles/rcfiles/term_rc
+#
+# =========================================================================== #
+export TERM="xterm"

data/lib/rcfiles/rcfiles/video_rc

@@ -0,0 +1,24 @@
+# =========================================================================== #
+# This file was automatically generated at: 03.10.2022
+#
+# The filename is:
+#
+#   /home/x/programming/ruby/src/rcfiles/lib/rcfiles/rcfiles/video_rc
+#
+# =========================================================================== #
+export MY_DVD="$MOUNT/DVD"
+export MYDVD="$MY_DVD"
+export DVDD="$MY_DVD"
+export MOUNTED_DVD="$MY_DVD"
+export MY_DVD_COVER="$IMG/VIDEO/COVERS"
+export DVDCOVER="${MY_DVD_COVER}/DVD_COVER.jpg"
+export DVD_COVER="$DVDCOVER"
+export CLIPS="$DEPOT/Video"
+export DEPOT_DVD="$DEPOT/DVD"
+export VIDEO="$CLIPS"
+export MY_VIDEOS="$CLIPS"
+export VID="$VIDEO"
+export VIDEO_STREAM_1="http://streaming-26c3-ice.fem-net.de:3000/saal1"
+export VIDEO_STREAM_2="http://streaming-26c3-ice.fem-net.de:3000/saal2"
+export VIDEO_STREAM_3="http://streaming-26c3-ice.fem-net.de:3000/saal3"
+export MAIN_VIDEO_PLAYER="mplayer"

data/lib/rcfiles/requires/require_the_directory_aliases.rb

@@ -0,0 +1,7 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'rcfiles/requires/require_the_directory_aliases.rb'
+# =========================================================================== #
+require 'rcfiles/directory_aliases/directory_aliases.rb'

data/lib/rcfiles/requires/require_the_rcfiles_constants.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This file will also "bundle" together all the constants for this project.
+# =========================================================================== #
+# require 'rcfiles/requires/require_the_rcfiles_constants.rb'
+# =========================================================================== #
+require 'rcfiles/project/project.rb'
+require 'rcfiles/constants/constants.rb'
+# =========================================================================== #
+# We will also pull in the .rb files under files/ because they were
+# original part of constants/.
+# =========================================================================== #
+require 'rcfiles/files/file_aliases.rb'
+require 'rcfiles/files/file_cd_aliases.rb'
+require 'rcfiles/files/file_programs_aliases.rb'
+require 'rcfiles/files/file_system_settings.rb'

data/lib/rcfiles/requires/require_the_rcfiles_project.rb

@@ -0,0 +1,67 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'rcfiles/requires/require_the_rcfiles_project.rb'
+# =========================================================================== #
+require 'rcfiles/requires/try_to_require_syck_and_psych.rb'
+# =========================================================================== #
+# Require the project/*rb files next:
+# =========================================================================== #
+require 'rcfiles/project/project.rb'
+require 'rcfiles/requires/require_the_rcfiles_constants.rb'
+require 'rcfiles/version/version.rb'
+# =========================================================================== #
+# Next require the files under the files/ subdirectory:
+# =========================================================================== #
+require 'rcfiles/files/file_aliases.rb'
+require 'rcfiles/files/file_cd_aliases.rb'
+require 'rcfiles/files/file_programs_aliases.rb'
+require 'rcfiles/files/file_system_settings.rb'
+# =========================================================================== #
+# Require the help-file:
+# =========================================================================== #
+require 'rcfiles/help/help.rb'
+# =========================================================================== #
+# Next require the colours:
+# =========================================================================== #
+require 'rcfiles/colours/colours.rb'
+# =========================================================================== #
+# Next, load up the .rb files under rcfiles/toplevel_methods. We will
+# keep misc.rb last since it pulls in a few other .rb files.
+# =========================================================================== #
+%w(
+convert
+e
+esystem
+infer
+is_on_roebe
+main_directory
+n_registered_aliases_in_total
+rds
+remove_newlines
+report
+return_standard_header
+use_quotes
+run_it
+use_psych_or_syck
+generate_yaml_files
+autogenerate_rc_file_from_this_yaml_file
+misc
+).each {|this_file|
+  require "rcfiles/toplevel_methods/#{this_file}.rb"
+}
+# =========================================================================== #
+# Require rcfiles commandline-related code:
+# =========================================================================== #
+require 'rcfiles/commandline/commandline.rb'
+# =========================================================================== #
+# Next require the main class of the rcfiles project:
+# =========================================================================== #
+require 'rcfiles/class/rcfiles.rb'
+# =========================================================================== #
+# And also require the directory_aliases component that is part of the
+# rcfiles project since May 2019 (and rewritten in May 2022):
+# =========================================================================== #
+require 'rcfiles/requires/require_the_directory_aliases.rb'
+require 'rcfiles/aggregate_all_rcfiles/aggregate_all_rcfiles.rb'

data/lib/rcfiles/requires/try_to_require_syck_and_psych.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'rcfiles/requires/try_to_require_syck_and_psych.rb'
+# =========================================================================== #
+require 'rcfiles/toplevel_methods/use_psych_or_syck.rb'
+
+case Rcfiles.use_psych_or_syck?
+when :psych
+  require 'psych'
+when :syck
+  begin
+    require 'try_syck'
+  rescue LoadError
+    require 'syck'
+  end
+end

data/lib/rcfiles/toplevel_methods/autogenerate_rc_file_from_this_yaml_file.rb

@@ -0,0 +1,102 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'rcfiles/toplevel_methods/autogenerate_rc_file_from_this_yaml_file.rb'
+# =========================================================================== #
+module Rcfiles
+
+  require 'rcfiles/toplevel_methods/convert.rb'
+  require 'rcfiles/toplevel_methods/main_directory.rb'
+  require 'rcfiles/toplevel_methods/rds.rb'
+  require 'rcfiles/toplevel_methods/return_standard_header.rb'
+  require 'rcfiles/toplevel_methods/save_file.rb'
+
+  begin
+    require 'opn'
+  rescue LoadError; end
+
+  # ========================================================================= #
+  # === Rcfiles.populate_this_directory
+  # ========================================================================= #
+  def self.populate_this_directory(i)
+    self.store_at = i
+    generate_the_most_important_rcfiles
+  end
+
+  # ========================================================================= #
+  # === Rcfiles.autogenerate_rc_file_from_this_yaml_file
+  #
+  # The first argument to this method shall denote the full path to an
+  # existing .yml file.
+  #
+  # The second argument determines whether we will be verbose or silent.
+  # Verbose in this context means to display text to the user.
+  #
+  # Invocation example:
+  #
+  #   Rcfiles.autogenerate_rc_file_from_this_yaml_file('/home/x/data/PROGRAMMING_LANGUAGES/RUBY/src/rcfile_generator/lib/rcfile_generator/yaml/cd_aliases.yml')
+  #
+  # ========================================================================= #
+  def self.autogenerate_rc_file_from_this_yaml_file(
+      this_yaml_file = 1,
+      be_verbose     = true
+    )
+    # ======================================================================= #
+    # Next denote the base directory to use.
+    # ======================================================================= #
+    base_directory_to_use = main_directory?
+    # ======================================================================= #
+    # Handle some common symbols next. These are assumed to be shortcuts.
+    # Additionally we will support some numbers as well.
+    # ======================================================================= #
+    case this_yaml_file # case tag
+    # ======================================================================= #
+    # === :cd_aliases
+    # ======================================================================= #
+    when :cd_aliases,
+         1,
+         '1'
+      this_yaml_file = file_cd_aliases?
+    # ======================================================================= #
+    # === :aliases
+    # ======================================================================= #
+    when :aliases,
+         2,
+         '2'
+      this_yaml_file = file_aliases?
+    # ======================================================================= #
+    # === :program_aliases
+    # ======================================================================= #
+    when :program_aliases,
+         3,
+         '3'
+      this_yaml_file = file_programs_aliases?
+    end
+    if File.exist? this_yaml_file
+      where = rds(
+        base_directory_to_use+
+        File.basename(this_yaml_file).
+        sub(/\.yml$/,'')+'_rc'.dup
+      )
+      # ===================================================================== #
+      # If the file exists, we can continue. We will assume that the
+      # yaml file at hand is of export-type, that is, the variables
+      # will be like: export FOO="bar"
+      # ===================================================================== #
+      if be_verbose
+        opn; e "Next loading from the file #{sfile(this_yaml_file)}"
+      end
+      yaml_dataset = YAML.load_file(this_yaml_file)
+      # store_this_data = ensure_main_encoding(''.dup)
+      # store_this_data << ensure_main_encoding(return_standard_header(where))
+      store_this_data = return_standard_header(where).dup
+      store_this_data << convert_hash_to_export_file(yaml_dataset, :ensure_proper_encoding)
+      if be_verbose
+        opn; e "Storing into -> `#{sfile(where)}`."
+      end
+      write_what_into(store_this_data.chomp, where)
+    end
+  end; self.instance_eval { alias generate autogenerate_rc_file_from_this_yaml_file } # === Rcfiles.generate
+
+end

data/lib/rcfiles/toplevel_methods/change_directory.rb

@@ -0,0 +1,16 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'rcfiles/toplevel_methods/change_directory.rb'
+# =========================================================================== #
+module Rcfiles
+
+  # ========================================================================= #
+  # === Rcfiles.change_directory
+  # ========================================================================= #
+  def self.change_directory(i)
+    Dir.chdir(i) if File.directory? i
+  end; self.instance_eval { alias cd change_directory } # === Rcfiles.cd
+
+end

data/lib/rcfiles/toplevel_methods/convert.rb

@@ -0,0 +1,118 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This file contains code that can convert a .yml file into a bash
+# rcfile, either using "alias" or "export" statements.
+# =========================================================================== #
+# require 'rcfiles/toplevel_methods/convert.rb'
+# Rcfiles.convert_this_hash_to_export_file
+# =========================================================================== #
+module Rcfiles
+
+  require 'rcfiles/constants/constants.rb'
+  require 'rcfiles/toplevel_methods/remove_newlines.rb'
+  require 'rcfiles/toplevel_methods/use_quotes.rb'
+
+  # ========================================================================= #
+  # === Rcfiles.convert_this_hash_to_alias_file
+  #
+  # This method expects a Hash as input.
+  # ========================================================================= #
+  def self.convert_this_hash_to_alias_file(
+      hash
+    )
+    _ = ''.dup # <- Our return String.
+    hash.each_pair {|key, value|
+      value = remove_newlines(value.to_s.strip)
+      if @use_quotes 
+        _ << "alias '#{key}'=\"#{value}\"#{N}"
+      else
+        _ << "alias #{key}=#{value}#{N}"
+      end
+    } if hash
+    return _
+  end; self.instance_eval { alias convert_hash_to_alias_file convert_this_hash_to_alias_file } # === Rcfiles.convert_hash_to_alias_file
+
+  # ========================================================================= #
+  # === Rcfiles.convert_this_array_to_export_file
+  #
+  # This method expects an Array as input.
+  #
+  # Arrays are handled a bit differently, though - they will be aggregated
+  # into one input value for "export".
+  # ========================================================================= #
+  def self.convert_this_array_to_export_file(
+      array,
+      optional_second_input_as_name_of_the_export_variable = 'PKG_CONFIG_PATH'
+    )
+    if array and array.is_a?(Array)
+      _ = ''.dup # <- Our return String.
+      joined = array.join(':').strip
+      _ << "export #{optional_second_input_as_name_of_the_export_variable}=\"#{joined}\"#{N}"
+      return _
+    else
+      array
+    end
+  end; self.instance_eval { alias convert_array_to_export_file convert_this_array_to_export_file } # === Rcfiles.convert_array_to_export_file
+
+  # ========================================================================= #
+  # === Rcfiles.convert_this_input_to_export_file
+  # ========================================================================= #
+  def self.convert_this_input_to_export_file(
+      i, optional_second_input_as_name_of_the_export_variable = nil
+    )
+    case i
+    when Hash
+      # ===================================================================== #
+      # Hashes will ignore the optional second argument to this method, even
+      # if it has been provided. The reason is primarily because we expect
+      # a key -> value entry of a Hash already, so the kew is known; whereas
+      # for an Array, we actually need the user to supply the name of the
+      # key at hand.
+      # ===================================================================== #
+      convert_this_hash_to_export_file(i)
+    when Array
+      convert_this_array_to_export_file(i, optional_second_input_as_name_of_the_export_variable)
+    when String
+      convert_this_array_to_export_file([i], optional_second_input_as_name_of_the_export_variable)
+    else
+      e "Unregistered input-class (#{i.class})"
+    end
+  end
+
+  # ========================================================================= #
+  # === Rcfiles.convert_this_hash_to_export_file
+  #
+  # This method expects a Hash as input. If you need a bit more flexibility
+  # then you are encouraged to use the other method, called
+  # Rcfiles.convert_this_input_to_export_file() instead.
+  # ========================================================================= #
+  def self.convert_this_hash_to_export_file(
+      hash,
+      ensure_proper_encoding = false
+    )
+    case ensure_proper_encoding
+    when :ensure_proper_encoding
+      ensure_proper_encoding = true
+    end
+    _ = ''.dup # <- Our return String.
+    hash.each_pair {|key, value|
+      value = value.to_s.strip
+      if ensure_proper_encoding
+        value = ensure_proper_encoding_for(value)
+        key   = ensure_proper_encoding_for(value)
+      end
+      value = value.tr("\n", ' ').squeeze(' ')
+      _ << "export #{key}=\"#{value}\"#{N}"
+    } if hash
+    return _
+  end; self.instance_eval { alias convert_hash_to_export_file convert_this_hash_to_export_file } # === Rcfiles.convert_hash_to_export_file
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Rcfiles.convert_this_hash_to_export_file(
+    { cat: :tom, mouse: :jerry }
+  )
+end

data/lib/rcfiles/toplevel_methods/convert_global_variables_in_the_cd_aliases_file_to_a_standalone_yaml_file.rb

@@ -0,0 +1,50 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'rcfiles/toplevel_methods/convert_global_variables_in_the_cd_aliases_file_to_a_standalone_yaml_file.rb'
+# =========================================================================== #
+module Rcfiles
+
+  require 'rcfiles/toplevel_methods/e.rb'
+
+  # ========================================================================= #
+  # === Rcfiles.convert_global_variables_in_the_cd_aliases_file_to_a_standalone_yaml_file
+  #
+  # This method will collect all $ global variables found in the file
+  # called "cd_aliases.yml" into a standalone .yml file. That .yml file
+  # can then be loaded by other projects.
+  # ========================================================================= #
+  def self.convert_global_variables_in_the_cd_aliases_file_to_a_standalone_yaml_file(
+      use_this_as_the_input_file = 
+        '/home/x/programming/ruby/src/rcfiles/lib/rcfiles/yaml/cd_aliases.yml'
+    )
+    require 'yaml'
+    require 'convert_global_env'
+    require 'save_file'
+    use_this_regex = /\$(\w+)/ # See: https://rubular.com/r/w75cLOvTTDfJvL
+    _ = use_this_as_the_input_file
+    if File.exist? _
+      dataset = File.read(_)
+      scanned = dataset.scan(use_this_regex).flatten.uniq
+      # Now we have the array. We next have to build up our main Hash.
+      hash = {}
+      scanned.each {|this_key|
+        hash[this_key] = ConvertGlobalEnv['$'+this_key]
+      }
+      what = YAML.dump(hash)
+      into = '/home/x/programming/ruby/src/rcfiles/lib/rcfiles/yaml/global_variables/'\
+             'global_variables_extracted_from_the_file_cd_aliases.yml'
+      e 'Storing into the file `'+into+'`.'
+      SaveFile.write_what_into(what, into)
+      store_this = YAML.dump(scanned)
+    else
+      e 'No file exists at '+_+'.'
+    end
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Rcfiles.convert_global_variables_in_the_cd_aliases_file_to_a_standalone_yaml_file
+end