rgdata 0.1.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in rgdata.gemspec
+gemspec

data/README.rdoc

@@ -0,0 +1,98 @@
+= RGData
+
+RGData makes it easy to get data from Google's Data APIs.
+It streamlines requests and gives you back good ole Ruby objects.
+
+An Example:
+
+  domain = 'redningja.com'
+  profiles = RGData::API::Profiles.retrieve domain, oauth_token: 'access_token_thatlookslikegibberish'
+  => [#<RGData::Model::Profile full_name: 'Jared Ning'>, ...]
+  # Now you can just do this:
+  profiles.first.full_name
+  # Want each user's email addresses?
+  profiles.map(&:emails)
+
+== Installation
+
+  gem install rgdata
+
+  RGData.config do
+    client_id     <your client_id>
+    client_secret <your client_secret>
+  end
+
+== Authentication
+
+To retrieve data, you need an oauth token (a.k.a. access token).
+There's a lot of setup, but after that it should be easy.
+
+* Setup
+  * Get your client_id and client_secret
+    * https://code.google.com/apis/console
+    * Click on Identity at the left.
+    * Look for OAuth2 Credentials and you'll find your client_id and client_secret
+  * While you're you may want to list your redirect URIs if you know what they will be. These must match your authentication requests (more on this later).
+* Request authentication. (Depending on which API you are using, there may be specific instructions you may want to tell your user about. See the individual APIs classes for specifics.)
+  * Your user will go to the request URL generated for you by calling, for example, RGData::API::Profiles.request_url(scope, redirect_uri).
+  * They will be promted by Google to authenticate and grant permission.
+* Successful authentication will return hash that you are responsible for collecting. It includes 3 parts:
+  * access_token: This is what we're after. You can use this immediately to retrieve data. You can also get one by using refresh_token which we'll get to in a sec.
+  * expiration: You have this many seconds to use access_token before it expires.
+  * refresh_token: See below.
+* Once you have your access token, you can start accessing the data.
+
+=== Refresh tokens
+
+A refresh token won't get you into the data, but it will allow you to get more access tokens in the future. Keep this if you don't want your users to re-authenticate over and over again.
+To get another access token:
+
+  RGData::API::Profiles.get_access_token(refresh_token)
+
+For convenience, APIs are smart enough to do this work for you:
+
+  RGData::API::Profiles.retrieve domain, refresh_token: refresh_token
+
+=== client-side and native application authentication
+
+TODO
+
+== Retrieving data
+
+Easy:
+
+  # If you already have an access_token or oauth_token (same diff)
+  RGData::API::Profiles.retrieve domain, oauth_token: oauth_token
+  # If you only have a refresh token
+  RGData::API::Profiles.retrieve domain, refresh_token: refresh_token
+  # Both will return familiar, easy-to-use Ruby objects
+  _.first.full_name
+  #=> 'Jared Ning'
+
+=== Query parameters, Retrieving a single profile, etc.
+
+TODO
+
+There are more ways to retrieve information (e.g. http://code.google.com/googleapps/domain/profiles/developers_guide_protocol.html#Retrieving).
+Currently the gem only supports retrieving all (or at least all that Google allows in one request).
+
+== Supported APIs
+
+* Profiles
+
+=== Add more
+
+Please feel free to contribute more APIs.
+Take a look at lib/rgdata/apis/profiles.rb and lib/rgdata/models/profile.rb to see how easy it is.
+For the API, just find the scope (link below)
+
+== Compatibility
+
+Ruby 1.9. Want 1.8 support? Go fork yourself.
+gem-testers: http://test.rubygems.org/gems/rgdata
+
+== Useful links
+
+* OAuth2 for server side: http://code.google.com/apis/accounts/docs/OAuth2.html#SS
+* Scopes: http://code.google.com/apis/gdata/faq.html#AuthScopes
+* Each API class should have a link to its corresponding Google API page.

data/Rakefile

@@ -0,0 +1,10 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+
+task :default => :test
+
+Rake::TestTask.new do |t|
+  t.pattern = "mspec/**/*_spec.rb"
+end

data/lib/rgdata/api.rb

@@ -0,0 +1,55 @@
+module RGData::API
+
+  def self.included(target)
+    target.extend ClassMethods
+    target.instance_eval do
+      include HTTParty
+      headers 'GData-Version' => '3.0'
+      format :xml
+    end
+  end
+
+  module ClassMethods
+
+    attr_accessor :scope
+    attr_accessor :model
+
+    def request_url(redirect_uri)
+      RGData::Authentication.request_url(scope, redirect_uri)
+    end
+
+    # Send request and return response.
+    # options can be :oauth_token, :access_token, or :refresh_token.
+    def do_request(domain, options)
+      oauth_token = extract_oauth_token_or_access_token_or_get_one_using_refresh_token(options)
+      query = {oauth_token: oauth_token}
+      query.verify_keys_present_and_values_not_nil(:oauth_token)
+      get "/#{domain}/full", query: query
+    end
+
+    # Perform request and instantiate new model objects.
+    def retrieve(domain, options)
+      full_xml_hash = do_request(domain, options)
+      full_xml_hash['feed']['entry'].map do |xml_hash|
+        model.new_from_xml_hash xml_hash
+      end
+    end
+
+    private
+
+    # Get an oauth_token from a hash.
+    # It can be in the form of oauth_token or access_token.
+    # If neither of those is found, refresh_token should be present and
+    # will be used to get an access_token.
+    def extract_oauth_token_or_access_token_or_get_one_using_refresh_token(hash)
+      oauth_token = hash.extract_values_at(:oauth_token, :access_token).compact.first
+      unless oauth_token
+        refresh_token = hash.extract(:refresh_token)
+        oauth_token = RGData::Authentication::get_access_token(refresh_token)
+      end
+      oauth_token
+    end
+
+  end
+
+end

data/lib/rgdata/apis/profiles.rb

@@ -0,0 +1,18 @@
+# http://code.google.com/googleapps/domain/profiles/developers_guide_protocol.html
+# Authentication notes:
+#   Google requires that the user granting permission be an administrator for their domain.
+#   When prompted for which account they are going to use, they should choose the one under the Google Apps section (not the default one).
+
+module RGData::API
+
+  class Profiles
+
+    include RGData::API
+
+    base_uri     'http://www.google.com/m8/feeds/profiles/domain'
+    self.scope = 'http://www.google.com/m8/feeds/'
+    self.model = RGData::Model::Profile
+
+  end
+
+end

data/lib/rgdata/authentication.rb

@@ -0,0 +1,37 @@
+class RGData::Authentication
+
+  include HTTParty
+  base_uri 'https://accounts.google.com/o/oauth2'
+
+  class << self
+
+    # Construct a url for requesting authentication.
+    def request_url(scope, redirect_uri)
+      method = Net::HTTP::Get
+      path = default_options[:base_uri] + '/auth'
+      query = {
+        redirect_uri:  redirect_uri,
+        scope:         scope,
+        response_type: 'code',
+        client_id:     RGData.config.client_id,
+      }
+      query.verify_keys_present_and_values_not_nil(:client_id, :redirect_uri, :scope, :response_type)
+      request = HTTParty::Request.new(method, path, query: query)
+      URI.unescape(request.uri.to_s)
+    end
+
+    def get_access_token(refresh_token)
+      body = {
+        refresh_token: refresh_token,
+        grant_type: 'refresh_token',
+        client_id: RGData.config.client_id,
+        client_secret: RGData.config.client_secret,
+      }
+      body.verify_keys_present_and_values_not_nil(:refresh_token, :grant_type, :client_secret, :client_id)
+      response = post('/token', body: body)
+      response['access_token']
+    end
+
+  end
+
+end

data/lib/rgdata/config.rb

@@ -0,0 +1,34 @@
+class RGData::Config
+
+  configurations = [
+    :client_id,     # https://code.google.com/apis/console, (click 'Identity' on left)
+    :client_secret, # https://code.google.com/apis/console, (click 'Identity' on left)
+  ]
+
+  configurations.each do |configuration|
+    define_method configuration, do |*new_value|
+      instance_variable = :"@#{configuration}"
+      if new_value.any?
+        instance_variable_set instance_variable, new_value.first
+      else
+        instance_variable_get instance_variable
+      end
+    end
+  end
+
+end
+
+module RGData
+
+  class << self
+
+    def config(&block)
+      @config ||= RGData::Config.new
+      @config.instance_eval &block if block_given?
+      raise 'You need to set client_id and client_secret in configs' unless @config.client_id && @config.client_secret
+      @config
+    end
+
+  end
+
+end

data/lib/rgdata/model.rb

@@ -0,0 +1,55 @@
+# A class that includes RGData::Model represent an XML response from GOogle as a Ruby object.
+# The class method new_from_xml_hash accepts an XML hash.
+# It should be the portion of the HTTParty/Crack parsed hash that represents a single record.
+# Once the module is included, the class just needs to declare fields and
+# define instructions on how to drill down into the hash to get to the useful information.
+
+module RGData::Model
+
+  def self.included(target)
+    target.extend ClassMethods
+  end
+
+  module ClassMethods
+
+    # Declare a field.
+    # It will be given attr_accessor.
+    # parse_block will be instructions on how to drill down into the xml_hash and get the value.
+    def field(name, &parse_block)
+      parse_blocks[name] = parse_block
+      attr_accessor name
+    end
+
+    def new_from_xml_hash(xml_hash)
+      attributes = parse_blocks.inject({}) do |atts, (field, parse_block)|
+        begin
+          atts[field] = parse_block.call(xml_hash)
+          atts
+        rescue Exception => ex
+          raise FieldError.new(field, ex.message)
+        end
+      end
+      new(attributes)
+    end
+
+    private
+
+    def parse_blocks
+      @parse_blocks ||= {}
+    end
+
+  end
+
+  def initialize(atts = {})
+    atts.each do |field, value|
+      send "#{field}=", value
+    end
+  end
+
+  class FieldError < StandardError
+    def initialize(field, msg)
+      super "Error extracting '#{field}' field value from xml_hash: #{msg}"
+    end
+  end
+
+end

data/lib/rgdata/models/profile.rb

@@ -0,0 +1,58 @@
+# This is a a single Google profile obtained from from XML, parsed into to a hash (by HTTParty/Crack), then output by awesome_print.
+#   {
+#               "id" => "http://www.google.com/m8/feeds/profiles/domain/redningja.com/full/jared",
+#          "updated" => "2011-03-31T15:24:04.179Z",
+#       "app:edited" => "2011-03-31T15:24:04.179Z",
+#         "category" => {
+#           "scheme" => "http://schemas.google.com/g/2005#kind",
+#             "term" => "http://schemas.google.com/contact/2008#profile"
+#       },
+#            "title" => "Jared Ning",
+#             "link" => [
+#           [0] {
+#                "rel" => "http://schemas.google.com/contacts/2008/rel#photo",
+#               "type" => "image/*",
+#               "href" => "https://www.google.com/m8/feeds/photos/profile/redningja.com/jared"
+#           },
+#           [1] {
+#                "rel" => "self",
+#               "type" => "application/atom+xml",
+#               "href" => "https://www.google.com/m8/feeds/profiles/domain/redningja.com/full/jared"
+#           },
+#           [2] {
+#                "rel" => "edit",
+#               "type" => "application/atom+xml",
+#               "href" => "https://www.google.com/m8/feeds/profiles/domain/redningja.com/full/jared"
+#           }
+#       ],
+#          "gd:name" => {
+#             "gd:fullName" => "Jared Ning",
+#            "gd:givenName" => "Jared",
+#           "gd:familyName" => "Ning"
+#       },
+#         "gd:email" => [
+#           [0] {
+#                   "rel" => "http://schemas.google.com/g/2005#other",
+#               "address" => "jared@redningja.com",
+#               "primary" => "true"
+#           },
+#           [1] {
+#                   "rel" => "http://schemas.google.com/g/2005#other",
+#               "address" => "*@redningja.com"
+#           }
+#       ],
+#          "gd:etag" => "\"D0NbQR5cQit7I2A4\""
+#   }
+#
+# It is possible for a profile to have multiple email addresses.
+
+class RGData::Model::Profile
+
+  include RGData::Model
+
+  field(:full_name)   { |xml_hash| xml_hash['gd:name']['gd:fullName'] }
+  field(:given_name)  { |xml_hash| xml_hash['gd:name']['gd:givenName'] }
+  field(:family_name) { |xml_hash| xml_hash['gd:name']['gd:familyName'] }
+  field(:emails)      { |xml_hash| [xml_hash['gd:email']].flatten.map { |email| email['address'] } }
+
+end

data/lib/rgdata/version.rb

@@ -0,0 +1,3 @@
+module Rgdata
+  VERSION = '0.1.0'
+end

data/lib/rgdata.rb

@@ -0,0 +1,18 @@
+require 'httparty'
+
+module RGData
+end
+
+require 'rgdata/config'
+require 'rgdata/authentication'
+require 'rgdata/api'
+require 'rgdata/model'
+
+lib_requires = [
+  '/support/**/*.rb',
+  '/rgdata/models/**/*.rb',
+  '/rgdata/apis/**/*.rb',
+]
+lib_requires.each do |lib|
+  Dir[File.dirname(File.expand_path(__FILE__)) + lib].each { |file| require file }
+end

data/lib/support/hash.rb

@@ -0,0 +1,27 @@
+class Hash
+
+  # This gem was meant to help deal with the strictness of APIs
+  # and their inability to give good feedback for mundane detail errors.
+  # This method helps eliminate guessing when it comes to Request query/body/etc. hashes.
+  def verify_keys_present_and_values_not_nil(*keys)
+    keys.each do |key|
+      unless has_key?(key.to_sym) || has_key?(key.to_s)
+        raise "Options missing '#{key}'"
+      end
+      if extract(key).nil?
+        raise "Option '#{key}' cannot be nil"
+      end
+    end
+  end
+
+  # get a value from the given key whether it be stored as a symbol or string.
+  def extract(key)
+    self[key.to_s] || self[key.to_sym]
+  end
+
+  # Same as values_at(), but uses extract().
+  def extract_values_at(*keys)
+    keys.map { |key| extract(key) }
+  end
+
+end

data/mspec/api_spec.rb

@@ -0,0 +1,13 @@
+require File.dirname(File.expand_path(__FILE__)) + '/spec_helper'
+
+describe RGData::API do
+
+  it 'extracts oauth_token or access_token or gets one using refresh_token' do
+    klass = Class.new
+    klass.extend RGData::API::ClassMethods
+    klass.send(:extract_oauth_token_or_access_token_or_get_one_using_refresh_token, oauth_token: 'asdf').must_equal 'asdf'
+    klass.send(:extract_oauth_token_or_access_token_or_get_one_using_refresh_token, access_token: 'asdf').must_equal 'asdf'
+    klass.send(:extract_oauth_token_or_access_token_or_get_one_using_refresh_token, refresh_token: TEST_REFRESH_TOKEN).wont_be_nil
+  end
+
+end

data/mspec/apis/api_spec.rb

@@ -0,0 +1,15 @@
+require File.dirname(File.expand_path(__FILE__)) + '/../spec_helper'
+
+describe RGData::API do
+
+  before :each do
+    @klass = Class.new
+    @klass.send :include, RGData::API
+  end
+
+  it 'stores and returns scope' do
+    @klass.scope = 'asdf'
+    @klass.scope.must_equal 'asdf'
+  end
+
+end

data/mspec/apis/profiles_spec.rb

@@ -0,0 +1,27 @@
+require File.dirname(File.expand_path(__FILE__)) + '/../spec_helper'
+
+describe RGData::API::Profiles do
+
+  it 'has a scope' do
+    RGData::API::Profiles.scope.wont_be_nil
+  end
+
+  it 'requests authentication url' do
+    redirect_uri = 'http://come.back.here.after.successful.authentication.com/'
+    request_url = RGData::API::Profiles.request_url(redirect_uri)
+    uri = URI.escape("https://accounts.google.com/o/oauth2/auth?redirect_uri=http://come.back.here.after.successful.authentication.com/&scope=http://www.google.com/m8/feeds/&response_type=code&client_id=#{RGData.config.client_id}")
+    request_url.must_equal uri
+  end
+
+  it 'retrieves profiles from a domain' do
+    domain = 'redningja.com'
+    access_token = RGData::Authentication.get_access_token(TEST_REFRESH_TOKEN)
+    profiles = RGData::API::Profiles.retrieve(domain, oauth_token: access_token)
+    profiles.wont_be_empty
+  end
+
+  it 'has a corresponding model' do
+    RGData::API::Profiles.model.must_equal RGData::Model::Profile
+  end
+
+end

data/mspec/authentication_spec.rb

@@ -0,0 +1,17 @@
+require File.dirname(File.expand_path(__FILE__)) + '/spec_helper'
+
+describe RGData::Authentication do
+
+  it 'provides a url for a user to request authentication' do
+    scope        = RGData::API::Profiles.scope
+    redirect_uri = 'http://come.back.here.after.successful.authentication.com/'
+    request_url = RGData::Authentication.request_url(scope, redirect_uri)
+    uri = URI.escape("https://accounts.google.com/o/oauth2/auth?redirect_uri=http://come.back.here.after.successful.authentication.com/&scope=http://www.google.com/m8/feeds/&response_type=code&client_id=#{RGData.config.client_id}")
+    request_url.must_equal uri
+  end
+
+  it 'retrieves another access_token given a refresh_token' do
+    RGData::Authentication.get_access_token(TEST_REFRESH_TOKEN).wont_be_nil
+  end
+
+end

data/mspec/config_spec.rb

@@ -0,0 +1,22 @@
+require File.dirname(File.expand_path(__FILE__)) + '/spec_helper'
+
+describe RGData::Config do
+
+  after :each do
+    # Restore configs.
+    RGData.config do
+      client_id     ENV['GOOGLE_APPS_CLIENT_ID']
+      client_secret ENV['GOOGLE_APPS_CLIENT_SECRET']
+    end
+  end
+
+  it 'stores and returns client_id and client_secret' do
+    RGData.config do
+      client_id 1
+      client_secret 2
+    end
+    RGData.config.client_id.must_equal 1
+    RGData.config.client_secret.must_equal 2
+  end
+
+end

data/mspec/fixtures/profiles.xml

@@ -0,0 +1 @@
+<?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;D0cARX86cSt7I2A9WhZSFUU.&quot;'><id>redningja.com</id><updated>2011-03-31T15:24:04.119Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/contact/2008#profile'/><title>redningja.com's Profiles</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='https://www.google.com/m8/feeds/profiles/domain/redningja.com/full'/><link rel='http://schemas.google.com/g/2005#batch' type='application/atom+xml' href='https://www.google.com/m8/feeds/profiles/domain/redningja.com/full/batch'/><link rel='self' type='application/atom+xml' href='https://www.google.com/m8/feeds/profiles/domain/redningja.com/full?max-results=60'/><author><name>redningja.com</name></author><generator version='1.0' uri='http://www.google.com/m8/feeds'>Contacts</generator><openSearch:totalResults>4</openSearch:totalResults><openSearch:startIndex>1</openSearch:startIndex><openSearch:itemsPerPage>60</openSearch:itemsPerPage><entry gd:etag='&quot;D0NbQR5cQit7I2A4&quot;'><id>http://www.google.com/m8/feeds/profiles/domain/redningja.com/full/jared</id><updated>2011-03-31T15:24:04.179Z</updated><app:edited xmlns:app='http://www.w3.org/2007/app'>2011-03-31T15:24:04.179Z</app:edited><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/contact/2008#profile'/><title>Jared Ning</title><link rel='http://schemas.google.com/contacts/2008/rel#photo' type='image/*' href='https://www.google.com/m8/feeds/photos/profile/redningja.com/jared'/><link rel='self' type='application/atom+xml' href='https://www.google.com/m8/feeds/profiles/domain/redningja.com/full/jared'/><link rel='edit' type='application/atom+xml' href='https://www.google.com/m8/feeds/profiles/domain/redningja.com/full/jared'/><gd:name><gd:fullName>Jared Ning</gd:fullName><gd:givenName>Jared</gd:givenName><gd:familyName>Ning</gd:familyName></gd:name><gd:email rel='http://schemas.google.com/g/2005#other' address='jared@redningja.com' primary='true'/><gd:email rel='http://schemas.google.com/g/2005#other' address='*@redningja.com'/></entry><entry gd:etag='&quot;XBEHEU8MRit7I2A0&quot;'><id>http://www.google.com/m8/feeds/profiles/domain/redningja.com/full/jwn</id><updated>2011-03-31T15:24:04.179Z</updated><app:edited xmlns:app='http://www.w3.org/2007/app'>2011-03-31T15:24:04.179Z</app:edited><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/contact/2008#profile'/><title>jared weining</title><link rel='http://schemas.google.com/contacts/2008/rel#photo' type='image/*' href='https://www.google.com/m8/feeds/photos/profile/redningja.com/jwn'/><link rel='self' type='application/atom+xml' href='https://www.google.com/m8/feeds/profiles/domain/redningja.com/full/jwn'/><link rel='edit' type='application/atom+xml' href='https://www.google.com/m8/feeds/profiles/domain/redningja.com/full/jwn'/><gd:name><gd:fullName>jared weining</gd:fullName><gd:givenName>jared</gd:givenName><gd:familyName>weining</gd:familyName></gd:name><gd:email rel='http://schemas.google.com/g/2005#other' address='jwn@redningja.com' primary='true'/></entry><entry gd:etag='&quot;ChRQGUxZQSt7I2A9&quot;'><id>http://www.google.com/m8/feeds/profiles/domain/redningja.com/full/darcy</id><updated>2011-03-31T15:24:04.179Z</updated><app:edited xmlns:app='http://www.w3.org/2007/app'>2011-03-31T15:24:04.179Z</app:edited><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/contact/2008#profile'/><title>darcy clark</title><link rel='http://schemas.google.com/contacts/2008/rel#photo' type='image/*' href='https://www.google.com/m8/feeds/photos/profile/redningja.com/darcy'/><link rel='self' type='application/atom+xml' href='https://www.google.com/m8/feeds/profiles/domain/redningja.com/full/darcy'/><link rel='edit' type='application/atom+xml' href='https://www.google.com/m8/feeds/profiles/domain/redningja.com/full/darcy'/><gd:name><gd:fullName>darcy clark</gd:fullName><gd:givenName>darcy</gd:givenName><gd:familyName>clark</gd:familyName></gd:name><gd:email rel='http://schemas.google.com/g/2005#other' address='darcy@redningja.com' primary='true'/></entry><entry gd:etag='&quot;URFUQx5eFCt7I2A-&quot;'><id>http://www.google.com/m8/feeds/profiles/domain/redningja.com/full/stephanie</id><updated>2011-03-31T15:24:04.180Z</updated><app:edited xmlns:app='http://www.w3.org/2007/app'>2011-03-31T15:24:04.180Z</app:edited><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/contact/2008#profile'/><title>stephanie adler</title><link rel='http://schemas.google.com/contacts/2008/rel#photo' type='image/*' href='https://www.google.com/m8/feeds/photos/profile/redningja.com/stephanie'/><link rel='self' type='application/atom+xml' href='https://www.google.com/m8/feeds/profiles/domain/redningja.com/full/stephanie'/><link rel='edit' type='application/atom+xml' href='https://www.google.com/m8/feeds/profiles/domain/redningja.com/full/stephanie'/><gd:name><gd:fullName>stephanie adler</gd:fullName><gd:givenName>stephanie</gd:givenName><gd:familyName>adler</gd:familyName></gd:name><gd:email rel='http://schemas.google.com/g/2005#other' address='stephanie@redningja.com' primary='true'/></entry></feed>

data/mspec/models/profile_spec.rb

@@ -0,0 +1,20 @@
+require File.dirname(File.expand_path(__FILE__)) + '/../spec_helper'
+
+describe RGData::Model::Profile do
+
+  it 'can be created from an xml hash' do
+    data = [
+      ['Jared Ning', 'Jared', 'Ning', ['jared@redningja.com', '*@redningja.com']],
+      ['jared weining', 'jared', 'weining', ['jwn@redningja.com']],
+      ['darcy clark', 'darcy', 'clark', ['darcy@redningja.com']],
+      ['stephanie adler', 'stephanie', 'adler', ['stephanie@redningja.com']],
+    ]
+    xml_hashes = Crack::XML.parse(fixture_file('profiles.xml'))['feed']['entry']
+    xml_hashes.map do |xml_hash|
+      profile = RGData::Model::Profile.new_from_xml_hash(xml_hash)
+      profile_data = [:full_name, :given_name, :family_name, :emails].map { |field| profile.send field }
+      profile_data
+    end.must_equal data
+  end
+
+end

data/mspec/spec_helper.rb

@@ -0,0 +1,23 @@
+require 'minitest/pride'
+require 'minitest/autorun'
+require 'pathname'
+ROOT_DIR = Pathname(File.dirname(File.expand_path(__FILE__))) + '..'
+$LOAD_PATH << (ROOT_DIR + 'lib').to_s
+require 'rgdata'
+require 'crack'
+
+RGData.config do
+  client_id     ENV['GOOGLE_APPS_CLIENT_ID']
+  client_secret ENV['GOOGLE_APPS_CLIENT_SECRET']
+end
+TEST_REFRESH_TOKEN = ENV['GOOGLE_APPS_REFRESH_TOKEN']
+
+module MiniTest::Spec::Helpers
+
+  def fixture_file(file_name)
+    File.open(ROOT_DIR + 'mspec/fixtures/' + file_name)
+  end
+
+end
+
+MiniTest::Unit::TestCase.send :include, MiniTest::Spec::Helpers

data/rgdata.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path('../lib', __FILE__)
+require 'rgdata/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'rgdata'
+  s.version     = Rgdata::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['Jared Ning']
+  s.email       = ['jared@redningja.com']
+  s.homepage    = 'https://github.com/ordinaryzelig/rgdata'
+  s.summary     = %q{Google Data API for Ruby}
+  s.description = %q{Google Data API for Ruby}
+
+  s.rubyforge_project = 'rgdata'
+
+  s.files         = `git ls-files`.split()
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split('\n')
+  s.executables   = `git ls-files -- bin/*`.split('\n').map{ |f| File.basename(f) }
+  s.require_paths = ['lib']
+
+  s.add_dependency 'httparty', '~> 0.7.4'
+
+  s.add_development_dependency 'minitest', '2.0.2'
+end

metadata

@@ -0,0 +1,100 @@
+--- !ruby/object:Gem::Specification 
+name: rgdata
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Jared Ning
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-04-01 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.7.4
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: minitest
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        version: 2.0.2
+  type: :development
+  version_requirements: *id002
+description: Google Data API for Ruby
+email: 
+- jared@redningja.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gemtest
+- .gitignore
+- Gemfile
+- README.rdoc
+- Rakefile
+- lib/rgdata.rb
+- lib/rgdata/api.rb
+- lib/rgdata/apis/profiles.rb
+- lib/rgdata/authentication.rb
+- lib/rgdata/config.rb
+- lib/rgdata/model.rb
+- lib/rgdata/models/profile.rb
+- lib/rgdata/version.rb
+- lib/support/hash.rb
+- mspec/api_spec.rb
+- mspec/apis/api_spec.rb
+- mspec/apis/profiles_spec.rb
+- mspec/authentication_spec.rb
+- mspec/config_spec.rb
+- mspec/fixtures/profiles.xml
+- mspec/models/profile_spec.rb
+- mspec/spec_helper.rb
+- rgdata.gemspec
+has_rdoc: true
+homepage: https://github.com/ordinaryzelig/rgdata
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: rgdata
+rubygems_version: 1.6.1
+signing_key: 
+specification_version: 3
+summary: Google Data API for Ruby
+test_files: []
+