#source #search #find #async-api #library

sauce-api

API for searching for the original source of images

16 releases (1 stable)

1.0.0 Nov 24, 2022
0.9.3 Jan 23, 2022
0.9.2-alpha.2 Dec 29, 2021
0.9.1 Sep 7, 2021
0.5.1 Nov 17, 2020

#1449 in Web programming

Download history 68/week @ 2024-07-23 18/week @ 2024-07-30 1/week @ 2024-09-17 11/week @ 2024-09-24 7/week @ 2024-10-01

55 downloads per month

MIT license

21KB
484 lines

sauce-api

documentation crates.io

sauce-api is an API for finding the source image for low-quality or cropped images.
Currently it only works with anime-styled images, but I hope to makeit capable of doing other kinds of images as well.

Asynchronous due to the usage of reqwest, and works best with Tokio.

Supported Sources

If you wish to see more, please submit PRs or a request in an issue!

Usage

IQDB

use sauce_api::source::{Output, iqdb::Iqdb, Source};
use sauce_api::error::Error;

async fn find_source(url: &str) {
    let source = Iqdb::create(()).await.unwrap();
    let res: Result<Output, Error> = source.check(url).await; // Can take some time as IQDB is a bit slow.

    match res {
        Ok(result) => {
            println!("Found results! {:?}", result);
        }
        Err(e) => {
            eprintln!("Unable to find results: {}", e);
        }
    }
}

SauceNao

use sauce_api::source::{Output, saucenao::SauceNao, Source};
use sauce_api::error::Error;

async fn find_source(url: &str, api_key: &str) {
    let source = SauceNao::create(api_key.to_string()).await.unwrap();
    let res: Result<Output, Error> = source.check(url).await;

    match res {
        Ok(result) => {
            println!("Found results! {:?}", result);
        }
        Err(e) => {
            eprintln!("Unable to find results: {}", e);
        }
    }
}

Requirements

sauce-api by default uses the native TLS framework, see this for specific details. You may opt-in to using rustls if you would like to by enabling the rustls feature like this:

sauce-api = { version = "1.0.0", features = ["rustls"] }

Dependencies

~4–17MB
~232K SLoC