Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Python3 client for accessing tv show information from

Project Description

Python3 client for accessing tv show information from


  • Lazy, you can search tvrage with quick-search and still get all the information as you would get with a full search about the specified show. When a Show object is asked to return information not provided by the search method used, it will query tvrage for the information.
  • Will handle the occasional database errors and information inconsistencies in the tvrage database sane and gracefully.
  • High-level api, handles all the XML stuff for you.


  • Searching

    • Full search

      Returns a list of Show objects.

      from import search
      results = search('Buffy')
      first = results[0] # => 'Buffy the Vampire Slayer'
    • Quick search

      Returns a show object, the closest match to search term or None.

      from import quick_info
      result = quick_info('Csi crime') # => 'CSI: Crime Scene Investigation'
      # Enable stricter matching
      result = quick_info('CSI crime', exact=True)
      result == None # => True
    • Search by id

      Returns a Show object, or None if id is incorrect.

      from import search_id
      result = search_id('2930') # => 'Buffy the Vampire Slayer'
  • Show objects

    Show objects should not be initialized manually, it should be done by one of the search functions, but for this example we do.

    from tvrage3.api import Show
    show = Show(show_id='3183')
    show.air_day        # => 'Wednesday'
    show.air_time       # => '22:00'
    show.classification # => 'Scripted'        # => 'US'
    show.ended_year     # => None
    show.genres         # => ['Action', 'Crime', 'Drama']           # => ''           # => 'CSI: Crime Scene Investigation'        # => OrderedDict([('@country', 'US'), ('#text', 'CBS')])
    show.runtime        # => 60
    show.seasons        # => 14
    show.show_id        # => '3183'
    show.started_year   # => 2000
    show.status         # => 'Returning Series'


0.1.1 (2014-05-10)

  • Fixed some style errors

0.1.0 (2014-05-10)

  • First release on PyPI.

Release History

This version
History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(7.2 kB) Copy SHA256 Hash SHA256
3.4 Wheel May 10, 2014
(14.6 kB) Copy SHA256 Hash SHA256
Source May 10, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting