colours 0.8.12

data/lib/colours/yaml/kde_colour_palette.yml

@@ -0,0 +1,183 @@
+# =========================================================================== #
+# === The KDE colour palette
+#
+# This file specifically stores colours defined and used by the "KDE
+# colour palette". This can be found here:
+#
+#   https://community.kde.org/KDE_Visual_Design_Group/HIG/Color
+#
+# Note that we will ONLY store entries that have a simple name associated
+# with them; reason being that human folks will preferentially make use
+# of that name alone.
+#
+# The keys should be sorted alphabetically in this file here.
+# =========================================================================== #
+# x = YAML.load_file('kde_colour_palette.yml')
+# =========================================================================== #
+
+# =========================================================================== #
+# === a tag
+# =========================================================================== #
+Abyss Blue:
+- '#2980b9'
+-
+ - 41
+ - 128
+ - 18
+
+Alternate Grey:
+- '#bdc3c7'
+-
+ - 189
+ - 195
+ - 199
+
+# =========================================================================== #
+# === b tag
+# =========================================================================== #
+Beware Orange:
+- '#f67400'
+-
+ - 246
+ - 116
+ - 0
+
+Burnt Charcoal:
+- '#3b4045'
+-
+ - 59
+ - 64
+ - 69
+
+# =========================================================================== #
+# === c tag
+# =========================================================================== #
+Cardboard Grey:
+- '#eff0f1'
+-
+ - 239
+ - 240
+ - 241
+
+Charcoal Grey:
+- '#31363b'
+-
+ - 49
+ - 54
+ - 59
+
+Coastal Fog:
+- '#7f8c8d'
+-
+ - 127
+ - 140
+ - 141
+
+# =========================================================================== #
+# === d tag
+# =========================================================================== #
+Deco Blue:
+- '#1e92ff'
+-
+ - 30
+ - 146
+ - 255
+
+# =========================================================================== #
+# === h tag
+# =========================================================================== #
+Hover Blue:
+- '#93cee9'
+-
+ - 147
+ - 206
+ - 233
+
+Hyper Blue:
+- '#3daee6'
+-
+ - 61
+ - 174
+ - 230
+
+# =========================================================================== #
+# === i tag
+# =========================================================================== #
+Icon Blue:
+- '#1d99f3'
+-
+ - 29
+ - 153
+ - 243
+
+Icon Green:
+- '#2ecc71'
+-
+ - 46
+ - 204
+ - 113
+
+Icon Grey:
+- '#4d4d4d'
+-
+ - 77
+ - 77
+ - 77
+
+Icon Red:
+- '#da4453'
+-
+ - 218
+ - 68
+ - 83
+
+Icon Yellow:
+- '#fdbc4b'
+-
+ - 253
+ - 188
+ - 75
+
+# =========================================================================== #
+# === l tag
+# =========================================================================== #
+Lazy Grey:
+- '#afb0b3'
+-
+ - 175
+ - 176
+ - 179
+
+# =========================================================================== #
+# === n tag
+# =========================================================================== #
+Noble Fir:
+- '#27ae60'
+-
+ - 39
+ - 174
+ - 96
+
+# =========================================================================== #
+# === p tag
+# =========================================================================== #
+Paper White:
+- '#fcfcfc'
+-
+ - 252
+ - 252
+ - 252
+
+Pimpinella:
+- '#e74c3c'
+-
+ - 231
+ - 76
+ - 60
+
+Plasma Blue:
+- '#3daee9'
+-
+ - 61
+ - 174
+ - 233

data/lib/colours/yaml/prefer_this_colour_schemata.yml

@@ -0,0 +1,17 @@
+# =========================================================================== #
+# === prefer_this_colour_schemata.yml
+#
+# This file will determine which colour-schematas the Colours project
+# will prefer, by default. There are only three entries possible,
+# which is :html_colours, :support_for_256_colours and :basic_colours
+#
+# The data structure is kept as a numbered Hash. While it could also be
+# kept as an Array, I wanted to be able to also use [1], [2] and [3]
+# to quickly, cleanly and easily access these entries.
+# =========================================================================== #
+# 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

@@ -0,0 +1,15 @@
+# =========================================================================== #
+# === use_these_values_for_the_colour_methods.yml
+#
+# This yaml file will contain which colour codes we may use for when we
+# wish to make use of HTML colours.
+# =========================================================================== #
+# x = YAML.load_file('use_these_values_for_the_colour_methods.yml')
+# =========================================================================== #
+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

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

data/test/test.html

@@ -0,0 +1,18 @@
+<html>
+
+<p>
+
+This is a paragraph in some <slateblue>slateblue</> colour
+and also in <darkgreen>darkgreen</> colour and, last
+but not least, .
+
+
+It continues here with a <chartreuse>chartreuse</> colour.
+
+</p>
+
+<p>
+And here as well with a <papaya>papaya</> colour.
+</p>
+
+</html>

data/test/testing_256_colours_support.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'new_colours/test/testing_256_colours_support.rb'
+# =========================================================================== #
+require 'colours/256_colours/support_for_256_colours.rb'
+
+alias e puts
+
+e 'Now testing 256 colours support.'
+
+# =========================================================================== #
+# === test_256_colours_support
+# =========================================================================== #
+def test_256_colours_support
+  Colours.display_this_256_colour(0) { :newline }
+  Colours.display_this_256_colour(1) { :newline }
+  Colours.display_this_256_colour(2) { :newline }
+  Colours.display_this_256_colour(3) { :newline }
+  Colours.display_this_256_colour(155) { :newline }
+  Colours.display_this_256_colour(rand(255+1)) { :newline }
+  e
+  Colours.show_all_256_colours { :newline }
+  e
+end
+
+test_256_colours_support
+# test_256_colours_support

data/test/testing_bold_italic_underline.rb

@@ -0,0 +1,26 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'colours'
+
+alias e puts
+
+x = 'Test string.'
+
+result1 = Colours.bold(x+' Bold.')
+result2 = Colours.return_italic(x+' Italic.')
+result3 = Colours.return_underline(x+' Underline.')
+
+e '-'*80
+e result1
+pp result1
+e '-'*80
+e result2
+pp result2
+e '-'*80
+e result3
+pp result3
+
+
+# echo -e "\e[1mbold\e[0m"

data/test/testing_class_colours.rb

@@ -0,0 +1,46 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'colours'
+
+alias e puts
+
+# x = Colours('This is bright blue.').blue.bright
+# y = x.build_the_main_string
+e Colours('This is blue.').blue
+e Colours('This is blue underline.').blue.underline
+e Colours('This is bright blue underline.').blue.bright.underline
+e Colours('This is bright blue.').blue.bright
+e Colours('This is bright blue.').blue.bright+
+  Colours(' And this is bright yellow.').yellow.bright
+e Colours('This is bright blue.').blue.bright+
+  Colours(' And this is bright yellow.').yellow.bright+
+  Colours(' And this is green.').green
+e Colours('This is bright blue.').blue.bright+
+  Colours(' And this is bright yellow.').yellow.bright+
+  Colours(' And this is green.').green+
+  Colours(' And this is bright green.').green.bright
+e Colours('This is bright blue.').blue.bright+
+  Colours(' And this is bright yellow.').yellow.bright+
+  Colours(' And this is green.').green+
+  Colours(' And this is bright green.').green.bright+
+  Colours(' And this is magenta, italic.').magenta.italic
+e Colours('This is blue bright underline.').blue.bright.underline
+e Colours('This is blue bright underline and italic.').blue.bright.underline.italic
+e Colours('This is blue bright and italic.').blue.bright.italic
+e Colours("this is red").red + " and " +
+  Colours("this on yellow bg").bg(:yellow) + " and " +
+  Colours('even bright underlined!').underline.bright+
+  Colours(' Again!').underline.bright.red
+e Colours('This is red.').red+' '+
+  Colours('And this should be reversed').red.reversed
+e Colours('This is blue.').blue
+result = Colours('This is blue and bold.').blue.bold
+e result
+e 'Also showing the Escape code for this ^^^'
+pp result.to_s
+result = Colours('This is just bold.').bold
+e result
+e 'Also showing the Escape code for this ^^^'
+pp result.to_s

data/test/testing_col.rb

@@ -0,0 +1,10 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# Code in this file will test the Colours.col() method.
+# =========================================================================== #
+require 'new_colours/toplevel_methods/col.rb'
+
+puts NewColours.col '/home/x/songs/'
+puts NewColours.col '/home/x/songs/Westbam_Sunshine.mp3'

data/test/testing_colours.rb

@@ -0,0 +1,96 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# The test-code resides in colours/lib/colours/test.rb so we can just
+# call Colours.test
+# =========================================================================== #
+if __FILE__ == $PROGRAM_NAME
+
+  require 'colours/autoinclude'
+ 
+  alias ee print
+
+  # ========================================================================= #
+  # === cliner
+  # ========================================================================= #
+  def cliner
+    ::Colours.cliner
+  end
+
+  # ========================================================================= #
+  # === Testing Colours.ecomment() next
+  # ========================================================================= #
+  cliner
+  e 'This file will test the colour gem.'
+  e
+  e 'Next, this file will test for the method Colours.ecomment()'
+  e 'being able to process multiple lines in one go:'
+  cliner
+  ::Colours.ecomment '
+
+  --ncards?               # How many cards are available
+                          # ^^^ If you pass an argument, then we will use that as name for the card set.
+  merge in all yaml files # To merge in all yaml files
+  html                    # To generate the .html page
+  zip                     # To create a big .zip file
+
+'
+
+  # cliner # <-- This cliner is superfluous because Colours.test() will already show one.
+  e 'Next, Colours.test() will be invoked:'
+  e
+  Colours.test # Invoke the Colours.test() class method.
+  e Colours.bold_white('This text here should be in bold white.')
+  cliner
+  e 'Next testing Colours::AnsiColours'
+  i = "08.01.2015, 01:16:25 \e[1;32mNo registered users\e[0;0m\e[0;37m."
+  e 'Available colours:'
+  Colours::ARRAY_REGISTERED_ANSI_COLOURS.each {|colour|
+    e colour.inspect+' '+colour+'<- Colourtest.'
+  }
+  e 'Next we will test a string with AnsiEscape sequences.'
+  e 'We wish to get rid of them.'
+  pp i
+  ee '(1) '
+  e Colours.remove(i)
+  ee '(2) '
+  e i.gsub(REMOVE_ANSI_ESCAPE_CHARACTERS, '') # This regex also works.
+  e Colours::TEAL+'Teal'+Colours::REVERT
+  # ========================================================================= #
+  # === Next test the HtmlColours submodule
+  # ========================================================================= #
+  cliner
+  e 'Next testing the html colours subcomponent of module Colours:'
+  e 'Featuring '+simp('Colours::HtmlColours.sample')+' next:'
+  e Colours::HtmlColours.sample
+  e
+  e Colours::HtmlColours::HTML_COLOURS.size
+  pp Colours::HtmlColours[]
+  cliner
+  # ========================================================================= #
+  # === Next test the old ColourAid module
+  # ========================================================================= #
+  cliner
+  e 'Hello World! We will now test sfancy() simp() swarn() and ssymlink():'
+  cliner
+  e 'How do you '+Colours.sfancy('do')+'?'
+  e 'How do you '+Colours.simp('do')+'?'
+  e 'How do you '+Colours.swarn('do')+'?'
+  e 'How do you '+Colours.ssymlink('do')+'?'
+  cliner
+  e 'How do you '+sfancy('do')+'?'
+  e 'How do you '+simp('do')+'?'
+  e 'How do you '+swarn('do')+'?'
+  e 'How do you '+ssymlink('do')+'?'
+  cliner
+  e 'Next testing efancy(), eimp(), ewarn() and esymlink().'
+  efancy 'All is fine.'
+  eimp 'You are doing great!'
+  ewarn 'Red Alert!'
+  esymlink 'yo there'
+  e 'Next, we will test Colours.eparse()'
+  Colours.eparse(' - s[number]  # start to cut at this '\
+  'start-position in seconds - example: s5')
+  e Colours.fancy_parse('<lightgreen><i>E. coli</i></lightgreen>')
+end # test_colours

data/test/testing_colours_e.rb

@@ -0,0 +1,13 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'colours/everything/autoinclude'
+
+e
+e 'This code-snippet will test the '+Colours.gold('e()')+
+  ' method and various colour-related'
+e 'methods, such as sfancy() or simp()'
+e
+e 'Testing ... '+sfancy('Testing ...')+simp(' some more testing ...')
+e

data/test/testing_eparse.rb

@@ -0,0 +1,13 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+alias e puts
+
+require 'colours/eparse/eparse.rb'
+
+e
+Colours.eparse('Hello there # how do you do, this is a test')
+e
+Colours.eparse('And this variant has no special token')
+e

data/test/testing_italic.rb

@@ -0,0 +1,28 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'colours'
+
+alias e puts
+
+e
+e "#{Colours.rev}First, we will show the code used by Colours.rev():"
+e
+pp Colours.rev
+e
+
+e '='*80
+x = '<i>in-vitro</i>-F <steelblue>abcdef</steelblue> And some more here ...'
+result = Colours.rev+
+         Colours.fancy_parse(x)
+pp result
+e result
+e '='*80
+
+x = '- Es gibt den <i>E. coli</i> Stamm <lightblue>BL21</lightblue> der in der Gentechnik eingesetzt wird. <tomato>Wieso</tomato>? Er ist ein <one>Protease-armer Stamm</one>.'
+result = Colours.rev+
+         Colours.fancy_parse(x)
+pp result
+e result
+e '='*80

data/test/testing_kde_colour_palette.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'colours/autoinclude'
+
+e 'Now testing the component called `kde_colour_palette`.'
+text = 'The cat jumps over the fence.'
+e
+Colours.eabyss_blue(text+' (abyss_blue)')
+Colours.ealternate_grey(text+' (alternate_grey)')
+Colours.ebeware_orange(text+' (beware_orange)')
+Colours.eburnt_charcoal(text+' (burnt_charcoal)')
+Colours.ecardboard_grey(text+' (cardboard_grey)')
+Colours.echarcoal_grey(text+' (charcoal_grey)')
+Colours.ecoastal_fog(text+' (coastal_fog)')
+Colours.edeco_blue(text+' (deco_blue)')
+Colours.ehover_blue(text+' (hover_blue)')
+Colours.ehyper_blue(text+' (hyper_blue)')
+Colours.eicon_blue(text+' (icon_blue)')
+Colours.eicon_green(text+' (icon_green)')
+Colours.eicon_grey(text+' (icon_grey)')
+Colours.eicon_red(text+' (icon_red)')
+Colours.eicon_yellow(text+' (icon_yellow)')
+Colours.elazy_grey(text+' (lazy_grey)')
+Colours.enoble_fir(text+' (noble_fir)')
+Colours.epaper_white(text+' (paper_white)')
+Colours.epimpinella(text+' (pimpinella)')
+Colours.eplasma_blue(text+' (plasma_blue)')
+e