# Robbie [Rovi](http://developer.rovicorp.com/Get_Started) API wrapper ## Installation Add this line to your application's Gemfile: ```ruby gem "robbie" ``` And then execute: ```bash $ bundle ``` Or install it yourself as: ```bash $ gem install robbie ``` ## Usage Working with models ```ruby require "robbie" Robbie.setup(api_key: "your api key", api_secret: "your api secret") foo = Robbie::Artist.find_by_name("foo fighters") # ] # > # ...or directly by id foo = Robbie::Artist.find("MN0000184043") foo.albums.last # # ...or directly by id Robbie::Album.find("MW0002115022") foo.albums.last.tracks.first # ], # @title="Bridge Burning", # @duration=286 # > # ...or directly by id Robbie::Track.find("MT0041016087") ``` Autocomplete and extended autocomplete ```ruby Robbie::Autocomplete.complete("b") # ["Beyoncé", "Bruno Mars", "Bad Meets Evil", "Bon Iver", "Bob Marley", # "Big Sean", "The Band Perry", "Blake Shelton", "B.O.B", "The Black Eyed Peas"] Robbie::Autocomplete.predict("b").first # ] # > ``` You can turn response caching ```ruby # on Robbie.enable_cache # and off Robbie.disable_cache ``` ## Contributing 1. Fork it 2. Create your feature branch (`git checkout -b my-new-feature`) 3. Commit your changes (`git commit -am 'Added some feature'`) 4. Push to the branch (`git push origin my-new-feature`) 5. Create new Pull Request