thetvdb

Crates.iothetvdb
lib.rsthetvdb
version0.1.0-beta.2
sourcesrc
created_at2020-01-23 13:24:31.951507
updated_at2020-02-11 18:52:22.151285
descriptionTheTVDB API async client
homepage
repositoryhttps://github.com/roignpar/thetvdb
max_upload_size
id201253
size180,975
(roignpar)

documentation

README

thetvdb

crates.io Released API docs License Minimum rustc version CI

TheTVDB API V3 Rust async client.

Minimum Rust version: 1.40.0

In order to use this client you will need an API key. To create a new API key log in and go to the API Keys page.

NOTE: Because it depends on reqwest, thetvdb currently only works with tokio.

Install

Add with cargo edit:

cargo add thetvdb

or add to Cargo.toml:

[dependencies]
thetvdb = "0.1.0-beta.2"

Use

Search series by title:

use thetvdb::{Client, params::SearchBy};

let client = Client::new("YOUR_API_KEY").await?;
let search_results = client.search(SearchBy::Name("Planet Earth")).await?;

For more examples check the documentation.

Supported requests:

Authentication

  • POST /login (used internally; cannot be manually requested)

Episodes

  • GET /episodes/{id}

Languages

  • GET /languages
  • GET /languages/{id}

Movies

  • GET /movies/{id}
  • GET /movieupdates

Search

  • GET /search/series

Series

  • GET /series/{id}
  • HEAD /series/{id}
  • GET /series/{id}/actors
  • GET /series/{id}/episodes
  • GET /series/{id}/episodes/query
  • GET /series/{id}/episodes/summary
  • GET /series/{id}/filter
  • GET /series/{id}/images
  • GET /series/{id}/images/query
  • GET /series/{id}/images/query/params

Updates

  • GET /updated/query

Integration tests

export THETVDB_APIKEY=<API_KEY>
cargo t --test client

License

Licensed under either of Apache License, Version 2.0 or MIT at your option.

Commit count: 203

cargo fmt