dbalatero-evri_rpx 0.1.1 → 1.0.0

data/LICENSE

@@ -1,4 +1,5 @@
-Copyright (c) 2009 David Balatero
+Copyright (c) 2009 Evri, Inc
+Authored by David Balatero <dbalatero@evri.com>
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.markdown

@@ -0,0 +1,142 @@
+evri_rpx
+========
+The `evri_rpx` library provides an wrapper around RPXNow's universal sign-on API. To learn more about this API, you can read up at [https://rpxnow.com/docs](https://rpxnow.com/docs)
+
+Features
+--------
+ - Clean and simple API design
+ - Full SSL certificate validation
+ - Implements all RPX API calls, including ones available at the Pro level
+ - 100% spec coverage
+ - Clear documentation (and if not, let me know!)
+
+TODO
+----
+ - Rails helper methods for building up the iframe/popup widget code.
+
+Usage/Install
+-------------
+ - Grab an API key/account from [http://rpxnow.com](http://rpxnow.com)
+ - As gem: `sudo gem install dbalatero-evri_rpx -s http://gems.github.com`
+ - The gem will be on RubyForge soon, but their project request page is messed up, so no dice for now.
+
+Examples
+========
+
+Here are examples of the features in `evri_rpx`. As well, you can browse the RDocs here: [http://rdoc.info/projects/dbalatero/evri_rpx](http://rdoc.info/projects/dbalatero/evri_rpx)
+
+All interaction with the API goes through the public methods in `Evri::RPX::Session`, which often return complex objects. See [RDocs](http://rdoc.info/projects/dbalatero/evri_rpx) for all the methods available on these objects.
+
+To see examples of raw JSON responses from RPX, see [http://github.com/dbalatero/evri_rpx/tree/master/spec/fixtures](http://github.com/dbalatero/evri_rpx/tree/master/spec/fixtures)
+
+Validating tokens in your Rails app
+-----------------------------------
+    class RPXController < ApplicationController
+      def process_token
+        if params[:token].blank?
+          flash[:notice] = 'You cancelled RPX login.'
+          redirect_to root_url
+          return
+        end
+
+        # Returns a User object.
+        @user = rpx.auth_info(params[:token])
+
+        # rest of your logic here
+      end
+
+      private
+      def rpx
+        @rpx ||= Evri::RPX::Session.new('myapikey')
+      end
+    end
+
+Mapping your local user's primary keys to third-party providers
+---------------------------------------------------------
+    class RPXController < ApplicationController
+      def process_token
+        # Returns a User object.
+        @user = rpx.auth_info(params[:token])
+
+        # Get the corresponding user out of the database for a 
+        # given email.
+        @user_in_mysql = User.find_by_email(@user.email)
+
+        # Map this user's local primary key to the 3rd-party provider
+        rpx.map(@user, @user_in_mysql.id)
+      end
+
+      private
+      def rpx
+        @rpx ||= Evri::RPX::Session.new('myapikey')
+      end
+    end
+
+Authenticating already mapped users
+-----------------------------------
+    class RPXController < ApplicationController
+      def process_token
+        # Returns a User object.
+        @rpx_user = rpx.auth_info(params[:token])
+
+        @user = User.find(:first, :conditions => ['id = ?', @rpx_user.identifier])
+        if @user
+          # log them in
+          self.current_user = @user
+        end
+      end
+
+      private
+      def rpx
+        @rpx ||= Evri::RPX::Session.new('myapikey')
+      end
+    end
+
+Retrieving mappings for a given user's primary key
+--------------------------------------------------
+    user = User.find_by_email('foo@bar.com')
+    rpx = Evri::RPX::Session.new('myapikey')
+    mappings = rpx.mappings(user.id)
+
+Retrieving all mappings for your application
+--------------------------------------------
+    rpx = Evri::RPX::Session.new('myapikey')
+    all_mappings = rpx.all_mappings
+
+    all_mappings.each do |identifier, mappings|
+      puts "#{identifier} has the following mappings: " <<
+           mappings.join(', ')
+    end
+
+Unmapping a user's primary key and 3rd-party identifier
+-------------------------------------------------------
+    user = User.find(50)
+
+    rpx = Evri::RPX::Session.new('myapikey')
+    rpx.unmap('http://brian.myopenid.com/', user.id)
+
+Retrieving contact lists for users (requires RPX Pro)
+-----------------------------------------------------
+    rpx = Evri::RPX::Session.new('myapikey')
+
+    # Without a User object, requires primary key.
+    user = User.find(50)
+    contact_list = rpx.get_contacts(user.id)
+
+    # With a user object that is mapped already
+    user = rpx.auth_info(params[:token])
+    contact_list = rpx.get_contacts(user)
+
+provider? methods for Users
+------------------------------------
+    user = rpx.auth_info(params[:token])
+
+    if user.twitter?
+      # post an article to twitter via the API
+    elsif user.facebook?
+      # post an article to facebook via FB connect
+    end
+
+Copyright
+=========
+Copyright (c) 2009 Evri, Inc. Authored by David Balatero <dbalatero at evri dot com>. See LICENSE for details.

data/VERSION

@@ -1 +1 @@
-0.1.1
+1.0.0

data/evri_rpx.gemspec

@@ -2,34 +2,46 @@
 
 Gem::Specification.new do |s|
   s.name = %q{evri_rpx}
-  s.version = "0.1.1"
+  s.version = "1.0.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["David Balatero"]
-  s.date = %q{2009-06-15}
+  s.date = %q{2009-06-16}
   s.email = %q{dbalatero@evri.com}
   s.extra_rdoc_files = [
     "LICENSE",
-     "README.rdoc"
+     "README.markdown"
   ]
   s.files = [
     ".document",
      ".gitignore",
      "LICENSE",
-     "README.rdoc",
+     "README.markdown",
      "Rakefile",
      "VERSION",
      "certs/cacert.pem",
      "evri_rpx.gemspec",
      "lib/evri/rpx.rb",
+     "lib/evri/rpx/contact.rb",
+     "lib/evri/rpx/contact_list.rb",
+     "lib/evri/rpx/credentials.rb",
      "lib/evri/rpx/mappings.rb",
      "lib/evri/rpx/session.rb",
      "lib/evri/rpx/user.rb",
      "lib/evri_rpx.rb",
+     "spec/evri/rpx/contact_list_spec.rb",
+     "spec/evri/rpx/contact_spec.rb",
+     "spec/evri/rpx/credentials_spec.rb",
      "spec/evri/rpx/mappings_spec.rb",
      "spec/evri/rpx/session_spec.rb",
      "spec/evri/rpx/user_spec.rb",
+     "spec/fixtures/contacts/bob_johnson.json",
+     "spec/fixtures/credentials/dbalatero_facebook.json",
+     "spec/fixtures/credentials/dbalatero_twitter.json",
+     "spec/fixtures/credentials/dbalatero_windowslive.json",
      "spec/fixtures/mappings/identifiers.json",
+     "spec/fixtures/session/all_mappings.json",
+     "spec/fixtures/session/get_contacts.json",
      "spec/fixtures/session/map.json",
      "spec/fixtures/session/normal_error.json",
      "spec/fixtures/session/service_down_error.json",
@@ -37,6 +49,7 @@ Gem::Specification.new do |s|
      "spec/fixtures/user/dbalatero_facebook.json",
      "spec/fixtures/user/dbalatero_gmail.json",
      "spec/fixtures/user/dbalatero_twitter.json",
+     "spec/fixtures/user/dbalatero_windows_live.json",
      "spec/fixtures/user/dbalatero_yahoo.json",
      "spec/spec_helper.rb"
   ]
@@ -46,7 +59,10 @@ Gem::Specification.new do |s|
   s.rubygems_version = %q{1.3.4}
   s.summary = %q{An API wrapper for the RPXNow.com login service.}
   s.test_files = [
-    "spec/evri/rpx/mappings_spec.rb",
+    "spec/evri/rpx/contact_list_spec.rb",
+     "spec/evri/rpx/contact_spec.rb",
+     "spec/evri/rpx/credentials_spec.rb",
+     "spec/evri/rpx/mappings_spec.rb",
      "spec/evri/rpx/session_spec.rb",
      "spec/evri/rpx/user_spec.rb",
      "spec/spec_helper.rb"

data/lib/evri/rpx/contact.rb

@@ -0,0 +1,18 @@
+module Evri
+  module RPX
+    class Contact
+      # Returns the person's display name, eg "Bob Johnson".
+      attr_reader :display_name
+
+      # Returns an array of emails, eg ['bob@johnson.com']
+      attr_reader :emails
+
+      def initialize(json)
+        @display_name = json['displayName']
+        @emails = json['emails'].map do |email|
+          email['value']
+        end
+      end
+    end
+  end
+end

data/lib/evri/rpx/contact_list.rb

@@ -0,0 +1,27 @@
+module Evri
+  module RPX
+    class ContactList
+      # Returns the total amount of contacts found for this user.
+      attr_reader :total_results
+
+      # Returns the current pagination index into the contact results
+      attr_reader :start_index
+
+      # Returns the number of contacts returned per page.
+      attr_reader :items_per_page
+
+      # Returns an array of Contact objects.
+      attr_reader :contacts
+
+      def initialize(json)
+        @total_results = json['response']['totalResults'] rescue 0
+        @start_index = json['response']['startIndex'] rescue nil
+        @items_per_page = json['response']['itemsPerPage']
+
+        @contacts = json['response']['entry'].map do |contact_json|
+          Contact.new(contact_json)
+        end
+      end
+    end
+  end
+end

data/lib/evri/rpx/credentials.rb

@@ -0,0 +1,65 @@
+module Evri
+  module RPX
+    class Credentials
+      def initialize(json)
+        @json = json
+      end
+
+      # Returns the type of credentials:
+      #   (Facebook|OAuth|WindowsLive)
+      #
+      # Generally, you should use the helper methods such
+      # as #facebook?, #oauth?, #windows_live?
+      def type
+        @json['type']
+      end
+
+      # Returns true if these credentials are Facebook.
+      def facebook?
+        type == 'Facebook'
+      end
+
+      # Returns the Facebook session key.
+      def facebook_session_key
+        @json['sessionKey']
+      end
+
+      # Returns when this Facebook session expires, as a Time
+      # object.
+      def facebook_expires
+        Time.at(@json['expires'].to_i)
+      end
+
+      # Returns the UID for the authorized Facebook user.
+      def facebook_uid
+        @json['uid']
+      end
+
+      # Returns true if these credentials are OAuth.
+      def oauth?
+        type == 'OAuth'
+      end
+
+      # Returns the OAuth token.
+      def oauth_token
+        @json['oauthToken']
+      end
+
+      # Returns the OAuth token secret.
+      def oauth_token_secret
+        @json['oauthTokenSecret']
+      end
+
+      # Returns true if these credentials are for Windows Live
+      def windows_live?
+        type == 'WindowsLive'
+      end
+
+      # Returns the Windows Live eact string, which contains the
+      # user's delegated authentication consent token.
+      def windows_live_eact
+        @json['eact']
+      end
+    end
+  end
+end

data/lib/evri/rpx/mappings.rb

@@ -1,6 +1,7 @@
 module Evri
   module RPX
     class Mappings
+      # Gives back the raw JSON returned by RPX.
       attr_reader :json
       alias :raw :json
 
@@ -8,6 +9,8 @@ module Evri
         @json = json
       end
 
+      # Returns a list of identifiers for a user, or an empty
+      # array if there are none.
       def identifiers
         @json['identifiers'] || []
       end

data/lib/evri/rpx/session.rb

@@ -7,10 +7,14 @@ module Evri
                                                 '..', '..', '..', 'certs',
                                                 'cacert.pem'))
 
-
+      # This error is raised when the RPX service is unavailable.
       class ServiceUnavailableError < StandardError; end
+
+      # This error is raised when an API call is misformed,
+      # or there is bad configuration on the other end.
       class APICallError < StandardError; end
 
+      # Returns the current RPX api_key attached to the session.
       attr_reader :api_key
 
       def initialize(api_key)
@@ -40,13 +44,41 @@ module Evri
         User.new(json)
       end
 
+      # Get all stored mappings for a particular application.
+      #
+      # Returns a hash in this form:
+      #   { 'identifier1' => ['mapping1', 'mapping2'],
+      #     'identifier2' => ['mapping3', 'mapping4'],
+      #     ... }
+      def all_mappings
+        json = parse_response(get("/api/#{API_VERSION}/all_mappings",
+                                  :apiKey => @api_key))
+        json['mappings']
+      end
+
+      # Retrieve a list of contacts for an identifier in the
+      # Portable Contacts format. 
+      #
+      # Takes either a string identifier, or a User object
+      # that responds to :identifier.
+      #
+      # This feature is only available for RPX Pro customers.
+      def get_contacts(user_or_identifier)
+        identifier = identifier_param(user_or_identifier)
+        json = parse_response(get("/api/#{API_VERSION}/get_contacts",
+                                  :apiKey => @api_key,
+                                  :identifier => identifier))
+        ContactList.new(json)
+      end
+
       # Returns the mappings for a given user's primary key, as a
       # Evri::RPX::Mappings object.
       #
       # Takes either a string of the user's primary key:
-      #   session.mappings('dbalatero')
+      #   m = session.mappings('dbalatero')
       # or a User object with an attached primary key:
-      #   session.mappings(
+      #   user = session.auth_info(params[:token])
+      #   m = session.mappings(user)
       def mappings(user_or_primary_key)
         params = { 'apiKey' => @api_key }
         params['primaryKey'] = user_or_primary_key.respond_to?(:primary_key) ?
@@ -62,7 +94,7 @@ module Evri
       # this OpenID will return the mapped primaryKey in the auth_info 
       # API response, which you may use to sign the user in.
       #
-      #  
+      # Returns true.  
       def map(user_or_identifier, primary_key, options = {})
         params = { 'apiKey' => @api_key,
                    'primaryKey' => primary_key,
@@ -75,6 +107,9 @@ module Evri
         json['stat'] == 'ok'
       end
 
+      # Remove (unmap) an OpenID from a primary key.
+      #
+      # Returns true.
       def unmap(user_or_identifier, primary_key)
         params = { 'apiKey' => @api_key,
                    'primaryKey' => primary_key }
@@ -108,18 +143,18 @@ module Evri
       end
 
       def parse_response(response)
-        if response.code.to_i >= 400
-          result = JSON.parse(response.body)
+        result = JSON.parse(response.body)
 
+        if result['err']
           code = result['err']['code']
           if code == -1
             raise ServiceUnavailableError, "The RPX service is temporarily unavailable."
           else
             raise APICallError, "Got error: #{result['err']['msg']} (code: #{code}), HTTP status: #{response.code}"
           end
-        else
-          JSON.parse(response.body)
         end
+
+        result
       end
     end
   end

data/lib/evri/rpx/user.rb

@@ -3,6 +3,10 @@ module Evri
     class User
       class InvalidUserJsonError < StandardError; end
 
+      # Returns a Credentials object for this user, or nil.
+      attr_reader :credentials
+
+      # Returns the raw JSON returned by RPX, in case you want it. 
       attr_reader :json
       alias :raw :json
 
@@ -11,7 +15,12 @@ module Evri
           raise InvalidUserJsonError,
                 'The JSON passed in is invalid!'
         end
+
         @json = json
+
+        if @json['accessCredentials']
+          @credentials = Credentials.new(@json['accessCredentials'])
+        end
       end
 
       # Returns the person's full name (aka David Balatero)
@@ -50,10 +59,6 @@ module Evri
         @json['profile']['url'] rescue nil
       end
 
-      def credentials
-        nil
-      end
-
       # Returns a user's email.
       def email
         @json['profile']['email'] rescue nil
@@ -70,17 +75,25 @@ module Evri
         provider_name == 'Twitter'
       end
 
+      # Returns true if this is a Google login.
       def google?
         provider_name == 'Google'
       end
 
+      # Returns true if this is a Facebook login.
       def facebook?
         provider_name == 'Facebook'
       end
 
+      # Returns true if this is a Yahoo! login.
       def yahoo?
         provider_name == 'Yahoo!'
       end
+
+      # Returns true if this is a Windows Live login.
+      def windows_live?
+        provider_name == 'Windows Live'
+      end
     end
   end
 end

data/lib/evri_rpx.rb

@@ -5,6 +5,9 @@ require 'net/http'
 require 'net/https'
 
 require 'evri/rpx'
+require 'evri/rpx/contact'
+require 'evri/rpx/contact_list'
+require 'evri/rpx/credentials'
 require 'evri/rpx/mappings'
 require 'evri/rpx/session'
 require 'evri/rpx/user'

data/spec/evri/rpx/contact_list_spec.rb

@@ -0,0 +1,39 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', '..', 'spec_helper'))
+
+describe Evri::RPX::ContactList do
+  before(:all) do
+    @list = Evri::RPX::ContactList.new(json_fixture('session/get_contacts.json'))
+  end
+
+  describe "total_results" do
+    it "should return the total results for a user's contact list" do
+      @list.total_results.should == 5
+    end
+  end
+
+  describe "start_index" do
+    it "should return the start index used in pagination" do
+      @list.start_index.should == 1
+    end
+  end
+
+  describe "items_per_page" do
+    it "should return the items per page, for pagination" do
+      @list.items_per_page.should == 5
+    end
+  end
+
+  describe "contacts" do
+    it "should return an array of Contact objects" do
+      @list.contacts.each do |contact|
+        contact.should be_a_kind_of(Evri::RPX::Contact)
+      end
+    end
+
+    it "should include Bob Johnson" do
+      @list.contacts.select { |contact|
+        contact.display_name == 'Bob Johnson'
+      }.should_not be_nil
+    end
+  end
+end

data/spec/evri/rpx/contact_spec.rb

@@ -0,0 +1,19 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', '..', 'spec_helper'))
+
+describe Evri::RPX::Contact do
+  before(:all) do
+    @contact = Evri::RPX::Contact.new(json_fixture('contacts/bob_johnson.json'))
+  end
+
+  describe "display_name" do
+    it "should be the correct display name in the response" do
+      @contact.display_name.should == 'Bob Johnson'
+    end
+  end
+
+  describe "emails" do
+    it "should return a list of emails for a given user" do
+      @contact.emails.should == ['bob@example.com']
+    end
+  end
+end

data/spec/evri/rpx/credentials_spec.rb

@@ -0,0 +1,98 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', '..', 'spec_helper'))
+
+describe Evri::RPX::Credentials do
+  describe "parsing OAuth (twitter) credentials" do
+    before(:all) do
+      json = json_fixture('credentials/dbalatero_twitter.json')
+      @credentials = Evri::RPX::Credentials.new(json['accessCredentials'])
+    end
+
+    describe "oauth?" do
+      it "should be true" do
+        @credentials.oauth?.should be_true
+      end
+    end
+
+    describe "type" do
+      it "should be OAuth" do
+        @credentials.type.should == 'OAuth'
+      end
+    end
+
+    describe "oauth_token" do
+      it "should be the oauth token given" do
+        @credentials.oauth_token.should == '35834683-jBU3o-snip' 
+      end
+    end
+
+    describe "oauth_token_secret" do
+      it "should be the secret given" do
+        @credentials.oauth_token_secret.should == '2GjoAgV5-snip'
+      end
+    end
+  end
+
+  describe "parsing Windows Live credentials" do
+    before(:all) do
+      json = json_fixture('credentials/dbalatero_windowslive.json')
+      @credentials = Evri::RPX::Credentials.new(json['accessCredentials'])
+    end
+
+    describe "windows_live?" do
+      it "should be true" do
+        @credentials.windows_live?.should be_true
+      end
+    end
+
+    describe "type" do
+      it "should be WindowsLive" do
+        @credentials.type.should == 'WindowsLive'
+      end
+    end
+
+    describe "windows_live_eact" do
+      it "should be the eact field given" do
+        @credentials.windows_live_eact.should == 'eact%3DJvtJUb4%252Bx1InXqjglTBWX-snip'
+      end
+    end
+  end
+
+
+  describe "parsing Facebook credentials" do
+    before(:all) do
+      json = json_fixture('credentials/dbalatero_facebook.json')
+      @credentials = Evri::RPX::Credentials.new(json['accessCredentials'])
+    end
+
+    describe "facebook?" do
+      it "should be true" do
+        @credentials.facebook?.should be_true
+      end
+    end
+
+    describe "type" do
+      it "should be Facebook" do
+        @credentials.type.should == 'Facebook'
+      end
+    end
+
+    describe "facebook_session_key" do
+      it "should be the session key given" do
+        @credentials.facebook_session_key.should == '2.7kr3H8W-snip'
+      end
+    end
+
+    describe "facebook_uid" do
+      it "should be the UID given" do
+        @credentials.facebook_uid.should == '10701789'
+      end
+    end
+
+    describe "facebook_expires" do
+      it "should be the correct Time object" do
+        @credentials.facebook_expires.should == Time.at(1245196800)
+      end
+    end
+
+  end
+end

data/spec/evri/rpx/session_spec.rb

@@ -46,6 +46,46 @@ describe Evri::RPX::Session do
     end
   end
 
+  describe "all_mappings" do
+    it "should return a set of identifiers to mappings" do
+      FakeWeb.register_uri(:get,
+                           'https://rpxnow.com:443/api/v2/all_mappings',
+                           :file => fixture_path('session/all_mappings.json'))
+      result = @session.all_mappings
+      result['1'].should == ['http://cygnus.myopenid.com/']
+      result['2'].should == ['http://brianellin.com/', 'http://brian.myopenid.com/']
+    end
+  end
+
+  describe "get_contacts" do
+    before(:each) do
+      FakeWeb.register_uri(:get,
+                           'https://rpxnow.com:443/api/v2/get_contacts',
+                           :file => fixture_path('session/get_contacts.json'))
+    end
+    
+    after(:each) do
+      FakeWeb.clean_registry
+    end
+
+    it "should return a contacts list for a identifier string" do
+      result = @session.get_contacts('http://brian.myopenid.com/')
+      result.should be_a_kind_of(Evri::RPX::ContactList)
+
+      result.contacts.should have(6).things
+    end
+
+    it "should return a contacts list for a user string" do
+      user = mock('user')
+      user.should_receive(:identifier).and_return('http://brian.myopenid.com/')
+
+      result = @session.get_contacts(user)
+      result.should be_a_kind_of(Evri::RPX::ContactList)
+
+      result.contacts.should have(6).things
+    end
+  end
+
   describe "map" do
     before(:each) do
       FakeWeb.register_uri(:get,

data/spec/evri/rpx/user_spec.rb

@@ -78,7 +78,7 @@ describe Evri::RPX::User do
 
     describe "credentials" do
       it "should not be nil" do
-        pending
+        @user.credentials.should_not be_nil
       end
     end
 
@@ -215,7 +215,6 @@ describe Evri::RPX::User do
 
     describe "credentials" do
       it "should be set" do
-        pending
         @user.credentials.should_not be_nil
       end
     end
@@ -300,4 +299,29 @@ describe Evri::RPX::User do
       end
     end
   end
+
+  describe "parsing Windows Live logins" do
+    before(:all) do
+      json = json_fixture('user/dbalatero_windows_live.json')
+      @user = Evri::RPX::User.new(json)
+    end
+
+    describe "windows_live?" do
+      it "should be true" do
+        @user.windows_live?.should be_true
+      end
+    end
+
+    describe "credentials" do
+      it "should not be nil" do
+        @user.credentials.should_not be_nil
+      end
+    end
+
+    describe "email" do
+      it "should be correct" do
+        @user.email.should == 'dbalatero16@hotmail.com'
+      end
+    end
+  end
 end

data/spec/fixtures/contacts/bob_johnson.json

@@ -0,0 +1,9 @@
+{
+  "displayName": "Bob Johnson",
+    "emails": [
+    {
+      "type": "other",
+      "value": "bob@example.com"
+    }
+  ]
+}

data/spec/fixtures/credentials/dbalatero_facebook.json

@@ -0,0 +1,32 @@
+{
+  "profile": {
+    "name": {
+      "givenName": "David",
+      "familyName": "Balatero",
+      "formatted": "David Balatero"
+    },
+    "address": {
+      "region": "Washington",
+      "country": "United States",
+      "postalCode": "98115",
+      "locality": "Seattle"
+    },
+    "photo": "http:\/\/profile.ak.facebook.com\/v230\/745\/68\/n10701789_1299.jpg",
+    "displayName": "David Balatero",
+    "preferredUsername": "DavidBalatero",
+    "url": "http:\/\/www.facebook.com\/profile.php?id=10701789",
+    "utcOffset": "-07:00",
+    "gender": "male",
+    "birthday": "1986-08-31",
+    "providerName": "Facebook",
+    "primaryKey": "dbalatero",
+    "identifier": "http:\/\/www.facebook.com\/profile.php?id=10701789"
+  },
+  "accessCredentials": {
+    "expires": "1245196800",
+    "uid": "10701789",
+    "type": "Facebook",
+    "sessionKey": "2.7kr3H8W-snip"
+  },
+  "stat": "ok"
+}

data/spec/fixtures/credentials/dbalatero_twitter.json

@@ -0,0 +1,19 @@
+{
+  "profile": {
+    "name": {
+      "formatted": "David Balatero"
+    },
+    "photo": "http:\/\/s3.amazonaws.com\/twitter_production\/profile_images\/196887137\/n10704766_41523711_7282_normal.jpg",
+    "displayName": "David Balatero",
+    "preferredUsername": "dbalatero",
+    "url": "http:\/\/twitter.com\/dbalatero",
+    "providerName": "Twitter",
+    "identifier": "http:\/\/twitter.com\/account\/profile?user_id=35834683"
+  },
+  "accessCredentials": {
+    "oauthToken": "35834683-jBU3o-snip",
+    "type": "OAuth",
+    "oauthTokenSecret": "2GjoAgV5-snip"
+  },
+  "stat": "ok"
+}

data/spec/fixtures/credentials/dbalatero_windowslive.json

@@ -0,0 +1,15 @@
+{
+  "profile": {
+    "displayName": "hit me with that motown funk",
+    "preferredUsername": "hit me with that motown funk",
+    "url": "http:\/\/cid-f032362d64442690.spaces.live.com\/",
+    "providerName": "Windows Live",
+    "identifier": "http:\/\/cid-f032362d64442690.spaces.live.com\/",
+    "email": "dbalatero16@hotmail.com"
+  },
+  "accessCredentials": {
+    "eact": "eact%3DJvtJUb4%252Bx1InXqjglTBWX-snip",
+    "type": "WindowsLive"
+  },
+  "stat": "ok"
+}

data/spec/fixtures/session/all_mappings.json

@@ -0,0 +1,12 @@
+{
+  "mappings": {
+    "1": [
+      "http:\/\/cygnus.myopenid.com\/"
+    ],
+    "2": [
+      "http:\/\/brianellin.com\/",
+      "http:\/\/brian.myopenid.com\/"
+    ]
+  },
+  "stat": "ok"
+}

data/spec/fixtures/session/get_contacts.json

@@ -0,0 +1,63 @@
+{
+  "response": {
+    "totalResults": 5,
+    "startIndex": 1,
+    "entry": [
+      {
+        "displayName": "Bob Johnson",
+        "emails": [
+          {
+            "type": "other",
+            "value": "bob@example.com"
+          }
+        ]
+      },
+      {
+        "displayName": "Cindy Smith",
+        "emails": [
+          {
+            "type": "other",
+            "value": "cindy.smith@example.com"
+          }
+        ]
+      },
+      {
+        "displayName": "Fred Williams",
+        "emails": [
+          {
+            "type": "other",
+            "value": "fred.williams@example.com"
+          }
+        ]
+      },
+      {
+        "emails": [
+          {
+            "type": "other",
+            "value": "j.lewis@example.com"
+          }
+        ]
+      },
+      {
+        "displayName": "Mary Jones",
+        "emails": [
+          {
+            "type": "other",
+            "value": "mary.jones@example.com"
+          }
+        ]
+      },
+      {
+        "displayName": "Patricia Green",
+        "emails": [
+          {
+            "type": "other",
+            "value": "p.green@example.com"
+          }
+        ]
+      }
+    ],
+    "itemsPerPage": 5
+  },
+  "stat": "ok"
+}

data/spec/fixtures/user/dbalatero_windows_live.json

@@ -0,0 +1,15 @@
+{
+  "profile": {
+    "displayName": "hit me with that motown funk",
+    "preferredUsername": "hit me with that motown funk",
+    "url": "http:\/\/cid-f032362d64442690.spaces.live.com\/",
+    "providerName": "Windows Live",
+    "identifier": "http:\/\/cid-f032362d64442690.spaces.live.com\/",
+    "email": "dbalatero16@hotmail.com"
+  },
+  "accessCredentials": {
+    "eact": "--snip--",
+    "type": "WindowsLive"
+  },
+  "stat": "ok"
+}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: dbalatero-evri_rpx
 version: !ruby/object:Gem::Version 
-  version: 0.1.1
+  version: 1.0.0
 platform: ruby
 authors: 
 - David Balatero
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-06-15 00:00:00 -07:00
+date: 2009-06-16 00:00:00 -07:00
 default_executable: 
 dependencies: []
 
@@ -21,25 +21,37 @@ extensions: []
 
 extra_rdoc_files: 
 - LICENSE
-- README.rdoc
+- README.markdown
 files: 
 - .document
 - .gitignore
 - LICENSE
-- README.rdoc
+- README.markdown
 - Rakefile
 - VERSION
 - certs/cacert.pem
 - evri_rpx.gemspec
 - lib/evri/rpx.rb
+- lib/evri/rpx/contact.rb
+- lib/evri/rpx/contact_list.rb
+- lib/evri/rpx/credentials.rb
 - lib/evri/rpx/mappings.rb
 - lib/evri/rpx/session.rb
 - lib/evri/rpx/user.rb
 - lib/evri_rpx.rb
+- spec/evri/rpx/contact_list_spec.rb
+- spec/evri/rpx/contact_spec.rb
+- spec/evri/rpx/credentials_spec.rb
 - spec/evri/rpx/mappings_spec.rb
 - spec/evri/rpx/session_spec.rb
 - spec/evri/rpx/user_spec.rb
+- spec/fixtures/contacts/bob_johnson.json
+- spec/fixtures/credentials/dbalatero_facebook.json
+- spec/fixtures/credentials/dbalatero_twitter.json
+- spec/fixtures/credentials/dbalatero_windowslive.json
 - spec/fixtures/mappings/identifiers.json
+- spec/fixtures/session/all_mappings.json
+- spec/fixtures/session/get_contacts.json
 - spec/fixtures/session/map.json
 - spec/fixtures/session/normal_error.json
 - spec/fixtures/session/service_down_error.json
@@ -47,6 +59,7 @@ files:
 - spec/fixtures/user/dbalatero_facebook.json
 - spec/fixtures/user/dbalatero_gmail.json
 - spec/fixtures/user/dbalatero_twitter.json
+- spec/fixtures/user/dbalatero_windows_live.json
 - spec/fixtures/user/dbalatero_yahoo.json
 - spec/spec_helper.rb
 has_rdoc: false
@@ -76,6 +89,9 @@ signing_key:
 specification_version: 3
 summary: An API wrapper for the RPXNow.com login service.
 test_files: 
+- spec/evri/rpx/contact_list_spec.rb
+- spec/evri/rpx/contact_spec.rb
+- spec/evri/rpx/credentials_spec.rb
 - spec/evri/rpx/mappings_spec.rb
 - spec/evri/rpx/session_spec.rb
 - spec/evri/rpx/user_spec.rb

data/README.rdoc

@@ -1,13 +0,0 @@
-= evri_rpx
-
-Description goes here.
-
-== Copyright
-
-== TODO
-
- * Implement #all_mappings
- * Implement #get_contacts
- * Helper methods for forms, etc.
-
-Copyright (c) 2009 David Balatero, Evri, Inc. <dbalatero at evri dot com>. See LICENSE for details.