tvdbr 0.0.1

data/.gitignore

@@ -0,0 +1,3 @@
+pkg/*
+*.gem
+.bundle

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in tvdbr.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,27 @@
+PATH
+  remote: .
+  specs:
+    tvdbr (0.0.1)
+      activesupport
+      hashie
+      httparty
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (3.0.3)
+    crack (0.1.8)
+    hashie (0.4.0)
+    httparty (0.6.1)
+      crack (= 0.1.8)
+    rake (0.8.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport
+  hashie
+  httparty
+  rake
+  tvdbr!

data/README

@@ -0,0 +1,70 @@
+# 1. Associate our media with tvdb
+# 2. Iterate through and search episodes (backfill missing episodes, backfill better screenshots)
+# 3. Update rake task, daily => get all the updates, reference the changes => propogate to our data (new episodes, new shows)
+
+# rake tvdb:populate => associate media to tvdb and backfill missing episodes and show info
+
+  Media.tvdb_id_is_null.find_each do |media|
+    tvdb_match = tvdb.fetch_series_from_data(:title => media.title, :starring => media.starring)
+    # Update media info and/or associate media to tvdb (ref_id) and change source
+    media.update_attributes(:source => "Tvdb", :tvdb_id => tvdb_match.id)
+    tvdb_match.episodes.each do |tvdb_episode|
+      episode = media.episodes.where(:episode => tvdb_episode.episode_num, :season => tvdb_episode.season_num)
+      # Update or create episode from the information from tvdb
+    end
+  end
+
+# rake tvdb:daily    => update database to sync with new shows and episodes on a daily task (attach existing show)
+
+  tvdb.each_updated_series(:since => 1.day.ago) do |tvdb_series|
+    puts "#{series.id} - #{series.title}"
+    media = Media.where(:ref_id => tvdb_series.id).first
+    # Update information from the new data?
+  end
+
+  tvdb.each_updated_episode(:since => 1.day.ago) do |tvdb_episode|
+    media = Media.where(:ref_id => tvdb_series.seriesid).first
+    episode = Episode.where(:season => tvdb_episode.season_num, :episode => tvdb_episode.episode_num).first
+    # Update or create episode information based on the new data.
+  end
+
+== Initial Database Processing
+
+- Get the current server time
+  a. Retrieve http://www.thetvdb.com/api/Updates.php?type=none. (Time.now.to_i) [1295299577]
+  b. Store this value for later use (denoted as <previoustime> for rest of example).
+
+- Loop through and look up each series id
+  a. Retrieve http://www.thetvdb.com/api/GetSeries.php?seriesname=<series name from your database>
+  b. Optionally present results to user so they can select the match they want.
+  c. Store this series id in a table in your database.
+
+- Get base information for each series
+  a. Retrieve <mirrorpath_zip>/api/<apikey>/series/<seriesid>/all/<language>.zip and extract <language>.xml and banners.xml.
+  b. Process the XML data in <language>.xml and store all <Series> data.
+  c. Download each series banner in banners.xml and prompt the user to see which they want to keep.
+  Note: Make sure you record <id> from each series, since it's returned in updates as <Series>.
+
+- Get base information for each episode
+  a. Use <language>.xml from step 3 to find and store the data associated with your episode.
+  b. Use <filename> from results in step above to download the episode image from <mirrorpath_banners>/banners/<filename>.
+  Note: Make sure you record <id> from each episode, since it's returned in updates as <Episode>.
+
+== Future Database Processing
+
+These steps are used to keep your database current with the latest information.
+
+- Get a list of all series and episode updates
+  a. Retrieve http://www.thetvdb.com/api/Updates.php?type=all&time=<previoustime>.
+  b. Process the returned XML and loop through each series (<seriesid>) and episode (<episodeid>) entry.
+
+- Update each series in the update XML
+  a. Retrieve <mirrorpath_xml>/api/<apikey>/series/<seriesid>/<language>.xml.
+  b. Process XML data and use to replace information in local database.
+
+- Update each episode in the update XML
+  a. Retrieve <mirrorpath_xml>/api/<apikey>/episodes/<episodeid>/<language>.xml.
+  b. Process XML data and use to replace information in local database.
+
+- Record <previoustime> for next update
+  a. Using the XML from step 2, store <Time> as <previoustime> and use for your next call to Updates.php.

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/examples/demo.rb

@@ -0,0 +1,41 @@
+require 'rubygems'
+require 'tvdbr'
+
+tvdb = Tvdbr::Client.new('YOUR_API_KEY')
+
+# Fetch series based on title and starring
+series_wrong = tvdb.fetch_series_from_data(:title => "Dexter",
+  :starring => "Adewale Akinnuoye-Agbaje, Sam Anderson, Naveen Andrews, L. Scott Caldwell, Nestor Carbonell, François Chau, Henry Ian Cusick, Jeremy Davies, Emilie de Ravin, Michael Emerson, Jeff Fahey, Fionnula Flanagan, Matthew Fox, Jorge Garcia, Maggie Grace, Josh Holloway, Malcolm David Kelley, Daniel Dae Kim, Yunjin Kim, Ken Leung, Evangeline Lilly, Rebecca Mader, Elizabeth Mitchell, Dominic Monaghan, Terry O'Quinn, Harold Perrineau, Zuleikha Robinson, Michelle Rodriguez, Kiele Sanchez,Rodrigo Santoro, Ian Somerhalder, John Terry, Sonya Walger, Cynthia Watros")
+puts "Wrong Match: #{series_wrong.inspect}"
+
+# Fetch series based on title and starring
+series_right = tvdb.fetch_series_from_data(:title => "Lost",
+  :starring => "Adewale Akinnuoye-Agbaje, Sam Anderson, Naveen Andrews, L. Scott Caldwell, Nestor Carbonell, François Chau, Henry Ian Cusick, Jeremy Davies, Emilie de Ravin, Michael Emerson, Jeff Fahey, Fionnula Flanagan, Matthew Fox, Jorge Garcia, Maggie Grace, Josh Holloway, Malcolm David Kelley, Daniel Dae Kim, Yunjin Kim, Ken Leung, Evangeline Lilly, Rebecca Mader, Elizabeth Mitchell, Dominic Monaghan, Terry O'Quinn, Harold Perrineau, Zuleikha Robinson, Michelle Rodriguez, Kiele Sanchez,Rodrigo Santoro, Ian Somerhalder, John Terry, Sonya Walger, Cynthia Watros")
+puts "Right Match: #{series_right.inspect}"
+
+puts "\n\n"
+series = series_right
+puts series.title + " (" + series.categories.join(", ") + ")"
+puts series.synopsis
+puts series.starring.join(", ")
+puts series.poster
+puts series.release_date.inspect
+
+# Fetch episodes for a series
+puts "\nEpisodes:\n\n"
+series.episodes.each do |e|
+ puts e.name + " (S#{e.season_num}E#{e.episode_num})"
+end
+
+#  # Fetch series updates since given timestamp
+#  results = tvdb.find_updates_since(2.hours.ago)
+#  puts "\n\nUpdated series since 2 hours ago: #{results[:series].size} series\n\n"
+#  tvdb.each_updated_series(:since => 2.hours.ago) do |series|
+#    puts "#{series.id} - #{series.title}"
+#  end
+#
+#  # Fetch episode udpates since given timestamp
+#  puts "Updated episodes since 2 hours ago: #{results[:episodes].size} episodes\n\n"
+#  tvdb.each_updated_episode(:since => 2.hours.ago) do |episode|
+#    puts "#{episode.id} - #{episode.name} - #{episode.seriesid}"
+#  end

data/lib/tvdbr/client.rb

@@ -0,0 +1,123 @@
+require 'httparty' unless defined?(HTTParty)
+
+module Tvdbr
+  class Client
+    include HTTParty
+    format :xml
+    base_uri "http://www.thetvdb.com/api/"
+
+    # Creates an instance of the TVDB interface
+    # Tvdb.new('some_key')
+    def initialize(api_key)
+      @api_key = api_key
+      check_api_key!
+    end
+
+    # Fetches a series object based on the given attributes hash
+    # tvdb.fetch_series_from_data(:title => "Dexter", :kind => "TvShow", :starring => "xxxx, xxxx")
+    # => { "SeriesName" => "Dexter", ... } or nil
+    #
+    def fetch_series_from_data(options={})
+      return self.find_series_by_title(options[:title]) if options[:starring].nil?
+      series_results = self.find_all_series_by_title(options[:title])
+      expected_actors = options[:starring].split(",")
+      series_results.find { |series| series.actor_match?(expected_actors) }
+    end
+
+    # Yields the block for every updated series
+    # tvdb.each_updated_series(:since => 1.day.ago) { |s| Media.find_by_tvdb_id(s.id).title = s.title }
+    def each_updated_series(options={}, &block)
+      updates = self.find_updates_since(options[:since])
+      updates[:series].each do |series_id|
+        series = Series.new(self, self.find_series_by_id(series_id))
+        block.call(series)
+      end
+    end
+
+    # Yields the block for every updated episode
+    # tvdb.each_updated_episode(:since => 1.day.ago) { |s| Episode.find_by_tvdb_id(s.id).title = s.title }
+    def each_updated_episode(options={}, &block)
+      updates = self.find_updates_since(options[:since])
+      updates[:episodes].each do |episode_id|
+        episode = Episode.new(self, self.find_episode_by_id(episode_id))
+        block.call(episode)
+      end
+    end
+
+    # Returns all series matching the given title
+    # tvdb.find_all_series_by_title("Dexter")
+    # => [{ "SeriesName" => "Dexter", ... }, ...]
+    def find_all_series_by_title(title)
+      result = self.class.get("/GetSeries.php", :query => { :seriesname => title, :language => "en" })['Data']
+      return [] if result.blank? || result['Series'].blank?
+      result = result['Series'].is_a?(Array) ? result['Series'] : [result['Series']]
+      result.first(5).map { |s| Series.new(self, self.find_series_by_id(s['seriesid'])) }
+    end
+
+    # Returns the first series returned for a title
+    # tvdb.find_series_by_title("Dexter")
+    # => { "SeriesName" => "Dexter", ... }
+    #
+    def find_series_by_title(title)
+      self.find_all_series_by_title(title).first
+    end
+
+    # Returns series data for a given series_id
+    # tvdb.find_series_by_id(1234, :all => true)
+    # tvdb.find_series_by_id(1234, :dataset => true)
+    # => { "SeriesName" => "Dexter", ... }
+    def find_series_by_id(series_id, options={})
+      series_url = "/series/#{series_id}"
+      series_url << "/all" if options[:all]
+      result = self.get_with_key(series_url)['Data']
+      return result if options[:all]
+      return Series.new(self, result["Series"]) if options[:dataset]
+      result["Series"]
+    end
+
+    # Returns Episode data for a given episode id
+    # tvdb.find_episode_by_id(12345)
+    # => { "EpisodeName" => "..." }
+    def find_episode_by_id(episode_id, options={})
+      episode_url = "/episodes/#{episode_id}"
+      result = self.get_with_key(episode_url)['Data']
+      return Episode.new(self, result["Episode"]) if options[:dataset]
+      result["Episode"]
+    end
+
+    # Returns the list of TVDB mirror_urls
+    # => ["http://thetvdb.com", ...]
+    def mirror_urls
+      Array(self.get_with_key('/mirrors.xml')['Mirrors']['Mirror']['mirrorpath'])
+    end
+
+    # Returns a list of series and episode updates since given time
+    # tvdb.find_updates_since(1.day.ago)
+    # => { :series  }
+    # {"Time"=>"1295300137", "Series"=>["70386", "70500", "70522", "70566", "70591", "70726", "70730", "70761", "70851", "70994", "71035", "71179", "71355",
+    #{ }"71383", "71394", "71470", "71489", "71493", "71635", "71649", "71663", "71753", "71788", "71991", "72023", "72073", "222571", "72158", "72164",
+    #{ }"72201", "72218", "72227", "72229", "72231", "72233", "72235", "72301", "72368", "72382", "72449", "72467", "72476", "72514", "72546", "153021", "72614", "72675", "72716", "72745", "82812", "72888", "72922", "72955", "72963", "80348", "73014", "73028", "73029", "73141", "222641", "73244", "73255", "207621", "73265", "73388", "73444", "73507", "73508", "73534", "73545", "73546", "73587", "73641", "73696", "73704", "73730", "73739", "83004", "73741", "73762", "73776", "73787", "73800", "73838", "73871", "73888", "73902", "73918", "73965", "74156", "74205", "74285", "74340", "74379", "164221", "74523", "74550", "74608", "74670", "74697", "74709", "74730", "74806", "74814", "74843", "74852", "74875", "74897", "74948", "74992", "219931", "75062", "75138", "75164", "75299", "75340", "75382", "75397", "75450", "75457", "75532", "75579", "75669", "75682", "75692", "75710", "124561", "75719", "75734", "75760", "75897", "75931", "75978", "82467", "76107", "76168", "76177", "76290", "180791", "76354", "76355", "76360", "76385", "163531", "76421", "76568", "76575", "76648", "76738", "76746", "76772", "76813", "76846", "76857", "76924", "77098", "77244", "77398", "77526", "77537", "77544", "77623", "219821", "77772", "77811", "126301", "77847", "77996", "78056", "222821", "78131", "78224", "85075", "78261", "78310", "78442", "78490", "78527", "78581", "78650", "78733", "78804", "84352", "78817", "78833", "78875", "78890", "78901", "209551", "78923", "78929", "78939", "78949", "79022", "79089", "79114", "79126", "80392", "163851", "79168", "79169", "79175", "72108", "79182", "109411", "79203", "79212", "79216", "107931", "79251", "79261", "79262", "82459", "79317", "79330", "82881", "79334", "79335", "79337", "79349", "79352", "79488", "79501", "79506", "79507", "79511", "79525", "79567", "79572", "79696", "79809", "79676", "80128", "222701", "79824", "79834", "79842", "85358", "79899", "79890", "79925", "80033", "80115", "80159", "80207", "80198", "80231", "80273", "80270", "80301", "80389", "80310", "80330", "80337", "80349", "80367", "80379", "80411", "80442", "80494", "102241", "80529", "80542", "80547", "80608", "80680", "80732", "80846", "80976", "80988", "80995", "81148", "81074", "81161", "222601", "81189", "93651", "81213", "81230", "81253", "221561", "221481", "81335", "81346", "81400", "81797", "81385", "81386", "81394", "222801", "222811", "222831", "81445", "81831", "81578", "95441", "81751", "81841", "81869", "81955", "81950", "82046", "85186", "82038", "82083", "82066", "82339", "82184", "82283", "82213", "82422", "82480", "82493", "82696", "82620", "82613", "138551", "82716", "82825", "103121", "83098", "83115", "83123", "83214", "83237", "83268", "83292", "83322", "83462", "83558", "83602", "83610", "83616", "83742", "109061", "83929", "84021", "84024", "84238", "84358", "84458", "84600", "84676", "84879", "84912", "84947", "85040", "85523", "85539", "222711", "222621", "222631", "222651", "222661", "88031", "91171", "91311", "94971", "92411", "93221", "93991", "213491", "94121", "94541", "94571", "94801", "94991", "95011", "95021", "95451", "95491", "95731", "95761", "97281", "97401", "97731", "98411", "100071", "164541", "101181", "102441", "109931", "112621", "113471", "114701", "114851", "114921", "116861", "117411", "118021", "118421", "222131", "119761", "120431", "123581", "124051", "127021", "127401", "128141", "128171", "129261", "131561", "132941", "133251", "133461", "133861", "134241", "134321", "134511", "136621", "163561", "163581", "137031", "138531", "140141", "142101", "142581", "142961", "145191", "145231", "145951", "146711", "146911", "148151", "149731", "154431", "158661", "158411", "159791", "160671", "161461", "161511", "163431", "163671", "164301", "164401", "164951", "164981", "183971", "165591", "165841", "165851", "166361", "166981", "168941", "171241", "174501", "172501", "173821", "174921", "175861", "176941", "178201", "180831", "181011", "182061", "182661", "188201", "186911", "187071", "190531", "220661", "219391", "192171", "192601", "193131", "194031", "194051", "194541", "199051", "194751", "195161", "195611", "196921", "197021", "197271", "200301", "201481", "201991", "203261", "203411", "206011", "207391", "207701", "208231", "208291", "209671", "211391", "212421", "212571", "213721", "214921", "216181", "217331", "217661", "217961", "218191", "218891", "218991", "219131", "219701", "219771", "220141", "220621", "220551", "220571", "221001", "221771", "221801", "222671", "222681", "222581", "222561", "222691", "222721", "222731", "222741", "222751", "222761", "222771", "222781", "222791"], "Episode"=>["3411341", "6112", "6113", "6114", "6115", "6116", "6117", "6118", "6119", "6120", "6121", "6122", "6123", "6124", "6125", "6126", "6127", "6128", "6131", "6132", "6133", "6134", "6135", "6136", "6137", "6138", "6139", "6140", "6141", "6142", "6143", "6144", "6145", "6146", "6147", "6148", "6149", "6150", "6151", "6152", "19486", "19487", "19488", "19489", "19490", "19491", "19492", "19493", "19494", "19495", "19496", "19497", "19498", "19499", "19500", "19501", "19502", "19503", "19504", "19505", "19506", "19507", "19508", "19509", "19510", "19511", "19512", "19513", "19514", "19515", "19516", "19517", "19518", "19519", "19520", "19521", "19522", "19523", "19524", "19525", "19526", "19527", "19528", "19529", "19530", "19531", "19532", "19533", "19534", "19535", "19536", "19537", "19538", "19539", "19540", "19541", "19542", "19543", "19544", "19545", "19546", "19547", "19548", "19549", "19550", "19551", "19552", "19553", "19554", "19555", "19556", "19557", "19558", "19559", "19560", "19561", "19562", "19563", "19564", "19565", "19566", "19567", "19568", "19569", "19570", "19571", "19572", "19573", "19574", "19575", "19576", "19577", "19578", "19579", "19580", "19581", "19582", "19583", "19584", "19585", "19586", "19587", "19588", "19589", "19590", "19591", "19592", "19593", "19594", "19595", "19596", "78538", "85905", "85906", "85907", "85908", "85909", "85910", "85911", "85912", "85913", "85914", "85916", "85917", "85918", "85919", "85920", "85921", "85922", "85923", "85924", "87055", "87056", "87057", "87058", "87059", "87060", "87061", "87062", "87063", "87064", "87065", "87066", "87067", "87068", "87069", "87070", "87071", "87072", "87073", "87074", "87075", "87076", "87077", "87078", "87081", "87082", "87083", "87084", "87085", "87086", "87087", "87088", "87089", "87090", "87091", "87092", "87093", "87094", "87095", "87096", "87097", "87098", "87099", "87100", "87101", "87102", "87103", "87104", "87130", "87132", "87133", "87134", "87135", "87136", "87137", "87138", "87139", "87140", "87141", "87142", "87143", "87144", "87145", "87146", "87147", "87148", "87150", "87151", "87152", "87153", "87154", "87155", "87156", "87157", "87158", "87159", "87160", "87161", "87162", "87163", "87164", "87165", "87167", "87168", "87169", "87170", "87172", "87173", "87175", "87176", "93515", "93516", "93517", "93518", "93519", "93520", "93521", "93522", "93523", "93524", "93525", "93526", "93527", "93528", "93529", "93530", "93531", "93532", "93533", "93534", "93535", "93536", "93537", "104003", "104004", "104005", "104099", "104100", "104101", "104102", "104103", "104104", "104105", "104106", "104107", "104108", "104109", "104111", "104112", "104113", "104114", "104115", "104116", "104117", "104118", "104119", "104120", "104121", "104122", "117690", "117691", "2275781", "131481", "131482", "131483", "131484", "131485", "131486", "131487", "131488", "131489", "131490", "131491", "131492", "131493", "131494", "131495", "131496", "147906", "147908", "151219", "159329", "159330", "165527", "165531", "165533", "165544", "165545", "165549", "165551", "165552", "165554", "165555", "165556", "165557", "165558", "165559", "165560", "165561", "165562", "165563", "165564", "165565", "175245", "175246", "175247", "175248", "175249", "175332", "175333", "175335", "175337", "175339", "175340", "200336", "200337", "200338", "200339", "200340", "200341", "200342", "383455", "383456", "3490541", "214197", "214198", "214200", "3088411", "214219", "789101", "228957", "228958", "228959", "228960", "228961", "228962", "228963", "228964", "228965", "228966", "228967", "228969", "228970", "228971", "228972", "228973", "228974", "228975", "228976", "228977", "228978", "228979", "228980", "228981", "228982", "228983", "228984", "228985", "228986", "228987", "228988", "228989", "228990", "228991", "228992", "228993", "228994", "228995", "228996", "228997", "228998", "228999", "229000", "229001", "229002", "229003", "229004", "229005", "229006", "229007", "229008", "229009", "229010", "229011", "229012", "229013", "229014", "229015", "229016", "229017", "229018", "229019", "229020", "229021", "229022", "229023", "229024", "229025", "229026", "229027", "229028", "229029", "229030", "229031", "229032", "229033", "229034", "229035", "229036", "229037", "229038", "229039", "229040", "229041", "229042", "229043", "229044", "229045", "229046", "229047", "229048", "229049", "229050", "229051", "229052", "229053", "229054", "229055", "229056", "229057", "229058", "229059", "229060", "229061", "229062", "2588861", "229065", "229066", "229067", "235252", "248787", "248788", "2226501", "277955", "277956", "277957", "277958", "277959", "277960", "277961", "277962", "277963", "277964", "277965", "285172", "285173", "285174", "285175", "297130", "297131", "297132", "297133", "297134", "2562291", "299427", "299428", "299429", "299430", "299431", "299432", "299433", "299600", "299602", "299603", "299604", "315500", "315501", "3406411", "304964", "304965", "304966", "304967", "304968", "324294", "315503", "315504", "315505", "315506", "315507", "315508", "315509", "315510", "2428991", "328515", "328516", "328517", "328518", "328519", "328520", "328521", "328522", "328523", "328524", "328611", "328612", "328613", "328614", "328615", "328616", "328617", "328618", "328619", "328620", "328621", "328622", "328623", "328624", "328625", "329990", "329991", "329992", "329993", "333410", "333608", "333609", "1543481", "1543491", "1543501", "339789", "339791", "339792", "339805", "339814", "348267", "348268", "348270", "349232", "349233", "349235", "349236", "349238", "353644", "353645", "353646", "353647", "353648", "392706", "392707", "392708", "369273", "369857", "371998", "377868", "377869", "392140", "392139", "391671", "383603", "385744", "386664", "386673", "388126", "388260", "403429", "403430", "403431", "405995", "412351", "412482", "3489821", "3489801", "413385", "413386", "413387", "413388", "438912", "440482", "440483", "446898", "3489811", "450261", "450271", "450281", "450291", "450301", "450311", "450321", "466681", "480481", "480471", "480461", "480491", "480501", "529461", "529481", "529491", "529531", "529541", "529571", "529591", "529601", "529611", "582801", "582811", "582831", "582841", "3469021", "641491", "641501", "641511", "641521", "641531", "641541", "641551", "641561", "641571", "641581", "641591", "641601", "641611", "695171", "705231", "705261", "705271", "705281", "705301", "705311", "3489791", "738671", "3490561", "3489931", "3489941", "3489951", "797321", "863841", "863851", "2502511", "2502521", "2502531", "918261", "918271", "2420141", "960411", "970951", "3488721", "1007721", "1122641", "1046501", "1046511", "1046521", "1046811", "1056501", "1069101", "1073491", "1073501", "1073511", "1079401", "1079411", "1129781", "1129801", "1129811", "1129831", "1133991", "1147201", "1147211", "1147231", "1156901", "1163221", "1164561", "1164571", "1177551", "1229221", "1229231", "1265811", "1265821", "1280491", "3488781", "3488771", "3488751", "3488761", "3488741", "1347941", "1347961", "1347971", "1347981", "1348101", "1348111", "1348121", "1348131", "1348141", "1348151", "1348161", "1348191", "1348201", "1348211", "1370101", "1370111", "3107001", "1475281", "1475291", "1475301", "1475271", "1475241", "1475251", "1475261", "1475311", "1475321", "1880471", "1880481", "1531721", "1531731", "1531761", "1531771", "1531781", "1531791", "1531801", "1531811", "1531821", "1531831", "1558861", "2944761", "1582181", "1601751", "2468781", "2468771", "1776961", "2459641", "2459651", "2459661", "2459671", "1824261", "1824331", "1824351", "1880511", "2457931", "2457901", "2457911", "2457921", "2457891", "1928631", "1928641", "1928651", "1928661", "1945411", "2012221", "2012231", "2105931", "2184331", "2184341", "2184351", "2202411", "2211571", "2226481", "2226491", "2226511", "2226521", "2226531", "2226561", "2226571", "2226581", "2226591", "2226601", "2226611", "2237101", "2237111", "2240091", "2241791", "2278921", "2305441", "2305461", "2305471", "2305481", "2314931", "2452271", "2366081", "2588931", "2613201", "2669741", "2669751", "2669761", "2669771", "2669781", "2669791", "2669801", "2669811", "2681211", "2698111", "2698131", "2724061", "2738291", "2738301", "2738311", "2750571", "2756371", "2796281", "2831181", "2831191", "2831201", "2831211", "2831221", "2831231", "2831241", "2831291", "2845721", "2831791", "2845751", "2845761", "2845771", "2875941", "2875951", "2875961", "2875971", "2875981", "2875991", "2876001", "2876011", "2876021", "2876031", "2876041", "2876051", "2876061", "2876071", "2876081", "2876091", "2876101", "2876111", "2876121", "2876131", "2876141", "2876151", "2876161", "2876171", "2902281", "2902291", "2902301", "2902311", "2902321", "2902331", "2902341", "2903101", "2905171", "2922911", "3489781", "2925151", "2925161", "2925171", "2925181", "2925191", "2925201", "2925211", "2925221", "2925231", "2925241", "2925251", "2925261", "2925271", "2925281", "2925291", "2925301", "2925411", "2932181", "2932141", "2932151", "2932161", "2932171", "2932191", "2932201", "2932211", "2932221", "2932231", "2932241", "2932251", "2932261", "2932271", "2932281", "2932291", "2932301", "2932311", "2932321", "2932331", "2943401", "2943411", "2943421", "2943431", "2943441", "2943451", "2943461", "2943471", "2961101", "2961661", "2969781", "2992001", "2996021", "3011261", "3011271", "3012721", "3018351", "3030521", "3054391", "3061861", "3061871", "3485271", "3071831", "3071881", "3071891", "3071901", "3071911", "3073051", "3073821", "3073831", "3073841", "3073851", "3073871", "3086011", "3097861", "3489921", "3489901", "3105081", "3107271", "3107281", "3109321", "3109331", "3109341", "3109351", "3109361", "3110601", "3111451", "3112871", "3125421", "3125431", "3135911", "3140901", "3140911", "3148661", "3148671", "3149091", "3150521", "3155731", "3155741", "3155751", "3162261", "3192901", "3198471", "3201471", "3204501", "3213821", "3215561", "3234881", "3235071"]}
+    def find_updates_since(time)
+      @_updated_results ||= {}
+      stamp = time.to_i # Get timestamp
+      result = @_updated_results[stamp] ||= self.class.get("/Updates.php?type=all&time=#{stamp}")['Items']
+      { :series => result['Series'].map(&:to_i), :episodes => result['Episode'].map(&:to_i), :time => result['Time'] }
+    end
+
+    protected
+
+      # Returns the given xml as a hash appending the api_key to the url
+      # tvdb.get_with_key("/some/url", :query => { :foo => "bar" })
+      def get_with_key(*args)
+        args[0] = "/#{@api_key}/" + args[0]
+        self.class.get(*args)
+      end
+
+      # Checks if the api key works by retrieving mirrors
+      def check_api_key!
+        self.mirror_urls
+      rescue
+        raise "Please check your TVDB API Key!"
+      end
+  end
+end

data/lib/tvdbr/data_set.rb

@@ -0,0 +1,79 @@
+require 'Hashie' unless defined?(Hashie)
+
+module Tvdbr
+  class DataSet < Hashie::Mash
+    attr_reader :parent
+
+    ## INSTANCE METHODS ##
+
+    # Tvdb::DataSet.new(self, { :foo => "bar" })
+    def initialize(parent, *args)
+      @parent = parent
+      args[0] = normalize_keys(args[0]) if args[0].is_a?(Hash)
+      super(*args)
+    end
+
+    # Outputs: <#Tvdb::Series actors="..." added=nil added_by=nil>
+    def inspect
+      ret = "<##{self.class.to_s}"
+      self.keys.sort.each do |key|
+        ret << " #{key}=#{self[key].inspect}"
+      end
+      ret << ">"
+      ret
+    end
+
+    ## CLASS METHODS ##
+
+    # Aliases the original propery to the new method name
+    # alias_property :old, :new
+    def self.alias_property(original, name)
+      define_method(name) { self.send(original) }
+    end
+
+    # Turns a property "a | b | c" => ['a', 'b', 'c']
+    # listify :lista, :listb
+    def self.listify(*attrs)
+      attrs.each do |a|
+        define_method(a) { self[a] ? self[a][1..-1].split("|").map(&:strip) : []  }
+      end
+    end
+
+    # Turns a property into a date object
+    # dateify :release_date
+    def self.dateify(*attrs)
+      attrs.each do |a|
+        define_method(a) { Time.parse(self[a]) if self[a] }
+      end
+    end
+
+    # Turns a relative image link to a full tvdb link url
+    # absolutize :file_name
+    def self.absolutize(*attrs)
+      attrs.each do |a|
+        define_method(a) { File.join("http://www.thetvdb.com/banners/", self[a]) if self[a] }
+      end
+    end
+
+    private
+
+      # Translates all keys to lowercase and to a symbol
+      # => [:foo => "bar", ...]
+      def normalize_keys(hash)
+        hash.inject({}) do |options, (key, value)|
+          options[(underscore(key) rescue key) || key] = value
+          options
+        end
+      end
+
+      def underscore(camel_cased_word)
+        word = camel_cased_word.to_s.dup
+        word.gsub!(/::/, '/')
+        word.gsub!(/([A-Z]+)([A-Z][a-z])/,'\1_\2')
+        word.gsub!(/([a-z\d])([A-Z])/,'\1_\2')
+        word.tr!("-", "_")
+        word.downcase!
+        word
+      end
+  end
+end

data/lib/tvdbr/episode.rb

@@ -0,0 +1,17 @@
+module Tvdbr
+  # {:combined_episodenumber=>"14", :imdb_id=>nil, :episode_number=>"14", :absolute_number=>nil, :first_aired=>"2010-05-04",
+  #  :dvd_episodenumber=>nil, :episode_name=>"The Candidate", :rating=>"7.9", :filename=>"episodes/73739/1685171.jpg", :director=>"Jack Bender",
+  #  :seasonid=>"66871", :writer=>"|Elizabeth Sarnoff|Jim Galasso|", :dvd_chapter=>nil, :production_code=>nil, :combined_season=>"6", :season_number=>"6",
+  #  :dvd_season=>nil, :language=>"en", :dvd_discid=>nil, :lastupdated=>"1277153526",
+  #  :overview=>"...", :id=>"1685171", :ep_img_flag=>"2", :rating_count=>"187", :seriesid=>"73739", :guest_stars=>nil}
+  class Episode < DataSet
+    alias_property :episode_name, :name
+    alias_property :episode_number, :episode_num
+    alias_property :season_number, :season_num
+    alias_property :overview, :description
+    alias_property :first_aired, :original_air_date
+    dateify :first_aired
+    listify :writer
+    absolutize :filename
+  end
+end

data/lib/tvdbr/series.rb

@@ -0,0 +1,36 @@
+module Tvdbr
+  # { "ContentRating"=>"TV-MA", "Status"=>"Continuing", "Airs_Time"=>"9:00 PM", "FirstAired"=>"2006-10-01", "Runtime"=>"60",
+  #   "banner"=>"graphical/79349-g7.jpg", "poster"=>"posters/79349-2.jpg", "id"=>"79349", "Genre"=>"|Action and Adventure|Drama|",
+  #   "Network"=>"Showtime", "Overview"=>"...", "addedBy"=>nil, "lastupdated"=>"1295047217", "IMDB_ID"=>"tt0773262",
+  #   "Language"=>"en", "SeriesName"=>"Dexter", "Rating"=>"9.3", "fanart"=>"fanart/original/79349-16.jpg",
+  #   "Actors"=>"|Michael C. Hall|Julie Benz|", "Airs_DayOfWeek"=>"Sunday",
+  #   "zap2it_id"=>"SH859795", "RatingCount"=>"678", "SeriesID"=>"62683" }
+  class Series < DataSet
+    alias_property :series_name, :title
+    alias_property :overview, :synopsis
+    alias_property :actors, :starring
+    alias_property :genre, :categories
+    alias_property :first_aired, :release_date
+    listify :genre, :actors
+    dateify :first_aired
+    absolutize :fanart, :poster, :banner
+
+    def episodes
+      episode_data = self.parent.find_series_by_id(self.id, :all => true)
+      return [] unless episode_data && episode_data['Episode']
+      episode_data['Episode'].map { |e| Episode.new(self, e) if e && e.is_a?(Hash) }.compact
+    end
+
+    # Returns true if the series matches the given actors
+    # actors = ['x', 'y', 'z']
+    # series.actor_match?(actors) => true
+    def actor_match?(actors)
+      expected_actors   = actors.map      { |a| a.downcase.strip.gsub(/[\.\-\s\']/, '') }
+      normalized_actors = self.actors.map { |a| a.downcase.strip.gsub(/[\.\-\s\']/, '') }
+      # puts "1: #{self.inspect} - #{self.title} - #{normalized_actors.inspect} - #{expected_actors.inspect}"
+      # puts "2: " + (normalized_actors & expected_actors).inspect
+      normalized_actors.is_a?(Array) && expected_actors.is_a?(Array) &&
+      (normalized_actors & expected_actors).size > 1
+    end
+  end
+end

data/lib/tvdbr/version.rb

@@ -0,0 +1,3 @@
+module Tvdbr
+  VERSION = "0.0.1"
+end

data/lib/tvdbr.rb

@@ -0,0 +1,6 @@
+module Tvdbr
+  autoload :Client,    'tvdbr/client'
+  autoload :DataSet,   'tvdbr/data_set'
+  autoload :Series,    'tvdbr/series'
+  autoload :Episode,   'tvdbr/episode'
+end

data/tvdbr.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "tvdbr/version"
+
+Gem::Specification.new do |s|
+  s.name        = "tvdbr"
+  s.version     = Tvdbr::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Miso", "Nathan Esquenazi"]
+  s.email       = ["nesquena@gmail.com"]
+  s.homepage    = "https://github.com/bazaarlabs/tvdbr"
+  s.summary     = %q{Use the TVDB API from Ruby}
+  s.description = %q{Utilize the TVDB API from Ruby to fetch shows, track updates to the tvdb and sync your media database}
+  s.rubyforge_project = "tvdbr"
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency "hashie"
+  s.add_dependency "httparty"
+  s.add_development_dependency "rake"
+end

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification 
+name: tvdbr
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Miso
+- Nathan Esquenazi
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-01-17 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hashie
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id003
+description: Utilize the TVDB API from Ruby to fetch shows, track updates to the tvdb and sync your media database
+email: 
+- nesquena@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- README
+- Rakefile
+- examples/demo.rb
+- lib/tvdbr.rb
+- lib/tvdbr/client.rb
+- lib/tvdbr/data_set.rb
+- lib/tvdbr/episode.rb
+- lib/tvdbr/series.rb
+- lib/tvdbr/version.rb
+- spec/.gitkeep
+- tvdbr.gemspec
+has_rdoc: true
+homepage: https://github.com/bazaarlabs/tvdbr
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: tvdbr
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Use the TVDB API from Ruby
+test_files: 
+- spec/.gitkeep