coloryze 2.0.0

data/test/color/coloryze_test.rb

@@ -0,0 +1,90 @@
+#!/usr/bin/ruby -w
+# -*- ruby -*-
+
+require 'rubyunit'
+require 'color/coloryze'
+require 'stringio'
+require 'riel'
+
+Log.verbose = true
+
+class ColoryzeTestCase < RUNIT::TestCase
+  include Loggable
+
+  def assert_iostring(ary, io, verbose = false)
+    str = io.string
+    info str if verbose
+    assert_equals ary.collect { |x| x + "\n" }.join(''), io.string
+  end
+
+  def test_usage
+    io = StringIO.new
+    col = Coloryze.new(%w{ --help }, io)
+    str = io.string
+    
+    exp = Array.new
+    exp << "usage: coloryze [options]"
+    exp << "options:"
+    exp << "    --help, --usage                 display this help message"
+    exp << "    --monochromatic=HUE             display one hue"
+    exp << "    --split-complementary=HUE,DEG   display hue and two complements near 180 degrees"
+    exp << "    --double-complementary=HUE,HUE  display two hues and their two complements"
+    exp << "    --complementary=HUE             display hues at 180 degrees from each other"
+    exp << "    --analogous=HUE,DEG             display three hues near each other"
+    exp << "    --triadic=HUE                   display three equidistant hues"
+    exp << "    --hues=START,END,INT            display colors for the generated hues (no scheme applied)"
+    exp << "    --sample=NUM                    select only NUM colors per hue, chosen randomly"
+    exp << "    --total-sample=NUM              select only NUM total colors, chosen randomly"
+    exp << "    --saturation=START,END,INT      set the saturation start, end, and interval"
+    exp << "    --brightness=START,END,INT      set the brightness start, end, and interval"
+    exp << "    --output=TYPE                   set the output type, \"text\" (the default) or \"html\""
+    exp << "    --verbose                       produce debugging output"
+    exp << "    --version                       display the version and exit"
+
+    assert_iostring exp, io
+
+    assert_equal 0, col.exit_status
+  end
+
+  def test_version
+    io = StringIO.new
+    col = Coloryze.new(%w{ --version }, io)
+    str = io.string
+
+    exp = Array.new
+    exp << "coloryze, version 2.0.0"
+    exp << "Written by Jeff Pace (jpace@incava.org)"
+    exp << "Released under the GNU Public License."
+
+    assert_iostring exp, io
+
+    assert_equal 0, col.exit_status
+  end
+
+  def do_invalid_scheme_arguments_test(scheme, required, *options)
+    ([ '', '='] | options).each do |option|
+      outio = StringIO.new
+      errio = StringIO.new
+      col = Coloryze.new([ '--' + scheme + option ], outio, errio)
+      str = errio.string
+
+      exp = Array.new
+      exp << "error: scheme '#{scheme}' requires #{required}"
+
+      assert_iostring exp, errio
+
+      assert_equal 1, col.exit_status
+    end
+  end
+
+  def test_invalid_scheme_arguments
+    do_invalid_scheme_arguments_test 'monochromatic',        'hue',           '=31,34', '=,aa'
+    do_invalid_scheme_arguments_test 'split-complementary',  'hue,deg',       '=123',   '=123,321,23', '=123,01aabc'
+    do_invalid_scheme_arguments_test 'double-complementary', 'hue,hue',       '=11',    '=123,321,23'
+    do_invalid_scheme_arguments_test 'complementary',        'hue',           '=12,31'
+    do_invalid_scheme_arguments_test 'analogous',            'hue,deg',       '=41', '=,43', '=1,2,3', '=23,aabbcc'
+    do_invalid_scheme_arguments_test 'triadic',              'hue',           '=1,2', '=2,3,4,5', '=123,234,'
+    do_invalid_scheme_arguments_test 'hues',                 'start,end,int', '=1,2', '=1,2,3,4'
+  end
+  
+end

data/test/color/full_palette_test.rb

@@ -0,0 +1,153 @@
+#!/usr/bin/ruby -w
+# -*- ruby -*-
+
+require 'rubyunit'
+require 'color/hsb'
+require 'color/rgb'
+require 'color/scheme'
+require 'color/full_palette'
+require 'stringio'
+require 'riel'
+
+
+class FullPaletteTestCase < RUNIT::TestCase
+  include Loggable
+
+  def assert_iostring(ary, io, verbose = false)
+    str = io.string
+    info str if verbose
+    assert_equals ary.collect { |x| x + "\n" }.join(''), io.string
+  end
+
+  def xtest_as_text
+    hues = [ [ 123, 23, 12 ] ].collect { |vals| Color::RGB.new(*vals).to_hsb.hue }
+    log "hues: #{hues.inspect}"
+    args = {
+      :background => nil
+    }
+    fp = Color::FullPalette.new(hues, args)
+
+    str = StringIO.new
+    fp.print_as_text(str)
+    # puts str.string
+  end
+  
+  def xtest_as_html
+    hues = [ [ 123, 23, 12 ] ].collect { |vals| Color::RGB.new(*vals).to_hsb.hue }
+    log "hues: #{hues.inspect}"
+    background = nil
+    args = {
+      :background => nil
+    }
+    fp = Color::FullPalette.new(hues, args)
+
+    str = StringIO.new
+    fp.print_as_html(str)
+    # puts str.string
+  end
+
+  def test_monochromatic
+    scheme = Color::Monochromatic.new(123)
+    info "scheme: #{scheme}"
+
+    hues = scheme.hues
+    info "hues: #{hues}"
+
+    assert_equal [ 123 ], scheme.hues
+
+    params = {
+      :saturation_start => 20,
+      :saturation_end   => 25,
+      :saturation_step  => 5,
+      :brightness_start => 10,
+      :brightness_end   => 100,
+      :brightness_step  => 50,
+    }
+
+    palette = Color::FullPalette.new(hues, params)
+    info "palette: #{palette}"
+
+    info "palette.colors: #{palette.colors}"
+
+    exp_colors = [ 
+      Color::HSB.new(123,  0.2, 0.1), 
+      Color::HSB.new(123,  0.2, 0.6), 
+      Color::HSB.new(123, 0.25, 0.1), 
+      Color::HSB.new(123, 0.25, 0.6), 
+    ]
+    
+    assert_equal exp_colors, palette.colors
+
+    io  = StringIO.new
+    palette.print_as_html(io)
+    str = io.string
+
+    exp = Array.new
+
+    exp << "<div style=\"background-color: FFFFFF;\">"
+    exp << "    <table width=\"100%\">"
+    exp << "        <tr>"
+    exp << "            <td style=\"color: #000000;\">hue 123 &deg;</td>"
+    exp << "        </tr>"
+    exp << "        <tr>"
+    exp << "            <td>"
+    exp << "                <table width=\"100%\">"
+    exp << "                    <tr>"
+    exp << "                        <td colspan=2>"
+    exp << "                            saturation: 0.2"
+    exp << "                        </td>"
+    exp << "                    </tr>"
+    exp << "                    <tr>"
+    exp << "                        <td style=\"width: 50%; vertical-align: bottom; border:2px outset; border-collapse:collapse;\">"
+    exp << "                            <table width=\"100%\" border=\"0\" border-width=\"4px\">"
+    exp << "                                <tr><td>#7a997b; b: 0.60</td></tr"
+    exp << "                                <tr><td style=\"background-color: #7a997b; vertical-align: bottom;\"><br>&nbsp;</td></tr>"
+    exp << "                            </table>"
+    exp << "                        </td>"
+    exp << "                        <td style=\"width: 50%; vertical-align: bottom; border:2px outset; border-collapse:collapse;\">"
+    exp << "                            <table width=\"100%\" border=\"0\" border-width=\"4px\">"
+    exp << "                                <tr><td>#141914; b: 0.10</td></tr"
+    exp << "                                <tr><td style=\"background-color: #141914; vertical-align: bottom;\"><br>&nbsp;</td></tr>"
+    exp << "                            </table>"
+    exp << "                        </td>"
+    exp << "                    </tr>"
+    exp << "                </table>"
+    exp << "            </td>"
+    exp << "        </tr>"
+    exp << "        <tr>"
+    exp << "            <td>"
+    exp << "                <table width=\"100%\">"
+    exp << "                    <tr>"
+    exp << "                        <td colspan=2>"
+    exp << "                            saturation: 0.25"
+    exp << "                        </td>"
+    exp << "                    </tr>"
+    exp << "                    <tr>"
+    exp << "                        <td style=\"width: 50%; vertical-align: bottom; border:2px outset; border-collapse:collapse;\">"
+    exp << "                            <table width=\"100%\" border=\"0\" border-width=\"4px\">"
+    exp << "                                <tr><td>#729974; b: 0.60</td></tr"
+    exp << "                                <tr><td style=\"background-color: #729974; vertical-align: bottom;\"><br>&nbsp;</td></tr>"
+    exp << "                            </table>"
+    exp << "                        </td>"
+    exp << "                        <td style=\"width: 50%; vertical-align: bottom; border:2px outset; border-collapse:collapse;\">"
+    exp << "                            <table width=\"100%\" border=\"0\" border-width=\"4px\">"
+    exp << "                                <tr><td>#131913; b: 0.10</td></tr"
+    exp << "                                <tr><td style=\"background-color: #131913; vertical-align: bottom;\"><br>&nbsp;</td></tr>"
+    exp << "                            </table>"
+    exp << "                        </td>"
+    exp << "                    </tr>"
+    exp << "                </table>"
+    exp << "            </td>"
+    exp << "        </tr>"
+    exp << "    </table>"
+    exp << "</div>"
+
+    puts io.string
+    assert_iostring exp, io
+
+  end
+
+  #$$$ todo: add tests for schemes
+  
+  
+end

data/test/color/hsb_test.rb

@@ -0,0 +1,54 @@
+#!/usr/bin/ruby -w
+# -*- ruby -*-
+
+require 'rubyunit'
+require 'color/hsb'
+require 'color/rgb'
+require 'riel'
+
+
+class HSBTestCase < RUNIT::TestCase
+  include Loggable
+
+  def do_initialize_test(h, s, b)
+    log "h: #{h}; s: #{s}; b: #{b}"
+    hsb = Color::HSB.new(h, s, b)
+    log "hsb: #{hsb}"
+    assert_equals h, hsb.hue
+    assert_equals s, hsb.saturation
+    assert_equals b, hsb.brightness
+  end
+
+  def test_initialize
+    do_initialize_test(0, 0, 0)
+    do_initialize_test(0, 0, 1)
+    do_initialize_test(0, 0, 0.5)
+    do_initialize_test(0, 0, 0.25)
+
+    [ -1, -0.1, 1.01, 10 ].each do |val|
+      [ [ val, 0 ], [0, val ] ].each do |s, b|
+        assert_raise RuntimeError do
+          do_initialize_test(0, s, b)
+        end
+      end
+    end
+
+    do_initialize_test(70, 1.0, 1.0)
+  end
+ 
+  def do_to_rgb_test(rgb_expected, h, s, b)
+    log "h: #{h}; s: #{s}; b: #{b}"
+    rgb_actual = Color::HSB.new(h, s, b).to_rgb
+    log sprintf("rgb: exp: #{rgb_expected.inspect} (%06x); act: #{rgb_actual} (%06x)\n", rgb_expected, rgb_actual.to_i)
+    assert_equals rgb_expected, rgb_actual.to_i, "h: #{h}; s: #{s}; b: #{b}"
+  end
+
+  def test_to_rgb
+    do_to_rgb_test(0,         0,   0, 0)
+    do_to_rgb_test(0xffffff,  0,   0, 1)
+    do_to_rgb_test(0x7f7f7f,  0,   0, 0.5)
+    do_to_rgb_test(0x3f3f3f,  0,   0, 0.25)
+    do_to_rgb_test(0xd4ff00, 70, 1.0, 1.0)
+  end
+
+end

data/test/color/rgb_test.rb

@@ -0,0 +1,104 @@
+#!/usr/bin/ruby -w
+# -*- ruby -*-
+
+require 'rubyunit'
+require 'color/rgb'
+require 'color/hsb'
+require 'riel'
+
+
+class RGBTestCase < RUNIT::TestCase
+  include Color, Loggable
+
+  def do_initialize_from_numbers_test(r, g, b)
+    log "r: #{r}; g: #{g}; b: #{b}"
+    rgb = RGB.new(r, g, b)
+    assert_equals r, rgb.red
+    assert_equals g, rgb.green
+    assert_equals b, rgb.blue
+  end
+
+  def do_initialize_from_rgb_test(str, r, g, b)
+    log "str: #{str}; r: #{r}; g: #{g}; b: #{b}"
+    rgb = RGB.new(str)
+    assert_equals r, rgb.red
+    assert_equals g, rgb.green
+    assert_equals b, rgb.blue
+  end
+
+  def test_initialize_from_numbers
+    do_initialize_from_numbers_test(  0,   0,   0)
+    do_initialize_from_numbers_test( 10,  55, 105)
+    do_initialize_from_numbers_test(115, 100, 210)
+    do_initialize_from_numbers_test(225, 220,  99)
+    do_initialize_from_numbers_test(255, 255, 255)
+
+    [ -1, -0.1, 255.01, 256, 1000 ].each do |val|
+      [ [ val, 0, 0 ], [ 0, val, 0 ], [ 0, 0, val ] ].each do |r, g, b|
+        assert_raise RuntimeError do
+          do_initialize_from_numbers_test(r, g, b)
+        end
+      end
+    end
+
+  end
+
+  def test_initialize_from_rgb
+    do_initialize_from_rgb_test "#000000",   0,   0,   0
+    do_initialize_from_rgb_test "#ffffff", 255, 255, 255
+    do_initialize_from_rgb_test  "000000",   0,   0,   0
+    do_initialize_from_rgb_test  "ffffff", 255, 255, 255
+    do_initialize_from_rgb_test  "aabeef", 170, 190, 239
+    do_initialize_from_rgb_test  "9a8b7c", 154, 139, 124
+
+    [ '#0101g1', '0101g1' ].each do |str|
+      assert_raise RuntimeError do
+        do_initialize_from_rgb_test(str, nil, nil, nil)
+      end
+    end
+
+  end
+
+  def test_equal
+    assert_equal RGB.new(0, 10, 20), RGB.new(0, 10, 20)
+  end
+
+  def do_to_hsb_test(h_exp, s_exp, b_exp, r, g, b)
+    log "r: #{r}; g: #{g}; b: #{b}"
+    hsb_expected = HSB.new(h_exp, s_exp, b_exp)
+    hsb_actual   = RGB.new(r, g, b).to_hsb
+    log "hsb: exp: #{hsb_expected}; act: #{hsb_actual}"
+    assert_equals hsb_expected, hsb_actual, "r: #{r}; g: #{g}; b: #{b}"
+  end
+
+  def test_to_hsb
+    # do_to_hsb_test(0, 0, 0, 0, 0, 0)
+    # do_to_hsb_test(210.0, 0.6666667, 0.02352941, 2, 4, 6)
+    
+    # from: http://en.wikipedia.org/wiki/HSL_and_HSV
+    tests = [
+      [ 61.4, 0.779, 0.639, 0.628, 0.643, 0.142 ],
+      [ 49.6, 0.946, 0.937, 0.941, 0.785, 0.053 ],
+    ].each do |vals|
+      log "vals: #{vals.inspect}"
+      r, g, b = (3 .. 5).collect { |n| vals[n] * 255 }
+      do_to_hsb_test(vals[0], vals[1], vals[2], r, g, b)
+    end
+
+  end
+
+  def do_matches_rgb_string_test(match_expected, val)
+    assert_equals match_expected, !Color::RGB.matches_rgb_string?(val).nil?
+  end
+
+  def test_matches_rgb_string
+    do_matches_rgb_string_test true,  "ff88dd"
+    do_matches_rgb_string_test true,  "001122"
+    do_matches_rgb_string_test false, "ffd"
+    do_matches_rgb_string_test false, "012"
+    do_matches_rgb_string_test true,  "#ff88dd"
+    do_matches_rgb_string_test true,  "#001122"
+  end
+    
+
+end

data/test/color/sample_palette_test.rb

@@ -0,0 +1,64 @@
+#!/usr/bin/ruby -w
+# -*- ruby -*-
+
+require 'rubyunit'
+require 'color/hsb'
+require 'color/rgb'
+require 'color/sample_palette'
+require 'stringio'
+require 'riel'
+
+
+class SamplePaletteTestCase < RUNIT::TestCase
+  include Loggable
+  
+  def test_total_samples_as_text
+    hues = [
+      [ 123, 23, 12 ],
+      [  25, 37, 31 ]
+    ].collect do |vals| 
+      Color::RGB.new(*vals).to_hsb.hue
+    end
+
+    log "hues: #{hues.inspect}"
+    args = {
+      :background    => nil,
+      :total_samples => 5,
+    }
+    fp = Color::SamplePalette.new(hues, args)
+
+    str = StringIO.new
+    fp.print_as_text(str)
+    # puts str.string
+  end
+  
+  def test_as_text
+    hues = [ [ 123, 23, 12 ] ].collect { |vals| Color::RGB.new(*vals).to_hsb.hue }
+    log "hues: #{hues.inspect}"
+    args = {
+      :background    => nil,
+      :total_samples => 4,
+    }
+    fp = Color::SamplePalette.new(hues, args)
+
+    str = StringIO.new
+    fp.print_as_text(str)
+    # puts str.string
+  end
+  
+  def test_as_html
+    hues = [ [ 123, 23, 12 ] ].collect { |vals| Color::RGB.new(*vals).to_hsb.hue }
+    log "hues: #{hues.inspect}"
+    background = nil
+    args = {
+      :background    => nil,
+      :total_samples => 4,
+    }
+    fp = Color::SamplePalette.new(hues, args)
+
+    str = StringIO.new
+    fp.print_as_html(str)
+    # puts str.string
+  end
+  
+end