libravatar 1.0.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/LICENSE.txt

@@ -0,0 +1,22 @@
+The MIT License
+
+Copyright (c) 2011 Kang-min Liu
+
+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.rdoc

@@ -0,0 +1,20 @@
+= libravatar
+
+http://libravatar.org is an avatar service to let their users associate avatar images
+with their emails or openids. This rubygem generates their avatar URL.
+
+== Contributing to libravatar
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Kang-min Liu. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,46 @@
+require 'rubygems'
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "libravatar"
+  gem.homepage = "http://github.com/gugod/libravatar"
+  gem.license = "MIT"
+  gem.summary = %Q{Avatar URL Generation wih libravatar.org}
+  gem.description = %Q{libravatar.org provides avatar image hosting (like gravatar.com). Their users may associate avatar images with email or openid. This rubygem can be used to generate libravatar avatar image URL}
+  gem.email = "gugod@gugod.org"
+  gem.authors = ["Kang-min Liu"]
+  # Include your dependencies below. Runtime dependencies are required when using your gem,
+  # and development dependencies are only needed for development (ie running rake tasks, tests, etc)
+  # gem.add_runtime_dependency 'digest/sha2', '> 0.1'
+  # gem.add_runtime_dependency 'uri', '> 0.1'
+  gem.add_development_dependency 'shoulda', '> 1.2.3'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+require 'rcov/rcovtask'
+Rcov::RcovTask.new do |test|
+  test.libs << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "libravatar #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/lib/libravatar.rb

@@ -0,0 +1,59 @@
+#
+# The Libravatar class generates the avatar URL provided by the libravatar
+# web service at http://www.libravatar.org
+#
+# Users may associate their avatar images with multiple OpenIDs and Emails.
+#  
+# Author:: Kang-min Liu (http://gugod.org)
+# Copyright:: Copyright (c) 2011 Kang-min Liu
+# License:: MIT
+#
+
+require 'digest/sha2'
+require 'uri'
+
+class Libravatar
+  attr_accessor :email, :openid, :size, :default
+
+  # The options should contain :email or :openid values.  If both are
+  # given, email will be used. The value of openid and email will be
+  # normalized by the rule described in http://www.libravatar.org/api
+  #
+  # List of option keys:
+  #
+  # - :email
+  # - :openid
+  # - :size An integer ranged 1 - 512, default is 80.
+  #
+  def initialize(options = {})
+    @email   = options[:email]
+    @openid  = options[:openid]
+    @size    = options[:size]
+    @default = options[:default]
+  end
+
+  # Generate the libravatar URL
+  def to_s
+    @email.downcase! if @email
+    id = Digest::SHA2.hexdigest(@email || normalize_openid(@openid))
+    s  = @size ? "s=#{@size}" : nil
+    d  = @default ? "d=#{@default}" : nil
+
+    query = [s,d].reject{|x|!x}.join("&")
+    query = "?#{query}" unless query == ""
+    return "http://cdn.libravatar.org/avatar/" + id + query
+  end
+
+  private
+
+  # Normalize an openid URL following the description on libravatar.org
+  def normalize_openid(s)
+    x = URI.parse(s)
+    x.host.downcase!
+    x.scheme = x.scheme.downcase
+    if (x.path == "" && x.fragment == nil)
+      x.path = "/"
+    end
+    return x.to_s
+  end
+end

data/libravatar.gemspec

@@ -0,0 +1,52 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{libravatar}
+  s.version = "1.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Kang-min Liu"]
+  s.date = %q{2011-04-15}
+  s.description = %q{libravatar.org provides avatar image hosting (like gravatar.com). Their users may associate avatar images with email or openid. This rubygem can be used to generate libravatar avatar image URL}
+  s.email = %q{gugod@gugod.org}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "lib/libravatar.rb",
+    "libravatar.gemspec",
+    "test/helper.rb",
+    "test/test_libravatar.rb"
+  ]
+  s.homepage = %q{http://github.com/gugod/libravatar}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.6.1}
+  s.summary = %q{Avatar URL Generation wih libravatar.org}
+  s.test_files = [
+    "test/helper.rb",
+    "test/test_libravatar.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<shoulda>, ["> 1.2.3"])
+    else
+      s.add_dependency(%q<shoulda>, ["> 1.2.3"])
+    end
+  else
+    s.add_dependency(%q<shoulda>, ["> 1.2.3"])
+  end
+end
+

data/test/helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'libravatar'
+
+class Test::Unit::TestCase
+end

data/test/test_libravatar.rb

@@ -0,0 +1,34 @@
+require 'helper'
+
+class TestLibravatar < Test::Unit::TestCase
+  should "Generate url from email" do
+    # echo -n "user@example.com"|shasum -a 256
+    # => b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514
+    avatar = Libravatar.new(:email => "user@example.com")
+    assert_equal avatar.to_s, "http://cdn.libravatar.org/avatar/b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514"
+
+    assert_equal Libravatar.new(:email => "USER@ExAmPlE.CoM").to_s, "http://cdn.libravatar.org/avatar/b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514"
+
+    assert_equal Libravatar.new(:email => "USER@ExAmPlE.CoM", :default => "http://example.com/avatar.png").to_s, "http://cdn.libravatar.org/avatar/b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514?d=http://example.com/avatar.png"
+
+    assert_equal Libravatar.new(:email => "USER@ExAmPlE.CoM", :size => 512, :default => "mm").to_s, "http://cdn.libravatar.org/avatar/b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514?s=512&d=mm"
+  end
+
+  should "Generate url from openid" do
+    avatar = Libravatar.new(:openid => "http://example.com/id/Bob")
+    assert_equal avatar.to_s, "http://cdn.libravatar.org/avatar/80cd0679bb52beac4d5d388c163016dbc5d3f30c262a4f539564236ca9d49ccd"
+
+    avatar = Libravatar.new(:openid => "hTTp://EXAMPLE.COM/id/Bob")
+    assert_equal avatar.to_s, "http://cdn.libravatar.org/avatar/80cd0679bb52beac4d5d388c163016dbc5d3f30c262a4f539564236ca9d49ccd"
+
+    avatar = Libravatar.new(:openid => "hTTp://EXAMPLE.COM/id/Bob", :size => 512)
+    assert_equal avatar.to_s, "http://cdn.libravatar.org/avatar/80cd0679bb52beac4d5d388c163016dbc5d3f30c262a4f539564236ca9d49ccd?s=512"
+  end
+
+  should "Normalize OpenID" do
+    x = Libravatar.new
+    assert_equal x.send(:normalize_openid, "HTTP://EXAMPLE.COM/id/Bob"), "http://example.com/id/Bob"
+
+    assert_equal x.send(:normalize_openid, "HTTP://EXAMPLE.COM"), "http://example.com/"
+  end
+end

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification 
+name: libravatar
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: 
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Kang-min Liu
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-04-15 00:00:00 +08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: shoulda
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">"
+      - !ruby/object:Gem::Version 
+        hash: 25
+        segments: 
+        - 1
+        - 2
+        - 3
+        version: 1.2.3
+  type: :development
+  version_requirements: *id001
+description: libravatar.org provides avatar image hosting (like gravatar.com). Their users may associate avatar images with email or openid. This rubygem can be used to generate libravatar avatar image URL
+email: gugod@gugod.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.rdoc
+files: 
+- .document
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/libravatar.rb
+- libravatar.gemspec
+- test/helper.rb
+- test/test_libravatar.rb
+has_rdoc: true
+homepage: http://github.com/gugod/libravatar
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.6.1
+signing_key: 
+specification_version: 3
+summary: Avatar URL Generation wih libravatar.org
+test_files: 
+- test/helper.rb
+- test/test_libravatar.rb