Vinegar
Rotten Tomatoes API Wrapper in Ruby. Currently the wrapper supports the movies api and lists api is comming shortly.
Installation
Sign up for a Rotten Tomatoes API key:
http://developer.rottentomatoes.com/member/register
Add this line to your application's Gemfile:
gem 'vinegar'
And then execute:
$ bundle
Or install it yourself as:
$ gem install vinegar
Documentation
http://rdoc.info/github/jasontruluck/vinegar
Usage
Setup a new client
client = Vinegar::Client.new(:api_key => 1234567890)
client.movies_search("Star Wars")
client.movie(12345) #12345 is the movies Rotten Tomatoes ID
client.full_movie_cast(12345) #12345 is the movies Rotten Tomatoes ID
client.all_movie_reviews(12345) #12345 is the movies Rotten Tomatoes ID
client.similar_movies(12345) #12345 is the movies Rotten Tomatoes ID
client.clips_for_movie(12345) #12345 is the movies Rotten Tomatoes ID
Testing
This gem uses VCR to record requests to the api so you must test using a valid API key from Rotten Tomatoes.
Add a sample authentications file to your spec/fixtures
directory:
#spec/fixtures/authentications.yml
api_key: "1234567890" # Your API key
movies_search: "Star Wars" # Movie title you would like to use for tests
movie_id: "9" # ID of a movie you would like to use for tests
A sample is included in the directory.
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request