<html><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div>The <a href="http://rubyforge.org/projects/freebaseapi/">Ruby Freebase API</a> currently provides read access to <a href="http://www.freebase.com">http://www.freebase.com/</a>.</div><div><br class="webkit-block-placeholder"></div><div>This release includes:</div><ul class="MailOutline"><li>Gem support. This means installing is a snap if you already have ruby and gems installed on your system.</li><li>JSON Parsing fix. The Ruby on Rails JSON parser was not compliant and failed on some freebase mql reads, JSON is now parsed using the JSON parser from <a href="http://json.rubyforge.org/">http://json.rubyforge.org/</a></li><li>Unit test framework - support for caching responses as files so there's no runtime requirement on the freebase service and changes to data will not break existing tests.</li></ul><div><br class="webkit-block-placeholder"></div><div><b>This library is still early ALPHA. The API will change, there's going to be some bugs. Your help in any form is appreciated.</b></div><div><br class="webkit-block-placeholder"></div><div>To Install:</div><div><font class="Apple-style-span" face="'Courier New'">~ $ sudo gem install -y freebase</font></div><div><font class="Apple-style-span" face="'Courier New'"><div>Successfully installed freebase-0.0.1</div><div>1 gem installed</div><div>Installing ri documentation for freebase-0.0.1...</div><div>Installing RDoc documentation for freebase-0.0.1...</div></font></div><div><br class="webkit-block-placeholder"></div><div>You can then launch an interactive ruby shell to try it out:</div><div><br class="webkit-block-placeholder"></div><div><div><font class="Apple-style-span" face="'Courier New'">chris:~ chris$ irb</font></div><div><font class="Apple-style-span" face="'Courier New'">irb(main):001:0> require 'rubygems'</font></div><div><font class="Apple-style-span" face="'Courier New'">=> true</font></div><div><font class="Apple-style-span" face="'Courier New'">irb(main):002:0> require 'freebase'</font></div><div><font class="Apple-style-span" face="'Courier New'">=> true</font></div><div><font class="Apple-style-span" face="'Courier New'">irb(main):003:0> (an_artist = Freebase::Types::Music::Artist.find(:first)).name</font></div><div><span class="Apple-style-span" style="font-family: 'Courier New'; ">=> "Blonde Redhead"</span></div><div><font class="Apple-style-span" face="'Courier New'"><div>irb(main):004:0> an_artist.albums.size</div><div>=> 17</div><div><div>irb(main):005:0> an_artist.albums[2].name</div><div>=> "Fake Can Be Just as Good"</div><div>irb(main):006:0> an_artist.albums[2].tracks.size</div><div>=> 8</div><div>irb(main):007:0> an_artist.albums[2].tracks.first.name</div><div>=> "Kazuality"</div></div></font></div><div><font class="Apple-style-span" face="'Courier New'"><br class="webkit-block-placeholder"></font></div><div><font class="Apple-style-span" face="'Courier New'"><span class="Apple-style-span" style="font-family: Helvetica; ">Ruby on Rails support is still available, but it now requires the gem to be installed. To install the latest:</span></font></div><div><br class="webkit-block-placeholder"></div><div><div><font class="Apple-style-span" face="'Courier New'">rails_project $ ./script/plugin install <a href="http://freebaseapi.rubyforge.org/svn/trunk/plugins/rails/freebase">http://freebaseapi.rubyforge.org/svn/trunk/plugins/rails/freebase</a></font></div><div><font class="Apple-style-span" face="'Courier New'">+ ./config/freebase.yml</font></div><div><font class="Apple-style-span" face="'Courier New'">+ ./init.rb</font></div><div><font class="Apple-style-span" face="'Courier New'">+ ./install.rb</font></div><div><font class="Apple-style-span" face="'Courier New'">+ ./tasks/freebase_tasks.rake</font></div><div><font class="Apple-style-span" face="'Courier New'">+ ./uninstall.rb</font></div><div><font class="Apple-style-span" face="'Courier New'">Installing: config/freebase.yml</font></div><div><span class="Apple-style-span" style="font-family: 'Courier New'; ">If you haven't yet done so, please install the freebase gem:</span></div><div><font class="Apple-style-span" face="'Courier New'">[sudo] gem install freebase</font></div><div><br class="webkit-block-placeholder"></div><div>Enjoy!</div><div>- Chris Eppstein</div></div></div></body></html>