giantbomb-api 1.5.7

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 032b2d2f6dabd3c02d3816ffba774a88d3d3a7e2
+  data.tar.gz: 6beefb52f5e58d0aff73c087c147f1b394f35ccf
+SHA512:
+  metadata.gz: c2fd4be30245fac477442acda251ca472f60501e8d0e6d4f27167b187e5124b8319d6c8e7f20ffaaa3ad082d196278d9a12d3e76423e1b3f79ba8fbb3e539057
+  data.tar.gz: a6d899ca0572a4ed456a978c13a3e8843a5373cb1e1dee7b6a6073098950a7288a7517491e9494b69fe43199f41ca94d3d4eca1eafba298dcbf6e38a6a88a573

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

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

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 2.0.0
+
+before_install: gem install bundler -v 1.10.6

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Vlad Radulescu
+
+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,93 @@
+## A Ruby wrapper for the GiantBomb API
+
+All credits goes to [intelekshual](https://github.com/intelekshual) for creating
+mostly everything :)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'giantbomb'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install giantbomb
+
+In your Rails application, add your API key to:
+`config/initializers/giantbomb.rb`
+
+``` ruby
+GiantBomb::Api.key('API_KEY_HERE')
+```
+
+### Resources
+
+Current available resources:
+* Character
+* Company
+* Concept
+* Franchise
+* Game
+* Location
+* Person
+* Platform
+* Video
+
+All resources have access to `Resource#list` `Resource#detail` and `Resource#search`
+
+### Usage
+
+###### Finding a Game
+
+``` ruby
+game = GiantBomb::Game.detail(1)
+
+games = GiantBomb::Game.find('gta')
+games = GiantBomb::Game.list
+```
+
+###### Searching for Games
+
+``` ruby
+search = GiantBomb::Search.new
+search.query('gta')
+search.fetch
+```
+
+``` ruby
+# Available filter methods
+
+.limit(10)           # limits the number of returned resources
+.resources('game')   # determines the type of resource
+.fields('name,deck') # returns only the requested resources
+.offset(100)         # sets the offset
+
+# All filters are chainable!
+```
+
+### Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run
+`rake spec` to run the tests. You can also run `bin/console` for an interactive
+prompt that will allow you to experiment.
+
+###### TODO
+
+* Add all resources available from: http://www.giantbomb.com/api/documentation
+* Create a proper documentation showcasing all available resources and how to use them
+* Tests
+
+### Examples
+
+For more examples see [mygames.io](https://github.com/pacMakaveli/mygames.io)
+for a live application
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

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

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "giantbomb"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/giantbomb.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+require './lib/giantbomb/version'
+
+Gem::Specification.new do |g|
+  g.name        = "giantbomb-api"
+  g.version     = GiantBomb::VERSION
+  g.platform    = Gem::Platform::RUBY
+  g.date        = Date.today.to_s
+
+  g.authors     = ["Robert Coker", "Vlad Radulescu"]
+  g.email       = ["rob@robertsays.com", "pacMakaveli90@gmail.com"]
+
+  g.homepage    = "http://rubygems.org/gems/giantbomb-api"
+  g.summary     = %q{A Ruby wrapper for the GiantBomb video game wiki API.}
+  g.description = %q{Provides a simple, easy to use interface for the Giant Bomb video game wiki API.}
+
+  g.add_dependency("httparty")
+
+  g.files         = `git ls-files`.split("\n")
+  g.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  g.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  g.require_paths = ["lib"]
+end

data/lib/giantbomb.rb

@@ -0,0 +1,25 @@
+require 'rubygems'
+require 'httparty'
+
+require 'giantbomb/version'
+
+module GiantBomb
+
+  ['api', 'search', 'resource'].each do |inc|
+    require File.join(File.dirname(__FILE__), 'giantbomb', inc)
+  end
+
+  c = ['character', 'company', 'concept']
+  f = ['franchise']
+  g = ['game']
+  l = ['location']
+  o = ['object']
+  p = ['person', 'platform']
+  r = ['review']
+  u = ['user_review']
+  v = ['video']
+
+  [c, f, g, l, o, p, r, u, v].flatten.each do |inc|
+    require File.join(File.dirname(__FILE__), 'giantbomb', inc)
+  end
+end

data/lib/giantbomb/api.rb

@@ -0,0 +1,18 @@
+module GiantBomb
+  module Api
+    include HTTParty
+
+    base_uri 'http://www.giantbomb.com/api/'
+
+    def self.config
+      @@config
+    end
+
+    def self.key(api_key)
+      @@config = {
+        api_key: api_key,
+        format: 'json'
+      }
+    end
+  end
+end

data/lib/giantbomb/character.rb

@@ -0,0 +1,40 @@
+module GiantBomb
+  class Character < Resource
+    has_resource 'character', plural: 'characters', id: '3005'
+
+    # http://www.giantbomb.com/api/documentation#toc-0-4
+    # http://www.giantbomb.com/api/documentation#toc-0-5
+    #
+    @@fields = [
+      :aliases,                # List of aliases that the character is known by. A \n (newline) separates each alias.
+      :api_detail_url,         # URL pointing to the character detail resource
+      :birthday,               # Birthday of the character
+      :companies,              # Companies that have used the character in a game
+      :concepts,               # Concepts related to the character
+      :date_added,             # Date the character was added to Giant Bomb
+      :date_last_updated,      # Date the character was last updated on Giant Bomb
+      :deck,                   # Brief summary of the character
+      :description,            # Description of the character
+      :enemies,                # Enemies of the character
+      :first_appeared_in_game, # Game that the character first appeared in
+      :franchises,             # Franchises the character has appeared in
+      :friends,                # Friends of the character
+      :games,                  # Games the character has appeared in
+      :gender,                 # Gender of the character. Available options are: Male, Female, Other
+      :id,                     # Unique ID of the character
+      :image,                  # Main Image of the character
+      :last_name,              # Last name of the character
+      :locations,              # Locations related to the character
+      :name,                   # Name of the character
+      :objects,                # Objects related to the character
+      :people,                 # People who have worked with the character
+      :platforms,              # Platforms having a game the character has appeared in
+      :real_name,              # Real name of the character
+      :site_detail_url         # URL pointing to the character on Giant Bomb
+    ]
+
+    @@fields.each do |field|
+      attr_accessor field
+    end
+  end
+end

data/lib/giantbomb/company.rb

@@ -0,0 +1,44 @@
+module GiantBomb
+  class Company < Resource
+    has_resource 'company', plural: 'companies', id: '3010'
+
+    # http://www.giantbomb.com/api/documentation#toc-0-8
+    # http://www.giantbomb.com/api/documentation#toc-0-9
+    #
+    @@fields = [
+      :abbreviation,         # Abbreviation of the company
+      :aliases,              # List of aliases the company is known by. A \n (newline) separates each alias.
+      :api_detail_url,       # URL pointing to the company detail resource
+      :characters,           # Characters the company has used in a game
+      :concepts,             # Concepts related to the company
+      :date_added,           # Date the company was added to Giant Bomb
+      :date_founded,         # Date the company was founded
+      :date_last_updated,    # Date the company was last updated on Giant Bomb
+      :deck,                 # Brief summary of the company
+      :description,          # Description of the company
+      :developed_games,      # Games the company has developed
+      :developer_releases,   # Releases the company has developed
+      :distributor_releases, # Releases the company has distributed
+      :id,                   # Unique ID of the company
+      :image,                # Main Image of the company
+      :location_address,     # Street address of the company
+      :location_city,        # City the company resides in
+      :location_country,     # Country the company resides in
+      :location_state,       # State the company resides in
+      :locations,            # Locations related to the company
+      :name,                 # Name of the company
+      :objects,              # Objects related to the company
+      :people,               # People who have worked for the company
+      :phone,                # Phone number of the company
+      :published_games,      # Games published by the company
+      :publisher_releases,   # Releases the company has published
+      :site_detail_url,      # URL pointing to the company on Giant Bomb
+      :website               # URL to the company website
+    ]
+
+    @@fields.each do |field|
+      attr_accessor field
+    end
+
+  end
+end

data/lib/giantbomb/concept.rb

@@ -0,0 +1,38 @@
+module GiantBomb
+  class Concept < Resource
+    has_resource 'concept', plural: 'concepts', id: '3015'
+
+    # http://www.giantbomb.com/api/documentation#toc-0-10
+    # http://www.giantbomb.com/api/documentation#toc-0-11
+    #
+    @@fields = [
+      :aliases,                     # List of aliases the concept is known by. A \n (newline) separates each alias.
+      :api_detail_url,              # URL pointing to the concept detail resource
+      :characters,                  # Characters related to the concept
+      :companies,                   # Companies related to the concept
+      :concepts,                    # Other concepts related to the concept
+      :date_added,                  # Date the concept was added to Giant Bomb
+      :date_last_updated,           # Date the concept was last updated on Giant Bomb
+      :deck,                        # Brief summary of the concept
+      :description,                 # Description of the concept
+      :first_appeared_in_franchise, # Franchise that the concept first appeared in
+      :first_appeared_in_game,      # Game that the concept first appeared in
+      :franchises,                  # Franchises related to the concept
+      :games,                       # Games related to the concept
+      :id,                          # Unique ID of the concept
+      :image,                       # Main Image of the concept
+      :locations,                   # Locations related to the concept
+      :name,                        # Name of the concept
+      :objects,                     # Objects related to the concept
+      :people,                      # People related to the concept
+      :platforms,                   # Platforms related to the concept
+      :related_concepts,            # Other concepts related to the concept
+      :site_detail_url              # URL pointing to the concept on Giant Bomb
+    ]
+
+    @@fields.each do |field|
+      attr_accessor field
+    end
+
+  end
+end

data/lib/giantbomb/franchise.rb

@@ -0,0 +1,32 @@
+module GiantBomb
+  class Franchise < Resource
+    has_resource 'franchise', plural: 'franchises', id: '3025'
+
+    # http://www.giantbomb.com/api/documentation#toc-0-12
+    # http://www.giantbomb.com/api/documentation#toc-0-13
+    #
+    @@fields = [
+      :aliases,           # List of aliases the franchise is known by. A \n (newline) separates each alias.
+      :api_detail_url,    # URL pointing to the franchise detail resource
+      :characters,        # Characters related to the franchise
+      :concepts,          # Concepts related to the franchise
+      :date_added,        # Date the franchise was added to Giant Bomb
+      :date_last_updated, # Date the franchise was last updated on Giant Bomb
+      :deck,              # Brief summary of the franchise
+      :description,       # Description of the franchise
+      :games,             # Games related to the franchise
+      :id,                # Unique ID of the franchise
+      :image,             # Main Image of the franchise
+      :locations,         # Locations related to the franchise
+      :name,              # Name of the franchise
+      :objects,           # Objects related to the franchise
+      :people,            # People related to the franchise
+      :site_detail_url    # URL pointing to the franchise on Giant Bomb
+    ]
+
+    @@fields.each do |field|
+      attr_accessor field
+    end
+
+  end
+end

data/lib/giantbomb/game.rb

@@ -0,0 +1,55 @@
+module GiantBomb
+  class Game < Resource
+    has_resource 'game', plural: 'games', id: '3030'
+
+    # http://www.giantbomb.com/api/documentation#toc-0-14
+    # http://www.giantbomb.com/api/documentation#toc-0-15
+    #
+    @@fields = [
+      :aliases,                     # List of aliases the game is known by. A \n (newline) separates each alias.
+      :api_detail_url,              # URL pointing to the game detail resource
+      :characters,                  # Characters related to the game
+      :concepts,                    # Concepts related to the game
+      :date_added,                  # Date the game was added to Giant Bomb
+      :date_last_updated,           # Date the game was last updated on Giant Bomb
+      :deck,                        # Brief summary of the game
+      :description,                 # Description of the game
+      :developers,                  # Companies that developed the game
+      :expected_release_day,        # Expected day the game will be released in. The day is represented numerically.
+      :expected_release_month,      # Expected month the game will be released in. The month is represented numerically.
+      :expected_release_quarter,    # Expected quarter game will be released in. The quarter is represented numerically, where 1 = Q1, 2 = Q2, 3 = Q3, and 4 = Q4.
+      :expected_release_year,       # Expected year the game will be released in.
+      :first_appearance_characters, # Characters that first appeared in the game
+      :first_appearance_concepts,   # Concepts that first appeared in the game
+      :first_appearance_locations,  # Locations that first appeared in the game
+      :first_appearance_objects,    # Objects that first appeared in the game
+      :first_appearance_people,     # People that were first credited in the game
+      :franchises,                  # Franchises the game is a part of
+      :genres,                      # Genres that encompass the game
+      :id,                          # Unique ID of the game
+      :image,                       # Main Image of the game
+      :images,                      # List of images associated to the game
+      :killed_characters,           # Characters killed in the game
+      :locations,                   # Locations related to the game
+      :name,                        # Name of the game
+      :number_of_user_reviews,      # Number of user reviews of the game on Giant Bomb
+      :objects,                     # Objects related to the game
+      :original_game_rating,        # Rating of the first release of the game
+      :original_release_date,       # Date the game was first released
+      :people,                      # People related to the game
+      :platforms,                   # Platforms the game can be played on
+      :publishers,                  # Companies that published the game
+      :releases,                    # Releases of the game
+      :reviews,                     # Staff reviews of the game
+      :similar_games,               # Other games that are similar to the game
+      :site_detail_url,             # URL pointing to the game on Giant Bomb
+      :themes,                      # Themes that encompass the game
+      :videos                       # Videos associated to the game
+    ]
+
+    @@fields.each do |field|
+      attr_accessor field
+    end
+
+  end
+end

data/lib/giantbomb/location.rb

@@ -0,0 +1,27 @@
+module GiantBomb
+  class Location < Resource
+    has_resource 'location', plural: 'locations', id: '3035'
+
+    # http://www.giantbomb.com/api/documentation#toc-0-20
+    # http://www.giantbomb.com/api/documentation#toc-0-21
+    #
+    @@fields = [
+      :aliases,                # List of aliases the location is known by. A \n (newline) separates each alias.
+      :api_detail_url,         # URL pointing to the location detail resource
+      :date_added,             # Date the location was added to Giant Bomb
+      :date_last_updated,      # Date the location was last updated on Giant Bomb
+      :deck,                   # Brief summary of the location
+      :description,            # Description of the location
+      :first_appeared_in_game, # Game the location first appeared in
+      :id,                     # Unique ID of the location
+      :image,                  # Main Image of the location
+      :name,                   # Name of the location
+      :site_detail_url         # URL pointing to the location on Giant Bomb
+    ]
+
+    @@fields.each do |field|
+      attr_accessor field
+    end
+
+  end
+end

data/lib/giantbomb/object.rb

@@ -0,0 +1,36 @@
+module GiantBomb
+  class GameObject < Resource
+    has_resource 'object', plural: 'objects', id: '3055'
+
+    # http://www.giantbomb.com/api/documentation#toc-0-22
+    # http://www.giantbomb.com/api/documentation#toc-0-23
+    #
+    @@fields = [
+      :aliases,                # List of aliases the object is known by. A \n (newline) separates each alias.
+      :api_detail_url,         # URL pointing to the object detail resource
+      :characters,             # Characters related to the object
+      :companies,              # Companies related to the object
+      :concepts,               # Concepts related to the object
+      :date_added,             # Date the object was added to Giant Bomb
+      :date_last_updated,      # Date the object was last updated on Giant Bomb
+      :deck,                   # Brief summary of the object
+      :description,            # Description of the object
+      :first_appeared_in_game, # Game the object first appeared in
+      :franchises,             # Franchises related to the object
+      :games,                  # Games related to the object
+      :id,                     # Unique ID of the object
+      :image,                  # Main Image of the object
+      :locations,              # Locations related to the object
+      :name,                   # Name of the object
+      :objects,                # Other objects related to the object
+      :people,                 # People related to the object
+      :platforms,              # Platforms related to the object
+      :site_detail_url         # URL pointing to the object on Giant Bomb
+    ]
+
+    @@fields.each do |field|
+      attr_accessor field
+    end
+
+  end
+end

data/lib/giantbomb/person.rb

@@ -0,0 +1,41 @@
+module GiantBomb
+  class Person < Resource
+    has_resource 'person', plural: 'people', id: '3040'
+
+    # http://www.giantbomb.com/api/documentation#toc-0-24
+    # http://www.giantbomb.com/api/documentation#toc-0-25
+    #
+    @@fields = [
+      :aliases,             # List of aliases the person is known by. A \n (newline) separates each alias.
+      :api_detail_url,      # URL pointing to the person detail resource
+      :birth_date,          # Date the person was born
+      :characters,          # Characters related to the person
+      :companies,           # Companies the person has worked with
+      :concepts,            # Concepts related to the person
+      :country,             # Country the person resides in
+      :date_added,          # Date the person was added to Giant Bomb
+      :date_last_updated,   # Date the person was last updated on Giant Bomb
+      :death_date,          # Date the person died
+      :deck,                # Brief summary of the person
+      :description,         # Description of the person
+      :first_credited_game, # Game the person was first credited in
+      :franchises,          # Franchises the person has worked on
+      :games,               # Games the person has worked on
+      :gender,              # Gender of the person. Available options are: Male, Female, Other
+      :hometown,            # City or town the person resides in
+      :id,                  # Unique ID of the person
+      :image,               # Main Image of the person
+      :locations,           # Locations related to the person
+      :name,                # Name of the person
+      :objects,             # Objects related to the person
+      :people,              # Other people related to the person
+      :platforms,           # Platforms related to the person
+      :site_detail_url      # URL pointing to the person on Giant Bomb
+    ]
+
+    @@fields.each do |field|
+      attr_accessor field
+    end
+
+  end
+end

data/lib/giantbomb/platform.rb

@@ -0,0 +1,30 @@
+module GiantBomb
+  class Platform < Resource
+    has_resource 'platform', plural: 'platforms', id: '3045'
+
+    # http://www.giantbomb.com/api/documentation#toc-0-26
+    # http://www.giantbomb.com/api/documentation#toc-0-27
+    #
+    @@fields = [
+      :abbreviation,      # Abbreviation of the platform.
+      :api_detail_url,    # URL pointing to the platform detail resource
+      :company,           # Company that created the platform.
+      :date_added,        # Date the platform was added to Giant Bomb
+      :date_last_updated, # Date the platform was last updated on Giant Bomb
+      :deck,              # Brief summary of the platform
+      :description,       # Description of the platform
+      :id,                # Unique ID of the platform
+      :image,             # Main Image of the platform
+      :install_base,      # Approximate number of sold hardware units.
+      :name,              # Name of the platform
+      :online_support,    # Flag indicating whether the platform has online capabilities.
+      :original_price,    # Initial price point of the platform.
+      :release_date,      # Date of the platform
+      :site_detail_url,   # URL pointing to the platform on Giant Bomb.
+    ]
+
+    @@fields.each do |field|
+      attr_accessor field
+    end
+  end
+end

data/lib/giantbomb/resource.rb

@@ -0,0 +1,58 @@
+module GiantBomb
+  class Resource
+    @@endpoints = {}
+    @@endpoint_id = {}
+
+    def self.has_resource(singular=nil, opts={})
+      @@endpoints[self.name.downcase] = {
+        singular: singular.nil? ? "#{self.name.downcase}" : singular,
+        plural: opts[:plural].nil? ? "#{self.name.downcase}s" : opts[:plural]
+      }
+      @@endpoint_id[self.name.downcase] = opts[:id].nil? ? "" : "#{opts[:id]}-"
+    end
+
+    def self.endpoints
+      @@endpoints[self.name.downcase]
+    end
+
+    def self.endpoint_id
+      @@endpoint_id[self.name.downcase]
+    end
+
+    def self.detail(id, conditions={})
+      search = GiantBomb::Search.new("/#{self.endpoints[:singular]}/#{self.endpoint_id + id.to_s}/")
+      search.filter(conditions)
+      self.new(search.fetch)
+    end
+
+    def self.list(conditions={})
+      search = GiantBomb::Search.new("/#{self.endpoints[:plural]}")
+      search.filter(conditions)
+      search.fetch.collect do |result|
+        self.new(result)
+      end
+    end
+
+    def self.search(query)
+      search = GiantBomb::Search.new
+      search.resources("#{self.endpoints[:singular]}")
+      search.query(query)
+      search.fetch.collect do |result|
+        self.new(result)
+      end
+    end
+
+    class << self
+      alias_method :find, :search
+    end
+
+    def initialize(attributes={})
+      attributes.each do |key, value|
+        if self.respond_to?(key.to_sym)
+          self.instance_variable_set("@#{key}", value)
+        end
+      end
+    end
+
+  end
+end

data/lib/giantbomb/review.rb

@@ -0,0 +1,27 @@
+module GiantBomb
+  class Review < Resource
+    has_resource 'review', plural: 'reviews', id: '1900'
+
+    # http://www.giantbomb.com/api/documentation#toc-0-36
+    # http://www.giantbomb.com/api/documentation#toc-0-37
+    #
+    @@fields = [
+      :api_detail_url,  # URL pointing to the review detail resource
+      :deck,            # Brief summary of the review
+      :description,     # Description of the review
+      :dlc,             # Date the franchise was added to Giant Bomb
+      :dlc_name,        # Name of the Downloadable Content package
+      :game,            # Game the review is for
+      :publish_date,    # Date the review was published on Giant Bomb
+      :release,         # Release of game for review
+      :reviewer,        # Name of the review's author
+      :score,           # The score given to the game on a scale of 1 to 5
+      :site_detail_url, # URL pointing to the review on Giant Bomb
+      :platforms,       # Platforms the review appeared in.
+    ]
+
+    @@fields.each do |field|
+      attr_accessor field
+    end
+  end
+end

data/lib/giantbomb/search.rb

@@ -0,0 +1,112 @@
+module GiantBomb
+  # Wrapper for the Giant Bomb Search resource
+  #
+  # @see http://api.giantbomb.com/documentation/#search
+  class Search
+    include GiantBomb::Api
+
+    # @private
+    attr_reader :query, :resource
+
+    # Creates a new search
+    #
+    # @example Initialize a Giant Bomb search
+    #   search = GiantBomb::Search.new
+    #   search = GiantBomb::Search.new('game')
+    def initialize(resource=nil)
+      @params = {}
+      @resource = resource.nil? ? '/search' : resource
+      self
+    end
+
+    # @group Generic filters
+
+    # Only return the specified fields for the given resource
+    #
+    # @param fields [String] A comma delimited list of fields to return.
+    # @return [GiantBomb::Search] self
+    def fields(fields)
+      @params[:field_list] = "#{fields}"
+      self
+    end
+
+    # Only return a limited number of resources
+    #
+    # @param limit [Integer] Nmber of items to limit by.
+    # @return [GiantBomb::Search] self
+    def limit(limit)
+      @params[:limit] = "#{limit}"
+      self
+    end
+
+    # Only include resources starting from a given offset
+    #
+    # @param limit [Integer] Number of items to skip.
+    # @return [GiantBomb::Search] self
+    def offset(offset)
+      @params[:offset] = "#{offset}"
+      self
+    end
+
+    # Search query
+    #
+    # @param query [String] The search query.
+    # @return [GiantBomb::Search] self
+    def query(query)
+      @params[:query] = "#{query}"
+      self
+    end
+
+    # Only include items of the specified resources
+    #
+    # @param resources [String] A comma delimited list of resources to search.
+    # @return [GiantBomb::Search] self
+    def resources(resources)
+      @params[:resources] = "#{resources}"
+      self
+    end
+
+    # A convenience method that takes a hash where each key is
+    # the symbol of a method, and each value is the parameters
+    # passed to that method.
+    def filter(conditions)
+      if conditions
+        conditions.each do |key, value|
+          if self.respond_to?(key)
+            self.send(key, value)
+          end
+        end
+      end
+    end
+
+    # Fetch the results of the query
+    #
+    # @return [Array] Items that match the specified query.
+    # @example
+    #   search = GiantBomb::Search.new.query("Duke Nukem").fetch
+    def fetch
+      fetch_response['results']
+    end
+
+    # Fetch the full response of the query, including metadata
+    # Keys returned:
+    #   status_code
+    #   error
+    #   number_of_total_results
+    #   number_of_page_results
+    #   limit
+    #   offset
+    #   results
+    #
+    # @return [Hash] Hash of the api response
+    # @example
+    #   search = GiantBomb::Search.new.query("Duke Nukem").fetch_response
+    # @see http://api.giantbomb.com/documentation/#handling_responses
+    def fetch_response
+      options = @params.merge(Api.config)
+      response = Api.get(@resource, query: options)
+      response.to_hash
+    end
+
+  end
+end

data/lib/giantbomb/user_review.rb

@@ -0,0 +1,24 @@
+module GiantBomb
+  class UserReview < Resource
+    has_resource 'user_review', plural: 'user_reviews', id: '2200'
+
+    # http://www.giantbomb.com/api/documentation#toc-0-42
+    # http://www.giantbomb.com/api/documentation#toc-0-43
+    #
+    @@fields = [
+      :api_detail_url,    # URL pointing to the review detail resource
+      :date_added,        # Date the user_review was added to Giant Bomb
+      :date_last_updated, # Date the user_review was last updated on Giant Bomb
+      :deck,              # Brief summary of the user_review
+      :description,       # Description of the user_review
+      :game,              # Game the user_review is for
+      :reviewer,          # Name of the review's author
+      :score,             # The score given to the game on a scale of 1 to 5
+      :site_detail_url,   # URL pointing to the user_review on Giant Bomb
+    ]
+
+    @@fields.each do |field|
+      attr_accessor field
+    end
+  end
+end

data/lib/giantbomb/version.rb

@@ -0,0 +1,12 @@
+module GiantBomb
+  VERSION = "1.5.7"
+
+  # Changelog
+  #
+  # v1.5.5 -
+  # v1.5.6 - Add Review resource
+  # v1.5.7 - Add User Review Resource
+  ## v1.5.8 - Planned
+  #
+
+end

data/lib/giantbomb/video.rb

@@ -0,0 +1,24 @@
+module GiantBomb
+  class Video < Resource
+    has_resource 'video', plural: 'videos', id: '2300'
+
+    # http://www.giantbomb.com/api/documentation#toc-0-44
+    #
+    @@fields = [
+      :api_detail_url,  # URL pointing to the video detail resource
+      :deck,            # Brief summary of the video
+      :id,              # Unique ID of the video
+      :image,           # Image associated with the video
+      :name,            # Title of the video
+      :publish_date,    # Date the video was published on Giant Bomb
+      :site_detail_url, # URL pointing to the video on Giant Bomb
+      :url,             # The video's filename
+      :user             # Author of the video
+    ]
+
+    @@fields.each do |field|
+      attr_accessor field
+    end
+
+  end
+end

data/spec/giantbomb_spec.rb

@@ -0,0 +1,11 @@
+require 'spec_helper'
+
+describe GiantBomb do
+  it 'has a version number' do
+    expect(GiantBomb::VERSION).not_to be nil
+  end
+
+  it 'does something useful' do
+    expect(false).to eq(true)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+require 'giantbomb'

metadata

@@ -0,0 +1,94 @@
+--- !ruby/object:Gem::Specification
+name: giantbomb-api
+version: !ruby/object:Gem::Version
+  version: 1.5.7
+platform: ruby
+authors:
+- Robert Coker
+- Vlad Radulescu
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-01-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Provides a simple, easy to use interface for the Giant Bomb video game
+  wiki API.
+email:
+- rob@robertsays.com
+- pacMakaveli90@gmail.com
+executables:
+- console
+- setup
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- giantbomb.gemspec
+- lib/giantbomb.rb
+- lib/giantbomb/api.rb
+- lib/giantbomb/character.rb
+- lib/giantbomb/company.rb
+- lib/giantbomb/concept.rb
+- lib/giantbomb/franchise.rb
+- lib/giantbomb/game.rb
+- lib/giantbomb/location.rb
+- lib/giantbomb/object.rb
+- lib/giantbomb/person.rb
+- lib/giantbomb/platform.rb
+- lib/giantbomb/resource.rb
+- lib/giantbomb/review.rb
+- lib/giantbomb/search.rb
+- lib/giantbomb/user_review.rb
+- lib/giantbomb/version.rb
+- lib/giantbomb/video.rb
+- spec/giantbomb_spec.rb
+- spec/spec_helper.rb
+homepage: http://rubygems.org/gems/giantbomb-api
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: A Ruby wrapper for the GiantBomb video game wiki API.
+test_files:
+- spec/giantbomb_spec.rb
+- spec/spec_helper.rb