koala 1.6.0 → 1.7.0rc1

data/.travis.yml

@@ -2,12 +2,9 @@ rvm:
   - 1.8.7
   - 1.9.2
   - 1.9.3
-  - ruby-head
+  - 2.0.0
   - jruby-18mode # JRuby in 1.8 mode
   - jruby-19mode # JRuby in 1.9 mode
   - rbx-18mode
   - rbx-19mode
-  - ree
-matrix:
-  allow_failures:
-    - rvm: ruby-head
+  - ree

data/Gemfile

@@ -1,4 +1,4 @@
-source :rubygems
+source "https://rubygems.org"
 
 group :development do
   gem "yard"
@@ -10,7 +10,6 @@ group :development, :test do
   # Testing infrastructure
   gem 'guard'
   gem 'guard-rspec'
-  gem "parallel_tests"
 
   if RUBY_PLATFORM =~ /darwin/
     # OS X integration

data/changelog.md

@@ -1,16 +1,46 @@
+v1.7
+====
+
+New methods:
+* API#debug_token allows you to examine user tokens (thanks, Cyril-sf!)
+* Koala.config allows you to set Facebook servers (to use proxies, etc.) (thanks, bnorton!)
+
+Internal improvements:
+* CHANGED: Parameters can now be Arrays of non-enumerable values, which get comma-separated (thanks, csaunders!)
+* CHANGED: API#put_wall_post now automatically encodes parameters hashes as JSON
+* CHANGED: GraphCollections returned by batch API calls retain individual access tokens (thanks, billvieux!)
+* CHANGED: Gem version restrictions have been removed, and versions updated.
+* CHANGED: How support files are loaded in spec_helper has been improved.
+* FIXED: API#get_picture returns nil if FB returns no result, rather than error (thanks, mtparet!)
+* FIXED: Koala now uses the right grant_type value for fetching app access tokens (thanks, miv!)
+* FIXED: Koala now uses the modern OAuth endpoint for generating codes (thanks, jayeff!)
+* FIXED: Misc small fixes, typos, etc. (thanks, Ortuna, Crunch09, sagarbommidi!)
+
+Testing improvements:
+* FIXED: MockHTTPService compares Ruby objects rather than strings.
+* FIXED: Removed deprecated usage of should_not_receive.and_return (thanks, Cyril-sf!)
+* FIXED: Test suite now supports Typhoeus 0.5 (thanks, Cyril-sf!)
+* CHANGED: Koala now tests against Ruby 2.0 on Travis (thanks, sanemat!)
+
 v1.6
+====
+
 New methods:
 * RealtimeUpdates#validate_update to validate the signature of a Facebook call (thanks, gaffo!)
+
 Updated methods:
 * Graph API methods now accepts a post processing block, see readme for examples (thanks, wolframarnold!)
-_Internal improvements:_
+
+Internal improvements:
 * Koala now returns more specific and useful error classes (thanks, archfear!)
 * Switched URL parsing to addressable, which can handle unusual FB URLs (thanks, bnorton!)
 * Fixed Batch API bug that seems to have broken calls requiring post-processing
 * Bump Faraday requirement to 0.8 (thanks, jarthod!)
 * Picture and video URLs now support unicode characters (thanks, jayeff!)
+
 Testing improvements:
 * Cleaned up some test suites (thanks, bnorton!)
+
 Documentation:
 * Changelog is now markdown
 * Code highlighting in readme (thanks, sfate!)
@@ -18,11 +48,15 @@ Documentation:
 * Added permissions example for OAuth (thanks, sebastiandeutsch!)
 
 v1.5
+====
+
 New methods:
 * Added Koala::Utils.logger to enable debugging (thanks, KentonWhite!)
 * Expose fb_error_message and fb_error_code directly in APIError
+
 Updated methods:
 * GraphCollection.parse_page_url now uses the URI library and can parse any address (thanks, bnorton!)
+
 Internal improvements:
 * Update MultiJson dependency to support the Oj library (thanks, eckz and zinenko!)
 * Loosened Faraday dependency (thanks, rewritten and romanbsd!)
@@ -30,33 +64,44 @@ Internal improvements:
 * Switched uses of put_object to the more semantically accurate put_connections
 * Cleaned up gemspec
 * Handle invalid batch API responses better
+
 Documentation:
 * Added HTTP Services description for Faraday 0.8/persistent connections (thanks, romanbsd!)
 * Remove documentation of the old pre-1.2 HTTP Service options
 
-v.1.4.1
+v1.4.1
+=======
+
 * Update MultiJson to 1.3 and change syntax to silence warnings (thanks, eckz and masterkain!)
 
 v1.4
+====
+
 New methods:
 * OAuth#exchange_access_token(_info) allows you to extend access tokens you receive (thanks, etiennebarrie!)
+
 Updated methods:
 * HTTPServices#encode_params sorts parameters to aid in URL comparison (thanks, sholden!)
 * get_connections is now aliased as get_connection (use whichever makes sense to you)
+
 Internal improvements:
 * Fixed typos (thanks, brycethornton and jpemberthy!)
 * RealtimeUpdates will no longer execute challenge block unnecessarily (thanks, iainbeeston!)
+
 Testing improvements:
 * Added parallel_tests to development gem file
 * Fixed failing live tests
 * Koala now tests against JRuby and Rubinius in 1.9 mode on Travis-CI
 
 v1.3
+====
+
 New methods:
 * OAuth#url_for_dialog creates URLs for Facebook dialog pages
 * API#set_app_restrictions handles JSON-encoding app restrictions
 * GraphCollection.parse_page_url now exposes useful functionality for non-Rails apps
 * RealtimeUpdates#subscription_path and TestUsers#test_user_accounts_path are now public
+
 Updated methods:
 * REST API methods are now deprecated (see http://developers.facebook.com/blog/post/616/)
 * OAuth#url_for_access_token and #url_for_oauth_code now include any provided options as URL parameters
@@ -67,12 +112,14 @@ Updated methods:
 * All methods with http_options can now take :http_component => :response for the complete response
 * OAuth#get_user_info_from_cookies returns nil rather than an error if the cookies are expired (thanks, herzio)
 * TestUsers#delete_all now uses the Batch API and is much faster
+
 Internal improvements:
 * FQL queries now use the Graph API behind-the-scenes
 * Cleaned up file and class organization, with aliases for backward compatibility
 * Added YARD documentation throughout
 * Fixed bugs in RealtimeUpdates, TestUsers, elsewhere
 * Reorganized file and class structure non-destructively
+
 Testing improvements:
 * Expanded/improved test coverage
 * The test suite no longer users any hard-coded user IDs
@@ -80,27 +127,35 @@ Testing improvements:
 * Configured tests to run in random order using RSpec 2.8.0rc1
 
 v1.2.1
+======
+
 New methods:
 * RestAPI.set_app_properties handles JSON-encoding application properties
+
 Updated methods:
 * OAuth.get_user_from_cookie works with the new signed cookie format (thanks, gmccreight!)
 * Beta server URLs are now correct
 * OAuth.parse_signed_request now raises an informative error if the signed_request is malformed
+
 Internal improvements:
 * Koala::Multipart middleware properly encoding nested parameters (hashes) in POSTs
 * Updated readme, changelog, etc.
+
 Testing improvements:
 * Live tests with test users now clean up all fake users they create
 * Removed duplicate test cases
 * Live tests with test users no longer delete each object they create, speeding things up
 
 v1.2
+====
+
 New methods:
 * API is now the main API class, contains both Graph and REST methods
   * Old classes are aliased with deprecation warnings (non-breaking change)
 * TestUsers#update lets you update the name or password of an existing test user
 * API.get_page_access_token lets you easily fetch the access token for a page you manage (thanks, marcgg!)
 * Added version.rb (Koala::VERSION)
+
 Updated methods:
 * OAuth now parses Facebook's new signed cookie format
 * API.put_picture now accepts URLs to images (thanks, marcgg!)
@@ -110,6 +165,7 @@ Updated methods:
   * Non-pageable results from get_connections no longer error
   * GraphCollection.raw_results allows access to original result data
 * Koala no longer enforces any limits on the number of test users you create at once
+
 Internal improvements:
 * Koala now uses Faraday to make requests, replacing the HTTPServices (see wiki)
   * Koala::HTTPService.http_options allows specification of default Faraday connection options
@@ -120,6 +176,7 @@ Internal improvements:
 * RealTimeUpdates and TestUsers are no longer subclasses of API, but have their own .api objects
   * The old .graph_api accessor is aliases to .api with a deprecation warning
 * Removed deprecation warnings for pre-1.1 batch interface
+
 Testing improvements:
 * Live test suites now run against test users by default
   * Test suite can be repeatedly run live without having to update facebook_data.yml
@@ -131,6 +188,8 @@ Testing improvements:
 * Fixed bug with YAML parsing in Ruby 1.9
 
 v1.1
+====
+
 New methods:
 * Added Batch API support (thanks, seejohnrun and spiegela!)
   * includes file uploads, error handling, and FQL
@@ -139,11 +198,13 @@ New methods:
 * Added RestAPI#fql_multiquery, which simplifies the results (thanks, amrnt!)
 * HTTP services support global proxy and timeout settings (thanks, itchy!)
 * Net::HTTP supports global ca_path, ca_file, and verify_mode settings (thanks, spiegela!)
+
 Updated methods:
 * RealtimeUpdates now uses a GraphAPI object instead of its own API
 * RestAPI#rest_call now has an optional last argument for method, for calls requiring POST, DELETE, etc. (thanks, sshilo!)
 * Filename can now be specified when uploading (e.g. for Ads API) (thanks, sshilo!)
 * get_objects([]) returns [] instead of a Facebook error in non-batch mode (thanks, aselder!)
+
 Internal improvements:
 * Koala is now more compatible with other Rubies (JRuby, Rubinius, etc.)
 * HTTP services are more modular and can be changed on the fly (thanks, chadk!)
@@ -154,11 +215,14 @@ Internal improvements:
 * Fixed bugs and typos (thanks, waynn, mokevnin, and tikh!)
 
 v1.0
+====
+
 New methods:
 * Photo and file upload now supported through #put_picture
   * Added UploadableIO class to manage file uploads
 * Added a delete_like method (thanks to waseem)
 * Added put_connection and delete_connection convenience methods
+
 Updated methods:
 * Search can now search places, checkins, etc. (thanks, rickyc!)
 * You can now pass :beta => true in the http options to use Facebook's beta tier
@@ -167,6 +231,7 @@ Updated methods:
 * url_for_oauth_code can now take a :display option (thanks, netbe!)
 * Net::HTTP can now accept :timeout and :proxy options (thanks, gilles!)
 * Test users now supports using test accounts across multiple apps
+
 Internal improvements:
 * For public requests, Koala now uses http by default (instead of https) to improve speed
   * This can be overridden through Koala.always_use_ssl= or by passing :use_ssl => true in the options hash for an api call
@@ -178,6 +243,7 @@ Internal improvements:
 * APIError is now < StandardError, not Exception
 * Added KoalaError for non-API errors
 * Net::HTTP's SSL verification is no longer disabled by default
+
 Test improvements:
 * Incorporated joshk's awesome rewrite of the entire Koala test suite (thanks, joshk!)
 * Expanded HTTP service tests (added Typhoeus test suite and additional Net::HTTP test cases)
@@ -185,16 +251,22 @@ Test improvements:
 * Replaced the 50-person network test, which often took 15+ minutes to run live, with a 5-person test
 
 v0.10.0
+=======
+
 * Added test user module
 * Fixed bug when raising APIError after Facebook fails to exchange session keys
 * Made access_token accessible via the readonly access_token property on all our API classes
 
 v0.9.1
+======
+
 * Tests are now compatible with Ruby 1.9.2
 * Added JSON to runtime dependencies
 * Removed examples directory (referenced from github instead)
 
 v0.9.0
+======
+
 * Added parse_signed_request to handle Facebook's new authentication scheme
   * note: creates dependency on OpenSSL (OpenSSL::HMAC) for decryption
 * Added GraphCollection class to provide paging support for GraphAPI get_connections and search methods (thanks to jagthedrummer)
@@ -205,14 +277,20 @@ v0.9.0
 * If Facebook returns nil for search or get_connections requests, Koala now returns nil rather than throwing an exception
 
 v0.8.0
+======
+
 * Breaking interface changes
   * Removed string overloading for the methods, per 0.7.3, which caused Marshaling issues
   * Removed ability to provide a string as the second argument to url_for_access_token, per 0.5.0
 
 v0.7.4
+======
+
 * Fixed bug with get_user_from_cookies
 
 v0.7.3
+======
+
 * Added support for picture sizes -- thanks thhermansen for the patch!
 * Adjusted the return values for several methods (get_access_token, get_app_access_token, get_token_from_session_key, get_tokens_from_session_keys, get_user_from_cookies)
   * These methods now return strings, rather than hashes, which makes more sense
@@ -225,18 +303,24 @@ v0.7.3
 * Added license
 
 v0.7.2
+======
+
 * Added support for exchanging session keys for OAuth access tokens (get_token_from_session_key for single keys, get_tokens_from_session_keys for multiple)
 * Moved Koala files into a koala/ subdirectory to minimize risk of name collisions
 * Added OAuth Playground git submodule as an example
 * Updated tests, readme, and changelog
 
 v0.7.1
+======
+
 * Updated RealtimeUpdates#list_subscriptions and GraphAPI#get_connections to now return an
 array of results directly (rather than a hash with one key)
 * Fixed a bug with Net::HTTP-based HTTP service in which the headers hash was improperly formatted
 * Updated readme
 
 v0.7.0
+======
+
 * Added RealtimeUpdates class, which can be used to manage subscriptions for user updates (see http://developers.facebook.com/docs/api/realtime)
 * Added picture method to graph API, which fetches an object's picture from the redirect headers.
 * Added _greatly_ improved testing with result mocking, which is now the default set of tests
@@ -245,16 +329,21 @@ v0.7.0
 * Much internal refactoring
 * Updated readme, changelog, etc.
 
-
 v0.6.0
+======
+
 * Added support for the old REST API thanks to cbaclig's great work
 * Updated tests to conform to RSpec standards
 * Updated changelog, readme, etc.
 
 v0.5.1
+======
+
 * Documentation is now on the wiki, updated readme accordingly.
 
 v0.5.0
+======
+
 * Added several new OAuth methods for making and parsing access token requests
 * Added test suite for the OAuth class
 * Made second argument to url_for_access_token a hash (strings still work but trigger a deprecation warning)
@@ -262,20 +351,28 @@ v0.5.0
 * Updated readme
 
 v0.4.1
+======
+
 * Encapsulated GraphAPI and OAuth classes in the Koala::Facebook module for clarity (and to avoid claiming the global Facebook class)
 * Moved make_request method to Koala class from GraphAPI instance (for use by future OAuth class functionality)
 * Renamed request method to api for consistancy with Javascript library
 * Updated tests and readme
 
 v0.4.0
+======
+
 * Adopted the Koala name
 * Updated readme and tests
 * Fixed cookie verification bug for non-expiring OAuth tokens
 
 v0.3.1
+======
+
 * Bug fixes.
 
 v0.3
+====
+
 * Renamed Graph API class from Facebook::GraphAPI to FacebookGraph::API
 * Created FacebookGraph::OAuth class for tokens and OAuth URLs
 * Updated method for including HTTP service (think we've got it this time)
@@ -283,12 +380,18 @@ v0.3
 * Added CHANGELOG and gemspec
 
 v0.2
+====
+
 * Gemified the project
 * Split out HTTP services into their own file, and adjusted inclusion method
 
 v0.1
+====
+
 * Added modular support for Typhoeus
 * Added tests
 
 v0.0
-* Hi from F8!  Basic read/write from the graph is working
+====
+
+* Hi from F8!  Basic read/write from the graph is working

data/koala.gemspec

@@ -20,9 +20,9 @@ Gem::Specification.new do |gem|
   gem.extra_rdoc_files = ["readme.md", "changelog.md"]
   gem.rdoc_options     = ["--line-numbers", "--inline-source", "--title", "Koala"]
 
-  gem.add_runtime_dependency(%q<multi_json>,    ["~> 1.3"])
-  gem.add_runtime_dependency(%q<faraday>,       ["~> 0.8"])
-  gem.add_runtime_dependency(%q<addressable>,   ["~> 2.2"])
-  gem.add_development_dependency(%q<rspec>,     ["~> 2.8"])
-  gem.add_development_dependency(%q<rake>,      ["~> 0.8"])
+  gem.add_runtime_dependency("multi_json")
+  gem.add_runtime_dependency("faraday")
+  gem.add_runtime_dependency("addressable")
+  gem.add_development_dependency("rspec")
+  gem.add_development_dependency("rake")
 end

data/lib/koala.rb

@@ -15,20 +15,29 @@ require 'koala/http_service'
 # miscellaneous
 require 'koala/utils'
 require 'koala/version'
+require 'ostruct'
 
 module Koala
   # A Ruby client library for the Facebook Platform.
   # See http://github.com/arsduo/koala/wiki for a general introduction to Koala
   # and the Graph API.
-  
+
   # Making HTTP requests
   class << self
-    # Control which HTTP service framework Koala uses. 
+    # Control which HTTP service framework Koala uses.
     # Primarily used to switch between the mock-request framework used in testing
     # and the live framework used in real life (and live testing).
     # In theory, you could write your own HTTPService module if you need different functionality,
     # but since the switch to {https://github.com/arsduo/koala/wiki/HTTP-Services Faraday} almost all such goals can be accomplished with middleware.
     attr_accessor :http_service
+
+    def configure
+      yield config
+    end
+
+    def config
+      @config ||= OpenStruct.new(HTTPService::DEFAULT_SERVERS)
+    end
   end
 
   # @private
@@ -39,14 +48,14 @@ module Koala
       # if this is a deprecated module, support the old interface
       # by changing the default adapter so the right library is used
       # we continue to use the single HTTPService module for everything
-      service.deprecated_interface 
+      service.deprecated_interface
     else
       # if it's a real http_service, use it
       @http_service = service
     end
   end
 
-  # An convenenient alias to Koala.http_service.make_request. 
+  # An convenenient alias to Koala.http_service.make_request.
   def self.make_request(path, args, verb, options = {})
     http_service.make_request(path, args, verb, options)
   end