Motion Giphy

A wrapper around http://giphy.com

Installation

Add this to your Gemfile:

gem "motion-giphy"

Then execute:

$ bundle

MotionGiphy relies on AFMotion to run so you'll need to install the neccessary pods.

# First get Cocoapods up and running.
$ pod setup

# Now install the needed pods.
$ rake pod:install

Usage

First you'll need to set your API. You can do this in the app_delegate.rb file.

MotionGiphy::Configuration.configure do |config|
  config.api_key = "API_KEY"
end

Giphy provide a development API key that you can use. If you're moving to production you'll need to contact them.

With the gem you can retrieve the Top 100 Gifs, search and get a specific Gif via it's ID.

MotionGiphy::Client.trending do |response|
end

MotionGiphy::Client.search("dancing") do |response|
end

MotionGiphy::Client.gif(gif_id) do |response|
end

All three methods will return a MotionGiphy::Response object. From here you can determine the state of the request, pagination details and either an array of Gifs (#search, #trending) or a single Gif (#id).

MotionGiphy::Client.search("dancing") do |response|
  if response.success?
    gif = response.data.first

    puts gif.id
    puts gif.giphy_url

    # Returns a MotionGiphy::Image
    puts gif.fixed_width.url
  else
    puts response.error.message
  end
end

To see all the methods you have access to I would recommend having a read through the MotionGiphy::Gif class and the MotionGiphy::Image class.