npm.io
1.5.1 • Published 1 year ago

purrbot-api

Licence
MIT
Version
1.5.1
Deps
0
Size
63 kB
Vulns
0
Weekly
0
Stars
2

Purrbot.site API Wrapper

The official Wrapper for the purrbot.site API

100% API Coverage
100% TypeScript Coverage
100% JSDoc Coverage
100% Test Coverage

Getting started

import PurrBot from 'purrbot-api';

PurrBot.get('img', false, 'neko'); // returns Promise<string>
PurrBot.list('gif', false, 'neko'); // returns Promise<string[]>

PurrBot.sfw.get('gif', 'neko'); // returns Promise<string>
PurrBot.sfw.list('gif', 'neko'); // returns Promise<string[]>
PurrBot.sfw.gif.get('neko'); // returns Promise<string>
PurrBot.sfw.gif.list('neko'); // returns Promise<string[]>
PurrBot.sfw.img.get('neko'); // returns Promise<string>
PurrBot.sfw.img.list('neko'); // returns Promise<string[]>
PurrBot.sfw.categories.neko('gif'); // returns Promise<string>
PurrBot.sfw.categories.senko(); // returns Promise<string>

// NSFW Categories have the same Syntax

PurrBot.owoify("Hello World!"); // returns Promise<string>
PurrBot.owoify("Hello World!", { emoticons: true }); // returns Promise<string>
PurrBot.owoify("Hello World!", { replaceWords: true, stutter: true }); // returns Promise<string>

Options

NSFW / SFW Categories:

imgType: either `img` or `gif`
nsfw: boolean
category: string

Owoify:

text: string
sutter?: boolean
replaceWords?: boolean
emoticons?: boolean

Support

If you need Help, please contact me at Discord or open an Issue on GitHub


Contributing

I will happily accept your Pull-Request if it:

  • looks reasonable
  • does not break backwards compatibility