redgreenblue 0.15.0 → 0.16.0

data/lib/redgreenblue/web.rb

@@ -1,55 +1,4 @@
-class RGB
-
-  #----------------------------------------------------------------------#
-  #                            Class Methods                             #
-  #----------------------------------------------------------------------#
-
-  class << self
-
-    # Returns CSS named colors, as per CSS Color Module Level 4.
-    #
-    # Optional selector argument can be:
-    # - String or Regexp (to select by name)
-    # - RGB color (to select by color)
-    # - Integer (to select by index).
-    # Selection by name (string or regular expression) is case-insensitive by default.
-    #
-    # @example No Selector
-    #  # All colors
-    #  RGB.css
-    #
-    #  # Pastels
-    #  RGB.css.select { |c| c.ostwald_cwk[1] > 0.6 }
-    # @example Select by Name
-    #  # Exact name
-    #  RGB.css 'pink'
-    #
-    #  # Regular expression
-    #  RGB.css /pink|rose/
-    #
-    # @example Select by RGB color
-    #  RGB.css RGB.hex('0ff')
-    def css(selector=nil)
-      @@css ||= load_gpl file: ( File.join File.dirname(__FILE__), 'palettes', 'css.gpl' ), freeze: true
-      case selector
-        when NilClass
-          @@css
-        when String
-          n = selector.downcase
-          @@css.select { |c| c.name == n }.first
-        when Regexp
-          r = Regexp.new selector.source, Regexp::IGNORECASE
-          @@css.select { |c| c.name =~ r }
-        when Integer
-          @@css[selector]
-        when self
-          @@css.select { |c| c == selector }
-        else
-          raise ArgumentError, 'Unsupported selector'
-      end
-    end
-
-  end
+class RGB::Color
 
   #----------------------------------------------------------------------#
   #                           Instance Methods                           #
@@ -112,3 +61,58 @@ class RGB
   end
 
 end
+
+#----------------------------------------------------------------------#
+#                            Module Methods                            #
+#----------------------------------------------------------------------#
+
+module RGB
+
+  class << self
+
+    # Returns CSS named colors, as per CSS Color Module Level 4.
+    #
+    # Optional selector argument can be:
+    # - String or Regexp (to select by name)
+    # - RGB color (to select by color)
+    # - Integer (to select by index).
+    # Selection by name (string or regular expression) is case-insensitive by default.
+    #
+    # @example No Selector
+    #  # All colors
+    #  RGB.css
+    #
+    #  # Pastels
+    #  RGB.css.select { |c| c.ostwald_cwk[1] > 0.6 }
+    # @example Select by Name
+    #  # Exact name
+    #  RGB.css 'pink'
+    #
+    #  # Regular expression
+    #  RGB.css /pink|rose/
+    #
+    # @example Select by RGB color
+    #  RGB.css RGB.hex('0ff')
+    def css(selector=nil)
+      @@css ||= load_gpl file: ( File.join File.dirname(__FILE__), 'palettes', 'css.gpl' ), freeze: true
+      case selector
+        when NilClass
+          @@css
+        when String
+          n = selector.downcase
+          @@css.select { |c| c.name == n }.first
+        when Regexp
+          r = Regexp.new selector.source, Regexp::IGNORECASE
+          @@css.select { |c| c.name =~ r }
+        when Integer
+          @@css[selector]
+        when RGB::Color
+          @@css.select { |c| c == selector }
+        else
+          raise ArgumentError, 'Unsupported selector'
+      end
+    end
+
+  end
+
+end

data/lib/redgreenblue.rb

@@ -1,4 +1,23 @@
-class RGB
+# The RGB module is the main namespace for redgreenblue.
+#
+# This module has many helper methods for creating RGB::Color objects.
+# The example below shows seven ways to create an RGB::Color object for the exact same color.
+# @example
+#  require 'redgreenblue'
+#
+#  pink = RGB.new(1, 0.6, 0.8)
+#  pink = RGB.rgb(255, 153, 204)
+#  pink = RGB.rrggbb(65535, 39321, 52428)
+#  pink = RGB.hex('f9c')
+#  pink = RGB.hsl(330, 1, 0.8)
+#  pink = RGB.hsv(330, 0.4, 1)
+#  pink = RGB.at(16751052)
+module RGB
+
+  # This class represents an RGB color.
+  class Color
+  end
+
 end
 
 %w(

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: redgreenblue
 version: !ruby/object:Gem::Version
-  version: 0.15.0
+  version: 0.16.0
 platform: ruby
 authors:
 - lllist.eu
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-11-10 00:00:00.000000000 Z
+date: 2022-06-09 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
+rubygems_version: 3.3.11
 signing_key:
 specification_version: 4
 summary: A simple Ruby library for handling RGB colors.