Hey everyone,
I’m excited to announce the release of the Koala 1.1 release candidate!
The big news here is support for Facebook’s batch API, which lets you bundle a number of operations into one request from Facebook:
me, friends = Koala::Facebook::GraphAPI.batch do
   @api.get_object('me')
   @api.get_connections('me', 'friends')
end
We’ve also added new convenience methods, improved others, and refactored the HTTP services to be more modular.  All changes are, of course, fully tested and non-breaking (though if you’re interacting directly with Koala’s HTTPServices, you should review the changes).
Documentation is available on the wiki, and the complete diff since 1.0 is available here.

Installation

Just run
[sudo] gem install koala --pre
or add
gem "koala", "~> 1.1.0rc"
to your Gemfile.

Changes

New methods:
  • You can now make batch requests to Facebook; we support the entire API, including file uploads, error handling, and FQL.
  • GraphAPI#get_comments_for_urls (pretty self-explanatory)
  • RestAPI#fql_multiquery, which simplifies both making the requests and using the results
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.
  • UploadableIO can take a filename (for the Ads API)
  • get_objects([]) returns [] instead of a Facebook error

Internal improvements:

  • HTTP services are more modular and can be changed on the fly
    • Includes support for uploading StringIOs and other non-files via Net::HTTP even when using TyphoeusService
  • Support for global proxy and timeout settings
  • Support for setting certificate path and file to address Net::HTTP errors under Ruby 1.9.2

Thank to…

We’ve had a lot of great contributions in this release.  Huge thanks to chadk for refactoring the HTTPServices, to seejohnrun for the initial implementation of the Batch API, and to amrnt and aselder, who both contributed several patches.  As always, thanks also to Chris, my codeveloper, and to the people at Context Optional, who have been awesome in supporting Koala’s development.

Note: Facebook now requests access tokens for certain API requests

In case you missed this on the FB developer blog, Graph API requests for PROFILE_ID/feed and PROFILE_ID/posts now requires an access token.  This is a breaking change on Facebook’s end.  If you’ve started to see errors when making anonymous requests for those connections, that’s why.

What’s next

If everything goes well with the release candidate, we’ll release 1.1 mid-month.  In the meanwhile, if you encounter any issues or have any questions, drop me an email or open up an issue.
Enjoy the Batch API and have a great week!
Alex
http://github.com/arsduo/koala