color 2.1.2 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 192b04db62242c8531c1ed8f20f9d024b5e0c57c0a97a6452d481ea5f6ca3e77
-  data.tar.gz: c588cfff08831c11fe0e977bcc536140ee5c9c765f24be4360fad3f9e71c56cd
+  metadata.gz: b32b311487259ef9b4a72e7264f1eaa8a34a617918829f41b629fe814b72776f
+  data.tar.gz: 9fe85bc3e862e29c0fded320e03ec77063a30e86faa205c71dbae2cc6b840f28
 SHA512:
-  metadata.gz: 0c38775facf0b320eee6b7ae6774cab01297bb63b4483fc35270f8a4e05c12ea3307bd60e0200c1dce203eb9010cfe5ab8b755a69ec5f9259fdb336a4acd34f7
-  data.tar.gz: 1d01a276bcf0048b0ca9e2bfba6f0559fb4dbaf30c712f4cc91d9022a4da333627ffbe051cd31b3e47b4468d5018f27914984d5a77504a9901651bf0f129861f
+  metadata.gz: 712f80bb0eb3f8f04d6144d3ca0d608546b7bdf371b03d549aae1be985f73a8f84b7e615792206f32db8caf587e68cfb66f59c75c0ee1911d3af4d34efe0ed3f
+  data.tar.gz: ec2928f2caf9b5d9614168b0109d33743a542192e0ef2a30dc0d08b2dda5b5825bd539f9b5b477c1b96ffc3a37e8ebbacd57c5b71e18bd8cb9e77c023caec323

data/CHANGELOG.md

@@ -1,12 +1,39 @@
 # color Changelog
 
+## 2.2.0 / 2026-01-DD
+
+- When `color/rgb/colors` is loaded and the RGB color does not have defined
+  names, a fallback lookup to named RGB colors will be performed to use that
+  name.
+
+  ```ruby
+  simple_black = Color.from_values(r: 0, g: 0, b: 0)
+  stuart_black = Color.from_values(r: 0, g: 0, b: 0, names: ["semple-black-4.0"])
+
+  simple_black.name # => nil
+  stuart_black.name # => "semple-black-4.0"
+
+  require 'color/rgb/colors'
+
+  simple_black.name # => "black"
+  stuart_black.name # => "semple-black-4.0"
+  ```
+
+  This was suggested by [@akicho8][gh-user-akicho8] in [#89][gh-issue-89].
+
+- The RGB inspect and pretty print formats have been modified to include defined
+  names. This was suggested by @akicho8 in #89.
+
+- Added unit tests for `#pretty_print` implementations. Fixed some bugs found in
+  the implementations.
+
 ## 2.1.2 / 2025-12-30
 
 - Updated to Contributor Covenant 3.0 and applied updates to several support
   documents.
 
 - Full coverage of conversion tests. Adds CIELAB `to_yiq` and Grayscale `to_xyz`
-  methods. Only YIQ now lacks conversions support. Fixed in [#69][pr-69].
+  methods. Only YIQ now lacks conversions support. Fixed in [#69][pull-69].
 
 - Fix an incorrect conversion of CIELAB colors with low lightness to XYZ, which
   caused the Y component to be ~903 times larger than correct. In practice, this
@@ -15,7 +42,7 @@
   This also affected conversion from CIELAB to RGB, CMYK, HSL, YIQ, and
   grayscale, which convert from CIELAB to XYZ as an intermediate step.
 
-  Reported by @alexwlchan in [#95][issue-95] and fixed in [#96][pr-96].
+  Reported by [@alexwlchan][gh-user-alexwlchan] in [#95][issue-95] and fixed in [#96][pull-96].
 
 - Fix an incorrect comparison when converting CIE XYZ colors to RGB that could
   raise a `NoMethodError` when constructing the RGB value. The conversion
@@ -27,7 +54,7 @@
   to RGB, HSL, YIQ, and Grayscale -- all of which convert from XYZ to RGB as an
   intermediate step.
 
-  Reported by @alexwlchan in [#92][issue-92] and fixed in [#93][pr-93].
+  Reported by @alexwlchan in [#92][issue-92] and fixed in [#93][pull-93].
 
 ## 2.1.1 / 2025-08-08
 
@@ -44,7 +71,7 @@ and adds more Color::XYZ white points for standard illuminants.
   was seen in `Color::RGB#to_lab` since CIELAB conversions must go through the
   XYZ color model. Even though we were using the D65 white point, the Z value
   was being clamped to 1.0 instead of the correct value of ≅1.08. Reported by
-  @r-plus in [#45][issue-45] and fixed in [#45][pr-46].
+  @r-plus in [#45][issue-45] and fixed in [#45][pull-46].
 
   The resulting Color::LAB values are not _exactly_ the same values under Color
   1.8, but they are within fractional differences deemed acceptable.
@@ -128,8 +155,8 @@ this release without prior warning.
 ### 🚀 New Features
 
 - `Color::CIELAB` and `Color::XYZ` namespaces have been added. Separate
-  implementations were submitted by David Heitzman and @stiff (in [#8][pr-8] and
-  [#11][pr-11]), but I have reworked the code substantially. These
+  implementations were submitted by David Heitzman and @stiff (in [#8][pull-8]
+  and [#11][pull-11]), but I have reworked the code substantially. These
   implementations were originally as `Color::LAB` and include a new contrast
   calculation using the ΔE\*00 algorithm.
 
@@ -140,7 +167,7 @@ this release without prior warning.
   automated releases are enabled), full GitHub Actions, Dependabot, Standard
   Ruby, and more.
 
-- Charles Nutter re-added JRuby support in CI. [#36][pr-36]
+- Charles Nutter re-added JRuby support in CI. [#36][pull-36]
 
 ### Governance
 
@@ -169,23 +196,22 @@ ownership to contribute it to this project under the licence terms.
   by Eric Meyer. For purposes of backwards compatibility, the previous name is
   still permitted, but its use is strongly discouraged, and it will be removed
   in the Color 2.0 release.
-  <http://meyerweb.com/eric/thoughts/2014/06/19/rebeccapurple/>
+  <https://meyerweb.com/eric/thoughts/2014/06/19/rebeccapurple/>
 
 ## 1.7 / 2014-06-12
 
-- Added `Color::RGB::BeccaPurple` (#663399) in honour of Rebecca Meyer, the
-  daughter of Eric Meyer, who passed away on the 7 June 2014. Her favourite
-  color was purple. `#663399becca`
-  <https://twitter.com/meyerweb/status/476089708674428929>
-  <http://www.zeldman.com/2014/06/10/the-color-purple/>
-  <http://discourse.specifiction.org/t/name-663399-becca-purple-in-css4-color/225>
+- Added `Color::RGB::BeccaPurple` ([#663399][gh-issue-663399]) in honour of Rebecca Meyer, the
+  daughter of Eric Meyer, who passed away on 7 June 2014. Her favourite color
+  was purple. `#663399becca`
+  <https://www.zeldman.com/2014/06/10/the-color-purple/>
+  <https://discourse.wicg.io/t/name-663399-becca-purple-in-css4-color/225/>
 
 - Changed the homepage in the gem to point to GitHub instead of RubyForge, which
-  has been shut down. Fixes [#10][issue-10], reported by @voxik.
+  has been shut down. Fixes [#10][issue-10], reported by [@voxik][gh-user-voxik].
 
 ## 1.6 / 2014-05-19
 
-- Aaron Hill (@armahillo) implemented the CIE Delta E 94 method by which an RGB
+- Aaron Hill ([@armahillo][gh-user-armahillo]) implemented the CIE Delta E 94 method by which an RGB
   color can be asked for the closest matching color from a list of provided
   colors. Fixes [#5][issue-5].
 
@@ -220,7 +246,7 @@ ownership to contribute it to this project under the licence terms.
   this work, color classes should `include` Color only need to implement
   `#coerce(other)`, `#to_a`, and supported conversion methods (e.g., `#to_rgb`).
 
-- Added @daveheitzman's initial implementation of a RGB contrast method as an
+- Added [@daveheitzman][gh-user-daveheitzman]'s initial implementation of a RGB contrast method as an
   extension file: `require 'color/rgb/contrast'`. This method and the value it
   returns should be considered experimental; it requires further examination to
   ensure that the results produced are consistent with the contrast comparisons
@@ -367,13 +393,25 @@ ownership to contribute it to this project under the licence terms.
 [issue-10]: https://github.com/halostatue/color/issues/10
 [issue-30]: https://github.com/halostatue/color/issues/30
 [issue-45]: https://github.com/halostatue/color/issues/45
+[issue-4]: https://github.com/halostatue/color/issues/4
+[issue-5]: https://github.com/halostatue/color/issues/5
 [issue-92]: https://github.com/halostatue/color/issues/92
 [issue-95]: https://github.com/halostatue/color/issues/95
-[pr-8]: https://github.com/halostatue/color/pulls/8
-[pr-11]: https://github.com/halostatue/color/pull/11
-[pr-36]: https://github.com/halostatue/color/pull/36
-[pr-46]: https://github.com/halostatue/color/pull/46
-[pr-69]: https://github.com/halostatue/color/pull/69
-[pr-93]: https://github.com/halostatue/color/pull/93
-[pr-96]: https://github.com/halostatue/color/pull/96
+[pull-11]: https://github.com/halostatue/color/pull/11
+[pull-15]: https://github.com/halostatue/color/pull/15
+[pull-18]: https://github.com/halostatue/color/pull/18
+[pull-24]: https://github.com/halostatue/color/pull/24
+[pull-36]: https://github.com/halostatue/color/pull/36
+[pull-46]: https://github.com/halostatue/color/pull/46
+[pull-69]: https://github.com/halostatue/color/pull/69
+[pull-8]: https://github.com/halostatue/color/pulls/8
+[pull-93]: https://github.com/halostatue/color/pull/93
+[pull-96]: https://github.com/halostatue/color/pull/96
 [wp-std-illuminant]: https://en.wikipedia.org/wiki/Standard_illuminant#White_points_of_standard_illuminants
+[gh-user-akicho8]: https://github.com/akicho8
+[gh-issue-89]: https://github.com/halostatue/color/issues/89
+[gh-user-alexwlchan]: https://github.com/alexwlchan
+[gh-issue-663399]: https://github.com/halostatue/color/issues/663399
+[gh-user-voxik]: https://github.com/voxik
+[gh-user-armahillo]: https://github.com/armahillo
+[gh-user-daveheitzman]: https://github.com/daveheitzman

data/CONTRIBUTING.md

@@ -25,7 +25,8 @@ I have several guidelines to contributing code through pull requests:
 - Use [Conventional Commits][conventional] with my
   [conventions](#commit-conventions).
 
-- Versions must not be updated in pull requests. This means that you must not:
+- Versions must not be updated in pull requests unless otherwise directed. This
+  means that you must not:
 
   - Modify `VERSION` in `lib/color/version.rb`. When your patch is accepted and
     a release is made, the version will be updated at that point.
@@ -117,6 +118,6 @@ required metadata trailers are:
 [issues]: https://github.com/halostatue/color/issues
 [minitest]: https://github.com/seattlerb/minitest
 [standardrb]: https://github.com/standardrb/standard
-[tpope-qcm]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
+[tpope-qcm]: https://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
 [trailers1]: https://git-scm.com/docs/git-interpret-trailers
 [trailers2]: https://git-scm.com/docs/git-commit#Documentation/git-commit.txt---trailerlttokengtltvaluegt

data/CONTRIBUTORS.md

@@ -6,9 +6,12 @@
 - Thomas Sawyer
 - Aaron Hill (CIE94 color matching)
 - Luke Bennellick
-- @stiff (CIELAB color support)
-- @r-plus
+- [@stiff][gh-user-stiff] (CIELAB color support)
+- [@r-plus][gh-user-r-plus]
 - Matthew Draper
 - Charles Nutter
 - Paul Gallagher
 - Alex Chan
+
+[gh-user-stiff]: https://github.com/stiff
+[gh-user-r-plus]: https://github.com/r-plus

data/README.md

@@ -1,12 +1,12 @@
 # Color -- Color Math in Ruby
 
+[![RubyGems Version][shield-gems]][rubygems] ![Coveralls][shield-coveralls]
+[![Build Status][shield-ci]][ci-workflow]
+
 - code :: <https://github.com/halostatue/color>
 - issues :: <https://github.com/halostatue/color/issues>
+- docs :: <https://halostatue.github.io/color/>
 - changelog :: <https://github.com/halostatue/color/blob/main/CHANGELOG.md>
-- continuous integration ::
-  [![Build Status](https://github.com/halostatue/color/actions/workflows/ci.yml/badge.svg)][ci-workflow]
-- test coverage ::
-  [![Coverage](https://coveralls.io/repos/halostatue/color/badge.svg?branch=main&service=github)][coveralls]
 
 ## Description
 
@@ -22,9 +22,11 @@ reliably converted to relative color spaces (like RGB) without color profiles.
 When necessary for conversions, Color provides D65 and D50 reference white
 values in Color::XYZ.
 
-Color 2.1 fixes multiple Color::XYZ bugs. It builds on the Color 2.0 major
-release, dropping support for all versions of Ruby prior to 3.2 as well as
-removing or renaming a number of features. The main breaking changes are:
+Color 2.2 adds a minor feature where an RGB color created from values can
+silently inherit the `#name` of a predefined color if `color/rgb/colors` has
+already been loaded. It builds on the Color 2.0 major release, dropping support
+for all versions of Ruby prior to 3.2 as well as removing or renaming a number
+of features. The main breaking changes are:
 
 - Color classes are immutable Data objects; they are no longer mutable.
 - RGB named colors are no longer loaded on gem startup, but must be required
@@ -50,5 +52,16 @@ end
 c.to_rgb
 ```
 
+## Color Semantic Versioning
+
+The Color library uses a [Semantic Versioning][semver] scheme with one change:
+
+- When PATCH is zero (`0`), it will be omitted from version references.
+
 [ci-workflow]: https://github.com/halostatue/color/actions/workflows/ci.yml
 [coveralls]: https://coveralls.io/github/halostatue/color?branch=main
+[rubygems]: https://rubygems.org/gems/color
+[semver]: https://semver.org/
+[shield-ci]: https://img.shields.io/github/actions/workflow/status/halostatue/color/ci.yml?style=for-the-badge "Build Status"
+[shield-coveralls]: https://img.shields.io/coverallsCoverage/github/halostatue/color?style=for-the-badge
+[shield-gems]: https://img.shields.io/gem/v/color?style=for-the-badge "Version"

data/Rakefile

@@ -8,7 +8,6 @@ require "minitest"
 require "minitest/test_task"
 
 Hoe.plugin :halostatue
-Hoe.plugin :rubygems
 
 Hoe.plugins.delete :debug
 Hoe.plugins.delete :newb
@@ -31,16 +30,16 @@ hoe = Hoe.spec "color" do
   }
 
   extra_dev_deps << ["hoe", "~> 4.0"]
-  extra_dev_deps << ["hoe-halostatue", "~> 2.1", ">= 2.1.1"]
+  extra_dev_deps << ["hoe-halostatue", "~> 3.0"]
   extra_dev_deps << ["json", ">= 0.0"]
-  extra_dev_deps << ["minitest", "~> 5.16"]
+  extra_dev_deps << ["minitest", "~> 6.0"]
   extra_dev_deps << ["minitest-autotest", "~> 1.0"]
   extra_dev_deps << ["minitest-focus", "~> 1.1"]
   extra_dev_deps << ["rake", ">= 10.0", "< 14"]
-  extra_dev_deps << ["rdoc", ">= 0.0", "< 7"]
+  extra_dev_deps << ["rdoc", ">= 6.0", "< 8"]
   extra_dev_deps << ["simplecov", "~> 0.22"]
   extra_dev_deps << ["simplecov-lcov", "~> 0.8"]
-  extra_dev_deps << ["standard", "~> 1.0"]
+  extra_dev_deps << ["standard", "~> 1.50"]
 end
 
 Minitest::TestTask.create :test

data/SECURITY.md

@@ -25,16 +25,6 @@ Ruby 3.2 or higher.
 
 ## Reporting a Vulnerability
 
-Prefer creating a [private vulnerability report][advisory] with GitHub.
-Alternatively, send an email to [security@ruby.halostatue.ca][email] with the
-text `Color` in the subject. Emails sent to this address should be encrypted
-using [age][age] with the following public key: [age][age] with the following
-public key:
-
-```
-age1fc6ngxmn02m62fej5cl30lrvwmxn4k3q2atqu53aatekmnqfwumqj4g93w
-```
+Create a [private vulnerability report][advisory] with GitHub.
 
 [advisory]: https://github.com/halostatue/color/security/advisories/new
-[age]: https://github.com/FiloSottile/age
-[email]: mailto:color@ruby.halostatue.ca

data/lib/color/cmyk.rb

@@ -255,14 +255,13 @@ class Color::CMYK
     q.text "CMYK"
     q.breakable
     q.group 2, "[", "]" do
-      q.text ".2f%%" % cyan
+      q.text "%.2f%%" % cyan
       q.fill_breakable
-      q.text ".2f%%" % magenta
+      q.text "%.2f%%" % magenta
       q.fill_breakable
-      q.text ".2f%%" % yellow
-      q.fill_breakable
-      q.text ".2f%%" % key
+      q.text "%.2f%%" % yellow
       q.fill_breakable
+      q.text "%.2f%%" % key
     end
   end
 

data/lib/color/hsl.rb

@@ -98,8 +98,8 @@ class Color::HSL
   # - Saturation values <= 0 always translate to a shade of gray using luminance as
   #   a percentage of gray.
   #
-  # [1] http://bobpowell.net/RGBHSB.aspx
-  # [2] http://support.microsoft.com/kb/29240
+  # [1] https://web.archive.org/web/20150311023529/http://bobpowell.net/RGBHSB.aspx
+  # [2] https://support.microsoft.com/kb/29240
   def to_rgb(...)
     if near_zero_or_less?(l)
       Color::RGB::Black000

data/lib/color/rgb.rb

@@ -69,13 +69,21 @@ class Color::RGB
   ##
   # :attr_reader: name
   # The primary name for this \RGB color.
+  #
+  # If there are no defined names, the color will be checked in the name registry and if
+  # there's a match, it will be returned.
 
   ##
   # :attr_reader: names
-  # The names for this \RGB color.
+  # The defined names for this \RGB color.
 
   ##
-  def name = names&.first # :nodoc:
+  def name # :nodoc:
+    name = names&.first
+    return name if name
+
+    self.class.send(:__by_hex)[hex]&.name if defined?(Color::RGB::Metallic)
+  end
 
   ##
   # Coerces the other Color object into \RGB.
@@ -144,7 +152,7 @@ class Color::RGB
   ##
   # Converts \RGB to Color::HSL.
   #
-  # The conversion here is based on formulas from http://www.easyrgb.com/math.php and
+  # The conversion here is based on formulas from https://www.easyrgb.com/math.php and
   # elsewhere.
   def to_hsl(...)
     min, max = [r, g, b].minmax
@@ -163,7 +171,7 @@ class Color::RGB
       end
 
       # This is based on the conversion algorithm from
-      # http://en.wikipedia.org/wiki/HSV_color_space#Conversion_from_RGB_to_HSL_or_HSV
+      # https://en.wikipedia.org/wiki/HSV_color_space#Conversion_from_RGB_to_HSL_or_HSV
       # Contributed by Adam Johnson
       sixth = 1 / 6.0
       if r == max # near_zero_or_less?(r - max)
@@ -192,7 +200,7 @@ class Color::RGB
   # other \RGB color spaces are currently supported.
   #
   # :call-seq:
-  #   to_xyz(color_space: :srgb)
+  #   to_xyz(color_space: :sRGB)
   def to_xyz(*args, **kwargs)
     color_space = kwargs[:color_space] || args.first || :sRGB
 
@@ -430,7 +438,7 @@ class Color::RGB
   def max_rgb_as_grayscale = Color::Grayscale.from_fraction([r, g, b].max)
 
   ##
-  def inspect = "RGB [#{html}]" # :nodoc:
+  def inspect = names ? "RGB [#{html}] {#{names.join(" ")}}" : "RGB [#{html}]" # :nodoc:
 
   ##
   def pretty_print(q) # :nodoc:
@@ -439,6 +447,17 @@ class Color::RGB
     q.group 2, "[", "]" do
       q.text html
     end
+
+    if names
+      q.breakable
+      q.group 2, "{", "}" do
+        last = names.last
+        names.each {
+          q.text _1
+          q.fill_breakable unless _1 == last
+        }
+      end
+    end
   end
 
   ##

data/lib/color/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Color
-  VERSION = "2.1.2" # :nodoc:
+  VERSION = "2.2.0" # :nodoc:
 end

data/lib/color/xyz.rb

@@ -214,7 +214,7 @@ class Color::XYZ
     rel = scale(1.0 / ref.x, 1.0 / ref.y, 1.0 / ref.z)
 
     # And now transform
-    # http://en.wikipedia.org/wiki/Lab_color_space#Forward_transformation
+    # https://en.wikipedia.org/wiki/Lab_color_space#Forward_transformation
     # There is a brief explanation there as far as the nature of the calculations,
     # as well as a much nicer looking modeling of the algebra.
     f = rel.map { |t|
@@ -260,7 +260,7 @@ class Color::XYZ
 
   def to_internal = [x, y, z] # :nodoc:
 
-  def inspect = "XYZ [#{x} #{y} #{z}]" # :nodoc:
+  def inspect = "XYZ [%.4f %.4f %.4f]" % [x, y, z] # :nodoc:
 
   def pretty_print(q) # :nodoc:
     q.text "XYZ"

data/lib/color/yiq.rb

@@ -88,15 +88,15 @@ class Color::YIQ
 
   def inspect = "YIQ [%.2f%% %.2f%% %.2f%%]" % [y * 100, i * 100, q * 100] # :nodoc:
 
-  def pretty_print(q) # :nodoc:
-    q.text "YIQ"
-    q.breakable
-    q.group 2, "[", "]" do
-      q.text "%.2f%%" % y
-      q.fill_breakable
-      q.text "%.2f%%" % i
-      q.fill_breakable
-      q.text "%.2f%%" % q
+  def pretty_print(pq) # :nodoc:
+    pq.text "YIQ"
+    pq.breakable
+    pq.group 2, "[", "]" do
+      pq.text "%.2f%%" % (y * 100)
+      pq.fill_breakable
+      pq.text "%.2f%%" % (i * 100)
+      pq.fill_breakable
+      pq.text "%.2f%%" % (q * 100)
     end
   end
 

data/test/minitest_helper.rb

@@ -3,6 +3,8 @@
 require "color"
 require "color/rgb/colors"
 
+require "pp"
+
 gem "minitest"
 require "minitest/autorun"
 require "minitest/focus"
@@ -18,5 +20,11 @@ module Minitest::ColorExtensions
     assert_in_delta expected, actual, Color::TOLERANCE, msg
   end
 
+  def assert_pretty_inspect(expected, object, msg = nil)
+    actual = PP.pp(object, +"", 8)
+
+    assert_equal expected, actual, message(msg, nil) { diff expected, actual }
+  end
+
   Minitest::Test.send(:include, self)
 end

data/test/test_cmyk.rb

@@ -34,6 +34,10 @@ module TestColor
       assert_equal("CMYK [10.00% 20.00% 30.00% 40.00%]", @cmyk.inspect)
     end
 
+    def test_pretty_print
+      assert_pretty_inspect "CMYK\n[10.00%\n  20.00%\n  30.00%\n  40.00%]\n", @cmyk
+    end
+
     def test_css
       assert_equal("device-cmyk(10.00% 20.00% 30.00% 40.00%, rgb(54.00% 48.00% 42.00%))", @cmyk.css)
       assert_equal("device-cmyk(10.00% 20.00% 30.00% 40.00% / 0.50, rgb(54.00% 48.00% 42.00% / 0.50))", @cmyk.css(alpha: 0.5))

data/test/test_grayscale.rb

@@ -42,6 +42,10 @@ module TestColor
     def test_inspect
       assert_equal("Grayscale [33.00%]", @gs.inspect)
     end
+
+    def test_pretty_print
+      assert_pretty_inspect "Grayscale\n[33.00%]\n", @gs
+    end
   end
 
   class TestGrayscaleConversions < Minitest::Test

data/test/test_hsl.rb

@@ -82,6 +82,10 @@ module TestColor
     def test_inspect
       assert_equal "HSL [145.00deg 20.00% 30.00%]", @hsl.inspect
     end
+
+    def test_pretty_print
+      assert_pretty_inspect "HSL\n[145.00deg\n  20.00%\n  30.00%]\n", @hsl
+    end
   end
 
   class TestHSLConversions < Minitest::Test

data/test/test_rgb.rb

@@ -139,8 +139,8 @@ module TestColor
     def test_by_hex
       assert_same(Color::RGB::Cyan, Color::RGB.by_hex("#0ff"))
       assert_same(Color::RGB::Cyan, Color::RGB.by_hex("#00ffff"))
-      assert_equal("RGB [#333333]", Color::RGB.by_hex("#333").inspect)
-      assert_equal("RGB [#333333]", Color::RGB.by_hex("333").inspect)
+      assert_equal("RGB [#333333] {tungsten}", Color::RGB.by_hex("#333").inspect)
+      assert_equal("RGB [#333333] {tungsten}", Color::RGB.by_hex("333").inspect)
       assert_raises(ArgumentError) { Color::RGB.by_hex("5555555") }
       assert_raises(ArgumentError) { Color::RGB.by_hex("#55555") }
     end
@@ -170,11 +170,41 @@ module TestColor
     end
 
     def test_inspect
-      assert_equal("RGB [#000000]", Color::RGB::Black.inspect)
-      assert_equal("RGB [#0000ff]", Color::RGB::Blue.inspect)
-      assert_equal("RGB [#00ff00]", Color::RGB::Lime.inspect)
-      assert_equal("RGB [#ff0000]", Color::RGB::Red.inspect)
-      assert_equal("RGB [#ffffff]", Color::RGB::White.inspect)
+      assert_equal("RGB [#000000] {black}", Color::RGB::Black.inspect)
+      assert_equal("RGB [#0000ff] {blue}", Color::RGB::Blue.inspect)
+      assert_equal("RGB [#00ff00] {lime}", Color::RGB::Lime.inspect)
+      assert_equal("RGB [#ff0000] {red}", Color::RGB::Red.inspect)
+      assert_equal("RGB [#ffffff] {white}", Color::RGB::White.inspect)
+      assert_equal("RGB [#708090] {slategray slategrey}", Color::RGB::SlateGrey.inspect)
+    end
+
+    def test_pretty_print
+      assert_pretty_inspect("RGB\n[#000000]\n{black}\n", Color::RGB::Black)
+      assert_pretty_inspect("RGB\n[#0000ff]\n{blue}\n", Color::RGB::Blue)
+      assert_pretty_inspect("RGB\n[#00ff00]\n{lime}\n", Color::RGB::Lime)
+      assert_pretty_inspect("RGB\n[#ff0000]\n{red}\n", Color::RGB::Red)
+      assert_pretty_inspect("RGB\n[#ffffff]\n{white}\n", Color::RGB::White)
+      assert_pretty_inspect("RGB\n[#708090]\n{slategray\n  slategrey}\n", Color::RGB::SlateGrey)
+    end
+
+    def test_name
+      assert_equal("black", Color::RGB::Black.name)
+      assert_equal("blue", Color::RGB::Blue.name)
+      assert_equal("lime", Color::RGB::Lime.name)
+      assert_equal("red", Color::RGB::Red.name)
+      assert_equal("white", Color::RGB::White.name)
+
+      assert_equal("black", Color::RGB.from_values(0, 0, 0).name)
+      assert_equal("blue", Color::RGB.from_values(0, 0, 0xff).name)
+      assert_equal("lime", Color::RGB.from_values(0, 0xff, 0).name)
+      assert_equal("red", Color::RGB.from_values(0xff, 0, 0).name)
+      assert_equal("white", Color::RGB.from_values(0xff, 0xff, 0xff).name)
+
+      assert_equal("000", Color::RGB.from_values(0, 0, 0, ["000"]).name)
+      assert_equal("00f", Color::RGB.from_values(0, 0, 0xff, ["00f"]).name)
+      assert_equal("0f0", Color::RGB.from_values(0, 0xff, 0, ["0f0"]).name)
+      assert_equal("f00", Color::RGB.from_values(0xff, 0, 0, ["f00"]).name)
+      assert_equal("fff", Color::RGB.from_values(0xff, 0xff, 0xff, ["fff"]).name)
     end
 
     def test_delta_e2000

data/test/test_yiq.rb

@@ -31,6 +31,10 @@ module TestColor
     def test_inspect
       assert_equal("YIQ [10.00% 20.00% 30.00%]", @yiq.inspect)
     end
+
+    def test_pretty_print
+      assert_pretty_inspect "YIQ\n[10.00%\n  20.00%\n  30.00%]\n", @yiq
+    end
   end
 
   class TestYIQConversions < Minitest::Test

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: color
 version: !ruby/object:Gem::Version
-  version: 2.1.2
+  version: 2.2.0
 platform: ruby
 authors:
 - Austin Ziegler
 - Matt Lyon
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 1970-01-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hoe
@@ -30,20 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.1.1
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.1.1
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
@@ -64,14 +58,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.16'
+        version: '6.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.16'
+        version: '6.0'
 - !ruby/object:Gem::Dependency
   name: minitest-autotest
   requirement: !ruby/object:Gem::Requirement
@@ -126,20 +120,20 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.0'
+        version: '6.0'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '7'
+        version: '8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.0'
+        version: '6.0'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '7'
+        version: '8'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -174,14 +168,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.50'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.50'
 description: |-
   Color is a Ruby library to provide RGB, CMYK, HSL, and other color space
   manipulation support to applications that require it. It provides optional named
@@ -195,9 +189,11 @@ description: |-
   When necessary for conversions, Color provides D65 and D50 reference white
   values in Color::XYZ.
 
-  Color 2.1 fixes multiple Color::XYZ bugs. It builds on the Color 2.0 major
-  release, dropping support for all versions of Ruby prior to 3.2 as well as
-  removing or renaming a number of features. The main breaking changes are:
+  Color 2.2 adds a minor feature where an RGB color created from values can
+  silently inherit the `#name` of a predefined color if `color/rgb/colors` has
+  already been loaded. It builds on the Color 2.0 major release, dropping support
+  for all versions of Ruby prior to 3.2 as well as removing or renaming a number
+  of features. The main breaking changes are:
 
   - Color classes are immutable Data objects; they are no longer mutable.
   - RGB named colors are no longer loaded on gem startup, but must be required
@@ -255,6 +251,7 @@ licenses:
 metadata:
   source_code_uri: https://github.com/halostatue/color
   bug_tracker_uri: https://github.com/halostatue/color/issues
+  documentation_uri: https://halostatue.github.io/color/
   changelog_uri: https://github.com/halostatue/color/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
 rdoc_options:
@@ -273,7 +270,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.4
 specification_version: 4
 summary: Color is a Ruby library to provide RGB, CMYK, HSL, and other color space
   manipulation support to applications that require it