TvrageApi

tvrage_api is a simple ruby client for accessing TV shows information from the tvrage.com API.

Getting started

You can add it to your Gemfile with:

gem 'tvrage_api'

Run the bundle command to install it.

How to use

There is one entry point:

client = TvrageApi::Client.new

Search show by name:

client = TvrageApi::Client.new
client.search.by_name(show: 'buffy')
client.search.full_by_name(show: 'buffy')

Search show by id:

client = TvrageApi::Client.new
client.show.find(sid: '123')
client.show.find_full(sid: '123')
client.show.episodes(sid: '123') # show with all episodes
client.show.episode(sid: '123', ep: 'SEASONxEPISODE') # show with specific episode
client.show.all

QuickInfo (it return plain text, not parsed)

client = TvrageApi::Client.new
client.info.find(show: 'Alias') # main information
client.info.find(show: 'Alias', ep: '2x04') # episode information
client.info.find(show: 'Alias', exact: 1) # exact information

Schedule (quick method return plain text)

client = TvrageApi::Client.new
client.schedule.quick
client.schedule.full(country: 'US')

Recaps

client = TvrageApi::Client.new
client.recap.all
client.recap.show(show: 5410)
client.recap.last(days: 100)

Updates:

client = TvrageApi::Client.new
client.update.last # last 24 hours
client.update.last(hours: 48) # set timeline (default: 48)
client.update.last(sort: 'episodes') # only shows where episodes have changed
client.update.last(since: 1403668430) # updates since last visit

Contributing

1. Fork it
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 new Pull Request