hubot-giphy-gifme
Get a random GIF from Giphy! Search by tags! Yeah!
Last updated 4 years ago by bencentra .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install hubot-giphy-gifme 
SYNC missed versions from official npm registry.

hubot-giphy-gifme

Get a random GIF from Giphy! Search by tags! Yeah!

Built with the wonderful Giphy API.

Commands

  • hubot gif me or hubot giphy returns a random GIF
  • hubot gif me american psycho or hubot giphy american psycho returns a random GIF tagged with "american" and "psycho"
  • hubot gif me /search american psycho or hubot giphy /search american psycho returns a random GIF selected from the search results for "american psycho" (using the /search endpoint instead of the default /random)

You can include tags in a number of ways:

  • Space delimited: hubot gif me american psycho
  • Comma separated: hubot gif me american, psycho
  • Quoted: hubot gif me "american psycho"

These will all result in the same search "american+psycho". See the random endpoint docs for more info.

Usage

In your hubot instance, include this script like so:

external-scripts.json

[
  ...
  "hubot-giphy-gifme"
]

package.json

{
  ...
  "dependencies": {
    ...
    "hubot-giphy-gifme": "^1.0.0"
  }
}

You can configure the script with the following environment variables:

  • HUBOT_GIPHY_API_KEY - Your Giphy API key. Uses Giphy's demo API key as a default. You can request your own here.
  • HUBOT_GIPHY_RATING - The maximum allowed GIF rating (to prevent NSFW results). Possible values are: y, g, pg, pg-13 or r. Defaults to pg.
  • HUBOT_GIPHY_FORCE_HTTPS - If true, transform all search results from http to https. Defaults to false.
  • HUBOT_GIPHY_INLINE_IMAGES - If true, send results as in-line images instead of raw URLs. Defaults to false
  • HUBOT_GIPHY_DEFAULT_ENDPOINT - The default Giphy API endpoint to use for searches. Defaults to /random.
  • HUBOT_GIPHY_RESULTS_LIMIT - The number of results to return when getting GIFs from the /search endpoint. Defaults to 25.

Contributing

  • Fork/clone this project
  • Run bootstrap script (installs dependencies, etc): npm start
  • Make and test your changes
    • Test against a local hubot instance (see below)
    • Run and update the tests: npm test
  • Submit a PR and badger bencentra until it is merged and a new version is published

Setting Up a Hubot Instance

See the hubot docs for info on setting up your own hubot instance.

To run Hubot with your local copy of hubot-giphy-gifme, add it to the scripts/ directory:

mkdir hubot/scripts
cp hubot-giphy-gifme/src/giphy-gifme.coffee hubot/scripts/giphy-gifme.coffee

You can set the additional environment variable DEBUG to enable console output:

DEBUG=* bin/hubot

License

MIT. See LICENSE.md.

Current Tags

  • 0.2.0                                ...           latest (4 years ago)

12 Versions

  • 0.2.0                                ...           4 years ago
  • 0.1.9                                ...           4 years ago
  • 0.1.8                                ...           4 years ago
  • 0.1.7                                ...           4 years ago
  • 0.1.6                                ...           4 years ago
  • 0.1.5                                ...           4 years ago
  • 0.1.4                                ...           5 years ago
  • 0.1.3                                ...           5 years ago
  • 0.1.2                                ...           5 years ago
  • 0.1.1                                ...           5 years ago
  • 0.1.0                                ...           5 years ago
  • 1.0.0                                ...           5 years ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (1)
Dev Dependencies (2)
Dependents (1)

Copyright 2014 - 2016 © taobao.org |