color 1.4.1 → 1.4.2

data.tar.gz.sig

@@ -1,3 +1,3 @@
-��$#�/��
-S�\zG��ז��V�Uk|a5�9Xk�Tg@A����8��I�5��C��O��=�L��9�^�+�S�L ���H��!��1<w��~�;
-
�a���Ҧ�Ah�y	O�7K'[>ݖ<�l�q��/v�uZ��E���u�gy�j('ϵPa�x�d��V�C����;�NmY���>�21���Bp��)�t�f�n-��X�4��osM�VM��R�Խ�T�`x�ք�78Yu&�=R�v��%���
+xn)Zn����Q�P���VU�GO�(�%ȩ0(�i[�p�̽p�[�q��:
+�ۀ�)�����屮{�Yړ���}�:���d���E������'I����2��6�;��d$�H��8ٚ�7/�먇m���=�$&`D�7�8̼�<����}U'!~dZ������ٟ�wr��
��ѩc2嬼�]g�L��G���
+���G�I@�iLDcP��Pÿ���ӣB<Y�®�(���,�;��r_�3��.��

data/.hoerc

@@ -0,0 +1,2 @@
+---
+exclude: !ruby/regexp /(tmp|swp)$|CVS|TAGS|\.(svn|git|hg|DS_Store|idea)|Gemfile\.lock|research\/|\.gemspec$/

data/Contributing.rdoc

@@ -0,0 +1,57 @@
+== Contributing
+
+I value any contribution to Color you can provide: a bug report, a feature
+request, or code contributions.
+
+Code contributions to Color are especially <del>welcome</del>encouraged.
+Because Color is a complex codebase, there are a few guidelines:
+
+* Changes <strong>will not</strong> be accepted without tests.
+* Match my coding style.
+* Use a thoughtfully-named topic branch that contains your change. Rebase your
+  commits into logical chunks as necessary.
+* Use {quality commit messages}[http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html].
+* Do not change the version number; when your patch is accepted and a release
+  is made, the version will be updated at that point.
+* Submit a GitHub pull request with your changes.
+* New features require new documentation.
+
+=== Test Dependencies
+
+To run the test suite, you will need to install the development dependencies
+for Color. If you have Bundler, you can accomplish this easily:
+
+    $ bundle install
+
+Color uses Ryan Davis’s excellent {Hoe}[https://github.com/seattlerb/hoe]
+to manage the release process, and it adds a number of rake tasks. You will
+mostly be interested in:
+
+    $ rake
+
+which runs the tests the same way that:
+
+    $ rake spec
+    $ rake test
+    $ rake travis
+
+will do.
+
+=== Workflow
+
+Here's the most direct way to get your work merged into the project:
+
+* Fork the project.
+* Clone down your fork (+git clone git://github.com/<username>/color.git+).
+* Create a topic branch to contain your change (+git checkout -b my\_awesome\_feature+).
+* Hack away, add tests. Not necessarily in that order.
+* Make sure everything still passes by running `rake`.
+* If necessary, rebase your commits into logical chunks, without errors.
+* Push the branch up (+git push origin my\_awesome\_feature+).
+* Create a pull request against halostatue/color and describe what your
+  change does and the why you think it should be merged.
+
+=== Contributors
+
+* Austin Ziegler created color-tools.
+* Matt Lyons created color.

data/{History.txt → History.rdoc}

@@ -1,8 +1,19 @@
-== Color 1.4.1 / 2010.02.03
+== 1.4.2 / 2013-06-30
+
+Maintenance:
+* Modernized Hoe installation of Color, removing some dependencies.
+* Switched to Minitest.
+* Turned on Travis CI.
+* Started using Code Climate.
+* Small code formatting cleanup that touched pretty much every file.
+
+== 1.4.1 / 2010-02-03
+
 * Imported to github.
 * Converted to Hoe 2.5 spec format.
 
-== Color 1.4.0 / 2007.02.11
+== 1.4.0 / 2007-02-11
+
 * Merged Austin Ziegler's color-tools library (previously part of the Ruby
   PDF Tools project) with Matt Lyon's color library.
   - The HSL implementation from the Color class has been merged into
@@ -39,13 +50,15 @@
 * Added an Adobe Color swatch (Photoshop) palette reader,
   Color::Palette::AdobeColor (for .aco files only).
 
-== Color 0.1.0 / 2006.08.05
+== Color 0.1.0 / 2006-08-05
+
 * Added HSL (degree, percent, percent) interface.
 * Removed RGB instance variable; color is managed internally as HSL floating
   point.
 * Tests!
 
 == color-tools 1.3.0
+
 * Added new metallic colours suggested by Jim Freeze <jfn@freeze.org>. These
   are in the namespace Color::Metallic.
 * Colours that were defined in the Color namespace (e.g., Color::Red,
@@ -76,18 +89,10 @@
   conversions from YIQ to other colour spaces.
 
 == color-tools 1.1.0
+
 * Added color/palette/gimp to support the reading and use of GIMP color
   palettes.
 
 == color-tools 1.0.0
-* Initial release.
-
-== Copyright
-  Color
-  Colour Management with Ruby
-  http://rubyforge.org/projects/color
 
-  Licensed under a MIT-style licence. See Licence.txt in the main
-  distribution for full licensing information.
-
-  Copyright (c) 2005 - 2010 Austin Ziegler and Matt Lyon
+* Initial release.

data/{Licence.txt → Licence.rdoc}

@@ -1,8 +1,8 @@
-Color
-Colour management in Ruby
-http://rubyforge.org/projects/color/
+== Licence
 
-Copyright (c) 2005 - 2010 Austin Ziegler, Matt Lyon, and other contributors
+This software is available under an MIT-style licence.
+
+* Copyright 2005–2013 Austin Ziegler, Matt Lyon, and other contributors
 
 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

data/Manifest.txt

@@ -1,8 +1,8 @@
-History.txt
-Install.txt
-Licence.txt
+.hoerc
+History.rdoc
+Licence.rdoc
 Manifest.txt
-README.txt
+README.rdoc
 Rakefile
 lib/color.rb
 lib/color/cmyk.rb
@@ -17,9 +17,7 @@ lib/color/rgb-colors.rb
 lib/color/rgb.rb
 lib/color/rgb/metallic.rb
 lib/color/yiq.rb
-setup.rb
 test/test_adobecolor.rb
-test/test_all.rb
 test/test_cmyk.rb
 test/test_color.rb
 test/test_css.rb

data/README.rdoc

@@ -0,0 +1,45 @@
+= Color
+
+home :: http://color.rubyforge.org
+code :: https://github.com/halostatue/color
+bugs :: https://github.com/halostatue/color/issues
+rdoc :: http://rubydoc.info/github/halostatue/color
+code climate :: {<img src="https://codeclimate.com/github/halostatue/color.png" />}[https://codeclimate.com/github/halostatue/color]
+continuous integration :: {<img src="https://travis-ci.org/halostatue/color.png" />}[https://travis-ci.org/halostatue/color]
+
+== Description
+
+Color is a Ruby library to provide basic RGB, CMYK, HSL, and other colourspace
+manipulation support to applications that require it. It also provides 152
+named RGB colours (184 with spelling variations) that are commonly supported in
+HTML, SVG, and X11 applications. A technique for generating monochromatic
+contrasting palettes is also included.
+
+The capabilities of the Color library are limited to pure mathematical
+manipulation of the colours based on colour theory without reference to colour
+profiles (such as sRGB or Adobe RGB). For most purposes, when working with the
+RGB and HSL colours, this won't matter. However, some colour models (like CIE
+L*a*b*) are not supported because Color does not yet support colour profiles,
+giving no meaningful way to convert colours in absolute colour spaces (like
+L*a*b*, XYZ) to non-absolute colour spaces (like RGB).
+
+Color version 1.4.2 updates the release and install as a RubyGem to remove an
+unnecessary dependency, adds code climate analysis, and Travis CI support.
+
+== History
+
+Color is the result of a project merge between color.rb 0.1.0 by
+Matt Lyon and color-tools 1.3 by Austin Ziegler. Please see History.txt for
+details on the changes this merge brings.
+
+Color::Palette::MonoContrast was developed based on techniques described by
+Andy “Malarkey” Clarke[1], implemented in JavaScript by Steve G. Chipman at
+SlayerOffice[2] and by Patrick Fitzgerald of BarelyFitz[3] in PHP.
+
+[1] http://www.stuffandnonsense.co.uk/archives/creating_colour_palettes.html
+[2] http://slayeroffice.com/tools/color_palette/
+[3] http://www.barelyfitz.com/projects/csscolor/
+
+:include: Contributing.rdoc
+
+:include: Licence.rdoc

data/Rakefile

@@ -1,116 +1,34 @@
-#! /usr/bin/env rake
-#--
-# Color
-# Colour Management with Ruby
-# http://rubyforge.org/projects/color
-#
-# Licensed under a MIT-style licence. See Licence.txt in the main
-# distribution for full licensing information.
-#
-# Copyright (c) 2005 - 2010 Austin Ziegler and Matt Lyon
-#++
+# -*- ruby encoding: utf-8 -*-
 
 require 'rubygems'
 require 'hoe'
 
-$LOAD_PATH.unshift('lib')
-
-require 'color'
-
-PKG_NAME    = 'color'
-PKG_VERSION = Color::COLOR_VERSION
-PKG_DIST    = "#{PKG_NAME}-#{PKG_VERSION}"
-PKG_TAR     = "pkg/#{PKG_DIST}.tar.gz"
-MANIFEST    = File.read("Manifest.txt").split
-
-Hoe.spec PKG_NAME do
-  self.version = PKG_VERSION
-
-# self.rubyforge_name = PKG_NAME
-
-  developer "Austin Ziegler", "austin@rubyforge.org" 
-  developer "Matt Lyon", "matt@postsomnia.com" 
-
-  self.url = %W(http://color.rubyforge.org/ http://github.com/halostatue/color)
-
-  self.summary = "Colour management with Ruby"
-  self.changes = paragraphs_of("History.txt", 0..1).join("\n\n")
-  self.description = paragraphs_of("README.txt", 1..1).join("\n\n")
-
-  extra_dev_deps << [ "archive-tar-minitar", "~>0.5.1" ]
-  clean_globs << "coverage"
-
-  # This is a lie because I will continue to use Archive::Tar::Minitar.
-  self.need_tar        = false
-end
-
-desc "Build a Color .tar.gz distribution."
-task :tar => [ PKG_TAR ]
-file PKG_TAR => [ :test ] do |t|
-  require 'archive/tar/minitar'
-  require 'zlib'
-  files = MANIFEST.map { |f|
-    fn = File.join(PKG_DIST, f)
-    tm = File.stat(f).mtime
-
-    if File.directory?(f)
-      { :name => fn, :mode => 0755, :dir => true, :mtime => tm }
-    else
-      mode = if f =~ %r{^bin}
-               0755
-             else
-               0644
-             end
-      data = File.read(f)
-      { :name => fn, :mode => mode, :data => data, :size => data.size,
-        :mtime => tm }
-    end
-  }
-
-  begin
-    unless File.directory?(File.dirname(t.name))
-      require 'fileutils'
-      File.mkdir_p File.dirname(t.name)
-    end
-    tf = File.open(t.name, 'wb')
-    gz = Zlib::GzipWriter.new(tf)
-    tw = Archive::Tar::Minitar::Writer.new(gz)
-
-    files.each do |entry|
-      if entry[:dir]
-        tw.mkdir(entry[:name], entry)
-      else
-        tw.add_file_simple(entry[:name], entry) { |os|
-          os.write(entry[:data])
-        }
-      end
-    end
-  ensure
-    tw.close if tw
-    gz.close if gz
-  end
-end
-task :package => [ PKG_TAR ]
-
-desc "Build the manifest file from the current set of files."
-task :build_manifest do |t|
-  require 'find'
-
-  paths = []
-  Find.find(".") do |path|
-    next if File.directory?(path)
-    next if path =~ /\.svn/
-    next if path =~ /\.git/
-    next if path =~ /\.hoerc/
-    next if path =~ /\.swp$/
-    next if path =~ %r{coverage/}
-    next if path =~ /~$/
-    paths << path.sub(%r{^\./}, '')
-  end
-
-  File.open("Manifest.txt", "w") do |f|
-    f.puts paths.sort.join("\n")
-  end
-
-  puts paths.sort.join("\n")
+Hoe.plugin :bundler
+Hoe.plugin :doofus
+Hoe.plugin :email
+Hoe.plugin :gemspec2
+Hoe.plugin :git
+Hoe.plugin :minitest
+Hoe.plugin :rubyforge
+Hoe.plugin :travis
+
+Hoe.spec 'color' do
+  developer "Austin Ziegler", "austin@rubyforge.org"
+  developer "Matt Lyon", "matt@postsomnia.com"
+
+  self.remote_rdoc_dir = '.'
+  self.rsync_args << ' --exclude=statsvn/'
+
+  self.history_file = 'History.rdoc'
+  self.readme_file = 'README.rdoc'
+  self.extra_rdoc_files = FileList["*.rdoc"].to_a
+
+  self.extra_dev_deps << ['hoe-bundler', '~> 1.2']
+  self.extra_dev_deps << ['hoe-doofus', '~> 1.0']
+  self.extra_dev_deps << ['hoe-gemspec2', '~> 1.1']
+  self.extra_dev_deps << ['hoe-git', '~> 1.5']
+  self.extra_dev_deps << ['hoe-rubygems', '~> 1.0']
+  self.extra_dev_deps << ['hoe-travis', '~> 1.2']
+  self.extra_dev_deps << ['minitest', '~> 5.0']
+  self.extra_dev_deps << ['rake', '~> 10.0']
 end

data/lib/color.rb

@@ -1,21 +1,9 @@
 # :title: Color -- Colour Management with Ruby
-# :main: README.txt
-
-#--
-# Color
-# Colour management with Ruby
-# http://rubyforge.org/projects/color
-#   Version 1.4.1
-#
-# Licensed under a MIT-style licence. See Licence.txt in the main
-# distribution for full licensing information.
-#
-# Copyright (c) 2005 - 2010 Austin Ziegler and Matt Lyon
-#++
+# :main: README.rdoc
 
 # = Colour Management with Ruby
 module Color
-  COLOR_VERSION = '1.4.1'
+  COLOR_VERSION = '1.4.2'
 
   class RGB; end
   class CMYK; end
@@ -82,7 +70,7 @@ module Color
       normalize_to_range(value, 0..255).to_i
     end
     alias normalize_8bit normalize_byte
-    
+
     # Normalize the value to the range (0) .. (65535).
     def normalize_word(value)
       normalize_to_range(value, 0..65535).to_i
@@ -115,7 +103,7 @@ module Color
   end
 
   # Provides a thin veneer over the Color module to make it seem like this
-  # is Color 0.1.0 (a class) and not Color 1.4.1 (a module). This
+  # is Color 0.1.0 (a class) and not Color 1.4 (a module). This
   # "constructor" will be removed in the future.
   #
   # mode = :hsl::   +values+ must be an array of [ hue deg, sat %, lum % ].

data/lib/color/cmyk.rb

@@ -1,15 +1,3 @@
-#--
-# Color
-# Colour management with Ruby
-# http://rubyforge.org/projects/color
-#   Version 1.4.1
-#
-# Licensed under a MIT-style licence. See Licence.txt in the main
-# distribution for full licensing information.
-#
-# Copyright (c) 2005 - 2010 Austin Ziegler and Matt Lyon
-#++
-
 # An CMYK colour object. CMYK (cyan, magenta, yellow, and black) colours are
 # based on additive percentages of ink. A CMYK colour of (0.3, 0, 0.8, 0.3)
 # would be mixed from 30% cyan, 0% magenta, 80% yellow, and 30% black.

data/lib/color/css.rb

@@ -1,15 +1,3 @@
-#--
-# Color
-# Colour management with Ruby
-# http://rubyforge.org/projects/color
-#   Version 1.4.1
-#
-# Licensed under a MIT-style licence. See Licence.txt in the main
-# distribution for full licensing information.
-#
-# Copyright (c) 2005 - 2010 Austin Ziegler and Matt Lyon
-#++
-
 require 'color'
 
 # This namespace contains some CSS colour names.

data/lib/color/grayscale.rb

@@ -1,15 +1,3 @@
-#--
-# Color
-# Colour management with Ruby
-# http://rubyforge.org/projects/color
-#   Version 1.4.1
-#
-# Licensed under a MIT-style licence. See Licence.txt in the main
-# distribution for full licensing information.
-#
-# Copyright (c) 2005 - 2010 Austin Ziegler and Matt Lyon
-#++
-
 # A colour object representing shades of grey. Used primarily in PDF
 # document creation.
 class Color::GrayScale
@@ -195,7 +183,7 @@ class Color::GrayScale
   # The subtraction is done using the grayscale accessor methods to ensure a
   # valid colour in the result.
   def -(other)
-    other = other.to_grayscale 
+    other = other.to_grayscale
     ng = self.dup
     ng.g -= other.g
     ng
@@ -206,7 +194,5 @@ class Color::GrayScale
   end
 end
 
-module Color
-  # A synonym for Color::GrayScale.
-  GreyScale = GrayScale
-end
+# A synonym for Color::GrayScale.
+Color::GreyScale = Color::GrayScale