kitsu.rs's Introduction

kitsu.rs

An unofficial Rust library acting as a wrapper around the Kitsu API, offering implementations for both asynchronous hyper (v0.11) and synchronous reqwest (v0.8).

note: The library supports retrieval from the API, but does not currently support authenticated requests.

Compile features

hyper-support: Compiles with hyper support
reqwest-support: Compliles with reqwest support (default)

Installation

Add the following to your Cargo.toml file:

[dependencies]
kitsu = "0.2"

To enable both hyper and reqwest support:

[dependencies.kitsu]
version = "0.2"
features = ["hyper-support", "reqwest-support"]

To enable hyper but not reqwest support:

[dependencies.kitsu]
version = "0.2"
default-features = false
features = ["hyper-support"]

Examples

Using reqwest, search for an anime using a string taken from user input:

extern crate kitsu;
extern crate reqwest;

use kitsu::KitsuReqwestRequester;
use reqwest::Client;
use std::io::{self, Write};

fn main() {
    // Create the reqwest Client.
    let client = Client::new();

    // Read an anime name to search for from the users input.
    let mut input = String::new();
    print!("Enter an anime name to search for:\n>");
    let _ = io::stdout().flush();
    io::stdin().read_line(&mut input).expect("Error reading input");
    let input_trimmed = input.trim();

    // Search for the anime.
    let anime = client.search_anime(|f| f.filter("text", input_trimmed))
        .expect("Error searching for anime");

    // Print out the response of the request.
    if let Some(ref picked) = anime.data.first() {
        let title = &picked.attributes.canonical_title;

        if let Some(ref rating) = picked.attributes.average_rating {
            println!("Found Anime: {} - {}", title, rating);
        } else {
            println!("Found Anime: {} - ??", title);
        }
    } else {
        println!("No Anime Found.");
    }
}