furbooru

Crates.iofurbooru
lib.rsfurbooru
version0.4.0
sourcesrc
created_at2020-06-13 02:20:11.292537
updated_at2021-09-07 11:40:28.204695
descriptionAn async Furbooru/Derpibooru client for Rust
homepagehttps://github.com/Xe/furbooru
repositoryhttps://github.com/Xe/furbooru
max_upload_size
id253460
size122,636
Xe Iaso (Xe)

documentation

README

furbooru

built with nix Rust MIT License Crates.io docs

A Furbooru and Derpibooru client written in Rust. The APIs for these two sites are near identical, so this crate can work with both; however it is optimized for Furbooru. Any time Furbooru diverges from Derpibooru, this crate will follow the Furbooru changes first.

Usage is simple:

let user_agent = format!(
  "{}/{} ({}, +{})",
  env!("CARGO_PKG_NAME"),
  env!("CARGO_PKG_VERSION"),
  std::env::var("API_USERNAME").unwrap(),
  env!("CARGO_PKG_REPOSITORY"),
);

let cli = furbooru::Client::new(
  user_agent,
  std::env::var("API_TOKEN").unwrap(),
)?

Set the environment variables API_USERNAME and API_TOKEN to your Furbooru/Derpibooru username and API token respectively. Adding the username associated with your bot to each request can help the booru staff when your bot does unwanted things like violating rate limits.

See the examples for more ideas.

Commit count: 34

cargo fmt