plus 0.0.1 → 0.0.2

data/.gitignore

@@ -1,3 +1,4 @@
+.rvmrc
 *.gem
 .bundle
 Gemfile.lock

data/README.md

@@ -0,0 +1,54 @@
+# Plus
+
+A simple gem for using the Google+ API. See documentation here: https://developers.google.com/+/api/
+
+## Pre-requisites
+
+You'll need an API key from Google. You can apply from one here: https://code.google.com/apis/console
+
+_Note: Plus does not currently support OAuth authentication._
+
+## Usage
+
+First, tell Plus about your API key:
+
+    Plus.options[:api_key] = '12345abcde'
+
+Now start getting data. Plus provies the same methods as the API and are named the same, so when
+in doubt just check out the official docs. Each API call simply returns a Ruby hash mirroring the 
+JSON sent back from the API. If in doubt as to how to access something just `.inspect` the code 
+returned by the call.
+
+### Activities.list
+
+Lists recent posts for a given user:
+
+    result = Plus::Activities.list(12345)
+
+Where `12345` is a valid Google+ user id (a very large integer). To get the text of the first 
+activity returned from the previous call:
+
+    result['items'].first['object']['content']
+
+### Activities.get
+
+Retrieves data about the given activity:
+
+    result = Plus::Activities.get('12345abcde')
+
+Where `12345abcde` is a big string, the `id` of the activity you care about.
+
+### Activities.search
+
+Returns recent activity that matches the given search term:
+
+    result = Plus::Activities.search('woodworking')
+
+## Future
+
+I'm thinking of abstracting the data returned from the API into nice Ruby objects so next time
+you could get the data with a much simpler call (and what feels like method calls rather than
+hash key access):
+
+    result.items.first.content
+

data/lib/plus.rb

@@ -1,5 +1,17 @@
-require "plus/version"
+require 'rubygems'
+require 'httparty'
+require 'plus/activities'
+require 'plus/comments'
+require 'plus/people'
 
 module Plus
-  # Your code goes here...
+
+  ENDPOINT = 'https://www.googleapis.com/plus/v1/'
+  
+  @options = {  :api_key => nil }
+
+  attr_accessor :options
+  
+  extend self
+
 end

data/lib/plus/activities.rb

@@ -0,0 +1,38 @@
+module Plus
+  class Activities
+
+    # Retrieves the recent posts for a given user.
+    def self.list(user_id, options={})
+      endpoint_prefix = 'people'
+
+      default_options = { :collection => :public, :alt => :json }
+      options = default_options.merge(options)
+      url = Plus::ENDPOINT + endpoint_prefix + '/' + user_id.to_s + '/activities/' + options.delete(:collection).to_s
+
+      HTTParty.get(url, :query => options.merge(:key => Plus.options[:api_key]))
+    end
+
+    # Retrieves the detail for a given activity.
+    def self.get(activity_id, options={})
+      endpoint_prefix = 'activities'
+
+      default_options = { :alt => :json }
+      options = default_options.merge(options)
+      url = Plus::ENDPOINT + endpoint_prefix + '/' + activity_id
+
+      HTTParty.get(url, :query => options.merge(:key => Plus.options[:api_key]))
+    end
+
+    # Searches public activities for the given search term
+    def self.search(query, options={})
+      endpoint_prefix = 'activities'
+
+      default_options = { :alt => :json }
+      options = default_options.merge(options)
+      url = Plus::ENDPOINT + endpoint_prefix
+
+      HTTParty.get(url, :query => options.merge(:key => Plus.options[:api_key], :query => query))
+    end
+
+  end
+end

data/lib/plus/comments.rb

@@ -0,0 +1,5 @@
+module Plus
+  class Comments
+
+  end
+end

data/lib/plus/people.rb

@@ -0,0 +1,5 @@
+module Plus
+  class People
+
+  end
+end

data/lib/plus/version.rb

@@ -1,3 +1,3 @@
 module Plus
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: plus
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-01-08 00:00:00.000000000 Z
+date: 2012-01-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
-  requirement: &70135092236640 !ruby/object:Gem::Requirement
+  requirement: &70144571398020 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,7 +21,7 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70135092236640
+  version_requirements: *70144571398020
 description: This gem provides programmatic access to the Google+ API without making
   HTTP calls manually.
 email:
@@ -31,10 +31,15 @@ extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
+- .rvmrc
 - Gemfile
-- README
+- Gemfile.lock
+- README.md
 - Rakefile
 - lib/plus.rb
+- lib/plus/activities.rb
+- lib/plus/comments.rb
+- lib/plus/people.rb
 - lib/plus/version.rb
 - plus.gemspec
 homepage: ''