googlecontacts 0.1.0

data/.document

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

data/.gitignore

@@ -0,0 +1,10 @@
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC
+.gitattributes
+.rvmrc
+script/console
+notes

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Pieter Noordhuis
+
+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.md

@@ -0,0 +1,41 @@
+*foo*
+
+
+
+
+    gc = GoogleContacts::Wrapper.new
+
+    gc.batch do
+      john = gc.contacts.find_by_email!('john@doe.com')
+
+      # Set this email as primary, overwriting other addresses
+      john.email = 'johnny@walker.com'
+      
+      # return primary email address (string)
+      puts john.email
+    
+      # Add email to the list
+      john.emails << 'fuckinghipster@hotmail.com'
+      
+      john.emails.push('fuckinghipster@hotmail.com', attrs)
+      
+      john.emails['fuckinghipster@hotmail.com'] = attrs
+      
+      # this removes any existing label
+      john.emails['fuckinghipster@hotmail.com'].rel   = 'blaat'
+      
+      # this removes any existing rel
+      john.emails['fuckinghipster@hotmail.com'].label = 'personal use'
+      
+      # access new email address. this can be used as a factory
+      # method to add new addresses
+      john.emails['thisonedidntexistyet@gmail.com'].primary!
+      
+      john.emails.delete('thisonedidntexistyet@gmail.com')
+      
+      
+      [:rel] = 'foo'
+      
+      # Set the last one as primary
+      john.emails.primary('fuckinghipster@hotmail.com')
+    end

data/README.rdoc

@@ -0,0 +1,17 @@
+= googlecontacts
+
+Description goes here.
+
+== 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) 2010 Pieter Noordhuis. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,49 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "googlecontacts"
+    gem.summary = %Q{Contacts API on steroids}
+    gem.description = %Q{Google Contacts API implementation}
+    gem.email = "pcnoordhuis@gmail.com"
+    gem.homepage = "http://github.com/pietern/googlecontacts"
+    gem.authors = ["Pieter Noordhuis"]
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    gem.add_runtime_dependency "activesupport", ">= 2.3.4"
+    gem.add_runtime_dependency "nokogiri", ">= 1.4.1"
+    gem.add_runtime_dependency "oauth", ">= 0.3.6"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: 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
+  spec.rcov_opts += ['--exclude', ENV['GEM_HOME']]
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "googlecontacts #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

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

data/lib/google_contacts.rb

@@ -0,0 +1,15 @@
+$:.unshift File.dirname(__FILE__)
+require 'rubygems'
+require 'active_support'
+require 'oauth'
+require 'nokogiri'
+
+require 'google_contacts/auth'
+require 'google_contacts/wrapper'
+require 'google_contacts/base'
+require 'google_contacts/contact'
+require 'google_contacts/group'
+
+require 'google_contacts/proxies/array'
+require 'google_contacts/proxies/hash'
+require 'google_contacts/proxies/emails'

data/lib/google_contacts/auth.rb

@@ -0,0 +1,28 @@
+module GoogleContacts
+  class Auth
+    GOOGLE_OAUTH = {
+      :site => 'https://www.google.com',
+      :request_token_path => '/accounts/OAuthGetRequestToken',
+      :authorize_path     => '/accounts/OAuthAuthorizeToken',
+      :access_token_path  => '/accounts/OAuthGetAccessToken',
+    }.freeze
+
+    class << self
+      attr_accessor :consumer_key
+      attr_accessor :consumer_secret
+      attr_accessor :callback_url
+    end
+    
+    def self.consumer
+      ::OAuth::Consumer.new(consumer_key, consumer_secret, GOOGLE_OAUTH)
+    end
+    
+    def request_token(options)
+      self.class.consumer.get_request_token({
+        :oauth_callback => options[:callback]
+      }, {
+        :scope => 'http://www.google.com/m8/feeds/'
+      })
+    end
+  end
+end

data/lib/google_contacts/base.rb

@@ -0,0 +1,163 @@
+module GoogleContacts
+  class Base
+    NAMESPACES = {
+      'atom'        => 'http://www.w3.org/2005/Atom',
+      'openSearch'  => 'http://a9.com/-/spec/opensearch/1.1/',
+      'gContact'    => 'http://schemas.google.com/contact/2008',
+      'batch'       => 'http://schemas.google.com/gdata/batch',
+      'gd'          => 'http://schemas.google.com/g/2005',
+    }.freeze
+
+    # DEFAULT_NAMESPACE = 'http://www.w3.org/2005/Atom'.freeze
+    
+    attr_reader :xml
+    def initialize(wrapper, xml = nil)
+      raise "Cannot create instance of Base" if self.class.name.split(/::/).last == 'Base'
+      @wrapper = wrapper
+      @xml     = self.class.decorate_with_namespaces(xml || initialize_xml_document)
+      @proxies = {}
+    end
+    
+    def self.namespace(node, prefix)
+      node.namespace_definitions.find do |ns|
+        ns.prefix == prefix
+      end
+    end
+    
+    def self.insert_xml(parent, tag, attributes = {}, &blk)
+      # Construct new node with the right namespace
+      matches = tag.match /^((\w+):)?(\w+)$/
+      ns      = matches[2] || 'atom'
+      tag     = matches[3]
+      node = Nokogiri::XML::Node.new(tag, parent)
+      node.namespace = namespace(parent, ns) || raise("Unknown namespace: #{ns}")
+
+      attributes.each_pair do |k,v|
+        node[k.to_s] = v.to_s
+      end
+      
+      parent << node
+      yield node if block_given?
+      node
+    end
+    
+    def remove_xml(tag)
+      @xml.xpath(tag).remove
+    end
+    
+    def insert_xml(tag, attributes = {}, &blk)
+      self.class.insert_xml(@xml, tag, attributes, &blk)
+    end
+    
+    def self.feed_for_batch
+      xml = Nokogiri::XML::Document.new
+      xml.root = decorate_with_namespaces(Nokogiri::XML::Node.new('feed', xml))
+      xml.root
+    end
+    
+    def xml_copy
+      doc = Nokogiri::XML::Document.new
+      doc.root = self.class.decorate_with_namespaces(xml.dup)
+      doc.root
+    end
+    
+    # Create new XML::Document that can be used in a
+    # Google Contacts batch operation.
+    def entry_for_batch(operation)
+      doc = Nokogiri::XML::Document.new
+      doc.root = self.class.decorate_with_namespaces(xml.dup) # This automatically dups xml
+      doc.root.xpath('./xmlns:link'   ).remove
+      doc.root.xpath('./xmlns:updated').remove
+
+      if operation == :update || operation == :destroy
+        doc.root.at('./xmlns:id').content = url(:edit)
+      end
+      
+      self.class.insert_xml(doc.root, 'batch:id')
+      self.class.insert_xml(doc.root, 'batch:operation', :type => operation)
+      
+      doc.root
+    end
+    
+    def new?
+      at('id').nil?
+    end
+    
+    def id
+      at('id').text.strip unless new?
+    end
+    
+    def updated_at
+      Time.parse at('updated').text.strip unless new?
+    end
+    
+    def url(rel)
+      rel = 'http://schemas.google.com/contacts/2008/rel#photo' if rel == :photo
+      at_xpath(%{xmlns:link[@rel="#{rel}"]})[:href]
+    end
+
+    def at(*args)
+      xml.at(*args)
+    end
+
+    def at_xpath(*args)
+      xml.at_xpath(*args)
+    end
+
+    def xpath(*args)
+      xml.xpath(*args)
+    end
+    
+    def changed?
+      new? || @proxies.values.any?(&:changed?)
+    end
+    
+    def save
+      return unless changed?
+      synchronize_proxies
+      @wrapper.save(self)
+    end
+    
+    protected
+    def register_proxy(name, proxy)
+      @proxies[name.to_sym] = proxy
+    end
+    
+    def synchronize_proxies
+      @proxies.values.map(&:synchronize)
+    end
+    
+    # Try to proxy missing method to one of the proxies
+    def method_missing(sym, *args, &blk)
+      if sym.to_s =~ /^(\w+)(=)?$/ && @proxies[$1.to_sym]
+        if $2
+          @proxies[sym].replace(args.first)
+        else
+          @proxies[sym]
+        end
+      else
+        super
+      end
+    end
+    
+    def initialize_xml_document
+      xml = Nokogiri::XML::Document.new
+      xml.root = Nokogiri::XML::Node.new('entry', xml)
+
+      category = Nokogiri::XML::Node.new('category', xml)
+      category['scheme'] = 'http://schemas.google.com/g/2005#kind'
+      category['term'  ] = self.class.const_get(:CATEGORY_TERM)
+      xml.root << category
+
+      xml.root
+    end
+    
+    def self.decorate_with_namespaces(node)
+      node.default_namespace = NAMESPACES['atom']
+      NAMESPACES.each_pair do |prefix, href|
+        node.add_namespace(prefix, href)
+      end
+      node
+    end
+  end
+end

data/lib/google_contacts/contact.rb

@@ -0,0 +1,32 @@
+module GoogleContacts
+  class Contact < Base
+    CATEGORY_TERM = 'http://schemas.google.com/contact/2008#contact'
+    
+    # attr_reader :groups
+    def initialize(*args)
+      super
+
+      register_proxy :emails, Proxies::Emails.new(self)
+      register_proxy :groups, Proxies::Array.new(self,
+        :tag   => 'gContact:groupMembershipInfo',
+        :attr  => 'href')
+      register_proxy :properties, Proxies::Hash.new(self,
+        :tag   => 'gd:extendedProperty',
+        :key   => 'name',
+        :value => 'value')
+    end
+    
+    def [](prop)
+      properties[prop]
+    end
+
+    def []=(prop, value)
+      properties[prop] = value
+    end
+    
+    def email=(address)
+      emails[address].primary!
+    end
+
+  end # class Contact
+end # module GoogleContacts

data/lib/google_contacts/group.rb

@@ -0,0 +1,9 @@
+module GoogleContacts
+  class Group < Base
+    CATEGORY_TERM = 'http://schemas.google.com/g/2005#group'
+    
+    def system_group?
+      @xml.xpath('.//gContact:systemGroup').size > 0
+    end
+  end
+end

data/lib/google_contacts/proxies/array.rb

@@ -0,0 +1,46 @@
+module GoogleContacts
+  module Proxies
+    class Array < BlankSlate
+      def initialize(parent, options)
+        @parent = parent
+        @tag    = options[:tag]
+        @attr   = options[:attr]
+        
+        reinitialize
+      end
+      
+      def reinitialize
+        @current = @parent.xml.xpath("./#{@tag}").map do |entry|
+          entry[@attr]
+        end.compact.uniq.sort
+        
+        # create a deep copy
+        @new = @current.map { |item| item.dup }
+      end
+      
+      def changed?
+        @current != @new
+      end
+      
+      def synchronize
+        @parent.remove_xml("./#{@tag}")
+        @new.each do |value|
+          @parent.insert_xml(@tag, { @attr => value })
+        end
+      end
+      
+      def push(item)
+        item = item.href if item.respond_to?(:href)
+        method_missing(:push, item)
+      end
+      alias :<< :push
+
+      private
+      def method_missing(sym, *args, &blk)
+        ret = @new.send(sym, *args, &blk)
+        @new = @new.compact.uniq.sort
+        ret
+      end
+    end # class Array
+  end # module Proxies
+end # module GoogleContacts