Skip to main content

A Python wrapper for TheTVDb Database API v2

Project description

https://travis-ci.org/phate89/tvdbsimple.svg?branch=master

tvdbsimple is a wrapper, written in Python, for TheTVDB API v2. By calling the functions available in tvdbsimple you can simplify your code and easily access a vast amount of tv series data. To learn more about TheTVDb API, check out the website api page.

Features

  • Full API implementation. Supports Search, Series, Episode, Updated, User and Languages methods.

  • Updated with the latest JSON API.

  • Fully tested with automated tests and travis.ci.

  • Supports Python 2.7, 3.3, 3.4, 3.5, 3.6.

  • Easy to access data using Python class attributes.

  • Easy to experiment with tvdbsimple functions inside the Python interpreter.

Installation

tvdbsimple is available on the Python Package Index (PyPI).

You can install tvdbsimple using one of the following techniques:

  • Use pip: pip install tvdbsimple

  • Download the .zip or .tar.gz file from PyPI and install it yourself

  • Download the source from Github and install it yourself

If you install it yourself, also install requests.

API Key

You will need an API key to TheTVDb to access the API. To obtain a key, follow these steps:

  1. Register for and verify an account.

  2. Log into your account.

  3. Go to this page and fill your details to generate a new API key.

Documentation

All the functions are fully documented in the docs folder and in the github wiki page but you can find several use examples in the examples page.

Issues

If you find any issue please post in the github issue page with all the information possible to reproduce the issue

Support

  • If you would like contribute to the projects, feel free to do: fork, pull-request, issues, etc… They’re higly welcome

  • Instead if you would like offer me a coffee or beer: Donate with PayPal

Thanks

  • To celiao, her tmdbsimple module inspired my work here

  • To BurntSushi, his pdoc module helped me documenting the module

  • To TheTVDb website for providing the content and the api

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

tvdbsimple-1.0.6.tar.gz (11.9 kB view details)

Uploaded Source

File details

Details for the file tvdbsimple-1.0.6.tar.gz.

File metadata

  • Download URL: tvdbsimple-1.0.6.tar.gz
  • Upload date:
  • Size: 11.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.0

File hashes

Hashes for tvdbsimple-1.0.6.tar.gz
Algorithm Hash digest
SHA256 a8665525fa8b7aaf1e15fc3eec18b6f181582e25468830f300ab3809dbe948fe
MD5 fd9165e3082efe122f8130b7fa4577ab
BLAKE2b-256 737db8e4d5c5473d6f9a492bf30916fdbf96f06034e6d23fde31ccb86704e41c

See more details on using hashes here.

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