No description

Find a file

Renovate Bot fdd49a94b9 Update dependency @types/node to v18		2022-12-28 18:51:48 +00:00
.github	Create FUNDING.yml	2021-05-10 21:50:20 +01:00
.gitlab	Update default.md	2021-01-15 18:15:14 +00:00
src	Fix type error (#34 )	2022-08-12 17:10:03 +01:00
.drone.yml	Fix type error (#34 )	2022-08-12 17:10:03 +01:00
.eslintrc	Update .eslintrc	2021-01-16 22:16:20 +00:00
.gitignore	Replace fetch with got	2021-12-01 20:39:02 +00:00
.gitlab-ci.yml	Add aslant to gitlab project ci	2021-01-13 21:08:47 +00:00
.npmignore	rewrite in typescript	2021-12-01 20:32:20 +00:00
app.ts	rewrite in typescript	2021-12-01 20:32:20 +00:00
CODE_OF_CONDUCT.md	Update documentation with up to date information	2022-08-18 17:45:05 +01:00
CONTRIBUTING.md	hotfix/2.0.3 (#40 )	2022-12-18 15:26:53 +00:00
license	Resolve "Create documentation"	2021-01-13 20:38:31 +00:00
LICENSE	Resolve "Create documentation"	2021-01-13 20:38:31 +00:00
package.json	Update dependency @types/node to v18	2022-12-28 18:51:48 +00:00
readme.md	hotfix/2.0.3 (#40 )	2022-12-18 15:26:53 +00:00
renovate.json	Update 'renovate.json'	2022-12-28 18:43:41 +00:00
tsconfig.json	Fix type error (#34 )	2022-08-12 17:10:03 +01:00
yarn.lock	Update dependency @types/node to v18	2022-12-28 18:51:48 +00:00

readme.md

random-bunny

Get a random image url from a subreddit of your choosing.

Install

npm install --save random-bunny

or if you're using yarn

yarn add random-bunny

Usage

import randomBunny from "random-bunny";

// ... In an async function
const result = await randomBunny('rabbits', 'hot', 100);
console.log(result);

API

`randomBunny()`

Returns a json string for a random post. Accepts 3 arguments: subreddit, sortby ('new', 'hot', 'top'), maxTries? (default 100)

The json string which gets returned consists of:

archived
downs
hidden
permalink
subreddit
subredditSubscribers
title
ups
url

sortBy will default to 'hot' if not given or invalid

maxTries prevents the script from rerolling too many times. The script rerolls the randomiser if the post its given doesn't contain an image. Default 100.

Notes

Node 4 or newer.
based upon Random Puppy