gmail_contacts 1.0

data/.document

@@ -0,0 +1,3 @@
+History.txt
+README.txt
+lib

data/History.txt

@@ -0,0 +1,6 @@
+=== 1.0.0 / 2009-04-08
+
+* 1 major enhancement
+
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,9 @@
+.document
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/gmail_contacts.rb
+lib/gmail_contacts/test_stub.rb
+sample/authsub.rb
+test/test_gmail_contacts.rb

data/README.txt

@@ -0,0 +1,51 @@
+= gmail_contacts
+
+* http://seattlerb.rubyforge.org/gmail_contacts
+
+== DESCRIPTION:
+
+Simple Gmail contacts extraction using GData.
+
+gmail_contacts development was sponsored by AT&T Interactive.
+
+== FEATURES/PROBLEMS:
+
+* Lets you extract contacts from GMail
+
+== SYNOPSIS:
+
+See sample/authsub.rb
+
+== REQUIREMENTS:
+
+* gdata gem
+* Gmail account
+
+== INSTALL:
+
+* sudo gem install gmail_contacts
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2009 Eric Hodel
+
+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/Rakefile

@@ -0,0 +1,15 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/gmail_contacts.rb'
+
+Hoe.new('gmail_contacts', GmailContacts::VERSION) do |p|
+  p.rubyforge_name = 'seattlerb' # if different than lowercase project name
+  p.developer 'Eric Hodel', 'drbrain@segment7.net'
+
+  p.extra_deps << ['gdata', '~> 1.0']
+  p.extra_deps << ['nokogiri', '~> 1.2']
+end
+
+# vim: syntax=Ruby

data/lib/gmail_contacts/test_stub.rb

@@ -0,0 +1,209 @@
+require 'gmail_contacts'
+
+##
+# Handy data files and GData modifications that allow GmailContacts to be
+# more easily tested
+#
+# To setup:
+#
+#   require 'gmail_contacts'
+#   require 'gmail_contacts/test_stub'
+#   
+#   class TestMyClass < Test::Unit::TestCase
+#     def test_something
+#       GmailContacts.stub
+#   
+#       # ... your code using gc
+#   
+#     end
+#   end
+#
+# If you set the authsub token to 'recycled_authsub_token', the test stub will
+# raise a GData::Client::AuthorizationError.
+
+class GmailContacts::TestStub
+
+  ##
+  # First page of contacts
+
+  CONTACTS = <<-ATOM
+<?xml version="1.0" encoding="UTF-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:gContact="http://schemas.google.com/contact/2008" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" gd:etag="W/&quot;CEMBRHY6fSp7ImA9WxVUGEk.&quot;">
+  <id>eric@example.com</id>
+  <updated>2009-03-23T21:07:35.815Z</updated>
+  <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/contact/2008#contact"/>
+  <title>drbrain's Contacts</title>
+  <link rel="alternate" type="text/html" href="http://www.google.com/"/>
+  <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://www.google.com/m8/feeds/contacts/eric%40example.com/full"/>
+  <link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="http://www.google.com/m8/feeds/contacts/eric%40example.com/full"/>
+  <link rel="http://schemas.google.com/g/2005#batch" type="application/atom+xml" href="http://www.google.com/m8/feeds/contacts/eric%40example.com/full/batch"/>
+  <link rel="self" type="application/atom+xml" href="http://www.google.com/m8/feeds/contacts/eric%40example.com/full?max-results=2"/>
+  <link rel="next" type="application/atom+xml" href="http://www.google.com/m8/feeds/contacts/eric%40example.com/full?start-index=3&amp;max-results=2"/>
+  <author>
+    <name>drbrain</name>
+    <email>eric@example.com</email>
+  </author>
+  <generator version="1.0" uri="http://www.google.com/m8/feeds">Contacts</generator>
+  <openSearch:totalResults>3</openSearch:totalResults>
+  <openSearch:startIndex>1</openSearch:startIndex>
+  <openSearch:itemsPerPage>2</openSearch:itemsPerPage>
+  <entry gd:etag="&quot;SHg-cTVSLip7ImA9WB5WGUUIQgc.&quot;">
+    <id>http://www.google.com/m8/feeds/contacts/eric%40example.com/base/0</id>
+    <updated>2007-08-01T15:35:39.659Z</updated>
+    <app:edited xmlns:app="http://www.w3.org/2007/app">2007-08-01T15:35:39.659Z</app:edited>
+    <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/contact/2008#contact"/>
+    <title>Sean</title>
+    <link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*" href="http://www.google.com/m8/feeds/photos/media/eric%40example.com/0"/>
+    <link rel="self" type="application/atom+xml" href="http://www.google.com/m8/feeds/contacts/eric%40example.com/full/0"/>
+    <link rel="edit" type="application/atom+xml" href="http://www.google.com/m8/feeds/contacts/eric%40example.com/full/0"/>
+    <gd:email rel="http://schemas.google.com/g/2005#other" address="sean@example.com" primary="true"/>
+  </entry>
+  <entry gd:etag="&quot;QXk4fjVSLyp7ImA9WxVUGUwDRgE.&quot;">
+    <id>http://www.google.com/m8/feeds/contacts/eric%40example.com/base/18</id>
+    <updated>2009-03-24T18:25:50.736Z</updated>
+    <app:edited xmlns:app="http://www.w3.org/2007/app">2009-03-24T18:25:50.736Z</app:edited>
+    <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/contact/2008#contact"/>
+    <title>Eric</title>
+    <link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*" href="http://www.google.com/m8/feeds/photos/media/eric%40example.com/18" gd:etag="&quot;UD9rbkUqSip7ImBkJkcZdVBoHxkeNFMKV1E.&quot;"/>
+    <link rel="self" type="application/atom+xml" href="http://www.google.com/m8/feeds/contacts/eric%40example.com/full/18"/>
+    <link rel="edit" type="application/atom+xml" href="http://www.google.com/m8/feeds/contacts/eric%40example.com/full/18"/>
+    <gd:email rel="http://schemas.google.com/g/2005#other" address="eric@example.com" primary="true"/>
+    <gd:email rel="http://schemas.google.com/g/2005#other" address="eric@example.net"/>
+    <gd:im address="example" protocol="http://schemas.google.com/g/2005#AIM" rel="http://schemas.google.com/g/2005#other"/>
+    <gd:phoneNumber rel="http://schemas.google.com/g/2005#mobile">999 555 1212</gd:phoneNumber>
+    <gd:postalAddress rel="http://schemas.google.com/g/2005#home">123 Any Street
+AnyTown, ZZ 99999</gd:postalAddress>
+    <gContact:groupMembershipInfo deleted="false" href="http://www.google.com/m8/feeds/groups/eric%40example.com/base/6"/>
+  </entry>
+</feed>
+  ATOM
+
+  ##
+  # Second page of contacts
+
+  CONTACTS2 = <<-ATOM
+<?xml version="1.0" encoding="UTF-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:gContact="http://schemas.google.com/contact/2008" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" gd:etag="W/&quot;CEYFQXkzfCp7ImA9WxVUGEg.&quot;">
+  <id>eric@example.com</id>
+  <updated>2009-03-23T23:48:30.784Z</updated>
+  <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/contact/2008#contact"/>
+  <title>drbrain's Contacts</title>
+  <link rel="alternate" type="text/html" href="http://www.google.com/"/>
+  <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://www.google.com/m8/feeds/contacts/eric%40example.com/full"/>
+  <link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="http://www.google.com/m8/feeds/contacts/eric%40example.com/full"/>
+  <link rel="http://schemas.google.com/g/2005#batch" type="application/atom+xml" href="http://www.google.com/m8/feeds/contacts/eric%40example.com/full/batch"/>
+  <link rel="self" type="application/atom+xml" href="http://www.google.com/m8/feeds/contacts/eric%40example.com/full?start-index=3&amp;max-results=2"/>
+  <link rel="previous" type="application/atom+xml" href="http://www.google.com/m8/feeds/contacts/eric%40example.com/full?start-index=1&amp;max-results=2"/>
+  <author>
+    <name>drbrain</name>
+    <email>eric@example.com</email>
+  </author>
+  <generator version="1.0" uri="http://www.google.com/m8/feeds">Contacts</generator>
+  <openSearch:totalResults>3</openSearch:totalResults>
+  <openSearch:startIndex>3</openSearch:startIndex>
+  <openSearch:itemsPerPage>2</openSearch:itemsPerPage>
+  <entry gd:etag="&quot;QXk_fTVSLyp7ImA9WxVUFUQITgA.&quot;">
+    <id>http://www.google.com/m8/feeds/contacts/eric%40example.com/base/5834fb5d0b47bfd7</id>
+    <updated>2009-03-20T23:49:00.745Z</updated>
+    <app:edited xmlns:app="http://www.w3.org/2007/app">2009-03-20T23:49:00.745Z</app:edited>
+    <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/contact/2008#contact"/>
+    <title>Coby</title>
+    <link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*" href="http://www.google.com/m8/feeds/photos/media/eric%40example.com/5834fb5d0b47bfd7" gd:etag="&quot;eRJhPnolbCp7ImBjG0U0GBtuHmVAdnsJYzM.&quot;"/>
+    <link rel="self" type="application/atom+xml" href="http://www.google.com/m8/feeds/contacts/eric%40example.com/full/5834fb5d0b47bfd7"/>
+    <link rel="edit" type="application/atom+xml" href="http://www.google.com/m8/feeds/contacts/eric%40example.com/full/5834fb5d0b47bfd7"/>
+    <gd:email rel="http://schemas.google.com/g/2005#other" address="coby@example.com" primary="true"/>
+    <gContact:groupMembershipInfo deleted="false" href="http://www.google.com/m8/feeds/groups/eric%40example.com/base/6"/>
+  </entry>
+</feed>
+  ATOM
+
+end
+
+# :stopdoc:
+class GmailContacts
+
+  @stubbed = false
+
+  def self.stub
+    return if @stubbed
+    @stubbed = true
+
+    alias old_get_token get_token
+
+    def get_token
+      if @authsub_token == 'recycled_authsub_token' then
+        raise GData::Client::AuthorizationError, 'recycled token'
+      end
+      old_get_token
+      @contact_api.stub_reset
+      @contact_api.stub_data << GmailContacts::TestStub::CONTACTS
+      @contact_api.stub_data << GmailContacts::TestStub::CONTACTS2
+    end
+  end
+
+end
+# :startdoc:
+
+##
+# Extension that provides a stub for testing GmailContacts
+#
+# See GmailContacts::TestStub for usage details
+
+class GData::Client::Contacts
+
+  ##
+  # Accessor for data the stub will return
+
+  attr_accessor :stub_data
+
+  ##
+  # Accessor for the stub AuthSub token
+
+  attr_accessor :stub_token
+
+  ##
+  # Accessor for URLs the stub accessed
+
+  attr_accessor :stub_urls
+
+  ##
+  # Sets the authsub token to +token+, but does no HTTP requests
+
+  def authsub_token=(token)
+    @stub_token = token
+    auth_handler = Object.new
+    def auth_handler.upgrade() @upgraded = true end
+    def auth_handler.upgraded?() @upgraded end
+    def auth_handler.revoke() @revoked = true end
+    def auth_handler.revoked?() @revoked end
+    self.auth_handler = auth_handler
+  end
+
+  ##
+  # Fetches +url+, records in in stub_urls, and returns data if there's still
+  # data in stub_data, or raises an exception
+
+  def get(url)
+    @stub_urls << url
+    raise 'stub data empty' if @stub_data.empty?
+
+    data = @stub_data.shift
+
+    return data.call if Proc === data
+
+    res = Object.new
+    def res.body() @data end
+    res.instance_variable_set :@data, data
+    res
+  end
+
+  ##
+  # Resets the stub to empty
+
+  def stub_reset
+    @stub_urls = []
+    @stub_data = []
+  end
+
+end
+

data/lib/gmail_contacts.rb

@@ -0,0 +1,228 @@
+require 'rubygems'
+require 'gdata'
+require 'nokogiri'
+
+##
+# GmailContacts sits atop GData and turns the contact feed into
+# GmailContacts::Contact objects for friendly consumption.
+#
+# GmailContacts was sponsored by AT&T Interactive.
+
+class GmailContacts
+
+  VERSION = '1.0'
+
+  Contact = Struct.new :title, :emails, :ims, :phone_numbers, :addresses
+
+  ##
+  # Struct containing title, emails, ims, phone_numbers and addresses
+
+  class Contact
+
+    def pretty_print(q) # :nodoc:
+      q.text "#{title}"
+      q.breakable
+
+      q.group 2 do
+        q.breakable
+        q.group 2, 'emails: ' do
+          emails.each_with_index do |email, i|
+            unless i == 0 then
+              q.text ','
+              q.breakable
+            end
+
+            email += " (Primary)" if i == 0
+            q.text email
+          end
+        end
+
+        q.breakable
+        q.group 2, 'ims: ' do
+          ims.each_with_index do |(address, type), i|
+            unless i == 0 then
+              q.text ','
+              q.breakable
+            end
+
+            q.text "#{address} (#{type.sub(/.*#/, '')})"
+          end
+        end
+
+        q.breakable
+        q.group 2, 'phone numbers: ' do
+          phone_numbers.each_with_index do |(number, type), i|
+            unless i == 0 then
+              q.text ','
+              q.breakable
+            end
+
+            q.text "#{number} (#{type.sub(/.*#/, '')})"
+          end
+        end
+
+        q.breakable
+        addresses.each do |address, type|
+          q.group 2, "#{type.sub(/.*#/, '')} address:\n" do
+            address = address.split("\n").each do |line|
+              q.text "#{' ' * q.indent}#{line}\n"
+            end
+          end
+        end
+      end
+    end
+
+    ##
+    # Returns the user's primary email address
+
+    def primary_email
+      emails.first
+    end
+
+  end
+
+  ##
+  # Contact list author's email
+
+  attr_reader :author_email
+
+  ##
+  # Contact list author's name
+
+  attr_reader :author_name
+
+  ##
+  # GData::Client::Contacts object accessor for testing
+
+  attr_accessor :contact_api # :nodoc:
+
+  ##
+  # Contact data
+  #
+  # An Array with contact title, primary email and alternate emails
+
+  attr_reader :contacts
+
+  ##
+  # Contacts list identifier
+
+  attr_reader :id
+
+  ##
+  # Contacts list title
+
+  attr_reader :title
+
+  ##
+  # Creates a new GmailContacts using +authsub_token+.  If you don't yet have
+  # an AuthSub token, call <tt>contact_api.auth_url</tt> providing your return
+  # endpoint.
+  #
+  # See GData::Client::Base in the gdata gem and
+  # http://code.google.com/apis/accounts/docs/AuthSub.html for more details.
+
+  def initialize(authsub_token = nil)
+    @authsub_token = authsub_token
+    @session_token = false
+
+    @id = nil
+    @title = nil
+    @author_email = nil
+    @author_name = nil
+    @contacts ||= []
+
+    @contact_api = GData::Client::Contacts.new
+  end
+
+  ##
+  # Fetches contacts from google for +email+.
+
+  def fetch(email)
+    get_token
+
+    uri = "http://www.google.com/m8/feeds/contacts/#{email}/full"
+
+    loop do
+      res = @contact_api.get uri
+
+      xml = Nokogiri::XML res.body
+
+      parse xml
+
+      next_uri = xml.xpath('//xmlns:feed/xmlns:link[@rel="next"]').first
+      break unless next_uri
+
+      uri = next_uri['href']
+    end
+  ensure
+    revoke_token if token?
+  end
+
+  ##
+  # Fetches an AuthSub session token
+
+  def get_token
+    @contact_api.authsub_token = @authsub_token
+    @contact_api.auth_handler.upgrade
+    @session_token = true
+  end
+
+  ##
+  # Extracts contact information from +xml+, appending it to the current
+  # contact information
+
+  def parse(xml)
+    @id    = xml.xpath('//xmlns:feed/xmlns:id').first.text
+    @title = xml.xpath('//xmlns:feed/xmlns:title').first.text
+
+    @author_email =
+      xml.xpath('//xmlns:feed/xmlns:author/xmlns:email').first.text
+    @author_name = xml.xpath('//xmlns:feed/xmlns:author/xmlns:name').first.text
+
+    xml.xpath('//xmlns:feed/xmlns:entry').each do |entry|
+      title = entry.xpath('.//xmlns:title').first.text
+      emails = []
+      emails << entry.xpath('.//gd:email[@primary]').first['address']
+      alternates = entry.xpath('.//gd:email[not(@primary)]')
+
+      emails.push(*alternates.map { |e| e['address'] })
+
+      ims = []
+      entry.xpath('.//gd:im').each do |im|
+        ims << [im['address'], im['protocol']]
+      end
+
+      phones = []
+      entry.xpath('.//gd:phoneNumber').each do |phone|
+        phones << [phone.text, phone['rel']]
+      end
+
+      addresses = []
+      entry.xpath('.//gd:postalAddress').each do |address|
+        addresses << [address.text, address['rel']]
+      end
+
+      contact = Contact.new title, emails, ims, phones, addresses
+
+      @contacts << contact
+    end
+
+    self
+  end
+
+  ##
+  # Revokes our AuthSub token
+
+  def revoke_token
+    @contact_api.auth_handler.revoke
+  end
+
+  ##
+  # Do we have an AuthSub session token?
+
+  def token?
+    @session_token
+  end
+
+end
+

data/sample/authsub.rb

@@ -0,0 +1,57 @@
+require 'rubygems'
+require 'webrick'
+require 'gmail_contacts'
+
+webrick = WEBrick::HTTPServer.new :Port => 3000
+
+webrick.mount_proc '/' do |req, res|
+  res.content_type = 'text/html'
+
+  if req.path == '/' then
+    res.body = <<-BODY
+<form action="http://#{Socket.gethostname}:3000/go">
+<input name="email">
+<input type="submit" value="go">
+</form>
+    BODY
+
+  elsif req.path == '/go' then
+    gmail_contacts = GmailContacts.new
+    url = gmail_contacts.contact_api.authsub_url \
+      "http://#{Socket.gethostname}:3000/return?email=#{req.query['email']}"
+    res.set_redirect WEBrick::HTTPStatus::SeeOther, url
+
+  elsif req.path == '/return' then
+    res.body = "<h1>contacts</h1>\n"
+
+    begin
+      gmail_contacts = GmailContacts.new req.query['token'].to_s
+
+      email = req.query['email']
+
+      gmail_contacts.fetch email
+
+      res.body << "<h1>contacts</h1>\n\n<ul>\n"
+
+      gmail_contacts.contacts.each do |contact|
+        res.body << "<li>#{contact.title} - #{contact.primary_email}\n"
+      end
+
+      res.body << "<\ul>\n"
+    rescue => e
+      res.body << <<-BODY
+<h1>error</h1>
+
+<p>#{e.message}
+
+<pre>#{e.backtrace.join "\n"}</pre>
+      BODY
+    end
+  end
+end
+
+trap 'INT'  do webrick.shutdown end
+trap 'TERM' do webrick.shutdown end
+
+webrick.start
+

data/test/test_gmail_contacts.rb

@@ -0,0 +1,112 @@
+require 'test/unit'
+require 'gmail_contacts'
+require 'gmail_contacts/test_stub'
+require 'pp'
+
+class TestGmailContacts < Test::Unit::TestCase
+
+  def setup
+    @gc = GmailContacts.new 'token'
+    @api = @gc.contact_api
+    @api.stub_reset
+
+    @eric =
+      GmailContacts::Contact.new('Eric', %w[eric@example.com eric@example.net],
+                                 [%w[example http://schemas.google.com/g/2005#AIM]],
+                                 [%w[999\ 555\ 1212 http://schemas.google.com/g/2005#mobile]],
+                                 [["123 Any Street\nAnyTown, ZZ 99999",
+                                   "http://schemas.google.com/g/2005#home"]])
+  end
+
+  def test_contact_pretty_print
+    str = ''
+    PP.pp @eric, str
+
+    expected = <<-EXPECTED
+Eric
+
+  emails: eric@example.com (Primary), eric@example.net
+  ims: example (AIM)
+  phone numbers: 999 555 1212 (mobile)
+  home address:
+    123 Any Street
+    AnyTown, ZZ 99999
+
+    EXPECTED
+
+    assert_equal expected, str
+  end
+
+  def test_fetch
+    @api.stub_data << GmailContacts::TestStub::CONTACTS
+    @api.stub_data << GmailContacts::TestStub::CONTACTS2
+
+    @gc.fetch 'eric@example.com'
+
+    assert_equal 3, @gc.contacts.length
+
+    assert_equal 2, @api.stub_urls.length
+    assert_equal 'http://www.google.com/m8/feeds/contacts/eric@example.com/full',
+                 @api.stub_urls.shift
+    assert_equal 'http://www.google.com/m8/feeds/contacts/eric%40example.com/full?start-index=3&max-results=2',
+                 @api.stub_urls.shift
+
+    assert @api.auth_handler.upgraded?
+    assert @api.auth_handler.revoked?
+  end
+
+  def test_fetch_forbidden
+    @api.stub_data << proc do
+      raise GData::Client::AuthorizationError
+    end
+
+    assert_raise GData::Client::AuthorizationError do
+      @gc.fetch 'notme@example.com'
+    end
+
+    assert_equal 0, @gc.contacts.length
+
+    assert_equal 1, @api.stub_urls.length
+    assert_equal 'http://www.google.com/m8/feeds/contacts/notme@example.com/full',
+                 @api.stub_urls.shift
+
+    assert @api.auth_handler.upgraded?
+    assert @api.auth_handler.revoked?
+  end
+
+  def test_parse
+    @gc.parse Nokogiri::XML(GmailContacts::TestStub::CONTACTS)
+
+    assert_equal 'eric@example.com', @gc.id
+    assert_equal 'drbrain\'s Contacts', @gc.title
+    assert_equal 'drbrain', @gc.author_name
+    assert_equal 'eric@example.com', @gc.author_email
+
+    expected = [
+      GmailContacts::Contact.new('Sean', %w[sean@example.com], [], [], []),
+      @eric
+    ]
+
+    assert_equal expected, @gc.contacts
+  end
+
+  def test_parse_two_pages
+    @gc.parse Nokogiri::XML(GmailContacts::TestStub::CONTACTS)
+    @gc.parse Nokogiri::XML(GmailContacts::TestStub::CONTACTS2)
+
+    assert_equal 'eric@example.com', @gc.id
+    assert_equal 'drbrain\'s Contacts', @gc.title
+    assert_equal 'drbrain', @gc.author_name
+    assert_equal 'eric@example.com', @gc.author_email
+
+    expected = [
+      GmailContacts::Contact.new('Sean', %w[sean@example.com], [], [], []),
+      @eric,
+      GmailContacts::Contact.new('Coby', %w[coby@example.com], [], [], []),
+    ]
+
+    assert_equal expected, @gc.contacts
+  end
+
+end
+

metadata

@@ -0,0 +1,120 @@
+--- !ruby/object:Gem::Specification 
+name: gmail_contacts
+version: !ruby/object:Gem::Version 
+  version: "1.0"
+platform: ruby
+authors: 
+- Eric Hodel
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDNjCCAh6gAwIBAgIBADANBgkqhkiG9w0BAQUFADBBMRAwDgYDVQQDDAdkcmJy
+  YWluMRgwFgYKCZImiZPyLGQBGRYIc2VnbWVudDcxEzARBgoJkiaJk/IsZAEZFgNu
+  ZXQwHhcNMDcxMjIxMDIwNDE0WhcNMDgxMjIwMDIwNDE0WjBBMRAwDgYDVQQDDAdk
+  cmJyYWluMRgwFgYKCZImiZPyLGQBGRYIc2VnbWVudDcxEzARBgoJkiaJk/IsZAEZ
+  FgNuZXQwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCbbgLrGLGIDE76
+  LV/cvxdEzCuYuS3oG9PrSZnuDweySUfdp/so0cDq+j8bqy6OzZSw07gdjwFMSd6J
+  U5ddZCVywn5nnAQ+Ui7jMW54CYt5/H6f2US6U0hQOjJR6cpfiymgxGdfyTiVcvTm
+  Gj/okWrQl0NjYOYBpDi+9PPmaH2RmLJu0dB/NylsDnW5j6yN1BEI8MfJRR+HRKZY
+  mUtgzBwF1V4KIZQ8EuL6I/nHVu07i6IkrpAgxpXUfdJQJi0oZAqXurAV3yTxkFwd
+  g62YrrW26mDe+pZBzR6bpLE+PmXCzz7UxUq3AE0gPHbiMXie3EFE0oxnsU3lIduh
+  sCANiQ8BAgMBAAGjOTA3MAkGA1UdEwQCMAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQW
+  BBS5k4Z75VSpdM0AclG2UvzFA/VW5DANBgkqhkiG9w0BAQUFAAOCAQEAHagT4lfX
+  kP/hDaiwGct7XPuVGbrOsKRVD59FF5kETBxEc9UQ1clKWngf8JoVuEoKD774dW19
+  bU0GOVWO+J6FMmT/Cp7nuFJ79egMf/gy4gfUfQMuvfcr6DvZUPIs9P/TlK59iMYF
+  DIOQ3DxdF3rMzztNUCizN4taVscEsjCcgW6WkUJnGdqlu3OHWpQxZBJkBTjPCoc6
+  UW6on70SFPmAy/5Cq0OJNGEWBfgD9q7rrs/X8GGwUWqXb85RXnUVi/P8Up75E0ag
+  14jEc90kN+C7oI/AGCBN0j6JnEtYIEJZibjjDJTSMWlUKKkj30kq7hlUC2CepJ4v
+  x52qPcexcYZR7w==
+  -----END CERTIFICATE-----
+
+date: 2009-04-08 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: gdata
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "1.0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "1.2"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.12.1
+    version: 
+description: |-
+  Simple Gmail contacts extraction using GData.
+  
+  gmail_contacts development was sponsored by AT&T Interactive.
+email: 
+- drbrain@segment7.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- .document
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- lib/gmail_contacts.rb
+- lib/gmail_contacts/test_stub.rb
+- sample/authsub.rb
+- test/test_gmail_contacts.rb
+has_rdoc: true
+homepage: http://seattlerb.rubyforge.org/gmail_contacts
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+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: seattlerb
+rubygems_version: 1.3.1.2162
+signing_key: 
+specification_version: 3
+summary: Simple Gmail contacts extraction using GData
+test_files: 
+- test/test_gmail_contacts.rb