ClarityCafe / Sagiri

Simple, lightweight, and easy to use SauceNAO API wrapper for Node.JS.
MIT License
97 stars 13 forks source link
async hacktoberfest js lightweight node-js nodejs promise saucenao saucenao-api simple

Sagiri

A simple and lightweight NodeJS wrapper for SauceNAO.

NPM Downloads Badge FOSSA Status

Installation

yarn add sagiri
# or with npm
npm install sagiri
# or with deno
deno add @clarity/sagiri

Usage

const sagiri = require("sagiri");

const client = sagiri("token");
const results = await client("http://i.imgur.com/5yFTeRV.png");

sagiri is a function that returns an async function, so you can call it and store it in a variable to use multiple times, or you can call it and use it immediately.

Sagiri also has the ability to provide [options]() both when calling the main function, and the given async function.

const client = sagiri("client", { results: 10 });
const results = await client("http://i.imgur.com/5yFTeRV.png", { mask: [5] });

API

sagiri(token: string, defaultOptions?: Options)
Creates a function to be used for finding potential sources for a given image.
By default has options set to give 5 results from SauceNAO.

You can get a token for SauceNAO by registering an account and going to the API page.

Returns async function (file: File, optionOverrides?: Options) which is loaded with the given token and default options to use.

Options

Options takes the form of a simple object passed to either the constructor function or the request function, which covers the options available in the SauceNAO API.

A basic overview of this object looks like this:

{
  results?: number;
  mask?: number[];
  excludeMask?: number[];
  testMode?: boolean;
  db?: number;
}

Contributing

Any contributions to this project are welcome, but please be sure to read over our contributing guidelines.

License

The code contained within this repository is licensed under the MIT License. See LICENSE for more information.

FOSSA Status