gem 'worth_watching'

# Create a new aggregator, passing in your API keys
movie_aggregator = WorthWatching::Aggregator.new("rotten_tomato_api_key", "tmdb_api_key")

# Search for movies by title. Returns an array of hashes, each hash representing
# a movie in the search result
# Note that it returns the Rotten Tomatoes ID for each movie, which is vital to aggregation
searcher = WorthWatching::RottenTomatoes::Searcher.new("rt_api_key")
searcher.search_by_title("the godfather", 4)
=> [{:title=>"The Godfather", :rt_id=>"12911", :year=>"1972"},
{:title=>"The Godfather, Part II", :rt_id=>"12926", :year=>"1974"},
{:title=>"The Godfather, Part III", :rt_id=>"13476", :year=>"1990"},
{:title=>"The Godfather of Green Bay", :rt_id=>"341816359", :year=>"2005"}]

# Pass the movie's Rotten Tomatoes ID
toy_story_3 = movie_aggregator.aggregate_movie("770672122")

# We now have a Movie object and can access many attributes...
toy_story_3.title
=> "Toy Story 3"

# Access ratings individually
toy_story_3.rt_rating
=> 99

toy_story_3.imdb_rating
=> 8.5

toy_story_3.metacritic_rating
=> 92

# Get the rating summary as a string
puts toy_story_3.rating_summary
=> "Rotten Tomatoes rating: 99
IMDB rating: 8.5
Metacritic rating: 92"

toy_story_3.plot
=> "Pixar returns to their first success with Toy Story 3. The movie begins with
Andy leaving for college and donating his beloved toys -- including Woody
(Tom Hanks) and Buzz (Tim Allen) -- to a daycare. While the crew meets new friends,
including Ken (Michael Keaton), they soon grow to hate their new surroundings and
plan an escape. The film was directed by Lee Unkrich from a script co-authored by
Little Miss Sunshine scribe Michael Arndt. ~ Perry Seibert, Rovi"

toy_story_3.director
=> "Lee Unkrich"

toy_story_3.cast
=> "Tom Hanks, Tim Allen, Joan Cusack, Ned Beatty"

toy_story_3.genre
=> "Animation"

toy_story_3.release_date
=> #<Date: 2010-06-18 ((2455366j,0s,0n),+0s,2299161j)>

# Rotten Tomatoes URL
toy_story_3.rt_url
=> "http://www.rottentomatoes.com/m/toy_story_3/"

toy_story_3.imdb_url
=> "http://www.imdb.com/title/tt0435761/"

toy_story_3.metacritic_url
=> "http://www.metacritic.com/movie/toy-story-3"

# Rotten Tomatoes ID
toy_story_3.rt_id
=> "770672122"

toy_story_3.imdb_id
=> "0435761"

toy_story_3.poster
=> "http://cf2.imgobject.com/t/p/original/tOwAAVeL1p3ls9dhOBo45ElodU3.jpg"

# Get a general summary
puts toy_story_3.summary
=> "Toy Story 3
------------------------------------------------------------
Released: 18 Jun 2010
------------------------------------------------------------
Pixar returns to their first success with Toy Story 3. The movie begins with Andy
leaving for college and donating his beloved toys -- including Woody (Tom Hanks)
and Buzz (Tim Allen) -- to a daycare. While the crew meets new friends,
including Ken (Michael Keaton), they soon grow to hate their new surroundings
and plan an escape. The film was directed by Lee Unkrich from a script
co-authored by Little Miss Sunshine scribe Michael Arndt. ~ Perry Seibert, Rovi
------------------------------------------------------------
Cast: Tom Hanks, Tim Allen, Joan Cusack, Ned Beatty
------------------------------------------------------------
Rotten Tomatoes rating: 99
IMDB rating: 8.5
Metacritic rating: 92"

# Get the first review
a_review = toy_story_3.reviews.last
a_review.author
=> "Ailsa Caine"

a_review.date
=> #<Date: 2010-07-22 ((2455400j,0s,0n),+0s,2299161j)>

a_review.quote
=> "By [Pixar's] high standards this isn't the best, but by anyone else's, it's close to perfection."

# Reviews are those collated by Rotten Tomatoes, where the review scale is binary ("fresh" or "rotten")
a_review.rating
=> "fresh"

# The review's original score (not always available)
a_review.original_score
=> "4/5"

a_review.source
=> "Little White Lies"

a_review.link
=> "http://www.littlewhitelies.co.uk/theatrical-reviews/toy-story-3/"

# Convenience method to summarise the review as a string
a_review.to_s
=> "Ailsa Caine wrote on 2010-07-22 : By [Pixar's] high standards this isn't the best, but by anyone else's, it's close to perfection.
Rating: 4/5"

# Create a new fetcher using your API key
list_fetcher = WorthWatching::RottenTomatoes::MovieListFetcher.new("rt_api_key")

# Get the top 4 box office movies in the UK
list_fetcher.fetch_list(:box_office, :uk, 4)
=> [{:title=>"A Most Wanted Man", :rt_id=>"771314084", :year=>"2014", :rt_rating=>91},
 {:title=>"Before I Go to Sleep", :rt_id=>"771367646", :year=>"2014", :rt_rating=>58},
 {:title=>"Let's Be Cops", :rt_id=>"771372963", :year=>"2014", :rt_rating=>20},
 {:title=>"Magic in the Moonlight", :rt_id=>"771367659", :year=>"2014", :rt_rating=>51}]

# Or the top 6 releases on DVD in the US
top_dvds = list_fetcher.fetch_list(:top_rentals, :us, 6)
=> [{:title=>"Captain America: The Winter Soldier", :rt_id=>"771312513", :year=>"2014", :rt_rating=>89},
 {:title=>"The Amazing Spider-Man 2", :rt_id=>"771249926", :year=>"2014", :rt_rating=>53},
 {:title=>"Godzilla", :rt_id=>"771225175", :year=>"2014", :rt_rating=>73},
 {:title=>"Neighbors", :rt_id=>"771308254", :year=>"2014", :rt_rating=>73},
 {:title=>"Divergent", :rt_id=>"771315918", :year=>"2014", :rt_rating=>41},
 {:title=>"Noah", :rt_id=>"771305170", :year=>"2014", :rt_rating=>77}]

# The above list-based methods return an array of hashes, each representing a result
number_1_dvd = top_dvds.first
=> {:title=>"Captain America: The Winter Soldier", :rt_id=>"771312513", :year=>"2014", :rt_rating=>89}

# Use the rt_id (Rotten Tomato ID) to subsequently aggregate movie info
aggregated_results = top_dvds.map { |movie| aggregator.aggregate_movie(movie[:rt_id]) }