subtitulos_downloader 0.5.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/Gemfile

@@ -0,0 +1,12 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in subtitulos_downloader.gemspec
+gemspec
+
+group :development, :test do
+  gem 'ruby-debug19'
+end
+
+group :test do
+  
+end

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Hector Sanchez-Pajares
+
+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.md

@@ -0,0 +1,76 @@
+Subtitulos Downloader
+=====================
+Subtitulos Downloader is a gem to download subtitles focused in spanish language.
+
+Description
+-----------
+Subtitles Downloader can use different subtitles providers to fetch the files from different webs.
+It allows to download subtitles for multiple languages supported by the provider used.
+
+It also supports TVdb to fetch the episode name and the real name for the show given a season and an episode number.
+
+It saves the file(s) to a given path.Right now, only supported format name is: 
+<code>Show Name/Season #/Show Name - SxEE - Episode Name-Language.srt</code>
+
+
+### Providers
+The providers currently developed are:
+* [subtitulos.es](http://www.subtitulos.es)
+
+
+Installation
+------------
+To install the gem
+<pre>
+  gem install subtitulos_downloader
+</pre>
+
+Usage
+-----
+For using this gem all you have to do is
+<pre>
+  require 'subtitulos_downloader'
+  sub_downloader = SubtitulosDownloader::SubtitulosDownloader({ 
+    :provider = SubtitulosDownloader::SubtitlosEs,
+    :tvdb_api_key = 'XXXXXXXXXXXXX'
+  })
+
+  # Fetching spanish subtitles given a show name, season and episode
+  episode = sub_downloader.fetch('Fringe', 4, 7, %w[ es ])
+
+  # Fetching english subtitles given a file name
+  episode = sub_downloader.fetch_by_file_name('Fringe.S04E07.HDTV.XviD-LOL.avi.avi', %w[ en ])
+
+  # Fetching english and spanish subtitles given an episode object
+  episode = SubtitulosDownloader::ShowEpisode.new_from_file_name('Fringe.S04E07.HDTV.XviD-LOL.avi.avi', {:tvdb_api_key = 'XXXXXXX'})
+  sub_downloader.fetch_by_show_episode(episode, %w[ es en ])
+        
+  # To save the subtitles
+  # Ex: /path_to_save/Fringe/Season 4/Fringe - 4x07 - Wallflower-English.srt
+  sub_downloader.save_subs_to_path(episode, '/path_to_save')
+
+  # Episode Object
+  episode = 
+  subs = episode.subtitles # Array containing all subtitles for the episode
+  name = episode.full_name # Ex: Fringe - 4x07 - Wallflower
+  ep_name = episode.episode_name # Ex: Wallflower
+  season = episode.season # Ex: 4
+  episode = episode.episode # Ex: 7
+  show = episode.show_name # Ex: Fringe
+
+  # Subtitle Object
+  subtitles = episode.subtitles.first
+  subtitles.language # Language of subtitles
+  subtitles.subtitles # String containing the subtitles
+</pre>
+
+Contact
+------
+Héctor Sánchez-Pajares
+[hector@aerstudio.com](mailto:hector@aerstudio.com)
+
+
+
+
+
+

data/Rakefile

@@ -0,0 +1,16 @@
+require "bundler/gem_tasks"
+require 'bundler/setup'
+require 'rspec/core/rake_task'
+
+Bundler.setup(:default, :development)
+
+
+desc "Run all RSpec tests"
+RSpec::Core::RakeTask.new(:spec)
+
+desc "Build the gem"
+task :gem do
+  sh 'gem build *.gemspec'
+end
+
+task :default => :spec

data/lib/subtitulos_downloader.rb

@@ -0,0 +1,67 @@
+require "subtitulos_downloader/version"
+require "subtitulos_downloader/subtitle"
+require "subtitulos_downloader/show_episode"
+require "subtitulos_downloader/exception"
+require "subtitulos_downloader/provider/provider"
+Dir["#{File.dirname(__FILE__)}/subtitulos_downloader/provider/*.rb"].each {|f| require f}
+
+
+module SubtitulosDownloader
+
+  class SubtitulosDownloader
+    def initialize(opts = {})
+      options = {
+        :provider => SubtitulosEs
+      }.merge!(opts)
+      
+      @provider = options[:provider].new(options)
+      @options = options
+    end
+
+    def fetch(show_name, season, episode, languages = %w[ es en ])
+      languages = [languages] if not languages.respond_to?('each')
+      show_episode = ShowEpisode.new(show_name, season, episode, @options)
+      languages.each do |language|
+        @provider.fetch(show_episode, language)
+      end
+      show_episode
+    end
+
+    def fetch_by_file_name(file_name, languages = %w[ es en ])
+      languages = [languages] if not languages.respond_to?('each')
+      show_episode = ShowEpisode.new_from_file_name(file_name, @options)
+      languages.each do |language|
+        @provider.fetch(show_episode, language)
+      end
+      show_episode
+    end
+
+    def fetch_by_show_episode(show_episode, languages = %w[ es en ])
+      languages = [languages] if not languages.respond_to?('each')
+      languages.each do |language|
+        @provider.fetch(show_episode, language)
+      end
+      show_episode
+    end
+
+    def save_subs_to_path(show_episode, path)
+      show_episode.subtitles.each do |subtitle|
+        check_if_path_exists("#{path}/#{show_episode.show_path}")
+        check_if_path_exists("#{path}/#{show_episode.season_path}")
+        file = File.new("#{path}/#{subtitle.save_path}", "w")
+        file.write(subtitle.subtitles)
+        file.close
+      end
+    end
+
+
+    protected
+
+    def check_if_path_exists(path)
+      if not FileTest::directory?(path)
+        Dir::mkdir(path)
+      end
+    end
+
+  end
+end

data/lib/subtitulos_downloader/exception.rb

@@ -0,0 +1,25 @@
+module SubtitulosDownloader
+  class SDException < Exception
+  end
+
+  class Timeout < SDException
+  end
+
+  class ShowNotFound < SDException
+  end
+
+  class MoreThanOneShow < SDException
+  end
+
+  class EpisodeNotFound < SDException
+  end
+
+  class SeasonNotFound < SDException
+  end
+
+  class TranslationNotFinished < SDException
+  end
+
+  class LanguageNotFound < SDException
+  end
+end

data/lib/subtitulos_downloader/provider/provider.rb

@@ -0,0 +1,22 @@
+require 'version'
+module SubtitulosDownloader
+  class Provider
+
+    def initialize(options={})
+      @options = options
+      @user_agent = "SubtitulosDownloader/#{VERSION}"
+      init
+    end
+
+    def init(options)
+      # to be override
+      @base_uri = ""
+      @provider_name =''
+    end
+
+    def fetch(show, language)
+
+    end
+
+  end
+end

data/lib/subtitulos_downloader/provider/subtitulos_es.rb

@@ -0,0 +1,143 @@
+# encoding: utf-8
+require 'hpricot'
+require "version"
+
+module SubtitulosDownloader
+
+  class SubtitulosEs < Provider
+
+    def init
+      @base_uri = "http://www.subtitulos.es"
+      @provider_name = "subtitulos.es"  
+    end
+    
+
+    def fetch(show_episode, language)
+
+      get_shows_page unless @shows_doc
+
+      shows = search_show show_episode
+      
+      show_sub = shows.first
+
+      episode_subs_table = get_episode_table show_episode, show_sub
+      
+      case language
+        when 'en'
+          lang = 'English'
+        when 'es'
+          lang = 'España'
+        else
+          lang = language
+      end
+
+      begin
+        subs = get_subtitles(lang, episode_subs_table, show_sub)
+        subtitle = Subtitle.new subs, language, show_episode
+      rescue SDException => e
+        if language == 'es'
+          if lang == 'España' 
+            lang = 'Latinoamérica'
+            retry
+          elsif lang == 'Latinoamérica'
+            lang = 'Español'
+            retry
+          else
+            raise e
+          end
+        else
+          raise e
+        end        
+      end
+
+      subtitle
+
+    end
+
+    protected
+
+    def get_subtitles(language, episode_table, show_sub)
+      (episode_table/"tr/td.language").each do |lang|
+        language_sub = lang.inner_html.strip.force_encoding('utf-8')
+        if language_sub =~ /#{language}/i
+            # puts "Language #{language} found"
+            if not lang.next_sibling.inner_html =~ /[0-9]+\.?[0-9]*% Completado/i
+              # puts "Translation for language #{language} completed"
+              subtitle_a = lang.parent.search("a").at(0)
+              subtitle_url = subtitle_a.attributes['href']
+              # puts "Fetching #{language} subtitle file"
+              open(subtitle_url, 
+                "User-Agent" => @user_agent,
+                "Referer" => "#{@base_uri}/show/#{show_sub[:id_show]}") { |f|
+                  # Save the response body
+                  subs= f.read
+                  return subs
+              }
+            else
+              raise TranslationNotFinished, "[#{@provider_name}] #{language} translation not finished for #{show_sub[:show_episode].full_name}"              
+            end
+        end
+      end
+      raise LanguageNotFound, "[#{@provider_name}] #{language} not found for #{show_sub[:show_episode].full_name}"
+    end
+
+
+    def search_show show_episode
+      shows = []
+      @shows_doc.search("a").each do |show_subs|
+        show_name = show_subs.inner_html.force_encoding('utf-8')
+        show_url = show_subs.attributes['href']
+        if show_name =~ /#{show_episode.show_name}/i
+          shows << { :show_episode => show_episode, :url => show_url, :id_show => show_url.split('/show/')[1].to_i }
+        end
+      end
+      raise ShowNotFound, "[#{@provider_name}] #{show_episode.show_name} not found" if shows.count == 0
+      raise MoreThanOneShow, "[#{@provider_name}] Found #{shows.count} for #{show_episode.show_name}" if shows.count > 1
+      shows
+    end
+
+    def get_episode_table(show_episode, show_sub)
+
+      season_url = "#{@base_uri}/ajax_loadShow.php?show=#{show_sub[:id_show]}&season=#{show_episode.season}"
+      ep_t = nil
+      open(season_url,
+        "User-Agent" => @user_agent,
+        "Referer" =>"#{@base_uri}" ) { |f|
+          
+          cont = f.read
+          raise SeasonNotFound, "[#{@provider_name}] Season for #{show_episode.full_name} not found" if cont == ''
+
+          season_doc = Hpricot(cont)
+
+          season_doc.search('table').each do |episode_table|
+            title = (episode_table/"tr/td[@colspan='5']/a").inner_html.force_encoding('utf-8')
+            episode_str = "%02d" % show_episode.episode
+            episode_number = "#{show_episode.season}x#{episode_str}"
+            if title =~ /#{episode_number}/i
+              ep_t = episode_table
+              break
+            end
+          end
+      }
+
+      if ep_t
+        return ep_t
+      else
+        raise EpisodeNotFound, "[#{@provider_name}] Episode #{show_episode.full_name} not found"
+      end
+
+    end
+
+
+    def get_shows_page
+      open(
+      "#{@base_uri}/series", 
+      "User-Agent" => @user_agent,
+      "Referer" =>"#{@base_uri}" ) { |f|
+        @shows_doc = Hpricot(f.read)
+      }
+    end
+
+  end
+
+end

data/lib/subtitulos_downloader/show_episode.rb

@@ -0,0 +1,111 @@
+require 'tvdb'
+
+module SubtitulosDownloader
+
+  class ShowEpisode
+
+    attr_accessor :show_name, :season, :episode, :episode_name
+    attr_accessor :tvdb_episode, :tvdb_show, :subtitles
+
+    def initialize(show_name, season, episode, options = {})
+      
+      @show_name = show_name
+      @season = season.to_i
+      @episode = episode.to_i
+      @options = options
+      @subtitles = []
+
+      if @options[:tvdb_api_key]
+        fetch_data_from_tvdb(@options[:tvdb_api_key])
+      end
+    end
+
+    def fetch_data_from_tvdb(key)
+      @tvdb = TVdb::Client.new(key)  
+      tvdb_show = @tvdb.search(@show_name)
+      if tvdb_show.count > 0
+        tvdb_show = tvdb_show[0]
+        @show_name = tvdb_show.seriesname
+        tvdb_show.episodes.each do |ep|
+          ep_number = ep.episodenumber
+          ep_season = ep.combined_season
+          if ep_number.to_i == @episode && ep_season.to_i == @season
+            @episode_name = ep.episodename
+            break
+          end
+        end
+      else
+        raise ShowNotFound, "[TVdb] show #{@show_name} not found"
+      end
+    end
+
+    def subtitle_language(lang)
+      subs = nil
+      @subtitles.each do |sub|
+        if sub.language == lang
+          return sub
+          break
+        end
+      end
+      return nil
+    end
+
+    def full_name
+      episode_str = "%02d" % @episode
+      if @episode_name
+        "#{@show_name} - #{@season}x#{episode_str} - #{@episode_name}"
+      else
+        "#{@show_name} - #{@season}x#{episode_str}"
+      end
+    end
+
+    def show_path
+      "#{@show_name}"
+    end
+
+    def season_path
+      "#{@show_name}/Season #{@season}"
+    end
+
+    def episode_path
+      "#{@show_name}/Season #{@season}/#{self.full_name}"
+    end
+
+    def self.new_from_file_name(file_name, options={})
+      # House.S04E13.HDTV.XviD-XOR.avi
+      # my.name.is.earl.s03e07-e08.hdtv.xvid-xor.[VTV].avi
+      # My_Name_Is_Earl.3x17.No_Heads_And_A_Duffel_Bag.HDTV_XviD-FoV.[VTV].avi
+      # My Name Is Earl - 3x04.avi
+      # MythBusters - S04E01 - Newspaper Crossbow.avi
+      # my.name.is.earl.305.hdtv-lol.[VTV].avi
+      
+      # TODO look up the regex used in XBMC to get data from TV episodes
+      re =
+        /^(.*?)(?:\s?[-\.]\s?)?\s*\[?s?(?:
+        (?:
+          (\d{1,2})
+          \s?\.?\s?[ex-]\s?
+          (?:(\d{2})(?:\s?[,-]\s?[ex]?(\d{2}))?)
+        )
+        |
+        (?:
+          \.(\d{1})(\d{2})(?!\d)
+        )
+        )\]?\s?.*$/ix
+      
+      if match = file_name.to_s.match(re)
+        series  = match[1].gsub(/[\._]/, ' ').strip.gsub(/\b\w/){$&.upcase}
+        season  = (match[2] || match[5]).to_i
+        episode = (match[3] || match[6]).to_i
+        episode = (episode)..(match[4].to_i) unless match[4].nil?
+        
+        show_episode = ShowEpisode.new(series, season, episode, options) 
+      else
+        nil
+      end
+      
+    end
+
+  end
+
+end

data/lib/subtitulos_downloader/subtitle.rb

@@ -0,0 +1,29 @@
+module SubtitulosDownloader
+
+  class Subtitle
+
+    attr_accessor :subtitles, :language, :show_episode
+
+    def initialize(subs, language, show_episode)
+      @subtitles = subs
+      @language = language
+      @show_episode = show_episode
+      @show_episode.subtitles << self
+    end
+
+
+    def save_path
+      case @language
+        when 'es'
+          lang = 'Spanish'
+        when 'en'
+          lang = 'English'
+        else
+          lang = @language
+      end
+      "#{@show_episode.episode_path}-#{lang}.srt"
+    end
+
+  end
+
+end

data/lib/subtitulos_downloader/version.rb

@@ -0,0 +1,3 @@
+module SubtitulosDownloader
+  VERSION = "0.5.1"
+end

data/spec/show_episode_spec.rb

@@ -0,0 +1,68 @@
+require 'spec_helper'
+
+
+describe SubtitulosDownloader::ShowEpisode do
+
+  context "Initializing" do
+
+    it 'should create a new show episode from show, season and episode' do
+      episode = SubtitulosDownloader::ShowEpisode.new('Raising Hope', 2, 4)
+      episode.show_name.should == 'Raising Hope' 
+      episode.season.should == 2
+      episode.episode.should == 4
+    end
+
+    it 'should create a new show episode from a file name' do
+      ep = SubtitulosDownloader::ShowEpisode.new_from_file_name("Fringe.S04E07.HDTV.XviD-LOL.avi.avi")
+      ep.show_name.should == 'Fringe'
+      ep.season.should == 4
+      ep.episode.should == 7
+    end
+
+    it 'should fetch data from TVdb' do
+      ep = SubtitulosDownloader::ShowEpisode.new_from_file_name("Fringe.S04E07.HDTV.XviD-LOL.avi.avi", {:tvdb_api_key => 'EF41E54C744526F7'})
+      ep.episode_name.should == 'Wallflower'
+    end
+
+    it 'should show the episode full name' do
+      ep = SubtitulosDownloader::ShowEpisode.new_from_file_name("Fringe.S04E07.HDTV.XviD-LOL.avi.avi", {:tvdb_api_key => 'EF41E54C744526F7'})
+      ep.full_name.should == 'Fringe - 4x07 - Wallflower'
+      episode = SubtitulosDownloader::ShowEpisode.new('Raising Hope', 2, 4)
+      episode.full_name.should == 'Raising Hope - 2x04'
+    end
+
+    it 'should show the subtitle given a language' do
+      episode = SubtitulosDownloader::ShowEpisode.new('fake show', 3, 3)
+      subtitle = SubtitulosDownloader::Subtitle.new('subs', 'es', episode)
+      sub = episode.subtitle_language 'es'
+      sub.should == subtitle
+      sub.subtitles.should =='subs'
+
+    end
+
+  end
+
+  context "Paths" do
+    before(:all) do
+      @ep = SubtitulosDownloader::ShowEpisode.new_from_file_name("Fringe.S04E07.HDTV.XviD-LOL.avi.avi", {:tvdb_api_key => 'EF41E54C744526F7'})
+    end
+    it 'should show the show path' do
+      @ep.show_path.should == 'Fringe'
+    end
+
+    it 'should show the season path' do
+      @ep.season_path.should == 'Fringe/Season 4'
+    end
+
+    it 'should show the episode path' do
+      @ep.episode_path.should == 'Fringe/Season 4/Fringe - 4x07 - Wallflower'
+    end
+  end
+
+  context "Exceptions" do
+  
+    it 'should raise a show not found exception' do
+      lambda{ SubtitulosDownloader::ShowEpisode.new('fake show', 4, 5, {:tvdb_api_key => 'EF41E54C744526F7'}) }.should raise_error(SubtitulosDownloader::ShowNotFound)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+
+require 'subtitulos_downloader'
+
+RSpec.configure do |config|
+  config.color_enabled = true
+  config.formatter  = 'documentation'
+end

data/spec/subtitle_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+
+describe SubtitulosDownloader::Subtitle do
+
+  context "Initializing" do
+    before(:all) do
+      @ep = SubtitulosDownloader::ShowEpisode.new_from_file_name("Fringe.S04E07.HDTV.XviD-LOL.avi.avi", {:tvdb_api_key => 'EF41E54C744526F7'})
+    end
+
+    it 'should initialize' do
+      sub = SubtitulosDownloader::Subtitle.new('subs', 'en', @ep)
+      sub.subtitles.should == 'subs'
+      sub.language.should == 'en'
+      sub.show_episode.should == @ep
+      @ep.subtitles.count.should == 1
+      @ep.subtitles.first.should == sub
+    end
+
+    it 'should show the path to save' do
+      sub = SubtitulosDownloader::Subtitle.new('subs', 'en', @ep)
+      sub.save_path.should == 'Fringe/Season 4/Fringe - 4x07 - Wallflower-English.srt'
+      sub = SubtitulosDownloader::Subtitle.new('subs', 'es', @ep)
+      sub.save_path.should == 'Fringe/Season 4/Fringe - 4x07 - Wallflower-Spanish.srt'
+      sub = SubtitulosDownloader::Subtitle.new('subs', 'ca', @ep)
+      sub.save_path.should == 'Fringe/Season 4/Fringe - 4x07 - Wallflower-ca.srt'
+    end
+
+  end
+
+end

data/spec/subtitulos_downloader_spec.rb

@@ -0,0 +1,58 @@
+# encoding: utf-8
+require 'spec_helper'
+
+
+describe SubtitulosDownloader::SubtitulosDownloader do
+
+  context "Fetching" do
+    before(:all) do
+      @sub_downloader = SubtitulosDownloader::SubtitulosDownloader.new
+    end
+
+    it 'should fetch subtitles given name, season and episode' do
+      episode = @sub_downloader.fetch('Fringe', 4, 7, %w[ es ])
+      episode.subtitles.count.should == 1
+      subs = (episode.subtitles.first.subtitles =~ /Ahora solo tengo que averiguar/) > 1
+      subs.should == true
+    end
+
+    it 'should fetch subtitles in english and spanish by default' do
+      episode = @sub_downloader.fetch('Fringe', 4, 7)
+      episode.subtitles.count.should == 2
+      subtitle = episode.subtitle_language 'es'
+      subs = (subtitle.subtitles =~ /Ahora solo tengo que averiguar/) > 1
+      subs.should == true
+      subtitle = episode.subtitle_language 'en'
+      subs = (subtitle.subtitles =~ /10-4. Copy location./) > 1
+      subs.should == true
+    end
+
+    it 'should fetch subtitles given a file name' do
+      episode = @sub_downloader.fetch_by_file_name('Fringe.S04E07.HDTV.XviD-LOL.avi.avi', %w[ es ])
+      episode.subtitles.count.should == 1
+      subs = (episode.subtitles.first.subtitles =~ /Ahora solo tengo que averiguar/) > 1
+      subs.should == true
+    end
+
+    it 'should fetch subtitles given a show episode' do
+      episode = SubtitulosDownloader::ShowEpisode.new_from_file_name('Fringe.S04E07.HDTV.XviD-LOL.avi.avi')
+      @sub_downloader.fetch_by_show_episode(episode, %w[ es ])
+      episode.subtitles.count.should == 1
+      subs = (episode.subtitles.first.subtitles =~ /Ahora solo tengo que averiguar/) > 1
+      subs.should == true
+    end
+
+  end
+
+  context "Saving" do
+    it 'should save the subtitles to disk' do
+      sub_downloader = SubtitulosDownloader::SubtitulosDownloader.new
+      episode = sub_downloader.fetch('Fringe', 4, 7)
+      sub_downloader.save_subs_to_path(episode, '/tmp')
+      episode.subtitles.each do |sub|
+        exists = File.exists?('/tmp/' + sub.save_path)
+        exists.should == true
+      end
+    end
+  end
+end

data/spec/subtitulos_es_spec.rb

@@ -0,0 +1,94 @@
+# encoding: utf-8
+require 'spec_helper'
+
+
+describe SubtitulosDownloader::SubtitulosEs do
+
+  context "Fetching subtitles" do
+    before(:all) do
+      @ep = SubtitulosDownloader::ShowEpisode.new_from_file_name("Fringe.S04E07.HDTV.XviD-LOL.avi.avi")
+      @simpsons = SubtitulosDownloader::ShowEpisode.new_from_file_name("The Simpsons - 20x05 - Dangerous Curves")
+      @simpsons2 = SubtitulosDownloader::ShowEpisode.new_from_file_name("The Simpsons - 20x07 - Mypods and Boomsticks")
+      @provider = SubtitulosDownloader::SubtitulosEs.new()
+    end
+
+    it 'should fetch spanish subtitle' do
+      subtitle = @provider.fetch(@ep, 'es')
+      subtitle.language.should == 'es'
+      subtitle.show_episode.should == @ep
+      subs = (subtitle.subtitles =~ /Ahora solo tengo que averiguar/) > 1
+      subs.should == true
+    end
+
+    it 'should fetch english subtitle' do
+      subtitle = @provider.fetch(@ep, 'en')
+      subtitle.language.should == 'en'
+      subtitle.show_episode.should == @ep
+      subs = (subtitle.subtitles =~ /10-4. Copy location./) > 1
+      subs.should == true
+    end
+
+    it 'should fetch latinoamerican instead of spanish subtitles' do
+      subtitle = @provider.fetch(@simpsons, 'es')
+      subtitle.language.should == 'es'
+      subtitle.show_episode.should == @simpsons
+      subs = (subtitle.subtitles =~ /Tenemos cubos amarillos, cubos anaranjados/) > 1
+      subs.should == true
+    end
+
+    it 'should fetch español instead of spanish subtitles' do
+      subtitle = @provider.fetch(@simpsons2, 'es')
+      subtitle.language.should == 'es'
+      subtitle.show_episode.should == @simpsons2
+      subs = (subtitle.subtitles =~ /me gusta la forma de pensar de ustedes los italianos/) > 1
+      subs.should == true
+    end
+
+    it 'should fetch italian language' do
+      episode = SubtitulosDownloader::ShowEpisode.new('fringe', 3, 7)
+      subtitle = @provider.fetch(episode, 'italian')
+      subtitle.language.should == 'italian'
+      subtitle.show_episode.should == episode
+      subs = (subtitle.subtitles =~ /Quello che conta e' che sono nei guai./) > 1
+      subs.should == true
+    end
+  end
+
+  context "Rasing Exceptions" do 
+    before(:all) do
+      @provider = SubtitulosDownloader::SubtitulosEs.new()
+    end
+
+    it 'should raise a not show found exception' do
+      episode = SubtitulosDownloader::ShowEpisode.new('fake show', 2, 4)
+      lambda{@provider.fetch(episode, 'es')}.should raise_error(SubtitulosDownloader::ShowNotFound)
+    end
+
+    it 'should raise more than one show exception' do
+      episode = SubtitulosDownloader::ShowEpisode.new('the', 3, 4)
+      lambda{@provider.fetch(episode, 'es')}.should raise_error(SubtitulosDownloader::MoreThanOneShow)
+    end
+
+    it 'should raise season not found exception' do
+      episode = SubtitulosDownloader::ShowEpisode.new('the simpsons', 3, 4)
+      lambda{@provider.fetch(episode, 'es')}.should raise_error(SubtitulosDownloader::SeasonNotFound)
+    end
+
+    it 'should raise episode not found exception' do
+      episode = SubtitulosDownloader::ShowEpisode.new('the simpsons', 22, 34)
+      lambda{@provider.fetch(episode, 'es')}.should raise_error(SubtitulosDownloader::EpisodeNotFound)
+    end
+
+    it 'should raise episode not translated exception' do
+      episode = SubtitulosDownloader::ShowEpisode.new('the simpsons', 20, 1)
+      lambda{@provider.fetch(episode, 'galego')}.should raise_error(SubtitulosDownloader::TranslationNotFinished)
+    end
+
+     it 'should raise language not found exception' do
+      episode = SubtitulosDownloader::ShowEpisode.new('the simpsons', 20, 1)
+      lambda{@provider.fetch(episode, 'esperanto')}.should raise_error(SubtitulosDownloader::LanguageNotFound)
+    end
+
+
+  end
+end

data/subtitulos_downloader.gemspec

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "subtitulos_downloader/version"
+
+Gem::Specification.new do |s|
+  s.name        = "subtitulos_downloader"
+  s.version     = SubtitulosDownloader::VERSION
+  s.authors     = ["hector spc"]
+  s.email       = ["hector@aerstudio.com"]
+  s.homepage    = "https://github.com/hecspc/Subtitulos-Downloader"
+  s.summary     = "Fetch subtitles focused on spanish language"
+  s.description = "Fetch subtitles from different providers and save them to a given path"
+
+  s.rubyforge_project = "subtitulos_downloader"
+
+  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"]
+
+  # specify any dependencies here; for example:
+  s.add_development_dependency "rake"
+  s.add_development_dependency "rspec", "~>2.0"
+  # s.add_runtime_dependency "rest-client"
+  s.add_dependency("tvdb", ">= 0.1.0")
+  s.add_dependency("hpricot", ">= 0.8.4")
+  s.add_dependency("httparty", ">= 0.8.1")
+  s.add_dependency("prowler", ">= 1.3.1")
+end

metadata

@@ -0,0 +1,150 @@
+--- !ruby/object:Gem::Specification 
+name: subtitulos_downloader
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.5.1
+platform: ruby
+authors: 
+- hector spc
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-11-20 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rake
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  prerelease: false
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "2.0"
+  type: :development
+  prerelease: false
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: tvdb
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: hpricot
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.8.4
+  type: :runtime
+  prerelease: false
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.8.1
+  type: :runtime
+  prerelease: false
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: prowler
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.3.1
+  type: :runtime
+  prerelease: false
+  version_requirements: *id006
+description: Fetch subtitles from different providers and save them to a given path
+email: 
+- hector@aerstudio.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/subtitulos_downloader.rb
+- lib/subtitulos_downloader/exception.rb
+- lib/subtitulos_downloader/provider/provider.rb
+- lib/subtitulos_downloader/provider/subtitulos_es.rb
+- lib/subtitulos_downloader/show_episode.rb
+- lib/subtitulos_downloader/subtitle.rb
+- lib/subtitulos_downloader/version.rb
+- spec/show_episode_spec.rb
+- spec/spec_helper.rb
+- spec/subtitle_spec.rb
+- spec/subtitulos_downloader_spec.rb
+- spec/subtitulos_es_spec.rb
+- subtitulos_downloader.gemspec
+has_rdoc: true
+homepage: https://github.com/hecspc/Subtitulos-Downloader
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: -1979499645020437577
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: -1979499645020437577
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: subtitulos_downloader
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Fetch subtitles focused on spanish language
+test_files: 
+- spec/show_episode_spec.rb
+- spec/spec_helper.rb
+- spec/subtitle_spec.rb
+- spec/subtitulos_downloader_spec.rb
+- spec/subtitulos_es_spec.rb