identicon 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: cc364d61b90b314a193e1970d488c6dc4531364c
+  data.tar.gz: 4ada24b1a13a39a1bd182167fbd51d516cc2a197
+SHA512:
+  metadata.gz: 92ffa1913b4049cac62664a1319a1971058fbadbbbe4742602970f8d03b09b770c0785cafe178937ecf16266cb6204ff359051b18f12276db3ba5af4cd060e28
+  data.tar.gz: ba5b800412da3caa320438ed9f32139ecd4df7b5bf4d6d366957b2ab789c835032f2867aa0a6d9323204e8a52e452048a00e269caaa3e60885602f4cf5f10c68

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2013 Victor Gama
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,66 @@
+Identicon
+=========
+![](https://dl.dropboxusercontent.com/u/262919/Identicons/1.png)
+![](https://dl.dropboxusercontent.com/u/262919/Identicons/2.png)
+![](https://dl.dropboxusercontent.com/u/262919/Identicons/3.png)
+
+A Ruby library that generates GitHub-like [identicons](https://github.com/blog/1586-identicons)
+
+## Installing
+
+That's easy! Use [RubyGems](http://rubygems.org)!
+
+Insert `Identicon` on your application's Gemfile:
+
+	gem `identicon`
+
+and run
+
+	$ bundle
+
+or manually install it typing
+
+	$ gem install identicon
+
+and hitting `return` with your favourite finger.
+
+
+
+
+## Using
+
+Require it as always
+
+	require 'identicon'
+
+Now you can use it through two methods: `data_url_for` or `file_for`. Simple like that.
+
+## `data_url_for`
+This generates a data-url, so you can use it immediately, check it out:
+
+	Identicon.data_url_for "Whatever you want!"
+
+You can also specify a image size and a background color:
+
+	Identicon.data_url_for "Whatever you want!", 128, [255, 255, 255]
+
+This creates a 128x128px image, with a nice white background.
+
+---------
+
+*But Vito, I want to save it as a file.*
+
+No probs! 
+
+# `file_for`
+This generates and writes the result to a file. It's as easy as just making a data-url. Check it out:
+
+	Identicon.file_for "User's email? Username? Telephone?", "/path/to/the/image"
+
+And, as you may guess, it also takes that optional parameters.
+
+	Identicon.file_for "User's email? Username? Telephone?", "/path/to/the/image", 128, [255, 255, 255]
+
+----------
+
+Pull requests are welcome!

data/identicon.gemspec

@@ -0,0 +1,20 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |s|
+	s.name					= "identicon"
+	s.version				= "0.0.2"
+	s.authors				= ["Victor Gama"]
+	s.email					= ["victor@insitelabs.com.br"]
+
+	s.description		= "A simple github-like identicons generator."
+	s.summary			= "A simple github-like identicons generator."
+	s.homepage			= "http://github.com/victorgama/identicon"
+	s.license			= "MIT"
+
+	s.files				= `git ls-files`.split($/)
+	s.executables		= s.files.grep(%r{^bin/}) { |file| File.basename(file) }
+	s.require_paths		= ["lib"]
+
+	s.add_dependency	"chunky_png", "~> 1.2.8"
+end

data/lib/identicon.rb

@@ -0,0 +1,147 @@
+require 'digest'
+require 'chunky_png'
+
+# Generates GitHub-like identicons using MD5 hashes
+class Identicon
+	class << self 
+		# Generates a identicon using the data:image protocol.
+		# Usefull for web applications.
+		#
+		# === Parameters
+		# * data 	= The data that will be converted to a identicon
+		# * size    = (Optional) The image size. Defaults to 420px
+		# * background = (Optional) The background color to be used in a rgb array. ([255, 255, 255])
+
+		def data_url_for(data, size = 420, background = nil)
+			img = self.new data, size
+			img.background = background unless background.nil?
+			img.generate_image
+			img.to_data_url
+		end
+
+		# Generates a identicon and stores it in a file
+		# Usefull for web applications.
+		#
+		# === Parameters
+		# * data 	= The data that will be converted to a identicon
+		# * path    = The path where the file will be stored
+		# * size    = (Optional) The image size. Defaults to 420px
+		# * background = (Optional) The background color to be used in a rgb array. ([255, 255, 255])
+		def file_for(data, path, size = 420, background = nil)
+			img = self.new data, size
+			img.background = background unless background.nil?
+			img.generate_image
+			img.save(path)
+		end
+	end
+	attr_accessor :size, :data, :background
+	CHARS_REGEX = /(\w)(\w)/
+
+	COLORS = {
+		:a => [196, 108, 168],
+		:b => [127, 219, 107],
+		:c => [83, 89, 215],
+		:d => [111, 198, 148],
+		:e => [186, 130, 82],
+		:f => [113, 66, 197],
+		:"0" => [201, 186, 84],
+		:"1" => [114, 153, 205],
+		:"2" => [141, 108, 204],
+		:"3" => [75, 183, 114],
+		:"4" => [192, 86, 82],
+		:"5" => [199, 115, 209],
+		:"6" => [206, 77, 94],
+		:"7" => [211, 135, 162],
+		:"8" => [71, 194, 197],
+		:"9" => [188, 110, 93]
+	}
+
+	# The +new+ method initializes a new Identicon instance
+	#
+	# === Parameters
+	# * data 	= The data that will be converted to a identicon
+	# * size    = The image size
+	def initialize(data, size)
+		@hash = Digest::MD5.hexdigest(data.to_s)
+		@chars = @hash.scan(CHARS_REGEX)
+		@color = [0, 0, 0]
+		@size = size
+		@pixel_ratio = (size / 6).round
+		@image_size = @size - (@pixel_ratio / 1.5).round
+		@square_array = Hash.new { |h| h = Hash.new(false) }
+		@background = [240, 240, 240]
+		convert_hash
+	end
+
+
+	def size=(value)
+		@size = value
+		@pixel_ratio = (value / 5).round
+		value
+	end
+
+	def data=(value)
+		@hash = Digest::MD5.hexdigest(data.to_s)
+		@chars = @hash.scan(CHARS_REGEX)
+		convert_hash
+		value
+	end
+
+	private
+	def convert_hash
+		chars = @chars.map { |p|
+			p[1]
+		}
+		chars.each_index { |i|
+			char = chars[i]
+			sqIndex = (i / 3).round
+			@square_array[i/3] = [] unless @square_array.member? sqIndex
+
+			if(i % 3 == 0) 
+				@square_array[i/3][0] = h_to_b char
+				@square_array[i/3][4] = h_to_b char
+			elsif(i % 3 == 1) 
+				@square_array[i/3][1] = h_to_b char
+				@square_array[i/3][3] = h_to_b char
+			else
+				@square_array[i/3][2] = h_to_b char
+			end
+		}
+		color = :a
+		0.upto(5) { color = chars.shift.to_sym }
+		@color = COLORS[color]
+	end
+
+	def h_to_b(value)
+		value.bytes.first % 2 == 0
+	end
+
+	public
+	# Process the specified data and generates the result
+	def generate_image
+		pImage = ChunkyPNG::Image.new(@image_size, @image_size, ChunkyPNG::Color::rgb(@background[0], @background[1], @background[2]))
+		@image = ChunkyPNG::Image.new(@size, @size, ChunkyPNG::Color::rgb(@background[0], @background[1], @background[2]))
+		@square_array.each_key { |lineKey|
+			lineValue = @square_array[lineKey]
+			lineValue.each_index { |colKey|
+				colValue = lineValue[colKey]
+				if(colValue)
+					pImage.rect(colKey * @pixel_ratio, lineKey * @pixel_ratio, (colKey + 1) * @pixel_ratio, (lineKey + 1) * @pixel_ratio, ChunkyPNG::Color::TRANSPARENT, ChunkyPNG::Color.rgb(@color[0], @color[1], @color[2]))
+				end
+			}
+		}
+		@image.compose!(pImage, @pixel_ratio / 2, @pixel_ratio / 2)
+	end
+
+	# Exports the result to a data:image format. 
+	def to_data_url
+		@image.to_data_url
+	end
+
+	# Exports the result to a file
+	# === Parameters
+	# * path	= Path where the image will be stored
+	def save(path)
+		@image.save(path)
+	end
+end

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification
+name: identicon
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Victor Gama
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-09-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: chunky_png
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.2.8
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.2.8
+description: A simple github-like identicons generator.
+email:
+- victor@insitelabs.com.br
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- LICENSE
+- README.md
+- identicon.gemspec
+- lib/identicon.rb
+homepage: http://github.com/victorgama/identicon
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.7
+signing_key: 
+specification_version: 4
+summary: A simple github-like identicons generator.
+test_files: []