giddy 0.0.1

data/.gitignore

@@ -0,0 +1 @@
+pkg

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,27 @@
+PATH
+  remote: .
+  specs:
+    giddy (0.0.1)
+      httparty (>= 0.11.0)
+      json (>= 1.8.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    httparty (0.11.0)
+      multi_json (~> 1.0)
+      multi_xml (>= 0.5.2)
+    json (1.8.0)
+    multi_json (1.8.0)
+    multi_xml (0.5.5)
+    rake (10.1.0)
+    rdoc (4.0.1)
+      json (~> 1.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  giddy!
+  rake
+  rdoc

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2013 Brian Muller
+
+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,40 @@
+# Giddy
+Giddy is a ruby gem for interacting with the Getty API.
+
+# Installation
+
+```
+gem install giddy
+```
+
+## Configuration
+To set up the authorization configuration, use:
+
+```ruby
+Giddy.setup do |config|
+  config.system_id = "12345"
+  config.system_password = "alongpassword"
+  config.username = "user"
+  config.password = "password"
+end
+```
+
+## Usage
+Searching:
+```ruby
+images = Giddy::Image.find(:query => "puppy")
+# or, with pagination
+images = Giddy::Image.find(:query => "kitty", :start => 21, :limit => 20)
+```
+
+Get an images details:
+```ruby
+image = Giddy::Image(:image_id => "182405488")
+puts image
+puts image.artist
+```
+
+Download request:
+```ruby
+puts image.download_largest
+```

data/Rakefile

@@ -0,0 +1,10 @@
+require 'bundler/gem_tasks'
+require 'rdoc/task'
+
+desc "Create documentation"
+Rake::RDocTask.new("doc") { |rdoc|
+  rdoc.title = "Giddy - Getty Connect API library for Ruby"
+  rdoc.rdoc_dir = 'docs'
+  rdoc.rdoc_files.include('README.md')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+}

data/giddy.gemspec

@@ -0,0 +1,23 @@
+$:.push File.expand_path("../lib", __FILE__)
+require "giddy/version"
+
+Gem::Specification.new do |s|
+  s.name        = "giddy"
+  s.version     = Giddy::VERSION
+  s.authors     = ["Brian Muller"]
+  s.email       = ["bamuller@gmail.com"]
+  s.homepage    = "https://github.com/opbandit/giddy"
+  s.summary     = "Ruby client for Getty API"
+  s.description = "Ruby client for Getty API"
+
+  s.rubyforge_project = "giddy"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  s.add_dependency("httparty", ">= 0.11.0")
+  s.add_dependency("json", ">= 1.8.0")
+  s.add_development_dependency('rdoc')
+  s.add_development_dependency('rake')
+end

data/lib/giddy.rb

@@ -0,0 +1,23 @@
+require 'json'
+require 'httparty'
+
+require "giddy/version"
+require "giddy/config"
+require "giddy/mediator"
+require "giddy/session"
+require "giddy/search"
+require "giddy/download"
+require "giddy/image"
+require "giddy/utils"
+
+module Giddy
+  def self.config
+    @config ||= Config.new
+  end
+
+  def self.setup(&block)
+    config.clear_session
+    yield config
+    config.check!
+  end
+end

data/lib/giddy/config.rb

@@ -0,0 +1,31 @@
+module Giddy
+
+  class Config
+    def self.required_fields
+      [ :system_id, :system_password, :username, :password ]
+    end
+    
+    # system specific information
+    attr_accessor :system_id, :system_password
+    
+    # user specific information
+    attr_accessor :username, :password
+
+    # session information
+    attr_accessor :token, :secure_token
+
+    def check!
+      self.class.required_fields.each do |required_field|
+        unless send(required_field)
+          raise MissingConfigurationError, "#{required_field} must be set"
+        end
+      end
+    end
+
+    def clear_session
+      @token = nil
+      @secure_token = nil
+    end
+  end
+
+end

data/lib/giddy/download.rb

@@ -0,0 +1,28 @@
+module Giddy
+  class Download
+    extend Mediator
+
+    def self.path
+      "download"
+    end
+
+    def self.search_for_images(attrs)
+      result = gettyup :SearchForImages, attrs, :SearchForImages2
+      result["Images"].map { |attrs|
+        Image.new(attrs)
+      }
+    end
+    
+    def self.get_largest_image_download_authorizations(ids)
+      ids = [ids].flatten.map { |id| { :ImageId => id } }
+      result = gettyup :GetLargestImageDownloadAuthorizations, { :Images => ids }
+      result["Images"].inject({}) { |h,i| h[i["ImageId"]] = Utils.rubified_hash(i); h }
+    end
+
+    def self.create_download_request(tokens)
+      tokens = [tokens].flatten.map { |token| { :DownloadToken => token } }
+      result = gettyup :CreateDownloadRequest, { :DownloadItems => tokens }, "CreateDownload", true
+      result["DownloadUrls"].inject({}) { |h,i| h[i["ImageId"]] = Utils.rubified_hash(i); h }
+    end
+  end
+end

data/lib/giddy/image.rb

@@ -0,0 +1,50 @@
+module Giddy
+  class Image
+    def initialize(attrs)
+      if attrs.has_key?(:image_id) and attrs.keys.length == 1
+        attrs = Search.get_image_details(attrs[:image_id]).first
+      end      
+      @attrs = Utils.rubified_hash(attrs)
+    end
+
+    def method_missing(method, *args, &block)
+      @attrs.fetch(method, nil)
+    end
+
+    def largest_available
+      result = Download.get_largest_image_download_authorizations(@attrs[:image_id])
+      result[@attrs[:image_id]]
+    end
+
+    def download_request(token)
+      result = Download.create_download_request(token)
+      result[@attrs[:image_id]]
+    end
+
+    def download_largest
+      authorizations = largest_available[:authorizations]
+      return nil if authorizations.length == 0
+      download_request authorizations.first[:download_token]
+    end
+
+    def self.find(attrs)
+      attrs = {
+        :limit => 25,
+        :start => 1,
+        :query => "",
+        :additional => {}
+      }.merge(attrs)
+      converted = {
+        :Query => { :SearchPhrase =>  attrs[:query] },
+        :ResultOptions => { :ItemCount => attrs[:limit], :ItemStartNumber => attrs[:start] }
+      }
+      attrs = attrs[:additional].merge(converted)
+      Search.search_for_images(attrs)
+    end
+
+    def to_s
+      as = @attrs.map { |k,v| "#{k}=#{v}" }.join(", ")
+      "<Image #{as}>" 
+    end
+  end
+end

data/lib/giddy/mediator.rb

@@ -0,0 +1,41 @@
+module Giddy
+  module Mediator
+    ROOTPATH = "https://connect.gettyimages.com/v1"
+    
+    def gettyup(name, data, bodyname=nil, secure=false, check_token=true)
+      token = secure ? Giddy.config.secure_token : Giddy.config.token
+      if token.nil? and check_token
+        Session.create_session
+        token = secure ? Giddy.config.secure_token : Giddy.config.token
+      end
+
+      result = fetch(token, bodyname, name, data)
+
+      if reauth_needed?(result)
+        Session.create_session
+        gettyup name, data, bodyname        
+      elsif result["ResponseHeader"]["Status"] == "success"
+        result["#{name}Result"]
+      else
+        raise "Error fetching #{name}: #{result["ResponseHeader"]}"
+      end
+    end
+
+    def fetch(token, bodyname, name, data)
+      body = { :RequestHeader => { :Token => token }, "#{bodyname || name}RequestBody" => data }
+      headers = { 'Content-Type' => 'application/json' }
+      url = "#{ROOTPATH}/#{path}/#{name}"
+      HTTParty.post(url, :body => body.to_json, :headers => headers)
+    end
+
+    def reauth_needed?(result)
+      return true if result.body == "<h1>Developer Inactive</h1>"
+      reauth_codes = [ "AUTH-012", "AUTH-010" ]
+      if result["ResponseHeader"]["StatusList"].length > 0
+        reauth_codes.include? result["ResponseHeader"]["StatusList"].first["Code"]
+      else
+        false
+      end
+    end
+  end
+end

data/lib/giddy/search.rb

@@ -0,0 +1,22 @@
+module Giddy
+  class Search
+    extend Mediator
+
+    def self.path
+      "search"
+    end
+
+    def self.search_for_images(attrs)
+      result = gettyup :SearchForImages, attrs, :SearchForImages2
+      result["Images"].map { |attrs|
+        Image.new(attrs)
+      }
+    end
+    
+    def self.get_image_details(ids)
+      attrs = { :ImageIds => [ids].flatten, :Language => 'en-us' }
+      result = gettyup :GetImageDetails, attrs
+      result["Images"]
+    end
+  end
+end

data/lib/giddy/session.rb

@@ -0,0 +1,22 @@
+module Giddy
+  class Session
+    extend Mediator
+
+    def self.path
+      "session"
+    end
+
+    def self.create_session
+      Giddy.config.clear_session
+      data = { 
+        :SystemId => Giddy.config.system_id,
+        :SystemPassword => Giddy.config.system_password,
+        :UserName => Giddy.config.username,
+        :UserPassword => Giddy.config.password
+      }
+      result = gettyup :CreateSession, data, nil, false, false
+      Giddy.config.token = result["Token"]
+      Giddy.config.secure_token = result["SecureToken"]
+    end
+  end
+end

data/lib/giddy/utils.rb

@@ -0,0 +1,23 @@
+module Giddy
+  class Utils
+    # covert camel case keys to underscore
+    def self.rubified_hash(h)
+      if h.is_a?(Array)
+        return h.map { |v| rubified_hash(v) }
+      elsif not h.is_a?(Hash)
+        return h
+      end
+
+      fixed = {}
+      h.each { |key, value|
+        key = key.to_s.gsub(/::/, '/').
+        gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+        gsub(/([a-z\d])([A-Z])/,'\1_\2').
+        tr("-", "_").
+        downcase
+        fixed[key.intern] = rubified_hash(value)
+      }
+      fixed
+    end
+  end
+end

data/lib/giddy/version.rb

@@ -0,0 +1,3 @@
+module Giddy
+  VERSION = "0.0.1"
+end

metadata

@@ -0,0 +1,119 @@
+--- !ruby/object:Gem::Specification 
+name: giddy
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Brian Muller
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2013-10-02 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.11.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: json
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.8.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rdoc
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  prerelease: false
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rake
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  prerelease: false
+  version_requirements: *id004
+description: Ruby client for Getty API
+email: 
+- bamuller@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- giddy.gemspec
+- lib/giddy.rb
+- lib/giddy/config.rb
+- lib/giddy/download.rb
+- lib/giddy/image.rb
+- lib/giddy/mediator.rb
+- lib/giddy/search.rb
+- lib/giddy/session.rb
+- lib/giddy/utils.rb
+- lib/giddy/version.rb
+homepage: https://github.com/opbandit/giddy
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 1099659910985099941
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 1099659910985099941
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: giddy
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Ruby client for Getty API
+test_files: []
+