google_contacts_api 0.7.0 → 0.7.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: dd239c2ecad17fa5fb9ca5f01cfda0bf248cb5c5
+  data.tar.gz: 2dc497813f158780edc3741290dcb564d634fcb5
+SHA512:
+  metadata.gz: 45c49f64438e64b67cfadfce88c18b2c77941dd1134782f881fff5e8542f7b1dceffa415840d7027d1271d868cce2bd752e35a02395c30d05c98b129b2506eec
+  data.tar.gz: feec2067b0542e8c270b2f9f3eb5bf38a1c47e5514480e977b47742ad6a85935a6be03283b3bd64c2b5836b0b3fd7a521a1038d4e82cad97ef393e7389ee0ef6

data/.rspec

@@ -0,0 +1,3 @@
+--format progress
+--require spec_helper
+--color

data/README.markdown

@@ -80,6 +80,6 @@ by jeweler).
 
 Copyright (c) 2011-15 Alvin Liang (aliang). See LICENSE.txt for further details.
 
-Some code based on a few bugfixes in lfittl and fraudpointer forks.
-
-Support for Google Contacts API version 3 fields by draffensperger.
+* Some code based on a few bugfixes in lfittl and fraudpointer forks.
+* Support for Google Contacts API version 3 fields by draffensperger.
+* Additional specs and empty GroupSet entry fix by Jeiwan.

data/VERSION

@@ -1 +1 @@
-0.7.0
+0.7.1

data/google_contacts_api.gemspec

@@ -2,14 +2,16 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
+# stub: google_contacts_api 0.7.1 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "google_contacts_api"
-  s.version = "0.7.0"
+  s.version = "0.7.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib"]
   s.authors = ["Alvin Liang"]
-  s.date = "2015-07-24"
+  s.date = "2016-01-05"
   s.description = "Lets you read from the Google Contacts API. Posting to come later."
   s.email = "ayliang@gmail.com"
   s.extra_rdoc_files = [
@@ -18,6 +20,7 @@ Gem::Specification.new do |s|
   ]
   s.files = [
     ".document",
+    ".rspec",
     ".travis.yml",
     "Gemfile",
     "LICENSE.txt",
@@ -37,21 +40,30 @@ Gem::Specification.new do |s|
     "lib/google_contacts_api/result_set.rb",
     "lib/google_contacts_api/user.rb",
     "lib/google_contacts_api/version.rb",
-    "spec/contact_set.json",
-    "spec/empty_contact_set.json",
-    "spec/errors/auth_sub_401.html",
-    "spec/google_contacts_api_spec.rb",
-    "spec/group_set.json",
-    "spec/spec_helper.rb"
+    "spec/fixtures/contact_set.json",
+    "spec/fixtures/empty_contact_set.json",
+    "spec/fixtures/empty_group_set.json",
+    "spec/fixtures/group_set.json",
+    "spec/lib/google_contacts_api/api_spec.rb",
+    "spec/lib/google_contacts_api/contact_set_spec.rb",
+    "spec/lib/google_contacts_api/contact_spec.rb",
+    "spec/lib/google_contacts_api/contacts_spec.rb",
+    "spec/lib/google_contacts_api/group_set_spec.rb",
+    "spec/lib/google_contacts_api/group_spec.rb",
+    "spec/lib/google_contacts_api/groups_spec.rb",
+    "spec/lib/google_contacts_api/result_set_spec.rb",
+    "spec/lib/google_contacts_api/result_spec.rb",
+    "spec/lib/google_contacts_api/user_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/support/rspec_helpers.rb"
   ]
   s.homepage = "http://github.com/aliang/google_contacts_api"
   s.licenses = ["MIT"]
-  s.require_paths = ["lib"]
-  s.rubygems_version = "1.8.24"
+  s.rubygems_version = "2.4.8"
   s.summary = "Lets you read from the Google Contacts API"
 
   if s.respond_to? :specification_version then
-    s.specification_version = 3
+    s.specification_version = 4
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
       s.add_runtime_dependency(%q<activesupport>, [">= 0"])

data/lib/google_contacts_api/contacts.rb

@@ -26,4 +26,4 @@ module GoogleContactsApi
       GoogleContactsApi::ContactSet.new(response.body, @api)
     end
   end
-end
+end

data/lib/google_contacts_api/group_set.rb

@@ -3,7 +3,11 @@ module GoogleContactsApi
     # Initialize a GroupSet from an API response body that contains groups data
     def initialize(response_body, api = nil)
       super
-      @results = @parsed.feed.entry.map { |e| GoogleContactsApi::Group.new(e, nil, api) }
+      if @parsed.nil? || @parsed.feed.nil? || @parsed.feed.entry.nil?
+        @results = []
+      else
+        @results = @parsed.feed.entry.map { |e| GoogleContactsApi::Group.new(e, nil, api) }
+      end
     end
   end
-end
+end

data/spec/fixtures/empty_group_set.json

@@ -0,0 +1,72 @@
+{
+    "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/\"C0UESXY5eip7ImA9WhdTEkw.\"",
+        "id": {
+            "$t": "example@gmail.com"
+        },
+        "updated": {
+            "$t": "2011-07-09T11:33:28.822Z"
+        },
+        "category": [{
+            "scheme": "http://schemas.google.com/g/2005#kind",
+            "term": "http://schemas.google.com/contact/2008#group"
+        }],
+        "title": {
+            "$t": "Example User's Contact Groups"
+        },
+        "link": [{
+            "rel": "alternate",
+            "type": "text/html",
+            "href": "http://www.google.com/"
+        },
+        {
+            "rel": "http://schemas.google.com/g/2005#feed",
+            "type": "application/atom+xml",
+            "href": "https://www.google.com/m8/feeds/groups/example%40gmail.com/full"
+        },
+        {
+            "rel": "http://schemas.google.com/g/2005#post",
+            "type": "application/atom+xml",
+            "href": "https://www.google.com/m8/feeds/groups/example%40gmail.com/full"
+        },
+        {
+            "rel": "http://schemas.google.com/g/2005#batch",
+            "type": "application/atom+xml",
+            "href": "https://www.google.com/m8/feeds/groups/example%40gmail.com/full/batch"
+        },
+        {
+            "rel": "self",
+            "type": "application/atom+xml",
+            "href": "https://www.google.com/m8/feeds/groups/example%40gmail.com/full?alt\u003djson\u0026max-results\u003d25"
+        }],
+        "author": [{
+            "name": {
+                "$t": "Example User"
+            },
+            "email": {
+                "$t": "example@gmail.com"
+            }
+        }],
+        "generator": {
+            "version": "1.0",
+            "uri": "http://www.google.com/m8/feeds",
+            "$t": "Contacts"
+        },
+        "openSearch$totalResults": {
+            "$t": "0"
+        },
+        "openSearch$startIndex": {
+            "$t": "1"
+        },
+        "openSearch$itemsPerPage": {
+            "$t": "25"
+        }
+    }
+}

data/spec/{group_set.json → fixtures/group_set.json}

@@ -210,4 +210,4 @@
             }]
         }]
     }
-}
+}

data/spec/lib/google_contacts_api/api_spec.rb

@@ -0,0 +1,88 @@
+class MockOAuth2Error < StandardError
+  attr_accessor :response
+  
+  def initialize(response)
+    @response = response
+  end
+end
+
+describe GoogleContactsApi::Api do
+  describe '#get' do
+    context 'when all parameters are correct' do
+      before do
+        @oauth = double("oauth")
+        allow(@oauth).to receive(:get).and_return("get response")
+        @api = GoogleContactsApi::Api.new(@oauth)
+      end
+
+      context 'when version is not specified' do
+        it 'performs a get request using oauth returning json with version 3' do
+          expect(@oauth).to receive(:get).with(
+            GoogleContactsApi::Api::BASE_URL + "any_url?alt=json&param=param&v=3", {"header" => "header"})
+
+          expect(@api.get("any_url",
+            {"param" => "param"},
+            {"header" => "header"})).to eq("get response")
+        end
+      end
+
+      context 'when version is specified' do
+        it 'performs a get request using oauth with the version specified' do
+          expect(@oauth).to receive(:get).with(
+            GoogleContactsApi::Api::BASE_URL + "any_url?alt=json&param=param&v=2", {"header" => "header"})
+
+          expect(@api.get("any_url",
+            {"param" => "param", "v" => "2"},
+            {"header" => "header"})).to eq("get response")
+        end
+      end
+    end
+
+    context 'when OAuth 1.0 returns unauthorized' do
+      before do
+        @oauth = double("oauth")
+        allow(@oauth).to receive(:get).and_return(Net::HTTPUnauthorized.new("1.1", 401, "You're not authorized"))
+        @api = GoogleContactsApi::Api.new(@oauth)
+      end
+
+      it 'raises UnauthorizedError' do
+        expect { @api.get("any url",
+          {"param" => "param"},
+          {"header" => "header"}) }.to raise_error(GoogleContactsApi::UnauthorizedError)
+      end
+    end
+
+    context 'when OAuth 2.0 returns unauthorized' do
+      before do
+        @oauth = double("oauth")
+        allow(@oauth).to receive(:get).and_raise(MockOAuth2Error.new(OpenStruct.new(status: 401)))
+        @api = GoogleContactsApi::Api.new(@oauth)
+      end
+
+      it 'raises UnauthorizedError' do
+        expect { @api.get("any url",
+          {"param" => "param"},
+          {"header" => "header"}) }.to raise_error(GoogleContactsApi::UnauthorizedError)
+      end
+    end
+  end
+
+  describe "#parse_response_code" do
+    before(:all) do
+      @Oauth = Struct.new(:code)
+      @Oauth2 = Struct.new(:status)
+    end
+
+    it 'parses oauth gem response' do
+      expect(GoogleContactsApi::Api.parse_response_code(@Oauth.new("401"))).to eq(401)
+    end
+
+    it 'parses oauth2 gem response' do
+      expect(GoogleContactsApi::Api.parse_response_code(@Oauth2.new(401))).to eq(401)
+    end
+  end
+
+  pending "should perform a post request using oauth"
+  pending "should perform a put request using oauth"
+  pending "should perform a delete request using oauth"
+end

data/spec/lib/google_contacts_api/contact_set_spec.rb

@@ -0,0 +1,39 @@
+describe GoogleContactsApi::ContactSet do
+  context "when entries are present" do
+    before(:all) do
+      @contact_set_json = contact_set_json
+      @contact_set = GoogleContactsApi::ContactSet.new(@contact_set_json)
+    end
+
+    specify "the right starting index is set" do
+      expect(@contact_set.start_index).to eq(1)
+    end
+
+    specify "the right number of results per page is set" do
+      expect(@contact_set.items_per_page).to eq(25)
+    end
+
+    specify "the right number of total results is set" do
+      expect(@contact_set.total_results).to eq(500)
+    end
+
+    specify "results are parsed into Contacts" do
+      expect(@contact_set.to_a.first).to be_instance_of(GoogleContactsApi::Contact)
+    end
+  end
+
+  context "when entries are not present" do
+    before(:all) do
+      @empty_contact_set_json = empty_contact_set_json
+      @empty_contact_set = GoogleContactsApi::ContactSet.new(@empty_contact_set_json)
+    end
+
+    specify "totals_results is equal to 0" do
+      expect(@empty_contact_set.total_results).to eq(0)
+    end
+
+    specify "@results variable is an empty array" do
+      expect(@empty_contact_set.instance_variable_get("@results")).to eq([])
+    end
+  end
+end

data/spec/lib/google_contacts_api/contact_spec.rb

@@ -0,0 +1,420 @@
+describe GoogleContactsApi::Contact do
+  subject { GoogleContactsApi::Contact.new(contact_json_hash) }
+
+  describe "#self_link" do
+    it "returns correct self_link" do
+      expect(subject.self_link).to eq("https://www.google.com/m8/feeds/contacts/example%40gmail.com/full/0")
+    end
+  end
+
+  describe "#photo_link_entry" do
+    it "returns correct photo_link_entry" do
+      expect(subject.photo_link_entry).to eq({
+        "rel" => "http://schemas.google.com/contacts/2008/rel#photo",
+        "type" => "image/*",
+        "href" => "https://www.google.com/m8/feeds/photos/media/example%40gmail.com/0",
+        "gd$etag" => "\"dxt2DAEZfCp7ImA-AV4zRxBoPG4UK3owXBM.\""
+      })
+    end
+  end
+
+  describe "#photo_link" do
+    it "returns correct photo_link" do
+      expect(subject.photo_link).to eq("https://www.google.com/m8/feeds/photos/media/example%40gmail.com/0")
+    end
+  end
+
+  describe "#edit_link" do
+    it "returns correct edit_link" do
+      expect(subject.edit_link).to eq("https://www.google.com/m8/feeds/contacts/example%40gmail.com/full/0")
+    end
+  end
+
+  describe "#edit_photo_link" do
+    it "returns correct edit_photo_link" do
+      # TODO: there isn't one in this contact, hahah
+      expect(subject.edit_photo_link).to eq(nil)
+    end
+  end
+
+  describe "#photo" do
+    it "fetches a photo" do
+      @oauth = double("oauth")
+      allow(@oauth).to receive(:get).and_return(Hashie::Mash.new({
+        "body" => "some response", # could use example response here
+        "code" => 200
+      }))
+      @api = double("api")
+      allow(@api).to receive(:oauth).and_return(@oauth)
+      @contact = GoogleContactsApi::Contact.new(contact_json_hash, nil, @api)
+
+      expect(@oauth).to receive("get").with(@contact.photo_link)
+
+      @contact.photo
+    end
+  end
+
+  describe "#photo_with_metadata" do
+    it "returns photo with metadata" do
+      @oauth = double("oauth")
+      allow(@oauth).to receive(:get).and_return(Hashie::Mash.new({
+        "body" => "some response",
+        "code" => 200,
+        "headers" => { "content-type" => "image/jpeg" }
+      }))
+      @api = double("api")
+      allow(@api).to receive(:oauth).and_return(@oauth)
+      @contact = GoogleContactsApi::Contact.new(contact_json_hash, nil, @api)
+
+      expect(@oauth).to receive("get").with(@contact.photo_link)
+      expect(@contact.photo_with_metadata).to eq(
+        data: 'some response',
+        etag: 'dxt2DAEZfCp7ImA-AV4zRxBoPG4UK3owXBM.',
+        content_type: 'image/jpeg'
+      )
+    end
+  end
+
+  describe "#emails" do
+    context 'when emails are specified' do
+      it "returns an array of emails" do
+        expect(subject.emails).to eq(["contact1@example.com"])
+      end
+    end
+
+    context 'when emails are not specified' do
+      it "returns an empty array" do
+        @contact = GoogleContactsApi::Contact.new(contact_no_emails_json_hash)
+        expect(@contact.emails).to eq([])
+      end
+    end
+  end
+
+  describe "#primary_email" do
+    context "when primary email is set" do
+      it "returns correct primary email" do
+        expect(subject.primary_email).to eq("contact1@example.com")
+      end
+    end
+
+    context "when primary email is not set" do
+      it "returns nil" do
+        @contact2 = GoogleContactsApi::Contact.new(contact_no_emails_json_hash)
+        expect(@contact2.primary_email).to be_nil
+        @contact3 = GoogleContactsApi::Contact.new(contact_no_primary_email_json_hash)
+        expect(@contact3.primary_email).to be_nil
+      end
+    end
+  end
+
+  describe "#ims" do
+    context "when instant messaging accounts are specified" do
+      it "returns instan messaging accounts" do
+        expect(subject.ims).to eq(["contact1@example.com"])
+      end
+    end
+
+    context "when instant messaging accounts are not specified" do
+      it "returns an empty array" do
+        @contact = GoogleContactsApi::Contact.new(contact_no_emails_json_hash)
+        expect(@contact.ims).to eq([])
+      end
+    end
+  end
+
+  #
+  describe 'Contacts API v3 fields' do
+    before do
+      @empty = GoogleContactsApi::Contact.new
+
+      @partly_empty = GoogleContactsApi::Contact.new(
+        'gd$name' => {},
+        'gContact$relation' => []        
+      )
+
+      @contact_v3 = GoogleContactsApi::Contact.new(
+        'gd$name' => {
+          'gd$givenName' => { '$t' => 'John' },
+          'gd$familyName' => { '$t' => 'Doe' },
+          'gd$fullName' => { '$t' => 'John Doe' }
+        },
+        'gContact$birthday' => {
+          'when' => '1988-05-12'
+        },
+        'gContact$relation' => [ { '$t' => 'Jane', 'rel' => 'spouse' } ],
+        'gd$structuredPostalAddress' => [
+          {
+            'gd$country' => { '$t' => 'United States of America' },
+            'gd$formattedAddress' => { '$t' => "2345 Long Dr. #232\nSomwhere\nIL\n12345\nUnited States of America" },
+            'gd$city' => { '$t' => 'Somwhere' },
+            'gd$street' => { '$t' => '2345 Long Dr. #232' },
+            'gd$region' => { '$t' => 'IL' },
+            'gd$postcode' => { '$t' => '12345' }
+          },
+          {
+            'rel' => 'http://schemas.google.com/g/2005#home',
+            'primary' => 'true',
+            'gd$country' => { '$t' => 'United States of America' },
+            'gd$formattedAddress' => { '$t' => "123 Far Ln.\nAnywhere\nMO\n67891\nUnited States of America" },
+            'gd$city' => { '$t' => 'Anywhere' },
+            'gd$street' => { '$t' => '123 Far Ln.' }
+          }
+        ],
+        'gd$email' => [
+          {
+            'primary' => 'true',
+            'rel' => 'http://schemas.google.com/g/2005#other',
+            'address' => 'johnsmith@example.com'
+          }
+        ],
+        'gd$phoneNumber' => [
+          {
+            'primary' => 'true',
+            '$t' => '(123) 334-5158',
+            'rel' => 'http://schemas.google.com/g/2005#mobile'
+          }
+        ],
+        'gd$organization' => [
+          {
+            'gd$orgTitle' => { '$t' => 'Worker Person' },
+            'gd$orgName' => { '$t' => 'Example, Inc' },
+            'rel' => 'http://schemas.google.com/g/2005#other'
+          }
+        ],
+        'gContact$groupMembershipInfo' => [
+          {
+            'deleted' => 'false',
+            'href' => 'http://www.google.com/m8/feeds/groups/test.user%40gmail.com/base/111'
+          },
+          {
+            'deleted' => 'true',
+            'href' => 'http://www.google.com/m8/feeds/groups/test.user%40gmail.com/base/222'
+          }
+        ]
+      )
+    end
+
+    describe '#nested_t_field_or_nil' do
+      context "when nested fields are present" do
+        it "returns correct value" do
+          expect(@contact_v3.nested_t_field_or_nil('gd$name', 'gd$givenName')).to eq('John')
+        end
+      end
+
+      context "when nested fields are not present" do
+        it "returns nil" do
+          expect(@empty.nested_t_field_or_nil('gd$name', 'gd$givenName')).to be_nil
+          expect(@partly_empty.nested_t_field_or_nil('gd$name', 'gd$givenName')).to be_nil
+        end
+      end
+    end
+
+    describe "#given_name" do
+      it "returns given name" do
+        expect(@contact_v3.given_name).to eq('John')
+      end
+    end
+
+    describe "#family_name" do
+      it "returns family name" do
+        expect(@contact_v3.family_name).to eq('Doe')
+      end
+    end
+
+    describe "#full_name" do
+      it "returns full name" do
+        expect(@contact_v3).to receive(:nested_t_field_or_nil).with('gd$name', 'gd$fullName').and_return('val')
+        expect(@contact_v3.full_name).to eq('val')
+      end
+    end
+
+    describe "#phone_numbers" do
+      it "returns an array of phone numbers" do
+        expect(@contact_v3.phone_numbers).to eq ["(123) 334-5158"]
+      end
+    end
+
+    describe "#relations" do
+      context "when relations are set" do
+        it "returns relations" do
+          expect(@contact_v3.relations).to eq([ { '$t' => 'Jane', 'rel' => 'spouse' } ])
+        end
+      end
+
+      context "when relations are not set" do
+        it "returns an empty array" do
+          expect(@empty.relations).to eq([])
+          expect(@partly_empty.relations).to eq([])
+        end
+      end
+    end
+
+    describe "#spouse" do
+      context "when spouse is set" do
+        it "returns spouse" do
+          expect(@contact_v3.spouse).to eq('Jane')
+        end
+      end
+
+      context "when spouse is not set" do
+        it "returns nil" do
+          expect(@empty.spouse).to be_nil
+          expect(@partly_empty.spouse).to be_nil
+        end
+      end
+    end
+
+    describe "#birthday" do
+      context "when full birthday is set" do
+        it "returns full birthday" do
+          expect(@contact_v3.birthday).to eq({ year: 1988, month: 5, day: 12 })
+        end
+      end
+
+      context "when year is not specified" do
+        it "returns partial birthday" do
+          contact_birthday_no_year = GoogleContactsApi::Contact.new('gContact$birthday' => { 'when' => '--05-12' })
+          expect(contact_birthday_no_year.birthday).to eq({ year: nil, month: 5, day: 12 })
+        end
+      end
+
+      context "when birthday is not set" do
+        it "returns nil" do
+          expect(@empty.birthday).to be_nil
+        end
+      end
+    end
+
+    describe "#addresses" do
+      context "when addresses are specified" do
+        it "returns addresses" do
+          formatted_addresses = [
+            { rel: 'work', primary: false, country: 'United States of America', city: 'Somwhere', street: '2345 Long Dr. #232',
+              region: 'IL', postcode: '12345' },
+            { rel: 'home', primary: true, country: 'United States of America', city: 'Anywhere', street: '123 Far Ln.',
+              region: nil, postcode: nil }
+          ]
+          expect(@contact_v3.addresses).to eq(formatted_addresses)
+        end
+      end
+
+      context "when addresses are not specified" do
+        it "returns an empty arary" do
+          expect(@empty.addresses).to eq([])
+        end
+      end
+    end
+
+    describe "#phone_numbers_full" do
+      context "when phone numbers are specified" do
+        it "returns full phone numbers" do
+          expect(@contact_v3.phone_numbers_full).to eq([ { :primary => true, :number => '(123) 334-5158', :rel => 'mobile' } ])
+        end
+      end
+
+      context "when phone numbers are not specified" do
+        it "returns an empty array" do
+          expect(@empty.phone_numbers_full).to eq([])
+        end
+      end
+    end
+
+    describe "#gourp_membership_info" do
+      context "when gourp membership info is specified" do
+        it "returns gourp membership info" do
+          group_membership_info = [
+            { deleted: false, href: 'http://www.google.com/m8/feeds/groups/test.user%40gmail.com/base/111' },
+            { deleted: true, href: 'http://www.google.com/m8/feeds/groups/test.user%40gmail.com/base/222' }
+          ]
+          expect(@contact_v3.group_membership_info).to eq(group_membership_info)
+        end
+      end
+
+      context "when gourp membership info is not specified" do
+        it "returns an empty array" do
+          expect(@empty.group_membership_info).to eq([])
+        end
+      end
+    end
+
+    describe "#organizations" do
+      context "when organizations are specified" do
+        it "returns organizations" do
+          formatted_organizations = [
+            {
+              org_title: 'Worker Person',
+              org_name: 'Example, Inc',
+              primary: false,
+              rel: 'other'
+            }
+          ]
+          expect(@contact_v3.organizations).to eq(formatted_organizations)
+        end
+      end
+
+      context "when organizations is not specified" do
+        it "returns an empty array" do
+          expect(@empty.organizations).to eq([])
+        end
+      end
+    end
+
+    describe "#emails_full" do
+      context "when emails are specified" do
+        it "returns emails" do
+          expect(@contact_v3.emails_full).to eq([ { :primary => true, :address => 'johnsmith@example.com', :rel => 'other' } ])
+        end
+      end
+
+      context "when emails is not specified" do
+        it "returns an empty array" do
+          expect(@empty.emails_full).to eq([])
+        end
+      end
+    end
+
+    describe '#group_memberships' do
+      it "returns group memberships" do
+        expect(@contact_v3.group_memberships).to eq(['http://www.google.com/m8/feeds/groups/test.user%40gmail.com/base/111'])
+      end
+    end
+
+    describe "#deleted_group_memberships" do
+      it "returns deleted group memberships" do
+        expect(@contact_v3.deleted_group_memberships).to eq(['http://www.google.com/m8/feeds/groups/test.user%40gmail.com/base/222'])
+      end
+    end
+  end
+
+  # The Google Contacts API (https://developers.google.com/gdata/docs/2.0/elements)
+  # specifies an optional yomi field for orgName, givenName, additionalName and familyName
+  it 'handles Japanese yomigana "yomi" name values' do
+    contact_params = {
+      'gd$name' => {
+        'gd$givenName' => {'$t' => 'John' },
+        'gd$additionalName' => {'$t' => 'Text name', 'yomi' => 'And yomi chars' },
+        'gd$familyName' => { 'yomi' => 'Yomi chars only' },
+      },
+      'gd$organization' => [{
+        'rel' => 'http://schemas.google.com/g/2005#other',
+        'primary' => 'true',
+        'gd$orgName' => {
+          'yomi' => 'Yomigana'
+        }
+      }],
+    }
+    contact = GoogleContactsApi::Contact.new(contact_params, nil, @api)
+
+    expect(contact.given_name).to eq('John')
+    expect(contact.given_name_yomi).to be_nil
+
+    expect(contact.additional_name).to eq('Text name')
+    expect(contact.additional_name_yomi).to eq('And yomi chars')
+
+    expect(contact.family_name).to be_nil
+    expect(contact.family_name_yomi).to eq('Yomi chars only')
+
+    expect(contact.organizations.first[:org_name]).to be_nil
+    expect(contact.organizations.first[:org_name_yomi]).to eq('Yomigana')
+  end
+end