colours 0.5.41

data/bin/colours

@@ -0,0 +1,7 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'colours'
+
+Colours.menu(ARGV)

data/bin/html_colour_to_hex_value

@@ -0,0 +1,7 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'colours/toplevel_methods/methods_related_to_html_colours.rb'
+
+puts Colours.html_colour_to_hex_value(ARGV)

data/bin/html_colourize

@@ -0,0 +1,7 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'colours/html_colours/html_colourize.rb'
+
+Colours::HtmlColours.html_colourize(ARGF)

data/bin/print_rainbow_line

@@ -0,0 +1,7 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'colours/rainbow_colours/do_parse_via_rainbow_colours.rb'
+
+Colours::RainbowColours.print_rainbow_line(ARGV)

data/bin/rainbow_colours

@@ -0,0 +1,7 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'colours/rainbow_colours/do_parse_via_rainbow_colours.rb'
+
+Colours::RainbowColours.do_parse_via_rainbow_colours(ARGV)

data/colours.gemspec

@@ -0,0 +1,75 @@
+# =========================================================================== #
+# Gemspec for Project Colours.
+# =========================================================================== #
+require 'colours/version/version.rb'
+
+Gem::Specification.new { |s|
+
+  s.name    = 'colours'
+  s.version = Colours::VERSION
+  s.date    = Time.now.strftime('%Y-%m-%d')
+
+  DESCRIPTION = <<-EOF
+
+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:
+
+  #{Colours::URL_TO_THE_DOCUMENTATION}
+
+EOF
+
+  s.summary     = DESCRIPTION
+  s.description = DESCRIPTION
+
+  s.extra_rdoc_files = %w()
+  
+  s.authors  = ['Robert A. Heiler']
+  s.email    = 'shevegen@gmail.com'
+  s.files    = Dir['**/*']
+  s.license  = 'MIT'
+  s.homepage = 'http://rubygems.org/gems/colours'
+
+  # ========================================================================= #
+  # Show this message when a user installs this project.
+  # ========================================================================= #
+  s.post_install_message = <<-EOF
+
+  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
+
+  EOF
+
+  s.required_ruby_version     = '>= '+RUBY_VERSION
+  s.required_rubygems_version = '>= '+Gem::VERSION
+  s.rubygems_version          = '>= '+Gem::VERSION
+
+  # ========================================================================= #
+  # No dependencies for this project.
+  # ========================================================================= #
+
+}

data/doc/COLOUR_CODES_CHART.md

@@ -0,0 +1,28 @@
+The available codes are:
+
+     0    Normal text, foreground and background  
+     1    Bold text
+     4    Underline
+     5    Blink
+     7    Inverse
+     8    Invisible
+
+    30    Black   foreground
+    31    Red     foreground
+    32    Green   foreground
+    33    Yellow  foreground
+    34    Blue    foreground
+    35    Magenta foreground
+    36    Cyan    foreground
+    37    White   foreground
+
+    40    Black   background
+    41    Red     background
+    42    Green   background
+    43    Yellow  background
+    44    Blue    background
+    45    Magenta background
+    46    Cyan    background
+    47    White   background
+    49    default background # Unsure if this one works as-is
+

data/doc/HOW_TO_PICK_YOUR_OWN_COLOURS.md

@@ -0,0 +1,29 @@
+This file describes how to pick your own colours - or how to use
+the Colours gem.
+
+The file colour_methods.rb within the konsole submodule has the
+relevant colours for KDE Konsole. It is stored in the hash
+called @table_colour_methods_to_specific_colour.
+
+Within that hash you may see 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 does mean, 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. The names 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