color_helpers 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 97e0b6581f86ddbf23b9b42ed549e35bef32ca24
-  data.tar.gz: a2938e01e6f8a420ee4fd00ecfdfff26286cfd2b
+  metadata.gz: 96bf52dfd6e884df92c351adfda806a911ef2357
+  data.tar.gz: ad1d2be1ec83107a91e1afd732848994b9a40359
 SHA512:
-  metadata.gz: b3ab42f984f88553b47f8130c948e2f1d30edb93192cbd68e9ff4d9b9e93868d5f9aae0cdda4004fc66e65c2a44916634daa66b227f5f7d21be72e593dc3c448
-  data.tar.gz: 8710fe3f0a98ae311eb2d439c4f172546f018f755a8181d0eb3faa75c2e86b49dce259a8637b56b08790688b7bb7db56b0722e6f7ebdae39f52a211b58935c11
+  metadata.gz: cf7ebcb123dcd996e326a26c5b10bf37192807474771db0a9801ec9bf9998a60fa012b58bc6e72c44f91ae9d94171c1b7da999236ed1fc67735c33c8a1347d24
+  data.tar.gz: 54b8177114c3c1a0c0b184fa40c1f78d36e80ad4984055a5b40b0c7b457c27d9971f07051d249dbfb71e225fdf26654a98656ea290148ad215737990c437107a

data/README.md

@@ -1,4 +1,5 @@
 # ColorHelpers
+[<img src="https://badge.fury.io/rb/color_helpers.svg" alt="Gem Version" />](https://rubygems.org/gems/color_helpers)
 
 ## Installation
 
@@ -17,12 +18,29 @@ Or install it yourself as:
     $ gem install color_helpers
 
 ## Usage
-_hex_color argument accepts an input string e.g. "#ff0000"_
-
-* **darken_color(hex_color, amount)** _amount 0-1, default: 0.4_
-* **lighten_color(hex_color, amount)** _amount 0-1, default: 0.6_
-* **contrasting_text_color(hex_color)**
 
+```ruby
+<%= random_hex_color %> // prints a random hex color e.g. "#ff0000"
+```
+```ruby
+<%= hex_to_rgb(hex_color) %> // converts hex color string to rgb color string
+```
+```ruby
+<%= rgb_to_hex(rgb_color) %> // converts rgb color string to hex color string
+```
+_hex_color argument accepts an input string e.g. "#ff0000"_
+```ruby
+<%= darken_color(hex_color, amount)  %> // amount: 0 to 1, default: 0.4
+```
+```ruby
+<%= lighten_color(hex_color, amount)  %> // amount: 0 to 1, default: 0.6
+```
+```ruby
+<%= contrasting_text_color(hex_color)  %> // Options: :monochrome, default: false
+```
+```ruby
+<%= color_to_grayscale(hex_color)  %> // converts color to greyscale
+```
 
 ## Development
 

data/color_helpers.gemspec

@@ -22,6 +22,8 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
+  spec.add_dependency "actionview", '~> 4.2'
+
   spec.add_development_dependency "bundler", "~> 1.8"
   spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "rspec"

data/lib/color_helpers/helpers.rb

@@ -1,5 +1,18 @@
 module ColorHelpers
   module ActionViewExtension
+    def random_hex_color
+      "#"+SecureRandom.hex(3)
+    end
+
+    def hex_to_rgb(hex_color)
+      color = hex_color.gsub('#','')
+      "rgb("+color.scan(/../).map {|color| color.to_i(16)}.join(",").to_s+")"
+    end
+
+    def rgb_to_hex(rgb_color)
+      color =  rgb_color.delete("rgb() ").split(",")
+      "#%02x%02x%02x" % color
+    end
 
     def darken_color(hex_color, amount=0.4)
       hex_color = hex_color.gsub('#','')
@@ -9,18 +22,31 @@ module ColorHelpers
 
     def lighten_color(hex_color, amount=0.6)
       hex_color = hex_color.gsub('#','')
-      rgb = hex_color.scan(/../).map(&:hex).map{|color| (color + 255) * amount}.map(&:round)
+      rgb = hex_color.scan(/../).map(&:hex).map{|color| (color + 255) * amount}.map{|color| [color.round, 255].min}
       "#%02x%02x%02x" % rgb
     end
 
-    def contrasting_text_color(hex_color)
+    def contrasting_text_color(hex_color, options = {})
       color = hex_color.gsub('#','')
-      convert_to_brightness_value(color) > 382.5 ? darken_color(color) : lighten_color(color)
+      if options[:monochrome] == true
+        convert_to_brightness_value(color) > 382.5 ? "#000000" : "#ffffff"
+      else
+        convert_to_brightness_value(color) > 382.5 ? darken_color(color) : lighten_color(color)
+      end
     end
 
     def convert_to_brightness_value(hex_color)
        (hex_color.scan(/../).map {|color| color.hex}).sum
     end
+
+    def color_to_grayscale(hex_color)
+      hex_color = hex_color.gsub('#','')
+      rgb = hex_color.scan(/../).map(&:hex)
+      grayscale_factors = {r: 0.21, g: 0.72, b: 0.07}
+      rgb[0] = (rgb[0].to_i * grayscale_factors[:r] + rgb[1].to_i * grayscale_factors[:g] + rgb[2].to_i * grayscale_factors[:b]).round
+      rgb[1] = rgb[2] = rgb[0]
+      "#%02x%02x%02x" % rgb
+    end
   end
 end
 ActionView::Base.send :include, ColorHelpers::ActionViewExtension

data/lib/color_helpers/version.rb

@@ -1,3 +1,3 @@
 module ColorHelpers
-  VERSION = "0.1.2"
+  VERSION = "0.2.0"
 end

data/lib/color_helpers.rb

@@ -1,2 +1,3 @@
+require 'action_view'
 require 'color_helpers/version'
 require 'color_helpers/helpers'

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: color_helpers
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Martin Schneider
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-04-22 00:00:00.000000000 Z
+date: 2016-04-25 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: actionview
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -93,7 +107,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.6
+rubygems_version: 2.6.3
 signing_key: 
 specification_version: 4
 summary: View helpers for hex color brightness adjustments.