chroma 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 50d3030c7ac81f4ced369d991d94ae827af946c3
-  data.tar.gz: 20fba6d256719e631c6f0333aeb32afcf13c0fc1
+  metadata.gz: ba59f54923418c9d94c2c434673428053bb71d71
+  data.tar.gz: 83e5c63353336387b402b9afd78533f6d0439e04
 SHA512:
-  metadata.gz: 95b1f6fa55a3f8fc40c35a069c94c45a47a1bf6a889382971285bc4bb052331133f45b5f5e253d1a3f69340f928b1ae2026d959ed887d07feea44759c5382257
-  data.tar.gz: 085c7c08e31045167d3e57832f1f518f5ad6a8309881be5bceaf1a747a402d6831d426cdeec2551825207cbbebdc045a3029a30c1671fffea28dd261d6489666
+  metadata.gz: c72995a317f6f18237dcdd0abb1023610895a777407d41a96df667ad56a306949ab3b36cc131c7e6412d5895387e53904dc3de6e03a1d50db40e74e3ced4ab74
+  data.tar.gz: d3bdef0aca890fc72a95f5d1eacfb527f92c4d42c07adbcaad01c376fb63a9c321f7093b7a7ae58aaa7cc6a0b7ea5cd4453b38740fe069a19fe7cca97d9ff3ff

data/CHANGELOG.md

@@ -1,4 +1,22 @@
-### v0.0.1 - 2015-01-14
+## v0.1.0 - 2016-05-26
+
+### Dynamic Custom Palettes
+
+You can generate custom palettes on the fly without predefining them now. The
+old way of defining them with a name via `Chroma.define_palette` still works
+too.
+
+```ruby
+# New dynamic way
+'red'.paint.custom_palette do
+  spin 60
+  spin 180
+end
+
+#=> [red, yellow, cyan]
+```
+
+## v0.0.1 - 2015-01-14
 
 **Method Changes:**
 
@@ -15,7 +33,7 @@
 * Minor API doc example fixes.
 * Add public API usage examples to README.
 
-### [v0.0.1.alpha.3] - 2015-01-13
+## [v0.0.1.alpha.3] - 2015-01-13
 
 **Bug Fixes:**
 
@@ -41,7 +59,7 @@
 * Introduced custom errors and replaced `raise` calls with them.
 * Added API doc headers. (#4)
 
-### [v0.0.1.alpha.2] - 2015-01-13
+## [v0.0.1.alpha.2] - 2015-01-13
 
 **Bug Fixes:**
 
@@ -82,6 +100,6 @@
   * `to_rgb_s`  -> `to_rgb`
   * Removed `to_name_s` alias
 
-### [v0.0.1.alpha.1] - 2015-01-11
+## [v0.0.1.alpha.1] - 2015-01-11
 
 * Initial release

data/README.md

@@ -270,6 +270,20 @@ red.palette.respond_to? :my_palette #=> true
 red.palette.my_palette #=> [#ff0000 #ffff00 #00ffff #ffff33 #808080]
 ```
 
+## Dynamic Custom Palettes
+
+You can generate custom palettes on the fly too with
+`Chroma::Color#custom_palette`.
+
+```ruby
+'red'.paint.custom_palette do
+  spin 60
+  spin 180
+end
+
+#=> [red, yellow, cyan]
+```
+
 ## Serializing Colors
 
 Colors offer several methods to output to different string color [formats](#available-formats).

data/lib/chroma.rb

@@ -112,7 +112,11 @@ module Chroma
         raise Errors::PaletteDefinedError, "Palette `#{name}' already exists"
       end
 
-      PaletteBuilder.build(name, &block)
+      palette_evaluator = PaletteBuilder.build(&block)
+
+      Harmonies.send(:define_method, name) do
+        palette_evaluator.evaluate(@color)
+      end
     end
 
     private

data/lib/chroma/color.rb

@@ -82,6 +82,22 @@ module Chroma
       Harmonies.new(self)
     end
 
+    # Defines a custom palette and immediately returns it. Uses a DSL inside
+    # `block` that mirrors the methods in {Color::Modifiers}.
+    #
+    # @example
+    #   'red'.paint.custom_palette do
+    #     spin 60
+    #     spin 180
+    #   end
+    #   #=> [red, yellow, cyan]
+    #
+    # @param block [Proc] the palette definition block
+    # @return [Array<Color>] palette array of colors
+    def custom_palette(&block)
+      PaletteBuilder.build(&block).evaluate(self)
+    end
+
     private
 
     def to_2char_hex(n)

data/lib/chroma/palette_builder.rb

@@ -4,47 +4,56 @@ module Chroma
     # Wrapper to instantiate a new instance of {PaletteBuilder} and call its
     #   {PaletteBuilder#build} method.
     #
-    # @param name  [Symbol, String] the name of the custom palette
-    # @param block [Proc]           the palette definition block
-    # @return      [Symbol, String] the name of the custom palette
-    def self.build(name, &block)
-      new(name, &block).build
+    # @param block [Proc]                             the palette definition block
+    # @return      [PaletteBuilder::PaletteEvaluator] lazy palette generator
+    def self.build(&block)
+      new(&block).build
     end
 
-    # @param name  [Symbol, String] the name of the custom palette
-    # @param block [Proc]           the palette definition block
-    def initialize(name, &block)
-      @name = name
+    # @param block [Proc] the palette definition block
+    def initialize(&block)
       @block = block
     end
 
-    # Build the custom palette by defining a new method on {Harmonies}.
-    # @return [Symbol, String] the name of the custom palette
+    # Build the custom palette
+    # @return [PaletteBuilder::PaletteEvaluator] lazy palette generator
     def build
       dsl = PaletteBuilderDsl.new
       dsl.instance_eval(&@block)
-      conversions = dsl.conversions
-
-      Harmonies.send(:define_method, @name) do
-        conversions.map do |color_calls|
-          color_calls.evaluate(@color)
-        end.unshift(@color)
-      end
+      dsl.evaluator
     end
 
     private
 
+    # Internal class for delaying evaluating a color to generate a
+    # final palette
+    class PaletteEvaluator
+      def initialize
+        @conversions = []
+      end
+
+      def <<(conversion)
+        @conversions << conversion
+      end
+
+      def evaluate(color)
+        @conversions.map do |color_calls|
+          color_calls.evaluate(color)
+        end.unshift(color)
+      end
+    end
+
     # Internal class for palette building DSL syntax.
     class PaletteBuilderDsl
-      attr_reader :conversions
+      attr_reader :evaluator
 
       def initialize
-        @conversions = []
+        @evaluator = PaletteEvaluator.new
       end
 
       def method_missing(name, *args)
         ColorCalls.new(name, args).tap do |color_calls|
-          @conversions << color_calls
+          @evaluator << color_calls
         end
       end
 

data/lib/chroma/version.rb

@@ -1,3 +1,3 @@
 module Chroma
-  VERSION = '0.0.1'
+  VERSION = '0.1.0'
 end

data/spec/color/custom_palette_spec.rb

@@ -0,0 +1,19 @@
+describe Chroma::Color, '#custom_palette' do
+  let(:subject) do
+    'red'.paint.custom_palette do
+      spin 60
+      spin 180
+      spin(60).brighten(20)
+      greyscale
+    end
+  end
+
+  it 'generates the correct colors' do
+    expect(subject).
+      to generate_palette %w(#ff0000 #ffff00 #00ffff #ffff33 #808080)
+  end
+
+  it 'keeps the same format' do
+    expect(subject).to all have_format :name
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: chroma
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Jeremy Fairbank
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-01-14 00:00:00.000000000 Z
+date: 2016-05-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -100,6 +100,7 @@ files:
 - spec/chroma/paint_spec.rb
 - spec/chroma_spec.rb
 - spec/color/attributes_spec.rb
+- spec/color/custom_palette_spec.rb
 - spec/color/modifiers_spec.rb
 - spec/color/palette_spec.rb
 - spec/color/serializers_spec.rb
@@ -135,6 +136,7 @@ test_files:
 - spec/chroma/paint_spec.rb
 - spec/chroma_spec.rb
 - spec/color/attributes_spec.rb
+- spec/color/custom_palette_spec.rb
 - spec/color/modifiers_spec.rb
 - spec/color/palette_spec.rb
 - spec/color/serializers_spec.rb