ruby_identicon 0.0.2 → 0.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 3e4fd1ab15de4f9a58dcf8691a03577f61e2f518
-  data.tar.gz: 478b2838da314ef4ae34ff9f8424003f5c0abf4c
+SHA256:
+  metadata.gz: cb0fabb0aa8547bc68ad2295ada31bc45d38e11609fd8bf0f45bde706ba6b6de
+  data.tar.gz: 49e1497f2ea0e3ae061adea1a9a0528e673b20896afca0dfb8681d50d98eb5c7
 SHA512:
-  metadata.gz: 9a8eda4c940f78b7ef21095014f7af8a4d2004621567b5816518e9f49875418179297b9752a8ad12eaeffe14e313c414b66e40668700847b7e7f073a9b8f332d
-  data.tar.gz: 0ca17ebe08f25cb69a99a81321b35fd8110c72cab3c39cdd309b8dc0fc4a64c9625a9d1cc2045ff8640dabe038c31427f12a9c1bffb853d998ee6a26bdbbb292
+  metadata.gz: 1d5dfaf6300470cfed0ae46bc393623971f4ed7a80f47f27fef29c7b8a817e5e05195588a8c80041422bd172188edf0aeff9f2a6dc478dfdda5787788e6cb1c3
+  data.tar.gz: fb8004bd6ac01140ce0aa767b8b71fcb87f2573c0d29ad7cd5031992385bafde9a4ede116b958f09f355523bb570d8dc3cc8d9cddee087411b9c7690554580f8

data/.travis.yml

@@ -2,5 +2,9 @@ language: ruby
 rvm:
   - 1.9.3
   - 2.0.0
+  - 2.1.6
+  - 2.2.3
+before_install:
+  - gem install bundler
 notifications:
   email: false

data/Gemfile

@@ -1,5 +1,9 @@
 source 'https://rubygems.org'
 
+group :development do
+  gem 'yard'
+end
+
 group :test do
   gem 'coveralls', :require => false
 end

data/README.md

@@ -2,10 +2,9 @@
 
 [![Gem Version](https://badge.fury.io/rb/ruby_identicon.png)](http://badge.fury.io/rb/ruby_identicon)
 [![Build Status](https://api.travis-ci.org/chrisbranson/ruby_identicon.png?branch=master)](http://travis-ci.org/chrisbranson/ruby_identicon)
-[![Dependency Status](https://gemnasium.com/chrisbranson/ruby_identicon.png)](https://gemnasium.com/chrisbranson/ruby_identicon)
 [![Coverage Status](https://coveralls.io/repos/chrisbranson/ruby_identicon/badge.png)](https://coveralls.io/r/chrisbranson/ruby_identicon)
 
-![Example Identicon](https://dl.dropboxusercontent.com/u/176278/ruby_identicon.png)
+![Example Identicon](https://raw.githubusercontent.com/chrisbranson/ruby_identicon/master/example/ruby_identicon.png)
 
 A Ruby implementation of [go-identicon](https://github.com/dgryski/go-identicon) by Damian Gryski
 
@@ -30,34 +29,45 @@ Or install it yourself as:
 ## Usage
 
 Creating an identicon and saving to png
-
-    RubyIdenticon.create_and_save("RubyIdenticon", "ruby_identicon.png")
+```ruby
+RubyIdenticon.create_and_save("RubyIdenticon", "ruby_identicon.png")
+```
 
 Creating an identicon and returning a binary string
-
-    blob = RubyIdenticon.create("RubyIdenticon")
-  
-    # optional, save to a file
-    File.open("ruby_identicon.png", "wb") do |f| f.write(blob) end
+```ruby
+blob = RubyIdenticon.create("RubyIdenticon")
+
+# optional, save to a file
+File.open("ruby_identicon.png", "wb") do |f| f.write(blob) end
+```
+
+Creating an identicon and returns in base64 format
+```ruby
+base64_identicon = RubyIdenticon.create_base64("RubyIdenticon")
+```    
+nb// to render this in html pass the base64 code into your view
+```ruby  
+raw "<img src='data:image/png;base64,#{base64_identicon}'>"
+```
 
 ## Customising the identicon
 
 The identicon can be customised by passing additional options
 
-    background_color:  (Integer, default 0) the background color of the identicon in rgba notation (e.g. xffffffff for white)
+    background_color:  (Integer, default 0) the background color of the identicon in rgba notation (e.g. 0xffffffff for white)
     border_size:  (Integer, default 35) the size in pixels to leave as an empty border around the identicon image
     grid_size:    (Integer, default 7)  the number of rows and columns in the identicon, minimum 4, maximum 9
     square_size:  (Integer, default 50) the size in pixels of each square that makes up the identicon
     key:          (String) a 16 byte key used by siphash when calculating the hash value (see note below)
-  
+
     Varying the key ensures uniqueness of an identicon for a given title, it is assumed desirable for different applications
     to use a different key.
-  
-Example
-
-    blob = RubyIdenticon.create("identicons are great!", grid_size: 5, square_size: 70, background_color: 0xf0f0f0ff, key: "1234567890123456")
-    File.open("tmp/test_identicon.png", "wb") do |f| f.write(blob) end
 
+Example
+```ruby
+blob = RubyIdenticon.create("identicons are great!", grid_size: 5, square_size: 70, background_color: 0xf0f0f0ff, key: "1234567890123456")
+File.open("tmp/test_identicon.png", "wb") do |f| f.write(blob) end
+ ```
 ## Contributing
 
 1. Fork it

data/lib/ruby_identicon.rb

@@ -25,6 +25,11 @@
 # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 #++
 
+require 'ruby_identicon/version'
+require 'chunky_png'
+require 'siphash'
+require 'base64'
+
 #
 # A Ruby implementation of go-identicon
 #
@@ -40,13 +45,8 @@
 # The grid and square sizes can be varied to create identicons of
 # differing size.
 #
-
-require "ruby_identicon/version"
-require "chunky_png"
-require "siphash"
-
 module RubyIdenticon
-  # the default paramters used when creating identicons
+  # the default options used when creating identicons
   #
   # background_color: (Integer, default 0) the background color of the identicon in rgba notation (e.g. xffffffff for white)
   # border_size:      (Integer, default 35) the size in pixels to leave as an empty border around the identicon image
@@ -57,8 +57,7 @@ module RubyIdenticon
   # varying the key ensures uniqueness of an identicon for a given title, it is assumed desirable for different applications
   # to use a different key.
   #
-
-  DEFAULT_PARAMETERS = {
+  DEFAULT_OPTIONS = {
     border_size: 35,
     square_size: 50,
     grid_size: 7,
@@ -69,41 +68,39 @@ module RubyIdenticon
   # create an identicon png and save it to the given filename
   #
   # Example:
-  #   >> RubyIdenticon.create_and_save("identicons are great!", "test_identicon.png")
+  #   >> RubyIdenticon.create_and_save('identicons are great!', 'test_identicon.png')
   #   => result (Boolean)
   #
-  # Arguments:
-  #   title: (String)
-  #   filename: (String)
-  #   options: (Hash)
-
+  # @param title [string] the string value to be represented as an identicon
+  # @param filename [string] the full path and filename to save the identicon png to
+  # @param options [hash] additional options for the identicon
+  #
   def self.create_and_save(title, filename, options = {})
-    raise "filename cannot be nil" if filename == nil
+    raise 'filename cannot be nil' if filename == nil
 
     blob = create(title, options)
     return false if blob == nil
 
-    File.open(filename, "wb") do |f| f.write(blob) end
+    File.open(filename, 'wb') { |f| f.write(blob) }
   end
 
   # create an identicon png and return it as a binary string
   #
   # Example:
-  #   >> RubyIdenticon.create("identicons are great!")
+  #   >> RubyIdenticon.create('identicons are great!')
   #   => binary blob (String)
   #
-  # Arguments:
-  #   title: (String)
-  #   options: (Hash)
-
+  # @param title [string] the string value to be represented as an identicon
+  # @param options [hash] additional options for the identicon
+  #
   def self.create(title, options = {})
-    options = DEFAULT_PARAMETERS.merge(options)
-    
-    raise "title cannot be nil" if title == nil
-    raise "key is nil or less than 16 bytes" if options[:key] == nil || options[:key].length < 16
-    raise "grid_size must be between 4 and 9" if options[:grid_size] < 4 || options[:grid_size] > 9
-    raise "invalid border size" if options[:border_size] < 0
-    raise "invalid square size" if options[:square_size] < 0
+    options = DEFAULT_OPTIONS.merge(options)
+
+    raise 'title cannot be nil' if title == nil
+    raise 'key is nil or less than 16 bytes' if options[:key] == nil || options[:key].length < 16
+    raise 'grid_size must be between 4 and 9' if options[:grid_size] < 4 || options[:grid_size] > 9
+    raise 'invalid border size' if options[:border_size] < 0
+    raise 'invalid square size' if options[:square_size] < 0
 
     hash = SipHash.digest(options[:key], title)
 
@@ -117,17 +114,17 @@ module RubyIdenticon
     hash >>= 24
 
     sqx = sqy = 0
-    for i in 0..(options[:grid_size] * ((options[:grid_size]+1) / 2))
+    (options[:grid_size] * ((options[:grid_size] + 1) / 2)).times do
       if hash & 1 == 1
         x = options[:border_size] + (sqx * options[:square_size])
         y = options[:border_size] + (sqy * options[:square_size])
 
         # left hand side
-        png.rect(x, y, x + options[:square_size], y + options[:square_size], color, color)
+        png.rect(x, y, x + options[:square_size] - 1, y + options[:square_size] - 1, color, color)
 
         # mirror right hand side
         x = options[:border_size] + ((options[:grid_size] - 1 - sqx) * options[:square_size])
-        png.rect(x, y, x + options[:square_size], y + options[:square_size], color, color)
+        png.rect(x, y, x + options[:square_size] - 1, y + options[:square_size] - 1, color, color)
       end
 
       hash >>= 1
@@ -138,6 +135,10 @@ module RubyIdenticon
       end
     end
 
-    png.to_blob :color_mode => ChunkyPNG::COLOR_INDEXED
+    png.to_blob color_mode: ChunkyPNG::COLOR_INDEXED
+  end
+
+  def self.create_base64(title, options = {})
+    Base64.encode64(self.create(title, options)).force_encoding('UTF-8')
   end
 end

data/lib/ruby_identicon/version.rb

@@ -1,3 +1,3 @@
 module RubyIdenticon
-  VERSION = "0.0.2"
+  VERSION = '0.0.6'
 end

data/lib/siphash.rb

@@ -8,10 +8,10 @@
 # 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
@@ -22,14 +22,13 @@
 #++
 
 module SipHash
-
   def self.digest(key, msg)
     s = State.new(key)
     len = msg.size
     iter = len / 8
 
     iter.times do |i|
-      m = msg.slice(i * 8, 8).unpack("Q<")[0]
+      m = msg.slice(i * 8, 8).unpack('Q<')[0]
       s.apply_block(m)
     end
 
@@ -44,7 +43,7 @@ module SipHash
 
   def self.last_block(msg, len, iter)
     last = (len << 56) & State::MASK_64;
-      
+
     r = len % 8
     off = iter * 8
 
@@ -59,7 +58,7 @@ module SipHash
   end
 
   class State
-    
+
     MASK_64 = 0xffffffffffffffff
 
     def initialize(key)
@@ -68,8 +67,8 @@ module SipHash
       @v2 = 0x6c7967656e657261
       @v3 = 0x7465646279746573
 
-      k0 = key.slice(0, 8).unpack("Q<")[0]
-      k1 = key.slice(8, 8).unpack("Q<")[0]
+      k0 = key.slice(0, 8).unpack('Q<')[0]
+      k1 = key.slice(8, 8).unpack('Q<')[0]
 
       @v0 ^= k0
       @v1 ^= k1
@@ -89,7 +88,7 @@ module SipHash
 
     def compress
       @v0 = (@v0 + @v1) & MASK_64
-      @v2 = (@v2 + @v3) & MASK_64 
+      @v2 = (@v2 + @v3) & MASK_64
       @v1 = rotl64(@v1, 13)
       @v3 = rotl64(@v3, 16)
       @v1 ^= @v0
@@ -112,6 +111,5 @@ module SipHash
     def digest
       @v0 ^ @v1 ^ @v2 ^ @v3
     end
-
   end
 end

data/ruby_identicon.gemspec

@@ -8,7 +8,7 @@ Gem::Specification.new do |spec|
   spec.version       = RubyIdenticon::VERSION
   spec.authors       = ["Chris Branson"]
   spec.email         = ["branson.chris@gmail.com"]
-  
+
   spec.description   = <<-EOT
     A Ruby implementation of go-identicon by Damian Gryski
 
@@ -31,9 +31,10 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "bundler", ">= 2.2.10"
   spec.add_development_dependency "rake"
-  spec.add_development_dependency "rspec", "~> 2.6"
+  spec.add_development_dependency "rspec", "~> 3.10.0"
+  spec.add_development_dependency "yard", ">= 0.9.20"
 
-  spec.add_dependency "chunky_png", "~> 1.2.8"
+  spec.add_dependency "chunky_png", "~> 1.4.0"
 end

data/ruby_identicon.rb

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "ruby_identicon.rb"
+
+abort "Please run with a filename as an argument" unless ARGV[0]
+filename = ARGV[0].clone
+ARGV.clear
+
+print "Reading standard input to generate identicon...\n"
+
+identstring = gets
+
+blob = RubyIdenticon.create(identstring, grid_size: 5, square_size: 70, background_color: 0xf0f0f0ff, key: "1234567890123456")
+File.open(filename, "wb") do |f| f.write(blob) end

data/spec/ruby_identicon_spec.rb

@@ -2,68 +2,74 @@ require 'helper'
 
 describe RubyIdenticon do
   before(:each) do
-    Dir.mkdir("tmp") unless File.directory?("tmp")
+    Dir.mkdir('tmp') unless File.directory?('tmp')
   end
 
-  it "creates a binary string image blob" do
-    expect(RubyIdenticon.create("RubyIdenticon")).to be_a_kind_of(String)  
+  # general parameter tests
+  it 'creates a binary string image blob' do
+    expect(RubyIdenticon.create('RubyIdenticon')).to be_a_kind_of(String)
   end
 
-  it "does not create a binary string image blob with an invalid title" do
-    lambda { RubyIdenticon.create(nil) }.should raise_exception("title cannot be nil")
+  it 'does not create a binary string image blob with an invalid title' do
+    lambda { RubyIdenticon.create(nil) }.should raise_exception('title cannot be nil')
   end
 
-  it "does not create a binary string image blob with an invalid key" do
-    lambda { RubyIdenticon.create("identicons are great!", key: "\x00\x11\x22\x33\x44") }.should raise_exception("key is nil or less than 16 bytes")
+  it 'does not create a binary string image blob with an invalid key' do
+    lambda { RubyIdenticon.create('identicons are great!', key: "\x00\x11\x22\x33\x44") }.should raise_exception('key is nil or less than 16 bytes')
   end
 
-  it "does not create a binary string image blob with an invalid grid size" do
-    lambda { RubyIdenticon.create("RubyIdenticon", grid_size: 2) }.should raise_exception("grid_size must be between 4 and 9")
-    lambda { RubyIdenticon.create("RubyIdenticon", grid_size: 20) }.should raise_exception("grid_size must be between 4 and 9")
+  it 'does not create a binary string image blob with an invalid grid size' do
+    lambda { RubyIdenticon.create('RubyIdenticon', grid_size: 2) }.should raise_exception('grid_size must be between 4 and 9')
+    lambda { RubyIdenticon.create('RubyIdenticon', grid_size: 20) }.should raise_exception('grid_size must be between 4 and 9')
   end
 
-  it "does not create a binary string image blob with an invalid square_size size" do
-    lambda { RubyIdenticon.create("RubyIdenticon", square_size: -2) }.should raise_exception("invalid square size")
+  it 'does not create a binary string image blob with an invalid square_size size' do
+    lambda { RubyIdenticon.create('RubyIdenticon', square_size: -2) }.should raise_exception('invalid square size')
   end
 
-  it "does not create a binary string image blob with an invalid border_size size" do
-    lambda { RubyIdenticon.create("RubyIdenticon", border_size: -2) }.should raise_exception("invalid border size")
+  it 'does not create a binary string image blob with an invalid border_size size' do
+    lambda { RubyIdenticon.create('RubyIdenticon', border_size: -2) }.should raise_exception('invalid border size')
   end
 
-
-
-  it "creates a png image file" do
-    blob = RubyIdenticon.create("RubyIdenticon")
-    result = File.open("tmp/ruby_identicon.png", "wb") do |f| f.write(blob) end
-    expect(result).to be_true
+  # blob creation tests
+  it 'creates a png image file' do
+    blob = RubyIdenticon.create('RubyIdenticon')
+    result = File.open('tmp/ruby_identicon.png', 'wb') { |f| f.write(blob) }
+    expect(result).to be_truthy
   end
 
-  it "creates a png image file of grid size 5, square size 70 and grey background" do
-    blob = RubyIdenticon.create("RubyIdenticon", grid_size: 5, square_size: 70, background_color: 0xf0f0f0ff, key: "1234567890123456")
-    result = File.open("tmp/ruby_identicon_gs5_white.png", "wb") do |f| f.write(blob) end
-    expect(result).to be_true
+  it 'creates a png image file of grid size 5, square size 70 and grey background' do
+    blob = RubyIdenticon.create('RubyIdenticon', grid_size: 5, square_size: 70, background_color: 0xf0f0f0ff, key: '1234567890123456')
+    result = File.open('tmp/ruby_identicon_gs5_white.png', 'wb') { |f| f.write(blob) }
+    expect(result).to be_truthy
   end
 
-  it "creates 10 png image files" do
+  it 'creates 10 png image files' do
     10.times do |count|
       blob = RubyIdenticon.create("RubyIdenticon_#{count}")
-      result = File.open("tmp/ruby_identicon_#{count}.png", "wb") do |f| f.write(blob) end
-      expect(result).to be_true
+      result = File.open("tmp/ruby_identicon_#{count}.png", 'wb') { |f| f.write(blob) }
+      expect(result).to be_truthy
     end
   end
 
+  # file creation tests
+  it 'creates a png image file via create_and_save' do
+    result = RubyIdenticon.create_and_save('RubyIdenticon is fun', 'tmp/test_identicon.png')
+    expect(result).to be_truthy
+  end
 
-
-  it "creates a png image file via create_and_save" do
-    result = RubyIdenticon.create_and_save("RubyIdenticon is fun", "tmp/test_identicon.png")
-    expect(result).to be_true
+  it 'does not create a png image file via create_and_save with an invalid filename' do
+    lambda { RubyIdenticon.create_and_save('RubyIdenticon is fun', nil) }.should raise_exception('filename cannot be nil')
   end
 
-  it "does not create a png image file via create_and_save with an invalid filename" do
-    lambda { RubyIdenticon.create_and_save("RubyIdenticon is fun", nil) }.should raise_exception("filename cannot be nil")
+  it 'does not create a png image file via create_and_save with an invalid title' do
+    lambda { RubyIdenticon.create_and_save(nil, 'tmp/test_identicon.png') }.should raise_exception('title cannot be nil')
   end
 
-  it "does not create a png image file via create_and_save with an invalid title" do
-    lambda { RubyIdenticon.create_and_save(nil, "tmp/test_identicon.png") }.should raise_exception("title cannot be nil")
+  # Base64 creation tests
+  it 'creates base64 version of the image' do
+    blob = RubyIdenticon.create('RubyIdenticon')
+    base64 = RubyIdenticon.create_base64('RubyIdenticon')
+    expect(Base64.decode64(base64)).to eq blob
   end
 end

metadata

@@ -1,29 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: ruby_identicon
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.6
 platform: ruby
 authors:
 - Chris Branson
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2014-02-17 00:00:00.000000000 Z
+date: 2021-08-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: 2.2.10
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: 2.2.10
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -44,28 +44,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.6'
+        version: 3.10.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.6'
+        version: 3.10.0
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.20
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.20
 - !ruby/object:Gem::Dependency
   name: chunky_png
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.2.8
+        version: 1.4.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.2.8
+        version: 1.4.0
 description: |2
       A Ruby implementation of go-identicon by Damian Gryski
 
@@ -89,17 +103,19 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- example/ruby_identicon.png
 - lib/ruby_identicon.rb
 - lib/ruby_identicon/version.rb
 - lib/siphash.rb
 - ruby_identicon.gemspec
+- ruby_identicon.rb
 - spec/helper.rb
 - spec/ruby_identicon_spec.rb
 homepage: ''
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -114,9 +130,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.2.0
-signing_key: 
+rubygems_version: 3.2.15
+signing_key:
 specification_version: 4
 summary: A Ruby Gem for creating GitHub like identicons
 test_files: