paint 0.8.0

data/CHANGELOG.rdoc

@@ -0,0 +1,2 @@
+=== 0.8 ===
+* Initial release

data/LICENSE.txt

@@ -0,0 +1,22 @@
+The MIT LICENSE
+
+Copyright (c) 2011 Jan Lelis
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,155 @@
+Paint manages terminal colors and effects for you. It combines the strengths of gems like term-ansicolor or rainbow into a simple to use and flexible colorizer.
+
+== Features
+* No string extensions (suitable for library development)
+* Supports setting 256 colors (for capable terminals)
+* Supports setting any effects (although most terminals won't support it)
+* Simple to use
+* Custom shortcuts can be defined and flexibly mixed in
+
+== TODO next version (beginning of july)
+* Fall-back mode for non-256-color terminals (Paint.mode)
+* Detection of those old terminals
+
+== Setup
+
+Install with:
+
+  gem install paint
+
+In Ruby do:
+
+  require 'paint'
+
+== Usage
+
+The only method you need to know to get started is: <tt>Paint.[]</tt>
+
+The first argument given to Paint.[] is the string to colorize (if the object is not a string, to_s will be called on the object). The other arguments describe how to modify/colorize the string. Let's learn by example:
+
+  Paint['Ruby', :red]           # sets ansi color red
+  Paint['Ruby', :red, :bright]  # also applies bright/bold effect
+  Paint['Ruby', :bright, :red]  # does the same as above
+  Paint['Ruby', :red, :bright, :underline] # effects can often be combined
+  Paint['Ruby', :red, :blue]    # the second color you define is for background
+  Paint['Ruby', nil, :blue]     # pass a nil before a color to ignore foreground and only set background color
+  Paint['Ruby', [100, 255, 5]]  # you can define rgb colors that map to one of 256 colors. Only supported on 256-color terminals, of course
+  Paint['Ruby', "gold", "snow"] # Paint supports rgb.txt color names, note that the arguments are strings (:yellow != "yellow")!
+  Paint['Ruby', "#123456"]      # html like definitions are possible.
+  Paint['Ruby', "fff"]          # another html hex definition
+  Paint['Ruby']                 # don't pass any argument to get one of eight random ansi foreground colors
+  Paint['Ruby', :inverse]       # swaps fore- and background
+  Paint['Ruby', :italic, :encircle, :rapid_blink, :overline] # probably not supported effects
+
+If you pass multiple colors, the first one is taken as foreground color and the second one defines the background color (all others will be ignored). To only change the background color, you have to pass a <tt>nil</tt> first. Effects can be passed in any order.
+
+To see more examples, checkout the specs.
+
+== More details about terminal colors and effects
+
+Terminal colors/effects are set by {ansi escape sequences}[http://en.wikipedia.org/wiki/ANSI_escape_code]. These are strings that look like this: <tt>\e[X;X;X;X;X]m</tt> where X are integers with some meaning. For example, 0 means reset, 31 means red foreground and 41 red background. When you tell Paint to use one of the eight ansi base colors as foreground color, it just inserts a number between 30 and 37 in the sequence. The following colors are available:
+
+  :black, :red, :green, :yellow, :blue, :magenta, :cyan, :white, (:default)
+
+When combined with the <tt>:bright</tt> (= <tt>:bold</tt>) effect, the color in the terminal emulator often differs a little bit.
+
+Through special sequences it's also possible to set 256-colors, instead of 8, which is also supported by many - but not all - terminals. Paint automatically translates given rgb colors to a suitable color of the 256 available colors.
+
+When using the <tt>Paint.[]</tt> method, Paint wraps the given string between the calculated escape sequence and an reset sequence (<tt>"\e[0m"</tt>). You can directly get only the escape sequence by using the <tt>Paint.color</tt> method.
+
+=== Effects (without colors)
+
+Also see {en.wikipedia.org/wiki/ANSI_escape_code}[http://en.wikipedia.org/wiki/ANSI_escape_code]:
+
+==== Often supported
+
+  0) :reset, :nothing
+  1) :bright, :bold
+  4) :underline
+  7) :inverse, :negative
+  8) :conceal, :hide
+  22) :clean
+  24) :underline_off
+  26) :inverse_off, :positive
+  27) :conceal_off, :show, :reveal
+
+==== Not widely supported
+
+  2) :faint
+  3) :italic
+  5) :blink, :slow_blink
+  6) :rapid_blink
+  9) :crossed, :crossed_out
+  10) :default_font, :font0
+  11-19) :font1, :font2, :font3, :font4, :font5, :font6, :font7, :font8, :font9
+  20) :fraktur
+  21) :bright_off, :bold_off, :double_underline
+  23) :italic_off, :fraktur_off
+  25) :blink_off
+  29) :crossed_off, :crossed_out_off
+  51) :frame
+  52) :encircle
+  53) :overline
+  54) :frame_off, :encircle_off
+  55) :overline_off
+
+== Shortcuts
+
+Now for the fancy part: Color shortcuts for your gems and scripts! Note: You don't have to use them (and only stick to <tt>Paint.[]</tt>) ;)
+
+It's easy: Just setup a hash of symbol keys and escape string values at: <tt>Paint::SHORTCUTS[:your_namespace]</tt>, for example:
+
+  Paint::SHORTCUTS[:example] = {
+    :white => Paint.color(:black),
+    :red => Paint.color(:red, :bright),
+    :title => Paint.color(:underline),
+  }
+
+The methods become rubymagically available in a <tt>Paint</tt> child model (via method_missing):
+
+  Paint::Example.red 'Ruby' # => "\e[31;1mRuby\e[0m"
+  Paint::Example.white      # => "\e[37m"
+
+As you can see, the helper methods look useful and can take either one (wrap string) or none (only color) arguments ...but they aren't really <em>short</em> yet.
+
+=== Inlcuding action
+
+Just include them:
+
+  include Paint::Example
+  red # => "\e[31;1m"
+  white 'Ruby' # => "\e[30m"
+
+All shortcuts, defined in your shortcut namespace at this time, are now (privately) available in your current namespace (without using a method_missing implementation).
+
+Furthermore, there are two variations of this approach:
+
+  include Paint::Example::String
+  "Ruby".title # => "\e[4mRuby\e[0m"
+  5.red # => "\e[31;1m5\e[0m"
+
+In this case, <tt>self</tt> will be converted to a string and wrapped with the specific color code. Note, that the helper methods doesn't take any arguments when using this method.
+
+The third way allows you to get a single color helper method to avoid cluttering namespaces:
+
+  include Paint::Example::Prefix::ExampleName
+  "Ruby".example_name(:red) # => "\e[31;1mRuby\e[0m"
+
+=== Utilities
+
+There are some helper methods available. You can get a <tt>p</tt> like alternative for calling <tt>Paint.[]</tt>:
+
+  require 'paint/pa'
+  pa "Ruby", :red, :underline  # same as puts Paint["Ruby", :red, :underline]
+
+Another one is <tt>Paint.unpaint</tt>, which removes any ansi colors:
+
+  Paint.unpaint( Paint['J-_-L', :red, :bright] ).should == 'J-_-L'
+
+== Credits
+
+Mainly influenced by rainbow[https://github.com/sickill/rainbow] and {term-ansicolor}[https://github.com/flori/term-ansicolor].
+
+Copyright (c) 2011 Jan Lelis, http://rbjl.net, released under the MIT license.
+
+J-_-L

data/Rakefile

@@ -0,0 +1,51 @@
+GEMSPEC = 'paint.gemspec'
+
+require 'rake'
+#require 'rake/rdoctask'
+require 'fileutils'
+require 'rspec/core/rake_task'
+
+task :default => :spec
+task :test    => :spec
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = [
+     '--color',
+    '-r ' + File.expand_path( File.join( 'spec', 'spec_helper') ),
+  ]
+end
+
+def gemspec
+  @gemspec ||= eval(File.read(GEMSPEC), binding, GEMSPEC)
+end
+
+desc "Build the gem"
+task :gem => :gemspec do
+  sh "gem build #{GEMSPEC}"
+  FileUtils.mkdir_p 'pkg'
+  FileUtils.mv "#{gemspec.name}-#{gemspec.version}.gem", 'pkg'
+end
+
+desc "Install the gem locally"
+task :install => :gem do
+  sh %{gem install pkg/#{gemspec.name}-#{gemspec.version} --no-rdoc --no-ri}
+end
+
+desc "Generate the gemspec"
+task :generate do
+  puts gemspec.to_ruby
+end
+
+desc "Validate the gemspec"
+task :gemspec do
+  gemspec.validate
+end
+
+#Rake::RDocTask.new do |rdoc|
+#  require File.expand_path( File.join( 'lib',  'paint') )
+#
+#  rdoc.rdoc_dir = 'doc'
+#  rdoc.title = "paint #{Paint::VERSION}"
+#  rdoc.rdoc_files.include('README*')
+#  rdoc.rdoc_files.include('lib/**/*.rb')
+#end

data/lib/paint.rb

@@ -0,0 +1,175 @@
+require 'paint/version'
+require 'paint/shortcuts'
+require 'paint/util'
+
+module Paint
+  autoload :RGB_COLORS, 'paint/rgb_colors'
+
+  # Important purpose
+  NOTHING = "\e[0m"
+
+  # Basic colors (often, the color differs when using the bright effect)
+  # Final color will be 30 + value for foreground and 40 + value for background
+  ANSI_COLORS = {
+    :black   => 0,
+    :red     => 1,
+    :green   => 2,
+    :yellow  => 3,
+    :blue    => 4,
+    :magenta => 5,
+    :cyan    => 6,
+    :white   => 7,
+    :default => 9,
+  }
+
+  # Terminal effects - most of them are not supported ;)
+  # See http://en.wikipedia.org/wiki/ANSI_escape_code
+  ANSI_EFFECTS = {
+    :reset         => 0,  :nothing         => 0,  # usually supported
+    :bright        => 1,  :bold            => 1,  # usually supported
+    :faint         => 2,
+    :italic        => 3,
+    :underline     => 4,                          # usually supported
+    :blink         => 5,  :slow_blink      => 5,
+    :rapid_blink   => 6,
+    :inverse       => 7,  :swap            => 7,  # usually supported
+    :conceal       => 8,  :hide            => 9,
+    :default_font  => 10,
+    :font0 => 10, :font1 => 11, :font2 => 12, :font3 => 13, :font4 => 14,
+    :font5 => 15, :font6 => 16, :font7 => 17, :font8 => 18, :font9 => 19,
+    :fraktur       => 20,
+    :bright_off    => 21, :bold_off        => 21, :double_underline => 21,
+    :clean         => 22,
+    :italic_off    => 23, :fraktur_off     => 23,
+    :underline_off => 24,
+    :blink_off     => 25,
+    :inverse_off   => 26, :positive        => 26,
+    :conceal_off   => 27, :show            => 27, :reveal           => 27,
+    :crossed_off   => 29, :crossed_out_off => 29,
+    :frame         => 51,
+    :encircle      => 52,
+    :overline      => 53,
+    :frame_off     => 54, :encircle_off    => 54,
+    :overline_off  => 55,
+  }
+
+  class << self
+    # Takes a string and color options and colorizes the string
+    # See README.rdoc for details
+    def [](string, *args)
+      color(*args) + string.to_s + NOTHING
+    end
+
+    # Sometimes, you only need the color
+    # Used by []
+    def color(*options)
+      mix = []
+      color_seen = false
+
+      if options.empty?
+        mix << random(false) # random foreground color
+      else
+        options.each{ |option|
+          case option
+          when Symbol
+            if ANSI_EFFECTS.keys.include?(option)
+              mix << effect(option)
+            elsif ANSI_COLORS.keys.include?(option)
+              mix  << simple(option, color_seen)
+              color_seen = true
+            else
+              raise ArgumentError, "Unknown color or effect: #{ option }"
+            end
+
+          when Array
+            if option.size == 3 && option.all?{ |n| n.is_a? Numeric }
+              mix << rgb(*(option + [color_seen])) # 1.8 workaround
+              color_seen = true
+            else
+              raise ArgumentError, "Array argument must contain 3 numerals"
+            end
+
+          when ::String
+            if option =~ /^#?(?:[0-9a-f]{3}){1,2}$/
+              mix << hex(option, color_seen)
+              color_seen = true
+            else
+              mix << name(option, color_seen)
+              color_seen = true
+            end
+
+          when Numeric
+            integer = option.to_i
+            color_seen = true if (30..49).include?(integer)
+            mix << integer
+
+          when nil
+            color_seen = true
+          
+          else
+            raise ArgumentError, "Invalid argument: #{ option.inspect }"
+
+          end
+        }
+      end
+
+      wrap(*mix)
+    end
+
+    # Adds ansi sequence
+    def wrap(*ansi_codes)
+      "\e[" + ansi_codes*";" + "m"
+    end
+
+    # Creates simple ansi color by looking it up on Paint::ANSI_COLORS
+    def simple(color_name, background = false)
+      (background ? 40 : 30) + ANSI_COLORS[color_name]
+    end
+
+    # Creates a 256-compatible color from rgb values
+    def rgb(red, green, blue, background = false)
+      "#{background ? 48 : 38};5;#{rgb_value(red, green, blue)}"
+    end
+
+    # Creates 256-compatible color from a html-like color string
+    def hex(string, background = false)
+      string.tr! '#',''
+      rgb(
+       *(if string.size == 6
+          # string.chars.each_cons(2).map{ |hex_color| hex_color.join.to_i(16) }
+          [string[0,2].to_i(16), string[2,2].to_i(16), string[4,2].to_i(16)]
+        else
+          string.chars.map{ |hex_color_half| (hex_color_half*2).to_i(16) }
+        end + [background]) # 1.8 workaround
+      )
+    end
+
+    # Creates a 256-color from a name found in Paint::RGB_COLORS (based on rgb.txt)
+    def name(color_name, background = false)
+      if color_code = RGB_COLORS[color_name]
+        "#{background ? 48 : 38};5;#{color_code}"
+      end
+    end
+
+    # Creates a random ansi color
+    def random(background = false)
+      (background ? 40 : 30) + rand(8)
+    end
+
+    # Creates the specified effect by looking it up in Paint::ANSI_COLORS
+    def effect(effect_name)
+      ANSI_EFFECTS[effect_name]
+    end
+
+    private
+ 
+    # Gets nearest supported color, heavily inspired by the rainbow gem
+    def rgb_value(red, green, blue)
+      [16, *[red, green, blue].zip([36, 6, 1]).map{ |color, mod|
+        (6 * (color.to_f / 256)).to_i * mod
+      }].inject(:+) 
+    end
+  end
+end
+
+# J-_-L

data/lib/paint/pa.rb

@@ -0,0 +1,11 @@
+require 'paint'
+
+module Kernel
+  private
+
+  # A helper method similar to puts for printing a String on STDOUT
+  # Passes all arguments to Paint.[]
+  def pa(*args)
+    puts Paint[*args]
+  end
+end

data/lib/paint/rgb_colors.rb

@@ -0,0 +1,8 @@
+module Paint
+  # A list of color names, based on X11's rgb.txt
+  # Can be used with Paint.[] by passing a string containing the color name
+  # See Paint::Util::update_rgb_colors for generating
+  RGB_COLORS = {"snow"=>231, "ghost white"=>231, "GhostWhite"=>231, "white smoke"=>231, "WhiteSmoke"=>231, "gainsboro"=>231, "floral white"=>231, "FloralWhite"=>231, "old lace"=>231, "OldLace"=>231, "linen"=>231, "antique white"=>231, "AntiqueWhite"=>231, "papaya whip"=>230, "PapayaWhip"=>230, "blanched almond"=>230, "BlanchedAlmond"=>230, "bisque"=>230, "peach puff"=>230, "PeachPuff"=>230, "navajo white"=>230, "NavajoWhite"=>230, "moccasin"=>230, "cornsilk"=>231, "ivory"=>231, "lemon chiffon"=>230, "LemonChiffon"=>230, "seashell"=>231, "honeydew"=>231, "mint cream"=>231, "MintCream"=>231, "azure"=>231, "alice blue"=>231, "AliceBlue"=>231, "lavender"=>231, "lavender blush"=>231, "LavenderBlush"=>231, "misty rose"=>231, "MistyRose"=>231, "white"=>231, "black"=>16, "dark slate gray"=>59, "DarkSlateGray"=>59, "dark slate grey"=>59, "DarkSlateGrey"=>59, "dim gray"=>102, "DimGray"=>102, "dim grey"=>102, "DimGrey"=>102, "slate gray"=>109, "SlateGray"=>109, "slate grey"=>109, "SlateGrey"=>109, "light slate gray"=>109, "LightSlateGray"=>109, "light slate grey"=>109, "LightSlateGrey"=>109, "gray"=>188, "grey"=>188, "light grey"=>188, "LightGrey"=>188, "light gray"=>188, "LightGray"=>188, "midnight blue"=>18, "MidnightBlue"=>18, "navy"=>19, "navy blue"=>19, "NavyBlue"=>19, "cornflower blue"=>111, "CornflowerBlue"=>111, "dark slate blue"=>61, "DarkSlateBlue"=>61, "slate blue"=>104, "SlateBlue"=>104, "medium slate blue"=>105, "MediumSlateBlue"=>105, "light slate blue"=>141, "LightSlateBlue"=>141, "medium blue"=>20, "MediumBlue"=>20, "royal blue"=>69, "RoyalBlue"=>69, "blue"=>21, "dodger blue"=>39, "DodgerBlue"=>39, "deep sky blue"=>45, "DeepSkyBlue"=>45, "sky blue"=>153, "SkyBlue"=>153, "light sky blue"=>153, "LightSkyBlue"=>153, "steel blue"=>74, "SteelBlue"=>74, "light steel blue"=>189, "LightSteelBlue"=>189, "light blue"=>195, "LightBlue"=>195, "powder blue"=>195, "PowderBlue"=>195, "pale turquoise"=>195, "PaleTurquoise"=>195, "dark turquoise"=>44, "DarkTurquoise"=>44, "medium turquoise"=>80, "MediumTurquoise"=>80, "turquoise"=>86, "cyan"=>51, "light cyan"=>231, "LightCyan"=>231, "cadet blue"=>109, "CadetBlue"=>109, "medium aquamarine"=>115, "MediumAquamarine"=>115, "aquamarine"=>122, "dark green"=>28, "DarkGreen"=>28, "dark olive green"=>65, "DarkOliveGreen"=>65, "dark sea green"=>151, "DarkSeaGreen"=>151, "sea green"=>72, "SeaGreen"=>72, "medium sea green"=>78, "MediumSeaGreen"=>78, "light sea green"=>43, "LightSeaGreen"=>43, "pale green"=>157, "PaleGreen"=>157, "spring green"=>48, "SpringGreen"=>48, "lawn green"=>118, "LawnGreen"=>118, "green"=>46, "chartreuse"=>118, "medium spring green"=>49, "MediumSpringGreen"=>49, "green yellow"=>191, "GreenYellow"=>191, "lime green"=>77, "LimeGreen"=>77, "yellow green"=>149, "YellowGreen"=>149, "forest green"=>34, "ForestGreen"=>34, "olive drab"=>106, "OliveDrab"=>106, "dark khaki"=>186, "DarkKhaki"=>186, "khaki"=>229, "pale goldenrod"=>229, "PaleGoldenrod"=>229, "light goldenrod yellow"=>230, "LightGoldenrodYellow"=>230, "light yellow"=>231, "LightYellow"=>231, "yellow"=>226, "gold"=>226, "light goldenrod"=>229, "LightGoldenrod"=>229, "goldenrod"=>214, "dark goldenrod"=>178, "DarkGoldenrod"=>178, "rosy brown"=>181, "RosyBrown"=>181, "indian red"=>174, "IndianRed"=>174, "saddle brown"=>130, "SaddleBrown"=>130, "sienna"=>131, "peru"=>179, "burlywood"=>223, "beige"=>231, "wheat"=>230, "sandy brown"=>216, "SandyBrown"=>216, "tan"=>187, "chocolate"=>172, "firebrick"=>160, "brown"=>124, "dark salmon"=>216, "DarkSalmon"=>216, "salmon"=>216, "light salmon"=>216, "LightSalmon"=>216, "orange"=>214, "dark orange"=>214, "DarkOrange"=>214, "coral"=>209, "light coral"=>217, "LightCoral"=>217, "tomato"=>209, "orange red"=>202, "OrangeRed"=>202, "red"=>196, "hot pink"=>212, "HotPink"=>212, "deep pink"=>199, "DeepPink"=>199, "pink"=>224, "light pink"=>224, "LightPink"=>224, "pale violet red"=>211, "PaleVioletRed"=>211, "maroon"=>168, "medium violet red"=>163, "MediumVioletRed"=>163, "violet red"=>163, "VioletRed"=>163, "magenta"=>201, "violet"=>219, "plum"=>219, "orchid"=>213, "medium orchid"=>170, "MediumOrchid"=>170, "dark orchid"=>134, "DarkOrchid"=>134, "dark violet"=>128, "DarkViolet"=>128, "blue violet"=>135, "BlueViolet"=>135, "purple"=>129, "medium purple"=>141, "MediumPurple"=>141, "thistle"=>225, "snow1"=>231, "snow2"=>231, "snow3"=>188, "snow4"=>145, "seashell1"=>231, "seashell2"=>231, "seashell3"=>188, "seashell4"=>145, "AntiqueWhite1"=>231, "AntiqueWhite2"=>230, "AntiqueWhite3"=>188, "AntiqueWhite4"=>144, "bisque1"=>230, "bisque2"=>224, "bisque3"=>187, "bisque4"=>138, "PeachPuff1"=>230, "PeachPuff2"=>224, "PeachPuff3"=>187, "PeachPuff4"=>138, "NavajoWhite1"=>230, "NavajoWhite2"=>223, "NavajoWhite3"=>187, "NavajoWhite4"=>138, "LemonChiffon1"=>230, "LemonChiffon2"=>230, "LemonChiffon3"=>187, "LemonChiffon4"=>144, "cornsilk1"=>231, "cornsilk2"=>230, "cornsilk3"=>188, "cornsilk4"=>144, "ivory1"=>231, "ivory2"=>231, "ivory3"=>188, "ivory4"=>145, "honeydew1"=>231, "honeydew2"=>231, "honeydew3"=>188, "honeydew4"=>145, "LavenderBlush1"=>231, "LavenderBlush2"=>231, "LavenderBlush3"=>188, "LavenderBlush4"=>145, "MistyRose1"=>231, "MistyRose2"=>224, "MistyRose3"=>188, "MistyRose4"=>138, "azure1"=>231, "azure2"=>231, "azure3"=>188, "azure4"=>145, "SlateBlue1"=>141, "SlateBlue2"=>105, "SlateBlue3"=>104, "SlateBlue4"=>61, "RoyalBlue1"=>69, "RoyalBlue2"=>69, "RoyalBlue3"=>68, "RoyalBlue4"=>25, "blue1"=>21, "blue2"=>21, "blue3"=>20, "blue4"=>19, "DodgerBlue1"=>39, "DodgerBlue2"=>39, "DodgerBlue3"=>32, "DodgerBlue4"=>25, "SteelBlue1"=>117, "SteelBlue2"=>117, "SteelBlue3"=>74, "SteelBlue4"=>67, "DeepSkyBlue1"=>45, "DeepSkyBlue2"=>45, "DeepSkyBlue3"=>38, "DeepSkyBlue4"=>31, "SkyBlue1"=>153, "SkyBlue2"=>117, "SkyBlue3"=>110, "SkyBlue4"=>67, "LightSkyBlue1"=>195, "LightSkyBlue2"=>153, "LightSkyBlue3"=>152, "LightSkyBlue4"=>103, "SlateGray1"=>195, "SlateGray2"=>189, "SlateGray3"=>152, "SlateGray4"=>103, "LightSteelBlue1"=>195, "LightSteelBlue2"=>189, "LightSteelBlue3"=>152, "LightSteelBlue4"=>103, "LightBlue1"=>195, "LightBlue2"=>195, "LightBlue3"=>152, "LightBlue4"=>109, "LightCyan1"=>231, "LightCyan2"=>195, "LightCyan3"=>188, "LightCyan4"=>109, "PaleTurquoise1"=>195, "PaleTurquoise2"=>195, "PaleTurquoise3"=>152, "PaleTurquoise4"=>109, "CadetBlue1"=>159, "CadetBlue2"=>159, "CadetBlue3"=>116, "CadetBlue4"=>73, "turquoise1"=>51, "turquoise2"=>51, "turquoise3"=>44, "turquoise4"=>37, "cyan1"=>51, "cyan2"=>51, "cyan3"=>44, "cyan4"=>37, "DarkSlateGray1"=>159, "DarkSlateGray2"=>159, "DarkSlateGray3"=>116, "DarkSlateGray4"=>73, "aquamarine1"=>122, "aquamarine2"=>122, "aquamarine3"=>115, "aquamarine4"=>72, "DarkSeaGreen1"=>194, "DarkSeaGreen2"=>194, "DarkSeaGreen3"=>151, "DarkSeaGreen4"=>108, "SeaGreen1"=>85, "SeaGreen2"=>85, "SeaGreen3"=>79, "SeaGreen4"=>72, "PaleGreen1"=>157, "PaleGreen2"=>157, "PaleGreen3"=>114, "PaleGreen4"=>71, "SpringGreen1"=>48, "SpringGreen2"=>48, "SpringGreen3"=>42, "SpringGreen4"=>35, "green1"=>46, "green2"=>46, "green3"=>40, "green4"=>34, "chartreuse1"=>118, "chartreuse2"=>118, "chartreuse3"=>112, "chartreuse4"=>70, "OliveDrab1"=>191, "OliveDrab2"=>191, "OliveDrab3"=>149, "OliveDrab4"=>106, "DarkOliveGreen1"=>192, "DarkOliveGreen2"=>192, "DarkOliveGreen3"=>150, "DarkOliveGreen4"=>107, "khaki1"=>229, "khaki2"=>229, "khaki3"=>186, "khaki4"=>143, "LightGoldenrod1"=>229, "LightGoldenrod2"=>229, "LightGoldenrod3"=>186, "LightGoldenrod4"=>143, "LightYellow1"=>231, "LightYellow2"=>230, "LightYellow3"=>188, "LightYellow4"=>144, "yellow1"=>226, "yellow2"=>226, "yellow3"=>184, "yellow4"=>142, "gold1"=>226, "gold2"=>220, "gold3"=>184, "gold4"=>136, "goldenrod1"=>220, "goldenrod2"=>220, "goldenrod3"=>178, "goldenrod4"=>136, "DarkGoldenrod1"=>220, "DarkGoldenrod2"=>220, "DarkGoldenrod3"=>178, "DarkGoldenrod4"=>136, "RosyBrown1"=>224, "RosyBrown2"=>224, "RosyBrown3"=>181, "RosyBrown4"=>138, "IndianRed1"=>210, "IndianRed2"=>210, "IndianRed3"=>167, "IndianRed4"=>131, "sienna1"=>215, "sienna2"=>209, "sienna3"=>173, "sienna4"=>130, "burlywood1"=>223, "burlywood2"=>223, "burlywood3"=>180, "burlywood4"=>137, "wheat1"=>230, "wheat2"=>230, "wheat3"=>187, "wheat4"=>138, "tan1"=>215, "tan2"=>215, "tan3"=>179, "tan4"=>137, "chocolate1"=>208, "chocolate2"=>208, "chocolate3"=>172, "chocolate4"=>130, "firebrick1"=>203, "firebrick2"=>203, "firebrick3"=>160, "firebrick4"=>124, "brown1"=>203, "brown2"=>203, "brown3"=>167, "brown4"=>124, "salmon1"=>216, "salmon2"=>216, "salmon3"=>173, "salmon4"=>131, "LightSalmon1"=>216, "LightSalmon2"=>216, "LightSalmon3"=>180, "LightSalmon4"=>137, "orange1"=>214, "orange2"=>214, "orange3"=>178, "orange4"=>136, "DarkOrange1"=>208, "DarkOrange2"=>208, "DarkOrange3"=>172, "DarkOrange4"=>130, "coral1"=>210, "coral2"=>209, "coral3"=>173, "coral4"=>131, "tomato1"=>209, "tomato2"=>209, "tomato3"=>167, "tomato4"=>130, "OrangeRed1"=>202, "OrangeRed2"=>202, "OrangeRed3"=>166, "OrangeRed4"=>124, "red1"=>196, "red2"=>196, "red3"=>160, "red4"=>124, "DebianRed"=>197, "DeepPink1"=>199, "DeepPink2"=>199, "DeepPink3"=>162, "DeepPink4"=>125, "HotPink1"=>212, "HotPink2"=>211, "HotPink3"=>175, "HotPink4"=>132, "pink1"=>224, "pink2"=>218, "pink3"=>181, "pink4"=>138, "LightPink1"=>224, "LightPink2"=>218, "LightPink3"=>181, "LightPink4"=>138, "PaleVioletRed1"=>218, "PaleVioletRed2"=>211, "PaleVioletRed3"=>175, "PaleVioletRed4"=>132, "maroon1"=>206, "maroon2"=>205, "maroon3"=>163, "maroon4"=>126, "VioletRed1"=>205, "VioletRed2"=>205, "VioletRed3"=>168, "VioletRed4"=>125, "magenta1"=>201, "magenta2"=>201, "magenta3"=>164, "magenta4"=>127, "orchid1"=>219, "orchid2"=>213, "orchid3"=>176, "orchid4"=>133, "plum1"=>225, "plum2"=>225, "plum3"=>182, "plum4"=>139, "MediumOrchid1"=>213, "MediumOrchid2"=>177, "MediumOrchid3"=>170, "MediumOrchid4"=>97, "DarkOrchid1"=>171, "DarkOrchid2"=>171, "DarkOrchid3"=>134, "DarkOrchid4"=>91, "purple1"=>135, "purple2"=>135, "purple3"=>92, "purple4"=>55, "MediumPurple1"=>183, "MediumPurple2"=>141, "MediumPurple3"=>140, "MediumPurple4"=>97, "thistle1"=>231, "thistle2"=>225, "thistle3"=>188, "thistle4"=>139, "gray0"=>16, "grey0"=>16, "gray1"=>16, "grey1"=>16, "gray2"=>16, "grey2"=>16, "gray3"=>16, "grey3"=>16, "gray4"=>16, "grey4"=>16, "gray5"=>16, "grey5"=>16, "gray6"=>16, "grey6"=>16, "gray7"=>16, "grey7"=>16, "gray8"=>16, "grey8"=>16, "gray9"=>16, "grey9"=>16, "gray10"=>16, "grey10"=>16, "gray11"=>16, "grey11"=>16, "gray12"=>16, "grey12"=>16, "gray13"=>16, "grey13"=>16, "gray14"=>16, "grey14"=>16, "gray15"=>16, "grey15"=>16, "gray16"=>16, "grey16"=>16, "gray17"=>59, "grey17"=>59, "gray18"=>59, "grey18"=>59, "gray19"=>59, "grey19"=>59, "gray20"=>59, "grey20"=>59, "gray21"=>59, "grey21"=>59, "gray22"=>59, "grey22"=>59, "gray23"=>59, "grey23"=>59, "gray24"=>59, "grey24"=>59, "gray25"=>59, "grey25"=>59, "gray26"=>59, "grey26"=>59, "gray27"=>59, "grey27"=>59, "gray28"=>59, "grey28"=>59, "gray29"=>59, "grey29"=>59, "gray30"=>59, "grey30"=>59, "gray31"=>59, "grey31"=>59, "gray32"=>59, "grey32"=>59, "gray33"=>59, "grey33"=>59, "gray34"=>102, "grey34"=>102, "gray35"=>102, "grey35"=>102, "gray36"=>102, "grey36"=>102, "gray37"=>102, "grey37"=>102, "gray38"=>102, "grey38"=>102, "gray39"=>102, "grey39"=>102, "gray40"=>102, "grey40"=>102, "gray41"=>102, "grey41"=>102, "gray42"=>102, "grey42"=>102, "gray43"=>102, "grey43"=>102, "gray44"=>102, "grey44"=>102, "gray45"=>102, "grey45"=>102, "gray46"=>102, "grey46"=>102, "gray47"=>102, "grey47"=>102, "gray48"=>102, "grey48"=>102, "gray49"=>102, "grey49"=>102, "gray50"=>102, "grey50"=>102, "gray51"=>145, "grey51"=>145, "gray52"=>145, "grey52"=>145, "gray53"=>145, "grey53"=>145, "gray54"=>145, "grey54"=>145, "gray55"=>145, "grey55"=>145, "gray56"=>145, "grey56"=>145, "gray57"=>145, "grey57"=>145, "gray58"=>145, "grey58"=>145, "gray59"=>145, "grey59"=>145, "gray60"=>145, "grey60"=>145, "gray61"=>145, "grey61"=>145, "gray62"=>145, "grey62"=>145, "gray63"=>145, "grey63"=>145, "gray64"=>145, "grey64"=>145, "gray65"=>145, "grey65"=>145, "gray66"=>145, "grey66"=>145, "gray67"=>188, "grey67"=>188, "gray68"=>188, "grey68"=>188, "gray69"=>188, "grey69"=>188, "gray70"=>188, "grey70"=>188, "gray71"=>188, "grey71"=>188, "gray72"=>188, "grey72"=>188, "gray73"=>188, "grey73"=>188, "gray74"=>188, "grey74"=>188, "gray75"=>188, "grey75"=>188, "gray76"=>188, "grey76"=>188, "gray77"=>188, "grey77"=>188, "gray78"=>188, "grey78"=>188, "gray79"=>188, "grey79"=>188, "gray80"=>188, "grey80"=>188, "gray81"=>188, "grey81"=>188, "gray82"=>188, "grey82"=>188, "gray83"=>188, "grey83"=>188, "gray84"=>231, "grey84"=>231, "gray85"=>231, "grey85"=>231, "gray86"=>231, "grey86"=>231, "gray87"=>231, "grey87"=>231, "gray88"=>231, "grey88"=>231, "gray89"=>231, "grey89"=>231, "gray90"=>231, "grey90"=>231, "gray91"=>231, "grey91"=>231, "gray92"=>231, "grey92"=>231, "gray93"=>231, "grey93"=>231, "gray94"=>231, "grey94"=>231, "gray95"=>231, "grey95"=>231, "gray96"=>231, "grey96"=>231, "gray97"=>231, "grey97"=>231, "gray98"=>231, "grey98"=>231, "gray99"=>231, "grey99"=>231, "gray100"=>231, "grey100"=>231, "dark grey"=>145, "DarkGrey"=>145, "dark gray"=>145, "DarkGray"=>145, "dark blue"=>19, "DarkBlue"=>19, "dark cyan"=>37, "DarkCyan"=>37, "dark magenta"=>127, "DarkMagenta"=>127, "dark red"=>124, "DarkRed"=>124, "light green"=>157, "LightGreen"=>157}
+end
+
+# J-_-L

data/lib/paint/shortcuts.rb

@@ -0,0 +1,82 @@
+module Paint
+  # Hash for defining color/effect shortcuts
+  # See README for details
+  SHORTCUTS = {
+    # :example => {                    # would create a Paint::Example constant...
+    #   :light_red     => "\e[31;1m",  # with a method .light_red
+    # }
+  }
+  SHORTCUTS.default = {}
+
+  class << self
+    # Paint::SomeModule --> Paint::SHORTCUTS[:some_module]
+    def const_missing(mod_name)
+      # get shortcuts
+      shortcuts = SHORTCUTS[mod_name.to_s.gsub(/[A-Z]/,'_\0').downcase[1..-1].to_sym] || []
+
+      # create module
+      class_eval "module #{mod_name}; end"
+      mod = const_get(mod_name)
+      eigen_mod = class << mod; self; end # 1.8
+
+      # define direct behaviour, class methods
+      # mod.define_singleton_method :method_missing do |color_name, *args|
+      eigen_mod.send:define_method, :method_missing do |color_name, *args|
+        if color_code = shortcuts[color_name]
+          if args.empty? then color_code else color_code + Array(args).join + NOTHING end
+        else
+          nil
+        end
+      end
+
+      eigen_mod.send:define_method, :respond_to? do |color_name, *args|
+        shortcuts.include?(color_name) || super(color_name, *args)
+      end
+
+      # define include behaviour, instance methods
+      eigen_mod.send:define_method, :included do |_|
+        shortcuts.each{ |color_name, color_code|
+          define_method color_name do |*args|
+            if args.empty? then color_code else color_code + Array(args).join + NOTHING end
+          end
+        }
+        private *shortcuts.keys unless shortcuts.empty?
+      end
+
+      # include variations, defined in child modules
+      mod.class_eval "module String; end"
+      string = mod.const_get(:String)
+      eigen_string = class << string; self; end # 1.8
+      eigen_string.send:define_method, :included do |_|
+        shortcuts.each{ |color_name, color_code|
+          define_method color_name do
+            color_code + to_s + NOTHING
+          end
+        }
+      end
+
+      # OK, let's take it one level further ;)
+      mod.class_eval "module Prefix; end"
+      prefix_prefix = mod.const_get(:Prefix)
+      eigen_prefix_prefix = class << prefix_prefix; self; end # 1.8
+      eigen_prefix_prefix.send:define_method, :const_missing do |prefix_name|
+        class_eval "module #{prefix_name}; end"
+        prefix = const_get(prefix_name)
+        eigen_prefix = class << prefix; self; end # 1.8
+
+        eigen_prefix.send:define_method, :included do |_|
+          define_method prefix_name.to_s.gsub(/[A-Z]/,'_\0').downcase[1..-1].to_sym do |color_name|
+            shortcuts[color_name] && shortcuts[color_name] + to_s + NOTHING
+          end
+        end
+
+        prefix
+      end
+
+      # :)
+      mod
+    end
+  end
+end
+
+# J-_-L

data/lib/paint/util.rb

@@ -0,0 +1,35 @@
+module Paint
+  # These helpers add functionality you sometimes need when working with terminal colors
+  class << self
+    # Removes any color and effect strings
+    def unpaint(string)
+      string.gsub(/\e\[(?:[0-9];?)+m/, '')
+    end
+
+    # Tries to print all 256 colors
+    def rainbow
+      (0..256).each{ |color| 
+        print Paint[' ',48,5,color] # print empty bg color field
+      }
+      puts
+    end
+
+    # Updates color names
+    def update_rgb_colors(path = '/etc/X11/rgb.txt')
+      if File.file?(path)
+        Paint::RGB_COLORS.clear
+
+        File.open(path, 'r') do |file|
+          file.each_line{ |line|
+            line.chomp =~ /(\d+)\s+(\d+)\s+(\d+)\s+(.*)$/
+            Paint::RGB_COLORS[$4] = Paint.send:rgb_value, $1, $2, $3 if $4
+          }
+        end
+      else
+        raise ArgumentError, "Not a valid file: #{path}"
+      end
+    end
+  end
+end
+
+# J-_-L

data/lib/paint/version.rb

@@ -0,0 +1,3 @@
+module Paint
+  VERSION = '0.8.0'
+end

data/paint.gemspec

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+require 'rubygems' unless defined? Gem
+require File.dirname(__FILE__) + "/lib/paint/version"
+ 
+Gem::Specification.new do |s|
+  s.name        = "paint"
+  s.version     = Paint::VERSION
+  s.authors     = ["Jan Lelis"]
+  s.email       = "mail@janlelis.de"
+  s.homepage    = "https://github.com/janlelis/paint"
+  s.summary     = "Yet another terminal colors gem"
+  s.description =  "Yet another terminal colors gem / no string extensions / 256 color support / effect support / define custom shortcuts"
+  s.required_ruby_version     = '>= 1.8.7'
+  s.files = Dir.glob(%w[{lib,test,spec}/**/*.rb bin/* [A-Z]*.{txt,rdoc} ext/**/*.{rb,c}]) + %w{Rakefile paint.gemspec .gemtest}
+  s.extra_rdoc_files = ["README.rdoc", "LICENSE.txt"]
+  s.license = 'MIT'
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'rspec-core'
+  s.add_development_dependency 'rake'
+ 
+  len = s.homepage.size
+  s.post_install_message = \
+   ("       ┌── " + "info ".ljust(len-2,'%')            + "─┐\n" +
+    " J-_-L │ "   + s.homepage                          + " │\n" +
+    "       ├── " + "usage ".ljust(len-2,'%')           + "─┤\n" +
+    "       │ "   + "require 'paint'".ljust(len,' ')    + " │\n" +
+    "       │ "   + "puts Paint['J-_-L', :red] # \e[31mJ-_-L\e[0m".ljust(len,' ')         + " │\n" +
+    "       └─"   + '─'*len                             + "─┘").gsub('%', '─') # 1.8 workaround
+end

data/spec/paint_methods_spec.rb

@@ -0,0 +1,77 @@
+describe 'Paint.color' do
+  it 'only returns a the color escape sequnce and is directly used by Paint.[] with all paramenters except the first; see there fore specs' do end
+end
+
+describe 'Paint.simple' do
+  it 'returns ansi code number for one of the eight ansi base colors' do
+    Paint.simple(:red).should == 31
+  end
+
+  it 'returns background ansi code number for one of the eight ansi base colors if second parameter is true' do
+    Paint.simple(:red, true).should == 41
+  end
+end
+
+describe 'Paint.rgb' do
+  it 'returns ansi code sequence for one of 256 colors' do
+    Paint.rgb(1,2,3).should == '38;5;16'
+  end
+
+  it 'returns background ansi code sequence for one of 256 colors if last parameter is true' do
+    Paint.rgb(1, 2, 3, true).should == '48;5;16'
+  end
+end
+
+describe 'Paint.hex' do
+  it 'returns ansi code sequence for one of 256 colors' do
+    Paint.hex("#fff").should == "38;5;231"
+  end
+
+  it 'returns background ansi code sequence for one of 256 colors if second parameter is true' do
+    Paint.hex("123456", true).should == "48;5;24"
+  end
+end
+
+describe 'Paint.name' do
+  it 'returns ansi code sequence for one of 256 colors' do
+    Paint.name("gold").should == "38;5;226"
+  end
+
+  it 'returns background ansi code sequence for one of 256 colors if second parameter is true' do
+    Paint.name("gold", true).should == "48;5;226"
+  end
+end
+
+describe 'Paint.random' do
+  it 'returns ansi code for one of the eight ansi base colors' do
+    (30...38) === Paint.random.should
+  end
+end
+
+describe 'Paint.effect' do
+  it 'returns ansi code for effect using EFFECTS hash' do
+    Paint.effect(:bright).should == 1
+  end
+end
+
+describe 'Paint.wrap' do
+  it 'wraps an ansi color code (array of integers) into an ansi escape sequence' do
+    Paint.wrap(31, 1).should == "\e[31;1m"
+  end
+end
+
+# util.rb
+
+describe 'Paint.unpaint' do
+  it 'removes any ansi color escape sequences in the string' do
+    Paint.unpaint( Paint['J-_-L', :red, :bright] ).should == 'J-_-L'
+  end
+end
+
+describe 'Paint.rainbow' do
+  it 'prints all available 256 colors' do end
+end
+
+describe 'Paint.update_rgb_colors' do
+  it 'updates the Paint::RGB_COLORS hash using rgb.txt (takes path to it as argument' do end
+end

data/spec/paint_shortcuts_spec.rb

@@ -0,0 +1,55 @@
+# TODO fix include specs, probably failing because of some rspec voodoo
+
+describe 'Paint::SHORTCUTS' do
+  before do
+    Paint::SHORTCUTS[:example] = {
+      :white => Paint.color(:black),
+      :red => Paint.color(:red, :bright),
+      :title => Paint.color(:underline),
+    }
+  end
+
+  context 'Paint::Example.method_missing' do
+    it 'returns a color defined in the SHORTCUTS hash under the :example key' do
+      Paint::Example.red == "\e[31m"
+    end
+
+    it 'returns a color defined in the SHORTCUTS hash under the :some_module key; method takes string to colorize' do
+      Paint::Example.red 'J-_-L' == "\e[31;1mJ-_-L\e[0m"
+    end
+  end
+
+  context 'include Paint::Example' do
+    include Paint::Example
+    #red.should == "\e[31;1m"
+    #white( 'Ruby' ).should "\e[30m"
+  end
+
+
+  context 'include Paint::Example::String' do
+    it 'adds shortcuts methods that colorize self' do
+      class MyString < String # could also have used original String
+        include Paint::Example::String
+      end
+
+      # MyString.new("J-_-L").red.should == "\e[31;1mJ-_-L\e[0m"
+    end
+
+    it 'adds shortcuts methods that colorize self (also works for non-String classes by calling to_s)' do
+      Paint::SHORTCUTS[:example][:gold] = Paint.color "gold"
+      class Integer
+        include Paint::Example::String
+      end
+      #123.red.should == "\e[38;5;226m123\e[0m"
+    end
+  end
+
+  context 'include Paint::Example::Prefix::ExampleName' do
+    it 'sets a single color helper method to avoid cluttering namespaces' do
+      class Object
+        include Paint::Example::Prefix::ExampleName
+      end
+      #"Ruby".example_name(:red).should == "\e[31;1mRuby\e[0m"
+    end
+  end
+end

data/spec/paint_spec.rb

@@ -0,0 +1,79 @@
+describe 'Paint.[]' do
+  context '(with no options)' do
+    it 'colorizes using a random ansi foreground color' do
+      Paint['J-_-L'].should =~ /\e\[3\dmJ-_-L\e\[0m/
+    end
+  end
+
+  context '(with one color)' do
+    it 'understands a simple symbol color and use it as foreground color' do
+      Paint['J-_-L', :yellow].should == "\e[33mJ-_-L\e[0m"
+    end
+
+    it 'understands an array as rgb color definition and use it as foreground color' do
+      Paint['J-_-L', [255, 200, 0]].should == "\e[38;5;220mJ-_-L\e[0m"
+    end
+
+    it 'understands a hex string (with #, 6 digits) as rgb color definition and use it as foreground color' do
+      Paint['J-_-L', "#123456"].should == "\e[38;5;24mJ-_-L\e[0m"
+    end
+
+    it 'understands a hex string (no #, 6 digits) as rgb color definition and use it as foreground color' do
+      Paint['J-_-L', "123456"].should == "\e[38;5;24mJ-_-L\e[0m"
+    end
+
+    it 'understands a hex string (with #, 3 digits) as rgb color definition and use it as foreground color' do
+      Paint['J-_-L', "#fff"].should == "\e[38;5;231mJ-_-L\e[0m"
+    end
+
+    it 'understands a hex string (no #, 3 digits) as rgb color definition and use it as foreground color' do
+      Paint['J-_-L', "fff"].should == "\e[38;5;231mJ-_-L\e[0m"
+    end
+
+    it 'understands a non-hex string as rgb color name (rgb.txt) and use it as foreground color' do
+      Paint['J-_-L', "medium purple"].should == "\e[38;5;141mJ-_-L\e[0m"
+    end
+  end
+  
+  context '(with two colors)' do
+    it 'interprets the first color as foreground color and the second one as background color' do
+      Paint['J-_-L', :yellow, :red].should == "\e[33;41mJ-_-L\e[0m"
+    end
+
+    it 'interprets the first color as foreground color and the second one as background color (rgb)' do
+      Paint['J-_-L', '#424242', [42, 142, 242]].should == "\e[38;5;59;48;5;39mJ-_-L\e[0m"
+    end
+
+    it 'sets only a background color, if first color is nil' do
+      Paint['J-_-L', nil, [42, 142, 242]].should == "\e[48;5;39mJ-_-L\e[0m"
+    end
+  end
+
+  context '(with effects)' do
+    it 'passes effects' do
+      Paint['J-_-L', :bright].should == "\e[1mJ-_-L\e[0m"
+    end
+
+    it 'passes effects, mixed with colors' do
+      Paint['J-_-L', :yellow, :bright].should == "\e[33;1mJ-_-L\e[0m"
+    end
+
+    it 'passes effects, mixed with colors, order does not matter' do
+      Paint['J-_-L', :bright, :yellow].should == "\e[1;33mJ-_-L\e[0m"
+    end
+
+    it 'passes multiple effects' do
+      Paint['J-_-L', :yellow, :red, :bright, :underline, :inverse].should == "\e[33;41;1;4;7mJ-_-L\e[0m"
+    end
+  end
+
+  context '(with plain integers)' do
+    it 'passes integers to final escape sequence' do
+      Paint['J-_-L', 31, 1, 42].should == "\e[31;1;42mJ-_-L\e[0m"
+    end
+
+    it 'passes integers to final escape sequence (mixed with normal arguments)' do
+      Paint['J-_-L', :red, :bright, 42, :underline].should == "\e[31;1;42;4mJ-_-L\e[0m"
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require File.dirname(__FILE__) + '/../lib/paint'

metadata

@@ -0,0 +1,102 @@
+--- !ruby/object:Gem::Specification 
+name: paint
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.8.0
+platform: ruby
+authors: 
+- Jan Lelis
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-06-29 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec-core
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id003
+description: Yet another terminal colors gem / no string extensions / 256 color support / effect support / define custom shortcuts
+email: mail@janlelis.de
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- LICENSE.txt
+files: 
+- lib/paint/rgb_colors.rb
+- lib/paint/util.rb
+- lib/paint/shortcuts.rb
+- lib/paint/pa.rb
+- lib/paint/version.rb
+- lib/paint.rb
+- spec/spec_helper.rb
+- spec/paint_methods_spec.rb
+- spec/paint_spec.rb
+- spec/paint_shortcuts_spec.rb
+- LICENSE.txt
+- README.rdoc
+- CHANGELOG.rdoc
+- Rakefile
+- paint.gemspec
+- .gemtest
+homepage: https://github.com/janlelis/paint
+licenses: 
+- MIT
+post_install_message: "       \xE2\x94\x8C\xE2\x94\x80\xE2\x94\x80 info \xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x90\n J-_-L \xE2\x94\x82 https://github.com/janlelis/paint \xE2\x94\x82\n       \xE2\x94\x9C\xE2\x94\x80\xE2\x94\x80 usage \xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\xA4\n       \xE2\x94\x82 require 'paint'                   \xE2\x94\x82\n       \xE2\x94\x82 puts Paint['J-_-L', :red] # \e[31mJ-_-L\e[0m \xE2\x94\x82\n       \xE2\x94\x94\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x80\xE2\x94\x98"
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: 1.8.7
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.1
+signing_key: 
+specification_version: 3
+summary: Yet another terminal colors gem
+test_files: []
+