color-hacker 1.0.0

data/README.markdown

@@ -0,0 +1,59 @@
+# What is this?
+
+Color Hacker is a handy little utility for helping you crack your color schemes using Sass color functions.
+Simply pass the `hack-colors` function a list of colors and it will return a set of color functions that show
+how all of the colors in the color scheme can be derived from the first color.
+
+## Example
+
+``` scss
+@debug(hack-colors(#cff09e #a8dba8 #79bd9a #3b8686 #0b486b));
+```
+
+Output:
+
+``` scss
+$key: #cff09e;
+$color-2: scale-color(adjust-hue($key, 36deg), $saturation: -43.367%, $lightness: -2.764%);
+$color-3: scale-color(adjust-hue($key, 65deg), $saturation: -53.561%, $lightness: -22.111%);
+$color-4: scale-color(adjust-hue($key, 96deg), $saturation: -46.923%, $lightness: -51.508%);
+$color-5: scale-color(adjust-hue($key, 118deg), $saturation: 30.395%, $lightness: -70.352%);
+```
+
+
+## Setup
+
+Install the plugin:
+
+``` sh
+gem install color-hacker
+```
+
+Add Color Hacker to your compass configuration file:
+
+``` rb
+require 'color-hacker'
+```
+
+## Usage
+
+`hack-colors` accepts two variables.
+
+1. A space separated list of colors, e.g. (#fab #00face)
+2. Optional: A function type, scale or adjust. Defaults to scale.
+
+``` scss
+// Debug passes output to the terminal
+@debug(hack-colors(#beaf0c #deac0b));
+
+// Return adjust-color functions
+@debug(hack-colors(#beaf0c #deac0b, scale));
+
+```
+
+## License
+Copyright (c) 2008-2009 Brandon Mathis<br>
+All Rights Reserved.<br>
+Released under a [slightly modified MIT License][license].
+
+[license]: http://github.com/imathis/color-hacker/tree/master/LICENSE.markdown

data/VERSION.yml

@@ -0,0 +1,4 @@
+---
+:major: 1
+:minor: 0
+:patch: 0

data/lib/color-hacker.rb

@@ -0,0 +1,7 @@
+#require 'compass'
+
+base_directory  = File.join(File.dirname(__FILE__), '..')
+stylesheets_dir = File.join(base_directory, 'stylesheets')
+templates_dir = File.join(base_directory, 'templates')
+
+Compass::Frameworks.register('color-hacker', :stylesheets_directory => stylesheets_dir, :templates_directory => templates_dir)

data/lib/version.rb

@@ -0,0 +1,59 @@
+module ColorHacker
+  module Version
+    # Returns a hash representing the version.
+    # The :major, :minor, and :teeny keys have their respective numbers.
+    # The :string key contains a human-readable string representation of the version.
+    # The :rev key will have the current revision hash.
+    #
+    # This method swiped from Compass by Chris Eppstein who swiped it from Haml and then modified it, so some credit goes to Nathan Weizenbaum too.
+    def version
+      if defined?(@version)
+        @version
+      else
+        read_version
+      end
+    end
+
+    protected
+
+    def scope(file) # :nodoc:
+      File.join(File.dirname(__FILE__), '..', file)
+    end
+
+    def read_version
+      require 'yaml'
+      @version = YAML::load(File.read(scope('VERSION.yml')))
+      @version[:teeny] = @version[:patch]
+      @version[:string] = "#{@version[:major]}.#{@version[:minor]}"
+      @version[:string] << ".#{@version[:patch]}" if @version[:patch]
+      @version[:string] << ".#{@version[:state]}" if @version[:state]
+      @version[:string] << ".#{@version[:build]}" if @version[:build]
+      #if !ENV['OFFICIAL'] && r = revision
+      #  @version[:string] << ".#{r[0..6]}"
+      #end
+      @version
+    end
+
+    def revision
+      revision_from_git
+    end
+
+    def revision_from_git
+      if File.exists?(scope('.git/HEAD'))
+        rev = File.read(scope('.git/HEAD')).strip
+        if rev =~ /^ref: (.*)$/
+          rev = File.read(scope(".git/#{$1}")).strip
+        end
+      end
+    end
+  end
+  extend ColorHacker::Version
+  def self.const_missing(const)
+    # This avoid reading from disk unless the VERSION is requested.
+    if const == :VERSION
+      version[:string]
+    else
+      super
+    end
+  end
+end

data/stylesheets/_color-hacker.scss

@@ -0,0 +1,35 @@
+@function scale-to-adjust($start, $change) {
+  @if($change > 0) {
+    $end: $start + $change;
+    @return percentage(($end - $start)/(100 - $start));
+  } @else {
+    @return percentage($change / $start);
+  }
+}
+
+@function scale-key($key, $color) {
+  $h: hue($color) - hue($key);
+  $s: saturation($color) - saturation($key);
+  $l: lightness($color) - lightness($key);
+  @return "scale-color(adjust-hue($key, #{$h}), $saturation: #{scale-to-adjust(saturation($key), $s)}, $lightness: #{scale-to-adjust(lightness($key), $l)}); ";
+}
+
+@function adjust-key($key, $color) {
+  $h: hue($color) - hue($key);
+  $s: saturation($color) - saturation($key);
+  $l: lightness($color) - lightness($key);
+  @return "adjust-color($key, $hue: #{$h}, $saturation: #{$s}, $lightness: #{$l}); ";
+}
+
+@function hack-colors($colors, $method: scale){
+  $key: nth($colors, 1);
+  $hack: "$key: #{$key}; ";
+  @for $i from 2 through length($colors) {
+    @if $method == scale {
+     $hack: $hack + "$color-#{$i}: #{scale-key($key, nth($colors, $i))}";
+   } @else {
+     $hack: $hack + "$color-#{$i}: #{adjust-key($key, nth($colors, $i))}";
+   }
+  }
+  @return $hack;
+}

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification 
+name: color-hacker
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Brandon Mathis
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-11-05 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: compass
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0.11"
+  type: :runtime
+  version_requirements: *id001
+description: Color Hacker is a Compass plugin which uses Sass color functions to find find the relationships between colors
+email: brandon@imathis.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.markdown
+- VERSION.yml
+- lib/color-hacker.rb
+- lib/version.rb
+- stylesheets/_color-hacker.scss
+has_rdoc: true
+homepage: http://github.com/imathis/color-hacker
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Converts a list of colors into a set of dependant color functions
+test_files: []
+