shutterstock-ruby 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1101126b2596109a4c85c48056fa9cd787a95a15
+  data.tar.gz: 13240bc37a9d789cfa8ab86b429ded04eb3f870f
+SHA512:
+  metadata.gz: f2a8583283c6b41cc743dd39c084e2d8d14bdcc5dc74d98d3fa4f5a07624ce405b164290100880a1c61bf96f3b6313ce162e381eab55c2f4ac3212b8aeaa9ef4
+  data.tar.gz: 77d7a8c37993f297dc25e5041d102db23eb6a12c11b87a4e307fde1e4c5886202a092dc559d951db5d2d986d4763c37659e2e33853f91ebd55db4e27da5ee919

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Tailor
+
+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,53 @@
+The Shutterstock Ruby API Wrapper
+===================
+
+A Ruby API wrapper for [Shutterstock](http://www.shutterstock.com/) [API's](http://developers.shutterstock.com)
+
+[![Gem Version](https://badge.fury.io/rb/shutterstock-ruby.svg)](http://badge.fury.io/rb/shutterstock-ruby)[![Dependency Status](https://gemnasium.com/TailorBrands/shutterstock-ruby.svg)](https://gemnasium.com/TailorBrands/shutterstock-ruby)
+[![Circle CI](https://circleci.com/gh/TailorBrands/shutterstock-ruby/tree/master.svg?style=svg)](https://circleci.com/gh/TailorBrands/shutterstock-ruby/tree/master)  [![Code Climate](https://codeclimate.com/github/TailorBrands/shutterstock-ruby/badges/gpa.svg)](https://codeclimate.com/github/TailorBrands/shutterstock-ruby)  [![Test Coverage](https://codeclimate.com/github/TailorBrands/shutterstock-ruby/badges/coverage.svg)](https://codeclimate.com/github/TailorBrands/shutterstock-ruby)
+
+```rb
+gem "shutterstock-ruby", "~> 0.0.1"
+```
+
+## Missing
+
+Current version only wraps the Image search, purchase and download API's. Feel free to send a pull request with more API's wrapped!
+
+## Usage
+
+You need a valid client_id/secret combo to use the Gem, you can get it by signing up [here](http://developers.shutterstock.com)
+
+*Raises Exception on missing credentials*
+
+### Configuration
+You can use an initializer for example if you're on Rails.
+```rb
+# initializers/shutterstock.rb
+ShutterstockRuby.configure do |config|
+  config.api_client = ENV['SHUTTERSTOCK_CLIENT']
+  config.api_secret = ENV['SHUTTERSTOCK_SECRET']
+end
+```
+
+### Search for images
+
+```rb
+result = ShutterstockRuby::Images.search('Cat') # Returns a hash of the parsed JSON result.
+```
+Source [source](https://developers.shutterstock.com/api/v2/image/search)
+
+## Disclaimer
+
+This is completely unofficial and is not related to Shutterstock in any way.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## About Tailor Brands
+[Check us out!](https://www.tailorbrands.com)

data/Rakefile

@@ -0,0 +1,14 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+$:.unshift 'lib'
+
+desc 'Default: run unit tests.'
+task :default => [:spec]
+
+require 'rspec/core/rake_task'
+
+desc 'Run specs'
+RSpec::Core::RakeTask.new do |t|
+  t.pattern = './spec/**/*_spec.rb'
+end

data/lib/shutterstock-ruby.rb

@@ -0,0 +1,29 @@
+require 'json'
+require 'rest_client'
+require 'shutterstock-ruby/connections'
+require 'shutterstock-ruby/images'
+
+# Top level name space for the entire Gem.
+module ShutterstockRuby
+  API_BASE = 'api.shutterstock.com/v2'
+
+  def self.configuration
+    @configuration ||=  Configuration.new
+  end
+
+  def self.configure
+    self.configuration ||= Configuration.new
+    yield(configuration) if block_given?
+  end
+
+  # Main configuration class.
+  class Configuration
+    attr_accessor :api_client
+    attr_accessor :api_secret
+
+    def initialize
+      @api_client = nil
+      @api_secret = nil
+    end
+  end
+end

data/lib/shutterstock-ruby/connections.rb

@@ -0,0 +1,29 @@
+module ShutterstockRuby
+  module Connections
+    def get(path, params = nil, options = {})
+      ensure_credentials!
+
+      options = { accept: :json }.merge(options)
+      options[:params] = params unless params.nil?
+
+      RestClient.get(build_url(path), options)
+    end
+
+    def post(path, body, options = {})
+      ensure_credentials!
+
+      RestClient.post(build_url(path), body, options)
+    end
+
+    private
+
+    def build_url(path)
+      "https://#{ShutterstockRuby.configuration.api_client}:#{ShutterstockRuby.configuration.api_secret}@#{ShutterstockRuby::API_BASE}#{path}"
+    end
+
+    def ensure_credentials!
+      config = ShutterstockRuby.configuration
+      fail(Exception, 'Missing credentials') if config.api_client.nil? || config.api_secret.nil?
+    end
+  end
+end

data/lib/shutterstock-ruby/images.rb

@@ -0,0 +1,11 @@
+module ShutterstockRuby
+  # A class to hold all images related code.
+  class Images
+    extend Connections
+
+    def self.search(query, options = {})
+      query = URI.encode_www_form_component(query)
+      JSON.parse(self.get('/images/search', { query: query }.merge(options)))
+    end
+  end
+end

data/spec/lib/shutterstock_ruby_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+RSpec.describe ShutterstockRuby do
+  after :each do
+    ShutterstockRuby.configuration.api_client = nil
+    ShutterstockRuby.configuration.api_secret = nil
+  end
+
+  it 'has the correct default' do
+    expect(ShutterstockRuby.configuration.api_client).to be nil
+    expect(ShutterstockRuby.configuration.api_secret).to be nil
+  end
+
+  it 'sets the correct configuration' do
+    expect(ShutterstockRuby.configuration.api_client).to be nil
+    expect(ShutterstockRuby.configuration.api_secret).to be nil
+
+    key = SecureRandom.uuid
+    secret = SecureRandom.uuid
+    ShutterstockRuby.configure do |config|
+      config.api_client = key
+      config.api_secret = secret
+    end
+
+    expect(ShutterstockRuby.configuration.api_client).to equal(key)
+    expect(ShutterstockRuby.configuration.api_secret).to equal(secret)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,16 @@
+require 'codeclimate-test-reporter'
+CodeClimate::TestReporter.start
+
+require 'bundler/setup'
+require 'shutterstock-ruby'
+require 'pry'
+require 'faker'
+require 'json'
+
+# require_relative 'support/fakes'
+
+RSpec.configure do |config|
+  config.disable_monkey_patching!
+  config.formatter = 'documentation'
+  config.color = true
+end

metadata

@@ -0,0 +1,129 @@
+--- !ruby/object:Gem::Specification
+name: shutterstock-ruby
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Nadav Shatz
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-04-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+- !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'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+- !ruby/object:Gem::Dependency
+  name: faker
+  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'
+- !ruby/object:Gem::Dependency
+  name: semver
+  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: A Gem to expose a wrapping API for the Shutterstock API's
+email: nadav@tailorbrands.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- Rakefile
+- lib/shutterstock-ruby.rb
+- lib/shutterstock-ruby/connections.rb
+- lib/shutterstock-ruby/images.rb
+- spec/lib/shutterstock_ruby_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/TailorBrands/shutterstock-ruby
+licenses:
+- MIT
+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.4.5
+signing_key: 
+specification_version: 4
+summary: An API wrapper for the Shutterstock API's
+test_files:
+- spec/lib/shutterstock_ruby_spec.rb
+- spec/spec_helper.rb