google_apps_api 0.1.0

data/.document

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

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 James Stuart
+
+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,17 @@
+= google_apps_api
+
+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 James Stuart. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,56 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "google_apps_api"
+    gem.summary = %Q{Various APIs for Google Apps}
+    gem.description = %Q{APIs for Google Apps (currently Provisioning, Calendar, Calendar Resources)}
+    gem.email = "tastyhat@jamesstuart.org"
+    gem.homepage = "http://github.com/tastyhat/google_apps_api"
+    gem.authors = ["James Stuart"]
+    gem.add_dependency "httpclient"
+    gem.add_dependency "nokogiri"
+    gem.add_dependency "activesupport" 
+    gem.add_development_dependency "shoulda", ">= 0"
+    # 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 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/*_test.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "google_apps_api #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

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

data/google_apps_api.gemspec

@@ -0,0 +1,85 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{google_apps_api}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["James Stuart"]
+  s.date = %q{2010-05-05}
+  s.description = %q{APIs for Google Apps (currently Provisioning, Calendar, Calendar Resources)}
+  s.email = %q{tastyhat@jamesstuart.org}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "google_apps_api.gemspec",
+     "lib/config/calendar.yml",
+     "lib/config/provisioning.yml",
+     "lib/google_apps_api.rb",
+     "lib/google_apps_api/base_api.rb",
+     "lib/google_apps_api/calendar.rb",
+     "lib/google_apps_api/calendar_resources.rb",
+     "lib/google_apps_api/contacts.rb",
+     "lib/google_apps_api/exceptions.rb",
+     "lib/google_apps_api/provisioning.rb",
+     "lib/google_apps_api/user_profiles.rb",
+     "lib/load_config.rb",
+     "private/gapps-config.yml",
+     "private/userscalendars.xml",
+     "test/google_apps_api-calendar_resources_test.rb",
+     "test/google_apps_api_calendar_test.rb",
+     "test/google_apps_api_contacts_test.rb",
+     "test/google_apps_api_provisioning_test.rb",
+     "test/google_apps_api_user_profiles_test.rb",
+     "test/helper.rb",
+     "test/test_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/tastyhat/google_apps_api}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Various APIs for Google Apps}
+  s.test_files = [
+    "test/google_apps_api-calendar_resources_test.rb",
+     "test/google_apps_api_calendar_test.rb",
+     "test/google_apps_api_contacts_test.rb",
+     "test/google_apps_api_provisioning_test.rb",
+     "test/google_apps_api_user_profiles_test.rb",
+     "test/helper.rb",
+     "test/test_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<httpclient>, [">= 0"])
+      s.add_runtime_dependency(%q<nokogiri>, [">= 0"])
+      s.add_runtime_dependency(%q<activesupport>, [">= 0"])
+      s.add_development_dependency(%q<shoulda>, [">= 0"])
+    else
+      s.add_dependency(%q<httpclient>, [">= 0"])
+      s.add_dependency(%q<nokogiri>, [">= 0"])
+      s.add_dependency(%q<activesupport>, [">= 0"])
+      s.add_dependency(%q<shoulda>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<httpclient>, [">= 0"])
+    s.add_dependency(%q<nokogiri>, [">= 0"])
+    s.add_dependency(%q<activesupport>, [">= 0"])
+    s.add_dependency(%q<shoulda>, [">= 0"])
+  end
+end
+

data/lib/config/calendar.yml

@@ -0,0 +1,34 @@
+:calendar:
+  :service: cl
+
+  :headers:
+    GData-Version: "2"
+
+  :action_subs:
+    :feed_basic: ":feed:/calendar/feeds"
+    :service: cl
+    :auth: https://www.google.com
+    :feed: https://www.google.com
+    
+  :action_hash:
+    :domain_login:
+      :method: :post
+      :path: ":auth:/accounts/ClientLogin"
+      :format: :text
+    :retrieve_users_calendars:
+      :method: :get
+      :path: ":feed_basic:/:username:/allcalendars/full"
+      :feed: true
+      :class: GoogleAppsApi::CalendarEntry
+    :retrieve_users_own_calendars:
+      :method: :get
+      :path: ":feed_basic:/:username:/owncalendars/full"  
+      :feed: true
+      :class: GoogleAppsApi::CalendarEntry
+    :add_calendar_to_user:
+      :method: :post
+      :path: ":feed_basic:/:username:/allcalendars/full"
+    :delete_calendar_from_user:
+      :method: :delete
+      :path: ":feed_basic:/:username:/allcalendars/full/:id:"
+    

data/lib/config/provisioning.yml

@@ -0,0 +1,36 @@
+:provisioning:
+  :service: apps
+
+  :action_subs:
+    :service: apps
+    :auth: https://www.google.com
+    :feed: https://apps-apis.google.com
+    :path_user: ":feed:/a/feeds/:domain:/user/2.0"    
+    
+  :action_hash:
+    :domain_login:
+      :method: :post
+      :path: ":auth:/accounts/ClientLogin"
+      :format: :text
+    :rename_user:
+      :method: :put
+      :path: ":path_user:/:username:"
+    :delete_user:
+      :method: :delete
+      :path: ":path_user:/:username:"
+    :create_user:
+      :method: :post
+      :path: ":path_user:"
+    :retrieve_user:
+      :method: :get
+      :path: ":path_user:/:username:"
+      :class: GoogleAppsApi::UserEntry
+    :retrieve_all_users:
+      :method: :get
+      :path: ":path_user:"
+      :feed: true
+      :class: GoogleAppsApi::UserEntry
+    :update_user:
+      :method: :put
+      :path: ":path_user:/:username:"
+      :format: :text

data/lib/google_apps_api/base_api.rb

@@ -0,0 +1,157 @@
+include REXML
+
+module GoogleAppsApi
+  class BaseApi
+
+
+    def initialize(api_name, *args)
+      api_config = GoogleAppsApi.config[api_name] || {}
+      options = args.extract_options!.merge!(api_config)
+      raise("Must supply admin_user") unless options[:admin_user] 
+      raise("Must supply admin_password") unless options[:admin_password]
+      raise("Must supply domain") unless options[:domain]
+      @actions_hash = options[:action_hash] || raise("Must supply action hash")
+      @actions_subs = options[:action_subs] || raise("Must supply action subs")
+      @actions_hash[:next] = [:get, '']
+      @actions_subs[:domain] = options[:domain]
+
+      @token = login(options[:admin_user], options[:domain], options[:admin_password], options[:service])
+      @headers = {'Content-Type'=>'application/atom+xml', 'Authorization'=> 'GoogleLogin auth='+@token}.merge(options[:headers] || {})
+
+    end
+
+    def method_missing(method, *args, &block)
+      if @actions_hash.has_key?(method.to_sym)
+        request(method.to_sym, *args)
+      end
+    end
+
+    private
+
+    def setup_action(*args)
+      options = args.extract_options!
+      actions = options[:action_hash]
+
+      actions.each_pair do |k,v|
+        actions[k] = {:method => v[0], :path => (v[1].to_s.gsub!(/\:([^\:]+)\:/) { |sub| options[sub.gsub(/\:/,"").to_sym] })}
+      end
+
+      return actions
+    end
+
+    def login(username, domain, password, service)
+      request_body = '&Email='+CGI.escape(username + "@" + domain)+'&Passwd='+CGI.escape(password)+'&accountType=HOSTED&service='+ service + '&source=columbiaUniversity-google_apps_api-0.1'
+      res = request(:domain_login, :headers =>  {'Content-Type'=>'application/x-www-form-urlencoded'}, :body => request_body)
+
+
+      return /^Auth=(.+)$/.match(res.to_s)[1]
+    end
+
+    def request(action, *args)
+      options = args.extract_options!
+      options = {:headers => @headers}.merge(options)
+      action_hash = @actions_hash[action] || raise("invalid action #{action} called")
+      
+      subs_hash = @actions_subs.merge(options)
+      subs_hash.each { |k,v| subs_hash[k] = action_gsub(v, subs_hash) if v.kind_of?(String)}
+
+      method = action_hash[:method]
+      path = action_gsub(action_hash[:path], subs_hash) + options[:query].to_s
+      is_feed = action_hash[:feed]
+      feed_class = action_hash[:class].constantize if action_hash[:class]
+      format = action_hash[:format] || :xml
+      response = http_request(method, path, options[:body], options[:headers])
+
+      if format == :text
+        return response.body.content
+      else
+        begin 
+          xml = Nokogiri::XML(response.body.content) { |c| c.strict}
+          test_errors(xml)
+          if is_feed
+            entries = entryset(xml.css('feed>entry'),feed_class)
+
+          
+            while (next_feed = xml.at_css('feed>link[rel=next]'))
+              response = http_request(:get, next_feed.attribute("href").to_s, nil, options[:headers])
+              xml = Nokogiri::XML(response.body.content) { |c| c.strict}
+              entries += entryset(xml.css('feed>entry'),feed_class)
+            end
+              
+            entries
+          else
+            feed_class ? feed_class.new(xml) : xml
+          end
+        
+
+        rescue Nokogiri::XML::SyntaxError  => e
+          error = GDataError.new()
+          error.code = "SyntaxError"
+          error.input = "path: #{path}"
+          error.reason = "XML expected, syntax error"
+          raise error, e.to_s
+        end
+      end
+    end
+
+    def http_request(method, path, body, headers, redirects = 0)
+      @hc ||= HTTPClient.new
+      
+      response = case method
+      when :delete
+        @hc.send(method, path, headers)
+      else
+        @hc.send(method, path, body, headers)
+      end
+      
+      if response.status_code == 302 && (redirects += 1) < 10
+        response = http_request(method, response.header["Location"], body, headers, requests)
+      end
+      return response
+    end
+
+    def action_gsub(str, sub_hash)
+      str.gsub(/\:([^\:]+)\:/) { |key| sub_hash[key.gsub(/\:/,"").to_sym] }
+    end
+
+
+    # parses xml response for an API error tag. If an error, constructs and raises a GDataError.
+    def test_errors(xml)
+      error = xml.at_xpath("AppsForYourDomainErrors/error")
+      if  error
+        gdata_error = GDataError.new
+        gdata_error.code = error.attribute("errorCode").content
+        gdata_error.input = error.attribute("invalidInput").content
+        gdata_error.reason = error.attribute("reason").content
+        msg = "error code : "+gdata_error.code+", invalid input : "+gdata_error.input+", reason : "+gdata_error.reason
+        raise gdata_error, msg
+      end
+    end
+
+    def entryset(entries, feed_class)
+      feed_class ? entries.collect { |en| feed_class.new(en)} : entries
+    end
+
+    def escapeXML(text)
+      CGI.escapeHTML(text.to_s)
+    end
+
+  end
+
+  class Entry
+
+    private
+
+    def escapeXML(text)
+      CGI.escapeHTML(text.to_s)
+    end
+
+  end
+  
+	class GDataError < RuntimeError
+		attr_accessor :code, :input, :reason
+		
+		def initialize()
+		end
+	end
+end

data/lib/google_apps_api/calendar.rb

@@ -0,0 +1,65 @@
+#!/usr/bin/ruby
+include REXML
+
+
+
+module GoogleAppsApi #:nodoc:
+
+  module Calendar
+    class Api < GoogleAppsApi::BaseApi
+      attr_reader :token
+
+      def initialize(*args)
+        super(:calendar, *args)
+      end
+
+      def retrieve_user_settings(username)
+        xml_response = request(:retrieve_user_settings, :username => username) 
+      end
+
+      def add_calendar_to_user(calendar, user)
+        CalendarEntry.new(request(:add_calendar_to_user, :username => user, :body => calendar.add_message))
+      end
+
+      def delete_calendar_from_user(calendar, user)
+        request(:delete_calendar_from_user, :username => user, :id => calendar.id)
+      end
+    end
+
+
+
+
+
+  end
+
+  class CalendarEntry
+    attr_accessor :id, :title, :edit_link
+    def initialize(xml = nil)
+      if xml
+        @id = xml.at_css('id').content.gsub(/^.*calendars\//,"")
+        @title = xml.at_css('title').content
+        @edit_link = xml.at_css('link[rel=edit]').attribute('href').value
+      end
+    end
+
+    def to_s
+      title
+    end
+
+    def inspect
+      "<CalendarEntry: #{title} : #{id}, #{edit_link}>"
+    end
+
+    def add_message
+      Nokogiri::XML::Builder.new { |xml|
+        xml.entry(:xmlns => "http://www.w3.org/2005/Atom") {
+          xml.id_ {
+            xml.text id.to_s
+          }
+        }
+      }.to_xml
+    end
+  end
+
+
+end

data/lib/google_apps_api/calendar_resources.rb

@@ -0,0 +1,34 @@
+#!/usr/bin/ruby
+include REXML
+
+
+
+module GoogleAppsApi #:nodoc:
+  module CalendarResources
+    class Api < BaseApi
+      attr_reader :token
+
+      def initialize(*args)
+        begin
+          action_list = {
+            :domain_login => [:post, ":auth:/accounts/ClientLogin"],
+            :retrieve_all_resources => [:get, ":feed_basic:/"],
+          }
+        end
+      
+      
+        options = args.extract_options!
+      
+        domain = options[:domain]
+      
+        options.merge!(:action_hash => action_list, :auth => "https://www.google.com", :feed => "https://apps-apis.google.com", :service => "apps")
+        options[:feed_basic] = options[:feed]+ "/a/feeds/calendar/resource/2.0/#{domain}"
+      
+        super(options)
+      end
+    end
+
+
+  end
+
+end

data/lib/google_apps_api/contacts.rb

@@ -0,0 +1,53 @@
+# #!/usr/bin/ruby
+# 
+# # require 'cgi'
+# # require 'rexml/document'
+# # 
+# 
+# include REXML
+# 
+# 
+# 
+# module GoogleAppsApi #:nodoc:
+#   module SharedContacts 
+#     class Api < GoogleAppsApi::BaseApi
+#       attr_reader :token
+# 
+#       def initialize(*args)  
+#         action_list = {
+#           :domain_login => [:post, ":auth:/accounts/ClientLogin"],
+#           :retrieve_all => [:get, ":feed_basic:/full"],
+#           :create_contact => [:post, ":feed_basic:/full"]
+#         }
+# 
+#         options = args.extract_options!
+#         options.merge!(:action_hash => action_list, :auth => "https://www.google.com", :feed => "https://www.google.com", :service => "cp")
+#         options[:feed_basic] = options[:feed]+ "/m8/feeds/contacts/#{options[:domain]}"
+# 
+#         super(options)
+#       end
+# 
+#       def create_contact(*args)
+#         options = args.extract_options!
+#         msg = RequestMessage.new
+#         msg.add_contact(options)
+#         response  = request(:create_contact, :body => msg.to_s)
+#         return response.to_s
+#       end
+# 
+#     end
+# 
+#     class RequestMessage < GoogleAppsApi::RequestMessage #:nodoc:
+# 
+#       def add_contact(*args)
+#         options = args.extract_options!
+#         base = self.elements["atom:entry"]
+#         base.add_element("atom:title", {"type" => "text"}).text = options[:name] 
+#         base.add_element("atom:content", {"type" => "text"}).text = "Notes"
+#         (options[:email] || {}).each_pair do |email_type, address|
+#           base.add_element("gd:email", {"rel" => "http://schemas.google.com/g/2005##{email_type.to_s}", "address" => address})
+#         end
+#       end
+#     end
+#   end
+# end

data/lib/google_apps_api/exceptions.rb

@@ -0,0 +1,19 @@
+#!/usr/bin/ruby
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not
+# use this file except in compliance with the License. You may obtain a copy of
+# the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0 
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations under
+# the License.
+module GoogleAppsApi #:nodoc:
+
+	class GDataError < RuntimeError
+		attr_accessor :code, :input, :reason
+	end
+end