Vylpes
031a5455b5
- Bump minimatch from 3.0.4 to 3.1.2 - Update discord links Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Ethan Lane <ethan@vylpes.com> Reviewed-on: https://gitea.vylpes.xyz/RabbitLabs/random-bunny/pulls/41 Reviewed-by: VylpesTester <tester@vylpes.com>
61 lines
1.1 KiB
Markdown
61 lines
1.1 KiB
Markdown
# random-bunny
|
|
|
|
> Get a random image url from a subreddit of your choosing.
|
|
|
|
## Install
|
|
|
|
```bash
|
|
npm install --save random-bunny
|
|
```
|
|
|
|
or if you're using yarn
|
|
|
|
```bash
|
|
yarn add random-bunny
|
|
```
|
|
|
|
|
|
## Usage
|
|
|
|
```ts
|
|
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](https://github.com/dylang/random-puppy)
|
|
|
|
## Links
|
|
|
|
* Discord: [Server Link](https://go.vylpes.xyz/A6HcA)
|
|
* Support: [helpdesk@vylpes.com](mailto:helpdesk@vylpes.com)
|
|
|
|
## License
|
|
|
|
MIT © [Vylpes](https://www.vylpes.com) |