worth_watching 0.1.5 → 1.0.0

data/spec/unit/movie_spec.rb

@@ -1,54 +1,33 @@
-require 'test_helper'
+require 'spec_helper'
 require 'json'
 
 describe "WorthWatching::Movie" do
   let(:movie) do
-    response_movie_hash = File.read(File.dirname(__FILE__) + "/../support/json_responses/toy_story_rt.json")
-    WorthWatching::Movie.new(JSON.parse(response_movie_hash))
+    WorthWatching::Movie.new({title: "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",
+              director: "Lee Unkrich",
+              genre: "Animation",
+              rt_rating: "99",
+              rt_url: "http://www.rottentomatoes.com/m/toy_story_3/",
+              cast: "Tom Hanks, Tim Allen, Joan Cusack, Ned Beatty",
+              imdb_id: "0435761",
+              imdb_url: "http://www.imdb.com/title/tt0435761/",
+              release_date: Date.parse("2010-06-18"),
+              rt_id: "770672122"
+              })
   end
 
   it "has a valid constructor" do
       expect(movie).to be_an_instance_of(WorthWatching::Movie)
   end
 
-  it "creates a printable string of cast members from an array of individual actors" do
-    expect(movie.cast).to eq("Tom Hanks, Tim Allen, Joan Cusack, Ned Beatty")
-  end
-
-  it "should have the title 'Toy Story 3" do
-    expect(movie.title).to eq("Toy Story 3")
-  end
-
-  it "should have correct plot'" do
-    expect(movie.plot).to eq("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")
-  end
-
-  it "should have a link to RT page 'http://www.rottentomatoes.com/m/toy_story_3/'" do
-    expect(movie.rt_url).to eq("http://www.rottentomatoes.com/m/toy_story_3/")
-  end
-
-  it "should have imdb url 'http://www.imdb.com/title/tt0435761/" do
-    expect(movie.imdb_url).to eq("http://www.imdb.com/title/tt0435761/")
-  end
-
-  it "should have release date '2010-06-18'" do
-    expect(movie.release_date).to eq(Date.new(2010, 06, 18))
-  end
-
-  it "should have director 'Lee Unkrich'" do
-    expect(movie.director).to eq("Lee Unkrich")
-  end
-
-  it "should have genre 'Animation'" do
-    expect(movie.genre).to eq("Animation")
-  end
-
-  it "has a general summary" do
+  it "returns a general summary" do
     summary = "------------------------------------------------------------\nToy Story 3\n------------------------------------------------------------\nReleased: 18 Jun 2010\n------------------------------------------------------------\nPixar 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\n------------------------------------------------------------\nCast: Tom Hanks, Tim Allen, Joan Cusack, Ned Beatty\n------------------------------------------------------------\nRotten Tomatoes rating: 99\nIMDB rating: Not retrieved\nMetacritic rating: Not retrieved\n\n"
+
     expect(movie.summary).to eq(summary)
   end
 
-  it "has a rating summary" do
+  it "returns a rating summary" do
     summary = "Rotten Tomatoes rating: 99\nIMDB rating: Not retrieved\nMetacritic rating: Not retrieved\n"
     expect(movie.rating_summary).to eq(summary)
   end

data/spec/unit/rotten_tomatoes/movie_info_fetcher_spec.rb

@@ -0,0 +1,63 @@
+require 'spec_helper'
+
+describe "WorthWatching::RottenTomatoes::MovieInfoFetcher" do
+  before do
+    # Single movie RottenTomatoes
+    json_response = File.read(File.dirname(__FILE__) + "/../../support/json_responses/toy_story_rt.json")
+    stub_request(:get, /api\.rottentomatoes\.com\/api\/public\/v1\.0\/movies\/770672122\.json\?apikey\=.*/).to_return(:status => 200, :body => json_response,:headers => {"content-type"=>["application/json; charset=utf-8"]})
+  end
+
+  let(:fetcher) { WorthWatching::RottenTomatoes::MovieInfoFetcher.new("rt_api_key") }
+
+  let(:movie) { fetcher.fetch_info("770672122") }
+
+  describe "the Movie object returned" do
+    it "has the correct movie title" do
+      expect(movie.title).to eq("Toy Story 3")
+    end      
+
+    it "has the correct movie cast" do
+      expect(movie.cast).to eq("Tom Hanks, Tim Allen, Joan Cusack, Ned Beatty")
+    end
+
+    it "has director 'Lee Unkrich'" do
+      expect(movie.director).to eq("Lee Unkrich")
+    end
+
+    it "creates a printable string of cast members from an array of individual actors" do
+      expect(movie.cast).to eq("Tom Hanks, Tim Allen, Joan Cusack, Ned Beatty")
+    end
+
+    it "has the title 'Toy Story 3" do
+      expect(movie.title).to eq("Toy Story 3")
+    end
+
+    it "has the correct plot'" do
+      expect(movie.plot).to eq("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")
+    end
+
+    it "has a link to RT page 'http://www.rottentomatoes.com/m/toy_story_3/'" do
+      expect(movie.rt_url).to eq("http://www.rottentomatoes.com/m/toy_story_3/")
+    end
+
+    it "has imdb url 'http://www.imdb.com/title/tt0435761/" do
+      expect(movie.imdb_url).to eq("http://www.imdb.com/title/tt0435761/")
+    end
+
+    it "has the release date '2010-06-18'" do
+      expect(movie.release_date).to eq(Date.new(2010, 06, 18))
+    end
+
+    it "has the genre 'Animation'" do
+      expect(movie.genre).to eq("Animation")
+    end
+
+    it "has a placeholder IMDb rating'" do
+      expect(movie.imdb_rating).to eq("Not retrieved")
+    end
+
+    it "has a placeholder Metacritic rating'" do
+      expect(movie.imdb_rating).to eq("Not retrieved")
+    end
+  end
+end

data/spec/unit/rotten_tomatoes/movie_list_fetcher_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+
+describe "WorthWatching::RottenTomatoes::MovieListFetcher" do
+  before do
+    json_response = File.read(File.dirname(__FILE__) + "/../../support/json_responses/rt_top_16_in_cinemas.json")
+    stub_request(:get, "http://api.rottentomatoes.com/api/public/v1.0/lists/movies/in_theaters.json?apikey=rt_api_key&country=uk&limit=16&page=1&page_limit=16").
+             with(:headers => {'User-Agent'=>'Typhoeus - https://github.com/typhoeus/typhoeus'}).
+             to_return(:status => 200, :body => json_response, :headers => {})
+  end
+
+  let(:movie_info_fetcher) { WorthWatching::RottenTomatoes::MovieListFetcher.new("rt_api_key") }
+  let(:movies) { movie_info_fetcher.fetch_list(:in_theaters, :uk, 16) }
+
+  it "retrieves an array of Hash objects, each representing a movie result in the list" do
+    expect(movies).to be_a(Array)
+    movies.each {|movie| expect(movie).to be_a(Hash)}
+  end
+
+  describe "a single movie result in the movies list" do
+    let(:movie_result) { movies.first }
+
+    it "has the title of the movie" do
+      expect(movie_result[:title]).to eq("The Lego Movie")
+    end
+
+    it "has the Rotten Tomatoes ID of the movie" do
+      expect(movie_result[:rt_id]).to eq("771305753")
+    end
+
+    it "has the year the movie was released" do
+      expect(movie_result[:year]).to eq("2014")
+    end
+
+    it "has the year the movie was released" do
+      expect(movie_result[:rt_rating]).to eq(97)
+    end
+  end
+end

data/spec/unit/rotten_tomatoes/movie_parser_spec.rb

@@ -0,0 +1,80 @@
+require 'spec_helper'
+require 'json'
+
+describe "WorthWatching::RottenTomatoes::MovieParser" do
+  let (:complete_api_response) do
+    JSON.parse(File.read(File.dirname(__FILE__) + "/../../support/json_responses/toy_story_rt.json"))
+  end
+
+  let (:incomplete_api_response) do
+    JSON.parse(File.read(File.dirname(__FILE__) + "/../../support/json_responses/a_movie_with_little_info_rt.json"))
+  end
+
+  it "returns a Movie object representing the movie in the response" do
+    movie = WorthWatching::RottenTomatoes::MovieParser.parse(complete_api_response)
+    expect(movie).to be_a(WorthWatching::Movie)
+  end
+
+  describe "the Movie object created after parsing" do
+    context "when full movie information is available via the Rotten Tomatoes API" do
+      let (:movie) { WorthWatching::RottenTomatoes::MovieParser.parse(complete_api_response) }
+      
+      it "has the correct movie title" do
+        expect(movie.title).to eq("Toy Story 3")
+      end      
+
+      it "has the correct movie cast" do
+        expect(movie.cast).to eq("Tom Hanks, Tim Allen, Joan Cusack, Ned Beatty")
+      end
+
+      it "has director 'Lee Unkrich'" do
+        expect(movie.director).to eq("Lee Unkrich")
+      end
+
+      it "creates a printable string of cast members from an array of individual actors" do
+        expect(movie.cast).to eq("Tom Hanks, Tim Allen, Joan Cusack, Ned Beatty")
+      end
+
+      it "has the title 'Toy Story 3" do
+        expect(movie.title).to eq("Toy Story 3")
+      end
+
+      it "has the correct plot'" do
+        expect(movie.plot).to eq("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")
+      end
+
+      it "has a link to RT page 'http://www.rottentomatoes.com/m/toy_story_3/'" do
+        expect(movie.rt_url).to eq("http://www.rottentomatoes.com/m/toy_story_3/")
+      end
+
+      it "has imdb url 'http://www.imdb.com/title/tt0435761/" do
+        expect(movie.imdb_url).to eq("http://www.imdb.com/title/tt0435761/")
+      end
+
+      it "has the release date '2010-06-18'" do
+        expect(movie.release_date).to eq(Date.new(2010, 06, 18))
+      end
+
+      it "has the genre 'Animation'" do
+        expect(movie.genre).to eq("Animation")
+      end
+
+      it "has Rotten Tomato rating 99" do
+        expect(movie.rt_rating).to eq(99)
+      end
+    end
+
+    context "when the Rotten Tomatoes API has information missing about a movie" do
+      let (:movie) { WorthWatching::RottenTomatoes::MovieParser.parse(incomplete_api_response) }
+
+      it "has a director of nil" do
+        expect(movie.director).to eq(nil)
+      end
+
+      it "has a genre of nil" do
+        expect(movie.genre).to eq(nil)
+      end
+    end
+
+  end
+end

data/spec/unit/rotten_tomatoes/review_parser_spec.rb

@@ -0,0 +1,47 @@
+require 'spec_helper'
+require 'json'
+
+describe "WorthWatching::RottenTomatoesReviewParser" do
+  let (:review_response_hash) do
+    JSON.parse(File.read(File.dirname(__FILE__) + "/../../support/json_responses/toy_story_reviews_rt.json"))
+  end
+
+  it "returns an array of Review objects representing the review in the response" do
+    reviews = WorthWatching::RottenTomatoes::ReviewParser.parse(review_response_hash)
+    expect(reviews).to be_a(Array)
+    reviews.each { |review| expect(review).to be_a(WorthWatching::WrittenReview) }
+  end
+
+  describe "the WrittenReview object created after parsing" do
+    let (:review) { WorthWatching::RottenTomatoes::ReviewParser.parse(review_response_hash).last }
+    
+    it "has an author" do
+      expect(review.author).to eq("Ailsa Caine")
+    end
+
+    it "has a date" do
+      expect(review.date).to eq(Date.parse("2010-07-22"))
+    end
+
+    it "has a rating" do
+      expect(review.rating).to eq("fresh")
+    end
+
+    it "has the original score" do
+      expect(review.original_score).to eq("4/5")
+
+    end
+
+    it "has a source" do
+      expect(review.source).to eq("Little White Lies")
+    end
+
+    it "has a quote" do
+      expect(review.quote).to eq("By [Pixar's] high standards this isn't the best, but by anyone else's, it's close to perfection.")
+    end
+
+    it "has a link" do
+      expect(review.link).to eq("http://www.littlewhitelies.co.uk/theatrical-reviews/toy-story-3/")
+    end
+  end
+end

data/spec/unit/rotten_tomatoes/reviews_fetcher_spec.rb

@@ -0,0 +1,18 @@
+require 'spec_helper'
+
+describe "WorthWatching::RottenTomatoes::ReviewsFetcher" do
+  before do
+    # Movie reviews from RottenTomatoes
+    json_response = File.read(File.dirname(__FILE__) + "/../../support/json_responses/toy_story_reviews_rt.json")
+    stub_request(:get, /api\.rottentomatoes\.com\/api\/public\/v1\.0\/movies\/770672122\/reviews\.json\?apikey\=.*&country=uk&page=1&page_limit=5&review_type=top_critic/).to_return(:status => 200, :body => json_response,:headers => {"content-type"=>["application/json; charset=utf-8"]})
+  end
+
+  let(:movie_rt_id) { "770672122" }
+
+  it "retrieves a URL of the movie's poster" do
+    reviews = WorthWatching::RottenTomatoes::ReviewsFetcher.fetch("770672122", "rt_api_key")
+
+    expect(reviews).to be_a(Array)
+    reviews.each { |review| expect(review).to be_a(WorthWatching::WrittenReview) }
+  end
+end

data/spec/unit/rotten_tomatoes/searcher_spec.rb

@@ -0,0 +1,49 @@
+require 'spec_helper'
+
+describe "WorthWatching::RottenTomatoes::Searcher" do
+  describe "searching for movies" do
+    before do
+      json_response = File.read(File.dirname(__FILE__) + "/../../support/json_responses/1_movie_search_result.json")
+      stub_request(:get, /api\.rottentomatoes\.com\/api\/public\/v1\.0\/movies\.json\?apikey=.*&page_limit=4&q=finding%20nemo/).to_return(:status => 200, :body => json_response,:headers => {"content-type"=>["application/json; charset=utf-8"]})
+
+      json_response = File.read(File.dirname(__FILE__) + "/../../support/json_responses/3_movie_search_result.json")
+      stub_request(:get, /api\.rottentomatoes\.com\/api\/public\/v1\.0\/movies\.json\?apikey=.*&page_limit=4&q=toy%20story/).to_return(:status => 200, :body => json_response,:headers => {"content-type"=>["application/json; charset=utf-8"]})
+
+      json_response = File.read(File.dirname(__FILE__) + "/../../support/json_responses/0_movie_search_result.json")
+      stub_request(:get, /api\.rottentomatoes\.com\/api\/public\/v1\.0\/movies\.json\?apikey=.*&page_limit=4&q=amoviethatdoesnotexist/).to_return(:status => 200, :body => json_response,:headers => {"content-type"=>["application/json; charset=utf-8"]})
+    end
+
+    let(:searcher) { WorthWatching::RottenTomatoes::Searcher.new("rt_api_key") }
+    
+    context "when results exist for the given query string" do
+      let(:results) { searcher.search_by_title("finding nemo", 4) }
+
+      describe "the search results" do
+        it "is an array of movies" do
+          expect(results).to be_an_instance_of(Array)
+        end
+
+        it "has the title of the movie result" do
+          expect(results.first[:title]).to eq("Finding Nemo")
+        end
+
+        it "has the Rotten Tomatoes ID of the movie result" do
+          expect(results.first[:rt_id]).to eq("9377")
+        end
+
+        it "has the release year of the movie result" do
+          expect(results.first[:year]).to eq("2003")
+        end
+      end
+    end
+
+    context "when results do not exist for the given query string" do
+      describe "the search results" do
+        it "returns false" do
+          results = searcher.search_by_title("amoviethatdoesnotexist", 4)
+          expect(results).to be_false
+        end
+      end
+    end
+  end
+end

data/spec/unit/tmdb/poster_fetcher_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+describe "WorthWatching::TMDB::PosterFetcher" do
+  before do
+    json_response = File.read(File.dirname(__FILE__) + "/../../support/json_responses/toy_story_tmdb.json")
+    stub_request(:get, /api\.themoviedb\.org\/3\/movie\/tt0435761\?api_key\=.*/).to_return(:status => 200, :body => json_response,:headers => {"content-type"=>["application/json; charset=utf-8"]})
+  end
+
+  let(:movie_imdb_id) { "0435761" }
+  let(:poster_fetcher) { WorthWatching::TMDB::PosterFetcher.new("tmdb_api_key") }
+  it "retrieves a URL of the movie's poster" do
+    poster_url = poster_fetcher.fetch(movie_imdb_id)
+    expect(poster_url).to eq("http://cf2.imgobject.com/t/p/original/tOwAAVeL1p3ls9dhOBo45ElodU3.jpg")
+  end
+end

data/spec/unit/written_review_spec.rb

@@ -1,45 +1,22 @@
-require 'test_helper'
+require 'spec_helper'
 
 describe "WorthWatching::WrittenReview" do
-  let (:review) {WorthWatching::WrittenReview.new( {"critic"=>"Joshua Rothkopf", "date"=>"2014-03-27", "original_score"=>"4/5", "freshness"=>"fresh", "publication"=>"Time Out New York", "quote"=>"The Marvel faithful will turn up for the action scenes, and the directors, brothers Anthony and Joe Russo, add an uncommon sharpness to sequences of urban warfare -- these Heat-grade bullet volleys have a real ping to them.", "links"=>{"review"=>"http://www.timeout.com/us/film/captain-america-the-winter-soldier"}})}
+  let (:review) do
+    WorthWatching::WrittenReview.new(
+      "Joshua Rothkopf",
+      Date.parse("2014-03-27"),
+      "fresh",
+      "Time Out New York",
+      "The Marvel faithful will turn up for the action scenes, and the directors, brothers Anthony and Joe Russo, add an uncommon sharpness to sequences of urban warfare -- these Heat-grade bullet volleys have a real ping to them.",
+      "http://www.timeout.com/us/film/captain-america-the-winter-soldier",
+      "4/5"
+      )
+  end
 
   it "has a valid constructor" do
     expect(review).to be_an_instance_of(WorthWatching::WrittenReview)
   end
 
-  it "has an author" do
-    expect(review.author).to eq("Joshua Rothkopf")
-  end
-
-  it "has a date" do
-    expect(review.date).to eq(Date.parse("2014-03-27"))
-  end
-
-  it "has a rating" do
-    expect(review.rating).to eq("fresh")
-  end
-
-  it "has the original score" do
-    expect(review.original_score).to eq("4/5")
-
-  end
-
-  it "has a source" do
-    expect(review.source).to eq("Time Out New York")
-  end
-
-  it "has a quote" do
-    expect(review.quote).to eq("The Marvel faithful will turn up for the action scenes, and the directors, brothers Anthony and Joe Russo, add an uncommon sharpness to sequences of urban warfare -- these Heat-grade bullet volleys have a real ping to them.")
-  end
-
-  it "has a link" do
-    expect(review.link).to eq("http://www.timeout.com/us/film/captain-america-the-winter-soldier")
-  end
-
-  it "returns a formatted string representing the review" do
-    expect(review.to_s).to eq("Joshua Rothkopf wrote on 2014-03-27 : The Marvel faithful will turn up for the action scenes, and the directors, brothers Anthony and Joe Russo, add an uncommon sharpness to sequences of urban warfare -- these Heat-grade bullet volleys have a real ping to them.\nRating: 4/5")
-  end
-
   it "can be converted back to a hash" do
     expect(review.to_hash).to eq({ author: "Joshua Rothkopf",
                                    date: Date.parse("2014-03-27"),
@@ -49,4 +26,8 @@ describe "WorthWatching::WrittenReview" do
                                    link: "http://www.timeout.com/us/film/captain-america-the-winter-soldier",
                                    original_score: "4/5"})
   end
+
+  it "returns a formatted string representing the review" do
+    expect(review.to_s).to eq("Joshua Rothkopf wrote on 2014-03-27 : The Marvel faithful will turn up for the action scenes, and the directors, brothers Anthony and Joe Russo, add an uncommon sharpness to sequences of urban warfare -- these Heat-grade bullet volleys have a real ping to them.\nRating: 4/5")
+  end
 end