giphy 0.0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    YzI1NDkwMDYxMzc3YzFkMjU4OTI3YjYzYjVjYTc4M2RiZGEwNzM5Nw==
+  data.tar.gz: !binary |-
+    NDMyYTFlNzU1YzljZjFhNjY5MDE2OGIyZTZjYzlkYzdjYjkwZjBjYg==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    OTYyZjNmODMwYmRhMTljYzNlOTVmMDg2ZTEyNzg2M2NiNTRiM2MyNWI1ZWYx
+    ODBmZWZkOWU5MWY5MjBiNTVlZmYyYzMxM2VhMWJlOTU1ODhiYzdlYTQ4OTlj
+    NzdhNzk0YmExMzJkYzljNTNiYTY1MDUxZjM5YWNhZGVmZGRlNDA=
+  data.tar.gz: !binary |-
+    NDExMmM1Yjg1OGFjNThiNWYyYjgyN2ExNTlkNmJjMzEwNDFmMTJhZDUzYzdk
+    NmU2ZjU3YjZkYTY2ZjhiNDRmNWIyZDYzMTJmMDNkNjFlNTMxODE5MmZmOWIz
+    MzlkMTE1MzJiM2M2MTZiNjMyYWZhODgyMjQxZTBhNGMzZDJhMWM=

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.DS_Store

data/.rspec

@@ -0,0 +1,2 @@
+--colour
+--order TYPE[random] 

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in giphy.gemspec
+gemspec

data/LICENSE.md

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Sebastian Sogamoso
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,126 @@
+# Giphy
+
+Because GIFs make life fun! Use [Giphy API](http://api.giphy.com) from your Ruby programs and
+command line. Check out [Giphy Labs](http://labs.giphy.com/) for inspiration. 
+
+![](http://media.giphy.com/media/GuDQNjS0qJHpe/200.gif)
+
+## 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`:
+
+```ruby
+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](http://labs.giphy.com/) for updates.
+
+That's it, you're ready to have fun!
+
+#### Recent
+````ruby
+Giphy.recent(tag: 'cats', limit: 5)
+````
+
+#### Translate
+````ruby
+Giphy.translate('geek')
+````
+
+#### Search
+````ruby
+Giphy.search('funny cat', {limit: 50, offset: 25})
+````
+
+#### Flagged
+Write
+````ruby
+Giphy.flag('m5QHf0caAwgMw')
+````
+Read
+````ruby
+Giphy.flagged
+````
+
+#### Favorites
+Write
+````ruby
+Giphy.favorite('12HoHdqnDxz5NS')
+````
+Read
+````ruby
+Giphy.favorites
+````
+
+#### Screensaver
+````ruby
+Giphy.screensaver('surprise')
+````
+
+#### Random
+````ruby
+Giphy.random
+````
+
+#### Artists
+````ruby
+Giphy.artists
+````
+
+#### GIFs by artist
+````ruby
+Giphy.gif_by_artist('89a', {limit: 5, offset: 10})
+````
+
+#### GIFs by ID
+````ruby
+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'
+
+*Currently only supported for Mac.*
+
+## Supported Ruby Versions
+This library aims to support and is [tested against][travis] the following Ruby
+implementations:
+
+* Ruby 1.9.3
+* Ruby 2.0.0
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch: `git checkout -b my-new-feature`
+3. Run tests: `rake`
+4. Commit your changes: `git commit -am 'Add some feature'`
+5. Push to the branch: `git push origin my-new-feature`
+6. Create new Pull Request
+
+## License
+
+See [LICENSE](https://github.com/sebasoga/giphy/blob/master/LICENSE.md) for details.

data/Rakefile

@@ -0,0 +1,7 @@
+require "bundler/gem_tasks"
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :test => :spec
+task :default => :spec

data/bin/giphy

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+
+# Doing this so we can run the following in development (which doesn't have
+# lib/ in the path)
+#
+#   $ ./bin/giphy
+#
+$LOAD_PATH.unshift File.expand_path('../../lib/', __FILE__)
+require 'giphy'
+
+cli = Giphy::CLI.new(ARGV[0])
+cli.search

data/giphy.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'giphy/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "giphy"
+  spec.version       = Giphy::VERSION
+  spec.authors       = ["Sebastian Sogamoso"]
+  spec.email         = ["sebasoga@gmail.com"]
+  spec.description   = %q{A Ruby interface to the Giphy API.}
+  spec.summary       = %q{Enjoy Giphy API from you Ruby programs and command line}
+  spec.homepage      = "http://github.com/sebasoga/giphy"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_dependency "faraday", "~> 0.8.8"
+  spec.add_dependency "faraday_middleware-parse_oj", "~> 0.2.1"
+end

data/lib/giphy.rb

@@ -0,0 +1,8 @@
+require "uri"
+
+current_path = File.expand_path("../", __FILE__)
+Dir["#{current_path}/**/*.rb"].each { |file| require file }
+
+module Giphy
+  extend Giphy::Search
+end

data/lib/giphy/artist.rb

@@ -0,0 +1,35 @@
+module Giphy
+  class Artist
+    def self.build_batch_from(array)
+      array.map { |artist| new(artist) }
+    end
+
+    def initialize(hash)
+      @hash = hash
+    end
+
+    def username
+      hash.fetch('username')
+    end
+
+    def avatar
+      URI(hash.fetch('avatar'))
+    end
+
+    def website
+      URI(hash.fetch('website'))
+    end
+
+    def name
+      hash.fetch('name')
+    end
+
+    def count
+      hash.fetch('count').to_i
+    end
+
+    private
+
+    attr_reader :hash
+  end
+end

data/lib/giphy/cli.rb

@@ -0,0 +1,23 @@
+module Giphy
+  class CLI
+    def initialize(keyword)
+      @keyword = keyword
+    end
+
+    def search
+      system "echo 'Showing the GIF on your default browser: #{url}' && open #{url}"
+    end
+
+    private
+
+    attr_reader :keyword
+
+    def url
+      @url ||= URI("http://giphy.com/embed/#{result.id}")
+    end
+
+    def result
+      Giphy.screensaver(keyword)
+    end
+  end
+end

data/lib/giphy/client.rb

@@ -0,0 +1,72 @@
+module Giphy
+  class Client
+    def recent(options={})
+      get('/recent', options)
+    end
+
+    def translate(word)
+      get('/translate', s: word)
+    end
+
+    def search(keyword, options={})
+      options_hash = {q: keyword}.merge(options)
+      get('/search', options_hash)
+    end
+
+    def flag(id)
+      post("/#{id}/flagged")
+     end
+
+    def flagged
+      get('/flagged')
+    end
+
+    def favorite(id)
+      post("/#{id}/favorites")
+    end
+
+    def favorites
+      get('/favorites')
+    end
+
+    def screensaver(tag)
+      get('/screensaver', tag: tag)
+    end
+
+    def random
+      get('/random')
+    end
+
+    def artists(options={})
+      get('/artists', options)
+    end
+
+    def gif(id)
+      get("/#{id}")
+    end
+
+    def gifs(ids)
+      get('', ids: ids.join(','))
+    end
+
+    private
+
+    def get(path, options={})
+      api_response = request.get(path, options)
+      response(api_response)
+    end
+
+    def post(path, options={})
+      api_response = request.post(path, options)
+      response(api_response)
+    end
+
+    def request
+      Giphy::Request
+    end
+
+    def response(api_response)
+      Giphy::Response.build(api_response)
+    end
+  end
+end

data/lib/giphy/configuration.rb

@@ -0,0 +1,23 @@
+module Giphy
+  class Configuration
+    DEFAULT_VERSION  = 'v1'
+    DEFAULT_API_KEY  = 'dc6zaTOxFJmzC'
+
+    class << self
+      attr_writer :version, :api_key
+
+      def configure(&block)
+        yield self
+        self
+      end
+
+      def version
+        @version ||= DEFAULT_VERSION
+      end
+
+      def api_key
+        @api_key ||= DEFAULT_API_KEY
+      end
+    end
+  end
+end

data/lib/giphy/errors/api.rb

@@ -0,0 +1,5 @@
+module Giphy
+  module Errors
+    class API < StandardError ; end
+  end
+end

data/lib/giphy/errors/argument_error.rb

@@ -0,0 +1,5 @@
+module Giphy
+  module Errors
+    class ArgumentError < StandardError ; end
+  end
+end

data/lib/giphy/favorite_gif.rb

@@ -0,0 +1,9 @@
+require 'giphy/special_gif'
+
+module Giphy
+  class FavoriteGif < Giphy::SpecialGif
+    def tag
+      hash.fetch('tag')
+    end
+  end
+end

data/lib/giphy/flagged_gif.rb

@@ -0,0 +1,18 @@
+require 'date'
+require 'giphy/special_gif'
+
+module Giphy
+  class FlaggedGif < Giphy::SpecialGif
+    def inappropriate?
+      hash.fetch('is_inappropriate') == "1"
+    end
+
+    def wrong_source?
+      hash.fetch('is_wrong_source') == "1"
+    end
+
+    def source_corrected
+      hash.fetch('source_corrected')
+    end
+  end
+end