gilt 0.1.0

data/.gitignore

@@ -0,0 +1,4 @@
+.DS_Store
+*.gem
+.bundle
+pkg/*

data/.travis.yml

@@ -0,0 +1,10 @@
+language: ruby
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - jruby-18mode
+  - jruby-19mode
+  - rbx-18mode
+  - rbx-19mode
+  - ree

data/Gemfile

@@ -0,0 +1,15 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in gilt-rb.gemspec
+gemspec
+
+gem "rake", "~> 0.9.2"
+
+group :test do
+  gem "rspec", "~> 2.9.0"
+  gem "webmock", "~> 1.8.5"
+end
+
+platforms :jruby do
+  gem "jruby-openssl", "~> 0.7.6"
+end

data/Gemfile.lock

@@ -0,0 +1,54 @@
+PATH
+  remote: .
+  specs:
+    gilt (0.1.0)
+      money (~> 4.0.2)
+      weary (~> 1.0.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.2.7)
+    bouncy-castle-java (1.5.0146.1)
+    crack (0.3.1)
+    diff-lcs (1.1.3)
+    i18n (0.6.0)
+    jruby-openssl (0.7.6.1)
+      bouncy-castle-java (>= 1.5.0146.1)
+    json (1.6.6)
+    money (4.0.2)
+      i18n (~> 0.4)
+      json
+    multi_json (1.1.0)
+    promise (0.3.0)
+    rack (1.4.1)
+    rake (0.9.2.2)
+    rspec (2.9.0)
+      rspec-core (~> 2.9.0)
+      rspec-expectations (~> 2.9.0)
+      rspec-mocks (~> 2.9.0)
+    rspec-core (2.9.0)
+    rspec-expectations (2.9.0)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.9.0)
+    simple_oauth (0.1.5)
+    weary (1.0.0)
+      addressable (~> 2.2.7)
+      multi_json (~> 1.1.0)
+      promise (~> 0.3.0)
+      rack (~> 1.4.0)
+      simple_oauth (~> 0.1.5)
+    webmock (1.8.5)
+      addressable (>= 2.2.7)
+      crack (>= 0.1.7)
+
+PLATFORMS
+  java
+  ruby
+
+DEPENDENCIES
+  gilt!
+  jruby-openssl (~> 0.7.6)
+  rake (~> 0.9.2)
+  rspec (~> 2.9.0)
+  webmock (~> 1.8.5)

data/README.md

@@ -0,0 +1,43 @@
+      .oooooo.     ooooo   ooooo     ooooooooooooo
+     d8P'  `Y8b    `888'   `888'     8'   888   `8
+    888             888     888           888
+    888             888     888           888
+    888     ooooo   888     888           888
+    `88.    .88'    888     888     o     888
+     `Y8bood8P'    o888o   o888ooood8    o888o
+
+
+`gilt` is a Ruby library for v1 of the [Gilt Public API](http://dev.gilt.com/).
+
+It's written with the [Weary](https://github.com/mwunsch/weary) framework, so it gets the features of that library out of the box, like:
+
+* Full Rack integration. The Client to the library is a Rack application.
+* Fully asynchronous. `gilt` makes liberal use of futures and Weary::Deferred.
+
+## Examples
+
+```ruby
+active_sales = Gilt::Sale.active :apikey => "your-api-key"
+womens_sales = sales.select {|sale| sale.store == Gilt::Stores::WOMEN }
+sales.products.map(&:name)
+```
+
+Above, the call to `sales.products` returns a list of [Weary::Deferred](https://github.com/mwunsch/weary/blob/master/lib/weary/deferred.rb) objects wrapping Gilt::Product objects. This means that fetching the product is asynchronous, and only blocks when accessed.
+
+### With Rack
+
+```ruby
+# config.ru
+client = Gilt::Client::Product
+client.use Rack::Runtime
+
+run client
+```
+
+After `rackup`:
+
+    curl "http://localhost:9292/sales/active.json?apikey=my-api-key"
+
+## Installation
+
+    gem install gilt

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+task :default => :spec
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = ["--color"]
+end

data/gilt.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "gilt/version"
+
+Gem::Specification.new do |s|
+  s.name        = "gilt"
+  s.version     = Gilt::VERSION
+  s.authors     = ["Mark Wunsch"]
+  s.email       = ["mwunsch@gilt.com"]
+  s.homepage    = "http://github.com/mwunsch/gilt"
+  s.summary     = %q{Ruby client for the Gilt public API.}
+  s.description = %q{Ruby client for the Gilt public API (http://dev.gilt.com). Written with the Weary framework.}
+
+  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_runtime_dependency "money", "~> 4.0.2"
+  s.add_runtime_dependency "weary", "~> 1.0.0"
+end

data/lib/gilt.rb

@@ -0,0 +1,14 @@
+module Gilt
+  module Stores
+    WOMEN = :women
+    MEN   = :men
+    KIDS  = :kids
+    HOME  = :home
+  end
+
+  autoload :Sale, 'gilt/sale'
+  autoload :Product, 'gilt/product'
+end
+
+require "gilt/client"
+require "gilt/version"

data/lib/gilt/client.rb

@@ -0,0 +1,18 @@
+require "weary/client"
+
+module Gilt
+  class Client < Weary::Client
+    VERSION = "v1"
+    FORMAT = "json"
+    DOMAIN = "https://api.gilt.com/#{VERSION}"
+
+    def initialize(apikey, affid=nil)
+      @defaults = {}
+      @defaults[:apikey] = apikey
+      @defaults[:affid]  = affid unless affid.nil?
+    end
+
+    autoload :Sales, "gilt/client/sales"
+    autoload :Products, "gilt/client/products"
+  end
+end

data/lib/gilt/client/products.rb

@@ -0,0 +1,15 @@
+require "gilt/client"
+
+module Gilt
+  class Client
+    class Products < Gilt::Client
+      domain DOMAIN
+
+      required :apikey
+
+      optional :affid
+
+      get :detail, "/products/:product_id/detail.#{FORMAT}"
+    end
+  end
+end

data/lib/gilt/client/sales.rb

@@ -0,0 +1,41 @@
+require "gilt/client"
+
+module Gilt
+  class Client
+    class Sales < Gilt::Client
+      domain DOMAIN
+
+      required :apikey
+
+      optional :affid
+
+      get :active, "/sales/active.#{FORMAT}"
+
+      get :active_in_store, "/sales/:store/active.#{FORMAT}"
+
+      get :upcoming, "/sales/upcoming.#{FORMAT}"
+
+      get :upcoming_in_store, "/sales/:store/upcoming.#{FORMAT}"
+
+      get :detail, "/sales/:store/:sale_key/detail.#{FORMAT}"
+
+      [ Gilt::Stores::WOMEN,
+        Gilt::Stores::MEN,
+        Gilt::Stores::KIDS,
+        Gilt::Stores::HOME ].each do |store|
+        define_method "active_in_#{store}" do |*args, &block|
+          params = args.first || {}
+          active_in_store params.merge({:store => store}), &block
+        end
+        alias_method "#{store}_active".intern, "active_in_#{store}".intern
+
+        define_method "upcoming_in_#{store}" do |*args, &block|
+          params = args.first || {}
+          upcoming_in_store params.merge({:store => store}), &block
+        end
+        alias_method "#{store}_upcoming".intern, "upcoming_in_#{store}".intern
+      end
+
+    end
+  end
+end

data/lib/gilt/product.rb

@@ -0,0 +1,162 @@
+module Gilt
+  autoload :Sku, "gilt/sku"
+
+  class Product
+
+    def self.defer(future)
+      require 'weary/deferred'
+      Weary::Deferred.new future, self, lambda {|product, response| product.new(response.parse) }
+    end
+
+    def self.client(apikey, affid=nil)
+      Gilt::Client::Products.new(apikey, affid)
+    end
+
+    def self.detail(product_id, apikey, affid=nil)
+      client(apikey, affid).detail(:product_id => product_id)
+    end
+
+    def self.create(product_id, apikey, affid=nil)
+      response = detail(product_id, apikey, affid).perform
+      self.new response.parse
+    end
+
+    def initialize(product_body)
+      @product = product_body
+    end
+
+    def name
+      @product["name"]
+    end
+
+    def product
+      URI(@product["product"])
+    end
+
+    def id
+      @product["id"].to_i
+    end
+
+    def brand
+      @product["brand"]
+    end
+
+    def url
+      URI(@product["url"])
+    end
+
+    def description
+      fetch_content :description
+    end
+
+    def fit_notes
+      fetch_content :fit_notes
+    end
+
+    def material
+      fetch_content :material
+    end
+
+    def care_instructions
+      fetch_content :care_instructions
+    end
+
+    def origin
+      fetch_content :origin
+    end
+
+    def content
+      keys = [:description, :fit_notes, :material, :care_instructions, :origin]
+      Hash[keys.map {|content| [content, self.send(content) ]}]
+    end
+
+    def skus
+      @product["skus"].map {|sku| Sku.new(sku) }
+    end
+
+    def min_price
+      sorted_price.last
+    end
+
+    def max_price
+      sorted_price.first
+    end
+
+    def price_range
+      [min_price, max_price]
+    end
+
+    def format_price
+      range = price_range
+      return range.first.format if range.first == range.last
+      price_range.map(&:format).join(" - ")
+    end
+
+    def images
+      @product["image_urls"]
+    end
+
+    def colors
+      skus.map {|sku| sku.attributes[:color] }.uniq
+    end
+
+    def sizes
+      skus.map {|sku| sku.attributes[:size] }.uniq
+    end
+
+    def skus_of_size(size)
+      skus_with_attribute :size, size
+    end
+
+    def skus_of_color(color)
+      skus_with_attribute :color, color
+    end
+
+    def skus_with_attribute(attribute, value)
+      skus.select {|sku| !!sku.attributes[attribute.to_sym].match(value) }
+    end
+
+    def select_sku(attributes)
+      attribute_map = attributes.map {|k, v| skus_with_attribute(k, v).map(&:id) }
+      ids = attribute_map.reduce(:&)
+      skus.find {|sku| sku.id == ids.first } if ids.size > 0
+    end
+
+    def inventory_status
+      sku_inventory = skus.map(&:inventory_status).uniq
+      if sku_inventory.include? Gilt::Sku::FOR_SALE
+        Gilt::Sku::FOR_SALE
+      elsif sku_inventory.all? {|status| status == Gilt::Sku::RESERVED}
+        Gilt::Sku::RESERVED
+      else
+        Gilt::Sku::SOLD_OUT
+      end
+    end
+
+    def for_sale?
+      inventory_status == Gilt::Sku::FOR_SALE
+    end
+
+    def sold_out?
+      inventory_status == Gilt::Sku::SOLD_OUT
+    end
+
+    def reserved?
+      inventory_status == Gilt::Sku::RESERVED
+    end
+
+    private
+
+    def fetch_content(key)
+      content = @product["content"]
+      content[key.to_s] unless content.nil?
+    end
+
+    def sorted_price
+      set = skus.map(&:sale_price).uniq
+      return set if set.size == 1
+      set.sort
+    end
+
+  end
+end

data/lib/gilt/sale.rb

@@ -0,0 +1,101 @@
+require 'time'
+
+module Gilt
+  class Sale
+    class << self
+      Gilt::Client::Sales.resources.keys.each do |key|
+        define_method key do |params, &block|
+          args = params || {}
+          apikey = args[:apikey]
+          affid = args[:affid]
+          products = product_client apikey, affid
+          req = client(apikey, affid).send(key.to_sym, args)
+          response = req.perform.parse
+          if response["sales"].nil?
+            [self.new(response, products)]
+          else
+            response["sales"].map {|sale| self.new(sale, products)}
+          end
+        end
+      end
+    end
+
+    def self.client(apikey, affid=nil)
+      Gilt::Client::Sales.new(apikey, affid)
+    end
+
+    def self.product_client(apikey, affid=nil)
+      Gilt::Client::Products.new(apikey, affid)
+    end
+
+    def self.create(store, sale_key, apikey, affid=nil)
+      detail(:store => store, :sale_key => sale_key, :apikey => apikey, :affid => affid).first
+    end
+
+    def initialize(sale_body, client=nil)
+      @sale = sale_body
+      @client = client
+    end
+
+    def name
+      @sale["name"]
+    end
+
+    def store
+      @sale["store"].intern
+    end
+
+    def sale_key
+      @sale["sale_key"]
+    end
+
+    def sale
+      URI(@sale["sale"])
+    end
+
+    def sale_url
+      URI(@sale["sale_url"])
+    end
+
+    def images
+      @sale["image_urls"]
+    end
+
+    def description
+      @sale["description"]
+    end
+
+    def begins
+      Time.parse @sale["begins"]
+    end
+
+    def ends
+      end_time = @sale["ends"]
+      Time.parse end_time unless end_time.nil?
+    end
+
+    def ended?
+      return false if ends.nil?
+      ends < Time.now
+    end
+
+    def duration
+      (ends - begins).ceil unless ends.nil?
+    end
+
+    def products
+      return @products unless @products.nil?
+      resource = Gilt::Client::Products.resources[:detail]
+      @products = (@sale["products"] || []).map do |product|
+        id = resource.url.extract(product)["product_id"]
+        @client.detail(:product_id => id).perform
+        Product.defer @client.detail(:product_id => id).perform
+      end
+    end
+
+    def length
+      return products.length
+    end
+
+  end
+end