Skip to main content

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.

Source Distribution

tvrage3-0.1.1.tar.gz (14.6 kB view hashes)

Uploaded Source

Built Distribution

tvrage3-0.1.1-py3-none-any.whl (7.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page