Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

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.

Project details

Download files

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

Files for tvrage3, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size tvrage3-0.1.1-py3-none-any.whl (7.2 kB) File type Wheel Python version 3.4 Upload date Hashes View
Filename, size tvrage3-0.1.1.tar.gz (14.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page