5 releases

0.1.4 Jul 1, 2021
0.1.3 Jun 25, 2021
0.1.2 Jun 3, 2021
0.1.1 Jun 3, 2021
0.1.0 Jun 1, 2021

#259 in #api-wrapper

Apache-2.0

14KB
125 lines

jokeapi_rs

Rust wrapper for JokeAPI

Get a joke

use jokeapi_rs::Joke;

fn main() {
    println!("{}", Joke::new().fetch().joke());
}

Get a joke of a certain type

Type can either be "single" or "twopart"

use jokeapi_rs::Joke;

fn main() {
    println!("{}", Joke::new().of_type("single").fetch().joke());
}

Get a joke which belongs to certain categories

use jokeapi_rs::Joke;

fn main() {
    println!(
        "{}",
        Joke::new()
            .categories(
                ["programming", "spooky"]
                    .iter()
                    .map(|x| x.to_string())
                    .collect()
            )
            .fetch()
            .joke()
    )
}

Get a Data struct which contains all the fields of the the result

use jokeapi_rs::structs::joke::Data;
use jokeapi_rs::structs::joke::DataKind;
use jokeapi_rs::Joke;

fn main() {
    let res: Data = Joke::new()
        .of_type("single")
        .categories(
            ["programming", "pun"]
                .iter()
                .map(|x| x.to_string())
                .collect(),
        )
        .blacklist(["sexist", "nsfw"].iter().map(|x| x.to_string()).collect())
        //.safe() // Uncomment to enable safe mode
        .fetch();

    // Get the joke
    // .joke() method on res does the following for you
    match res.kind.clone() {
        DataKind::TwoPart { setup, delivery } => {
            println!("{}\n{}", setup, delivery)
        }
        DataKind::Single { joke } => println!("{}", joke),
    }

    // Access all the json fields
    println!("{:#?}", res);
}

Dependencies

~6–18MB
~256K SLoC