Releases: tmobaird/GuideboxWrapper
Version 0.1.9 Release (Tv Update)
The main upgrade in this release is that some of the GuideboxTv helpers will return Tv objects that will allow you to access a dozen of its different attributes. The two new helpers are:
guidebox_tv.fetch_tv_show(name_or_id)
guidebox_tv.fetch_tv_show_by_db_id(<imdb, themoviedb id, or tvdb id>, type)
These methods will return Tv objects to you where you can access it's attributes as follows:
tv = guidebox_tv.fetch_tv_show("entourage")
tv.title
# => "Entourage"
tv.rating
# => "TV-MA"
There are a ton of other attributes that can be accessed, check the readme to see all of those.
This gem has also been optimized to allow it's user to use as few queries as possible to retrieve the information that they desire (because Guidebox limits to 100,000 queries a month). For example, it takes multiple queries to get images, seasons, related shows, and sources for tv show so when fetching a tv show these will not initially be set, eliminating four extra queries that would usually be used. To get that information, you can simply call 4 different setter methods that will query for that information and set it for your Tv object's corresponding attributes and you will not need to query for it again. Those helpers are as follows:
tv = guidebox_tv.fetch_tv_show("entourage")
tv.images=(<your api key>)
tv.sources=(<your api key>)
tv.seasons=(<your api key>)
tv.related=(<your api key>)
On top of all these additions to querying for tv shows, the fetch_tv_show_by_db_id
equivalent for movies has now been added: fetch_movie_by_db_id
. This is used in the same way that the tv equivalent is, and the only db types that can be used are imdb ids and the movie db ids.
Feel free to contact me or create an issue if you are having/seeing any problems. I hope you enjoy 👍
~ Thomas Baird
Adding of Media (Posters, Backgrounds, Banners, and Thumbnail images) to Movies
This release includes different types of media as attributes associated with returned Movie objects. These extra attributes can be accessed with an array of different methods.
You can get movie posters with the following
movie.posters
movie.large_posters
movie.medium_posters
movie.small_posters
You can also get movie backgrounds with:
movie.backgrounds
movie.xlarge_backgrounds
movie.large_backgrounds
movie.medium_backgrounds
movie.small_backgrounds
You can also get movie banners with:
movie.banners
movie.xlarge_banners
movie.large_banners
movie.medium_banners
movie.small_banners
Lastly, you can get movie thumbnail images with:
movie.thumbnails
movie.xlarge_thumbnails
movie.large_thumbnails
movie.medium_thumbnails
movie.small_thumbnails
Hope you all enjoy!
-Thomas Baird
Version 0.1.5 Release (Movies Update)
This update allows you to fetch a movie based upon the title or guidebox id, whichever you would like to use. This will return a Movie object with plenty of set attributes (title, cast, release_date, free sources, etc.). This means that you will only use 1 of the 100,000 queries allowed, per key, to the Guidebox API per month, and you will still be able to access all of the movie's information.
One thing to keep in mind is that the Movie objects will not include the images that go along with the movie (posters, backgrounds, etc.) These will require a separate helper method.
The next version will include this same modification, but return a Tv object instead of a Movie object. I would also like to add the Movie's/Tv Show's images to the classes as well.
Hope you all enjoy!
Initial Release
This is the initial release of the GuideboxWrapper gem. Thank you to all who plan on using this!