tvdb 0.0.2

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Álvaro Bautista
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,14 @@
+# tvdb
+
+Ruby wrapper for accessing TV shows information from the [TheTVDB](http://www.thetvdb.com) API.
+
+## Example
+
+    require 'tvdb'
+    client = TVdb::Client.new('my_api_key')
+    results = client.search('The Big Bang Theory')
+    client.serie_in_language(results.first, 'fr')
+    
+## Copyright
+
+Copyright (c) 2009 Álvaro Bautista, released under MIT license

data/Rakefile

@@ -0,0 +1,46 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "tvdb"
+    gem.summary = %Q{Ruby wrapper for TheTVDB}
+    gem.description = %Q{Ruby wrapper for accessing TV shows information from the TheTVDB API}
+    gem.email = "alvarobp@gmail.com"
+    gem.homepage = "http://github.com/alvarobp/tvdb"
+    gem.authors = ["Álvaro Bautista"]
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    gem.add_dependency "hpricot", ">= 0.8.1"
+    gem.add_dependency "rubyzip", ">= 0.9.1"
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "tvdb #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.2

data/lib/tvdb.rb

@@ -0,0 +1,14 @@
+require 'ostruct'
+require 'open-uri'
+require 'hpricot'
+require 'zip/zip'
+
+# OpenURI by default returns StringIO objects for responses up to 10K 
+# and creates temporary files for greater responses, so we force it to
+# always create temporary files since ZipFile only accepts filenames
+OpenURI::Buffer::StringMax = 0
+
+require File.dirname(__FILE__) + '/tvdb/urls'
+require File.dirname(__FILE__) + '/tvdb/client'
+require File.dirname(__FILE__) + '/tvdb/element'
+require File.dirname(__FILE__) + '/tvdb/serie'

data/lib/tvdb/client.rb

@@ -0,0 +1,65 @@
+module TVdb
+  class Client
+    attr_reader :api_key, :urls
+    
+    def initialize(api_key)
+      @api_key = api_key
+      @urls = Urls.new(api_key)
+    end
+    
+    def search(name, options={})
+      default_options = {:lang => 'en', :match_mode => :all}
+      options = default_options.merge(options)
+      
+      search_url = @urls[:get_series] % {:name => URI.escape(name), :language => options[:lang]}
+      
+      doc = Hpricot(OpenURI.open_uri(search_url).read)
+      
+      ids = if options[:match_mode] == :exact
+        doc.search('series').select{|s| s.search('seriesname').inner_text == name }.collect{|e| e.search('id')}.map(&:inner_text)
+      else
+        doc.search('series').search('id').map(&:inner_text)
+      end
+      
+      ids.map do |sid|
+        get_serie_from_zip(sid, options[:lang])
+      end.compact
+    end
+    
+    def serie_in_language(serie, lang)
+      return nil if !serie.respond_to?(:tvdb_id)
+      return serie if lang == serie.language
+      
+      get_serie_from_zip(serie.tvdb_id, lang)
+    end
+    
+    def get_serie_zip(id, lang='en')
+      zip_file = open_or_rescue(@urls[:serie_zip] % {:serie_id => id, :language => lang})
+      zip_file.nil? ? nil : Zip::ZipFile.new(zip_file.path)
+    end
+    
+    private
+    
+    def open_or_rescue(url)
+      begin
+        return OpenURI.open_uri(url)
+      rescue OpenURI::HTTPError # 404 errors for some of the ids returned in search
+        return nil
+      end
+    end
+    
+    def get_serie_from_zip(sid, lang='en')
+      zip = get_serie_zip(sid, lang)
+      return nil if zip.nil?
+      
+      xml = read_serie_xml_from_zip(zip, lang)
+      return xml ? Serie.new(xml) : nil
+    end
+    
+    def read_serie_xml_from_zip(zip, lang='en')
+      if entry = zip.find_entry("#{lang}.xml")
+        entry.get_input_stream.read
+      end
+    end
+  end
+end

data/lib/tvdb/element.rb

@@ -0,0 +1,40 @@
+module TVdb
+  class Element < OpenStruct
+    def initialize(xml, root_name=nil)
+      @root_name = root_name
+      
+      atts = attributes_from_xml(xml)
+      
+      # Downcase the keys
+      atts = atts.inject({}){|options, (k,v)| options[k.downcase] = v; options}
+      
+      # Don't mess with Object.id
+      if atts.has_key?('id')
+        sid = atts.delete('id')
+        atts[:tvdb_id] = sid
+      end
+      
+      yield(atts) if block_given?
+      
+      super(atts)
+    end
+    
+    protected
+    
+    def attributes_from_xml(xml)
+      return {} if xml.nil? || xml.empty?
+      doc = Hpricot(xml)
+      
+      attributes = {}
+      
+      element_root = @root_name.nil? ? doc.root : doc.search(@root_name).first
+      
+      element_root.children.map do |child|
+        unless child.is_a?(Hpricot::Text)
+          attributes[child.name] = child.inner_text
+        end
+      end
+      attributes
+    end
+  end
+end

data/lib/tvdb/serie.rb

@@ -0,0 +1,16 @@
+module TVdb
+  class Serie < Element
+    def initialize(xml)
+      super(xml, 'series') do |atts|
+        # Turn into arrays
+        atts["actors"] = atts["actors"].split('|').select{|a| !a.nil? && !a.empty?} if atts["actors"] && atts["actors"].is_a?(String) && !atts["actors"].empty?
+        genres = atts.delete("genre")
+        atts["genres"] = genres.split('|').select{|a| !a.nil? && !a.empty?} if genres && genres.is_a?(String) && !genres.empty?
+
+        atts["poster"] = BANNER_URL % atts["poster"] unless atts["poster"].nil?
+      end
+    end
+  end
+  
+  BANNER_URL = "http://www.thetvdb.com/banners/_cache/%s"
+end

data/lib/tvdb/urls.rb

@@ -0,0 +1,40 @@
+module TVdb
+  class Urls
+    BASE_URL = "http://www.thetvdb.com"
+    URLS = {
+      :get_series => "%s/api/GetSeries.php?seriesname={{name}}&language={{language}}",
+      :serie_xml => "%s/api/%s/series/{{serie_id}}/{{language}}.xml",
+      :serie_full_xml => "%s/api/%s/series/{{serie_id}}/all/{{language}}.xml",
+      :serie_banners_xml => "%s/api/%s/series/{{serie_id}}/banners.xml",
+      :serie_zip => "%s/api/%s/series/{{serie_id}}/all/{{language}}.zip",
+      :episode_xml => "%s/api/%s/episodes/{{episode_id}}/{{language}}.xml"
+    }
+    
+    attr_reader :api_key, :templates
+    
+    def initialize(api_key, base_url=BASE_URL)
+      @api_key = api_key
+      @templates = URLS.inject({}){|object, (k,v)| object[k] = Template.new(v % [base_url, @api_key]); object}
+    end
+    
+    def [](key)
+      @templates[key]
+    end
+  end
+  
+  class Template
+    attr_reader :template
+    
+    def initialize(template)
+      @template = template
+    end
+    
+    def %(values)
+      @template.gsub(/\{\{(.*?)\}\}/ ){
+        value = values[$1] || values[$1.to_sym]
+        raise "Value for #{$1} not found" if value.nil?
+        value.to_s
+      }
+    end
+  end
+end

data/spec/data/serie1.xml

@@ -0,0 +1,26 @@
+<Series>
+  <id>80379</id>
+  <Actors>|Johnny Galecki|Kaley Cuoco|Jim Parsons|Sara Gilbert|Kunal Nayyar|Simon Helberg|</Actors>
+  <Airs_DayOfWeek>Monday</Airs_DayOfWeek>
+  <Airs_Time>9:30 PM</Airs_Time>
+  <ContentRating>TV-PG</ContentRating>
+  <FirstAired>2007-09-01</FirstAired>
+  <Genre>|Comedy|</Genre>
+  <IMDB_ID>tt0898266</IMDB_ID>
+  <Language>en</Language>
+  <Network>CBS</Network>
+  <NetworkID></NetworkID>
+  <Overview>A woman who moves into an apartment next door to two brilliant but socially awkward physicists shows them how little they know about life outside of the laboratory</Overview>
+  <Rating>8.9</Rating>
+  <Runtime>30</Runtime>
+  <SeriesID>58056</SeriesID>
+  <SeriesName>The Big Bang Theory</SeriesName>
+  <Status>Continuing</Status>
+  <added></added>
+  <addedBy></addedBy>
+  <banner>graphical/80379-g5.jpg</banner>
+  <fanart>fanart/original/80379-2.jpg</fanart>
+  <lastupdated>1258740481</lastupdated>
+  <poster>posters/80379-1.jpg</poster>
+  <zap2it_id>SH931182</zap2it_id>
+</Series>

data/spec/data/serie2.xml

@@ -0,0 +1,26 @@
+<Series>
+  <id>73739</id>
+  <Actors>|Matthew Fox|Evangeline Lilly|Naveen Andrews|Terry O'Quinn|Daniel Dae Kim|Yunjin Kim|Josh Holloway|John Terry|Andrew Divoff|Sam Anderson|L. Scott Caldwell|Nestor Carbonell|Kevin Durand|Jeff Fahey|Tania Raymonde|Mira Furlan|Alan Dale|Sonya Walger|Rebecca Mader|Ken Leung|Jeremy Davies|Elizabeth Mitchell|Kiele Sanchez|Rodrigo Santoro|Cynthia Watros|Adewale Akinnuoye-Agbaje|Henry Ian Cusick|Michael Emerson|Michelle Rodriguez|Dominic Monaghan|Emilie de Ravin|Harold Perrineau Jr.|Ian Somerhalder|Maggie Grace|Jorge Garcia|Malcolm David Kelley|M.C. Gainey|Zuleikha Robinson|</Actors>
+  <Airs_DayOfWeek>Wednesday</Airs_DayOfWeek>
+  <Airs_Time>9:00 PM</Airs_Time>
+  <ContentRating>TV-14</ContentRating>
+  <FirstAired>2004-09-22</FirstAired>
+  <Genre>|Action and Adventure|Drama|Science-Fiction|</Genre>
+  <IMDB_ID>tt0411008</IMDB_ID>
+  <Language>en</Language>
+  <Network>ABC</Network>
+  <NetworkID></NetworkID>
+  <Overview>After their plane, Oceanic Air flight 815, tore apart whilst thousands of miles off course, the survivors find themselves on a mysterious deserted island where they soon find out they are not alone.</Overview>
+  <Rating>9.1</Rating>
+  <Runtime>60</Runtime>
+  <SeriesID>24313</SeriesID>
+  <SeriesName>Lost</SeriesName>
+  <Status>Continuing</Status>
+  <added></added>
+  <addedBy></addedBy>
+  <banner>graphical/73739-g4.jpg</banner>
+  <fanart>fanart/original/73739-34.jpg</fanart>
+  <lastupdated>1258670676</lastupdated>
+  <poster>posters/73739-7.jpg</poster>
+  <zap2it_id>SH672362</zap2it_id>
+</Series>

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+require 'rubygems'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'tvdb'
+require 'spec'
+require 'spec/autorun'
+
+def load_example_data
+  @serie1_xml = File.read(File.dirname(__FILE__) + "/data/serie1.xml")
+  @serie2_xml = File.read(File.dirname(__FILE__) + "/data/serie2.xml")
+  @series_xml = @serie1_xml + @serie2_xml
+  @serie1_zip = File.open(File.dirname(__FILE__) + "/data/serie1.zip")
+  @serie2_zip = File.open(File.dirname(__FILE__) + "/data/serie2.zip")
+end

data/spec/tvdb/client_spec.rb

@@ -0,0 +1,133 @@
+require File.expand_path(File.dirname(__FILE__) + "/../spec_helper")
+
+module TVdb
+  describe Client do
+    before(:each) do
+      @client = Client.new("api_key")
+      load_example_data
+    end
+    
+    it "should have an api_key" do
+      @client.api_key.should == "api_key"
+    end
+    
+    it "should have an Urls instance for the given api_key" do
+      @client.urls.should be_an_instance_of Urls
+      @client.urls[:serie_xml].template.should match /^http:\/\/www\.thetvdb\.com\/api\/api_key/
+    end
+    
+    describe "get serie full data on zip" do
+      it "should request the TheTVDB serie zip url" do
+        OpenURI.should_receive(:open_uri).with(@client.urls[:serie_zip] % {:serie_id => "123987", :language => "en"}).and_return(@serie1_zip)
+        @client.get_serie_zip("123987")
+      end
+      
+      it "should request the TheTVDB serie zip url in given language" do
+        OpenURI.should_receive(:open_uri).with(@client.urls[:serie_zip] % {:serie_id => "123987", :language => "de"}).and_return(@serie1_zip)
+        @client.get_serie_zip("123987", 'de')
+      end
+      
+      it "should avoid OpenURI::HTTPError exceptions" do
+        # Trying the TheTVDB API I have experienced that search return some
+        # invalid records which lead to 404 errors when requesting their info
+        OpenURI.stub!(:open_uri).and_raise(OpenURI::HTTPError.new("", "a"))
+        lambda {@client.get_serie_zip("123987")}.should_not raise_error
+        @client.get_serie_zip("123987").should be_nil
+      end
+    end
+    
+    describe "search" do
+      it "should request the TheTVDB search uri with given name" do
+        OpenURI.should_receive(:open_uri).with(@client.urls[:get_series] % {:name => URI.escape("Best show"), :language => "en"}).and_return(@serie1_zip)
+        @client.search("Best show")
+      end
+      
+      it "should request the TheTVDB search uri with given name and language" do
+        OpenURI.should_receive(:open_uri).with(@client.urls[:get_series] % {:name => URI.escape("Best show"), :language => "de"}).and_return(@serie1_zip)
+        @client.search("Best show", {:lang => "de"})
+      end
+      
+      it "should get the zips of returned results" do
+        OpenURI.should_receive(:open_uri).and_return(StringIO.new(@series_xml))
+        
+        @client.should_receive(:get_serie_zip).with("80379", "en").and_return(nil)
+        @client.should_receive(:get_serie_zip).with("73739", "en").and_return(nil)
+        @client.search("something")
+      end
+      
+      it "should get the info for each return result in given language" do
+        OpenURI.should_receive(:open_uri).and_return(StringIO.new(@series_xml))
+        
+        @client.should_receive(:get_serie_zip).with("80379", "de").and_return(nil)
+        @client.should_receive(:get_serie_zip).with("73739", "de").and_return(nil)
+        @client.search("something", :lang => "de")
+      end
+      
+      it "should return the Series corresponding to each response" do
+        OpenURI.should_receive(:open_uri).and_return(StringIO.new(@series_xml))
+        
+        @client.should_receive(:get_serie_zip).with("80379", "en").and_return(Zip::ZipFile.new(@serie1_zip.path))
+        @client.should_receive(:get_serie_zip).with("73739", "en").and_return(Zip::ZipFile.new(@serie2_zip.path))
+        
+        results = @client.search("something")
+        results.size.should == 2
+        results.each{|r| r.class.should == TVdb::Serie}
+        results.map(&:seriesname).sort.should == ["Lost", "The Big Bang Theory"]
+      end
+      
+      it "should give just the results with exact name" do
+        OpenURI.should_receive(:open_uri).and_return(StringIO.new(<<-XML
+        <Series><id>73739</id><SeriesName>Lost</SeriesName></Series>
+        <Series><id>73420</id><SeriesName>Finder of Lost Loves</SeriesName></Series>
+        <Series><id>98261</id><SeriesName>Lost Evidence</SeriesName></Series>
+        XML
+        ))
+        
+        @client.should_receive(:get_serie_zip).once.with("73739", "en").and_return(Zip::ZipFile.new(@serie2_zip.path))
+        results = @client.search("Lost", :match_mode => :exact)
+        results.size.should == 1
+        results.first.seriesname.should == "Lost"
+      end
+      
+      it "should skip unreachable results" do
+        OpenURI.should_receive(:open_uri).and_return(StringIO.new(@series_xml))
+        
+        @client.should_receive(:get_serie_zip).with("80379", "en").and_return(Zip::ZipFile.new(@serie1_zip.path))
+        @client.should_receive(:get_serie_zip).with("73739", "en").and_return(nil)
+        
+        results = @client.search("something")
+        results.size.should == 1
+        results.first.seriesname.should == "The Big Bang Theory"
+      end
+    end
+    
+    describe "get serie in other language" do
+      it "should avoid empty series" do
+        @client.serie_in_language(Serie.new(""), "es").should be_nil
+      end
+      
+      it "should give the serie itself when language is the same" do
+        serie = Serie.new(@serie1_xml)
+        @client.serie_in_language(serie, "en").should == serie
+      end
+      
+      it "should get the serie with information in the given language" do        
+        original = Serie.new("<Series><id>4815162342</id></Series>")
+        zip_mock = mock "ZipFile"
+        
+        @client.stub!(:get_serie_zip).and_return(zip_mock)
+        @client.stub!(:read_serie_xml_from_zip).with(zip_mock, 'es').and_return("<Series><id>4815162342</id><Overview>¿Qué quieren decir esos números?</Overview></Series>")
+
+        translated = @client.serie_in_language(original, "es")
+        translated.tvdb_id.should == "4815162342"
+        translated.overview.should == "¿Qué quieren decir esos números?"
+      end
+      
+      it "should return nil if there is no serie info" do
+        original = Serie.new("<Series><id>4815162342</id></Series>")
+        @client.should_receive(:get_serie_zip).with("4815162342", "es").and_return(nil)
+        @client.serie_in_language(original, "es").should be_nil
+      end
+    end
+  end
+end

data/spec/tvdb/element_spec.rb

@@ -0,0 +1,49 @@
+require File.expand_path(File.dirname(__FILE__) + "/../spec_helper")
+
+module TVdb
+  describe Element do
+    before(:each) do
+      load_example_data
+    end
+    
+    it "should map id attribute to tvdb_id serie method" do
+      element = Element.new("<Element><id>4815162342</id></Element>")
+      element.tvdb_id.should == "4815162342"
+      
+      element = Element.new("<Wadus><id>3210</id></Wadus>")
+      element.tvdb_id.should == "3210"
+    end
+    
+    it "should have a method returning each root children by default" do
+      element = Element.new('<Element><attribute1>The one</attribute1><second>2</second><last>inphinity</last></Element>')
+      element.attribute1.should == "The one"
+      element.second.should == "2"
+      element.last.should == "inphinity"
+    end
+    
+    it "should have a method returning each children of the first element of the given name" do
+      element = Element.new('<Data><List><Element><attribute1>The one</attribute1><second>2</second><last>inphinity</last></Element></List></Data>', 'element')
+      element.attribute1.should == "The one"
+      element.second.should == "2"
+      element.last.should == "inphinity"
+    end
+    
+    it "should accept a block that takes an attributes hash parameter to process elements" do
+      element = Element.new('<Element><attribute1>The one</attribute1><second>2</second></Element>') do |attributes|
+        attributes['attribute1'] += " and only"
+        attributes['attribute2'] = attributes['second']
+        attributes.delete('second')
+      end
+      
+      element.attribute1.should == "The one and only"
+      element.attribute2.should == "2"
+      element.second.should be_nil
+    end
+    
+    it "should behave with empty xml" do
+      element = Element.new("")
+      
+      element.wadus.should be_nil
+    end
+  end
+end

data/spec/tvdb/serie_spec.rb

@@ -0,0 +1,39 @@
+require File.expand_path(File.dirname(__FILE__) + "/../spec_helper")
+
+module TVdb
+  describe Serie do
+    before(:each) do
+      load_example_data
+    end
+    
+    it "should build from TheTVDB serie xml" do
+      serie = Serie.new(@serie1_xml)
+      serie.seriesname = "The Big Bang Theory"
+      serie.firstaired = "2007-09-01"
+      serie.imdb_id = "tt0898266"
+      serie.status = "Continuing"
+    end
+    
+    it "should map actors field to an array" do
+      serie = Serie.new("<Series><actors>|Humphrey Bogart|</actors></Series>")
+      serie.actors.should == ["Humphrey Bogart"]
+      
+      serie = Serie.new("<Series><actors>|Humphrey Bogart|Ingrid Bergman|Paul Henreid|</actors></Series>")
+      serie.actors.should == ["Humphrey Bogart", "Ingrid Bergman", "Paul Henreid"]
+    end
+    
+    it "should map genre field to field genres as an array" do
+      serie = Serie.new("<Series><genre>|Comedy|</genre></Series>")
+      serie.genres.should == ["Comedy"]
+      
+      serie = Serie.new("<Series><genre>|Comedy|Romance|</genre></Series>")
+      serie.genres.should == ["Comedy", "Romance"]
+    end
+    
+    it "should convert poster attribute to a TheTVDB banner url" do
+      serie = Serie.new("<Series><poster>posters/80379-1.jpg</poster></Series>")
+      serie.poster.should == TVdb::BANNER_URL % "posters/80379-1.jpg"
+    end
+    
+  end
+end

data/spec/tvdb/urls_spec.rb

@@ -0,0 +1,50 @@
+require File.expand_path(File.dirname(__FILE__) + "/../spec_helper")
+
+module TVdb
+  describe Urls do
+    before(:each) do
+      @urls = Urls.new("api_key")
+    end
+    
+    it "should have an api_key" do
+      @urls.api_key.should == "api_key"
+    end
+    
+    it "should have templates for default urls with base url and api key on their template value" do
+      @urls.templates.size.should == Urls::URLS.size
+      Urls::URLS.each do |k,v|
+        @urls.templates[k].template.should == v % [Urls::BASE_URL, "api_key"]
+      end
+    end
+    
+    it "should support different base urls" do
+      urls = Urls.new("api_key", "http://www.wadus.org")
+      Urls::URLS.each do |k,v|
+        urls.templates[k].template.should == v % ["http://www.wadus.org", "api_key"]
+      end
+    end
+    
+    it "should reference its templates" do
+      @urls[:serie_url].should == @urls.templates[:serie_url]
+    end
+  end
+  
+  describe Template do
+    before(:each) do
+      @template_string = "Hello my name is {{name}} and I am from {{country}}."
+      @template = Template.new(@template_string)
+    end
+    
+    it "should have a template" do
+      @template.template.should == @template_string
+    end
+    
+    it "should substitute its pattern using keys and values" do
+      (@template % {:name => "Alvaro", :country => "Spain"}).should == "Hello my name is Alvaro and I am from Spain."
+    end
+    
+    it "should raise error if any value is missing" do
+      lambda {@template % {:name => "Alvaro"}}.should raise_error("Value for country not found")
+    end
+  end
+end

data/tvdb.gemspec

@@ -0,0 +1,74 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{tvdb}
+  s.version = "0.0.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["\303\201lvaro Bautista"]
+  s.date = %q{2010-08-29}
+  s.description = %q{Ruby wrapper for accessing TV shows information from the TheTVDB API}
+  s.email = %q{alvarobp@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.markdown"
+  ]
+  s.files = [
+    ".gitignore",
+     "LICENSE",
+     "README.markdown",
+     "Rakefile",
+     "VERSION",
+     "lib/tvdb.rb",
+     "lib/tvdb/client.rb",
+     "lib/tvdb/element.rb",
+     "lib/tvdb/serie.rb",
+     "lib/tvdb/urls.rb",
+     "spec/data/serie1.xml",
+     "spec/data/serie1.zip",
+     "spec/data/serie2.xml",
+     "spec/data/serie2.zip",
+     "spec/spec.opts",
+     "spec/spec_helper.rb",
+     "spec/tvdb/client_spec.rb",
+     "spec/tvdb/element_spec.rb",
+     "spec/tvdb/serie_spec.rb",
+     "spec/tvdb/urls_spec.rb",
+     "tvdb.gemspec"
+  ]
+  s.homepage = %q{http://github.com/alvarobp/tvdb}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{Ruby wrapper for TheTVDB}
+  s.test_files = [
+    "spec/spec_helper.rb",
+     "spec/tvdb/client_spec.rb",
+     "spec/tvdb/element_spec.rb",
+     "spec/tvdb/serie_spec.rb",
+     "spec/tvdb/urls_spec.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_runtime_dependency(%q<hpricot>, [">= 0.8.1"])
+      s.add_runtime_dependency(%q<rubyzip>, [">= 0.9.1"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_dependency(%q<hpricot>, [">= 0.8.1"])
+      s.add_dependency(%q<rubyzip>, [">= 0.9.1"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    s.add_dependency(%q<hpricot>, [">= 0.8.1"])
+    s.add_dependency(%q<rubyzip>, [">= 0.9.1"])
+  end
+end
+

metadata

@@ -0,0 +1,128 @@
+--- !ruby/object:Gem::Specification 
+name: tvdb
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 2
+  version: 0.0.2
+platform: ruby
+authors: 
+- "\xC3\x81lvaro Bautista"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-08-29 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 2
+        - 9
+        version: 1.2.9
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: hpricot
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 8
+        - 1
+        version: 0.8.1
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rubyzip
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 9
+        - 1
+        version: 0.9.1
+  type: :runtime
+  version_requirements: *id003
+description: Ruby wrapper for accessing TV shows information from the TheTVDB API
+email: alvarobp@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.markdown
+files: 
+- .gitignore
+- LICENSE
+- README.markdown
+- Rakefile
+- VERSION
+- lib/tvdb.rb
+- lib/tvdb/client.rb
+- lib/tvdb/element.rb
+- lib/tvdb/serie.rb
+- lib/tvdb/urls.rb
+- spec/data/serie1.xml
+- spec/data/serie1.zip
+- spec/data/serie2.xml
+- spec/data/serie2.zip
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/tvdb/client_spec.rb
+- spec/tvdb/element_spec.rb
+- spec/tvdb/serie_spec.rb
+- spec/tvdb/urls_spec.rb
+- tvdb.gemspec
+has_rdoc: true
+homepage: http://github.com/alvarobp/tvdb
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Ruby wrapper for TheTVDB
+test_files: 
+- spec/spec_helper.rb
+- spec/tvdb/client_spec.rb
+- spec/tvdb/element_spec.rb
+- spec/tvdb/serie_spec.rb
+- spec/tvdb/urls_spec.rb