GuideboxWrapper 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 781382e9ef5bb0f587c224c9b8bb1c4aa8e80264
+  data.tar.gz: ab6bdad42303169407dcc08a089d6622d841d54e
+SHA512:
+  metadata.gz: 854b11bc754973e7ed5908a0293a3c9c7bd416943d37433e39f1156271f0c322d5b3e989ba621eb06a55e922ab100a5d8488dd0234bb8d30e62bd117c467f0d1
+  data.tar.gz: 98860e92bf0c9c856c66c492f1df28eda5e41de7605748c89c5cb194c1d14256cf45070ab778cdc89818c1c9be5c64eab39dbe40c86e15048d1fcaf28f469409

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/GuideboxWrapper-0.1.0.gem

data/.rspec

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

data/.travis.yml

@@ -0,0 +1,19 @@
+language: ruby
+cache: bundler 
+
+rvm:
+  - 2.2.1
+
+script: 'bundle exec rake'
+
+notifications:
+  email:
+    recipients:
+      - tmobaird@gmail.com
+      - tbaird@mail.umw.edu
+    on_success: change # default: change
+    on_failure: always # default: always
+
+addons:
+  code_climate:
+    repo_token: a8b1370c362034c18a1c27ee8abdec1c17939bbeb4c041f06219d03ab29762c6

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http:contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/Gemfile

@@ -0,0 +1,8 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in GuideboxWrapper.gemspec
+gemspec
+
+group :test do
+  gem 'codeclimate-test-reporter', require: false
+end

data/GuideboxWrapper.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'GuideboxWrapper/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "GuideboxWrapper"
+  spec.version       = GuideboxWrapper::VERSION
+  spec.authors       = ["Thomas Baird"]
+  spec.email         = ["tbaird@mail.umw.edu"]
+
+  # if spec.respond_to?(:metadata)
+  #   spec.metadata['allowed_push_host'] = "TODO: Set to 'http://mygemserver.com' to prevent pushes to rubygems.org, or delete to allow pushes to any server."
+  # end
+
+  spec.summary       = %q{A ruby wrapper for the Guidebox API.}
+  spec.description   = %q{This gem is a ruby wrapper for the Guidebox API. Guidebox is a big database of movie/tv-show information. This gem allows you to query this api easily for different pieces of data.}
+  spec.homepage      = "https://github.com/tmobaird/GuideboxWrapper"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.8"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.4"
+  spec.add_development_dependency "json", "~> 1.8"
+
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Thomas Baird
+
+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,277 @@
+# GuideboxWrapper
+
+[![Code Climate](https://codeclimate.com/github/tmobaird/GuideboxWrapper/badges/gpa.svg)](https://codeclimate.com/github/tmobaird/GuideboxWrapper)
+[![Test Coverage](https://codeclimate.com/github/tmobaird/GuideboxWrapper/badges/coverage.svg)](https://codeclimate.com/github/tmobaird/GuideboxWrapper/coverage)
+[![Build Status](https://travis-ci.org/tmobaird/GuideboxWrapper.svg?branch=master)](https://travis-ci.org/tmobaird/GuideboxWrapper)
+
+Guidebox Wrapper is a Ruby Wrapper for the Guidebox API. The Guidebox API contains tons of information about tv shows and movies. This gem will help you extract data from this API in a simple way. It contains an array of different methods that allow you to obtain different information about a movie/tv show. 
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'GuideboxWrapper'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install GuideboxWrapper
+
+## Usage
+
+To use this gem you must first register for a personal API key on Guidebox's website. This registration page can be found here: [Guidebox API key registration page](https://api.guidebox.com/production-key). Once you obtain your personal API key (which should be randomized string of numbers and characters) you will be able to start using this gem.
+
+**Do not use yet, this Gem is not currently active on RubyGems**
+
+The API helpers throughout this gem can be called on either Tv or Movie objects. These objects can be initialized by doing the following:
+
+```ruby
+GuideboxWrapper::Tv.new("YOUR_API_KEY", "region") # region can be "all", "US" (United States), "GB" (Great Britain), etc
+
+GuideboxWrapper::Movie.new("YOUR_API_KEY", "region") # region can be "all", "US" (United States), "GB" (Great Britain), etc
+```
+
+Keep in mind that Guidebox has some restrictions on the amount of API calls that can be made per month and per second. The API is limited to 100,000 API calls a month and 1 API call per second. The monthy limit of 100,000 resets on the 1st of every month. To check the amont of API calls you have made in the current month use the quota helper. It can be called on either a GuideboxWrapper::Movie Or GuideboxWrapper::Tv object as follows:
+
+```ruby
+tv = GuideboxWrapper::Tv.new("YOUR_API_KEY", "region")
+tv.quota
+# => 5500
+
+movie = GuideboxWrapper::Movie.new("YOUR_API_KEY", "region")
+movie.quota
+# => 5500
+```
+Here are all the helper methods within this wrapper for the Movie and Tv classes:
+
+#### Movie Helpers
+
+```ruby
+guidebox_movie = GuideboxWrapper::Movie.new("YOUR_API_KEY", "region")
+
+guidebox_movie.search_for("star wars a new hope")
+# => [{"id"=>55413, "title"=>"Star Wars: Episode IV: A New Hope", "release_year"=>1977, "themoviedb"=>11, ...}]
+
+guidebox_movie.search_for_by_provider("star wars a new hope", "amazon_prime")
+# => [{"id"=>55413, "title"=>"Star Wars: Episode IV: A New Hope", "release_year"=>1977, "themoviedb"=>11, ...}]
+
+guidebox_movie.search_by_db_id(11, "themoviedb")
+# => {"id"=>55413, "title"=>"Star Wars: Episode IV: A New Hope", "release_year"=>1977, "themoviedb"=>11, ...}
+
+guidebox_movie.show_information("star wars a new hope")
+# => {"id"=>55413, "title"=>"Star Wars: Episode IV: A New Hope", "release_year"=>1977, "themoviedb"=>11, "alternate_titles"=>["Star Wars", "Star Wars Episode IV - A New Hope", "Star Wars Episode 4 - A New Hope", "Star Wars Episode IV", "Star Wars 4", "Star Wars: Episode IV - A New Hope - Despecialized Edition", "Star Wars Episode IV: A New Hope", "Star Wars: Episode IV - A New Hope", "Star Wars: A New Hope", "Star Wars: A New Hope (Bonus Features)"], "imdb"=>"tt0076759", "pre_order"=>false, "release_date"=>"1977-05-25", "rating"=>"PG", "rottentomatoes"=>11292, "freebase"=>"/m/0dtfn", "wikipedia_id"=>52549, "metacritic"=>"http://www.metacritic.com/movie/star-wars-episode-iv---a-new-hope", "common_sense_media"=>nil, "overview"=>"Princess Leia is captured and held hostage by the evil Imperial forces in their effort to take over the galactic Empire. Venturesome Luke Skywalker and dashing captain Han Solo team together with the loveable robot duo R2-D2 and C-3PO to rescue the beautiful princess and restore peace and justice in the Empire.", ...}
+
+guidebox_movie.cast("star wars a new hope")
+# => [{"id"=>300791, "name"=>"Mark Hamill", "character_name"=>"Luke Skywalker"}, {"id"=>212668, "name"=>"Harrison Ford", "character_name"=>"Han Solo"}, {"id"=>577359, "name"=>"Carrie Fisher", "character_name"=>"Leia Organa"}, ...]
+
+guidebox_movie.writers("star wars a new hope")
+# => [{"id"=>527769, "name"=>"George Lucas"}] 
+
+guidebox_movie.directors("star wars a new hope")
+# => [{"id"=>527769, "name"=>"George Lucas"}] 
+
+guidebox_movie.release_year("star wars a new hope")
+# => 1977
+
+guidebox_movie.release_date("star wars a new hope")
+# => "1977-05-25"
+
+guidebox_movie.rating("star wars a new hope")
+# => "PG"
+
+guidebox_movie.duration("star wars a new hope")
+# => 7260
+
+guidebox_movie.themoviedb_id("star wars a new hope")
+# => 11
+
+guidebox_movie.imdb_id("star wars a new hope")
+# => "tt0076759"
+
+guidebox_movie.rotten_tomatoes_id("star wars a new hope")
+# => 11292
+
+guidebox_movie.alternate_titles("star wars a new hope")
+# => ["Star Wars", "Star Wars Episode IV - A New Hope", "Star Wars Episode 4 - A New Hope", "Star Wars Episode IV", "Star Wars 4", "Star Wars: Episode IV - A New Hope - Despecialized Edition", "Star Wars Episode IV: A New Hope", "Star Wars: Episode IV - A New Hope", "Star Wars: A New Hope", "Star Wars: A New Hope (Bonus Features)"] 
+
+guidebox_movie.freebase("star wars a new hope")
+# => "/m/0dtfn"
+
+guidebox_movie.wikipedia_id("star wars a new hope")
+# => 52549
+
+guidebox_movie.metacritic_link("star wars a new hope")
+# => "http://www.metacritic.com/movie/star-wars-episode-iv---a-new-hope"
+
+guidebox_movie.overview("star wars a new hope")
+# => "Princess Leia is captured and held hostage by the evil Imperial forces in their effort to take over the galactic Empire. Venturesome Luke Skywalker and dashing captain Han Solo team together with the loveable robot duo R2-D2 and C-3PO to rescue the beautiful princess and restore peace and justice in the Empire."
+
+guidebox_movie.genres("star wars a new hope")
+# => [{"id"=>3, "title"=>"Adventure"}, {"id"=>1, "title"=>"Action"}, {"id"=>21, "title"=>"Science-Fiction"}] 
+
+guidebox_movie.tags("star wars a new hope")
+# => [{"id"=>1594, "tag"=>"galaxy"}, {"id"=>9191, "tag"=>"hermit"}, {"id"=>2186, "tag"=>"star wars"}, {"id"=>9192, "tag"=>"death star"}, {"id"=>9193, "tag"=>"lightsaber"}, {"id"=>5558, "tag"=>"jedi"}, ...]
+
+guidebox_movie.facebook_link("star wars revenge of the sith")
+# => "https://www.facebook.com/pages/Star-Wars-Episode-III-Revenge-of-the-Sith/105663472799675"
+
+guidebox_movie.web_trailers("star wars revenge of the sith")
+# => [{"type"=>"Main Trailer", "source"=>"guidebox", "display_name"=>"Guidebox", "link"=>"http://www.guidebox.com/watch-now.php?video=53201", "embed"=>"http://api-widget.guidebox.com/embed.php?video=53201"}] 
+
+guidebox_movie.ios_trailers("star wars revenge of the sith")
+# => [{"type"=>"Main Trailer", "source"=>"guidebox", "display_name"=>"Guidebox", "link"=>"http://www.guidebox.com/watch-now.php?video=53201", "embed"=>"http://api-widget.guidebox.com/embed.php?video=53201"}] 
+
+guidebox_movie.android_trailers("star wars revenge of the sith")
+# => [{"type"=>"Main Trailer", "source"=>"guidebox", "display_name"=>"Guidebox", "link"=>"http://www.guidebox.com/watch-now.php?video=53201", "embed"=>"http://api-widget.guidebox.com/embed.php?video=53201"}] 
+
+guidebox_movie.posters("star wars a new hope")
+# => [{"large"=>{"url"=>"http://static-api.guidebox.com/022615/thumbnails_movies/-alt--55413-2929921416-5712237544-4512474872-large-400x570-alt-.jpg", "width"=>400, "height"=>570}, ...] 
+
+guidebox_movie.thumbnail_images("star wars a new hope")
+# => [{"xlarge"=>{"url"=>"http://static-api.guidebox.com/012915/movies/thumbnails/55413-4649667824-932900156-9715580251-608x342.jpg", "width"=>608, "height"=>342}, "large"=>{"url"=>"http://static-api.guidebox.com/012915/movies/thumbnails/55413-4649667824-932900156-9715580251-448x252.jpg", "width"=>448, "height"=>252}, ...] 
+
+guidebox_movie.banner_images("star wars a new hope")
+# => [{"xlarge"=>{"url"=>"http://static-api.guidebox.com/012915/movies/banners/55413-9158895025-3035124387-2547398284-1300x240.jpg", "width"=>1300, "height"=>240}, "large"=>{"url"=>"http://static-api.guidebox.com/012915/movies/banners/55413-9158895025-3035124387-2547398284-1000x185.jpg", "width"=>1000, "height"=>185}, ...] 
+
+guidebox_movie.background_images("star wars a new hope")
+# => [{"original"=>{"url"=>"http://static-api.guidebox.com/012915/movies/backgrounds/55413-83836050721-144034282636-0.jpg", "width"=>1920, "height"=>1080}, "original_width"=>1920, "original_height"=>1080, "image_rating"=>0}, {"original"=>{"url"=>"http://static-api.guidebox.com/012915/movies/backgrounds/55413-206143594668-179262854890-0.jpg", "width"=>1920, "height"=>1080}, "original_width"=>1920, "original_height"=>1080, "image_rating"=>0}, {"original"=>{"url"=>"http://static-api.guidebox.com/012915/movies/backgrounds/55413-187622151929-44181177682-0.jpg", "width"=>1920, "height"=>1080}, "original_width"=>1920, "original_height"=>1080, "image_rating"=>0}]
+
+guidebox_movie.free_web_sources("star wars a new hope")
+# => []
+
+guidebox_movie.free_ios_sources("star wars a new hope")
+# => []
+
+guidebox_movie.free_android_sources("star wars a new hope")
+# => []
+
+guidebox_movie.tv_everywhere_web_sources("godzilla")
+# => [{"source"=>"xfinity_tveverywhere", "display_name"=>"Xfinity", "tv_channel"=>"Cinemax", "link"=>"http://xfinitytv.comcast.net/watch/Godzilla/7874134385186056112/574211139668/Godzilla-%28Cinemax%29/videos"}, ...] 
+
+guidebox_movie.tv_everywhere_ios_sources("godzilla")
+# => [{"source"=>"maxgo", "display_name"=>"MAX GO", "tv_channel"=>"Cinemax", "link"=>"maxgo://deeplink/MO.MO/MGOROSTGP38072", "app_name"=>"MAX GO", "app_link"=>1, "app_required"=>1, "app_download_link"=>"itms-apps://itunes.apple.com/app/max-go/id453560335"}] 
+
+guidebox_movie.tv_everywhere_android_sources("godzilla")
+# => [{"source"=>"maxgo", "display_name"=>"MAX GO", "tv_channel"=>"Cinemax", "link"=>"maxgo://deeplink/MO.MO/MGOROSTGP38072", "app_name"=>"MAX GO", "app_link"=>1, "app_required"=>1, "app_download_link"=>"https://play.google.com/store/apps/details?id=com.MAXGo"}] 
+
+guidebox_movie.subscription_web_sources("star wars a new hope")
+# => [{"source"=>"now_tv", "display_name"=>"NOW TV", "link"=>"http://watch.nowtv.com/watch-movies/star-wars-episode-iv-new-hope-1977/d3742a916796e410VgnVCM1000000b43150a____"}] 
+
+guidebox_movie.purchase_web_sources("star wars a new hope")
+# => [{"source"=>"itunes", "display_name"=>"iTunes", "link"=>"https://itunes.apple.com/us/movie/star-wars-a-new-hope/id978943481?uo=4&at=10laHb", "formats"=>[{"price"=>"19.99", "format"=>"SD", "type"=>"purchase", "pre_order"=>false}, {"price"=>"19.99", "format"=>"HD", "type"=>"purchase", "pre_order"=>false}]}, ...]
+
+guidebox_movie.purchase_ios_sources("star wars a new hope")
+# => [{"source"=>"itunes", "display_name"=>"iTunes", "link"=>"itms://itunes.apple.com/us/movie/star-wars-a-new-hope/id978943481?uo=4&at=10laHb", "app_name"=>"iTunes", "app_link"=>1, "app_required"=>1, "app_download_link"=>"itms-apps://", "formats"=>[{"price"=>"19.99", "format"=>"SD", "type"=>"purchase", "pre_order"=>false}, {"price"=>"19.99", "format"=>"HD", "type"=>"purchase", "pre_order"=>false}]}] 
+
+guidebox_movie.purchase_android_sources("star wars a new hope")
+# => [{"source"=>"google_play", "display_name"=>"Google Play", "link"=>"https://play.google.com/store/movies/details?id=yYNSSNJ0z_U", "app_name"=>"Google Play", "app_link"=>0, "app_required"=>0, "app_download_link"=>"https://play.google.com/store", "formats"=>[{"price"=>"19.99", "format"=>"HD", "type"=>"purchase", "pre_order"=>false}]}] 
+```
+
+#### Tv Helpers
+
+```ruby
+guidebox_tv = GuideboxWrapper::Tv.new("YOUR_API_KEY", "region")
+
+guidebox_tv.search_for("entourage")
+# => [{"id"=>6085, "title"=>"Entourage", "alternate_titles"=>[], "container_show"=>0, "first_aired"=>"2004-07-18", "imdb_id"=>"tt0387199", ...}, ...] 
+
+guidebox_tv.search_for_by_provider("entourage", "hbo")
+# => [{"id"=>6085, "title"=>"Entourage", "alternate_titles"=>[], "container_show"=>0, "first_aired"=>"2004-07-18", "imdb_id"=>"tt0387199", ...}, ...]
+
+guidebox_tv.search_by_db_id("tt0387199", "imdb")
+# => {"id"=>6085, "title"=>"Entourage", "alternate_titles"=>[], "container_show"=>0, "first_aired"=>"2004-07-18", "imdb_id"=>"tt0387199", ...} 
+
+guidebox_tv.show_information("entourage")
+# => {"id"=>6085, "title"=>"Entourage", "alternate_titles"=>[], "status"=>"Ended", "type"=>"television", "container_show"=>0, "first_aired"=>"2004-07-18", "network"=>"HBO", "channels"=>[{"id"=>36, "name"=>"HBO", "short_name"=>"hbo", ...}
+
+guidebox_tv.seasons("entourage")
+# => [{"season_number"=>1, "first_airdate"=>"2004-07-18"}, {"season_number"=>2, "first_airdate"=>"2005-06-05"}, {"season_number"=>3, "first_airdate"=>"2006-06-11"}, {"season_number"=>4, "first_airdate"=>"2007-06-17"}, ...]
+
+guidebox_tv.cast("entourage")
+# => [{"id"=>40080, "name"=>"Kevin Connolly", "character_name"=>"Eric Murphy"}, {"id"=>349611, "name"=>"Adrian Grenier", "character_name"=>"Vincent Chase"}, {"id"=>275528, "name"=>"Jerry Ferrara", "character_name"=>"Turtle"}, {"id"=>71709, "name"=>"Kevin Dillon", "character_name"=>"Johnny \"Drama\" Chase"}, {"id"=>491504, "name"=>"Jeremy Piven", "character_name"=>"Ari Gold"}, ...] 
+
+guidebox_tv.status("entourage")
+# => "Ended"
+
+guidebox_tv.type("entourage")
+# => "television"
+
+guidebox_tv.first_aired("entourage")
+# => "2004-07-18"
+
+guidebox_tv.network("entourage")
+# => "HBO"
+
+guidebox_tv.channel_information("entourage")
+# => [{"id"=>36, "name"=>"HBO", "short_name"=>"hbo", "channel_type"=>"television", "artwork_208x117"=>"http://static-api.guidebox.com/041014/thumbnails_small/36-4192732312-208x117-channel.jpg", ...}]
+
+guidebox_tv.runtime("entourage")
+# => 30
+
+guidebox_tv.genres("entourage")
+# => [{"id"=>6, "title"=>"Comedy"}, {"id"=>9, "title"=>"Drama"}] 
+
+guidebox_tv.tags("entourage")
+# => [{"id"=>919, "tag"=>"beverly hills"}, {"id"=>1624, "tag"=>"beverly hills california"}, {"id"=>44, "tag"=>"male friendship"}, {"id"=>293, "tag"=>"aspiring actor"}, {"id"=>295, "tag"=>"hollywood"}, ...]
+
+guidebox_tv.overview("entourage")
+# => "Vincent Chase is a young actor whose career is on the rise. Joining him on his journey to stardom are his childhood buddies Eric, Turtle, his brother Johnny Drama and his hot-tempered agent Ari Gold. Together, they'll navigate the highs and lows of Hollywood's fast lane, where the stakes are higher -- and the money and temptations greater -- than ever before. "
+
+guidebox_tv.air_day_of_week("entourage")
+# => "Sunday"
+
+guidebox_tv.air_time("entourage")
+# => "10:30 PM"
+
+guidebox_tv.rating("entourage")
+# => "TV-MA"
+
+guidebox_tv.imdb_id("entourage")
+# => "tt0387199"
+
+guidebox_tv.metacritic_link("entourage")
+# => "http://www.metacritic.com/tv/entourage"
+
+guidebox_tv.wikipedia_id("entourage")
+# => 907282
+
+guidebox_tv.facebook_link("entourage")
+# => "https://www.facebook.com/Entourage"
+
+guidebox_tv.twitter_link("entourage")
+# => nil
+
+guidebox_tv.related_show("entourage")
+# => {"total_results"=>6, "total_returned"=>6, "results"=>[{"id"=>300, "title"=>"Suits", "alternate_titles"=>[], "container_show"=>0, "first_aired"=>"2011-06-23", "imdb_id"=>"tt1632701", "tvdb"=>247808, "themoviedb"=>37680, "freebase"=>"/m/0gg70vv", "wikipedia_id"=>30987670, "tvrage"=>{"tvrage_id"=>27518, "link"=>"http://www.tvrage.com/shows/id-27518"}, "artwork_208x117"=>"http://static-api.guidebox.com/091414/thumbnails_small/300-4352846579-208x117-show-thumbnail.jpg", "artwork_304x171"=>"http://static-api.guidebox.com/091414/thumbnails_medium/300-2030188479-304x171-show-thumbnail.jpg", "artwork_448x252"=>"http://static-api.guidebox.com/091414/thumbnails_large/300-9888987527-448x252-show-thumbnail.jpg", "artwork_608x342"=>"http://static-api.guidebox.com/091414/thumbnails_xlarge/300-9276088145-608x342-show-thumbnail.jpg"}, ...]} 
+
+guidebox_tv.posters("entourage")
+# => [{"xlarge"=>{"url"=>"http://static-api.guidebox.com/012915/shows/posters/6085-3725524591-5295090941-3912000982-600x855.jpg", "width"=>600, "height"=>855}, "large"=>{"url"=>"http://static-api.guidebox.com/012915/shows/posters/6085-3725524591-5295090941-3912000982-400x570.jpg", "width"=>400, "height"=>570}, ...}]
+
+guidebox_tv.thumbnail_images("entourage")
+# => [{"xlarge"=>{"url"=>"http://static-api.guidebox.com/091414/thumbnails_xlarge/6085-6340779560-608x342-show-thumbnail.jpg", "width"=>608, "height"=>342}, "large"=>{"url"=>"http://static-api.guidebox.com/091414/thumbnails_large/6085-6218685578-448x252-show-thumbnail.jpg", "width"=>448, "height"=>252}, ...}] 
+
+guidebox_tv.banner_images("entourage")
+# => [{"xlarge"=>{"url"=>"http://static-api.guidebox.com/012915/shows/banners/6085-6918728002-5154230813-6413012026-1300x240.jpg", "width"=>1300, "height"=>240}, "large"=>{"url"=>"http://static-api.guidebox.com/012915/shows/banners/6085-6918728002-5154230813-6413012026-1000x185.jpg", "width"=>1000, "height"=>185}, ...]
+
+guidebox_tv.background_images("entourage")
+# => [{"original"=>{"url"=>"http://static-api.guidebox.com/012915/shows/backgrounds/6085-96932638085-133215735918-888.jpg", "width"=>1280, "height"=>720}, "original_width"=>1280, "original_height"=>720, "image_rating"=>0}, ...] 
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release` to create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/GuideboxWrapper/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,9 @@
+require 'rspec/core/rake_task'
+require "bundler/gem_tasks"
+
+RSpec::Core::RakeTask.new(:spec) do |task|
+	task.rspec_opts = ['--color', '--format documentation']
+end
+
+task :default => :spec
+

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "GuideboxWrapper"
+
+# 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/lib/GuideboxWrapper.rb

@@ -0,0 +1,4 @@
+require_relative 'GuideboxWrapper/guidebox_wrapper'
+require_relative 'GuideboxWrapper/tv'
+require_relative 'GuideboxWrapper/movie'
+require_relative 'GuideboxWrapper/version'

data/lib/GuideboxWrapper/guidebox_wrapper.rb

@@ -0,0 +1,25 @@
+require 'json'
+require 'open-uri'
+
+module GuideboxWrapper
+  class Client
+    def query(url)
+      JSON.parse(open(url).read)
+    end
+  end
+  class GuideboxApi
+    def initialize(key, region)
+      @key = key
+      @region = region
+      @base_url = "http://api-public.guidebox.com/v1.43/#{region}/#{key}"
+      @client = Client.new
+    end
+
+    def quota
+      url = @base_url + "/quota"
+      results = @client.query(url)
+      results["monthly_quota"]["current"]
+    end
+
+  end
+end

data/lib/GuideboxWrapper/movie.rb

@@ -0,0 +1,265 @@
+require 'GuideboxWrapper/query_builders/movie/movie_query_builders'
+
+module GuideboxWrapper
+  class Movie < GuideboxApi
+    include MovieQueryBuilders
+    # Search for show
+    def search_for(name)
+      url = build_query(name)
+      url += '/fuzzy/web'
+      data = @client.query(url)
+      sleep(1)
+      data["results"]
+    end
+
+    # Search by provider
+    def search_for_by_provider(name, provider)
+      url = build_query(name)
+      url += '/fuzzy/' + provider + '/web'
+      data = @client.query(url)
+      data["results"]
+    end
+
+    def search_by_db_id(id, type)
+      url = @base_url
+      url += "/search/movie/id/"
+      case type
+      when "themoviedb"
+        url += "themoviedb/"
+        url += id.to_s
+      when "imdb"
+        url += "imdb/"
+        url += id
+      else
+        puts "That id type does not exist"
+        return
+      end
+      @client.query(url)
+    end
+
+    def show_information(name)
+      id = self.search_for(name).first["id"]
+      url = @base_url
+      url += "/movie/" + id.to_s
+      @client.query(url)
+    end
+
+    def cast(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["cast"]
+    end
+
+    def writers(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["writers"]
+    end
+
+    def directors(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["directors"]
+    end
+
+    def release_year(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["release_year"]
+    end
+
+    def release_date(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["release_date"]
+    end
+
+    def rating(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["rating"]
+    end
+
+    def duration(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["duration"]
+    end
+
+    def themoviedb_id(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["themoviedb"]
+    end 
+
+    def imdb_id(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["imdb"]
+    end
+
+    def rotten_tomatoes_id(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["rottentomatoes"]
+    end
+
+    def alternate_titles(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["alternate_titles"]
+    end
+
+    def freebase(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["freebase"]
+    end
+
+    def wikipedia_id(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["wikipedia_id"] 
+    end
+
+    def metacritic_link(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["metacritic"]
+    end
+
+    def overview(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["overview"]
+    end
+
+    def genres(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["genres"]
+    end
+
+    def tags(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["tags"]
+    end
+
+    def facebook_link(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["social"]["facebook"]["link"]
+    end
+
+    def web_trailers(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["trailers"]["web"]
+    end
+
+    def ios_trailers(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["trailers"]["ios"]
+    end
+
+    def android_trailers(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["trailers"]["android"]
+    end
+
+    def posters(name_or_id)
+      url = @base_url
+      id = set_name_or_id(name_or_id)
+      url += "/movie/" + id.to_s + "/images/posters"
+      results = @client.query(url)
+      results["results"]["posters"]
+    end
+
+    def thumbnail_images(name_or_id)
+      url = @base_url
+      id = set_name_or_id(name_or_id)
+      url += "/movie/" + id.to_s + "/images/thumbnails"
+      results = @client.query(url)
+      results["results"]["thumbnails"]
+    end
+
+    def banner_images(name_or_id)
+      url = @base_url
+      id = set_name_or_id(name_or_id)
+      url += "/movie/" + id.to_s + "/images/banners"
+      results = @client.query(url)
+      results["results"]["banners"]
+    end
+
+    def background_images(name_or_id)
+      url = @base_url
+      id = set_name_or_id(name_or_id)
+      url += "/movie/" + id.to_s + "/images/backgrounds"
+      results = @client.query(url)
+      results["results"]["backgrounds"]
+    end
+
+    def free_web_sources(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["free_web_sources"]
+    end
+
+    def free_ios_sources(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["free_ios_sources"]
+    end
+
+    def free_android_sources(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["free_android_sources"]
+    end
+
+    def tv_everywhere_web_sources(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["tv_everywhere_web_sources"]
+    end
+
+    def tv_everywhere_ios_sources(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["tv_everywhere_ios_sources"]
+    end
+
+    def tv_everywhere_android_sources(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["tv_everywhere_android_sources"]
+    end
+
+    def subscription_web_sources(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["subscription_web_sources"]
+    end
+
+    def purchase_web_sources(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["purchase_web_sources"]
+    end
+
+    def purchase_ios_sources(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["purchase_ios_sources"]
+    end
+
+    def purchase_android_sources(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["purchase_android_sources"]
+    end
+  end
+end

data/lib/GuideboxWrapper/query_builders/movie/movie_query_builders.rb

@@ -0,0 +1,29 @@
+module MovieQueryBuilders
+  def build_query(name)
+    url = @base_url
+    words = name.split(" ")
+    url += "/search/movie/title/"
+    for word in words
+      url += word
+      unless word == words.last
+        url += "+"
+      end
+    end
+    url
+  end
+
+  def search_and_set_url(name)
+    id = self.search_for(name).first["id"]
+    url = @base_url
+    url + "/movie/" + id.to_s
+  end
+
+  def set_name_or_id(name_or_id)
+    if name_or_id.is_a?(String)
+      id = self.search_for(name_or_id).first["id"]
+    else
+      id = name_or_id
+    end
+    id
+  end
+end

data/lib/GuideboxWrapper/query_builders/tv/tv_query_builders.rb

@@ -0,0 +1,29 @@
+module TvQueryBuilders
+  def build_query(name)
+    url = @base_url
+    words = name.split(" ")
+    url += "/search/title/"
+    for word in words
+      url += word
+      unless word == words.last
+        url += "+"
+      end
+    end
+    url
+  end
+
+  def search_and_set_url(name)
+    id = self.search_for(name).first["id"]
+    url = @base_url
+    url + "/show/" + id.to_s
+  end
+
+  def set_name_or_id(name_or_id)
+    if name_or_id.is_a?(String)
+      id = self.search_for(name_or_id).first["id"]
+    else
+      id = name_or_id
+    end
+    id
+  end
+end

data/lib/GuideboxWrapper/tv.rb

@@ -0,0 +1,231 @@
+require 'GuideboxWrapper/query_builders/tv/tv_query_builders'
+
+module GuideboxWrapper
+  class Tv < GuideboxApi
+    include TvQueryBuilders
+    # Search for show
+    def search_for(name)
+      url = build_query(name)
+      url += '/fuzzy/web'
+      data = @client.query(url)
+      sleep(1)
+      data["results"]
+    end
+
+    # Search by provider
+    def search_for_by_provider(name, provider)
+      url = build_query(name)
+      url += '/fuzzy/' + provider + "/web"
+      data = @client.query(url)
+      data["results"]
+    end
+
+    # Search for show by external db id
+    def search_by_db_id(id, type)
+      url = @base_url
+      url += "/search/id/"
+      case type
+      when "tvdb"
+        url += "tvdb/"
+        url += id.to_s
+      when "themoviedb"
+        url += "themoviedb/"
+        url += id.to_s
+      when "imdb"
+        url += "imdb/"
+        url += id
+      else
+        puts "That id type does not exist"
+        return
+      end
+      @client.query(url)
+    end
+
+    # Get all tv show info
+    def show_information(name)
+      id = self.search_for(name).first["id"]
+      url = @base_url
+      url += "/show/" + id.to_s
+      @client.query(url)
+    end
+
+    # Get all seasons of show by name
+    def seasons(name)
+      id = self.search_for(name).first["id"]
+      url = @base_url
+      url += "/show/" + id.to_s + "/seasons"
+      data = @client.query(url)
+      data["results"]
+    end
+
+    # Get the cast of show by show name
+    def cast(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["cast"]
+    end
+
+    # Get the status of show by name ex. Ended
+    def status(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["status"]
+    end
+
+    # Get type of show by name ex. TV
+    def type(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["type"]
+    end
+
+    # Get show first aired date by name
+    def first_aired(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["first_aired"]
+    end
+
+    # Get network aired on, ex HBO
+    def network(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["network"]
+    end
+
+    # Get channel information of show by name
+    def channel_information(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["channels"]
+    end
+
+    # Get runtime of show by name
+    def runtime(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["runtime"]
+    end
+
+    # Get genres of show by show name ex. Drama, Comedy
+    def genres(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["genres"]
+    end
+
+    # Get tags of show by name
+    def tags(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["tags"]
+    end
+
+    # Get overview or description of show by name
+    def overview(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["overview"]
+    end
+
+    # Get air day of the week by show name
+    def air_day_of_week(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["air_day_of_week"]
+    end
+
+    # Get air time of the day by show name
+    def air_time(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["air_time"]
+    end
+
+    # Get show rating by name ex. TV-MA
+    def rating(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["rating"]
+    end
+
+    # Get imdb id by show name
+    def imdb_id(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["imdb_id"]
+    end
+
+    # Get metacritic link by show name
+    def metacritic_link(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["metacritic"]
+    end
+
+    # Get wikipedia id by show name
+    def wikipedia_id(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["wikipedia_id"]
+    end
+
+    # Get facebook_link by show name
+    def facebook_link(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["social"]["facebook"]["link"]
+    end
+
+    # Get twitter_link by name
+    def twitter_link(name)
+      url = search_and_set_url(name)
+      results = @client.query(url)
+      results["social"]["twitter"]["link"]
+    end
+
+    # Gets all related tv shows by show id
+    def related_shows(name)
+      id = self.search_for(name).first["id"]
+      url = @base_url
+      url += "/show/" + id.to_s + "/related"
+      @client.query(url)
+    end
+
+    # Gets all tv show movie posters
+    def posters(name_or_id)
+      url = @base_url
+      id = set_name_or_id(name_or_id)
+      url += "/show/" + id.to_s + "/images/posters"
+      results = @client.query(url)
+      results["results"]["posters"]
+    end
+
+    # Gets all show thumbnail images by name or id
+    def thumbnail_images(name_or_id)
+      url = @base_url
+      id = set_name_or_id(name_or_id)
+      url += "/show/" + id.to_s + "/images/thumbnails"
+      results = @client.query(url)
+      results["results"]["thumbnails"]
+    end
+
+    # Gets all show banner images by name or id
+    def banner_images(name_or_id)
+      url = @base_url
+      id = set_name_or_id(name_or_id)
+      url += "/show/" + id.to_s + "/images/banners"
+      results = @client.query(url)
+      results["results"]["banners"]
+    end
+
+    # Gets all show background images by name or id
+    def background_images(name_or_id)
+      url = @base_url
+      id = set_name_or_id(name_or_id)
+      url += "/show/" + id.to_s + "/images/backgrounds"
+      results = @client.query(url)
+      results["results"]["backgrounds"]
+    end
+  end
+end

data/lib/GuideboxWrapper/version.rb

@@ -0,0 +1,3 @@
+module GuideboxWrapper
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,120 @@
+--- !ruby/object:Gem::Specification
+name: GuideboxWrapper
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Thomas Baird
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-12-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+description: This gem is a ruby wrapper for the Guidebox API. Guidebox is a big database
+  of movie/tv-show information. This gem allows you to query this api easily for different
+  pieces of data.
+email:
+- tbaird@mail.umw.edu
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- GuideboxWrapper.gemspec
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/GuideboxWrapper.rb
+- lib/GuideboxWrapper/guidebox_wrapper.rb
+- lib/GuideboxWrapper/movie.rb
+- lib/GuideboxWrapper/query_builders/movie/movie_query_builders.rb
+- lib/GuideboxWrapper/query_builders/tv/tv_query_builders.rb
+- lib/GuideboxWrapper/tv.rb
+- lib/GuideboxWrapper/version.rb
+homepage: https://github.com/tmobaird/GuideboxWrapper
+licenses:
+- MIT
+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.6
+signing_key: 
+specification_version: 4
+summary: A ruby wrapper for the Guidebox API.
+test_files: []