AtomicTV 1.0.1

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

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

data/AtomicTV.gemspec

@@ -0,0 +1,85 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{AtomicTV}
+  s.version = "1.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Olly Legg"]
+  s.date = %q{2011-06-01}
+  s.description = %q{A command line tool to tag MP4 TV shows with metadata pulled from TheTVDB.com. It uses AtomicParsley to process the file.}
+  s.email = %q{olly@51degrees.net}
+  s.executables = ["AtomicTV"]
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "AtomicTV.gemspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "bin/AtomicTV",
+    "lib/AtomicTV.rb",
+    "lib/AtomicTV/atomic_parsley_tagger.rb",
+    "lib/AtomicTV/episode_metadata.rb",
+    "lib/AtomicTV/filename_parser.rb",
+    "lib/AtomicTV/tvdb_episode.rb",
+    "spec/AtomicTV/atomic_parsley_tagger_spec.rb",
+    "spec/AtomicTV/episode_metadata_spec.rb",
+    "spec/AtomicTV/filename_parser_spec.rb",
+    "spec/AtomicTV/tvdb_episode_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/olly/AtomicTV}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.7.2}
+  s.summary = %q{A command line tool to tag MP4 TV shows with metadata pulled from TheTVDB.com.}
+  s.test_files = [
+    "spec/AtomicTV/atomic_parsley_tagger_spec.rb",
+    "spec/AtomicTV/episode_metadata_spec.rb",
+    "spec/AtomicTV/filename_parser_spec.rb",
+    "spec/AtomicTV/tvdb_episode_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<plist>, ["= 3.1.0"])
+      s.add_runtime_dependency(%q<tvdb_party>, ["= 0.6.0"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<webmock>, ["~> 1.6.2"])
+    else
+      s.add_dependency(%q<plist>, ["= 3.1.0"])
+      s.add_dependency(%q<tvdb_party>, ["= 0.6.0"])
+      s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<webmock>, ["~> 1.6.2"])
+    end
+  else
+    s.add_dependency(%q<plist>, ["= 3.1.0"])
+    s.add_dependency(%q<tvdb_party>, ["= 0.6.0"])
+    s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<webmock>, ["~> 1.6.2"])
+  end
+end
+

data/Gemfile

@@ -0,0 +1,12 @@
+source "http://rubygems.org"
+
+gem "plist", "3.1.0"
+gem "tvdb_party", "0.6.0"
+
+group :development do
+  gem "rspec", "~> 2.3.0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.5.2"
+  gem "rcov", ">= 0"
+  gem "webmock", "~> 1.6.2"
+end

data/Gemfile.lock

@@ -0,0 +1,41 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.2.5)
+    crack (0.1.8)
+    diff-lcs (1.1.2)
+    git (1.2.5)
+    httparty (0.7.7)
+      crack (= 0.1.8)
+    jeweler (1.5.2)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    plist (3.1.0)
+    rake (0.8.7)
+    rcov (0.9.9)
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.0)
+    tvdb_party (0.6.0)
+      httparty (>= 0.6.1)
+    webmock (1.6.2)
+      addressable (>= 2.2.2)
+      crack (>= 0.1.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  jeweler (~> 1.5.2)
+  plist (= 3.1.0)
+  rcov
+  rspec (~> 2.3.0)
+  tvdb_party (= 0.6.0)
+  webmock (~> 1.6.2)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Oliver Legg
+
+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.rdoc

@@ -0,0 +1,19 @@
+= AtomicTV
+
+Description goes here.
+
+== Contributing to AtomicTV
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Oliver Legg. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,50 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "AtomicTV"
+  gem.homepage = "http://github.com/olly/AtomicTV"
+  gem.license = "MIT"
+  gem.summary = %Q{A command line tool to tag MP4 TV shows with metadata pulled from TheTVDB.com.}
+  gem.description = %Q{A command line tool to tag MP4 TV shows with metadata pulled from TheTVDB.com. It uses AtomicParsley to process the file.}
+  gem.email = "olly@51degrees.net"
+  gem.authors = ["Olly Legg"]
+  # Include your dependencies below. Runtime dependencies are required when using your gem,
+  # and development dependencies are only needed for development (ie running rake tasks, tests, etc)
+  #  gem.add_runtime_dependency 'jabber4r', '> 0.1'
+  #  gem.add_development_dependency 'rspec', '> 1.2.3'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "AtomicTV #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+1.0.1

data/bin/AtomicTV

@@ -0,0 +1,24 @@
+#!/usr/bin/env ruby -rubygems
+
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib', 'AtomicTV'))
+
+include AtomicTV
+
+def display_error(error)
+  $stderr.puts "! ERROR: #{error.human_message}"
+end
+
+ARGV.each do |path|
+  begin
+    file_path = Pathname.new(path)
+    metadata = TVDBEpisode.metadata_for_filename(file_path.basename)
+    tagger = AtomicParsleyTagger.new(file_path, metadata)
+    tagger.run
+    puts "* Tagged: #{file_path.basename}"
+  rescue AtomicParsleyTagger::AtomicParsleyUnavailable => error
+    display_error(error)
+    exit 1
+  rescue AtomicTVError => error
+    display_error(error)
+  end
+end

data/lib/AtomicTV.rb

@@ -0,0 +1,15 @@
+require 'fileutils'
+require 'open-uri'
+require 'pathname'
+require 'tmpdir'
+
+require 'plist'
+require 'tvdb_party'
+
+module AtomicTV
+  class AtomicTVError < StandardError; end
+end
+
+['atomic_parsley_tagger', 'episode_metadata', 'filename_parser', 'tvdb_episode'].each do |file|
+  require File.expand_path(File.join(File.dirname(__FILE__), 'AtomicTV', file))
+end

data/lib/AtomicTV/atomic_parsley_tagger.rb

@@ -0,0 +1,99 @@
+module AtomicTV
+  class AtomicParsleyTagger
+    
+    class AtomicParsleyUnavailable < ::AtomicTV::AtomicTVError
+      def human_message
+        'AtomicParsley is not installed or could not be found. Try checking your PATH.'
+      end
+    end
+    
+    class FileNotFound < ::AtomicTV::AtomicTVError
+      def initialize(file_path)
+        @file_path = file_path
+      end
+      
+      attr_reader :file_path
+      
+      def human_message
+        "File not found: #{file_path}"
+      end
+    end
+    
+    class TaggingError < ::AtomicTV::AtomicTVError
+      def initialize(command)
+        @command = command
+      end
+      
+      attr_reader :command
+      
+      def human_message
+        "A tagging error occured: #{command}."
+      end
+      
+    end
+    
+    def self.executable
+      path = Pathname.new(`which AtomicParsley`.chomp)
+      raise AtomicParsleyUnavailable unless path.executable?
+      path
+    end
+    
+    def initialize(file_path, metadata)
+      @file_path = file_path
+      raise FileNotFound.new(file_path) unless file_path.exist?
+      
+      @metadata = metadata
+    end
+    
+    def cast_metadata
+      format_names = lambda {|name| {'name' => name}}
+      {
+        'cast' => metadata.actors.map(&format_names),
+        'directors' => metadata.directors.map(&format_names),
+        'screenwriters' => metadata.writers.map(&format_names)
+      }.to_plist
+    end
+    
+    def run
+      options = {
+        'stik' => metadata.media_type,
+        'artist' => metadata.artist,
+        'title' => metadata.title,
+        'album' => metadata.album,
+        'genre' => metadata.genre,
+        'description' => metadata.description,
+        'longdesc' => metadata.long_description,
+        'TVNetwork' => metadata.tv_network,
+        'TVShowName' => metadata.tv_show_name,
+        'TVEpisode' => metadata.tv_episode,
+        'TVSeasonNum' => metadata.tv_season_number,
+        'TVEpisodeNum' => metadata.tv_episode_number,
+        'tracknum' => metadata.track_number,
+        'year' => metadata.air_date
+      }
+      
+      metadata.with_loaded_posters do
+        command =  %Q{#{self.class.executable} }
+        command << %Q{"#{file_path}" }
+        command << %Q{--overWrite }
+        command << %Q{--rDNSatom '#{cast_metadata}' name=iTunMOVI domain=com.apple.iTunes }
+        metadata.posters.each do |poster|
+          command << %Q{--artwork #{poster.path} }
+        end
+        command << options.map {|option, value| %Q{--#{option} "#{escape_double_quotes(value)}"}}.join(' ')
+        
+        `#{command}`
+        raise TaggingError.new(command) unless $?.success?
+      end
+    end
+    
+    private
+    
+    attr_reader :file_path, :metadata
+    
+    def escape_double_quotes(str)
+      str.gsub('"', '\"')
+    end
+    
+  end
+end

data/lib/AtomicTV/episode_metadata.rb

@@ -0,0 +1,111 @@
+module AtomicTV
+  class EpisodeMetadata
+    
+    ArtworkBaseURL = "http://thetvdb.com/banners/"
+    
+    def initialize(series, episode)
+      @series, @episode = series, episode
+    end
+    
+    attr_reader :series, :episode
+    
+    def media_type
+      'TV Show'
+    end
+    
+    def artist
+      series.name
+    end
+    
+    def title
+      episode.name
+    end
+    
+    def album
+      "#{series.name}, Season #{episode.season_number}"
+    end
+    
+    def genre
+      series.genres.first
+    end
+    
+    def description
+      episode.overview[0,255].gsub(/\.(.*)\Z/, '.')
+    end
+    
+    def long_description
+      episode.overview
+    end
+    
+    def tv_network
+      series.network
+    end
+    
+    def tv_show_name
+      series.name
+    end
+    
+    def tv_episode
+      "#{episode.season_number}#{episode.number.to_s.rjust(2, '0')}"
+    end
+    
+    def tv_season_number
+      episode.season_number
+    end
+    
+    def tv_episode_number
+      episode.number
+    end
+    
+    def track_number
+      episode.number
+    end
+    
+    def air_date
+      episode.air_date && episode.air_date.to_s + 'T00:00:00Z'
+    end
+    
+    def actors
+      (series.actors.map {|a| a.name} + episode.guest_stars).uniq
+    end
+    
+    def directors
+      parse_names(episode.director)
+    end
+    
+    def writers
+      parse_names(episode.writer)
+    end
+    
+    attr_reader :posters
+    
+    def with_loaded_posters
+      temporary_directory = Dir.mktmpdir
+      
+      @posters = series.season_posters(episode.season_number, 'en').map do |poster|
+        url = ArtworkBaseURL + poster.path
+        file = File.new(File.join(temporary_directory, File.basename(url)), 'w')
+        file.write(open(url).read)
+        file.close
+        file
+      end
+      
+      yield
+      
+    ensure
+      FileUtils.rm_rf(temporary_directory)
+      @posters = nil
+    end
+    
+    private
+    
+    def parse_names(str)
+      return [] if str.nil?
+      
+      str.gsub!(/\A\|/, '')
+      str.gsub!(/\|\Z/, '') 
+      str.split(/\|+/)
+    end
+    
+  end
+end

data/lib/AtomicTV/filename_parser.rb

@@ -0,0 +1,37 @@
+module AtomicTV
+  class FilenameParser
+    
+    class InvalidFilename < ::AtomicTV::AtomicTVError
+      def initialize(filename)
+        @filename = filename
+      end
+      
+      attr_reader :filename
+      
+      def human_message
+        "Invalid filename: #{filename} (filenames must be in the format: 'Series Name - S01E01')."
+      end
+    end
+    
+    FilenameFormat =  /\A(.*) - S(\d{2})E(\d{2})\.\w{3}\Z/
+    
+    def self.parse(filename)
+      if filename.to_s =~ FilenameFormat
+        new($1, $2.to_i(10), $3.to_i(10))
+      else
+        raise InvalidFilename.new(filename)
+      end
+    end
+    
+    attr_reader :series_name, :season_number, :episode_number
+    
+    private
+    
+    def initialize(series_name, season_number, episode_number)
+      @series_name = series_name
+      @season_number = season_number
+      @episode_number = episode_number
+    end
+    
+  end
+end

data/lib/AtomicTV/tvdb_episode.rb

@@ -0,0 +1,46 @@
+module AtomicTV
+  class TVDBEpisode
+    
+    class UnknownSeries < ::AtomicTV::AtomicTVError
+      def initialize(series_name)
+        @series_name = series_name
+      end
+      
+      attr_reader :series_name
+      
+      def human_message
+        "Unknown TV series: '#{series_name}'"
+      end
+    end
+    
+    class UnknownEpisode < ::AtomicTV::AtomicTVError
+      def initialize(series_name, season_number, episode_number)
+        @episode_id = "#{series_name} - S#{season_number.to_s.rjust(2, '0')}E#{episode_number.to_s.rjust(2, '0')}"
+      end
+      
+      attr_reader :episode_id
+      
+      def human_message
+        "Unknown episode: #{episode_id}"
+      end
+    end
+    
+    def self.metadata_for_filename(filename)
+      parser = FilenameParser.parse(filename)
+      search_results = client.search(parser.series_name)
+      raise UnknownSeries.new(parser.series_name) if search_results.empty?
+      
+      series = client.get_series_by_id(search_results.first['seriesid'])
+      episode = client.get_episode(series, parser.season_number, parser.episode_number)
+      raise UnknownEpisode.new(series.name, parser.season_number, parser.episode_number) if episode.nil?
+      return EpisodeMetadata.new(series, episode)
+    end
+    
+    private
+    
+    def self.client
+      @client ||= TvdbParty::Search.new('BD90B148E7D9E897', 'en')
+    end
+    
+  end
+end

data/spec/AtomicTV/atomic_parsley_tagger_spec.rb

@@ -0,0 +1,60 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+
+describe AtomicTV::AtomicParsleyTagger do
+  
+  describe ".executable" do
+    
+    before(:each) do
+      stub!(:`).and_return('')
+    end
+    
+    context "with AtomicParsley installed" do
+      
+      let(:executable_path) { stub(:executable? => true) }
+      
+      before(:each) do
+        Pathname.stub!(:new).and_return(executable_path)
+      end
+      
+      it "should return a pathname with executable's location" do
+        path = AtomicTV::AtomicParsleyTagger.executable
+        path.should == executable_path
+      end
+      
+    end
+    
+    context "without AtomicParsley installed" do
+      
+      before(:each) do
+        Pathname.stub!(:new).and_return(stub(:executable? => false))
+      end
+      
+      it "should raise a AtomicParsleyUnavailable error" do
+        expect {
+          AtomicTV::AtomicParsleyTagger.executable
+        }.to raise_error(AtomicTV::AtomicParsleyTagger::AtomicParsleyUnavailable)
+      end
+      
+    end
+    
+  end
+  
+  describe "#cast_metadata" do
+    
+    let(:file_path) { stub(:exist? => true) }
+    
+    let(:metadata) do
+      stub(
+        :actors => ['Actor 1', 'Actor 2'], 
+        :directors => ['Director 1', 'Director 2'], 
+        :writers => ['Writer 1', 'Writer 2']
+      )
+    end
+    
+    it "should generate a plist string from the actors, directors and writers" do
+      tagger = AtomicTV::AtomicParsleyTagger.new(file_path, metadata)
+      tagger.cast_metadata.should == "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<!DOCTYPE plist PUBLIC \"-//Apple Computer//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n<plist version=\"1.0\">\n<dict>\n\t<key>cast</key>\n\t<array>\n\t\t<dict>\n\t\t\t<key>name</key>\n\t\t\t<string>Actor 1</string>\n\t\t</dict>\n\t\t<dict>\n\t\t\t<key>name</key>\n\t\t\t<string>Actor 2</string>\n\t\t</dict>\n\t</array>\n\t<key>directors</key>\n\t<array>\n\t\t<dict>\n\t\t\t<key>name</key>\n\t\t\t<string>Director 1</string>\n\t\t</dict>\n\t\t<dict>\n\t\t\t<key>name</key>\n\t\t\t<string>Director 2</string>\n\t\t</dict>\n\t</array>\n\t<key>screenwriters</key>\n\t<array>\n\t\t<dict>\n\t\t\t<key>name</key>\n\t\t\t<string>Writer 1</string>\n\t\t</dict>\n\t\t<dict>\n\t\t\t<key>name</key>\n\t\t\t<string>Writer 2</string>\n\t\t</dict>\n\t</array>\n</dict>\n</plist>\n"
+    end
+  end
+  
+end

data/spec/AtomicTV/episode_metadata_spec.rb

@@ -0,0 +1,147 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+
+describe AtomicTV::EpisodeMetadata do
+  
+  let(:series) do
+    stub('Mock Series', 
+      :name => 'House', :network => 'FOX',
+      :genres => ['Drama'],
+      :artwork => [
+        stub('Artwork 1', :path => 'seasons/12345-7-1.jpg'), 
+        stub('Artwork 2', :path => 'seasons/12345-7-2.jpg')],
+      :actors => [
+        stub('Actor 1', :name => 'Hugh Laurie'),
+        stub('Actor 2', :name => 'Olivia Wilde'),
+        stub('Actor 3', :name => 'Amber Tamblyn')]
+    )
+  end
+  
+  let(:episode) do
+    stub('Mock Episode',
+      :name => 'Last Temptation',
+      :season_number => '7',
+      :number => '19',
+      :overview => %Q{Masters faces a career crossroads on her last day as a medical student and struggles with the choice to continue on the path to become a surgeon or to accept the rare opportunity to join House’s team officially. Meanwhile, the team treats a 16-year-old girl who inexplicably collapsed days before embarking on an ambitious sailing tour around the globe. Despite the patient's life-changing diagnosis, the patient's family insists on getting her back on the seas in time for her potentially record-breaking launch. But to the team's surprise, including House, Masters makes a bold decision regarding the patient’s treatment.},
+      :air_date => Date.new(2011, 4, 18),
+      :guest_stars => ['Amber Tamblyn', 'Ron Perkins', 'Jennifer Landon'],
+      :director => 'Tim Southam',
+      :writer => '|David Foster|Liz Friedman|'
+    )
+  end
+  
+  let(:metadata) { AtomicTV::EpisodeMetadata.new(series, episode) }
+  
+  context "with complete show information" do
+    
+    it "should return 'TV Show' for media_type" do
+      metadata.media_type.should == 'TV Show'
+    end
+    
+    it "should return the series name for artist" do
+      metadata.artist.should == 'House'
+    end
+    
+    it "should return the episode name for title" do
+      metadata.title.should == 'Last Temptation'
+    end
+    
+    it "should return the series name and season for album" do
+      metadata.album.should == 'House, Season 7'
+    end
+    
+    it "should return the first genre for genre" do
+      metadata.genre.should == 'Drama'
+    end
+    
+    it "should return the first 255 characters, trucated to a complete sentence, of the overview for description" do
+      metadata.description.should == 'Masters faces a career crossroads on her last day as a medical student and struggles with the choice to continue on the path to become a surgeon or to accept the rare opportunity to join House’s team officially.'
+    end
+    
+    it "should return the full overview for long description" do
+      metadata.long_description.should == %Q{Masters faces a career crossroads on her last day as a medical student and struggles with the choice to continue on the path to become a surgeon or to accept the rare opportunity to join House’s team officially. Meanwhile, the team treats a 16-year-old girl who inexplicably collapsed days before embarking on an ambitious sailing tour around the globe. Despite the patient's life-changing diagnosis, the patient's family insists on getting her back on the seas in time for her potentially record-breaking launch. But to the team's surprise, including House, Masters makes a bold decision regarding the patient’s treatment.}
+    end
+    
+    it "should return the series network for tv network" do
+      metadata.tv_network.should == 'FOX'
+    end
+    
+    it "should return the series name for tv show name" do
+      metadata.tv_show_name.should == 'House'
+    end
+    
+    it "should return the series number and episode number for tv episode" do
+      metadata.tv_episode.should == '719'
+    end
+    
+    it "should return the season number for tv season number" do
+      metadata.tv_season_number.should == '7'
+    end
+    
+    it "should return the episode number for tv episode number" do
+      metadata.tv_episode_number.should == '19'
+    end
+    
+    it "should return the episode number for track number" do
+      metadata.track_number.should == '19'
+    end
+    
+    it "should return a date with timezone for air date" do
+      metadata.air_date.should == '2011-04-18T00:00:00Z'
+    end
+    
+    it "should return series cast and guest cast for actors" do
+      metadata.actors.should =~ ['Hugh Laurie', 'Olivia Wilde', 'Amber Tamblyn', 'Ron Perkins', 'Jennifer Landon']
+    end
+    
+    it "should return the episode's directors for directors" do
+      metadata.directors.should =~ ['Tim Southam']
+    end
+    
+    it "should return the episode's writers for writers" do
+      metadata.writers.should =~ ['David Foster', 'Liz Friedman']
+    end
+    
+  end
+  
+  context "with a missing air date" do
+    
+    before(:each) do
+      episode.stub!(:air_date).and_return(nil)
+    end
+    
+    it "should return nil for air_date" do
+      metadata.air_date.should be_nil
+    end
+    
+  end
+  
+  context "with missing artwork" do
+    
+  end
+  
+  describe "#description" do
+    pending "more logic"
+  end
+  
+  describe "#tv_episode" do
+    
+    it "should format the episode number to two digits" do
+      episode.stub!(:number).and_return('2')
+      metadata.tv_episode.should == '702'
+    end
+    
+  end
+  
+  describe "#directors" do
+    pending "more logic"
+  end
+  
+  describe "#writers" do
+    pending "more logic"
+  end
+  
+  describe "#with_loaded_posters" do
+    pending
+  end
+  
+end

data/spec/AtomicTV/filename_parser_spec.rb

@@ -0,0 +1,46 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+
+describe AtomicTV::FilenameParser do
+  
+  describe ".parse" do
+    
+    context "with valid filenames" do
+      
+      let(:parser) { AtomicTV::FilenameParser.parse('Battlestar Galactica (2003) - S04E20.m4v') }
+      
+      it "should extract the series name" do
+        parser.series_name.should == 'Battlestar Galactica (2003)'
+      end
+      
+      it "should extract the season number" do
+        parser.season_number.should == 4
+      end
+      
+      it "should extract the episode number" do
+        parser.episode_number.should == 20
+      end
+    end
+    
+    context "with invalid filenames" do
+      
+      it "should raise an AtomicTV::FilenameParser::InvalidFilename error" do
+        expect {
+          AtomicTV::FilenameParser.parse('V for Vendetta (2006).m4v')
+        }.to raise_error(AtomicTV::FilenameParser::InvalidFilename)
+      end
+      
+      it "should expose the invalid filename in the error" do
+        invalid_filename = 'V for Vendetta (2006).m4v'
+        
+        begin
+          AtomicTV::FilenameParser.parse(invalid_filename)
+        rescue AtomicTV::FilenameParser::InvalidFilename => error
+          error.filename.should == invalid_filename
+        end
+      end
+      
+    end
+    
+  end
+  
+end

data/spec/AtomicTV/tvdb_episode_spec.rb

@@ -0,0 +1,98 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+
+WebMock.disable_net_connect!
+
+describe AtomicTV::TVDBEpisode do
+  
+  describe ".metadata_for_filename" do
+    
+    context "with a correct series, season and episode" do
+      
+      before(:each) do
+        @mock_parser = stub('Mock Parser', :series_name => 'The Wire', :season_number => 3, :episode_number => 6)
+        AtomicTV::FilenameParser.stub!(:parse).and_return(@mock_parser)
+        
+        @result1 = stub('Mock Search Result - 1', :[] => '123456789')
+        @result2 = stub('Mock Search Result - 2', :[] => '987654321')
+        @episode = stub('Mock Episode')
+        @mock_client = stub('Mock Client', :search => [@result1, @result2], :get_series_by_id => @result1, :get_episode => @episode)
+        AtomicTV::TVDBEpisode.stub!(:client).and_return(@mock_client)
+      end
+      
+      it "should search for the series using the name" do
+        @mock_client.should_receive(:search).with('The Wire')
+        
+        AtomicTV::TVDBEpisode.metadata_for_filename('The Wire - S03E06.m4v')
+      end
+      
+      it "should use the first search result as the series" do
+        @mock_client.should_receive(:get_series_by_id).with('123456789')
+        
+        AtomicTV::TVDBEpisode.metadata_for_filename('The Wire - S03E06.m4v')
+      end
+      
+      it "should return the correct episode for the series" do
+        @mock_client.should_receive(:get_episode).with(@result1, 3, 6)
+        
+        AtomicTV::TVDBEpisode.metadata_for_filename('The Wire - S03E06.m4v')
+      end
+      
+      it "should return an EpisodeMetadata instance for the episode" do
+        metadata = AtomicTV::TVDBEpisode.metadata_for_filename('The Wire - S03E06.m4v')
+        metadata.should be_kind_of(AtomicTV::EpisodeMetadata)
+        metadata.series.should == @result1
+        metadata.episode.should == @episode
+      end
+      
+    end
+    
+    context "with an unknown series" do
+      
+      before(:each) do
+        @mock_client = stub('Mock Client', :search => [])
+        AtomicTV::TVDBEpisode.stub!(:client).and_return(@mock_client)
+      end
+      
+      it "should raise an AtomicTV::TVDBEpisode::UnknownSeries error" do
+        expect {
+          AtomicTV::TVDBEpisode.metadata_for_filename('Teh Wires - S01E01.m4v')
+        }.to raise_error(AtomicTV::TVDBEpisode::UnknownSeries)
+      end
+      
+      it "should expose the invalid series name in the error" do
+        begin
+          AtomicTV::TVDBEpisode.metadata_for_filename('Teh Wires - S01E01.m4v')
+        rescue AtomicTV::TVDBEpisode::UnknownSeries => error
+          error.series_name.should == 'Teh Wires'
+        end
+      end
+      
+    end
+    
+    context "with an unknown episode" do
+      
+      before(:each) do
+        @series = stub('Mock Series', :[] => '1234789', :name => 'The Wire')
+        @mock_client = stub('Mock Client', :search => [@series], :get_series_by_id => @series, :get_episode => nil)
+        AtomicTV::TVDBEpisode.stub!(:client).and_return(@mock_client)
+      end
+      
+      it "should raise an AtomicTV::TVDBEpisode::UnknownEpisode error" do
+        expect {
+          AtomicTV::TVDBEpisode.metadata_for_filename('The Wire - S01E99.m4v')
+        }.to raise_error(AtomicTV::TVDBEpisode::UnknownEpisode)
+      end
+      
+      it "should expose the invalid episode ID in the error" do
+        begin
+          AtomicTV::TVDBEpisode.metadata_for_filename('The Wire - S01E99.m4v')
+        rescue AtomicTV::TVDBEpisode::UnknownEpisode => error
+          error.episode_id.should == 'The Wire - S01E99'
+        end
+      end
+      
+    end
+    
+  end
+  
+end

data/spec/spec_helper.rb

@@ -0,0 +1,13 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'webmock/rspec'
+require 'AtomicTV'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  
+end

metadata

@@ -0,0 +1,198 @@
+--- !ruby/object:Gem::Specification 
+name: AtomicTV
+version: !ruby/object:Gem::Version 
+  hash: 21
+  prerelease: 
+  segments: 
+  - 1
+  - 0
+  - 1
+  version: 1.0.1
+platform: ruby
+authors: 
+- Olly Legg
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-06-01 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 3
+        - 1
+        - 0
+        version: 3.1.0
+  name: plist
+  prerelease: false
+  type: :runtime
+  requirement: *id001
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 0
+        - 6
+        - 0
+        version: 0.6.0
+  name: tvdb_party
+  prerelease: false
+  type: :runtime
+  requirement: *id002
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 2
+        - 3
+        - 0
+        version: 2.3.0
+  name: rspec
+  prerelease: false
+  type: :development
+  requirement: *id003
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  name: bundler
+  prerelease: false
+  type: :development
+  requirement: *id004
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 1
+        - 5
+        - 2
+        version: 1.5.2
+  name: jeweler
+  prerelease: false
+  type: :development
+  requirement: *id005
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  name: rcov
+  prerelease: false
+  type: :development
+  requirement: *id006
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 11
+        segments: 
+        - 1
+        - 6
+        - 2
+        version: 1.6.2
+  name: webmock
+  prerelease: false
+  type: :development
+  requirement: *id007
+description: A command line tool to tag MP4 TV shows with metadata pulled from TheTVDB.com. It uses AtomicParsley to process the file.
+email: olly@51degrees.net
+executables: 
+- AtomicTV
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.rdoc
+files: 
+- .document
+- .rspec
+- AtomicTV.gemspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- bin/AtomicTV
+- lib/AtomicTV.rb
+- lib/AtomicTV/atomic_parsley_tagger.rb
+- lib/AtomicTV/episode_metadata.rb
+- lib/AtomicTV/filename_parser.rb
+- lib/AtomicTV/tvdb_episode.rb
+- spec/AtomicTV/atomic_parsley_tagger_spec.rb
+- spec/AtomicTV/episode_metadata_spec.rb
+- spec/AtomicTV/filename_parser_spec.rb
+- spec/AtomicTV/tvdb_episode_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/olly/AtomicTV
+licenses: 
+- MIT
+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: 
+rubygems_version: 1.7.2
+signing_key: 
+specification_version: 3
+summary: A command line tool to tag MP4 TV shows with metadata pulled from TheTVDB.com.
+test_files: 
+- spec/AtomicTV/atomic_parsley_tagger_spec.rb
+- spec/AtomicTV/episode_metadata_spec.rb
+- spec/AtomicTV/filename_parser_spec.rb
+- spec/AtomicTV/tvdb_episode_spec.rb
+- spec/spec_helper.rb