rcfiles 1.2.46

data/lib/rcfiles/toplevel_methods/create_windows_cd_aliases_bat_file.rb

@@ -0,0 +1,51 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'rcfiles/toplevel_methods/create_windows_cd_aliases_bat_file.rb'
+# =========================================================================== #
+module Rcfiles
+
+  require 'rcfiles/files/file_cd_aliases.rb'
+  require 'rcfiles/toplevel_methods/e.rb'
+  require 'rcfiles/toplevel_methods/save_file.rb'
+
+  # ========================================================================= #
+  # === Rcfiles.create_windows_cd_aliases_bat_file
+  # ========================================================================= #
+  def self.create_windows_cd_aliases_bat_file
+    _ = ::Rcfiles.file_cd_aliases?
+    if File.exist? _
+      require 'yaml'
+      dataset = YAML.load_file(_)
+      _ = ''.dup
+      begin
+        require 'convert_global_env'
+      rescue LoadError; end
+      dataset.each_pair {|key, value|
+        # =================================================================== #
+        # value may contain a $, such as in $MAIN_WORK.
+        # If this is the case then we will as ConvertGlobalEnv[]
+        # to translate this for us.
+        # =================================================================== #
+        if value.include? '$'
+          value = ConvertGlobalEnv[value]
+        end
+        _ << 'function '+key.to_s+' { set-location "'+value.to_s+'" }'+N
+      }
+      # ===================================================================== #
+      # Now we can simply store this String into a file.
+      # ===================================================================== #
+      into = 'cd_aliases.bat'
+      e 'Storing into the file '+into+' next.'
+      write_what_into(_, into)
+    else
+      e 'No file exists at '+_+'.'
+    end
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Rcfiles.create_windows_cd_aliases_bat_file  
+end # rb create_windows_cd_aliases_bat_file.rb

data/lib/rcfiles/toplevel_methods/e.rb

@@ -0,0 +1,16 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'rcfiles/toplevel_methods/e.rb'
+# =========================================================================== #
+module Rcfiles
+
+  # ========================================================================= #
+  # === Rcfiles.e
+  # ========================================================================= #
+  def self.e(i = '')
+    puts i
+  end
+
+end

data/lib/rcfiles/toplevel_methods/esystem.rb

@@ -0,0 +1,19 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'rcfiles/toplevel_methods/esystem.rb'
+# =========================================================================== #
+require 'rcfiles/toplevel_methods/e.rb'
+
+module Rcfiles
+
+  # ========================================================================= #
+  # === Rcfiles.esystem
+  # ========================================================================= #
+  def self.esystem(i)
+    e i
+    system i
+  end
+
+end

data/lib/rcfiles/toplevel_methods/generate_yaml_files.rb

@@ -0,0 +1,148 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Rcfiles.generate_yaml_files
+#
+# This file will generate .yml files that will conform to UTF8 by default.
+#
+# Usage example:
+#
+#   Rcfiles.generate_yaml_files
+#
+# =========================================================================== #
+# require 'rcfiles/toplevel_methods/generate_yaml_files.rb'
+# =========================================================================== #
+module Rcfiles
+
+  require 'fileutils'
+  require 'rcfiles/files/file_cd_aliases.rb'
+  require 'rcfiles/files/file_aliases.rb'
+  require 'rcfiles/files/file_programs_aliases.rb'
+  require 'rcfiles/constants/constants.rb'
+  require 'rcfiles/toplevel_methods/e.rb'
+  require 'rcfiles/toplevel_methods/esystem.rb'
+  require 'rcfiles/toplevel_methods/save_file.rb'
+
+  # ========================================================================= #
+  # === Rcfiles.generate_yaml_files
+  #
+  # The main idea behind this method is to be able to work with UTF8
+  # encoded files.
+  # ========================================================================= #
+  def self.generate_yaml_files(
+      use_this_encoding = :utf8
+    )
+    require 'yaml'
+    # ======================================================================= #
+    # === Handle the file 'cd_aliases.yml' next
+    # ======================================================================= #
+    _ = file_cd_aliases?
+    if File.exist? _
+      string = ''.dup
+      begin
+        dataset_hash = YAML.load_file(_)
+        dataset_hash.each_pair {|key, value|
+          key   = ensure_main_encoding(key.to_s,   use_this_encoding)
+          value = ensure_main_encoding(value.to_s, use_this_encoding)
+          unless key.start_with? '"'
+            key = "\"#{key}\""
+          end
+          unless value.start_with? '"'
+            value = "\"#{value}\""
+          end
+          key   = ensure_main_encoding(key.to_s,   use_this_encoding)
+          value = ensure_main_encoding(value.to_s, use_this_encoding)
+          string << "#{key}: #{value}\n"
+        }
+        what = string
+        target_file = '/Depot/'+File.basename(_)
+        new_target_file = '/Depot/'+File.basename(_).sub(/\.#{File.extname(_)}$/,'')+'2.yml'
+        e 'Will store into the file `'+target_file+'`.'  
+        write_what_into(what, target_file)
+        system 'iconv -f ISO-8859-1 -t UTF-8 '+target_file+' >> '+new_target_file
+        File.delete(target_file)
+        FileUtils.mv(new_target_file, target_file)
+      rescue ArgumentError => error
+        pp error
+      end
+    else
+      e 'No file could be found at `'+_+'`.'
+    end
+    # ======================================================================= #
+    # === Handle the file 'aliases.yml' next
+    # ======================================================================= #
+    _ = file_aliases?
+    if File.exist? _
+      string = ''.dup
+      begin
+        dataset_hash = YAML.load_file(_)
+        dataset_hash.each_pair {|key, value|
+          key   = ensure_main_encoding(key.to_s,   use_this_encoding)
+          value = ensure_main_encoding(value.to_s, use_this_encoding)
+          unless key.start_with? '"'
+            key = "\"#{key}\""
+          end
+          unless value.start_with? '"'
+            value = "\"#{value}\""
+          end
+          key   = ensure_main_encoding(key.to_s,   use_this_encoding)
+          value = ensure_main_encoding(value.to_s, use_this_encoding)
+          string << "#{key}: #{value}\n"
+        }
+        what = string
+        target_file = "/Depot/#{File.basename(_)}"
+        new_target_file = '/Depot/'+File.basename(_).sub(/\.#{File.extname(_)}$/,'')+'2.yml'
+        e 'Will store into the file `'+target_file+'`.'  
+        write_what_into(what, target_file)
+        system 'iconv -f ISO-8859-1 -t UTF-8 '+target_file+' >> '+new_target_file
+        File.delete(target_file)
+        FileUtils.mv(new_target_file, target_file)
+      rescue ArgumentError => error
+        pp error
+      end
+    else
+      e 'No file could be found at `'+_+'`.'
+    end
+    # ======================================================================= #
+    # === Handle the file 'programs_aliases.yml' next
+    # ======================================================================= #
+    _ = file_programs_aliases?
+    if File.exist? _
+      string = ''.dup
+      begin
+        dataset_hash = YAML.load_file(_)
+        dataset_hash.each_pair {|key, value|
+          key   = ensure_main_encoding(key.to_s,   use_this_encoding)
+          value = ensure_main_encoding(value.to_s, use_this_encoding)
+          unless key.start_with? '"'
+            key = "\"#{key}\""
+          end
+          unless value.start_with? '"'
+            value = "\"#{value}\""
+          end
+          key   = ensure_main_encoding(key.to_s,   use_this_encoding)
+          value = ensure_main_encoding(value.to_s, use_this_encoding)
+          string << "#{key}: #{value}\n"
+        }
+        what = string
+        target_file = '/Depot/'+File.basename(_)
+        new_target_file = '/Depot/'+File.basename(_).sub(/\.#{File.extname(_)}$/,'')+'2.yml'
+        e 'Will store into the file `'+target_file+'`.'  
+        write_what_into(what, target_file)
+        system 'iconv -f ISO-8859-1 -t UTF-8 '+target_file+' >> '+new_target_file
+        File.delete(target_file)
+        FileUtils.mv(new_target_file, target_file)
+      rescue ArgumentError => error
+        pp error
+      end
+    else
+      e "No file could be found at `#{_}`."
+    end
+  end; self.instance_eval { alias syck_generate generate_yaml_files } # === Rcfiles.syck_generate
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Rcfiles.generate_yaml_files  
+end

data/lib/rcfiles/toplevel_methods/infer.rb

@@ -0,0 +1,83 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'rcfiles/toplevel_methods/infer.rb'
+# =========================================================================== #
+require 'rcfiles/toplevel_methods/e.rb'
+require 'rcfiles/toplevel_methods/main_directory.rb'
+require 'rcfiles/files/file_aliases.rb'
+require 'rcfiles/files/file_cd_aliases.rb'
+require 'rcfiles/files/file_programs_aliases.rb'
+
+module Rcfiles
+
+  # ========================================================================= #
+  # === Rcfiles.infer
+  #
+  # This method can be used to automatically infer, based on the input,
+  # what we may wish to do - in particular setting the path to one
+  # of the three major alias-groups of the Rcfiles project.
+  #
+  # For example, take the following API:
+  #
+  #   Rcfiles.infer 'programs_aliases.yml'
+  #
+  # which will be translated into the following, longer variant:
+  #
+  #   Rcfiles.set_programs_aliases(File.absolute_path('programs_aliases.yml'))
+  #
+  # As you can see, the first variant is significantly shorter to use. The
+  # trailing '.yml' part can be omitted as well, so the following is
+  # also possible:
+  #
+  #   Rcfiles.infer 'programs_aliases.yml'
+  #
+  # Generic usage examples:
+  #
+  #   Rcfiles.infer 'aliases.yml'          # => "/Depot/j/aliases.yml"
+  #   Rcfiles.infer 'cd_aliases.yml'       # => "/Depot/j/cd_aliases.yml"
+  #   Rcfiles.infer 'programs_aliases.yml' # => "/Depot/j/programs_aliases.yml"
+  #   Rcfiles.infer 'system_settings.yml'  # => "/Depot/j/system_settings.yml"
+  #
+  # ========================================================================= #
+  def self.infer(
+      i = 'programs_aliases'
+    )
+    if i.is_a? String
+      i = i.dup if i.frozen?
+      i << '.yml' unless i.end_with? '.yml' # Append the '.yml' substring in this case.
+    end
+    case i
+    # ======================================================================= #
+    # === system_settings.yml
+    # ======================================================================= #
+    when /system_?settings\.yml$/
+      set_file_aliases(
+        File.absolute_path(i)
+      )
+    # ======================================================================= #
+    # === aliases.yml
+    # ======================================================================= #
+    when /aliases\.yml$/
+      set_file_aliases(
+        File.absolute_path(i)
+      )
+    # ======================================================================= #
+    # === cd_aliases.yml
+    # ======================================================================= #
+    when /cd_?aliases\.yml$/
+      set_cd_aliases(
+        File.absolute_path(i)
+      )
+    # ======================================================================= #
+    # === programs_aliases.yml
+    # ======================================================================= #
+    when /programs_?aliases\.yml$/
+      set_programs_aliases(
+        File.absolute_path(i)
+      )
+    end
+  end
+
+end

data/lib/rcfiles/toplevel_methods/is_on_roebe.rb

@@ -0,0 +1,16 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'rcfiles/toplevel_methods/is_on_roebe.rb'
+# =========================================================================== #
+module Rcfiles
+
+  # ========================================================================= #
+  # === Rcfiles.is_on_roebe?
+  # ========================================================================= #
+  def self.is_on_roebe?
+    ENV['IS_ROEBE'].to_s == '1'
+  end
+
+end

data/lib/rcfiles/toplevel_methods/main_directory.rb

@@ -0,0 +1,108 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# The purpose of the file is to designate our main target directory -
+# that is, the directory in which we will store the rc-generated files.
+# =========================================================================== #
+# require 'rcfiles/toplevel_methods/main_directory.rb'
+# Rcfiles.main_directory?
+# =========================================================================== #
+require 'rcfiles/constants/constants.rb'
+require 'rcfiles/toplevel_methods/e.rb'
+require 'rcfiles/toplevel_methods/no_file_exists_at.rb'
+require 'rcfiles/toplevel_methods/save_file.rb'
+
+module Rcfiles
+
+  # ========================================================================= #
+  # === @store_into_this_directory
+  # ========================================================================= #
+  @store_into_this_directory = nil
+
+  # ========================================================================= #
+  # === Rcfiles.main_directory?
+  #
+  # This method will return e. g. "/AUTOGENERATED/".
+  #
+  # Note that you can modify this value, via the method stored in this
+  # file here, called Rcfiles.set_store_into_this_directory().
+  # ========================================================================= #
+  def self.main_directory?(
+      i = FILE_STORE_INTO_THIS_DIRECTORY
+    )
+    # ======================================================================= #
+    # The toplevel instance variable @store_into_this_directory will
+    # have priority. (Ideally this should be the only way how to
+    # query which directory is the current main one.)
+    # ======================================================================= #
+    if @store_into_this_directory
+      return @store_into_this_directory
+    elsif File.exist? i
+      result = YAML.load_file(i)
+      if result == false
+        result = CREATE_RCFILES_WHERE
+      end
+      result = result.to_s.chomp
+      return result
+    else
+      no_file_exists_at(i)
+    end
+  end; self.instance_eval { alias store_at? main_directory? } # === Rcfiles.store_at?
+       self.instance_eval { alias main_dir? main_directory? } # === Rcfiles.main_dir?
+
+  # ========================================================================= #
+  # === Rcfiles.store_at=
+  # ========================================================================= # 
+  def self.store_at=(i)
+    unless i.end_with? '/'
+      i = i.dup if i.frozen?
+      i << '/'
+    end
+    @store_into_this_directory = i
+  end; self.instance_eval { alias store_at store_at= } # === Rcfiles.store_at
+
+  # ========================================================================= #
+  # === Rcfiles.set_store_into_this_directory
+  #
+  # If the second argument to this method is true then we will also
+  # save this information into a local file.
+  # ========================================================================= #
+  def self.set_store_into_this_directory(
+      i              = :pwd,
+      save_into_file = true
+    )
+    case i
+    when 'pwd',
+         'Dir.pwd',
+         :pwd
+      i = Dir.pwd
+    end
+    i << '/' unless i.end_with? '/'
+    self.store_at = i
+    what = i
+    into = FILE_STORE_INTO_THIS_DIRECTORY
+    if save_into_file
+      e "We will store into the directory `#{sdir(what.to_s)}` from now on."
+      e "This will be saved into the file `#{sfile(into)}`."
+      write_what_into(what, into)
+    end
+    # ======================================================================= #
+    # Also save it on my home system.
+    # ======================================================================= #
+    this_dir =
+      "#{RUBY_SRC_DIR_AT_HOME}rcfiles/lib/rcfiles/yaml/"
+    if (ENV['IS_ROEBE'].to_s == '1') and
+        File.directory?(this_dir) and
+        save_into_file
+      into = "#{this_dir}store_into_this_directory.yml" # <- Save into this file here.
+      e "And also into the file `#{sfile(into)}`."
+      write_what_into(what, into)
+    end
+  end; self.instance_eval { alias set_main_directory set_store_into_this_directory } # === Rcfiles.set_main_directory
+       self.instance_eval { alias set_path           set_store_into_this_directory } # === Rcfiles.set_path
+       self.instance_eval { alias set_store_here     set_store_into_this_directory } # === Rcfiles.set_store_here
+       self.instance_eval { alias set_store_into     set_store_into_this_directory } # === Rcfiles.set_store_into
+       self.instance_eval { alias base_dir=          set_store_into_this_directory } # === Rcfiles.base_dir=
+
+end