portablecontacts 0.1.0

data/.document

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

data/.gitignore

@@ -0,0 +1,5 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Pelle Braendgaard
+
+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,48 @@
+= Portable Contacts
+
+This is a ruby client implementation of Portable Contacts a standard for exchanging profile and address book data.
+
+The current draft of the standard is http://portablecontacts.net/draft-spec.html
+
+Portable Contacts is currently supported by Plaxo, Google, Yahoo, and most OpenSocial containers.
+
+This client uses OAuth and JSON exclusively. There are no plans for supporting basic authentication or xml.
+
+To use it you need an OAuth AccessToken (see http://oauth.rubyforge.org/). If you are using Rails, you may find the easiest way of doing this as using the OAuth Plugin http://stakeventures.com/articles/2009/07/21/consuming-oauth-intelligently-in-rails
+
+The Gem requires:
+
+* ActiveSupport
+* OAuth Gem
+* JSON gem
+
+== Example Code
+
+  @access_token = ... # instantiate access token
+  
+  @client = PortableContacts::Client.new "http://www-opensocial.googleusercontent.com/api/people", @access_token
+  
+  # Get users profile
+  
+  @profile = @client.me
+  
+  puts @profile.display_name
+  => "Bob Sample"
+  
+  # Get users contacts
+  @contacts = @client.all
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but
+   bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2009 Pelle Braendgaard. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,54 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "portablecontacts"
+    gem.summary = %Q{Portable Contacts client for Ruby}
+    gem.description = %Q{A client library for the portable contacts standard}
+    gem.email = "pelleb@gmail.com"
+    gem.homepage = "http://github.com/pelle/portablecontacts"
+    gem.authors = ["Pelle Braendgaard"]
+    gem.rubyforge_project = "portablecontact"
+    gem.add_dependency('oauth', '>= 0.3.6')
+    gem.add_dependency('json')
+    gem.add_development_dependency "rspec"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::RubyforgeTasks.new do |rubyforge|
+    rubyforge.doc_task = "rdoc"
+  end
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "portablecontacts #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/portable_contacts.rb

@@ -0,0 +1,218 @@
+require 'uri'
+require 'json'
+require 'activesupport'
+module PortableContacts
+  
+  # This is the main PortableContacts Client.
+  #
+  # == query options
+  #
+  # The library supports the various filter and sorting parameters. The format of this may change for this library, so limit use to :
+  # :count and :start_index for now.
+  #
+  class Client
+    attr :base_url, :access_token
+    
+    # First parameter is the portable contacts base_url. Find this on your PortableContact providers documentation or through XRDS.
+    #
+    # * Google's is http://www-opensocial.googleusercontent.com/api/people
+    # * Yahoo's is http://appstore.apps.yahooapis.com/social/rest/people
+    #
+    # The second parameter is an OAuth::AccessToken instantiated for the provider.
+    #
+    def initialize(base_url,access_token)
+      @base_url=base_url
+      @access_token=access_token
+    end
+    
+    # Returns the AccessToken users contact details. Note this requests all fields from provider
+    # Returns an PortableContacts::Person object
+    def me(options={})
+      single(get("/@me/@self",options.reverse_merge(:fields=>:all)))
+    end
+
+    # Returns the contacts of the user. It defaults to all fields and 100 entries
+    #
+    #   @contacts = @client.all # return 100 contacts
+    #   @contacts = @client.all :count=>10 # return 10 contacts
+    #   @contacts = @client.all :count=>10, :start_index=>10 # returns the second page of 10 contacts
+    #   puts @contacts.total_entries # returns the total amount of contacts on the server
+    #
+    # Returns a PortableContacts::Collection which is a subclass of Array
+    def all(options={})
+      collection(get("/@me/@all",options.reverse_merge(:fields=>:all,:count=>100)))
+    end
+    
+    # Returns the full contact infor for a particular userid. TODO This is not tested well
+    # Returns an PortableContacts::Person object
+    def find(id, options={})
+      single(get("/@me/@all/#{id}",options.reverse_merge(:fields=>:all)))
+    end
+    
+    private
+
+    def get(path,options={})
+      parse(@access_token.get( url_for(path)+options_for(options), {'Accept' => 'application/json'}))
+    end
+    
+    def url_for(path)
+      "#{@base_url}#{path}"
+    end
+    
+    def options_for(options={})
+      return "" if options.nil? || options.empty?
+      options.symbolize_keys! if options.respond_to? :symbolize_keys!
+      "?#{(fields_options(options[:fields])+filter_options(options[:filter])+sort_options(options[:sort])+pagination_options(options)).sort.join("&")}"
+    end
+    
+    def single(data)
+      if data.is_a?(Hash) && data['entry']
+        PortableContacts::Person.new(data['entry'])
+      else
+        data
+      end
+    end
+    
+    def collection(data)
+      if data.is_a?(Hash)
+        PortableContacts::Collection.new data
+      else
+        data
+      end
+    end
+    
+    def parse(response)
+      return false unless response
+      if ["200","201"].include? response.code
+        unless response.body.blank?
+          JSON.parse(response.body)
+        else
+          true
+        end
+      else
+        false
+      end  
+    end
+    
+    def fields_options(options=nil)
+      return [] if options.nil?
+      if options.is_a? Symbol
+        return ["fields=#{(options==:all ? "@all": URI.escape(options.to_s))}"]
+      elsif options.respond_to?(:collect)
+        ["fields=#{options.collect{|f|f.to_s}.join(',')}"]
+      else
+        []
+      end
+    end
+    
+    def sort_options(options=nil)
+      return [] if options.nil?
+      if options.is_a? Symbol
+        return ["sortBy=#{URI.escape(options.to_s)}"]
+      end
+      if options.is_a?(Hash) and options[:by]||options['by']
+        return to_query_list(options,"sort")
+      end
+      return []
+    end
+
+    def pagination_options(options=nil)
+      return [] if options.nil? || options.empty?
+      params=[]
+      if options[:count]
+        params<<"count=#{options[:count]}"
+      end
+      if options[:start_index]
+        params<<"startIndex=#{options[:start_index]}"
+      end
+      params
+    end
+    
+    def filter_options(options={})
+      return [] if options.nil? || options.empty?
+      options[:op] ||= "equals"
+      to_query_list(options,"filter")
+    end
+    
+    def to_query_list(params,pre_fix='')
+      params.collect{ |k,v| "#{pre_fix}#{k.to_s.capitalize}=#{URI.escape(v.to_s)}"}
+    end
+  end
+  
+  class Person
+    
+    # Encapsulates a person. Each of the portable contact and opensocial contact fields has a rubyfied (underscored) accessor method.
+    #
+    # @person = @person.display_name
+    #
+
+    def initialize(data={})
+      @data=data
+    end
+    
+    SINGULAR_FIELDS = [
+      # Portable contacts singular fields
+      :id, :display_name, :name, :nickname, :published, :updated, :birthday, :anniversary,
+      :gender, :note, :preferred_username, :utc_offset, :connected, 
+      
+      # OpenSocial singular fields
+      :about_me, :body_type, :current_location, :drinker, :ethnicity, :fashion, :happiest_when, 
+      :humor, :living_arrangement, :looking_for, :profile_song, :profile_video, :relationship_status, 
+      :religion, :romance, :scared_of, :sexual_orientation, :smoker, :status
+    ]
+    PLURAL_FIELDS = [ 
+      # Portable contacts plural fields
+      :emails, :urls, :phone_numbers, :ims, :photos, :tags, :relationships, :addresses,
+      :organizations, :accounts,
+      
+      # OpenSocial plural fields
+      :activities, :books, :cars, :children, :food, :heroes, :interests, :job_interests, 
+      :languages, :languages_spoken, :movies, :music, :pets, :political_views, :quotes, 
+      :sports, :turn_offs, :turn_ons, :tv_shows
+    ]
+    
+    ENTRY_FIELDS = SINGULAR_FIELDS + PLURAL_FIELDS
+    
+    
+    def [](key)
+      @data[key.to_s.camelize(:lower)]
+    end
+    
+    # primary email address
+    def email
+      @email||= begin
+        (emails.detect {|e| e['primary']=='true '} || emails.first)["value"] unless emails.empty?
+      end
+    end
+    
+    def id
+      self["id"]
+    end
+    
+    protected
+    
+    def method_missing(method,*args)
+      if respond_to?(method)
+        return self[method]
+      end 
+      super
+    end
+    
+    def respond_to?(method)
+      ENTRY_FIELDS.include?(method) || @data.has_key?(method.to_s.camelize(:lower)) || super
+    end
+  end
+  
+  class Collection < Array
+    attr_reader :total_entries, :per_page, :start_index
+    
+    def initialize(data)
+      super data["entry"].collect{|e| PortableContacts::Person.new(e) }
+      @total_entries=data["totalResults"].to_i
+      @per_page=data["itemsPerPage"].to_i
+      @start_index=data["startIndex"].to_i
+    end
+
+  end
+  
+end

data/lib/portablecontacts.rb

@@ -0,0 +1 @@
+require File.join(File.dirname(__FILE__),'portable_contacts')

data/portablecontacts.gemspec

@@ -0,0 +1,63 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE
+# Instead, edit Jeweler::Tasks in Rakefile, and run `rake gemspec`
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{portablecontacts}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Pelle Braendgaard"]
+  s.date = %q{2009-10-02}
+  s.description = %q{A client library for the portable contacts standard}
+  s.email = %q{pelleb@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "lib/portable_contacts.rb",
+     "lib/portablecontacts.rb",
+     "portablecontacts.gemspec",
+     "spec/fixtures/multiple.json",
+     "spec/fixtures/single.json",
+     "spec/portable_contacts_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/pelle/portablecontacts}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{portablecontact}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Portable Contacts client for Ruby}
+  s.test_files = [
+    "spec/portable_contacts_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<oauth>, [">= 0.3.6"])
+      s.add_runtime_dependency(%q<json>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+    else
+      s.add_dependency(%q<oauth>, [">= 0.3.6"])
+      s.add_dependency(%q<json>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<oauth>, [">= 0.3.6"])
+    s.add_dependency(%q<json>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+  end
+end

data/spec/fixtures/multiple.json

@@ -0,0 +1,96 @@
+{
+  "startIndex": 10,
+  "itemsPerPage": 10,
+  "totalResults": 12,
+  "entry": [
+    {
+      "id": "123",
+      "displayName": "Minimal Contact"
+    },
+    {
+      "id": "703887",
+      "displayName": "Mork Hashimoto",
+      "name": {
+        "familyName": "Hashimoto",
+        "givenName": "Mork"
+      },
+      "birthday": "0000-01-16",
+      "gender": "male",
+      "drinker": "heavily",
+      "tags": [
+        "plaxo guy",
+        "favorite"
+      ],
+      "emails": [
+        {
+          "value": "mhashimoto-04@plaxo.com",
+          "type": "work",
+          "primary": "true"
+        },
+        {
+          "value": "mhashimoto-04@plaxo.com",
+          "type": "home"
+        },
+        {
+          "value": "mhashimoto@plaxo.com",
+          "type": "home"
+        }
+      ],
+      "urls": [
+        {
+          "value": "http://www.seeyellow.com",
+          "type": "work"
+        },
+        {
+          "value": "http://www.angryalien.com",
+          "type": "home"
+        }
+      ],
+      "phoneNumbers": [
+        {
+          "value": "KLONDIKE5",
+          "type": "work"
+        },
+        {
+          "value": "650-123-4567",
+          "type": "mobile"
+        }
+      ],
+      "photos": [
+        {
+          "value": "http://sample.site.org/photos/12345.jpg",
+          "type": "thumbnail"
+        }
+      ],
+      "ims": [
+        {
+          "value": "plaxodev8",
+          "type": "aim"
+        }
+      ],
+      "addresses": [
+        {
+          "type": "home",
+          "streetAddress": "742 Evergreen Terrace\nSuite 123",
+          "locality": "Springfield",
+          "region": "VT",
+          "postalCode": "12345",
+          "country": "USA",
+          "formatted": "742 Evergreen Terrace\nSuite 123\nSpringfield, VT 12345 USA"
+        }
+      ],
+      "organizations": [
+        {
+          "name": "Burns Worldwide",
+          "title": "Head Bee Guy"
+        }
+      ],
+      "accounts": [
+        {
+          "domain": "plaxo.com",
+          "userid": "2706"
+        }
+      ]
+    }
+  ]
+}

data/spec/fixtures/single.json

@@ -0,0 +1,88 @@
+{
+  "entry": 
+    {
+      "id": "703887",
+      "displayName": "Mork Hashimoto",
+      "name": {
+        "familyName": "Hashimoto",
+        "givenName": "Mork"
+      },
+      "birthday": "0000-01-16",
+      "gender": "male",
+      "drinker": "heavily",
+      "tags": [
+        "plaxo guy",
+        "favorite"
+      ],
+      "emails": [
+        {
+          "value": "mhashimoto-04@plaxo.com",
+          "type": "work",
+          "primary": "true"
+        },
+        {
+          "value": "mhashimoto-04@plaxo.com",
+          "type": "home"
+        },
+        {
+          "value": "mhashimoto@plaxo.com",
+          "type": "home"
+        }
+      ],
+      "urls": [
+        {
+          "value": "http://www.seeyellow.com",
+          "type": "work"
+        },
+        {
+          "value": "http://www.angryalien.com",
+          "type": "home"
+        }
+      ],
+      "phoneNumbers": [
+        {
+          "value": "KLONDIKE5",
+          "type": "work"
+        },
+        {
+          "value": "650-123-4567",
+          "type": "mobile"
+        }
+      ],
+      "photos": [
+        {
+          "value": "http://sample.site.org/photos/12345.jpg",
+          "type": "thumbnail"
+        }
+      ],
+      "ims": [
+        {
+          "value": "plaxodev8",
+          "type": "aim"
+        }
+      ],
+      "addresses": [
+        {
+          "type": "home",
+          "streetAddress": "742 Evergreen Terrace\nSuite 123",
+          "locality": "Springfield",
+          "region": "VT",
+          "postalCode": "12345",
+          "country": "USA",
+          "formatted": "742 Evergreen Terrace\nSuite 123\nSpringfield, VT 12345 USA"
+        }
+      ],
+      "organizations": [
+        {
+          "name": "Burns Worldwide",
+          "title": "Head Bee Guy"
+        }
+      ],
+      "accounts": [
+        {
+          "domain": "plaxo.com",
+          "userid": "2706"
+        }
+      ]
+    }
+}

data/spec/portable_contacts_spec.rb

@@ -0,0 +1,234 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe PortableContacts::Client do
+  
+  def access_token
+    @access_token ||= mock("accesstoken")
+  end
+  
+  before(:each) do
+    @client = PortableContacts::Client.new "http://sample.com/portable_contacts", access_token
+  end
+  
+  ["/@me/@all", "/@me/@all/(id)", "/@me/@self"].each do |path|
+    
+    it "should generate url for #{path}" do
+      @client.send( :url_for, path).should=="http://sample.com/portable_contacts#{path}"
+    end
+    
+  end
+    
+  it "should return empty string for no options" do
+    @client.send(:options_for).should==""
+  end
+  
+  describe "fields" do
+    it "should handle all" do
+      @client.send(:options_for, :fields=>:all).should=="?fields=@all"
+    end
+
+    it "should handle single field" do
+      @client.send(:options_for, :fields=>:name).should=="?fields=name"
+    end
+    
+    it "should handle array of fields" do
+      @client.send(:options_for, :fields=>[:name,:emails,:nickname,:id]).should=="?fields=name,emails,nickname,id"      
+    end
+
+  end
+  
+  describe "filtering" do
+    
+    it "should handle default operation" do
+      @client.send(:options_for, :filter=>{:by=>:name,:value=>"Bob"}).should=="?filterBy=name&filterOp=equals&filterValue=Bob"
+    end
+    
+    ["displayName","id","nickname"].each do |field|
+      ["equals", "contains", "startsWith", "present"].each do |op|
+        
+        it "should create filter for #{field} with #{op}" do
+          @client.send(:options_for, :filter=>{:by=>field, :op=>op, :value=>"bb"}).should=="?filterBy=#{field}&filterOp=#{op}&filterValue=bb"          
+        end
+
+      end
+    end
+  end
+
+  describe "sorting" do
+    
+    it "should handle straight sort" do
+      @client.send(:options_for, :sort=>:name).should=="?sortBy=name"
+    end
+
+    it "should handle sort as a hash" do
+      @client.send(:options_for, :sort=>{:by=>:name}).should=="?sortBy=name"
+    end
+
+    it "should handle sort as a hash" do
+      @client.send(:options_for, :sort=>{:by=>:name,:order=>:descending}).should=="?sortBy=name&sortOrder=descending"
+    end
+    
+  end
+  
+  describe "paging" do
+    
+    it "should handle count" do
+      @client.send(:options_for, :count=>133).should=="?count=133"
+    end
+
+    it "should handle startIndex" do
+      @client.send(:options_for, :start_index=>20).should=="?startIndex=20"
+    end
+
+    it "should handle count with startIndex" do
+      @client.send(:options_for, :count=>10,:start_index=>40).should=="?count=10&startIndex=40"
+    end
+
+  end
+  
+  it "should handle all parameters at once" do
+    @client.send(:options_for, 
+      :fields=>[:name,:emails,:nickname,:id],
+      :filter=>{:by=>:name,:value=>"Bob"},
+      :sort=>{:by=>:name,:order=>:descending},
+      :count=>10,:start_index=>40).should=="?count=10&fields=name,emails,nickname,id&filterBy=name&filterOp=equals&filterValue=Bob&sortBy=name&sortOrder=descending&startIndex=40"
+  end
+
+  describe "Rails Specific" do
+    require 'activesupport'
+
+    it "should handle all parameters at once with string keys" do    
+      @client.send(:options_for, 
+      'fields'=>['name','emails','nickname','id'],
+      'filter'=>{'by'=>'name','value'=>"Bob"},
+      'sort'=>{'by'=>'name','order'=>'descending'},
+      'count'=>10,'start_index'=>40).should=="?count=10&fields=name,emails,nickname,id&filterBy=name&filterOp=equals&filterValue=Bob&sortBy=name&sortOrder=descending&startIndex=40"
+    end
+  end
+
+  describe "parsing" do
+    
+    def parse_json_file(name)
+      File.open File.join(File.dirname(__FILE__),'fixtures', name) do |f|
+        JSON.parse f.read
+      end
+    end
+    
+    describe "single entry response" do
+      before(:each) do
+        @entry = @client.send(:single,parse_json_file('single.json'))
+      end
+      
+      it "should contain displayName" do
+        @entry.display_name.should=="Mork Hashimoto"
+      end
+      
+      it "should contain tags" do
+        @entry.tags.should == [
+          "plaxo guy",
+          "favorite"
+        ]
+      end
+      
+      it "should emails" do
+        @entry.emails.should == [
+          {
+            "value"=> "mhashimoto-04@plaxo.com",
+            "type"=> "work",
+            "primary"=> "true"
+          },
+          {
+            "value"=> "mhashimoto-04@plaxo.com",
+            "type"=> "home"
+          },
+          {
+            "value"=> "mhashimoto@plaxo.com",
+            "type"=> "home"
+          }
+        ]
+      end
+      
+      it "should have email" do
+        @entry.email.should=="mhashimoto-04@plaxo.com"
+      end
+    end
+
+    describe "multiple entries" do
+      before(:each) do
+        @entries = @client.send(:collection,parse_json_file('multiple.json'))
+      end
+      
+      it "should have correct start index" do
+        @entries.start_index.should == 10
+      end
+      
+      it "should have correct per page" do
+        @entries.per_page.should == 10
+      end
+      
+      it "should have correct total entries" do
+        @entries.total_entries.should == 12
+      end
+      
+      it "should have 2 enties" do
+        @entries.length.should==2
+      end
+      
+      describe "first entry" do
+        
+        before(:each) do
+          @entry=@entries.first
+        end
+        
+        it "should have correct id" do
+          @entry.id.should=="123"
+        end
+        
+        it "should contain displayName" do
+          @entry.display_name.should=="Minimal Contact"
+        end
+        
+      end
+      
+      # The same as data in single entry
+      describe "last entry" do
+        
+        before(:each) do
+          @entry=@entries.last
+        end
+        it "should contain displayName" do
+          @entry.display_name.should=="Mork Hashimoto"
+        end
+      
+        it "should contain tags" do
+          @entry.tags.should == [
+            "plaxo guy",
+            "favorite"
+          ]
+        end
+      
+        it "should emails" do
+          @entry.emails.should == [
+            {
+              "value"=> "mhashimoto-04@plaxo.com",
+              "type"=> "work",
+              "primary"=> "true"
+            },
+            {
+              "value"=> "mhashimoto-04@plaxo.com",
+              "type"=> "home"
+            },
+            {
+              "value"=> "mhashimoto@plaxo.com",
+              "type"=> "home"
+            }
+          ]
+        end
+      
+        it "should have email" do
+          @entry.email.should=="mhashimoto-04@plaxo.com"
+        end
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'portablecontacts'
+require 'spec'
+require 'spec/autorun'
+
+Spec::Runner.configure do |config|
+  
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification 
+name: portablecontacts
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Pelle Braendgaard
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-02 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: oauth
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.3.6
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: json
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: A client library for the portable contacts standard
+email: pelleb@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/portable_contacts.rb
+- lib/portablecontacts.rb
+- portablecontacts.gemspec
+- spec/fixtures/multiple.json
+- spec/fixtures/single.json
+- spec/portable_contacts_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/pelle/portablecontacts
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: portablecontact
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Portable Contacts client for Ruby
+test_files: 
+- spec/portable_contacts_spec.rb
+- spec/spec_helper.rb