gs_graph 2.6.5

data/.document

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

data/.gitattributes

@@ -0,0 +1,22 @@
+# Auto detect text files and perform LF normalization
+* text=auto
+
+# Custom for Visual Studio
+*.cs     diff=csharp
+*.sln    merge=union
+*.csproj merge=union
+*.vbproj merge=union
+*.fsproj merge=union
+*.dbproj merge=union
+
+# Standard to msysgit
+*.doc	 diff=astextplain
+*.DOC	 diff=astextplain
+*.docx diff=astextplain
+*.DOCX diff=astextplain
+*.dot  diff=astextplain
+*.DOT  diff=astextplain
+*.pdf  diff=astextplain
+*.PDF	 diff=astextplain
+*.rtf	 diff=astextplain
+*.RTF	 diff=astextplain

data/.gitignore

@@ -0,0 +1,26 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## RVM
+.rvmrc
+
+## PROJECT::GENERAL
+coverage*
+rdoc
+pkg
+
+## PROJECT::SPECIFIC
+.rbenv-version
+/nbproject/private/

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format=documentation

data/.travis.yml

@@ -0,0 +1,3 @@
+rvm:
+  - 1.9.2
+  - 1.9.3

data/Gemfile

@@ -0,0 +1,11 @@
+source 'http://rubygems.org'
+
+platforms :jruby do
+  gem 'jruby-openssl', '>= 0.7'
+end
+
+group :test do
+  gem 'oj'
+end
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,95 @@
+PATH
+  remote: .
+  specs:
+    gs_graph (2.6.4)
+      httpclient (>= 2.2.0.2)
+      multi_json (>= 1.3)
+      rack-oauth2 (>= 0.14.4)
+      tzinfo
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionpack (3.2.11)
+      activemodel (= 3.2.11)
+      activesupport (= 3.2.11)
+      builder (~> 3.0.0)
+      erubis (~> 2.7.0)
+      journey (~> 1.0.4)
+      rack (~> 1.4.0)
+      rack-cache (~> 1.2)
+      rack-test (~> 0.6.1)
+      sprockets (~> 2.2.1)
+    activemodel (3.2.11)
+      activesupport (= 3.2.11)
+      builder (~> 3.0.0)
+    activesupport (3.2.11)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    addressable (2.3.2)
+    attr_required (0.0.5)
+    builder (3.0.4)
+    configatron (2.9.1)
+      yamler (>= 0.1.0)
+    cover_me (1.2.0)
+      configatron
+      hashie
+    crack (0.3.2)
+    diff-lcs (1.1.3)
+    erubis (2.7.0)
+    gs_graph-mock (0.1.1)
+      gs_graph
+      rspec
+      webmock
+    hashie (1.2.0)
+    hike (1.2.1)
+    httpclient (2.3.2)
+    i18n (0.6.1)
+    journey (1.0.4)
+    multi_json (1.5.0)
+    oj (2.0.2)
+    rack (1.4.4)
+    rack-cache (1.2)
+      rack (>= 0.4)
+    rack-oauth2 (1.0.0)
+      activesupport (>= 2.3)
+      attr_required (>= 0.0.5)
+      httpclient (>= 2.2.0.2)
+      i18n
+      multi_json (>= 1.3.6)
+      rack (>= 1.1)
+    rack-test (0.6.2)
+      rack (>= 1.0)
+    rake (10.0.3)
+    rspec (2.12.0)
+      rspec-core (~> 2.12.0)
+      rspec-expectations (~> 2.12.0)
+      rspec-mocks (~> 2.12.0)
+    rspec-core (2.12.2)
+    rspec-expectations (2.12.1)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.12.2)
+    sprockets (2.2.2)
+      hike (~> 1.2)
+      multi_json (~> 1.0)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    tilt (1.3.3)
+    tzinfo (0.3.35)
+    webmock (1.9.0)
+      addressable (>= 2.2.7)
+      crack (>= 0.1.7)
+    yamler (0.1.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  actionpack (>= 3.0.6)
+  cover_me (>= 1.2.0)
+  gs_graph!
+  gs_graph-mock (>= 0.1.1)
+  jruby-openssl (>= 0.7)
+  oj
+  rake (>= 0.8)
+  rspec (>= 2)

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 nov matake
+
+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,314 @@
+= GSGraph
+
+A full-stack GameStamper/GoPlay Graph API wrapper in Ruby 
+for use with Rails.  This project (and README) is based off of the original Facebook project fb_graph
+by nov mattake (https://github.com/rockycaamano/fb_graph)
+and is a direct descendent of the contributions of rockycaamano
+(https://github.com/rockycaamano/gs_graph).
+
+== Installation
+
+We have not yet registered this gem with rubygems.org.  Once we do, the install will be simply:
+
+  gem install gs_graph
+
+However, as of now, you will need to do the following:
+
+1. check out the repository
+2. in the gs_graph directory on your system, run:
+
+	gem build gs_graph.gemspec
+
+3. from within your project, run:
+	
+	gem install [PATH_TO_GSGRAPH_GEM]/gsgraph-2.6.5.gem
+
+== Use
+
+Because the GoPlay network has potentially many different APIs for accessing graph data, and because Ruby on Rails locks down
+http entities such as the request and session, there is an extra step required for using this SDK in a Ruby on Rails app.  
+In your application controller, simply include the following in order to allow GSGraph to access the correct APIs:
+
+class ApplicationController < ActionController::Base
+	
+	before_filter :setup
+	protected
+		def setup
+			GSGraph::setup session, request
+		end
+
+
+== Examples
+
+Now GSGraph supports all objects listed here: http://developers.gamestamper.com/docs/reference/api/
+Almost all connections　for each object are also supported. ("attachments" and "shares" connections of message object are not supported yet)
+
+You can also play with a Rails sample app here. http://fbgraphsample.heroku.com/
+
+See GitHub wiki for more examples.
+https://github.com/nov/gs_graph/wiki
+
+=== GET
+
+==== Basic Objects
+
+  user = GSGraph::User.me(ACCESS_TOKEN)
+
+  user = GSGraph::User.fetch('matake')
+  user.name    # => 'Nov Matake'
+  user.picture # => 'https://graph.gamestamper.com/matake/picture'
+
+  # gs_graph doesn't access to Graph API until you call "fetch"
+  user = GSGraph::User.new('matake', :access_token => YOUR_ACCESS_TOKEN)
+  user.identifier # => "matake"
+  user.name # => nil
+  user.link # => nil
+  user = user.fetch
+  user.name # => "Nov Matake"
+  user.description # => "http://www.gamestamper.com/matake"
+
+  page = GSGraph::Page.fetch('smartfmteam')
+  page.name     # => 'smart.fm'
+  page.picture  # => 'https://graph.gamestamper.com/smart.fm/picture'
+
+  :
+
+==== Connections
+
+  # Public connections
+  user = GSGraph::User.fetch('matake')
+  user.feed
+  user.posts
+  user.friends
+  user.tagged
+  user.family
+  :
+
+  # Private connections requires "access_token"
+  GSGraph::User.new('matake').friends # => raise GSGraph::Unauthorized
+  user = GSGraph::User.fetch('matake', :access_token => ACCESS_TOKEN)
+  user.albums
+  user.events
+  user.friends
+  user.likes
+  :
+
+  # "home" connection is only available for "me"
+  me = User.new('me', :access_token => ACCESS_TOKEN)
+  me.home
+  :
+
+By default, GSGraph will only return the default fields. In order to
+get a non-default field, you have to supply the connect with an options hash
+specifying the field. An example for events:
+
+  user.events({:fields => "owner,name,description,picture"}) # { and } optional
+
+An overview of which fields you can include in the graph API can be found at
+https://developers.gamestamper.com/docs/reference/api/, which has a description
+of the specific objects fields in the sidebar under "Objects".
+
+==== Search
+
+  # all objects
+  GSGraph::Searchable.search("GSGraph") # => Array of Hash
+
+  # specify type
+  GSGraph::Page.search("GSGraph") # => Array of GSGraph::Page
+  GSGraph::User.search("matake", :access_token => ACCESS_TOKEN) # => Array of GSGraph::User
+
+==== Pagination
+
+  # collection
+  user = GSGraph::User.new('matake', :access_token => ACCESS_TOKEN)
+  likes = user.likes # => Array of GSGraph::Like
+  likes.next         # => Array of GSGraph::Like (next page)
+  likes.previous     # => Array of GSGraph::Like (previous page)
+  likes.collection.next     # => Hash for pagination options (ex. {"limit"=>"25", "until"=>"2010-08-08T03:17:21+0000"})
+  likes.collection.previous # => Hash for pagination options (ex. {"limit"=>"25", "since"=>"2010-08-08T06:28:20+0000"})
+  user.likes(likes.collection.next)     # => same with likes.next
+  user.likes(likes.collection.previous) # => same with likes.previous
+
+  # search results
+  results = GSGraph::Page.search("GSGraph") # => Array of GSGraph::Page
+  results.next     # => Array of GSGraph::Page (next page)
+  results.previous # => Array of GSGraph::Page (next page)
+  results.klass    # => GSGraph::Page
+  results.collection.next     # => Hash for pagination options (ex. {"limit"=>"25", "until"=>"2010-08-08T03:17:21+0000"})
+  results.collection.previous # => Hash for pagination options (ex. {"limit"=>"25", "since"=>"2010-08-08T06:28:20+0000"})
+  results.klass.search(results.query, results.collection.next)     # => same with results.next
+  results.klass.search(results.query, results.collection.previous) # => same with results.previous
+
+=== POST
+
+==== Update status (wall post)
+
+  me = GSGraph::User.me(ACCESS_TOKEN)
+  me.feed!(
+    :message => 'Updating via GSGraph',
+    :picture => 'https://graph.gamestamper.com/matake/picture',
+    :link => 'https://github.com/nov/gs_graph',
+    :name => 'GSGraph',
+    :description => 'A Ruby wrapper for Facebook Graph API'
+  )
+
+==== Post a like/comment to a post
+
+  post = GSGraph::Page.new(117513961602338).feed.first
+  bool = post.like!(
+    :access_token => ACCESS_TOKEN
+  )
+  comment = post.comment!(
+    :access_token => ACCESS_TOKEN,
+    :message => 'Hey, I\'m testing you!'
+  )
+
+==== Post a note
+
+  page = GSGraph::Page.new(117513961602338)
+  note = page.note!(
+    :access_token => ACCESS_TOKEN,
+    :subject => 'testing',
+    :message => 'Hey, I\'m testing you!'
+  )
+
+==== Post a link
+
+  me = GSGraph::User.me(ACCESS_TOKEN)
+  link = me.link!(
+    :link => 'https://github.com/nov/gs_graph',
+    :message => 'A Ruby wrapper for Facebook Graph API.'
+  )
+
+==== Create Event, respond to it
+
+  me = GSGraph::User.me(ACCESS_TOKEN)
+  event = me.event!(
+    :name => 'GSGraph test event',
+    :start_time => 1.week.from_now,
+    :end_time => 2.week.from_now
+  )
+  bool = event.attending!(
+    :access_token => ACCESS_TOKEN
+  )
+  bool = event.maybe!(
+    :access_token => ACCESS_TOKEN
+  )
+  bool = event.declined!(
+    :access_token => ACCESS_TOKEN
+  )
+
+==== Create an album
+
+  me = GSGraph::User.me(ACCESS_TOKEN)
+  album = me.album!(
+    :name => 'GSGraph test',
+    :message => 'test test test'
+  ) # => now facebook Graph API returns weird response for this call
+
+==== Upload a photo to an album
+
+  me = GSGraph::User.me(ACCESS_TOKEN)
+  album = me.albums.first
+  album.photo!(
+    :access_token => ACCESS_TOKEN,
+    :source => File.new('/Users/nov/Desktop/nov.gif', 'rb'), # 'rb' is needed only on windows
+    :message => 'Hello, where is photo?'
+  )
+
+=== DELETE
+
+==== Delete an object
+
+  post = GSGraph::Page.new(117513961602338).feed.first
+  bool = post.like!(
+    :access_token => ACCESS_TOKEN
+  )
+  comment = post.comment!(
+    :access_token => ACCESS_TOKEN,
+    :message => 'Hey, I\'m testing you!'
+  )
+  comment.destroy(:access_token => ACCESS_TOKEN)
+  post.unlike!(:access_token => ACCESS_TOKEN)
+  post.destroy(:access_token => ACCESS_TOKEN)
+
+=== Authentication
+
+Both Facebook JavaScript SDK and normal OAuth2 flow is supported.
+Below I show simple sample code.
+You can also see https://github.com/nov/gs_graph_sample for more details Rails3 sample application.
+
+In addition, if you are migrating an application that uses old-style session keys you can exchange
+the keys for access tokens.
+See more here: http://developers.gamestamper.com/docs/authentication/fb_sig/
+
+==== JavaScript SDK
+
+  fb_auth = GSGraph::Auth.new(YOUR_APP_ID, YOUR_APPLICATION_SECRET)
+  fb_auth.client # => Rack::OAuth2::Client
+
+  # get Facebook's auth cookie in advance using their JS SDK
+  fb_auth.from_cookie(cookies)
+  fb_auth.access_token # => Rack::OAuth2::AccessToken
+  fb_auth.user         # => GSGraph::User (only basic attributes)
+  fb_auth.user.fetch   # => fetch more details
+
+==== Normal OAuth2 Flow
+
+  # setup client
+  client = fb_auth.client
+  client.redirect_uri = "http://your.client.com/facebook/callback"
+
+  # redirect user to facebook
+  redirect_to client.authorization_uri(
+    :scope => [:email, :read_stream, :offline_access]
+  )
+
+  # in callback
+  client.authorization_code = params[:code]
+  access_token = client.access_token! :client_auth_body # => Rack::OAuth2::AccessToken
+  GSGraph::User.me(access_token).fetch # => GSGraph::User
+
+==== Extend Access Token Lifetime
+
+  # setup client
+  fb_auth = GSGraph::Auth.new(YOUR_APP_ID, YOUR_APPLICATION_SECRET)
+  fb_auth.exchange_token! 'short-life-access-token'
+  fb_auth.access_token # => Rack::OAuth2::AccessToken
+
+
+=== Analytics
+
+  app = GSGraph::Application.new(YOUR_APP_ID, :secret => YOUR_APPLICATION_SECRET)
+  app.insights # => Array of GSGraph::Insight
+
+=== Test User
+
+Not tested well yet.
+Sample is here.
+https://gist.github.com/752974
+
+=== FQL
+
+Not tested well yet.
+Sample is here.
+https://gist.github.com/752914
+
+=== More Examples?
+
+See GitHub wiki for more examples.
+https://github.com/nov/gs_graph/wiki
+
+== 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 nov matake. See LICENSE for details.