motion-giphy 1.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d1183020c545e3dbe18e10a8ca8b48d465720e07
+  data.tar.gz: 63860430c1c747d8cc0c76be51e41785aa4884ff
+SHA512:
+  metadata.gz: 5decaab9279ad5439a945b30a90cecc61578a7c35a029dab514860429e7bd2cb3bd4c391c637471c5b32439b0f335d62ae2a8ba206821790312d3d196b04518b
+  data.tar.gz: 31ee0f84d28ce025dafe1e84d6a53aa35691e9eaaff7fb257b44dfaac2aec06a86a988bb9371eb4620bd00282c9cfd8d1acd11eca6bb05531c88d91a278c033a

data/README.md

@@ -0,0 +1,77 @@
+# Motion Giphy
+> A wrapper around http://giphy.com
+
+![](http://media1.giphy.com/media/r2BtghAUTmpP2/200.gif)
+
+## Installation
+
+Add this to your Gemfile:
+```ruby
+gem "motion-giphy"
+```
+
+Then execute:
+
+```
+$ bundle
+```
+
+MotionGiphy relies on [AFMotion](https://github.com/usepropeller/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.
+
+```ruby
+MotionGiphy::Configuration.configure do |config|
+  config.api_key = "API_KEY"
+end
+```
+
+[Giphy](http://giphy.com/api) 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.
+
+```ruby
+MotionGiphy::Client.trending do |response|
+end
+```
+
+```ruby
+MotionGiphy::Client.search("dancing") do |response|
+end
+```
+
+```ruby
+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`).
+
+```ruby
+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.
+

data/lib/motion-giphy.rb

@@ -0,0 +1,10 @@
+require "afmotion"
+
+unless defined?(Motion::Project::Config)
+  raise "This file must be required within a RubyMotion project Rakefile."
+end
+
+lib_dir_path = File.dirname(File.expand_path(__FILE__))
+Motion::Project::App.setup do |app|
+  app.files.unshift(Dir.glob(File.join(lib_dir_path, "motion-giphy/*.rb")))
+end

data/lib/motion-giphy/client.rb

@@ -0,0 +1,30 @@
+module MotionGiphy
+  class Client
+    def self.search(query, options = {}, &block)
+      options = { q: query }.merge(options)
+
+      request.get("search", options) do |response|
+        response.process_data_as_batch if response.success?
+        block.call response
+      end
+    end
+
+    def self.gif(id, &block)
+      request.get("#{id}") do |response|
+        response.process_data_as_singular if response.success?
+        block.call response
+      end
+    end
+
+    def self.trending(options = {}, &block)
+      request.get("trending", options) do |response|
+        response.process_data_as_batch if response.success?
+        block.call response
+      end
+    end
+
+    def self.request
+      MotionGiphy::Request.new
+    end
+  end
+end

data/lib/motion-giphy/configuration.rb

@@ -0,0 +1,16 @@
+module MotionGiphy
+  class Configuration
+    class << self
+      attr_writer :api_key
+
+      def configure(&block)
+        yield self
+        self
+      end
+
+      def api_key
+        @api_key
+      end
+    end
+  end
+end

data/lib/motion-giphy/error.rb

@@ -0,0 +1,10 @@
+module MotionGiphy
+  class Error
+    attr_reader :message, :error
+
+    def initialize(error)
+      @error = error
+      @message = error.localizedDescription
+    end
+  end
+end

data/lib/motion-giphy/gif.rb

@@ -0,0 +1,59 @@
+module MotionGiphy
+  class Gif
+    def self.process_batch(data)
+      data.map { |gif_hash| new(gif_hash) }
+    end
+
+    attr_reader :hash
+
+    def initialize(hash)
+      @hash = hash
+    end
+
+    def id
+      hash["id"]
+    end
+
+    def giphy_url
+      hash["url"]
+    end
+
+    def original
+      image.new(images["original"])
+    end
+
+    def fixed_width
+      image.new(images["fixed_width"])
+    end
+
+    def fixed_width_downsampled
+      image.new(images["fixed_width_downsampled"])
+    end
+
+    def fixed_height
+      image.new(images["fixed_height"])
+    end
+
+    def fixed_height_downsampled
+      image.new(images["fixed_height_downsampled"])
+    end
+
+    def fixed_width_still
+      image.new(images["fixed_width_still"])
+    end
+
+    def fixed_height_still
+      image.new(images["fixed_height_still"])
+    end
+
+    private
+
+    def images
+      hash["images"]
+    end
+
+    def image
+      MotionGiphy::Image
+    end
+  end
+end

data/lib/motion-giphy/image.rb

@@ -0,0 +1,13 @@
+module MotionGiphy
+  class Image
+    attr_reader :url, :width, :height, :frames, :size
+
+    def initialize(image_hash)
+      @url = image_hash["url"]
+      @width = image_hash["width"]
+      @height = image_hash["height"]
+      @frames = image_hash["frames"]
+      @size = image_hash["size"]
+    end
+  end
+end

data/lib/motion-giphy/meta.rb

@@ -0,0 +1,10 @@
+module MotionGiphy
+  class Meta
+    attr_reader :message, :status
+
+    def initialize(meta)
+      @message = meta["message"]
+      @status = meta["status"]
+    end
+  end
+end

data/lib/motion-giphy/pagination.rb

@@ -0,0 +1,11 @@
+class MotionGiphy
+  module Pagination
+    attr_reader :total, :count, :offset
+
+    def initialize(pagination)
+      @total = pagination["total_count"]
+      @count = pagination["count"]
+      @offset = pagination["offset"]
+    end
+  end
+end

data/lib/motion-giphy/request.rb

@@ -0,0 +1,28 @@
+module MotionGiphy
+  class Request
+    def get(path, options = {}, &block)
+      client.get(path, create_options(options)) do |result|
+        block.call response.build_with_result(result)
+      end
+    end
+
+    private
+
+    def client
+     AFMotion::SessionClient.build("http://api.giphy.com/v1/gifs/") do
+        session_configuration :default
+        header "Accept", "application/json"
+        response_serializer :json
+      end
+    end
+
+    def response
+      MotionGiphy::Response
+    end
+
+    def create_options(options)
+      api_key = MotionGiphy::Configuration.api_key
+      { api_key: api_key }.merge(options)
+    end
+  end
+end

data/lib/motion-giphy/response.rb

@@ -0,0 +1,45 @@
+module MotionGiphy
+  class Response
+    def self.build_with_result(result)
+      response = self.new
+
+      if result.success?
+        response.success = true
+        response.json = result.object
+      else
+        response.success = false
+        response.error = MotionGiphy::Error.new(result.error)
+      end
+
+      response
+    end
+
+    attr_accessor :data, :json, :success, :error
+
+    def process_data_as_singular
+      self.data = gif.new(self.json["data"])
+    end
+
+    def process_data_as_batch
+      self.data = gif.process_batch(self.json["data"])
+    end
+
+    def pagination
+      @pages ||= MotionGiphy::Pagination.new(json["pagination"])
+    end
+
+    def meta
+      @meta ||= MoptionGiphy::Meta.new(json["meta"])
+    end
+
+    def success?
+      @success
+    end
+
+    private
+
+    def gif
+      MotionGiphy::Gif
+    end
+  end
+end

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification
+name: motion-giphy
+version: !ruby/object:Gem::Version
+  version: 1.2.0
+platform: ruby
+authors:
+- Will Raxworthy
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: motion-cocoapods
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: afmotion
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Giphy API wrapper for RubyMotion
+email:
+- git@willrax.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/motion-giphy/client.rb
+- lib/motion-giphy/configuration.rb
+- lib/motion-giphy/error.rb
+- lib/motion-giphy/gif.rb
+- lib/motion-giphy/image.rb
+- lib/motion-giphy/meta.rb
+- lib/motion-giphy/pagination.rb
+- lib/motion-giphy/request.rb
+- lib/motion-giphy/response.rb
+- lib/motion-giphy.rb
+homepage: ''
+licenses:
+- ''
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.14
+signing_key: 
+specification_version: 4
+summary: Giphy API wrapper for RubyMotion
+test_files: []