colours 0.6.12

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 'new_colours'
+
+# Testing code comes next:
+e 'We will now test R,G,B values: 255,200,22'
+p NewColours::RgbToHex[255,200,22]
+begin
+  p NewColours::RgbToHex[355,200,22]
+rescue ArgumentError => error
+  p error
+  e 'We rescued this error however.'
+end
+_ = NewColours::RgbToHex.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: -> '+NewColours::RgbToHex['slateblue']
+e 'darkblue:  -> '+NewColours::RgbToHex['darkblue']
+e '-------'
+e 'Next, we will apply .lighten, from darkblue as our base colour:'
+e NewColours::RgbToHex['darkblue']
+e NewColours::RgbToHex.new(NewColours::RgbToHex['darkblue']).lighten # => "#232323"
+e '-------'

data/test/testing_the_basic_colours_of_the_colours_project.rb

@@ -0,0 +1,58 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'new_colours/constants/colour_constants.rb'
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  include NewColours
+  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 '+NewColours.gray('there - this is gray') # This one is not visible on a black background.
+  e 'yo '+NewColours.light_gray('there - this is light gray')
+  e 'yo '+NewColours.yellow('there - this is yellow')
+  e 'yo '+NewColours.blue('there - this is blue')
+  e 'yo '+NewColours.brown('there - this is brown')
+  e 'yo '+NewColours.red('there - this is red')
+  e 'yo '+NewColours.white('there - this is white')
+  e 'yo '+NewColours.purple('there - this is purple')
+  e 'yo '+NewColours.purple('there - this is green')
+  e 'yo '+NewColours.light_purple('there - this is light purple')
+  e 'yo '+NewColours.light_red('there - this is light red')
+  e 'yo '+NewColours.light_green('there - this is light green')
+  e 'yo '+NewColours.cyan('there - this is cyan')
+  e 'yo '+NewColours.light_cyan('there - this is light cyan')
+  e 'yo '+NewColours.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 NewColours.send(
+        this_method,
+        padded_index+this_method.to_s+' does exist.'
+      )
+  }
+  e
+  e
+  e 'Next testing .rev()'
+  e
+  e NewColours.rev
+  e
+  pp NewColours::ARRAY_REGISTERED_ANSI_COLOURS
+  e
+  e 'Next testing: pp Colours.really_all_colours'
+  e
+  pp NewColours.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/colour_constants.rb'
+
+pp Colours::HASH_SIMPLE_COLOURS
+pp Colours::REVERT

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_whether_colours_will_be_used.rb

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

metadata

@@ -0,0 +1,229 @@
+--- !ruby/object:Gem::Specification
+name: colours
+version: !ruby/object:Gem::Version
+  version: 0.6.12
+platform: ruby
+authors:
+- Robert A. Heiler
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2022-09-15 00:00:00.000000000 Z
+dependencies: []
+description: |2+
+
+  This library is called colours. It unifies colour-related constants
+  and methods, including R,G,B values for colours and the commonly
+  known "HTML colours", such as "slateblue" or "royalblue" and so
+  on.
+
+  The primary use case for this project 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.6.12
+
+email: shevy@inbox.lt
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENCE.md
+- README.md
+- bin/colours
+- bin/html_colour_to_hex_value
+- bin/html_colourize
+- bin/print_rainbow_line
+- bin/rainbow_colours
+- bin/remove_ansii_escape_sequences
+- colours.gemspec
+- doc/COLOUR_CODES_CHART.md
+- doc/HOW_TO_PICK_YOUR_OWN_COLOURS.md
+- doc/README.gen
+- doc/todo/todo.md
+- lib/colours.rb
+- lib/colours/256_colours/support_for_256_colours.rb
+- lib/colours/autoalias_e.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/autoinclude.rb
+- lib/colours/base/base.rb
+- lib/colours/basic_colours/README.md
+- lib/colours/basic_colours/basic_colours.rb
+- lib/colours/class/class.rb
+- lib/colours/colour_methods/README.md
+- lib/colours/colour_methods/default_colour.rb
+- lib/colours/colour_methods/sargument.rb
+- lib/colours/colour_methods/scomments.rb
+- lib/colours/colour_methods/sdir.rb
+- lib/colours/colour_methods/sfancy.rb
+- lib/colours/colour_methods/sfile.rb
+- lib/colours/colour_methods/simportant.rb
+- lib/colours/colour_methods/snormal.rb
+- lib/colours/colour_methods/ssymlink.rb
+- lib/colours/colour_methods/swarn.rb
+- lib/colours/colour_table/README.md
+- lib/colours/colour_table/colour_table.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/colour_constants.rb
+- lib/colours/constants/file_constants.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/everything/autoinclude.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_colourize.rb
+- lib/colours/html_colours/is_this_html_colour_included.rb
+- lib/colours/html_colours/misc.rb
+- lib/colours/html_colours/show_html_colours.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/project/project_base_directory.rb
+- lib/colours/rainbow_colours/README.md
+- lib/colours/rainbow_colours/check_for_trollop_being_available_or_exit.rb
+- lib/colours/rainbow_colours/constants.rb
+- lib/colours/rainbow_colours/do_parse_via_rainbow_colours.rb
+- lib/colours/rainbow_colours/paint_detected_mode.rb
+- lib/colours/rainbow_colours/print_rainbow_line.rb
+- lib/colours/rainbow_colours/println_ani.rb
+- lib/colours/rainbow_colours/println_plain.rb
+- lib/colours/rainbow_colours/rainbow.rb
+- lib/colours/rainbow_colours/report_errors.rb
+- lib/colours/rainbow_colours/returnln_plain.rb
+- lib/colours/rainbow_colours/set_mode.rb
+- lib/colours/requires/require_all_colour_methods.rb
+- lib/colours/requires/require_commandline.rb
+- lib/colours/requires/require_eparse.rb
+- lib/colours/requires/require_rgb.rb
+- lib/colours/requires/require_sdir.rb
+- lib/colours/requires/require_sfile.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_colours_project.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
+- lib/colours/requires/require_the_toplevel_methods.rb
+- lib/colours/requires/require_yaml.rb
+- lib/colours/revert/revert.rb
+- lib/colours/rgb/rgb.rb
+- lib/colours/testing/README.md
+- lib/colours/testing/testing.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/fancy_parse.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_html_colour.rb
+- lib/colours/toplevel_methods/random_value.rb
+- lib/colours/toplevel_methods/remove_escape_sequence.rb
+- lib/colours/toplevel_methods/set_last_colour_used.rb
+- lib/colours/toplevel_methods/show_basic_colour_palette.rb
+- lib/colours/toplevel_methods/underline.rb
+- lib/colours/toplevel_methods/use_colours.rb
+- lib/colours/utility_scripts/README.md
+- lib/colours/utility_scripts/autogenerate.rb
+- lib/colours/version/version.rb
+- lib/colours/yaml/256_colours.yml
+- lib/colours/yaml/basic_colours.yml
+- lib/colours/yaml/html_colours.yml
+- lib/colours/yaml/kde_colour_palette.yml
+- lib/colours/yaml/prefer_this_colour_schemata.yml
+- lib/colours/yaml/use_these_values_for_the_colour_methods.yml
+- test/test.html
+- test/testing_256_colours_support.rb
+- test/testing_col.rb
+- test/testing_colours.rb
+- test/testing_colours_e.rb
+- test/testing_eparse.rb
+- test/testing_kde_colour_palette.rb
+- test/testing_konsole_submodule.rb
+- test/testing_map_symbol_to_corresponding_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_constants_of_the_colours_project.rb
+- test/testing_the_html_colours_of_the_colours_project.rb
+- test/testing_whether_colours_will_be_used.rb
+homepage: https://rubygems.org/gems/colours
+licenses:
+- MIT
+metadata: {}
+post_install_message: |2+
+
+    This is the colours gem.
+
+    Usage example:
+
+      require 'colours'
+
+    Have a look at methods such as sfancy() or simp(). These two methods
+    are heavily used to colourize important text. The leading "s" stands
+    for "string"; imp stands for "important" text.
+
+    If you wish to test the konsole colours, try:
+
+      colours --all_colours
+
+    or
+
+      Colours.test
+
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.6
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.7
+requirements: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: 'This library is called colours. It unifies colour-related constants and
+  methods, including R,G,B values for colours and the commonly known "HTML colours",
+  such as "slateblue" or "royalblue" and so on.  The primary use case for this project
+  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.6.12'
+test_files: []
+...