colours 0.8.12 → 0.9.8

data/lib/colours/yaml/html_colours.yml

@@ -829,7 +829,7 @@ yellow:
 - 255
 - 255
 -   0
-- FFFF00 
+- FFFF00
 yellowgreen:
 - 154
 - 205

data/lib/colours/yaml/prefer_this_colour_schemata.yml

@@ -11,7 +11,7 @@
 # =========================================================================== #
 # x = YAML.load_file('prefer_this_colour_schemata.yml')
 # =========================================================================== #
- 
+
 1: !ruby/symbol html_colours
 2: !ruby/symbol support_for_256_colours
 3: !ruby/symbol basic_colours

data/lib/colours/yaml/use_these_values_for_the_colour_methods.yml

@@ -3,13 +3,17 @@
 #
 # This yaml file will contain which colour codes we may use for when we
 # wish to make use of HTML colours.
+#
+# Keep the !ruby/symbol part here - while it may not be strictly
+# necessary, it helps to remember that we are working with Symbols
+# in this .yml file here.
 # =========================================================================== #
 # x = YAML.load_file('use_these_values_for_the_colour_methods.yml')
 # =========================================================================== #
+sfancy:    !ruby/symbol lightseagreen
 simp:      !ruby/symbol steelblue
 sdir:      !ruby/symbol olivedrab
 sfile:     !ruby/symbol slateblue
 swarn:     !ruby/symbol orangered
-sfancy:    !ruby/symbol lightseagreen
 sargument: !ruby/symbol slategray
 ssymlink:  !ruby/symbol mediumorchid

data/lib/colours.rb

@@ -1 +1 @@
-require 'colours/requires/require_the_project.rb'
+require 'colours/requires/require_the_project.rb'

data/test/testing_256_colours_support.rb

@@ -4,7 +4,9 @@
 # =========================================================================== #
 # require 'new_colours/test/testing_256_colours_support.rb'
 # =========================================================================== #
-require 'colours/256_colours/support_for_256_colours.rb'
+require 'colours/module_256_colours/module_256_colours.rb'
+require 'colours/autogenerated/256_colours_instance_methods.rb'
+require 'colours/autogenerated/256_colours_methods.rb'
 
 alias e puts
 
@@ -12,6 +14,8 @@ e 'Now testing 256 colours support.'
 
 # =========================================================================== #
 # === test_256_colours_support
+#
+# This method is used for testing various aspects of the 256-submodule.
 # =========================================================================== #
 def test_256_colours_support
   Colours.display_this_256_colour(0) { :newline }
@@ -23,6 +27,11 @@ def test_256_colours_support
   e
   Colours.show_all_256_colours { :newline }
   e
+  include ::Colours::Module256Colours
+  e green('This should be in green.')
+  e
+  e aquamarine3('This should be in aquamarine3.')
+  e
 end
 
 test_256_colours_support

data/test/testing_replace_number_words_with_the_corresponding_html_colour.rb

@@ -2,22 +2,28 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-require 'colours'
+require 'colours/html_colours'
+
 alias e puts
 
 use_this_hash = {
-  :one   => :steelblue,
-  :two   => :mediumseagreen,
-  :three => :mediumpurple,
-  :four  => :olivedrab,
-  :five  => :lightgreen,
-  :default_colour => :olivedrab
+  one:            :steelblue,
+  two:            :mediumseagreen,
+  three:          :mediumpurple,
+  four:           :olivedrab,
+  five:           :lightgreen,
+  default_colour: :olivedrab
 }
-x = 'Contemporary research in animal cognition has as its roots ... where? In <one>Charles Darwin’s theory of evolution by natural selection</one>.'
+x = 'Contemporary <royalblue>research</royalblue> in animal cognition has as '\
+    'its roots ... where? In <one>Charles Darwin’s theory of evolution by natural selection</one>.'
 
+e
 e x
+e
 y = Colours.replace_number_words_with_the_corresponding_html_colour(x, use_this_hash)
+e
 e y
+e
 
 z = '- Is <one>abc</one> <two>an example of</two> <orange>def ghi</orange> or of <orange>jkl mno</orange>? <one>Non-associative learning</one>.'
 scanned = z.scan(
@@ -30,7 +36,7 @@ scanned.each {|entry|
     regex_to_use = Colours.return_main_regex_to_use_for_obtaining_the_full_content(colour_to_use)
     e z.gsub(
       regex_to_use,
-      ::Colours::AllColourMethods.send(colour_to_use.to_sym, "\\1")       { :omit_end }+
+      ::Colours.send(colour_to_use.to_sym, "\\1")       { :omit_end }+
       ::Colours.rev
     )
   end

data/test/testing_the_colour_methods_such_as_simp_sdir_sfile_swarn_sfancy_sargument_and_ssymlink.rb

@@ -0,0 +1,53 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+alias e puts
+require 'colours'
+rev = Colours.rev
+# =========================================================================== #
+# === ARROW
+# =========================================================================== #
+ARROW = '→'
+# =========================================================================== #
+# === PADDING_TO_USE
+# =========================================================================== #
+PADDING_TO_USE = 58
+e
+e 'The code in this file will test the various colour-methods, such as'
+e 'sfancy(), sdir() and so forth.'
+e
+e "Let's show the colour-table we will be using here:"
+e
+pp ::Colours.colour_table?
+e
+e
+e Colours.sfancy(    'Hello world (through sfancy())').ljust(PADDING_TO_USE)+" #{ARROW} "+Colours.sfancy('').inspect
+e Colours.sdir(      'Hello world (through sdir())').ljust(PADDING_TO_USE)+" #{ARROW} "+Colours.sdir('').inspect
+e Colours.simportant('Hello world (through simportant())').ljust(PADDING_TO_USE)+" #{ARROW} "+Colours.simportant('').inspect
+e Colours.swarn(     'Hello world (through swarn())').ljust(PADDING_TO_USE)+" #{ARROW} "+Colours.swarn('').inspect
+# e Colours.snormal(   'Hello world (through snormal())')+Colours.snormal('').inspect
+# e Colours.sargument( 'Hello world (through sargument())')+Colours.sargument('').inspect
+# ^^^ these two were removed in November 2023.
+e Colours.sfile(     'Hello world (through sfile())').ljust(PADDING_TO_USE)+" #{ARROW} "+Colours.sfile('').inspect
+e Colours.ssymlink(  'Hello world (through ssymlink())').ljust(PADDING_TO_USE)+" #{ARROW} "+Colours.ssymlink('').inspect
+e Colours.scomments( 'Hello world (through scomments())').ljust(PADDING_TO_USE)+" #{ARROW} "+Colours.scomments('').inspect
+e
+e "#{rev}Next we will use Colours.use_new_colour_table() and hope"
+e "#{rev}that this will change the above colours."
+Colours.use_new_colour_table
+e
+e "#{rev}Showing the new colour-table next:"
+e
+pp ::Colours.colour_table?
+e
+e Colours.sfancy(    'Hello world (through sfancy())').ljust(PADDING_TO_USE)+" #{ARROW} "+Colours.sfancy('').inspect
+e Colours.sdir(      'Hello world (through sdir())').ljust(PADDING_TO_USE)+" #{ARROW} "+Colours.sdir('').inspect
+e Colours.simportant('Hello world (through simportant())').ljust(PADDING_TO_USE)+" #{ARROW} "+Colours.simportant('').inspect
+e Colours.swarn(     'Hello world (through swarn())').ljust(PADDING_TO_USE)+" #{ARROW} "+Colours.swarn('').inspect
+# e Colours.snormal(   'Hello world (through snormal())').ljust(PADDING_TO_USE)+" #{ARROW} "+Colours.snormal('').inspect
+# e Colours.sargument( 'Hello world (through sargument())').ljust(PADDING_TO_USE)+" #{ARROW} "+Colours.sargument('').inspect
+e Colours.sfile(     'Hello world (through sfile())').ljust(PADDING_TO_USE)+" #{ARROW} "+Colours.sfile('').inspect
+e Colours.ssymlink(  'Hello world (through ssymlink())').ljust(PADDING_TO_USE)+" #{ARROW} "+Colours.ssymlink('').inspect
+e Colours.scomments( 'Hello world (through scomments())').ljust(PADDING_TO_USE)+" #{ARROW} "+Colours.scomments('').inspect
+e

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: colours
 version: !ruby/object:Gem::Version
-  version: 0.8.12
+  version: 0.9.8
 platform: ruby
 authors:
 - Robert A. Heiler
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-10-29 00:00:00.000000000 Z
+date: 2023-12-04 00:00:00.000000000 Z
 dependencies: []
 description: |2+
 
@@ -22,10 +22,9 @@ description: |2+
 
   For more information about this project, have a look at the online
   documentation for this gem at the link called "documentation", at
-  the bottom right side of the colours
-  gem homepage:
+  the bottom right side of the colours gem homepage:
 
-    https://www.rubydoc.info/gems/colours/0.8.12
+    https://www.rubydoc.info/gems/colours/0.9.8
 
 email: shevy@inbox.lt
 executables: []
@@ -43,52 +42,46 @@ files:
 - bin/print_rainbow_line
 - bin/rainbow_colours
 - bin/remove_ansii_escape_sequences
+- bin/show_basic_colour_palette
 - bin/steelblue
 - colours.gemspec
-- doc/COLOUR_CODES_CHART.md
-- doc/HOW_TO_PICK_YOUR_OWN_COLOURS.md
 - doc/README.gen
+- doc/colour_codes_chart/colour_codes_chart.md
+- doc/how_to_pick_your_own_colours/how_to_pick_your_own_colours.md
 - doc/todo/todo.md
 - lib/colours.rb
-- lib/colours/256_colours/support_for_256_colours.rb
 - lib/colours/autoalias_e.rb
+- lib/colours/autogenerated/256_colours_instance_methods.rb
+- lib/colours/autogenerated/256_colours_methods.rb
 - lib/colours/autogenerated/README.md
-- lib/colours/autogenerated/support_for_256_colours.rb
-- lib/colours/autogenerated/support_for_html_colours.rb
-- lib/colours/autogenerated/toplevel_basic_colour_methods.rb
+- lib/colours/autogenerated/html_colours_instance_methods.rb
+- lib/colours/autogenerated/html_colours_methods.rb
 - lib/colours/autoinclude.rb
 - lib/colours/base/base.rb
-- lib/colours/basic_colours/README.md
-- lib/colours/basic_colours/basic_colours.rb
 - lib/colours/class/colours.rb
-- lib/colours/colour_methods/README.md
-- lib/colours/colour_methods/colour_methods.rb
-- lib/colours/colour_table/README.md
-- lib/colours/colour_table/colour_table.rb
+- lib/colours/colour/colour.rb
 - lib/colours/colours_e_autoinclude.rb
 - lib/colours/commandline/README.md
 - lib/colours/commandline/commandline.rb
-- lib/colours/commandline/menu.rb
 - lib/colours/constants/constants.rb
-- lib/colours/constants/escape.rb
-- lib/colours/constants/file_constants.rb
-- lib/colours/constants/hash_ansi_colours.rb
-- lib/colours/constants/hash_simple_colours.rb
-- lib/colours/constants/misc.rb
-- lib/colours/constants/newline.rb
-- lib/colours/constants/registered_colour_methods.rb
 - lib/colours/e.rb
 - lib/colours/e/README.md
 - lib/colours/e/autoinclude.rb
 - lib/colours/e/e.rb
 - lib/colours/eparse/eparse.rb
+- lib/colours/essentials/README.md
+- lib/colours/essentials/essentials.rb
 - lib/colours/everything/autoinclude.rb
+- lib/colours/html_colours.rb
 - lib/colours/html_colours/README.md
-- lib/colours/html_colours/add_html_colours_onto_the_toplevel_namespace.rb
+- lib/colours/html_colours/hash_html_colours.rb
 - lib/colours/html_colours/html_colours.rb
+- lib/colours/html_colours/push_the_html_colours_methods_onto_the_toplevel_namespace.rb
+- lib/colours/html_colours/random_html_colour.rb
 - lib/colours/kde_colour_palette/kde_colour_palette.rb
 - lib/colours/map_symbol_to_corresponding_colour/map_symbol_to_corresponding_colour.rb
 - lib/colours/module.rb
+- lib/colours/module_256_colours/module_256_colours.rb
 - lib/colours/project/project.rb
 - lib/colours/rainbow_colours/README.md
 - lib/colours/rainbow_colours/check_for_trollop_being_available_or_exit.rb
@@ -102,14 +95,15 @@ files:
 - lib/colours/rainbow_colours/report_errors.rb
 - lib/colours/rainbow_colours/returnln_plain.rb
 - lib/colours/rainbow_colours/set_mode.rb
+- lib/colours/replace_tokens_with_colour_code/replace_tokens_with_colour_code.rb
 - lib/colours/requires/require_autogenerated_colour_methods.rb
 - lib/colours/requires/require_commandline.rb
 - lib/colours/requires/require_eparse.rb
+- lib/colours/requires/require_essentials.rb
 - lib/colours/requires/require_rgb.rb
+- lib/colours/requires/require_save_file.rb
 - lib/colours/requires/require_the_256_colours_module.rb
-- lib/colours/requires/require_the_basic_colours.rb
 - lib/colours/requires/require_the_colour_methods.rb
-- lib/colours/requires/require_the_colour_table.rb
 - lib/colours/requires/require_the_constants.rb
 - lib/colours/requires/require_the_html_colours.rb
 - lib/colours/requires/require_the_kde_colour_palette.rb
@@ -117,34 +111,13 @@ files:
 - lib/colours/requires/require_the_toplevel_methods.rb
 - lib/colours/requires/require_yaml.rb
 - lib/colours/rgb/rgb.rb
+- lib/colours/sfile_sdir_sfancy_swarn_simp_scomments_and_ssymlink/sfile_sdir_sfancy_swarn_simp_scomments_and_ssymlink.rb
 - lib/colours/testing/README.md
 - lib/colours/testing/testing.rb
-- lib/colours/toplevel_methods/autogenerate.rb
-- lib/colours/toplevel_methods/bold.rb
-- lib/colours/toplevel_methods/bold_and_italic.rb
-- lib/colours/toplevel_methods/cat.rb
-- lib/colours/toplevel_methods/clear_screen.rb
-- lib/colours/toplevel_methods/cliner.rb
-- lib/colours/toplevel_methods/col.rb
 - lib/colours/toplevel_methods/e.rb
-- lib/colours/toplevel_methods/esystem.rb
-- lib/colours/toplevel_methods/html_colour_to_hex_value.rb
-- lib/colours/toplevel_methods/html_colourize.rb
-- lib/colours/toplevel_methods/is_on_roebe.rb
-- lib/colours/toplevel_methods/italic.rb
-- lib/colours/toplevel_methods/make_colour.rb
-- lib/colours/toplevel_methods/methods_related_to_html_colours.rb
-- lib/colours/toplevel_methods/misc.rb
-- lib/colours/toplevel_methods/open_this_file.rb
-- lib/colours/toplevel_methods/prefer_this_colour_schemata.rb
-- lib/colours/toplevel_methods/random_value.rb
-- lib/colours/toplevel_methods/remove_escape_sequence.rb
-- lib/colours/toplevel_methods/revert.rb
-- lib/colours/toplevel_methods/set_last_colour_used.rb
-- lib/colours/toplevel_methods/shell_file_containing_the_html_colours.sh
-- lib/colours/toplevel_methods/show_basic_colour_palette.rb
-- lib/colours/toplevel_methods/underline.rb
-- lib/colours/toplevel_methods/use_colours.rb
+- lib/colours/toplevel_methods/map_this_symbol_to_that_html_colour.rb
+- lib/colours/toplevel_methods/rev.rb
+- lib/colours/toplevel_methods/toplevel_methods.rb
 - lib/colours/version/version.rb
 - lib/colours/yaml/256_colours.yml
 - lib/colours/yaml/basic_colours.yml
@@ -167,7 +140,7 @@ files:
 - test/testing_replace_number_words_with_the_corresponding_html_colour.rb
 - test/testing_rgb_to_hex.rb
 - test/testing_the_basic_colours_of_the_colours_project.rb
-- test/testing_the_colour_methods.rb
+- test/testing_the_colour_methods_such_as_simp_sdir_sfile_swarn_sfancy_sargument_and_ssymlink.rb
 - test/testing_the_constants_of_the_colours_project.rb
 - test/testing_the_ecomment_method.rb
 - test/testing_the_html_colours_of_the_colours_project.rb
@@ -209,9 +182,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.4.18
+      version: 3.4.22
 requirements: []
-rubygems_version: 3.4.18
+rubygems_version: 3.4.22
 signing_key:
 specification_version: 4
 summary: 'This library is called colours. It unifies colour-related constants and
@@ -220,6 +193,6 @@ summary: 'This library is called colours. It unifies colour-related constants an
   is to make commandline-scripts display text on the terminal with colours.  For more
   information about this project, have a look at the online documentation for this
   gem at the link called "documentation", at the bottom right side of the colours
-  gem homepage:  https://www.rubydoc.info/gems/colours/0.8.12'
+  gem homepage:  https://www.rubydoc.info/gems/colours/0.9.8'
 test_files: []
 ...

data/doc/HOW_TO_PICK_YOUR_OWN_COLOURS.md

@@ -1,28 +0,0 @@
-This file describes how to pick your own colours - or how to use
-the Colours gem.
-
-The colours-centric Hash will contain entries such as:
-
-    sdir: :olivedrab
-
-Now, what does this mean?
-
-This is a hash entry, a key->value pair, with the key being called
-:sdir, and the value being :olivedrab.
-
-"sdir" is an abbreviation for "string_dir", aka "string_directory".
-
-:olivedrab is the HTML colour called olivedrab, a beige-green variant.
-
-What this thus does means, in english, is to "use the colour olivedrab
-in order to display directories in a coloured fashion".
-
-If you wish to use another colour, simply change the Symbol on the
-right hand side, aka :olivedrab, to another name, such as :steelblue
-or :orange. The names that should be chosen here are HTML Colour
-names.
-
-If you wish to get an overview of all available HTML colours, in ruby
-code, you can do this via the Colours namespace:
-
-    Colours.show_html_colours

data/lib/colours/256_colours/support_for_256_colours.rb

@@ -1,196 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'colours/256_colours/support_for_256_colours.rb'
-# =========================================================================== #
-module Colours
-
-  require 'yaml'
-  require 'colours/constants/misc.rb'
-  require 'colours/constants/newline.rb'
-  require 'colours/constants/file_constants.rb'
-  require 'colours/toplevel_methods/revert.rb'
-
-  # ========================================================================= #
-  # === @dataset_for_the_256_colours
-  #
-  # We will keep the keys in a downcased variant, as this will make it
-  # easier to use them as method-names.
-  # ========================================================================= #
-  if File.exist?(FILE_256_COLOURS) # Must safeguard.
-    @dataset_for_the_256_colours = YAML.load_file(FILE_256_COLOURS).
-                                   transform_keys(&:downcase)
-  else
-    @dataset_for_the_256_colours = nil
-  end
-
-  # ========================================================================= #
-  # === Colours.return_this_256_colour
-  #
-  # The first argument to this method should be a number from 0 to 255.
-  #
-  # For example, 255 is also known as "Grey93" - a variant of grey.
-  #
-  # It appears to work better if you use print() rather than puts() for
-  # whatever is returned here - perhaps due to the leading \u001b part.
-  #
-  # You can also input the colour variant, such as 'Grey93'. 
-  #
-  # Invocation example:
-  #
-  #   Colours.return_this_256_colour(255, "Hello world in grey!\n")
-  #   print Colours.return_this_256_colour(255, (Roebe.block_character*5)+"  Hello world in grey!  "+(Roebe.block_character*5)+" \n")
-  #   print Colours.return_this_256_colour('DarkTurquoise', (Roebe.block_character*5)+"  Hello world in DarkTurquoise!  "+(Roebe.block_character*5)+" \n")
-  #
-  # ========================================================================= #
-  def self.return_this_256_colour(
-      id            = 9,
-      use_this_text = "Hello world!"
-    )
-    id = id.to_s.downcase
-    if (id !~ /^\d+/) and @dataset_for_the_256_colours and
-      @dataset_for_the_256_colours.has_key?(id)
-      id = @dataset_for_the_256_colours[id]
-    end
-    "\u001b[38;5;#{id}m#{use_this_text}#{REVERT}"
-  end
-
-  # ========================================================================= #
-  # === Colours.write_this_in_256_colours
-  #
-  # Similar to the other write method, but has the arguments reversed. 
-  # ========================================================================= #
-  def self.write_this_in_256_colours(
-      this_text = "Hello world!\n",
-      id        = rand(256),
-      &block
-    )
-    display_this_256_colour(id, this_text, &block)
-  end; self.instance_eval { alias write_in_256_colour write_this_in_256_colours } # === Colours.write_in_256_colour
-
-  # ========================================================================= #
-  # === write_in_256_colour
-  #
-  # Include-able method to the above module-level instance.
-  # ========================================================================= #
-  def write_in_256_colour(
-      i  = 'hi there',
-      id = 33
-    )
-    write_this_in_256_colours(i, id)
-  end
-
-  # ========================================================================= #
-  # === Colours.display_this_256_colour
-  #
-  # The first argument should be a number from 0 to 255.
-  #
-  # You can also batch-output all colours, by using something like:
-  #
-  #   Colours.display_this_256_colour('0-255',"Hello world, in a batch!\n")
-  #
-  # Generic usage example:
-  #
-  #   Colours.display_this_256_colour(33, 'yo there') { :newline }
-  #
-  # ========================================================================= #
-  def self.display_this_256_colour(
-      id            = 9,
-      use_this_text = "Hello world!\n",
-      &block
-    )
-    if block_given?
-      yielded = yield
-      case yielded
-      when :newline
-        use_this_text = use_this_text.dup if use_this_text.frozen?
-        use_this_text << "\n"
-      end
-    end
-    if id.is_a?(String) and id.include?('-')
-      # ===================================================================== #
-      # Assume pseudo-range input.
-      # ===================================================================== #
-      splitted = id.split('-')
-      range = (splitted.first.to_i .. splitted.last.to_i).to_a
-      range.each {|this_range_id|
-        display_this_256_colour(this_range_id, use_this_text, &block)
-      }
-    else
-      print return_this_256_colour(id, use_this_text)
-    end
-  end; self.instance_eval { alias display_this_in_256_colour display_this_256_colour } # === Colours.display_this_in_256_colour
-
-  # ========================================================================= #
-  # === Colours.show_all_256_colours
-  # ========================================================================= #
-  def self.show_all_256_colours
-    yielded = nil
-    if block_given?
-      yielded = yield
-    end
-    0.upto(255).each {|this_number|
-      result = this_number.to_s.rjust(4)+' '+
-               return_this_256_colour(this_number).to_s.dup
-      if yielded and yielded == :newline
-        result << "\n"
-      end
-      print result
-    }
-  end
-
-  # ========================================================================= #
-  # === Colours.show_256_colour_cube
-  #
-  # This will show the 256-colours cube. Colours 16-231 are a
-  # 6x6x6 color cube.
-  # ========================================================================= #
-  def self.show_256_colour_cube
-    puts 'Color cube, 6x6x6 blocks:'
-    0.upto(5) {|green|
-      0.upto(5) {|red|
-        0.upto(5) {|blue|
-          colour = 16 + (red * 36) + (green * 6) + blue
-          print "\x1b[48;5;#{colour}m  "
-        }
-        print "\x1b[0m "
-      }
-      puts
-    }
-  end
-
-  # ========================================================================= #
-  # === Colours.is_this_a_256_colour?
-  #
-  # Invocation example:
-  #
-  #   Colours.is_this_a_256_colour? 'LightSteelBlue3'
-  #
-  # ========================================================================= #
-  def self.is_this_a_256_colour?(i)
-    if @dataset_for_the_256_colours
-      @dataset_for_the_256_colours.keys.map(&:downcase).include?(i.to_s.downcase)
-    else
-      false
-    end
-  end
-
-  # ========================================================================= #
-  # === is_this_a_256_colour?
-  # ========================================================================= #
-  def is_this_a_256_colour?(i)
-    ::Colours.is_this_a_256_colour?(i)
-  end
-
-end
-
-if __FILE__ == $PROGRAM_NAME
-  alias e puts
-  Colours.show_256_colour_cube
-  # The next line can be found in: colours/test/testing_256_colours_support.rb
-  # Colours.test_256_colours_support
-  e
-  Colours.display_this_256_colour('0-255',"Hello world, in a batch!\n")
-  e
-end # supportfor256colours