colours 0.8.12

data/test/testing_konsole_submodule.rb

@@ -0,0 +1,226 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'colours/autoinclude'
+
+class Bar
+  include Colours
+end
+
+N = "\n"
+e 'Now testing the gem called '+sfancy('colours')+rev+'.'
+e
+e 'We will also read in this html file lateron:'
+e
+e '  '+sfile(Colours::TEST_FILE)
+
+# =========================================================================== #
+# === konsole_colour_tests
+# =========================================================================== #
+def konsole_colour_tests(i = ARGV)
+  e 'First, we will display six random colours.'
+  e
+  e Colours[:random]+' heya1'
+  e Colours[:random]+' heya2'
+  e Colours[:random]+' heya3'
+  e Colours.random(' heya4')
+  e Colours.random(' heya5')
+  e Colours.random(' heya6')
+  pp Colours[:slateblue]
+  _ = Colours::Colour.new(ARGV)
+  begin
+    _.show_in_random_colour 'hmm'+N
+    _.show_in_random_colour 'hmm'+N
+    _.show_in_random_colour 'hmm'+N
+  rescue; end
+  # p _.html_colours # Test outputting all HTML colours.
+  # p Colours.html_colours
+  # p _.rvalue
+  _.seed_rgb_values # Get some random values for R,G,B.
+  # _.output_this_string :default, 89, 250, 237
+  _.output_this
+  _.output_this 'Hello World!'+N, :random_colours
+  _.output_this "Hello World!\n", :random_colours
+  _.output_this :random_colours
+  e _.random_colour? 'yeah'
+  # _.slateblue
+  # _.slateblue 'Hello World!'+N+N+N+N
+  # _.slateblue 'yoo!'+N
+  # e _.slateblue+'Direct test 1'
+  # e _.lightcyan+'Direct test 2'
+  # e _.mintcream+'Direct test 3'
+  # e _.slateblue('Direct test 4')
+  begin
+  e '
+  This is a longer paragraph. Some '+_.slateblue(:keywords)+' will
+  be highlighted in '+_.random_colour('a colour')+'.'+N+N+N+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+N+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+N+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+N+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+N+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+N+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')+
+  ' '+_.random_colour('test')
+  e
+  rescue; end
+  e 'Next trying to find out whether slateblue is registered or not:'
+  e _.registered_colour? 'slateblue'
+  e 'Next trying to read in a file:'
+  Colours.cliner {
+    _.read_file(TEST_FILE)
+  }
+  Colours.cliner {
+    e 'The registered colours are (Colours.registered_colours? '+
+      '- showing only 5):'
+    pp Colours.registered_colours?[0..5]
+  }
+  e
+  e 'Next we will show some random colours, just to test whether this'
+  e 'functionaly works properly:'
+  e
+  e '  '+Colours.random_colour?
+  e '  '+Colours.random_colour?
+  e '  '+Colours.random_colour?
+  e '  '+Colours.random_colour?
+  e '  '+Colours.random_colour?
+  e '  '+Colours.random_colour?
+  e
+  e "Next testing Colours :green, 'hello world'"
+  konsole_colours :green, 'hello world'
+  Colours.cliner {
+    e Time.now.strftime('%H:%M:%S')
+    puts kde_colour(:slateblue, Time.now.strftime('%H:%M:%S') ).to_s
+  }
+  puts Colours[:slateblue, Time.now.strftime('%H:%M:%S')]
+  pp REVERT
+  pp rgb
+  pp rgb
+  pp rgb
+  output_in_a_random_colour 'yo there'
+  output_in_a_random_colour 'yo there'
+  output_in_a_random_colour 'yo there'
+  e; Colours.cliner {
+    e 'We will display three random colours next:'
+    e '  '+Colours.random_colour?
+    e '  '+Colours.random_colour?
+    e '  '+Colours.random_colour?
+  }
+  e 'Is darkgreen a registered colour? '+registered_colour?('darkgreen').to_s
+  e Colours.rgb('slateblue')+'yo there'+restore?
+  e Colours.rgb(:random)+'yo there'+restore?+' (<-- '+
+    Colours.colourize(Colours.last_colour_used?)+')'
+    Colours.write_this_in_random_colour('yo man how do you do')
+  Colours.cliner
+  e 'Next testing direct calls such as: Colours.sienna()'
+  e Colours.sienna
+  e Colours.sienna('yo there')
+  e Colours.lightblue('yo there')
+  e Colours.cyan('yo there')
+  p darkgreen('ok')
+  p lightblue('ok')
+  slateblue
+  e Colours_colour_slateblue 'hello world!'
+  e Colours_colour_darkgreen 'hello world!'
+  eslateblue 'yo there'
+  Colours.slateblue
+  Colours.edarkgreen 'This is Colours.edarkgreen'
+  Colours.eslateblue 'This is Colours.eslateblue'
+  Bar.new.slateblue
+  Bar.slateblue
+  e Bar.slateblue('oki doki')
+  e; Colours.cliner {
+    e 'Next testing 4 occurances of slateblue:'
+    e Colours['slateblue','(1) Hello World!']
+    eColours_colour_slateblue '(2) hello world!' # This is the same as the above.
+    e Colours.slateblue '(3) yo'
+    eslateblue '(4) hi world'
+  }
+  e; Colours.cliner {
+    e 'We will next test out Colours.rgb with 3 specific values (R,G,B)'
+    e Colours.rgb(122,56,141)+' ok'+rev
+    e Colours.rgb(125,61,164)+' ok'+rev
+    e Colours.rgb(132,76,198)+' ok'+rev
+    e Colours.rgb(262,86,213)+' ok'+rev
+  }
+  e; Colours.cliner {
+    e 'Next we will test the method: write_this_in_random_colour'
+    write_this_in_random_colour '  hello world'
+    write_this_in_random_colour '  hello world'
+    write_this_in_random_colour '  hello world'
+  }
+  Colours_colours :green, 'Hello world!'
+  e Colours_colour_peru 'hey there - this here is Colours_colour_peru()'
+  e; Colours.cliner {
+    e 'Next testing italic:'
+    e Colours.italic('This must be italic.')
+    e
+    e 'Next testing underline:'
+    e Colours.underline('This must be underlined.')
+  }
+  Colours.display_all_colours # Finally, display all colours here.
+end; alias test_Colours_colours Colours_colour_tests # === test_Colours_colours
+
+if __FILE__ == $PROGRAM_NAME
+  # Testing code comes next:
+  if ARGV.empty?
+    Colours_colour_tests # Here we run the various colour-tests.
+  else
+    Colours.menu(ARGV) # Delegate towards Colours.menu() here.
+  end
+end # tkon

data/test/testing_map_symbol_to_corresponding_colour.rb

@@ -0,0 +1,14 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'new_colours/map_symbol_to_corresponding_colour/map_symbol_to_corresponding_colour.rb'
+
+alias e puts
+
+e
+NewColours.available_colours?.each {|this_colour|
+  translated = NewColours.map_symbol_to_corresponding_colour(this_colour)
+  e translated+':'+this_colour.to_s.ljust(8)+' -> '+
+    translated.to_s+' ('+translated.inspect+')'
+}; e

data/test/testing_replace_number_words_with_the_corresponding_html_colour.rb

@@ -0,0 +1,39 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'colours'
+alias e puts
+
+use_this_hash = {
+  :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>.'
+
+e x
+y = Colours.replace_number_words_with_the_corresponding_html_colour(x, use_this_hash)
+e y
+
+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(
+  Colours::REGEX_FOR_HTML_COLOURS
+).flatten.uniq
+scanned.each {|entry|
+  if Colours.is_a_HTML_colour?(entry) # Here we know it is a HTML colour.
+    e z+::Colours.rev
+    colour_to_use = Colours.replace_number_words_with_the_corresponding_html_colour(entry, use_this_hash)
+    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.rev
+    )
+  end
+}
+#e z
+# y = Colours.replace_number_words_with_the_corresponding_html_colour(x, use_this_hash)

data/test/testing_rgb_to_hex.rb

@@ -0,0 +1,32 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+alias e puts
+require 'colours'
+
+# Testing code comes next:
+e 'We will now test R,G,B values: 255,200,22'
+p Colours::RGB[255,200,22]
+begin
+  p Colours::RGB[355,200,22]
+rescue ArgumentError => error
+  p error
+  e 'We rescued this error however.'
+end
+_ = Colours::RGB.new '55,66,77'
+e 'We will now test R,G,B values: 55,66,77'
+p _
+e 'Testing add(3) next:'
+_.add 3
+p _
+e _.rgb
+e
+e 'Next, we will test HTML Colours (strings):'
+e 'slateblue: → '+Colours::RGB['slateblue']
+e 'darkblue:  → '+Colours::RGB['darkblue']
+e '-------'
+e 'Next, we will apply .lighten, from darkblue as our base colour:'
+e Colours::RGB['darkblue']
+e Colours::RGB.new(Colours::RGB['darkblue']).lighten # => "#232323"
+e '-------'

data/test/testing_the_basic_colours_of_the_colours_project.rb

@@ -0,0 +1,62 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  require 'colours/constants/constants.rb'
+  include Colours
+  require 'colours/basic_colours/basic_colours.rb'
+  include Colours::BasicColours
+  module Colours
+    include Colours::BasicColours
+  end
+  e 'Next testing direct support for colour-constants, such as '\
+    'COLOUR_LIGHT_PURPLE or COLOUR_GRAY'
+  e COLOUR_LIGHT_PURPLE+'foo bar'+COLOUR_NC
+  e COLOUR_GRAY+'foo bar'+COLOUR_NC
+  e GREEN+'TEST IN GREEN, THEN THE CLOSING "TAG"'+CLOSING_TAG
+  e
+  e 'Next, we will directly test for colour-methods such as .gray() or'
+  e '.light_gray(), .blue() and so forth:'
+  e
+  e 'yo '+Colours::BasicColours.gray('there - this is gray') # This one is not visible on a black background.
+  e 'yo '+Colours::BasicColours.light_gray('there - this is light gray')
+  e 'yo '+Colours::BasicColours.yellow('there - this is yellow')
+  e 'yo '+Colours::BasicColours.blue('there - this is blue')
+  e 'yo '+Colours::BasicColours.brown('there - this is brown')
+  e 'yo '+Colours::BasicColours.red('there - this is red')
+  e 'yo '+Colours::BasicColours.white('there - this is white')
+  e 'yo '+Colours::BasicColours.purple('there - this is purple')
+  e 'yo '+Colours::BasicColours.purple('there - this is green')
+  e 'yo '+Colours::BasicColours.light_purple('there - this is light purple')
+  e 'yo '+Colours::BasicColours.light_red('there - this is light red')
+  e 'yo '+Colours::BasicColours.light_green('there - this is light green')
+  e 'yo '+Colours::BasicColours.cyan('there - this is cyan')
+  e 'yo '+Colours::BasicColours.light_cyan('there - this is light cyan')
+  e 'yo '+Colours::BasicColours.light_blue('there - this is light blue')
+  e 'Is this line without colours?'
+  e
+  e 'Next, we will test whether HASH_SIMPLE_COLOURS contains all keys'
+  e 'as methods:'
+  keys = HASH_SIMPLE_COLOURS.keys
+  e
+  keys.each_with_index {|this_method, index| index += 1
+    padded_index = ('('+index.to_s+') ').rjust(5)
+    e Colours::BasicColours.send(
+        this_method,
+        padded_index+this_method.to_s+' does exist.'
+      )
+  }
+  e
+  e
+  e 'Next testing .rev()'
+  e
+  e Colours.rev
+  e
+  pp Colours::ARRAY_REGISTERED_ANSI_COLOURS
+  e
+  e 'Next testing: pp Colours.really_all_colours'
+  e
+  pp Colours.really_all_colours
+end

data/test/testing_the_colour_methods.rb

@@ -0,0 +1,36 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+alias e puts
+e
+e 'The code in this file will test the various colour-methods, such as'
+e 'sfancy(), sdir() and so forth.'
+e
+require 'new_colours'
+e
+e NewColours.sfancy(    'Hello world (through sfancy())')+NewColours.sfancy('').inspect
+e NewColours.sdir(      'Hello world (through sdir())')+NewColours.sdir('').inspect
+e NewColours.simportant('Hello world (through simportant())')+NewColours.simportant('').inspect
+e NewColours.swarn(     'Hello world (through swarn())')+NewColours.swarn('').inspect
+e NewColours.snormal(   'Hello world (through snormal())')+NewColours.snormal('').inspect
+e NewColours.sargument( 'Hello world (through sargument())')+NewColours.sargument('').inspect
+e NewColours.sfile(     'Hello world (through sfile())')+NewColours.sfile('').inspect
+e NewColours.ssymlink(  'Hello world (through ssymlink())')+NewColours.ssymlink('').inspect
+e NewColours.scomments( 'Hello world (through scomments())')+NewColours.scomments('').inspect
+
+e
+e 'Next we will use Colours.use_new_colour_table and hope'
+e 'that this will change the above colours:'
+e
+NewColours.use_new_colour_table
+e NewColours.sfancy(    'Hello world (through sfancy())')+NewColours.sfancy('').inspect
+e NewColours.sdir(      'Hello world (through sdir())')+NewColours.sdir('').inspect
+e NewColours.simportant('Hello world (through simportant())')+NewColours.simportant('').inspect
+e NewColours.swarn(     'Hello world (through swarn())')+NewColours.swarn('').inspect
+e NewColours.snormal(   'Hello world (through snormal())')+NewColours.snormal('').inspect
+e NewColours.sargument( 'Hello world (through sargument())')+NewColours.sargument('').inspect
+e NewColours.sfile(     'Hello world (through sfile())')+NewColours.sfile('').inspect
+e NewColours.ssymlink(  'Hello world (through ssymlink())')+NewColours.ssymlink('').inspect
+e NewColours.scomments( 'Hello world (through scomments())')+NewColours.scomments('').inspect
+e

data/test/testing_the_constants_of_the_colours_project.rb

@@ -0,0 +1,9 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'colours/constants/hash_simple_colours.rb'
+require 'colours/constants/constants.rb'
+
+pp Colours::HASH_SIMPLE_COLOURS
+pp Colours::REVERT

data/test/testing_the_ecomment_method.rb

@@ -0,0 +1,11 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'colours/colour_methods/colour_methods.rb'
+
+alias e puts
+
+e "The following text should be output in a colourized manner:\n\n"
+Colours.ecomment(' test1 # test2')
+e

data/test/testing_the_html_colours_of_the_colours_project.rb

@@ -0,0 +1,37 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'new_colours/requires/require_the_html_colours.rb'
+require 'new_colours/autogenerated/support_for_html_colours.rb'
+
+def cliner; e '='*80; end
+
+alias e puts
+
+cliner
+e
+pp NewColours::HtmlColours::HASH_HTML_COLOURS
+e
+cliner
+e
+pp NewColours::HtmlColours.return_all_html_colours
+e
+cliner
+e
+pp NewColours::HtmlColours['slateblue']
+e 'slateblue is represented as: '+
+  NewColours::HtmlColours['slateblue'].to_s
+e
+
+pp NewColours['crimson']
+
+e NewColours['crimson']+'Hello world!'
+e
+e 'Next testing for class inclusion.'
+class Foo
+  include NewColours::SupportForHTMLColours
+end
+
+foo = Foo.new
+e foo.slateblue('yo there')

data/test/testing_the_regex_for_capturing_the_commandline_coloured_content.rb

@@ -0,0 +1,112 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This .rb file will also text the extensive test suite that I am using
+# to make sure the colourization parts work.
+# =========================================================================== #
+require 'colours/toplevel_methods/methods_related_to_html_colours.rb'
+require 'colours/html_colours/html_colours.rb'
+
+result = <<-EOF
+- Is <one>abc</one> <two>an example of</two> <orange>def ghi</orange> or of <orange>jkl mno</orange>? <one>Non-associative learning</one>.
+<orange>C₅|H₁₀₀|N₂|O</orange>
+<orange>C₆|H₁₄|N₂|O₂</orange>
+<orange>H₂CO₃</orange>
+<orange>α-aminogruppe</orange>
+<orange>Mg²⁺</orange>
+<orange>„Write once, run everywhere.“</orange>.
+<orange>5'→3'</orange>yo
+ist <orange>a @ b</orange> eine valide Anweisung?
+<orange>x^2 + 1 = 0⁺</orange>
+<orange>yo there</orange>
+<orange>Antigen-Antikörper</orange>
+<orange>Antigen-Antikörper</orange>
+For the production of recombinant antibodies, we may use <orange>₂₃₄library display methods</orange>.
+C3-Pflanzen fixieren ... <orange>CO²</orange>
+<orange>4 ≥ 3</orange>
+<orange>item -> { }</orange>
+In <orange>Charles Darwin’s theory of evolution by natural selection</orange>.
+<orange>catch (...) { cout << 42; }</orange>
+<orange>₁₂₃₄₅₆₇₈₉⁰¹²³⁴⁵⁶⁷⁸⁹</orange>
+<orange>[]</orange>
+<orange>| |</orange>
+<orange>last shared_ptr to it is destroyed</orange>
+<orange>Process.uid.zero?</orange>
+<orange>"UGA"Å</orange>
+<orange>2:1 ratio</orange>
+<orange>3-O-β-D-galactose</orange>
+<orange>open(foobar.txt);</orange>
+<orange>open("foobar.txt")</orange>
+<orange>open("foobar.txt");</orange>
+<orange>Huber’s pigeon lab.</orange>
+<orange>Carl von Linné</orange>
+<orange>Tú frog</orange>
+<orange>(3x10²) + (2x10¹) + (7x10⁰)</orange>
+<orange>10∨³⁰</orange>
+<orange>10³⁰</orange>
+<orange>n μm in diameter</orange>
+<orange>10-20 μm in diameter</orange>
+<orange>⁻¹²</orange>
+<orange>+αβÅ</orange>
+<orange>+</orange>
+<orange>Maximale Trennungsgröße</orange>
+<orange>++foo</orange>
+<orange>300.000</orange>
+<orange>50°C</orange>
+<orange>1g/kg Körpergewicht</orange>
+<orange>foobar = { 1, 5, 9, 3, 6, 2 }</orange>
+<orange>a = b;</orange>
+foo? <orange>4-10 per cell</orange>
+- foo <orange>ok</orange>
+<orange>60%</orange>
+<orange>operative Geschäft</orange>
+<orange>C -> U</orange>
+<orange>"ok again"</orange>  <green>yere</green>  
+<orange>ok</orange>"? ok
+<orange>rint(f.read(5))</orange>
+<orange># => 3</orange>
+<orange>&</orange>
+<orange>int *x;</orange>
+<orange>a single F(ab)2 fragment</orange>
+<orange>¹⁸F.</orange>
+<orange>~70x</orange>
+<orange>!=</orange>
+Üowohl +0 sowie -0. Bei Vergleichen ... <orange>+0 = −0</orange>.
+<orange>3' OH Gruppe</orange>
+<orange>f = open("foobar.txt", "r");</orange>
+Dies ist <orange>xeee, aaa, prognostische, x "precision medicine"</orange>, die zudem ...
+<orange>-C≡N</orange>
+<orange>NOAEL</orange> und <orange>LOEL</orange>
+<orange>'\0'</orange>
+The female <orange>Túngara frog</orange> will select males that show ...
+EOF
+
+USE_THIS_COLOUR_FOR_THE_DEFAULT_COLOUR = :grey
+
+result = result.split("\n").reject {|entry| entry.strip.empty? }
+result.each {|this_line|
+  this_line = this_line.dup if this_line.frozen?
+  scanned_results = this_line.scan(
+    Colours::REGEX_FOR_HTML_COLOURS
+  ).flatten.uniq
+  scanned_results.each {|this_colour|
+    if Colours.is_this_a_valid_html_colour?(this_colour)
+      use_this_regex = 
+        Colours.return_main_regex_to_use_for_obtaining_the_full_content(this_colour)
+      # =================================================================== #
+      # We must use .gsub!() because the colour-string may occur more 
+      # than once. Unfortunately for longer Strings this becomes a bit
+      # fragile.
+      # =================================================================== #
+      part1 = ::Colours::AllColourMethods.send(this_colour.to_sym, "\\1") { :omit_end }
+      part2 = ::Colours::AllColourMethods.send(USE_THIS_COLOUR_FOR_THE_DEFAULT_COLOUR) { :omit_end }
+      this_line.gsub!(
+        use_this_regex,
+        part1+
+        part2
+      ).dup
+    end
+  }
+  puts ::Colours.rev+this_line
+}

data/test/testing_whether_colours_will_be_used.rb

@@ -0,0 +1,7 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'colours/toplevel_methods/use_colours.rb'
+
+Colours.report_whether_colours_will_be_used