colours 0.8.12 → 0.9.8

data/lib/colours/{colour_methods/colour_methods.rb → sfile_sdir_sfancy_swarn_simp_scomments_and_ssymlink/sfile_sdir_sfancy_swarn_simp_scomments_and_ssymlink.rb}

@@ -2,229 +2,185 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# require 'colours/colour_methods/colour_methods.rb'
+# require 'colours/sfile_sdir_sfancy_swarn_simp_scomments_and_ssymlink/sfile_sdir_sfancy_swarn_simp_scomments_and_ssymlink.rb'
 # =========================================================================== #
 module Colours
 
-  require 'colours/toplevel_methods/revert.rb'
-  require 'colours/colour_table/colour_table.rb'
-  require 'colours/map_symbol_to_corresponding_colour/map_symbol_to_corresponding_colour.rb'
-  require 'colours/autogenerated/support_for_html_colours.rb'
+  require 'colours/toplevel_methods/rev.rb'
+  require 'colours/module_256_colours/module_256_colours.rb'
+  require 'colours/toplevel_methods/map_this_symbol_to_that_html_colour.rb'
 
   # ========================================================================= #
-  # === Colours.ecomment
+  # === @use_html_colours
   #
-  # This method was added on Nov 2013.
+  # This is a separate variable so that we can selectively disable or
+  # enable the colours for the Konsole submodule. Some terminals do
+  # not respond nicely to the R,G,B values that the Konsole submodule
+  # may require.
   #
-  # In April 2014, the ability to split at any arbitrary character was
-  # added, which can be controlled via the second argument given to
-  # that method. By default it will split on the token '#'.
+  # Since as of November 2023 this variable is semi-deprecated, but
+  # not entirely disabled.
   # ========================================================================= #
-  def self.ecomment(
-      i,
-      optional_split_at_this_character = '#', # ← Specify which character to split at.
-      first_colour_to_use         = :steelblue,
-      second_colour_to_use        = :seagreen,
-      colour_to_use_for_the_token = :slategray
-    )
-    _ = i.to_s
-    if optional_split_at_this_character.is_a? Hash
-      # ===================================================================== #
-      # === :token
-      # ===================================================================== #
-      if optional_split_at_this_character.has_key? :token
-        optional_split_at_this_character = optional_split_at_this_character.delete :token
-      end
-    end
-    optional_split_at_this_character = optional_split_at_this_character.to_s
-    # ======================================================================= #
-    # === If we can find a token to split at
-    # ======================================================================= #
-    if _.include? optional_split_at_this_character
-      _ = _.dup if _.frozen?
-      splitted = _.split(optional_split_at_this_character)
-      first_part  = ::Colours::SupportForHTMLColours.send(first_colour_to_use, splitted.first)
-      middle_part = ::Colours::SupportForHTMLColours.send(colour_to_use_for_the_token, optional_split_at_this_character)
-      second_part = ::Colours::SupportForHTMLColours.send(second_colour_to_use, splitted.last)
-      _ = first_part+
-          middle_part+
-          second_part+
-          ::Colours.rev
-    end
-    e _
-  end
+  @use_html_colours = true
 
   # ========================================================================= #
-  # === Colours.default_colour
+  # === @colour_table                      (default tag, default colours tag)
   #
-  # Invocation example:
+  # This toplevel instance variable has the default colours assigned to
+  # the different methods. If you ever wish to change the default colours
+  # in use, you can do so by manipulating this instance variable.
   #
-  #   puts Colours.default_colour('Hello world!')
+  # The colour-table is a table that maps from e. g. sfancy() to the
+  # corresponding colour at hand.
   #
+  # Keep it sorted alphabetically.
   # ========================================================================= #
-  def self.default_colour(
-      i            = '',
-      make_newline = false
-    )
-    if @use_colours
-      if make_newline
-        i = "#{i}#{N}"
-      end
-      if @use_html_colours
-        i = SupportForHTMLColours.send(@colour_table[__method__.to_sym], i)
-      elsif @use_256_colours
-        use_this_colour = map_this_symbol_to_that_256_colour(@colour_table[__method__.to_sym])  
-        i = SupportFor256Colours.send(use_this_colour, i)
-      else
-        i = "#{corresponding_colour?(@colour_table[__method__.to_sym])}"\
-            "#{i}"\
-            "#{rev}"
-      end
-    end
-    return i
-  end
+  @colour_table = {
+    default_colour:  :green,
+    sfancy:          :bold_green,   # === sfancy()
+    # sargument:       :bold_green,   # === sargument()
+    scomments:       :grey,         # === scomments()
+    sdir:            :chocolate,    # === sdir()
+    sfile:           :saddlebrown,  # === sfile()
+    simportant:      :gold,         # === simportant()
+    ssymlink:        :lightblue,    # === ssymlink()
+    swarn:           :bold_red,     # === swarn()
+    # snormal:         :light_grey    # === snormal()
+  }
 
   # ========================================================================= #
-  # === edir
-  # ========================================================================= #
-  def edefault_colour(
-      i            = '',
-      make_newline = false
-    )
-    e ::Colours.default_colour(i, make_newline)
-  end
-
-  # ========================================================================= #
-  # === default_colour
-  # ========================================================================= #
-  def default_colour(i = '')
-    ::Colours.default_colour(i)
-  end
-
-  # ========================================================================= #
-  # === edir
+  # === Colours::HASH_NEW_COLOURS
+  #
+  # This is the new hash, which we can transition-into if necessary.
+  #
+  # Since as of the year 2018, this Hash is rarely used anymore, though.
+  #
+  # If you want to use these colours nonetheless, you can use this simpler API:
+  #
+  #    Colourss.set_method_to_colour_table(:new_colours)
+  #
   # ========================================================================= #
-  def edir(
-      i            = '',
-      make_newline = false
-    )
-    e ::Colours.sdir(i, make_newline)
-  end
+  HASH_NEW_COLOURS = {
+    default_colour: :green,        
+    # sargument:    :bold_brown,       # === sarg()      # removed in November 2023.
+    # scomments:    :bold_blue,        # === scomments() # removed in November 2023.
+    sdir:           :thistle,          # === sdir()
+    sfancy:         :rosybrown,        # === sfancy()
+    sfile:          :brown,            # === sfile()
+    simportant:     :pink,             # === simportant()
+    ssymlink:       :teal,             # === ssymlink()
+    swarn:          :olivedrab,        # === swarn
+    snormal:        :mediumaquamarine, # === snormal()
+    scomments:      :grey,             # === scomments()
+  }
 
   # ========================================================================= #
-  # === sdir
+  # === Colours.update_the_colour_codes_with                     (update tag)
   # ========================================================================= #
-  def sdir(
-      i = '', make_newline = false
+  def self.update_the_colour_codes_with(
+      i = HASH_NEW_COLOURS
     )
-    ::Colours::sdir(i, make_newline)
-  end
+    @colour_table.update(i)
+  end; self.instance_eval { alias update_colour_table_with update_the_colour_codes_with } # === Colours.update_colour_table_with
+       self.instance_eval { alias update_the_colour_codes  update_the_colour_codes_with } # === Colours.update_the_colour_codes
+       self.instance_eval { alias update_colour_codes      update_the_colour_codes_with } # === Colours.update_colour_codes
 
   # ========================================================================= #
-  # === Colours.sargument
+  # === Colours.sfancy
   #
   # Invocation example:
   #
-  #   Colours.sargument('Hello world!')
+  #   Colours.sfancy('Hello world!')
   #
   # ========================================================================= #
-  def self.sargument(
+  def self.sfancy(
       i            = '',
       make_newline = false
     )
-    if make_newline
-      i = "#{i}#{N}"
-    end
-    if @use_colours
-      if @use_html_colours
-        i = SupportForHTMLColours.send(@colour_table[__method__.to_sym], i)
-      elsif @use_256_colours
-        use_this_colour = map_this_symbol_to_that_256_colour(@colour_table[__method__.to_sym])
-        i = SupportFor256Colours.send(use_this_colour, i)
-      else
-        i = "#{corresponding_colour?(@colour_table[__method__.to_sym])}"\
-            "#{i}"\
-            "#{rev}"
-      end
+    # ======================================================================= #
+    # Fetch the appropriate replacement-colour next:
+    # ======================================================================= #
+    replacement_colour = @colour_table[__method__.to_sym].to_sym
+    unless ::Colours::HtmlColoursMethods.respond_to?(replacement_colour.to_sym)
+      replacement_colour = ::Colours.map_this_symbol_to_that_html_colour(replacement_colour.to_sym)
     end
-    i
-  end; self.instance_eval { alias argument sargument } # === Colours.argument
-       self.instance_eval { alias sarg     sargument } # === Colours.sarg
-
-  # ========================================================================= #
-  # === sargument
-  # ========================================================================= #
-  def sargument(
-      i = '',
-      make_newline = false
-    )
-    ::Colours.sargument(i, make_newline)
-  end; alias sarg sargument # === sarg
-  
-  # ========================================================================= #
-  # === eargument
-  # 
-  # The various simple colourize methods.
-  # ========================================================================= #
-  def eargument(
-      i            = '',
-      make_newline = false
-    )
-    e ::Colours.sargument(i, make_newline)
+    return ::Colours::HtmlColoursMethods.send(replacement_colour, i)
   end
 
   # ========================================================================= #
-  # === Colours.sdir
+  # === use_new_colour_codes
   #
-  # Invocation example:
+  # Use this method to assign new colour codes.
+  # We assume that you must pass a hash to this method.
+  #
+  # Usage example:
   #
-  #   puts Colours.sdir('Hello world!')
+  #   new_hash = {
+  #     :sfancy         => 'green',
+  #     :simportant     => 'teal',
+  #     :default_colour => 'grey',
+  #     :sfile          => 'magenta',
+  #     :sdir           => 'cyan'
+  #   }
+  #   Colours.assign_new_colour_codes(new_hash)
   #
   # ========================================================================= #
-  def self.sdir(
-      i            = '',
-      make_newline = false
+  def use_new_colour_codes(
+      i = HASH_NEW_COLOURS
     )
-    if make_newline
-      i = "#{i}#{N}"
-    end
-    if @use_colours
-      if @use_html_colours
-        i = SupportForHTMLColours.send(@colour_table[__method__.to_sym], i)
-      elsif @use_256_colours
-        use_this_colour = map_this_symbol_to_that_256_colour(@colour_table[__method__.to_sym])  
-        i = SupportFor256Colours.send(use_this_colour, i)
-      else
-        i = "#{corresponding_colour?(@colour_table[__method__.to_sym])}"\
-            "#{i}"\
-            "#{rev}"
-      end
-    end
-    i
-  end
+    @colour_table.update(i)
+  end; alias assign_new_colour_codes use_new_colour_codes # === assign_new_colour_codes
 
   # ========================================================================= #
-  # === Colours.sfile_or_sdir
+  # === Colours.set_colour_table
   #
-  # This method will directly delegate to either Colours.sfile() or
-  # Colours.sdir().
+  # This method can be used to modify the instance variable
+  # @colour_table.
   #
-  # Usage example:
-  #
-  #   Colours.sfile_or_sdir('/home/x/Temp/MyGems/')
-  #   Colours.sfile_or_sdir('/home/x/Temp/opened_files.yml')
+  # The input to this method should be a Hash. It can also be a Symbol,
+  # in which case we will try to find a Hash that corresponds to that
+  # Symbol.
   #
+  # If in doubt, pass in a Hash though.
   # ========================================================================= #
-  def self.sfile_or_sdir(
-      i            = '',
-      make_newline = false
+  def self.set_colour_table(
+      i = :new_colours
     )
-    if File.exist?(i) and File.file?(i)
-      return ::Colours.sfile(i, make_newline)
-    elsif File.directory?(i)
-      return ::Colours.sdir(i, make_newline)
+    case i
+    # ======================================================================= #
+    # === :new_colours
+    # ======================================================================= #
+    when :new_colours,
+         :new_colour_table,
+         :default
+      i = HASH_NEW_COLOURS
     end
-  end; self.instance_eval { alias sdir_or_sfile sfile_or_sdir } # === Colours.sdir_or_sfile
+    # ======================================================================= #
+    # Note that we must ensure that all the necessary keys are there
+    # in the given input. If this is not the case, then we will
+    # determine which entries are missing, and assign them from the
+    # instance variable @colour_table.
+    # ======================================================================= #
+    missing_entries = (
+      i.keys - @colour_table.keys
+    ).flatten
+    unless missing_entries.empty?
+      # ===================================================================== #
+      # Push them onto i in this case.
+      # ===================================================================== #
+      missing_entries.each {|this_key|
+        if i.has_key? this_key
+          # All fine, pass through in this case.
+        else
+          add_this = missing_entries[this_key]
+          i[key] = add_this
+
+        end
+      }
+    end
+    @colour_table = i
+  end; self.instance_eval { alias assign_new_colour_codes    set_colour_table } # === Colours.assign_new_colour_codes
+       self.instance_eval { alias set_method_to_colour_table set_colour_table } # === Colours.set_method_to_colour_table
 
   # ========================================================================= #
   # === Colours.sfile
@@ -243,163 +199,239 @@ module Colours
       i            = '',
       make_newline = false
     )
-    if @use_colours
-      if @use_html_colours
-        i = SupportForHTMLColours.send(
-          map_this_symbol_to_that_html_colour(@colour_table[__method__.to_sym]), i
-        )
-      elsif @use_256_colours
-        use_this_colour = map_this_symbol_to_that_256_colour(@colour_table[__method__.to_sym])
-        i = SupportFor256Colours.send(use_this_colour, i)
-      else
-        i = "#{corresponding_colour?(@colour_table[__method__.to_sym])}"\
-            "#{i}"\
-            "#{rev}"
-      end
+    replacement_colour = @colour_table[__method__.to_sym].to_sym
+    if ::Colours.const_defined?(:HtmlColoursMethods)
+      return ::Colours::HtmlColoursMethods.send(replacement_colour, i)
     end
-    i
   end
 
   # ========================================================================= #
-  # === sfile
+  # === Colours.colour_table?
+  #
+  # This method will feedback the available colour-table.
+  #
+  # To invoke this method, try the following code:
+  #
+  #   pp Colours.colours?
+  #
   # ========================================================================= #
-  def sfile(
-      i = '', make_newline = false
-    )
-    ::Colours.sfile(i, make_newline)
+  def self.colour_table?
+    @colour_table
+  end; self.instance_eval { alias method_to_colour_table                  colour_table? } # === Colours.method_to_colour_table
+       self.instance_eval { alias method_to_colour_table?                 colour_table? } # === Colours.method_to_colour_table?
+       self.instance_eval { alias colours?                                colour_table? } # === Colours.colours?
+       self.instance_eval { alias table?                                  colour_table? } # === Colours.table?
+       self.instance_eval { alias table_colour_methods_to_specific_colour colour_table? } # === Colours.table_colour_methods_to_specific_colour
+       self.instance_eval { alias colour_methods_to_specific_colour?      colour_table? } # === Colours.colour_methods_to_specific_colour?
+
+  # ========================================================================= #
+  # === Colours.use_new_colour_table
+  # ========================================================================= #
+  def self.use_new_colour_table
+    set_colour_table(:new_colour_table)
   end
 
   # ========================================================================= #
-  # === efile
+  # === Colours.show_the_colour_table
+  #
+  # This will simply pretty-print the current colour table.
   # ========================================================================= #
-  def efile(
+  def self.show_the_colour_table
+    pp @colour_table
+  end
+
+  # ========================================================================= #
+  # === Colours.shuffle
+  #
+  # Shuffle the above table. The available colours to take here will
+  # be from the HtmlColours namespace.
+  # ========================================================================= #
+  def self.shuffle
+    # ======================================================================= #
+    # Point to the html "table" to use.
+    # ======================================================================= #
+    _ = ::Colours::HtmlColours.all?.shuffle
+    @colour_table = {
+      simp:      _.shift,
+      sdir:      _.shift,
+      sfile:     _.shift,
+      swarn:     _.shift,
+      sfancy:    _.shift,
+      ssymlink:  _.shift
+    }
+  end
+
+  # ========================================================================= #
+  # === edir
+  # ========================================================================= #
+  def edir(
       i            = '',
       make_newline = false
     )
-    e sfile(i, make_newline)
+    e ::Colours.sdir(i, make_newline)
   end
 
   # ========================================================================= #
-  # === Colours.snormal
+  # === Colours.ssymlink
+  # ========================================================================= #
+  def self.ssymlink(
+      i            = '',
+      make_newline = false
+    )
+    replacement_colour = @colour_table[__method__.to_sym].to_sym
+    return ::Colours::HtmlColoursMethods.send(replacement_colour, i)
+  end; self.instance_eval { alias sym  ssymlink } # === Colours.sym
+       self.instance_eval { alias ssym ssymlink } # === Colours.ssym
+
+  # ========================================================================= #
+  # === Colours.default_colour
   #
   # Invocation example:
   #
-  #   Colours.snormal('Hello world!')
+  #   puts Colours.default_colour('Hello world!')
   #
   # ========================================================================= #
-  def self.snormal(
+  def self.default_colour(
       i            = '',
       make_newline = false
     )
-    if @use_colours
+    if use_colours?
+      if make_newline
+        i = "#{i}#{N}"
+      end
       if @use_html_colours
-        i = SupportForHTMLColours.send(
-          map_this_symbol_to_that_html_colour(@colour_table[__method__.to_sym]), i
-        )
-      elsif @use_256_colours
-        use_this_colour = map_this_symbol_to_that_256_colour(@colour_table[__method__.to_sym])
-        i = SupportFor256Colours.send(use_this_colour, i)
-      else
-        i = "#{corresponding_colour?(@colour_table[__method__.to_sym])}"\
-            "#{i}"\
-            "#{rev}"
+        replacement_colour = @colour_table[__method__.to_sym].to_sym
+        return ::Colours::HtmlColoursMethods.send(replacement_colour, i)
       end
     end
-    i
+    return i
   end
 
   # ========================================================================= #
-  # === snormal
+  # === Colours.colour_for_symlinks
+  #
+  # This method will simply return the colour for symlinks.
   # ========================================================================= #
-  def snormal(
-      i            = '',
-      make_newline = false
-    )
-    ::Colours.snormal(i, make_newline)
+  def self.colour_for_symlinks
+    return @colour_table[:ssymlink].to_sym
   end
 
   # ========================================================================= #
-  # === enormal
+  # === ssymlink
+  #
+  # Note that a symlink called symlink() exists to this method, but it
+  # is not exactly clear whether this alias will be kept, as it may
+  # interfere with some other methods when we do an include-action.
   # ========================================================================= #
-  def enormal(
+  def ssymlink(i = '')
+    ::Colours.ssymlink(i)
+  end; alias symlink ssymlink # === symlink
+       alias ssym    ssymlink # === ssym
+       alias slink   ssymlink # === slink
+
+  # ========================================================================= #
+  # === default_colour
+  # ========================================================================= #
+  def default_colour(i = '')
+    ::Colours.default_colour(i)
+  end
+
+  # ========================================================================= #
+  # === edefault_colour
+  # ========================================================================= #
+  def edefault_colour(
       i            = '',
       make_newline = false
     )
-    e snormal(i, make_newline)
+    e ::Colours.default_colour(i, make_newline)
   end
 
   # ========================================================================= #
-  # === Colours.simportant
-  #
-  #This method is the one to denote "important" text components.
-  #
-  # Invocation examples:
+  # === Colours.ecomment
   #
-  #   Colours.simportant('Hello world!')
-  #   Colours.simportant('yo there')
+  # This method was added on Nov 2013.
   #
+  # In April 2014, the ability to split at any arbitrary character was
+  # added, which can be controlled via the second argument given to
+  # that method. By default it will split on the token '#'.
   # ========================================================================= #
-  def self.simportant(
-      i            = '',
-      make_newline = false
+  def self.ecomment(
+      i,
+      optional_split_at_this_character = '#', # ← Specify which character to split at.
+      first_colour_to_use         = :steelblue,
+      second_colour_to_use        = :seagreen,
+      colour_to_use_for_the_token = :slategray
     )
-    if @use_colours
-      if @use_html_colours
-        i = SupportForHTMLColours.send(
-          map_this_symbol_to_that_html_colour(@colour_table[__method__.to_sym]), i
-        )
-      elsif @use_256_colours
-        use_this_colour = map_this_symbol_to_that_256_colour(@colour_table[__method__.to_sym])
-        i = SupportFor256Colours.send(use_this_colour, i)
-      else
-        i = "#{corresponding_colour?(@colour_table[__method__.to_sym])}"\
-            "#{i}"\
-            "#{rev}"
+    _ = i.to_s
+    if optional_split_at_this_character.is_a? Hash
+      # ===================================================================== #
+      # === :token
+      # ===================================================================== #
+      if optional_split_at_this_character.has_key? :token
+        optional_split_at_this_character = optional_split_at_this_character.delete :token
       end
     end
-    i
-  end; self.instance_eval { alias simp simportant } # === Colours.simp
+    optional_split_at_this_character = optional_split_at_this_character.to_s
+    # ======================================================================= #
+    # === If we can find a token to split at
+    # ======================================================================= #
+    if _.include? optional_split_at_this_character
+      _ = _.dup if _.frozen?
+      splitted = _.split(optional_split_at_this_character)
+      first_part  = ::Colours::HtmlColoursMethods.send(first_colour_to_use, splitted.first)
+      middle_part = ::Colours::HtmlColoursMethods.send(colour_to_use_for_the_token, optional_split_at_this_character)
+      second_part = ::Colours::HtmlColoursMethods.send(second_colour_to_use, splitted.last)
+      _ = first_part+
+          middle_part+
+          second_part+
+          ::Colours.rev
+    end
+    e _
+  end
 
   # ========================================================================= #
-  # === simportant
+  # === Colours.scomments
+  #  
+  # Invocation example:
+  #
+  #   Colours.scomments('Hello world!')
   #
-  # Delegate towards Colours.simportant() here.
   # ========================================================================= #
-  def simportant(
+  def self.scomments(
       i            = '',
       make_newline = false
     )
-    ::Colours.simportant(i, make_newline)
-  end; alias simp simportant # === simp
-       alias si   simportant # === si
+    replacement_colour = @colour_table[__method__.to_sym].to_sym
+    return ::Colours::HtmlColoursMethods.send(replacement_colour, i)
+  end; self.instance_eval { alias comment scomments } # === Colours.comment
 
   # ========================================================================= #
-  # === ciif
+  # === Colours.scomments?
+  #
+  # This method will usually return :grey.
   # ========================================================================= #
-  def ciif(i)
-    eimportant(i, false)
-  end # Alias to the above, basically.
+  def self.scomments?
+    colour_table?[:scomments]
+  end
 
   # ========================================================================= #
-  # === Colours.eimp
+  # === scomments
   # ========================================================================= #
-  def self.eimp(
-      i            = '',
-      make_newline = false
-    )
-    e simp(i, make_newline)
-  end
+  def scomments(i = '')
+    ::Colours.scomments(i) # Delegate towards Colours.scomments? here.
+  end; alias scomment scomments # === scomment
 
   # ========================================================================= #
-  # === eimportant
+  # === ecomment
+  #
+  # Just a wrapper over the Colours.ecomment() functionality.
   # ========================================================================= #
-  def eimportant(
-      i            = '',
-      make_newline = false
+  def ecomment(
+      i,
+      optional_split_at_this_character = '#'
     )
-    ::Colours.eimp(i, make_newline)
-  end; alias eimp eimportant # === eimp
-       alias cii  eimportant # === cii
+    ::Colours.ecomment(i, optional_split_at_this_character)
+  end
 
   # ========================================================================= #
   # === Colours.swarn
@@ -413,21 +445,8 @@ module Colours
       i            = '',
       make_newline = false
     )
-    if @use_colours
-      if @use_html_colours
-        i = SupportForHTMLColours.send(
-          map_this_symbol_to_that_html_colour(@colour_table[__method__.to_sym]), i
-        )
-      elsif @use_256_colours
-        use_this_colour = map_this_symbol_to_that_256_colour(@colour_table[__method__.to_sym])
-        i = SupportFor256Colours.send(use_this_colour, i)
-      else
-        i = "#{corresponding_colour?(@colour_table[__method__.to_sym])}"\
-            "#{i}"\
-            "#{rev}"
-      end
-    end
-    i
+    replacement_colour = @colour_table[__method__.to_sym].to_sym
+    return ::Colours::HtmlColoursMethods.send(replacement_colour, i)
   end
 
   # ========================================================================= #
@@ -440,6 +459,26 @@ module Colours
     ::Colours.swarn(i, make_newline)
   end
 
+  # ========================================================================= #
+  # === Colours.esymlink
+  # ========================================================================= #
+  def self.esymlink(
+      i            = '',
+      make_newline = false
+    )
+    e ::Colours.ssymlink(i, make_newline)
+  end
+
+  # ========================================================================= #
+  # === esymlink
+  # ========================================================================= #
+  def esymlink(
+      i            = '',
+      make_newline = false
+    )
+    ::Colours.esymlink(i, make_newline)
+  end
+
   # ========================================================================= #
   # === Colours.ewarn
   # ========================================================================= #
@@ -461,117 +500,71 @@ module Colours
   end
 
   # ========================================================================= #
-  # === Colours.ssymlink
+  # === Colours.simportant
   #
-  # Invocation example:
+  #This method is the one to denote "important" text components.
   #
-  #   Colours.ssymlink('Hello world!')
+  # Invocation examples:
+  #
+  #   Colours.simportant('Hello world!')
+  #   Colours.simportant('yo there')
   #
   # ========================================================================= #
-  def self.ssymlink(
+  def self.simportant(
       i            = '',
       make_newline = false
     )
-    if @use_colours
-      if @use_html_colours
-        i = SupportForHTMLColours.send(
-          map_this_symbol_to_that_html_colour(@colour_table[__method__.to_sym]), i
-        )
-      elsif @use_256_colours
-        use_this_colour = map_this_symbol_to_that_256_colour(@colour_table[__method__.to_sym])
-        i = SupportFor256Colours.send(use_this_colour, i)
-      else
-        i = "#{corresponding_colour?(@colour_table[__method__.to_sym])}"\
-            "#{i}"\
-            "#{rev}"
-      end
+    require 'colours/essentials/essentials.rb'
+    replacement_colour = @colour_table[__method__.to_sym].to_sym
+    _ = ::Colours::HtmlColoursMethods
+    if _.respond_to? replacement_colour
+      return _.send(replacement_colour, i)
+    else
+      ::Colours::Essentials.send(replacement_colour, i)
     end
-    i
-  end; self.instance_eval { alias sym  ssymlink } # === Colours.sym
-       self.instance_eval { alias ssym ssymlink } # === Colours.ssym
-
-  # ========================================================================= #
-  # === Colours.colour_for_symlinks
-  #
-  # This method will simply return the colour for symlinks.
-  # ========================================================================= #
-  def self.colour_for_symlinks
-    result = ''.dup
-    if @use_colours
-      if @use_html_colours
-        result = SupportForHTMLColours.send(
-          map_this_symbol_to_that_html_colour(@colour_table[:ssymlink])
-        )
-      elsif @use_256_colours
-        use_this_colour = map_this_symbol_to_that_256_colour(@colour_table[__method__.to_sym])
-        result = SupportFor256Colours.send(use_this_colour)
-      else
-        result = "#{corresponding_colour?(@colour_table[__method__.to_sym])}"
-      end
-    end
-    result
-  end
+  end; self.instance_eval { alias simp simportant } # === Colours.simp
 
   # ========================================================================= #
-  # === ssymlink
+  # === simportant
   #
-  # Note that a symlink called symlink() exists to this method, but it
-  # is not exactly clear whether this alias will be kept, as it may
-  # interfere with some other methods when we do an include-action.
+  # Delegate towards Colours.simportant() here.
   # ========================================================================= #
-  def ssymlink(i = '')
-    ::Colours.ssymlink(i)
-  end; alias symlink ssymlink # === symlink
-       alias ssym    ssymlink # === ssym
-       alias slink   ssymlink # === slink
+  def simportant(
+      i            = '',
+      make_newline = false
+    )
+    ::Colours.simportant(i, make_newline)
+  end; alias simp simportant # === simp
+       alias si   simportant # === si
 
   # ========================================================================= #
-  # === Colours.esymlink
+  # === Colours.eimp
   # ========================================================================= #
-  def self.esymlink(
+  def self.eimp(
       i            = '',
       make_newline = false
     )
-    e ::Colours.ssymlink(i, make_newline)
+    e simp(i, make_newline)
   end
 
   # ========================================================================= #
-  # === esymlink
+  # === eimportant
   # ========================================================================= #
-  def esymlink(
+  def eimportant(
       i            = '',
       make_newline = false
     )
-    ::Colours.esymlink(i, make_newline)
-  end
+    ::Colours.eimp(i, make_newline)
+  end; alias eimp eimportant # === eimp
+       alias cii  eimportant # === cii
 
   # ========================================================================= #
-  # === Colours.sfancy
-  #
-  # Invocation example:
-  #
-  #   Colours.sfancy('Hello world!')
+  # === ciif
   #
+  # Alias to the above method, basically, aka eimportant().
   # ========================================================================= #
-  def self.sfancy(
-      i            = '',
-      make_newline = false
-    )
-    if @use_colours
-      if @use_html_colours
-        i = SupportForHTMLColours.send(
-          map_this_symbol_to_that_html_colour(@colour_table[__method__.to_sym]), i
-        )
-      elsif @use_256_colours
-        use_this_colour = map_this_symbol_to_that_256_colour(@colour_table[__method__.to_sym])
-        i = SupportFor256Colours.send(use_this_colour, i)
-      else
-        i = "#{corresponding_colour?(@colour_table[__method__.to_sym])}"\
-            "#{i}"\
-            "#{rev}"
-      end
-    end
-    i
+  def ciif(i)
+    eimportant(i, false)
   end
 
   # ========================================================================= #
@@ -613,73 +606,142 @@ module Colours
   end; alias ff cif # === ff (alias to the above ^^^)
 
   # ========================================================================= #
-  # === Colours.scomments
-  #
-  # Invocation example:
-  #
-  #   Colours.scomments('Hello world!')
-  #
+  # === Colours.sdir
   # ========================================================================= #
-  def self.scomments(
+  def self.sdir(
       i            = '',
       make_newline = false
     )
-    if @use_colours
-      if @use_html_colours
-        i = SupportForHTMLColours.send(@colour_table[__method__.to_sym], i)
-      elsif @use_256_colours
-        use_this_colour = map_this_symbol_to_that_256_colour(@colour_table[__method__.to_sym])
-        i = SupportFor256Colours.send(use_this_colour, i)
-      else
-        i = "#{corresponding_colour?(@colour_table[__method__.to_sym])}"\
-            "#{i}"\
-            "#{rev}"
-      end
-    end
-    i
-  end; self.instance_eval { alias comment scomments } # === Colours.comment
+    replacement_colour = @colour_table[__method__.to_sym].to_sym
+    return ::Colours::HtmlColoursMethods.send(replacement_colour, i)
+  end
 
   # ========================================================================= #
-  # === scomments
+  # === sdir
   # ========================================================================= #
-  def scomments(i = '')
-    ::Colours.scomments(i) # Delegate towards Colours.scomments? here.
-  end; alias scomment scomments # === scomment
+  def sdir(
+      i            = '',
+      make_newline = false
+    )
+    ::Colours.sdir(i, make_newline)
+  end
 
   # ========================================================================= #
-  # === Colours.scomments?
+  # === sfile
+  # ========================================================================= #
+  def sfile(
+      i            = '',
+      make_newline = false
+    )
+    ::Colours.sfile(i, make_newline)
+  end
+
+  # ========================================================================= #
+  # === efile
+  # ========================================================================= #
+  def efile(
+      i            = '',
+      make_newline = false
+    )
+    e sfile(i, make_newline)
+  end
+
+  # ========================================================================= #
+  # === Colours.sfile_or_sdir
+  #
+  # This method will directly delegate to either Colours.sfile() or
+  # Colours.sdir(), depending on whether we have a file at hand or
+  # whether we have a directory at hand.
+  #
+  # Usage examples:
+  #
+  #   Colours.sfile_or_sdir('/home/x/Temp/MyGems/')
+  #   Colours.sfile_or_sdir('/home/x/Temp/opened_files.yml')
   #
-  # This method will usually return :grey.
   # ========================================================================= #
-  def self.scomments?
-    colour_table?[:scomments]
+  def self.sfile_or_sdir(
+      i            = '',
+      make_newline = false
+    )
+    if File.exist?(i) and File.file?(i)
+      return ::Colours.sfile(i, make_newline)
+    elsif File.directory?(i)
+      return ::Colours.sdir(i, make_newline)
+    end
+  end; self.instance_eval { alias sdir_or_sfile sfile_or_sdir } # === Colours.sdir_or_sfile
+
+  # ========================================================================= #
+  # === Update the colour-table next
+  # ========================================================================= #
+  if @use_html_colours and File.exist?(FILE_USE_THESE_VALUES_FOR_THE_COLOUR_METHODS)
+    these_colours = YAML.load_file(FILE_USE_THESE_VALUES_FOR_THE_COLOUR_METHODS).
+                    transform_keys(&:to_sym)
+    update_colour_table_with(these_colours)
   end
 
   # ========================================================================= #
-  # === ecomment
+  # === Colours.col                                                 (col tag)
+  #
+  # Careful - this method may collide with other methods named col().
+  #
+  # Usage examples:
+  #
+  #   Colours.col '/Depot/j/geojgirjh'
+  #   Colours.col '/home/x/songs/'
+  #   Colours.col '/home/x/songs/Westbam_Sunshine.mp3'
   #
-  # Just a wrapper over the Colours.ecomment() functionality.
   # ========================================================================= #
-  def ecomment(
+  def self.col(
       i,
-      optional_split_at_this_character = '#'
+      optional_arg_not_in_use_right_now = ''
     )
-    ::Colours.ecomment(i, optional_split_at_this_character)
+    if File.exist? i
+      ftype = File.ftype(i)
+      # ===================================================================== #
+      # e 'The ftype is: '+ftype # <- This could be used for debugging.
+      # ===================================================================== #
+      case ftype
+      # ===================================================================== #
+      # === file
+      # ===================================================================== #
+      when 'file'
+        return sfile(i)
+      # ===================================================================== #
+      # === directory
+      # ===================================================================== #
+      when 'directory'
+        return sdir(i)
+      # ===================================================================== #
+      # === link
+      # ===================================================================== #
+      when 'link'
+        return ssymlink(i)
+      else
+        e "module Colours: We do not know the filetype `#{ftype}`"
+      end
+    else # Else return the input a bit changed.
+      return sfile(i) # We modify it because that is better.
+    end
   end
 
 end
 
 if __FILE__ == $PROGRAM_NAME
   alias e puts
-  e ::Colours.sargument('Hello world!')
+  e ::Colours.sdir('Hello world!')
   e ::Colours.sfile('Hello world!')+' And this should appear in another colour.'
-  e ::Colours.snormal('Hello world!')
   e ::Colours.simportant('Hello world!')
+  e ::Colours.simp('Hello world!')
   e ::Colours.swarn('Hello world!')
   e ::Colours.ssymlink('Hello world!')
   e ::Colours.sfancy('Hello world!')
-  e ::Colours.default_colour('Hello world!')
-  e ::Colours.sdir('Hello world!')
   e ::Colours.scomments('Hello world!')
+  e ::Colours.col '/Depot/j/geojgirjh.md'
+  e ::Colours.col '/home/x/songs/'
+  e ::Colours.col '/home/x/songs/Westbam_Sunshine.mp3'
   ::Colours.ecomment('Hello world! # this is the associated comment')
-end
+  e
+  pp Colours::HASH_NEW_COLOURS
+  e
+  e ::Colours.default_colour('Hello world!')
+end # ruby sfile_sdir*.rb