Hey everyone,

Fresh like a crepe off the pan comes Koala 1.3rc2 to fill your stomach and brighten your day. (The holidays really seem to bring out the food imagery, don’t they?)

Documentation!

Koala has always had a thorough wiki, but until now you’ve had to look at the source code to see what methods are available and what they do.  No more!  The library is now completely documented; information on every public method and class is available on rubydoc.info.  If you don’t feel like rummaging through the source code for the method signature of a particular method, you no longer have to.  (Not that there’s anyone here who doesn’t like digging through the code of their libraries, I’m sure.)

Winter cleaning

With the holidays approaching and the relatives coming over, it was to give Koala a long overdue housecleaning.  The lib/koala/ directory was getting a bit crowded, so I’ve reorganized, moving a number of files into the new the api/ and http_service/ subdirectories.  I’ve also updated the class structure largely to match, putting classes and modules in more logical places.

Don’t worry, though — for each move there’s an alias to ensure your existing code doesn’t break, and there’s even a legacy spec to really ensure all the old references work.  (If you’re directly referencing any of Koala’s more internal classes in your code — MultipartRequest,  Response, UploadableIO, BatchOperation, or GraphCollection — check out the legacy spec for more details.)

Other updates since 1.3rc1

  • RealtimeUpdates#subscription_path and TestUsers#test_user_accounts_path are now public methods
  • TestUsers and RealtimeUpdates methods now take http_options arguments
  • All methods with http_options can now take :http_component => :response for the complete response object
  • Fixed bugs in RealtimeUpdates and TestUsers

Installation

As always:

[sudo|rvm] gem install koala --pre

Or with Bundler:

gem "koala", "~> 1.3.0rc2"

What’s next

Assuming I don’t come up with any other projects like documentation and cleanup, I’ll release 1.3 soon.  After that, we’ll just kick back, enjoy the holidays, and update as needed to stay current with the Facebook API.

Have a great week,

Alex
http://github.com/arsduo/koala

wooo