gravatar_profile 1.0

data/CHANGELOG.rdoc

@@ -0,0 +1,2 @@
+=== 0.1 / 2010-11-29
++ Initial release

data/README.rdoc

@@ -0,0 +1,45 @@
+= Author
+Veerasundaravel Thirugnanasundaram <veerasundaravel@gmail.cm>
+http://veerasundaravel.wordpress.com
+
+= Synopsis
+gravatar_profile is a Ruby Wrapper for getting GRAVATAR[http://gravatar.com] avatars and profile informations.
+
+By passing the user email you can get the gravatar image, gravatar profile url and as well as profile informations also.
+
+
+= Usage
+Using the GravatarProfile library is fairly simple and straight-forward.  The base
+class most of you will be using is the GravatarProfile class.
+
+=== Installation
+sudo gem install gravatar_profile
+
+===Getting Gravatar image
+
+gravatar = GravatarProfile.new("your-email-address")
+gp.gravatar_url
+>> "http://gravatar.com/avatar/6fa14cea01672568042121f81c33d5fbb.png"
+
+
+=== Getting Gravatar Profile Url
+
+gp = GravatarProfile.new("your-email-address"")
+gp.gravatar_profile_url
+>> "http://gravatar.com/6fa14cea01672568042121f81c33d5fbb"
+
+gp = GravatarProfile.new("your-email-address"")
+gp.gravatar_profile_url(:filetype => :xml)
+>> "http://gravatar.com/6fa14cea01672568042121f81c33d5fbb"
+
+
+=== Accessing profile informations
+
+gp = GravatarProfile.new("some-email-address")
+
+#For now we are supporting only the XML format profile details
+gp.get_profile_info({:filetype => :xml}) 
+
+#If your server need to use proxyy means specify the proxy details as follows.
+gp.get_profile_info({:proxy_host => 'www.some-proxy.com', :proxy_port=>8000, :filetype => :xml})
+>> {"name"=>[{"givenName"=>["User-GivenName"], "familyName"=>["FamilyName"], "formatted"=>["User-GivenName Lastname"]}], "requestHash"=>["6fa14cea067256804121f81c33d5fbb"], "preferredUsername"=>["user-givenname"], "displayName"=>["user-givenname"], "thumbnailUrl"=>["http://2.gravatar.com/avatar/6fadss14cea0167256804121f81c3d5fbb"], "hash"=>["6fadss14cea0167256804121f81c33d5fbb"], "urls"=>[{"value"=>["http://in.linkedin.com/pub/abced/8/11b/15"]}, {"title"=>["Ruby on Rails Weblog"], "value"=["http://user-givenname.wordpress.com"]}, {"title"=>["Twitter Account"], "value"=>["http://twitter.com/user-givenname"]}], "ims"=>[{"type"=>["yahoo"], "value"=>["some-name2003"]} {"type"=>["gtalk"], "value"=>["some-name2003"]}, {"type"=>["skype"], "value"=>["user-givenname"]}], "emails"=>[{"primary"=>["true"], "value"=>["some-name2003@gmail.com"]}], "photos">[{"type"=>["thumbnail"], "value"=>["http://2.gravatar.com/avatar/6fadss14cea0167256804121f81c33d5fbb"]}, {"value"=>["http://2.gravatar.com/userimage/5146707/c647651ea2579f4900cc05f766a3b23"]}], "id"=>["5146707"], "accounts"=>[{"shortname"=>["facebook"], "url"=>["http://www.facebook.com/profile.php?id=5523354779"], "username"=>["facebook.com"], "domain"=>[facebook.com"], "display"=>["facebook.com"], "verified"=>["true"]}, {"shortname"=>["linkedin"], "url"=>["http://www.linkedin.com/in/user-givenname"], "username"=>["usernameel"], "domain"=>["linkedin.com"], "display"=>["user-givenname"], "verified"=>["true"]}, {"shortname"=>["twitter"], "url"=>["http://twitter.com/user-givenname"], "username"=>["eerasundaravel"], "domain"=>["twitter.com"], "display"=>["@user-givenname"], "verified"=>["true"]}, {"shortname"=>["wordpress"], "url"=>["http://user-givenname.wordpress.com/", "username"=>["user-givenname.wordpress.com"], "domain"=>["user-givenname.wordpress.com"], "display"=>["user-givenname.wordpress.com"], "verified"=>["true"]}], "currentLocaton"=>["Location1, Country"], "aboutMe"=>["About me text goes here"], "phoneNumbers"=>[{"type"=>["mobile"], "value"=>["9894873774"]}], "profileUrl"=>["http://gravatar.com/user-givenname"]}

data/gravatar_profile.gemspec

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{gravatar_profile}
+  s.version = "1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Veerasundaravel Thirugnanasundaram"]
+  s.date = %q{2010-11-29}
+  s.description = %q{gravatar_profile is a Ruby Wrapper for getting GRAVATAR[http://gravatar.com] avatars and profile informations.}
+  s.email = ["veerasundaravel@gmail.com"]
+  s.extra_rdoc_files = ["CHANGELOG.rdoc", "README.rdoc", ]
+  s.files = ["CHANGELOG.rdoc", "README.rdoc", "gravatar_profile.gemspec", "lib/gravatar_profile.rb"]
+  s.homepage = %q{http://veerasundaravel.wordpress.com}
+  s.rdoc_options = ["--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{gravatar_profile}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{gravatar_profile is a Ruby Wrapper for getting GRAVATAR[http://gravatar.com] avatars and profile informations. by Veerasundaravel Thirugnanasundaram}
+  s.test_files = []
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 1
+    s.add_development_dependency(%q<xml-simple>, [">= 1.0.0"])
+  else
+    s.add_dependency(%q<xml-simple>, [">= 1.0.0"])
+  end
+end

data/lib/gravatar_profile.rb

@@ -0,0 +1,96 @@
+require 'digest/md5'
+require 'net/http'
+require 'uri'
+require 'xmlsimple'
+
+class GravatarProfile
+  DefaultOptions =   {
+      :rating => 'PG',
+      :secure => false,
+      :filetype => :png,
+      :size => 80
+  }
+  
+  def gravatar_abbreviations
+  { :size => 's',
+    :default => 'd',
+    :rating => 'r'
+  }
+  end
+  
+  
+  attr_accessor :email, :id
+  
+  def initialize(email = '', options = {})
+    
+    @email = email
+    @id = gravatar_id
+    
+  end
+  
+  def gravatar_id
+      Digest::MD5.hexdigest(email.to_s.downcase)
+  end
+  
+  # Constructs the full Gravatar url.
+  def gravatar_url(options={})
+    options = GravatarProfile::DefaultOptions.merge(options)
+    gravatar_hostname(options.delete(:secure)) +
+      gravatar_filename(options.delete(:filetype)) +
+      url_params_from_hash(options)
+  end
+    
+  # Constructs the full Gravatar url.
+  def gravatar_profile_url(options={})
+    options = GravatarProfile::DefaultOptions.merge(options)
+    gravatar_hostname(options.delete(:secure)) +
+      gravatar_profilename(options.delete(:filetype))
+  end
+  
+  def get_profile_info(options={})
+    options = GravatarProfile::DefaultOptions.merge(options)
+    proxy_host = options.delete(:proxy_host)
+    proxy_port = options.delete(:proxy_port)
+    
+    url = URI.parse("http://en.gravatar.com")
+    res = Net::HTTP::Proxy(proxy_host, proxy_port).start(url.host, url.port) {|http|
+    http.get(gravatar_profilename(options.delete(:filetype)))
+    }
+    
+    if res.msg == "OK"
+      profile_data = XmlSimple.xml_in(res.body)
+      if profile_data["entry"]
+        return profile_data["entry"].first
+      end
+    end
+  end
+
+private
+  
+  # Creates a params hash like "?foo=bar" from a hash like {'foo' => 'bar'}.
+  # The values are sorted so it produces deterministic output (and can 
+  # therefore be tested easily).
+  def url_params_from_hash(hash)
+    '?' + hash.map do |key, val|
+      [gravatar_abbreviations[key.to_sym] || key.to_s, val.to_s ].join('=')
+    end.sort.join('&')
+  end
+
+  # Returns either Gravatar's secure hostname or not.
+  def gravatar_hostname(secure)
+    'http' + (secure ? 's://secure.' : '://') + 'gravatar.com'
+  end
+  
+  # Joins the ID and the filetype into one. Like "profile.png"
+  def gravatar_filename(filetype)
+    "/avatar/#{gravatar_id}.#{filetype}"
+  end
+
+  def gravatar_profilename(filetype)
+    if filetype
+      "/#{gravatar_id}.#{filetype}"
+    else
+      "/#{gravatar_id}"
+    end
+  end
+end

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification 
+name: gravatar_profile
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  version: "1.0"
+platform: ruby
+authors: 
+- Veerasundaravel Thirugnanasundaram
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-11-29 00:00:00 +05:30
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: xml-simple
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  type: :development
+  version_requirements: *id001
+description: gravatar_profile is a Ruby Wrapper for getting GRAVATAR[http://gravatar.com] avatars and profile informations.
+email: 
+- veerasundaravel@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG.rdoc
+- README.rdoc
+files: 
+- CHANGELOG.rdoc
+- README.rdoc
+- gravatar_profile.gemspec
+- lib/gravatar_profile.rb
+has_rdoc: true
+homepage: http://veerasundaravel.wordpress.com
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: gravatar_profile
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 1
+summary: gravatar_profile is a Ruby Wrapper for getting GRAVATAR[http://gravatar.com] avatars and profile informations. by Veerasundaravel Thirugnanasundaram
+test_files: []
+