Giphy
Because GIFs make life fun! Use Giphy API from your Ruby programs and command line. Check out Giphy Labs for inspiration.
Installation
Add this line to your application's Gemfile:
gem 'giphy'
And then execute:
$ bundle
Or install it yourself as:
$ gem install giphy
Usage
Set the API version
and api_key
:
Giphy::Configuration.configure do |config|
config.version = THE_API_VERSION
config.api_key = YOUR_API_KEY
end
Important: Giphy API is currently in public beta. Unless version
and api_key
are set
to specific values the default values for the beta period will be used. Check
Giphy's API for updates.
That's it, you're ready to have fun!
Trending
Giphy.trending(limit: 5)
Translate
Giphy.translate('geek')
Search
Giphy.search('funny cat', {limit: 50, offset: 25})
Favorites
Write
Giphy.favorite('12HoHdqnDxz5NS')
Read
Giphy.favorites('absurdnoise', {limit: 50, offset: 25})
Screensaver
Giphy.screensaver('surprise')
Random
Giphy.random
For getting random gifs with a specific tag:
Giphy.random('american psycho')
GIFs by ID
Giphy.gif_by_id('feqkVgjJpYtjy', '12HoHdqnDxz5NS', '7rzbxdu0ZEXLy')
Command Line Tool
There is a small command line tool that let's you search for GIFs from the command line and opens it on your browser. Just for fun.
$ giphy 'dance'
Supported Ruby Versions
This library aims to support and is tested against the following Ruby implementations:
- Ruby 1.9
- Ruby 2.0
- Ruby 2.1
- Ruby 2.2
Contributing
- Fork it
- Create your feature branch:
git checkout -b my-new-feature
- Run tests:
rake
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Create new Pull Request
License
See LICENSE for details.