random-bunny/readme.md

51 lines
830 B
Markdown
Raw Normal View History

2020-12-20 19:39:03 +00:00
# random-bunny
2016-04-27 20:06:24 +01:00
2020-12-20 19:39:03 +00:00
> Get a random image url from a subreddit of your choosing.
2016-04-27 20:06:24 +01:00
## Install
```
2020-12-20 19:39:03 +00:00
$ npm install --save random-bunny
2016-04-27 20:06:24 +01:00
```
## Usage
```js
2020-12-20 19:39:03 +00:00
const randomBunny = require('random-bunny');
2016-04-27 20:06:24 +01:00
2021-03-01 18:15:51 +00:00
randomBunny('rabbits', 'new', res => {
console.log(res.title + ": " + res.url);
2020-12-20 19:39:03 +00:00
});
2016-04-27 20:06:24 +01:00
```
## API
2020-12-20 19:39:03 +00:00
### `randomBunny()`
2016-04-27 20:06:24 +01:00
2021-03-01 18:15:51 +00:00
Returns a `json string` for a random post to the `callback`. Accepts 3 arguments: `subreddit`, `sortby` ('new', 'hot', 'top'), `callback(res)`
The json string which gets returned consists of:
- archived
- downs
- hidden
- permalink
- subreddit
- subredditSubscribers
- title
- ups
- url
2016-04-29 03:23:21 +01:00
2016-04-27 20:12:06 +01:00
## Notes
* Node 4 or newer.
2020-12-20 19:39:03 +00:00
* based upon [Random Puppy](https://github.com/dylang/random-puppy)
## Links
* Discord: [Server Link](https://discord.gg/UyAhAVp)
2016-04-27 20:06:24 +01:00
## License
2021-03-01 18:15:51 +00:00
MIT © [Vylpes](https://gitlab.vylpes.com/Vylpes)