Hey everyone,
Happy new year! I hope you’ve all had a great start to 2012 — and what better way to kick the year off than with a new version of Koala?
Goodbye, REST API, someday
Facebook has finally ported over the last of the REST API functions to the Graph API, meaning that anything you can do with Facebook you can do through the newer interface…and that it’s time for them to deprecate the REST API. No need to rush — the older interface will still be around for a while and Koala of course will support it till the end — but you should start migrating over if you’re still using any REST API calls.
Documentation!
Koala is now completely documented; information on every public method and class is available on rubydoc.info. I know everyone loves rummaging around in source code, but if ever you feel like you just want a concise, useful writeup of the methods available to you, check it out here.
Other improvements
Here are the biggest changes since the last release:
- New OAuth#url_for_dialog method creates URLs for Facebook dialog pages
- New API#set_app_restrictions handles JSON-encoding app restrictions
- New GraphCollection.parse_page_url now exposes useful functionality for non-Rails apps (see this issue)
- Utils.deprecate only prints each message once (no more spamming!)
- OAuth#url_for_access_token and #url_for_oauth_code now include any provided options as URL parameters
- 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
- Fixed bugs, reorganized file and class structure non-destructively, expanded/improved test coverage
The complete changelog is here, and the diff since 1.2.1 is here.
What’s next
Nothing much, actually. Koala is stable and recent Facebook changes haven’t required any new code on our end (which we’re very excited about). We’ll keep an eye on the FB developer blog and update Koala as the API changes; in the meanwhile, feel free to submit any pull requests if there’s code you want to add or improve.
Have a great 2012!
