All Versions
44
Latest Version
Avg Release Cycle
414 days
Latest Release
1539 days ago

Changelog History
Page 3

  • v1.3 Changes

    🆕 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
    • APIError#raw_response allows access to the raw error response received from Facebook
    • 🗄 Utils.deprecate only prints each message once (no more spamming)
    • API#get_page_access_token now accepts additional arguments and HTTP options (like other calls)
    • ⚡️ TestUsers and RealtimeUpdates methods now take http_options arguments
    • 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
    • 👉 KoalaTest.test_user_api allows access to the TestUsers instance
    • 🔧 Configured tests to run in random order using RSpec 2.8.0rc1

  • v1.2.1 Changes

    🆕 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 Changes

    🆕 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!)
    • 📜 Bug fixes to put_picture, parse_signed_request, and the test suite (thanks, johnbhall and Will S.!)
    • Smarter GraphCollection use
      • Any pageable result will now become a GraphCollection
      • 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
      • Koala::HTTPService.faraday_middleware allows custom middleware configurations
      • Koala now defaults to Net::HTTP rather than Typhoeus
      • Koala::NetHTTPService and Koala::TyphoeusService modules no longer exist
      • Koala no longer automatically switches to Net::HTTP when uploading IO objects to Facebook
    • ⚡️ 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
      • OAuth code and session key tests cannot be run against test users
    • ✅ Faraday adapter for live tests can be specified with ADAPTER=[your adapter] in the rspec command
    • ✅ Live tests can be run against the beta server by specifying BETA=true in the rspec command
    • ✅ Tests now pass against all rubies on Travis CI
    • 🔨 Expanded and refactored test coverage
    • 🛠 Fixed bug with YAML parsing in Ruby 1.9

  • v1.1 Changes

    🆕 New methods:

    • ➕ Added Batch API support (thanks, seejohnrun and spiegela!)
      • includes file uploads, error handling, and FQL
    • ➕ Added GraphAPI#put_video
    • Added GraphAPI#get_comments_for_urls (thanks, amrnt!)
    • ➕ 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!)
      • Includes support for uploading StringIOs and other non-files via Net::HTTP even when using TyphoeusService
    • 💎 Koala now uses multi_json to improve compatibility with Rubinius and other Ruby versions
    • Koala now uses the modern Typhoeus API (thanks, aselder!)
    • Koala now uses the current modern Net::HTTP interface (thanks, romanbsd!)
    • 🛠 Fixed bugs and typos (thanks, waynn, mokevnin, and tikh!)

  • v1.0 Changes

    🆕 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
    • ✅ TestUser#befriend now requires user info hashes (id and access token) due to Facebook API changes (thanks, pulsd and kbighorse!)
    • All methods now accept an http_options hash as their optional last parameter (thanks, spiegela!)
    • 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:

    • 0️⃣ 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
    • Read-only REST API requests now go through the faster api-read server
    • Replaced parse_signed_request with a version from Facebook that also supports the new signed params proposal
      • Note: invalid requests will now raise exceptions rather than return nil, in keeping with other SDKs
    • Delete methods will now raise an error if there's no access token (like put_object and delete_like)
    • Updated parse_signed_request to match Facebook's current implementation (thanks, imajes!)
    • 👻 APIError is now < StandardError, not Exception
    • ➕ Added KoalaError for non-API errors
    • 0️⃣ 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)
    • ✅ Live tests now verify that the access token has the necessary permissions before starting
    • ✅ Replaced the 50-person network test, which often took 15+ minutes to run live, with a 5-person test

  • v0.10.0 Changes

    • ➕ 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 Changes

    • ✅ Tests are now compatible with Ruby 1.9.2
    • ➕ Added JSON to runtime dependencies
    • ✂ Removed examples directory (referenced from github instead)

  • v0.9.0 Changes

    • 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)
    • ➕ Added get_page method to easily fetch pages of results from GraphCollections
    • Exchanging sessions for tokens now works properly when provided invalid/expired session keys
    • You can now include a :typhoeus_options key in TyphoeusService#make_request's options hash to control the Typhoeus call (for example, to set :disable_ssl_peer_verification => true)
    • All paths provided to HTTP services start with leading / to improve compatibility with stubbing libraries
    • 👻 If Facebook returns nil for search or get_connections requests, Koala now returns nil rather than throwing an exception

  • v0.8.0 Changes

    • 💥 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 Changes

    • 👉 Fixed bug with get_user_from_cookies