vishnu 1.2.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f6982dc66f9e649a14ff319acef50fd6807ab767
+  data.tar.gz: 84be13069a4e230c0b406a77de2e51dd53c8edaa
+SHA512:
+  metadata.gz: 2e4c09569e39cec6492d69c1c0354e3cd6f52977d008f321daa404ad3d08238addb9af7cfb2c2768320b2dd23cb66979dc030d5832b67c5ef76fd762d17c9896
+  data.tar.gz: dad9a5b0b60fd395a52f9ae094819a49c9e3aa075e766ad76d45affd6f8aae7844a8dafc08b28dd21089c57b765b217832b6d128f434a1220cefabec6daad8e5

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 = "vishnu"
+  gem.homepage = "http://github.com/sandfoxme/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 = "sandfox@sandfox.me"
+  gem.authors = ['Anton Smirnov', "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 = "vishnu #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+1.2.1

data/lib/libravatar.rb

@@ -0,0 +1,3 @@
+require 'vishnu'
+
+class Libravatar < Vishnu; end

data/lib/vishnu.rb

@@ -0,0 +1,128 @@
+#
+# 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
+# Contributors:: https://github.com/gugod/libravatar/contributors
+#
+
+require 'digest/md5'
+require 'digest/sha2'
+require 'uri'
+require 'resolv'
+
+class Vishnu
+  attr_accessor :email, :openid, :size, :default, :https
+
+  # 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.
+  # - :https Set to true to serve avatars over SSL
+  # - :default URL to redirect missing avatars to, or one of these specials: "404", "mm", "identicon", "monsterid", "wavatar", "retro"
+  #
+  def initialize(options = {})
+    @email   = options[:email]
+    @openid  = options[:openid]
+    @size    = options[:size]
+    @default = options[:default]
+    @https   = options[:https]
+  end
+
+  def get_target_domain
+    return @email.split('@')[1] if @email
+    return URI.parse(@openid).host
+  end
+
+  # All the values which are different between HTTP and HTTPS methods.
+  @@profiles = [
+    { :scheme => 'http://',
+      :host => 'cdn.libravatar.org',
+      :srv => '_avatars._tcp.',
+      :port => 80 },
+    { :scheme => 'https://',
+      :host => 'seccdn.libravatar.org',
+      :srv => '_avatars-sec._tcp.',
+      :port => 443 }
+    ]
+
+  # Grab the DNS SRV records associated with the target domain,
+  # and choose one according to RFC2782.
+  def srv_lookup
+    profile = @@profiles[ @https ? 1 : 0 ]
+    Resolv::DNS::open do |dns|
+      rrs = dns.getresources(profile[:srv] + get_target_domain(),
+        Resolv::DNS::Resource::IN::SRV).to_a
+      return [nil, nil] unless rrs.any?
+
+
+      min_priority = rrs.map{ |r| r.priority }.min
+      rrs.delete_if{ |r| r.priority != min_priority }
+
+      weight_sum = rrs.inject(0) { |a,r| a+r.weight }.to_f
+
+      r = rrs.max_by { |r| r.weight == 0 ? 0 : rand ** (weight_sum / r.weight) }
+
+      return [r.target, r.port]
+    end
+  end
+
+  def get_base_url
+    profile = @@profiles[ @https ? 1 : 0 ]
+    target, port = srv_lookup
+
+    if (target && port) 
+      port_fragment = port != profile[:port] ? ':' + port.to_s : ''
+      return profile[:scheme] + target.to_s + port_fragment
+    else
+      return profile[:scheme] + profile[:host]
+    end
+  end
+
+  # Generate the libravatar URL
+  def to_s
+    if @email
+      @email.downcase!
+      id = Digest::MD5.hexdigest(@email)
+    else
+      id = Digest::SHA2.hexdigest(normalize_openid(@openid))
+    end
+    s  = @size ? "s=#{@size}" : nil
+    d  = @default ? "d=#{@default}" : nil
+
+    query = [s,d].reject{|x|!x}.join("&")
+    query = "?#{query}" unless query == ""
+    baseurl = get_base_url() + '/avatar/'
+    return baseurl + id + query
+  end
+
+  private
+
+  def sanitize_srv_lookup(hostname, port)
+    unless hostname.match(/^[0-9a-zA-Z\-.]+$/) && 1 <= port && port <= 65535
+      return [nil, nil]
+    end
+
+    return [hostname, port]
+  end
+
+  # 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/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,51 @@
+require 'helper'
+
+class TestLibravatar < Test::Unit::TestCase
+  should "Generate url from email" do
+    # echo -n "user@example.com"|md5sum
+    # => b58996c504c5638798eb6b511e6f49af
+    avatar = Libravatar.new(:email => "user@example.com")
+    assert_equal avatar.to_s, "http://cdn.libravatar.org/avatar/b58996c504c5638798eb6b511e6f49af"
+
+    assert_equal Libravatar.new(:email => "USER@ExAmPlE.CoM").to_s, "http://cdn.libravatar.org/avatar/b58996c504c5638798eb6b511e6f49af"
+
+    assert_equal Libravatar.new(:email => "user@example.com", :https => true).to_s, "https://seccdn.libravatar.org/avatar/b58996c504c5638798eb6b511e6f49af"
+
+    assert_equal Libravatar.new(:email => "user@example.com", :https => false).to_s, "http://cdn.libravatar.org/avatar/b58996c504c5638798eb6b511e6f49af"
+
+    assert_equal Libravatar.new(:email => "USER@ExAmPlE.CoM", :default => "http://example.com/avatar.png").to_s, "http://cdn.libravatar.org/avatar/b58996c504c5638798eb6b511e6f49af?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/b58996c504c5638798eb6b511e6f49af?s=512&d=mm"
+  end
+
+  should "Generate url from openid" do
+    # echo -n "http://example.com/id/Bob"|shasum -a 256
+    # => 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")
+    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
+
+  should "Return the federated URI" do
+    avatar = Libravatar.new(:email => 'invalid@catalyst.net.nz')
+    assert_equal avatar.to_s, 'http://static.avatars.catalyst.net.nz/avatar/f924d1e9f2c10ee9efa7acdd16484c2f'
+  end
+
+  should "Sanitize the SRV lookup result" do
+    avatar = Libravatar.new
+    assert_equal ["hosntame.abcde.fghi.com", 12345], avatar.send(:sanitize_srv_lookup, "hosntame.abcde.fghi.com", 12345)
+    assert_equal [nil, nil], avatar.send(:sanitize_srv_lookup, "FNORD IMPUNTK *#(*$#&", 65348283)
+  end
+end

data/vishnu.gemspec

@@ -0,0 +1,50 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+# stub: vishnu 1.2.1 ruby lib
+
+Gem::Specification.new do |s|
+  s.name = "vishnu"
+  s.version = "1.2.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib"]
+  s.authors = ["Anton Smirnov", "Kang-min Liu"]
+  s.date = "2016-03-25"
+  s.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"
+  s.email = "sandfox@sandfox.me"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "lib/libravatar.rb",
+    "lib/vishnu.rb",
+    "libravatar.gemspec",
+    "test/helper.rb",
+    "test/test_libravatar.rb"
+  ]
+  s.homepage = "http://github.com/sandfoxme/libravatar"
+  s.licenses = ["MIT"]
+  s.rubygems_version = "2.4.8"
+  s.summary = "Avatar URL Generation wih libravatar.org"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    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
+

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification
+name: vishnu
+version: !ruby/object:Gem::Version
+  version: 1.2.1
+platform: ruby
+authors:
+- Anton Smirnov
+- Kang-min Liu
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-03-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: shoulda
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>'
+      - !ruby/object:Gem::Version
+        version: 1.2.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>'
+      - !ruby/object:Gem::Version
+        version: 1.2.3
+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: sandfox@sandfox.me
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .document
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/libravatar.rb
+- lib/vishnu.rb
+- test/helper.rb
+- test/test_libravatar.rb
+- vishnu.gemspec
+homepage: http://github.com/sandfoxme/libravatar
+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.4.8
+signing_key: 
+specification_version: 4
+summary: Avatar URL Generation wih libravatar.org
+test_files: []