the_games_db 0.0.1

data/.gitignore

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

data/Gemfile

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

data/Guardfile

@@ -0,0 +1,11 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard 'rspec', :version => 2 do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^spec/support/(.+)\.rb$})                  { "spec" }
+  watch('spec/spec_helper.rb')                        { "spec" }
+end

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Jared Pace
+
+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,77 @@
+TheGamesDB: Ruby API Client
+===========================
+
+Simple API wrapper for TheGamesDB.net.
+
+Installation
+------------
+
+```bash
+gem install the_games_db
+```
+
+
+Usage
+-----
+
+```ruby
+require 'the_games_db'
+mario_games = TheGamesDB::Game.search :name => 'Super Mario Bros'
+mario_games.first.title
+ => "New Super Mario Bros."
+
+smb3 = TheGamesDB::Game.find 112
+smb3.title
+ => "Super Mario Bros. 3"
+smb3.platform
+ => "Nintendo Entertainment System (NES)"
+front_boxart = smb3.boxarts.detect {|boxart| boxart.side == "front"}
+front_boxart.url
+ => "http://thegamesdb.net/banners/boxart/original/front/112-2.jpg"
+```
+
+
+Available Properties
+--------------------
+
+    game.id
+    game.title
+    game.overview
+    game.platform
+    game.esrb
+    game.players
+    game.cooperative
+    game.publisher
+    game.developer
+    game.release_date
+    game.rating
+    game.youtube_video
+    game.genres
+    game.banners
+      banner.width
+      banner.height
+      banner.path
+    game.boxarts
+      boxart.width
+      boxart.height
+      boxart.side
+      boxart.path
+    game.fanarts
+      fanart.original.width
+      fanart.original.height
+      fanart.original.path
+      fanart.vignette.width
+      fanart.vignette.height
+      fanart.vignette.path
+      fanart.thumb.path
+    game.screenshots
+      screenshot.original.width
+      screenshot.original.height
+      screenshot.original.path
+      screenshot.thumb.path
+
+
+Copyright
+---------
+
+Copyright (c) 2010 Jared Pace. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,5 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+task :default => :spec

data/lib/the_games_db.rb

@@ -0,0 +1,11 @@
+require 'typhoeus'
+require 'sax-machine'
+
+require 'the_games_db/version'
+require 'the_games_db/exception'
+require 'the_games_db/image/banner'
+require 'the_games_db/image/boxart'
+require 'the_games_db/image/fanart'
+require 'the_games_db/image/screenshot'
+require 'the_games_db/game'
+require 'the_games_db/feed'

data/lib/the_games_db/exception.rb

@@ -0,0 +1,17 @@
+module TheGamesDB
+  module Exception
+
+    class BadResponse < StandardError
+      def initialize(message)
+        super "Error Fetching Data from TheGamesDB: #{message}"
+      end
+    end
+
+    class GameNotFound < StandardError
+      def initialize(id)
+        super "Game Not Found: id = #{id}"
+      end
+    end
+
+  end
+end

data/lib/the_games_db/feed.rb

@@ -0,0 +1,31 @@
+module TheGamesDB
+  class Feed
+    include SAXMachine
+
+    BaseApiUrl = "http://thegamesdb.net/api/"
+    Timeout = 10_000 # milliseconds
+
+    element  :baseImgUrl, :as => :base_image_url
+    elements :Game, :as => :games, :class => TheGamesDB::Game
+
+    def self.fetch_and_parse(path, params={})
+      parse fetch(path, params)
+    end
+
+    def self.fetch(path, params={})
+      response = Typhoeus::Request.get(api_url(path), :params => params, :timeout => Timeout)
+
+      bad_response!(response) unless response.success?
+      response.body
+    end
+
+    def self.api_url(path)
+      BaseApiUrl + path
+    end
+
+    def self.bad_response!(response)
+      raise TheGamesDB::Exception::BadResponse.new(response.curl_error_message)
+    end
+
+  end
+end

data/lib/the_games_db/game.rb

@@ -0,0 +1,47 @@
+require 'date'
+
+module TheGamesDB
+  class Game
+    include SAXMachine
+
+    parent   :feed
+    element  :id
+    element  :GameTitle,   :as => :title
+    element  :Overview,    :as => :overview
+    element  :Platform,    :as => :platform
+    element  :ESRB,        :as => :esrb
+    element  :Players,     :as => :players
+    element  :'Co-op',     :as => :cooperative
+    element  :Publisher,   :as => :publisher
+    element  :Developer,   :as => :developer
+    element  :ReleaseDate, :as => :release_date
+    element  :Rating,      :as => :rating
+    element  :Youtube,     :as => :youtube_video
+    elements :genre,       :as => :genres
+    elements :banner,      :as => :banners, :class => TheGamesDB::Image::Banner
+    elements :boxart,      :as => :boxarts, :class => TheGamesDB::Image::Boxart
+    elements :fanart,      :as => :fanarts, :class => TheGamesDB::Image::Fanart
+    elements :screenshot,  :as => :screenshots, :class => TheGamesDB::Image::Screenshot
+
+    attr_accessor :feed
+
+    def self.search(params = {})
+      feed = TheGamesDB::Feed.fetch_and_parse('GetGamesList.php', params)
+      feed.games
+    end
+
+    def self.find(id)
+      feed = TheGamesDB::Feed.fetch_and_parse('GetGame.php', :id => id)
+
+      feed.games.first || raise(TheGamesDB::Exception::GameNotFound.new id)
+    end
+
+    def release_date
+      return unless @release_date
+
+      month, day, year = @release_date.split('/').map(&:to_i)
+      Date.civil year, month, day
+    end
+
+  end
+end

data/lib/the_games_db/image/banner.rb

@@ -0,0 +1,25 @@
+module TheGamesDB
+  module Image
+    class Banner
+      include SAXMachine
+
+      parent :game
+      value :path
+      attribute :width
+      attribute :height
+
+      def url
+        game.feed.base_image_url + path
+      end
+
+      def width
+        @width.to_i
+      end
+
+      def height
+        @height.to_i
+      end
+
+    end
+  end
+end

data/lib/the_games_db/image/boxart.rb

@@ -0,0 +1,26 @@
+module TheGamesDB
+  module Image
+    class Boxart
+      include SAXMachine
+
+      parent :game
+      value :path
+      attribute :side
+      attribute :width
+      attribute :height
+
+      def url
+        game.feed.base_image_url + path
+      end
+
+      def width
+        @width.to_i
+      end
+
+      def height
+        @height.to_i
+      end
+
+    end
+  end
+end

data/lib/the_games_db/image/fanart.rb

@@ -0,0 +1,14 @@
+require 'the_games_db/image/format'
+
+module TheGamesDB
+  module Image
+    class Fanart
+      include SAXMachine
+
+      parent  :game
+      element :original, :class => TheGamesDB::Image::Format
+      element :vignette, :class => TheGamesDB::Image::Format
+      element :thumb,    :class => TheGamesDB::Image::Format
+    end
+  end
+end

data/lib/the_games_db/image/format.rb

@@ -0,0 +1,25 @@
+module TheGamesDB
+  module Image
+    class Format
+      include SAXMachine
+
+      parent :image
+      value :path
+      attribute :width
+      attribute :height
+
+      def url
+        image.game.feed.base_image_url + path
+      end
+
+      def width
+        @width.to_i
+      end
+
+      def height
+        @height.to_i
+      end
+
+    end
+  end
+end

data/lib/the_games_db/image/screenshot.rb

@@ -0,0 +1,13 @@
+require 'the_games_db/image/format'
+
+module TheGamesDB
+  module Image
+    class Screenshot
+      include SAXMachine
+
+      parent  :game
+      element :original, :class => TheGamesDB::Image::Format
+      element :thumb,    :class => TheGamesDB::Image::Format
+    end
+  end
+end

data/lib/the_games_db/version.rb

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

data/spec/fixtures/game.xml

@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+
+<Data>
+  <baseImgUrl>http://thegamesdb.net/banners/</baseImgUrl>
+  <Game>
+    <id>140</id>
+    <GameTitle>Super Mario Bros.</GameTitle>
+    <Platform>Nintendo Entertainment System (NES)</Platform>
+    <ReleaseDate>09/13/1985</ReleaseDate>
+    <Overview>The player takes the role of Mario, or in the case of a second player, Mario's brother Luigi. The ultimate objective is to race through the worlds of the Mushroom Kingdom, evade or eliminate Bowser's forces, and save the Princess</Overview>
+    <ESRB>E - Everyone</ESRB>
+    <Genres>
+      <genre>Adventure</genre>
+      <genre>Platform</genre>
+    </Genres>
+    <Players>2</Players>
+    <Co-op>No</Co-op>
+    <Publisher>Nintendo</Publisher>
+    <Developer>Nintendo</Developer>
+    <Actors>N/A</Actors>
+    <Images>
+      <fanart>
+        <original width="1920" height="1080">fanart/original/140-1.jpg</original>
+        <vignette width="1920" height="1080">fanart/vignette/140-1.jpg</vignette>
+        <thumb>fanart/thumb/140-1.jpg</thumb>
+      </fanart>
+      <fanart>
+        <original width="1920" height="1080">fanart/original/140-10.jpg</original>
+        <vignette width="1920" height="1080">fanart/vignette/140-10.jpg</vignette>
+        <thumb>fanart/thumb/140-10.jpg</thumb>
+      </fanart>
+      <fanart>
+        <original width="1920" height="1080">fanart/original/140-2.jpg</original>
+        <vignette width="1920" height="1080">fanart/vignette/140-2.jpg</vignette>
+        <thumb>fanart/thumb/140-2.jpg</thumb>
+      </fanart>
+      <fanart>
+        <original width="1920" height="1080">fanart/original/140-3.jpg</original>
+        <vignette width="1920" height="1080">fanart/vignette/140-3.jpg</vignette>
+        <thumb>fanart/thumb/140-3.jpg</thumb>
+      </fanart>
+      <fanart>
+        <original width="1920" height="1080">fanart/original/140-4.jpg</original>
+        <vignette width="1920" height="1080">fanart/vignette/140-4.jpg</vignette>
+        <thumb>fanart/thumb/140-4.jpg</thumb>
+      </fanart>
+      <fanart>
+        <original width="1920" height="1080">fanart/original/140-5.jpg</original>
+        <vignette width="1920" height="1080">fanart/vignette/140-5.jpg</vignette>
+        <thumb>fanart/thumb/140-5.jpg</thumb>
+      </fanart>
+      <fanart>
+        <original width="1920" height="1080">fanart/original/140-6.jpg</original>
+        <vignette width="1920" height="1080">fanart/vignette/140-6.jpg</vignette>
+        <thumb>fanart/thumb/140-6.jpg</thumb>
+      </fanart>
+      <fanart>
+        <original width="1920" height="1080">fanart/original/140-7.jpg</original>
+        <vignette width="1920" height="1080">fanart/vignette/140-7.jpg</vignette>
+        <thumb>fanart/thumb/140-7.jpg</thumb>
+      </fanart>
+      <fanart>
+        <original width="1920" height="1080">fanart/original/140-8.jpg</original>
+        <vignette width="1920" height="1080">fanart/vignette/140-8.jpg</vignette>
+        <thumb>fanart/thumb/140-8.jpg</thumb>
+      </fanart>
+      <fanart>
+        <original width="1920" height="1080">fanart/original/140-9.jpg</original>
+        <vignette width="1920" height="1080">fanart/vignette/140-9.jpg</vignette>
+        <thumb>fanart/thumb/140-9.jpg</thumb>
+      </fanart>
+      <boxart side="front" width="709" height="1000">boxart/original/front/140-1.jpg</boxart>
+      <boxart side="back" width="1532" height="2100">boxart/original/back/140-2.jpg</boxart>
+      <banner width="760" height="140">graphical/140-g.jpg</banner>
+      <banner width="760" height="140">graphical/140-g2.jpg</banner>
+      <banner width="760" height="140">graphical/140-g3.jpg</banner>
+      <screenshot>
+        <original width="256" height="232">screenshots/140-1.jpg</original>
+        <thumb>screenshots/thumb/140-1.jpg</thumb>
+      </screenshot>
+    </Images>
+  </Game>
+</Data>

data/spec/fixtures/games.xml

@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+
+<Data>
+  <Game>
+    <id>6859</id>
+    <GameTitle>New Super Mario Bros.</GameTitle>
+    <Platform>Nintendo DS</Platform>
+  </Game>
+  <Game>
+    <id>170</id>
+    <GameTitle>New Super Mario Bros. Wii</GameTitle>
+    <ReleaseDate>11/20/2009</ReleaseDate>
+    <Platform>Nintendo Wii</Platform>
+  </Game>
+    <Game>
+    <id>140</id>
+    <GameTitle>Super Mario Bros.</GameTitle>
+    <ReleaseDate>09/13/1985</ReleaseDate>
+    <Platform>Nintendo Entertainment System (NES)</Platform>
+  </Game>
+  <Game>
+  <id>3727</id>
+  <GameTitle>Super Mario Bros.</GameTitle>
+  <Platform>Nintendo Gameboy Advance</Platform>
+  </Game>
+  <Game>
+    <id>6410</id>
+    <GameTitle>Super Mario Bros. / Duck Hunt</GameTitle>
+    <ReleaseDate>07/26/1988</ReleaseDate>
+    <Platform>Nintendo Entertainment System (NES)</Platform>
+  </Game>
+  <Game>
+    <id>171</id>
+    <GameTitle>Super Mario Bros. 2</GameTitle>
+    <ReleaseDate>10/01/1988</ReleaseDate>
+    <Platform>Nintendo Entertainment System (NES)</Platform>
+  </Game>
+  <Game>
+    <id>112</id>
+    <GameTitle>Super Mario Bros. 3</GameTitle>
+    <ReleaseDate>10/23/1988</ReleaseDate>
+    <Platform>Nintendo Entertainment System (NES)</Platform>
+  </Game>
+</Data>

data/spec/spec_helper.rb

@@ -0,0 +1,19 @@
+require 'pathname'
+require 'rspec'
+require 'rspec/autorun'
+require 'mocha'
+
+SpecRoot = Pathname.new File.expand_path('..', __FILE__)
+$LOAD_PATH.unshift(SpecRoot)
+$LOAD_PATH.unshift(File.join(SpecRoot, '..', 'lib'))
+
+require 'the_games_db'
+
+RSpec.configure do |config|
+  config.color_enabled = true
+  config.filter_run :focused => true
+  config.run_all_when_everything_filtered = true
+  config.alias_example_to :fit, :focused => true
+  config.alias_example_to :they
+  config.mock_with :mocha
+end

data/spec/the_games_db/feed_spec.rb

@@ -0,0 +1,69 @@
+require 'spec_helper'
+
+describe TheGamesDB::Feed do
+
+  let(:xml) { SpecRoot.join('fixtures', 'game.xml').read }
+
+  context ".fetch" do
+    context 'when the request was successful' do
+      before do
+        expected_url = "http://thegamesdb.net/api/GetGame.php"
+        successful_response = stub 'response', :success? => true, :body => xml
+        Typhoeus::Request.expects(:get).
+          with(expected_url, :params => {:id => 140}, :timeout => TheGamesDB::Feed::Timeout).
+          returns(successful_response)
+      end
+
+      it 'returns the XML response' do
+        TheGamesDB::Feed.fetch('GetGame.php', :id => 140).should == xml
+      end
+    end
+
+    context 'when the request was unsuccessful' do
+      let(:xml) { SpecRoot.join('fixtures', 'game.xml').read }
+      before do
+        expected_url = "http://thegamesdb.net/api/GetGame.php"
+        error_response = stub 'response', :success? => false, :code => 500, :curl_error_message => '500'
+        Typhoeus::Request.expects(:get).
+          with(expected_url, :params => {:id => 140}, :timeout => TheGamesDB::Feed::Timeout).
+          returns(error_response)
+      end
+
+      it 'raises an exception' do
+        expect do
+          TheGamesDB::Feed.fetch('GetGame.php', :id => 140)
+        end.should raise_error(TheGamesDB::Exception::BadResponse)
+      end
+    end
+
+    context 'when the request times out' do
+      let(:xml) { SpecRoot.join('fixtures', 'game.xml').read }
+      before do
+        expected_url = "http://thegamesdb.net/api/GetGame.php"
+        error_response = stub 'response', :success? => false, :timed_out? => true, :curl_error_message => 'Timed out'
+        Typhoeus::Request.expects(:get).
+          with(expected_url, :params => {:id => 140}, :timeout => TheGamesDB::Feed::Timeout).
+          returns(error_response)
+      end
+
+      it 'raises an exception' do
+        expect do
+          TheGamesDB::Feed.fetch('GetGame.php', :id => 140)
+        end.should raise_error(TheGamesDB::Exception::BadResponse)
+      end
+    end
+  end
+
+  context '.fetch_and_parse' do
+    before do
+      TheGamesDB::Feed.expects(:fetch).with('GetGame.php', :id => 140).returns(xml)
+    end
+
+    it 'parses the XML response' do
+      feed = TheGamesDB::Feed.fetch_and_parse 'GetGame.php', :id => 140
+      feed.base_image_url.should == "http://thegamesdb.net/banners/"
+      feed.games.should_not be_empty
+    end
+  end
+
+end

data/spec/the_games_db/game_spec.rb

@@ -0,0 +1,81 @@
+require 'spec_helper'
+
+describe TheGamesDB::Game do
+
+  context '.search' do
+    it 'hits the GetGamesList API endpoint' do
+      TheGamesDB::Feed.expects(:fetch_and_parse).with('GetGamesList.php', :name => 'Mario').returns(stub_everything)
+      TheGamesDB::Game.search(:name => 'Mario')
+    end
+  end
+
+  context '.find' do
+    it 'hits the GetGame API endpoint' do
+      feed = stub 'feed', :games => [stub('game')]
+      TheGamesDB::Feed.expects(:fetch_and_parse).with('GetGame.php', :id => 140).returns(feed)
+      TheGamesDB::Game.find 140
+    end
+
+    context 'when the game is found' do
+      let(:game) { stub 'game' }
+
+      before do
+        feed = stub 'feed', :games => [game]
+        TheGamesDB::Feed.expects(:fetch_and_parse).returns(feed)
+      end
+
+      it 'returns the game' do
+        TheGamesDB::Game.find(140).should == game
+      end
+    end
+
+    context 'when the game is not found' do
+      before do
+        feed = stub 'feed', :games => []
+        TheGamesDB::Feed.expects(:fetch_and_parse).returns(feed)
+      end
+
+      it 'raises a not found error' do
+        expect do
+          TheGamesDB::Game.find(-1)
+        end.should raise_error(TheGamesDB::Exception::GameNotFound)
+      end
+    end
+  end
+
+  context 'when parsed' do
+    before do
+      game_xml = SpecRoot.join 'fixtures', 'game.xml'
+      TheGamesDB::Feed.stubs(:fetch).returns(game_xml.read)
+    end
+
+    let(:game) { TheGamesDB::Game.find 140 }
+
+    it 'correctly parses the values' do
+      game.id.should == "140"
+      game.title.should == "Super Mario Bros."
+      game.overview.should =~ /^The player takes the role of Mario/
+      game.platform.should == "Nintendo Entertainment System (NES)"
+      game.esrb.should == "E - Everyone"
+      game.players.should == "2"
+      game.cooperative.should == "No"
+      game.publisher.should == "Nintendo"
+      game.developer.should == "Nintendo"
+      game.release_date.should == Date.parse("September 13, 1985")
+      game.genres.should include('Adventure', 'Platform')
+
+      game.banners.should_not be_empty
+      game.banners.first.should be_a TheGamesDB::Image::Banner
+
+      game.boxarts.should_not be_empty
+      game.boxarts.first.should be_a TheGamesDB::Image::Boxart
+
+      game.fanarts.should_not be_empty
+      game.fanarts.first.should be_a TheGamesDB::Image::Fanart
+
+      game.screenshots.should_not be_empty
+      game.screenshots.first.should be_a TheGamesDB::Image::Screenshot
+    end
+  end
+
+end

data/spec/the_games_db/image/banner_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+describe TheGamesDB::Image::Banner do
+
+  before do
+    game_xml = SpecRoot.join 'fixtures', 'game.xml'
+    TheGamesDB::Feed.stubs(:fetch).returns(game_xml.read)
+  end
+
+  let(:game)   { TheGamesDB::Game.find 140 }
+  let(:banner) { game.banners.first }
+
+  it 'is parsed correctly' do
+    banner.width.should == 760
+    banner.height.should == 140
+    banner.path.should == "graphical/140-g.jpg"
+  end
+
+  context '#url' do
+    it 'is composed of the base image url and the path' do
+      banner.url.should == 'http://thegamesdb.net/banners/graphical/140-g.jpg'
+    end
+  end
+
+end

data/spec/the_games_db/image/boxart_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe TheGamesDB::Image::Boxart do
+
+  before do
+    game_xml = SpecRoot.join 'fixtures', 'game.xml'
+    TheGamesDB::Feed.stubs(:fetch).returns(game_xml.read)
+  end
+
+  let(:game)   { TheGamesDB::Game.find 140 }
+  let(:boxart) { game.boxarts.first }
+
+  it 'is parsed correctly' do
+    boxart.side.should == "front"
+    boxart.width.should == 709
+    boxart.height.should == 1000
+    boxart.path.should == "boxart/original/front/140-1.jpg"
+  end
+
+  context '#url' do
+    it 'is composed of the base image url and the path' do
+      boxart.url.should == 'http://thegamesdb.net/banners/boxart/original/front/140-1.jpg'
+    end
+  end
+
+end

data/spec/the_games_db/image/fanart_spec.rb

@@ -0,0 +1,36 @@
+require 'spec_helper'
+
+describe TheGamesDB::Image::Fanart do
+
+  before do
+    game_xml = SpecRoot.join 'fixtures', 'game.xml'
+    TheGamesDB::Feed.stubs(:fetch).returns(game_xml.read)
+  end
+
+  let(:game)   { TheGamesDB::Game.find 140 }
+  let(:fanart) { game.fanarts.first }
+
+  it 'is parsed correctly' do
+    fanart.original.should_not be_nil
+    fanart.original.width.should == 1920
+    fanart.original.height.should == 1080
+    fanart.original.path.should == 'fanart/original/140-1.jpg'
+
+    fanart.vignette.should_not be_nil
+    fanart.vignette.width.should == 1920
+    fanart.vignette.height.should == 1080
+    fanart.vignette.path.should == 'fanart/vignette/140-1.jpg'
+
+    fanart.thumb.should_not be_nil
+    fanart.thumb.path.should == 'fanart/thumb/140-1.jpg'
+  end
+
+  context '#url' do
+    it 'is composed of the base image url and the path' do
+      fanart.original.url.should == 'http://thegamesdb.net/banners/fanart/original/140-1.jpg'
+      fanart.vignette.url.should == 'http://thegamesdb.net/banners/fanart/vignette/140-1.jpg'
+      fanart.thumb.url.should == 'http://thegamesdb.net/banners/fanart/thumb/140-1.jpg'
+    end
+  end
+
+end

data/spec/the_games_db/image/screenshot_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+describe TheGamesDB::Image::Screenshot do
+
+  before do
+    game_xml = SpecRoot.join 'fixtures', 'game.xml'
+    TheGamesDB::Feed.stubs(:fetch).returns(game_xml.read)
+  end
+
+  let(:game)   { TheGamesDB::Game.find 140 }
+  let(:screenshot) { game.screenshots.first }
+
+  it 'is parsed correctly' do
+    screenshot.original.should_not be_nil
+    screenshot.original.width.should == 256
+    screenshot.original.height.should == 232
+    screenshot.original.path.should == 'screenshots/140-1.jpg'
+
+    screenshot.thumb.should_not be_nil
+    screenshot.thumb.path.should == 'screenshots/thumb/140-1.jpg'
+  end
+
+  context '#url' do
+    it 'is composed of the base image url and the path' do
+      screenshot.original.url.should == 'http://thegamesdb.net/banners/screenshots/140-1.jpg'
+      screenshot.thumb.url.should == 'http://thegamesdb.net/banners/screenshots/thumb/140-1.jpg'
+    end
+  end
+
+end

data/the_games_db.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "the_games_db/version"
+
+Gem::Specification.new do |s|
+  s.name        = "the_games_db"
+  s.version     = TheGamesDB::VERSION
+  s.authors     = ["Jared Pace"]
+  s.email       = ["jared@codeword.io"]
+  s.homepage    = "https://github.com/jdpace/the_games_db"
+  s.summary     = %q{TheGamesDB.net API wrapper}
+  s.description = %q{Ruby API Wrapper for TheGamesDB.net}
+
+  s.rubyforge_project = "the_games_db"
+
+  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"]
+
+  # Dependencies
+  s.add_dependency 'typhoeus', ['~> 0.2.4']
+  s.add_dependency 'nokogiri', ['~> 1.4.6']
+  s.add_dependency 'sax-machine', ['~> 0.0.20']
+
+  # Developmnet Dependencies
+  s.add_development_dependency 'rspec', ['~> 2.6']
+  s.add_development_dependency 'mocha', ['~> 0.9.12']
+  s.add_development_dependency 'guard-rspec', ['~> 0.4']
+end

metadata

@@ -0,0 +1,155 @@
+--- !ruby/object:Gem::Specification 
+name: the_games_db
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Jared Pace
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-09-23 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: typhoeus
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.2.4
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.4.6
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: sax-machine
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.0.20
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "2.6"
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: mocha
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.9.12
+  type: :development
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: guard-rspec
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "0.4"
+  type: :development
+  version_requirements: *id006
+description: Ruby API Wrapper for TheGamesDB.net
+email: 
+- jared@codeword.io
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Guardfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/the_games_db.rb
+- lib/the_games_db/exception.rb
+- lib/the_games_db/feed.rb
+- lib/the_games_db/game.rb
+- lib/the_games_db/image/banner.rb
+- lib/the_games_db/image/boxart.rb
+- lib/the_games_db/image/fanart.rb
+- lib/the_games_db/image/format.rb
+- lib/the_games_db/image/screenshot.rb
+- lib/the_games_db/version.rb
+- spec/fixtures/game.xml
+- spec/fixtures/games.xml
+- spec/spec_helper.rb
+- spec/the_games_db/feed_spec.rb
+- spec/the_games_db/game_spec.rb
+- spec/the_games_db/image/banner_spec.rb
+- spec/the_games_db/image/boxart_spec.rb
+- spec/the_games_db/image/fanart_spec.rb
+- spec/the_games_db/image/screenshot_spec.rb
+- the_games_db.gemspec
+has_rdoc: true
+homepage: https://github.com/jdpace/the_games_db
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: the_games_db
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: TheGamesDB.net API wrapper
+test_files: 
+- spec/fixtures/game.xml
+- spec/fixtures/games.xml
+- spec/spec_helper.rb
+- spec/the_games_db/feed_spec.rb
+- spec/the_games_db/game_spec.rb
+- spec/the_games_db/image/banner_spec.rb
+- spec/the_games_db/image/boxart_spec.rb
+- spec/the_games_db/image/fanart_spec.rb
+- spec/the_games_db/image/screenshot_spec.rb