Python client for The TVDB REST API

Johann Schmitz dcac5bdd37
Fix travis build
7 months ago
tests Respect timezone when converting datetime objects to epoch 11 months ago
tvdbrest Respect timezone when converting datetime objects to epoch 11 months ago
.gitignore Implemented first api calls 11 months ago
.travis.yml Drop pypy 11 months ago
Jenkinsfile Update Jenkinsfile 7 months ago
LICENSE.txt Initial commit 11 months ago
Makefile Fix travis build 7 months ago
README.md Add badges to README.md 11 months ago
requirements.txt Implemented first api calls 11 months ago
requirements_dev.txt Update requirements_dev and Makefile 8 months ago
setup.py Add setup.py 11 months ago
sonar-project.properties Add Jenkinsfile and update sonar-project.properties 7 months ago

README.md

tvdb-rest

Build Status Coverage Status

tvdb-rest is a client implementation of the TVDB REST API. This library does not support the "old" XML api!

tvdb-rest supports Python 3.4+. Python 2.7 may work, but isn't supported.

Usage

To use the REST API, you need an TVDB API key. See http://thetvdb.com/wiki/index.php?title=Programmers_API on how to obtain one.

from tvdbrest.client import TVDB
api = TVDB("myusername", "myuserkey", "myapikey")

for language in api.languages():
    print(language)

# search for series
search_results = api.search(name='The Simpsons')
for series in search_results:
    print(series)

# fetch series by id
simpsons = api.series(71663)

# access actors of series object
for actor in simpsons.actors():
    print("%s as %s" % (actor, ', '.join(actor.role.split('|'))))

# list all episodes for series (pagination handled automatically)
for episode in simpsons.episodes():
    print(episode)

License

See LICENSE.txt