hulu-show 0.1.0 → 0.2.0

data/README.md

@@ -0,0 +1,51 @@
+# hulu-show
+
+Hulu::Show fetches all episodes for the current season of a specified show.
+
+## Show attributes:
+
+    :network,
+    :title,
+    :genre,
+    :description,
+    :errors,
+    :episodes,
+    :url
+
+## Episode attributes:
+
+    :title,
+    :episode,
+    :running_time,
+    :air_date,
+    :season,
+    :url,
+    :beaconid,
+    :thumbnail_url,
+    :embed_html
+
+## Usage
+
+`gem install hulu-show`
+
+`require 'hulu/show'`
+
+`burn_notice = Hulu::Show.new('Burn Notice')`
+
+    #<Hulu::Show:0x007f972a04f740 @title="Burn Notice", @episodes=[#<Hulu::Episode:0x007f972a02c7b8 @episode="13", @title="Damned If You Do", @url="http://www.hulu.com/watch/296648/burn-notice-damned-if-you-do?c=Action-and-Adventure#x-4,cEpisodes,1,0", @beaconid="296648", @running_time="43:09", @air_date="11/03/2011", @embed_html="<object width=\"512\" height=\"296\"><param name=\"movie\" value=\"http://www.hulu.com/embed/c96sZQru3w567PP7t3cGZQ\"></param><param name=\"flashvars\" value=\"ap=1\"></param><embed src=\"http://www.hulu.com/embed/c96sZQru3w567PP7t3cGZQ\" type=\"application/x-shockwave-flash\" width=\"512\" height=\"296\" flashvars=\"ap=1\"></embed></object>", @thumbnail_url="http://thumbnails.hulu.com/8/60000008/60000008_145x80_generated.jpg">], @doc=nil, @errors=[], @network="USA", @genre="Action and Adventure", @description="A \"burned\" spy returns to Miami where he uses his special ops training to help those in need, and bring justice against the men who wrongly burned him.", @url="http://www.hulu.com/burn-notice">
+
+## Retrieve show episodes
+
+`burn_notice.episodes`
+
+    [#<Hulu::Episode:0x007f961a02be00 @episode="13", @title="Damned If You Do", @url="http://www.hulu.com/watch/296648/burn-notice-damned-if-you-do?c=Action-and-Adventure#x-4,cEpisodes,1,0", @beaconid="296648", @running_time="43:09", @air_date="11/03/2011", @embed_html="<object width=\"512\" height=\"296\"><param name=\"movie\" value=\"http://www.hulu.com/embed/c96sZQru3w567PP7t3cGZQ\"></param><param name=\"flashvars\" value=\"ap=1\"></param><embed src=\"http://www.hulu.com/embed/c96sZQru3w567PP7t3cGZQ\" type=\"application/x-shockwave-flash\" width=\"512\" height=\"296\" flashvars=\"ap=1\"></embed></object>", @thumbnail_url="http://thumbnails.hulu.com/8/60000008/60000008_145x80_generated.jpg">]
+
+
+## Retrieve multiple shows with their episodes at one time.
+
+`Hulu.shows(['Burn Notice', 'Warehouse 13'])`
+
+
+Copyright (c) 2011 Craig Williams. See LICENSE.txt for
+further details.
+

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.2.0

data/hulu-show.gemspec

@@ -5,16 +5,16 @@
 
 Gem::Specification.new do |s|
   s.name = "hulu-show"
-  s.version = "0.1.0"
+  s.version = "0.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Craig Williams"]
-  s.date = "2011-11-25"
+  s.date = "2011-11-27"
   s.description = "Really, that is about it. For each show, Hulu::Show will return an array of Episode objects with details about the episode."
   s.email = "cwilliams.allancraig@gmail.com"
   s.extra_rdoc_files = [
     "LICENSE.txt",
-    "README.rdoc"
+    "README.md"
   ]
   s.files = [
     ".document",
@@ -23,7 +23,7 @@ Gem::Specification.new do |s|
     "Gemfile",
     "Gemfile.lock",
     "LICENSE.txt",
-    "README.rdoc",
+    "README.md",
     "Rakefile",
     "VERSION",
     "hulu-show.gemspec",
@@ -31,9 +31,14 @@ Gem::Specification.new do |s|
     "lib/hulu/show.rb",
     "lib/hulu/show/base.rb",
     "lib/hulu/show/episode.rb",
+    "notes.txt",
+    "spec/hulu/base_spec.rb",
+    "spec/hulu/episode_spec.rb",
     "spec/hulu/show_spec.rb",
     "spec/spec_helper.rb",
-    "spec/support/vcr_cassettes/burn_notice.yml"
+    "spec/support/vcr_cassettes/additional_attributes.yml",
+    "spec/support/vcr_cassettes/burn_notice.yml",
+    "spec/support/vcr_cassettes/non_existent_show.yml"
   ]
   s.homepage = "http://github.com/CraigWilliams/hulu-show"
   s.licenses = ["BSD"]

data/lib/hulu/show.rb

@@ -1,21 +1,53 @@
+# encoding: utf-8
+
 require 'hulu/show/base'
 require 'hulu/show/episode'
 
 class Hulu::Show < Hulu::Base
-  attr_accessor :name
+  attr_accessor :network,
+    :title,
+    :genre,
+    :description,
+    :errors,
+    :episodes,
+    :url
 
-  def initialize(name)
-    @name = name
+  def initialize(title)
+    @title    = title
     @episodes = []
+    @doc      = Hulu.query(@title)
+    @errors   = []
+
+    if error_404
+      @errors << "404: Show not found" 
+      return
+    end
+
+    parse_show_details
+    parse_episodes
+    set_url
+
+    @doc = nil
+  end
+
+  def set_url
+    @url = "#{Hulu::BASE_URI}/#{Hulu::Base.prepare_name(@title)}"
+  end
+
+  def error_404
+    error = @doc.css('.fixed-lg .section .gr').text.strip
+    error =~ /404/ ? true : false
   end
 
-  def episodes
-    doc = Hulu.query(self.name)
-    parse_episodes(doc)
+  def parse_show_details
+    details      = @doc.css(".fixed-lg.container .section.details .relative .info")
+    @network     = details[0].text.strip
+    @genre       = details[2].text.split('|').first.gsub(/\302\240/, ' ').strip
+    @description = details[3].text.strip
   end
 
-  def parse_episodes(doc)
-    episodes = doc.css("#show-expander table")
+  def parse_episodes
+    episodes = @doc.css("#show-expander table")
 
     episodes.each_with_index do |episode, i|
       # There are several tables under the show-expander
@@ -27,7 +59,6 @@ class Hulu::Show < Hulu::Base
         end
       end
     end
-    @episodes
   end
 
 end

data/lib/hulu/show/base.rb

@@ -29,4 +29,12 @@ module Hulu
     show_name = Hulu::Base.prepare_name(show_name)
     Hulu::Fetcher::Page.get("#{BASE_URI}/#{show_name}")
   end
+
+  def self.shows(titles)
+    shows = []
+    titles.each do |title|
+      shows << Hulu::Show.new(title)
+    end
+    shows
+  end
 end

data/lib/hulu/show/episode.rb

@@ -3,15 +3,29 @@ class Hulu::Episode < Hulu::Base
     :episode,
     :running_time,
     :air_date,
-    :season
-    
+    :season,
+    :url,
+    :beaconid,
+    :thumbnail_url,
+    :embed_html
+
   def initialize
     yield self if block_given?
+
+    set_additional_attributes
+  end
+
+  def set_additional_attributes
+    info = additional_attributes
+    @embed_html    = info['html']
+    @thumbnail_url = info['thumbnail_url']
   end
 
   def process(episode)
-    @episode = episode.css('td.c0').text.strip
-    @title   = episode.css('td.c1 a').text.strip
+    @episode   = episode.css('td.c0').text.strip rescue ''
+    @title     = episode.css('td.c1 a').text.strip rescue ''
+    @url       = episode.css('td.c1 a').attr('href').text.strip rescue ''
+    @beaconid = episode.css('td.c1 a').attr('beaconid').text.strip rescue ''
     parse_running_time(episode)
   end
 
@@ -20,11 +34,16 @@ class Hulu::Episode < Hulu::Base
 
     if run_time.include?(':')
       @running_time = run_time
-      @air_date     = episode.css('td.c4').text.strip
+      @air_date     = episode.css('td.c4').text.strip rescue ''
     else
-      @running_time = episode.css('td.c4').text.strip
-      @air_date     = episode.css('td.c5').text.strip
+      @running_time = episode.css('td.c4').text.strip rescue ''
+      @air_date     = episode.css('td.c5').text.strip rescue ''
     end
   end
 
+  def additional_attributes
+    url = "http://www.hulu.com/api/oembed.json?url=http://www.hulu.com/watch/#{@beaconid}/#{Hulu::Base.prepare_name(@title)}"
+    Hulu::Fetcher::Page.get(url).parsed_response
+  end
+
 end

data/notes.txt

@@ -0,0 +1,25 @@
+#==============================================================
+# Fetching more data about a show
+#==============================================================
+# http://www.hulu.com/api/oembed.json?url=http://www.hulu.com/watch/20807/late-night-with-conan-obrien-wed-may-21-2008
+# http://www.hulu.com/api/oembed.json?url=http://www.hulu.com/watch/261293/burn-notice-mind-games
+
+{
+    "thumbnail_width": 145,
+    "type": "video",
+    "title": "Shadows (Warehouse 13)",
+    "embed_url": "http://www.hulu.com/embed/Gp_eWf7PQr697Ol0j7OfEg",
+    "thumbnail_height": 80,
+    "height": 296,
+    "provider_name": "Hulu",
+    "width": 512,
+    "html": "<object width=\"512\" height=\"296\"><param name=\"movie\" value=\"http://www.hulu.com/embed/Gp_eWf7PQr697Ol0j7OfEg\"></param><param name=\"flashvars\" value=\"ap=1\"></param><embed src=\"http://www.hulu.com/embed/Gp_eWf7PQr697Ol0j7OfEg\" type=\"application/x-shockwave-flash\" width=\"512\" height=\"296\" flashvars=\"ap=1\"></embed></object>",
+    "provider_url": "http://www.hulu.com/",
+    "duration": 2584.25,
+    "version": "1.0",
+    "cache_age": 3600,
+    "air_date": "Mon Sep 12 00:00:00 UTC 2011",
+    "thumbnail_url": "http://thumbnails.hulu.com/188/40038188/40038188_145x80_generated.jpg",
+    "author_name": "Syfy"
+}
+

data/spec/hulu/base_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+describe Hulu do
+  
+  it "returns an array of shows" do
+    titles = ['Burn Notice', 'Warehouse 13', 'Terra Nova']
+    shows = Hulu.shows(titles)
+
+    shows.count.should == 3
+    # shows.first.episodes.first.title.should == 'What'
+  end
+
+end

data/spec/hulu/episode_spec.rb

@@ -0,0 +1,18 @@
+require 'spec_helper'
+
+describe Hulu::Episode do
+
+    before { VCR.insert_cassette('additional_attributes') }
+    after { VCR.eject_cassette }
+  
+    it "episode can fetch additional attributes" do
+      episode = Hulu::Episode.new do |episode|
+        episode.beaconid = '296648'
+        episode.title = 'Damned If You Do'
+        episode.additional_attributes
+      end
+
+      episode.thumbnail_url.should == "http://thumbnails.hulu.com/8/60000008/60000008_145x80_generated.jpg"
+      episode.embed_html.should_not be_nil
+    end
+end

data/spec/hulu/show_spec.rb

@@ -1,37 +1,93 @@
+# encoding: utf-8
+
+require 'json'
+
 require 'spec_helper'
 
 describe Hulu::Show do
-  let(:burn_notice_erb) { 
-    {
-      title: 'Burn baby burn', 
-      running_time: '43:09',
-      air_date: '11/03/2011',
-      episode: '13' 
+
+  context "When show is found" do
+    let(:burn_notice_erb) { 
+      {
+        title: 'Burn baby burn', 
+        running_time: '43:09',
+        air_date: '11/03/2011',
+        episode: '13',
+        network: 'USA',
+        genre: '<b><a href=\"http://www.hulu.com/genres/Action-and-Adventure\"
+        class=\"show-title\">Action and Adventure</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href=\"http://www.hulu.com/genres/Drama\"
+        class=\"show-title\">Drama</a></b>',
+        description: "A &quot;burned&quot; spy returns to Miami where he uses his special ops training to help those in need, and bring justice against the men who wrongly burned him."
+      }
     }
-  }
 
-  it "should know it's name" do
-    Hulu::Show.new('Bones').name.should == 'Bones'
-  end
+    let(:additional_attributes) { 
+      {
+          "thumbnail_width" => 145,
+          "type" => "video",
+          "title" => "Shadows (Warehouse 13)",
+          "embed_url" =>  "http://www.hulu.com/embed/Gp_eWf7PQr697Ol0j7OfEg",
+          "thumbnail_height" => 80,
+          "height" =>  296,
+          "provider_name" => "Hulu",
+          "width" => 512,
+          "html" => "<object width=\"512\" height=\"296\"><param name=\"movie\" value=\"http://www.hulu.com/embed/Gp_eWf7PQr697Ol0j7OfEg\"></param><param name=\"flashvars\" value=\"ap=1\"></param><embed src=\"http://www.hulu.com/embed/Gp_eWf7PQr697Ol0j7OfEg\" type=\"application/x-shockwave-flash\" width=\"512\" height=\"296\" flashvars=\"ap=1\"></embed></object>",
+          "provider_url" => "http://www.hulu.com/",
+          "duration" => 2584.25,
+          "version" => "1.0",
+          "cache_age" => 3600,
+          "air_date" => "Mon Sep 12 00:00:00 UTC 2011",
+          "thumbnail_url" => "http://thumbnails.hulu.com/188/40038188/40038188_145x80_generated.jpg",
+          "author_name" => "Syfy"
+      }
+    }
+
+    before do
+      Hulu::Episode.any_instance.stub(:additional_attributes).and_return(additional_attributes)
+      VCR.insert_cassette('burn_notice', erb: burn_notice_erb)
+    end
+
+    after { VCR.eject_cassette }
+
+    it "show attributes should be set" do
+      show = Hulu::Show.new('Burn Notice')
+      show.title.should == 'Burn Notice'
+      show.network.should == 'USA'
+      show.genre.should == 'Action and Adventure'
+      show.description.should == "A \"burned\" spy returns to Miami where he uses his special ops training to help those in need, and bring justice against the men who wrongly burned him."
+      show.url == "http://www.hulu.com/burn-notice"
+    end
 
-  it "created episodes with correct attributes" do
-    VCR.use_cassette('burn_notice', erb: burn_notice_erb) do
+    it "episodes return correct attributes" do
       episodes = Hulu::Show.new('Burn Notice').episodes
       episode = episodes.first
 
-      episode.title.should == 'Burn baby burn'
+      episode.title.should        == 'Burn baby burn'
       episode.running_time.should == '43:09'
-      episode.air_date.should == '11/03/2011'
-      episode.episode.should == '13'
+      episode.air_date.should     == '11/03/2011'
+      episode.episode.should      == '13'
+      episode.url                 == "http://www.hulu.com/watch/296648/burn-notice-damned-if-you-do#x-4,cEpisodes,1,0"
+      episode.beaconid            == '296648'
+
+      # additional_attributes
+      episode.thumbnail_url.should == "http://thumbnails.hulu.com/188/40038188/40038188_145x80_generated.jpg"
     end
-  end
 
-  it "has the correct number of episodes" do
-    VCR.use_cassette('burn_notice', erb: burn_notice_erb) do
+    it "has the correct number of episodes" do
       episodes = Hulu::Show.new('Burn Notice').episodes
-
       episodes.count.should == 1
     end
+
+  end
+
+  context "When show not found" do
+    before { VCR.insert_cassette('non_existent_show') }
+    after { VCR.eject_cassette }
+
+    it "contains an error when show not found" do
+      show = Hulu::Show.new("Non-existent show")
+      show.errors.should include("404: Show not found")
+    end
   end
 
 end

data/spec/spec_helper.rb

@@ -11,8 +11,9 @@ Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
 VCR.config do |c|
   c.cassette_library_dir = 'spec/support/vcr_cassettes'
   c.stub_with :fakeweb
+  c.allow_http_connections_when_no_cassette = true
 end
 
 RSpec.configure do |config|
   config.extend VCR::RSpec::Macros
-end
+end

data/spec/support/vcr_cassettes/additional_attributes.yml

@@ -0,0 +1,33 @@
+---
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :get
+    uri: http://www.hulu.com:80/api/oembed.json?url=http://www.hulu.com/watch/296648/damned-if-you-do
+    body: 
+    headers: 
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 200
+      message: OK
+    headers:
+      server:
+      - nginx
+      content-type:
+      - application/json; charset=utf-8
+      status:
+      - 200 OK
+      x-ua-compatible:
+      - IE=EmulateIE9; IE=EmulateIE7
+      content-length:
+      - '803'
+      cache-control:
+      - max-age=3544
+      date:
+      - Sat, 26 Nov 2011 23:08:44 GMT
+    body: ! '{"author_name":"USA","type":"video","thumbnail_width":145,"thumbnail_height":80,"title":"Damned
+      If You Do (Burn Notice)","width":512,"provider_name":"Hulu","embed_url":"http://www.hulu.com/embed/c96sZQru3w567PP7t3cGZQ","version":"1.0","duration":2589.67,"height":296,"provider_url":"http://www.hulu.com/","air_date":"Thu
+      Nov 03 00:00:00 UTC 2011","html":"<object width=\"512\" height=\"296\"><param
+      name=\"movie\" value=\"http://www.hulu.com/embed/c96sZQru3w567PP7t3cGZQ\"></param><param
+      name=\"flashvars\" value=\"ap=1\"></param><embed src=\"http://www.hulu.com/embed/c96sZQru3w567PP7t3cGZQ\"
+      type=\"application/x-shockwave-flash\" width=\"512\" height=\"296\" flashvars=\"ap=1\"></embed></object>","cache_age":3600,"thumbnail_url":"http://thumbnails.hulu.com/8/60000008/60000008_145x80_generated.jpg"}'
+    http_version: '1.1'