rest-graph 1.5.0 → 1.6.0

data/.specification

@@ -0,0 +1,309 @@
+--- !ruby/object:Gem::Specification 
+name: rest-graph
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 1
+  - 6
+  - 0
+  version: 1.6.0
+platform: ruby
+authors: 
+- Cardinal Blue
+- "Lin Jen-Shin (aka godfat \xE7\x9C\x9F\xE5\xB8\xB8)"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-11-19 00:00:00 +08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rest-client
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 6
+        - 1
+        version: 1.6.1
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: em-http-request
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 2
+        - 15
+        version: 0.2.15
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rack
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 2
+        - 1
+        version: 1.2.1
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: yajl-ruby
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 7
+        - 8
+        version: 0.7.8
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 4
+        - 6
+        version: 1.4.6
+  type: :development
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: json_pure
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 4
+        - 6
+        version: 1.4.6
+  type: :development
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: ruby-hmac
+  prerelease: false
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 4
+        - 0
+        version: 0.4.0
+  type: :development
+  version_requirements: *id007
+- !ruby/object:Gem::Dependency 
+  name: rr
+  prerelease: false
+  requirement: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 0
+        - 2
+        version: 1.0.2
+  type: :development
+  version_requirements: *id008
+- !ruby/object:Gem::Dependency 
+  name: webmock
+  prerelease: false
+  requirement: &id009 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 6
+        - 1
+        version: 1.6.1
+  type: :development
+  version_requirements: *id009
+- !ruby/object:Gem::Dependency 
+  name: bacon
+  prerelease: false
+  requirement: &id010 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 1
+        - 0
+        version: 1.1.0
+  type: :development
+  version_requirements: *id010
+- !ruby/object:Gem::Dependency 
+  name: bones
+  prerelease: false
+  requirement: &id011 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 3
+        - 5
+        - 1
+        version: 3.5.1
+  type: :development
+  version_requirements: *id011
+description: A super simple Facebook Open Graph API client
+email: dev (XD) cardinalblue.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- .specification
+- CHANGES
+- CONTRIBUTORS
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README
+- TODO
+- rest-graph.gemspec
+files: 
+- .specification
+- CHANGES
+- CONTRIBUTORS
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README
+- README.rdoc
+- Rakefile
+- TODO
+- example/multi/config.ru
+- example/multi/rainbows.rb
+- example/rails2/README
+- example/rails2/Rakefile
+- example/rails2/app/controllers/application_controller.rb
+- example/rails2/config/boot.rb
+- example/rails2/config/environment.rb
+- example/rails2/config/environments/development.rb
+- example/rails2/config/environments/production.rb
+- example/rails2/config/environments/test.rb
+- example/rails2/config/initializers/cookie_verification_secret.rb
+- example/rails2/config/initializers/new_rails_defaults.rb
+- example/rails2/config/initializers/session_store.rb
+- example/rails2/config/rest-graph.yaml
+- example/rails2/config/routes.rb
+- example/rails2/log
+- example/rails2/script/console
+- example/rails2/script/server
+- example/rails2/test/functional/application_controller_test.rb
+- example/rails2/test/test_helper.rb
+- example/rails2/test/unit/rails_util_test.rb
+- init.rb
+- lib/rest-graph.rb
+- lib/rest-graph/auto_load.rb
+- lib/rest-graph/load_config.rb
+- lib/rest-graph/rails_util.rb
+- lib/rest-graph/test_util.rb
+- lib/rest-graph/version.rb
+- rest-graph.gemspec
+- test/common.rb
+- test/config/rest-graph.yaml
+- test/test_api.rb
+- test/test_cache.rb
+- test/test_default.rb
+- test/test_error.rb
+- test/test_handler.rb
+- test/test_load_config.rb
+- test/test_misc.rb
+- test/test_multi.rb
+- test/test_oauth.rb
+- test/test_old.rb
+- test/test_page.rb
+- test/test_parse.rb
+- test/test_rest-graph.rb
+- test/test_serialize.rb
+- test/test_test_util.rb
+- test/test_timeout.rb
+has_rdoc: true
+homepage: http://github.com/cardinalblue/rest-graph
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: rest-graph
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A super simple Facebook Open Graph API client
+test_files: 
+- test/test_api.rb
+- test/test_cache.rb
+- test/test_default.rb
+- test/test_error.rb
+- test/test_handler.rb
+- test/test_load_config.rb
+- test/test_misc.rb
+- test/test_multi.rb
+- test/test_oauth.rb
+- test/test_old.rb
+- test/test_page.rb
+- test/test_parse.rb
+- test/test_rest-graph.rb
+- test/test_serialize.rb
+- test/test_test_util.rb
+- test/test_timeout.rb

data/CHANGES

@@ -1,5 +1,83 @@
 = rest-graph changes history
 
+== rest-graph 1.6.0 -- 2010-11-19
+
+* [RestGraph] Added em-http as an alternate for HTTP client. So rest-client
+              is no longer a must-have dependency. Pass :async => true to
+              RestGraph#get/delete/post/put will pick em-http to do the
+              request instead of rest-client. Callback would be the block
+              passed to that particular method. There are short hands for
+              this, too: use RestGraph#aget/adelete/apost/aput.
+
+              Additionally, callback style also works for rest-client. e.g.
+
+                rg. get('me')                                 # rest-client
+                rg. get('me', {}, :async => true){ |result| } # em-http
+                rg.aget('me')                    { |result| } # em-http
+                rg. get('me')                    { |result| } # rest-client
+
+              So you can always use callback style to ease porting from
+              blocking mode (synchronized) to non-blocking mode (evented).
+
+* [RestGraph] Introduced RestGraph#multi to do multiple API call concurrently.
+              To use this feature, you'll need to run RestGraph inside an
+              EventMachine event loop and install em-http. (And you may want
+              async-rack if you're doing Rack application too.)
+
+* [RestGraph] Added a timeout option, which makes rest-graph raise a
+              Timeout::Error when any of the API call exceeds the timeout
+              limit. This might have some issues in Rubinius 1.1, I'm not
+              sure why.
+
+* [RestGraph] Added a log_method option, which would be used for default
+              logging template, which is extracted from RailsUtil. So the
+              log_method in RailsUtil would be `logger.method(:debug)',
+              while in a terminal, you might want `method(:puts)'.
+
+              Previously, you can only use log_handler for logging, which
+              you need to write your custom logging template. Now for common
+              logging, using log_method is enough. On the other hand,
+              log_handler could be used for event handling.
+
+* [RestGraph] Introduced Event::MultiDone and Event::Failed. Those event
+              objects would be passed to log_handler and/or log_method.
+              The former means a multi-request is done, the latter means
+              a request is failed.
+
+* [TestUtil] A collection of tools integrated with RR to ease the pain of
+             testing. There are 3 levels of tools to stub the result of
+             calling APIs. The highest level is TestUtil.login(1234) which
+             would stub a number of results to pretend the user 1234 is
+             logged-in.
+
+             The second level are the get/post/put/delete methods for
+             TestUtil. For example, to make rg.get('1234') return a
+             particular value (such as a hash {'a' => 1}), use
+             TestUtil.get('1234'){ {'a' => 1} } to set it up to return
+             the specified value (typically a hash).
+
+             The third level is for setting default_data and default_response
+             for TestUtil. The default_data is the default value for rg.data,
+             which includes the access_token and the user_id (uid). The
+             default_response is the response given by any RestGraph API call
+             (e.g. get, post) when no explicit response has been defined in
+             the second level.
+
+             To use TestUtil, remember to install RR (gem install rr) and
+             require 'rest-graph/test_util'. Then put
+             RestGraph::TestUtil.setup before any test case starts, and put
+             RestGraph::TestUtil.teardown after any test case ends. Setup
+             would stub default_data and default_response for you, and
+             teardown would remove any stubs on RestGraph. For Rails, you
+             might want to put these in test_helper.rb under "setup" and
+             "teardown" block, just as the name suggested. For bacon or
+             rspec style testing, these can be placed in the "before" and
+             "after" blocks.
+
+             In addition, you can get the API calls history via
+             RestGraph::TestUtil.history. This would get cleaned up in
+             RestGraph::TestUtil.teardown as well.
+
 == rest-graph 1.5.0 -- 2010-10-11
 
 * [RestGraph] Make sure RestGraph::Error#message is string, that way,

data/Gemfile

@@ -1,9 +1,11 @@
 
 source 'http://rubygems.org'
 
-gem 'rest-client'
-
 group :test do
+  # pick one http client
+  gem 'rest-client', '>=1.6'
+  gem 'em-http-request'
+
   # optional
   gem 'rack'
 

data/Gemfile.lock

@@ -1,13 +1,17 @@
 GEM
   remote: http://rubygems.org/
   specs:
-    addressable (2.2.1)
+    addressable (2.2.2)
     bacon (1.1.0)
-    bones (3.4.7)
+    bones (3.5.1)
       little-plugger (>= 1.1.2)
-      loquacious (>= 1.6.4)
+      loquacious (>= 1.7.0)
       rake (>= 0.8.7)
     crack (0.1.8)
+    em-http-request (0.2.14)
+      addressable (>= 2.0.0)
+      eventmachine (>= 0.12.9)
+    eventmachine (0.12.10)
     json (1.4.6)
     json_pure (1.4.6)
     little-plugger (1.1.2)
@@ -17,10 +21,10 @@ GEM
     rake (0.8.7)
     rest-client (1.6.1)
       mime-types (>= 1.16)
-    rr (1.0.0)
+    rr (1.0.2)
     ruby-hmac (0.4.0)
-    webmock (1.3.5)
-      addressable (>= 2.1.1)
+    webmock (1.5.0)
+      addressable (>= 2.2.2)
       crack (>= 0.1.7)
     yajl-ruby (0.7.8)
 
@@ -30,10 +34,11 @@ PLATFORMS
 DEPENDENCIES
   bacon
   bones
+  em-http-request
   json
   json_pure
   rack
-  rest-client
+  rest-client (>= 1.6)
   rr
   ruby-hmac
   webmock