Hey everyone,

We’re excited to announce the release of Koala 1.0 beta 2!  Thank you all for the feedback and ideas that you’ve sent and we’ve incorporated over the last month — thanks to them, Koala is much stronger and easier to use than ever before.

Revised Photo Uploads

With this beta, we’ve revamped photo uploads, making the process simpler by replacing the file hash with a number of convenient options:

# 1) Path to a photo
@graph.put_picture(path_to_my_file)
# 2) Upload a file directly
@graph.put_picture(file_class_object)
# 3) Rails 3 file uploads (ActionDispatch::Http::UploadedFile)
@graph.put_picture(params[:file])
# 4) Sinatra file uploads (Hash)
@graph.put_picture(file_hash)

See more about the new photo interface on the updated Koala wiki.

Important note: the new, final interface is not backwards compatible, so you’ll have to update your code once you upgrade to beta2.  Sorry about that :\

Other Updates

  • Added put_connection and delete_connection convenience methods, which can be used for manipulating albums and provides future compatibility with new Graph API methods.
  • You can now provide an http_options hash to any method as the final parameter (see http_services.rb for more info).
  • You can test your apps against Facebook’s beta tier by passing :beta => true in the http options for any method.
  • TestUser#befriend now requires user info hashes (id and access token) due to Facebook API changes
  • Koala’s APIError is now < StandardError, not Exception

Upgrading

To install the beta, just run sudo gem install koala –pre.  (This seems to work for both 0.10 and 1.0.0.beta1.)

To 1.0

In the next few weeks, we’ll be adding native Typhoeus file upload support and working through the fork and pull queues, which are filled with great ideas.  We’ll probably release one more beta to let you all play with Typhoeus uploads, and once that dust settles we’ll release the final version.

As always, please send us any feedback, comments, and questions!  We’re happy to hear from you.

Best,

The Koala Team
(Alex, Chris, Rafi, and the folks at Context Optional)