celery 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 24259f8a1be95e104f3fcc0467eca253f0304acb
+  data.tar.gz: ee77758970c43f9848787a0e764427629e9b6017
+SHA512:
+  metadata.gz: d61101aebd1da8b573feeba2720ff360a0c0a674ca0e934d5d961e13e21f70d3b5170580e9dfcb4c689e89e3f53ef59241569b001898556efcd45392682d1eb2
+  data.tar.gz: 3b60efc37783096140ffe98c2da52986033ed1875b74559141c6d1187bd085aca860c95c2b4337e883acba1661431220e454f9b7991caf39671d1a60e3e04515

data/.gitignore

@@ -0,0 +1,20 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.ruby-version
+.rbenv-gemsets
+.rbenv-vars

data/.rspec

@@ -0,0 +1,4 @@
+--colour
+--drb
+--format documentation
+--fail-fast

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Brian Getting
+
+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,54 @@
+# Celery
+
+A Ruby gem for interacting with the Celery API.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'celery'
+```
+
+And then execute:
+
+```ruby
+bundle
+```
+
+Or install it yourself as:
+
+```ruby
+gem install celery
+```
+
+## Usage
+
+To get started, you'll need to create a Celery account to get your API access token.
+
+```ruby
+require 'celery'
+
+celery = Celery::API.new ('CELERY_API_TOKEN')
+# Also looks in ENV['CELERY_API_TOKEN']
+# celery = Celery::API.new
+
+coupons = celery.coupon.all
+# => {"total"=>0, "count"=>0, "limit"=>0, "offset"=>0, "has_more"=>false, "coupons"=>[]}
+
+orders = celery.order.all(limit: 100, skip: 2, sort: 'created')
+# => {"total"=>0, "count"=>0, "limit"=>100, "offset"=>2, "has_more"=>false, "orders"=>[]}
+
+me = celery.user.me
+me['user']['name']
+# => "Joe Public"
+
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/celery.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'celery/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "celery"
+  spec.version       = Celery::VERSION
+  spec.platform      = Gem::Platform::RUBY
+  spec.authors       = ["Brian Getting"]
+  spec.email         = ["brian@tatem.ae"]
+  spec.description   = %q{Ruby wrapper for the Celery API}
+  spec.summary       = %q{Ruby wrapper for the Celery API}
+  spec.homepage      = "https://github.com/tatemae-consultancy/celery-ruby"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  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_dependency 'excon', "~> 0.31.0"
+  spec.add_dependency 'json', "~> 1.8.1"
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rspec", "~> 2.14.1"
+  spec.add_development_dependency "rake"
+end

data/lib/celery.rb

@@ -0,0 +1,186 @@
+require 'rubygems'
+require 'excon'
+require 'json'
+
+require "celery/errors"
+require "celery/version"
+require "celery/resources/coupon"
+require "celery/resources/order"
+require "celery/resources/product"
+require "celery/resources/shop"
+require "celery/resources/user"
+
+module Celery
+  class API
+
+    attr_accessor :debug, :host, :path, :session, :token
+
+    def initialize(token=nil, debug=false)
+      @host = 'https://api.trycelery.com'
+      @path = '/v1'
+      @session = Excon.new @host
+      @debug = debug
+      if not token
+        token = ENV['CELERY_API_TOKEN'] if ENV['CELERY_API_TOKEN']
+        # TODO: Could put feedback warning here that some methods
+        #       require an API key.
+      end
+      @token = token
+    end
+
+    # Make a request to the Celery API
+    #
+    # @param [Symbol] verb the HTTP request method
+    # @param [String] path the HTTP URL path of the request
+    # @param [Hash] opts the options to make the request with
+    #
+    def call(method, path, opts={}, &block) # :nodoc:
+      # Ensure the body is JSON
+      opts[:body] = JSON.generate(opts[:body]) if opts[:body] 
+      # Set the headers
+      opts[:headers] ||= {}
+      opts[:headers].merge!(headers)
+      # Set the path
+      opts[:path] = "#{@path}/#{path}"
+      # Set the access token
+      # TODO: Remove and use HTTP Basic Authorization
+      opts[:query] ||= {}
+      opts[:query].merge!(access_token: @token)
+      # Make the request
+      req = @session.send(method, opts)
+      # Handle the response
+      handle_response(req)
+    end
+
+    # Make a GET request
+    # @see #call
+    #
+    def get(path, opts={}, &block) # :nodoc:
+      call(:get, path, opts, &block)
+    end
+
+    # Make a POST request
+    # @see #call
+    #
+    def post(path, opts={}, &block) # :nodoc:
+      call(:post, path, opts, &block)
+    end
+
+    # Make a PUT request
+    # @see #call
+    #
+    def put(path, opts={}, &block) # :nodoc:
+      call(:put, path, opts, &block)
+    end
+
+    # Make a PATCH request
+    # @see #call
+    #
+    def patch(path, opts={}, &block) # :nodoc:
+      call(:patch, path, opts, &block)
+    end
+
+    # Make a DELETE request
+    # @see #call
+    #
+    def delete(path, opts={}, &block) # :nodoc:
+      call(:delete, path, opts, &block)
+    end
+
+    # Handle the response of a request
+    def handle_response(response) # :nodoc:
+      case response.status
+      when 400
+        raise BadRequest.new JSON.parse(response.body)["error"]
+      when 401
+        raise Unauthorized.new
+      when 404
+        raise NotFound.new
+      when 400...500
+        raise ClientError.new JSON.parse(response.body)["error"]
+      when 500...600
+        raise ServerError.new
+      else
+        if response.body.is_a?(Integer)
+          response.body
+        else
+          JSON.parse(response.body)
+        end
+      end
+    end
+
+    # Create an coupons object
+    #
+    # @return [Celery::Coupons] 
+    #
+    # @example
+    #
+    #   coupons = celery.coupons
+    #
+    def coupon
+      Coupon.new self
+    end
+
+    # Create an orders object
+    #
+    # @return [Celery::Orders] 
+    #
+    # @example
+    #
+    #   orders = celery.orders
+    #
+    def order
+      Order.new self
+    end
+
+    # Create an products object
+    #
+    # @return [Celery::Products] 
+    #
+    # @example
+    #
+    #   products = celery.products
+    #
+    def product
+      Product.new self
+    end
+
+    # Create an shop object
+    #
+    # @return [Celery::Shop] 
+    #
+    # @example
+    #
+    #   shop = celery.shop
+    #
+    def shop
+      Shop.new self
+    end
+
+    # Create an users object
+    #
+    # @return [Celery::Users] 
+    #
+    # @example
+    #
+    #   users = celery.users
+    #
+    def user
+      User.new self
+    end
+
+    private
+
+      # Set the request headers
+      def headers # :nodoc:
+        {
+          # TODO: Use HTTP Basic Authorization instead.
+          #'Authorization' => "Basic #{Base64.encode64(@token+':X')}",
+          'User-Agent' => "celery-ruby-#{VERSION}",
+          'Content-Type' => 'application/json; charset=utf-8',
+          'Accept' => 'application/json'
+        }
+      end
+
+  end
+end

data/lib/celery/errors.rb

@@ -0,0 +1,18 @@
+module Celery
+  class Error < StandardError
+  end
+  class BadRequest < Error
+  end
+  class ClientError < Error
+  end
+  class NotFound < Error
+  end
+  class ServerError < Error
+  end
+  class TooManyRequests < Error
+  end
+  class Unauthorized < Error
+  end
+  class Unavailable < Error
+  end
+end

data/lib/celery/resources/coupon.rb

@@ -0,0 +1,136 @@
+module Celery
+  class Coupon
+    attr_accessor :api
+
+    def initialize(api)
+      @api = api
+    end
+
+    # Returns a list of coupons you have. The coupons are returned
+    # in sorted order, with the most recent coupons appearing first.
+    # 
+    # @param [Integer] limit (optional) Limit the number of results.
+    # @param [Integer] skip (optional) Skip n results.
+    # @param [String] sort (optional) Field name to sort on.
+    # @param [String] order (optional) Either `asc` or `desc`.
+    #
+    # @return [JSON] A JSON object with the following attributes:
+    #   * total [Integer]
+    #   * count [Integer]
+    #   * offset [Integer]
+    #   * limit [Integer]
+    #   * has_more [Boolean]
+    #   * coupons [Array]
+    #
+    # @see https://www.trycelery.com/developer#list_coupons
+    #
+    # @example
+    #
+    #   coupons = celery.coupon.all(limit: 25, skip: 2, sort: 'created', order: 'asc')
+    #   coupons["total"]
+    #   => 28
+    #
+    def all(params = {})
+      @api.get("coupons", query: params)
+    end
+
+    # Retrieves a coupon that has previously been created.
+    # 
+    # @param [String] coupon_id (required) The identifier of the Coupon to be retrieved.
+    #
+    # @return [JSON] A Coupon object with the following attributes:
+    #   * code [String]
+    #   * type [String]
+    #   * discount [Integer]
+    #
+    # @see https://www.trycelery.com/developer#retrieve_coupon
+    #
+    # @example
+    #
+    #   coupon = celery.coupon.find("123abc")
+    #   coupon["code"]
+    #   => "Test Coupon Code"
+    #
+    def find(coupon_id)
+      @api.get("coupons/#{coupon_id}")
+    end
+
+    # Creates a new coupon object.
+    # 
+    # @param [Hash] coupon A hash of coupon attributes.
+    # @option coupon [String] code (required) the coupon code.
+    # @option coupon [String] type (required) the type of coupon.
+    # @option coupon [Integer] discount (required) the amount discounted.
+    #
+    # @return [JSON] A Coupon object with the following attributes:
+    #   * code [String]
+    #   * type [String]
+    #   * discount [Integer]
+    #
+    # @see https://www.trycelery.com/developer#create_coupon
+    #
+    # @example
+    #
+    #   coupon = {
+    #     code: "New Coupon Code",
+    #     type: "percent",
+    #     discount: 10
+    #   }
+    #   new_coupon = celery.coupon.new(coupon)
+    #   new_coupon["code"]
+    #   => "New Coupon Code"
+    #
+    def new(coupon)
+      @api.post("coupons", body: {coupon: coupon})
+    end
+
+    # Updates an existing coupon object.
+    # 
+    # @param [String] coupon_id (required) The identifier of the Coupon to be updated.
+    # @param [Hash] coupon A hash of coupon attributes.
+    # @option coupon [String] code (optional) the coupon code.
+    # @option coupon [String] type (optional) the type of coupon.
+    # @option coupon [Integer] discount (optional) the amount discounted.
+    #
+    # @return [JSON] A Coupon object with the following attributes:
+    #   * code [String]
+    #   * type [String]
+    #   * discount [Integer]
+    #
+    # @see https://www.trycelery.com/developer#update_coupon
+    #
+    # @example
+    #
+    #   updated_coupon = {
+    #     code: "Another Coupon Code",
+    #     type: "percent",
+    #     discount: 15
+    #   }
+    #   coupon = celery.coupon.update("123abc", updated_coupon)
+    #   coupon["code"]
+    #   => "Another Coupon Code"
+    #
+    def update(coupon_id, coupon)
+      @api.put("coupons/#{coupon_id}", body: {coupon: coupon})
+    end
+
+    # Deletes an existing coupon object.
+    # 
+    # @param [String] coupon_id (required) The identifier of the Coupon to be deleted.
+    #
+    # @return [JSON] A JSON object with the following attributes:
+    #   * status [Boolean]
+    #
+    # @see https://www.trycelery.com/developer#delete_coupon
+    #
+    # @example
+    #
+    #   result = celery.coupon.destroy("123abc")
+    #   result["status"]
+    #   => true
+    #
+    def destroy(coupon_id)
+      @api.delete("coupons/#{coupon_id}")
+    end
+  end
+end

data/lib/celery/resources/order.rb

@@ -0,0 +1,297 @@
+module Celery
+  class Order
+    attr_accessor :api
+
+    def initialize(api)
+      @api = api
+    end
+
+    # Returns a list of orders you have. The orders are returned
+    # in sorted order, with the most recent orders appearing first.
+    # 
+    # @param [Integer] limit (optional) Limit the number of results.
+    # @param [Integer] skip (optional) Skip n results.
+    # @param [String] sort (optional) Field name to sort on.
+    # @param [String] order (optional) Either `asc` or `desc`.
+    # @param [String] since (optional) Based on updated. Unix time in milliseconds (ms).
+    # @param [String] until (optional) Based on updated. Unix time in milliseconds (ms).
+    # @param [String] status (optional) Once of `paid`, `paid_balance`, `paid_deposit`, `refunded`, `shipped`.
+    #
+    # @return [JSON] A JSON object with the following attributes:
+    #   * total [Integer]
+    #   * count [Integer]
+    #   * offset [Integer]
+    #   * limit [Integer]
+    #   * has_more [Boolean]
+    #   * orders [Array]
+    #
+    # @see https://www.trycelery.com/developer#list_orders
+    #
+    # @example
+    #
+    #   orders = celery.order.all(limit: 25, skip: 2, sort: 'created', order: 'asc')
+    #   orders["total"]
+    #   => 158
+    #
+    def all(params = {})
+      @api.get("orders", query: params)
+    end
+
+    # Returns a list of `paid` orders.
+    # @see #all
+    #
+    # @example
+    #
+    #   paid = celery.order.paid(limit: 25, skip: 2, sort: 'created', order: 'asc')
+    #   paid["total"]
+    #   => 5
+    #
+    def paid(params = {})
+      params[:status] = 'paid'
+      all(params)
+    end
+
+    # Returns a list of `paid_balance` orders.
+    # @see #all
+    #
+    # @example
+    #
+    #   paid = celery.order.paid_balance(limit: 25, skip: 2, sort: 'created', order: 'asc')
+    #   paid["total"]
+    #   => 5
+    #
+    def paid_balance(params = {})
+      params[:status] = 'paid_balance'
+      all(params)
+    end
+
+    # Returns a list of `paid_deposit` orders.
+    # @see #all
+    #
+    # @example
+    #
+    #   paid = celery.order.paid_deposit(limit: 25, skip: 2, sort: 'created', order: 'asc')
+    #   paid["total"]
+    #   => 5
+    #
+    def paid_deposit(params = {})
+      params[:status] = 'paid_deposit'
+      all(params)
+    end
+
+    # Returns a list of `refunded` orders.
+    # @see #all
+    #
+    # @example
+    #
+    #   paid = celery.order.refunded(limit: 25, skip: 2, sort: 'created', order: 'asc')
+    #   paid["total"]
+    #   => 5
+    #
+    def refunded(params = {})
+      params[:status] = 'refunded'
+      all(params)
+    end
+
+    # Returns a list of `shipped` orders.
+    # @see #all
+    #
+    # @example
+    #
+    #   paid = celery.order.shipped(limit: 25, skip: 2, sort: 'created', order: 'asc')
+    #   paid["total"]
+    #   => 5
+    #
+    def shipped(params = {})
+      params[:status] = 'shipped'
+      all(params)
+    end
+
+    # Retrieves an order that has previously been created.
+    # 
+    # @param [String] order_id (required) The identifier of the Order to be retrieved.
+    #
+    # @return [JSON] An Order object.
+    #
+    # @see https://www.trycelery.com/developer#retrieve_order
+    #
+    # @example
+    #
+    #   order = celery.order.find("123abc")
+    #   order["_id"]
+    #   => "51ad40901a7e9b0200000006"
+    #
+    def find(order_id)
+      @api.get("orders/#{order_id}")
+    end
+
+    # Creates a new order object.
+    # 
+    # @param [Hash] order A hash of order attributes.
+    #
+    # @return [JSON] An Order object.
+    #
+    # @see https://www.trycelery.com/developer#create_order
+    #
+    # @example
+    #
+    #   order = {
+    #     seller_id: "123abc456",
+    #     buyer: {
+    #       email: "joe@public.com",
+    #       ...
+    #     },
+    #     ...
+    #   }
+    #   new_order = celery.order.new(order)
+    #   new_order["_id"]
+    #   => "51ad40901a7e9b0200000006"
+    #
+    def new(order)
+      @api.post("orders", body: {order: order})
+    end
+
+    # Updates an existing order object.
+    # 
+    # @param [String] order_id (required) The identifier of the Order to be updated.
+    # @param [Hash] order A hash of order attributes.
+    #
+    # @return [JSON] An Order object.
+    #
+    # @see https://www.trycelery.com/developer#update_order
+    #
+    # @example
+    #
+    #   updated_order = {
+    #     status: "refunded"
+    #   }
+    #   order = celery.order.update("123abc", updated_order)
+    #   order["status"]
+    #   => "refunded"
+    #
+    def update(order_id, order)
+      @api.put("orders/#{order_id}", body: {order: order})
+    end
+
+    # Deletes an existing order object.
+    # 
+    # @param [String] order_id (required) The identifier of the Order to be deleted.
+    #
+    # @return [JSON] A JSON object with the following attributes:
+    #   * status [Boolean]
+    #
+    # @see https://www.trycelery.com/developer#delete_order
+    #
+    # @example
+    #
+    #   result = celery.order.destroy("123abc")
+    #   result["status"]
+    #   => true
+    #
+    def destroy(order_id)
+      @api.delete("orders/#{order_id}")
+    end
+
+    # TODO: There is no way that this is a get request!
+    # TODO: Is "cancelled" and order status?
+    # Cancels an order.
+    # 
+    # @param [String] order_id (required) The identifier of the Order to be cancelled.
+    #
+    # @return [JSON] An Order object.
+    #
+    # @see https://www.trycelery.com/developer#cancel_order
+    #
+    # @example
+    #
+    #   cancelled_order = celery.order.cancel("123abc")
+    #   cancelled_order["status"]
+    #   => cancelled
+    #
+    def cancel(order_id)
+      @api.get("orders/#{order_id}/cancel")
+    end
+
+    # Charges deposit.
+    # 
+    # @param [String] order_id (required) The identifier of the Order to charge.
+    #
+    # @return [JSON] An Order object.
+    #
+    # @see https://www.trycelery.com/developer#charge_order_deposit
+    #
+    # @example
+    #
+    #   charge = celery.order.charge_deposit("123abc")
+    #
+    def charge_deposit(order_id)
+      @api.post("orders/#{order_id}/charge_deposit")
+    end
+
+    # Charges balance.
+    # 
+    # @param [String] order_id (required) The identifier of the Order to charge.
+    #
+    # @return [JSON] An Order object.
+    #
+    # @see https://www.trycelery.com/developer#charge_order_balance
+    #
+    # @example
+    #
+    #   charge = celery.order.charge_balance("123abc")
+    #
+    def charge_balance(order_id)
+      @api.post("orders/#{order_id}/charge_balance")
+    end
+
+    # Refunds deposit.
+    # 
+    # @param [String] order_id (required) The identifier of the Order to charge.
+    #
+    # @return [JSON] An Order object.
+    #
+    # @see https://www.trycelery.com/developer#refund_order_deposit
+    #
+    # @example
+    #
+    #   refund = celery.order.refund_deposit("123abc")
+    #
+    def refund_deposit(order_id)
+      @api.post("orders/#{order_id}/refund_deposit")
+    end
+
+    # Refunds balance.
+    # 
+    # @param [String] order_id (required) The identifier of the Order to charge.
+    #
+    # @return [JSON] An Order object.
+    #
+    # @see https://www.trycelery.com/developer#refund_order_balance
+    #
+    # @example
+    #
+    #   refund = celery.order.refund_balance("123abc")
+    #
+    def refund_balance(order_id)
+      @api.post("orders/#{order_id}/refund_balance")
+    end
+
+    # TODO: There is no way that this is a get request!
+    # TODO: Is "cancelled" and order status?
+    # Changes order status to `shipped `.
+    # 
+    # @param [String] order_id (required) The identifier of the Order to ship.
+    #
+    # @return [JSON] An Order object.
+    #
+    # @see https://www.trycelery.com/developer#ship_order
+    #
+    # @example
+    #
+    #   refund = celery.order.ship("123abc")
+    #
+    def ship(order_id)
+      @api.get("orders/#{order_id}/ship")
+    end
+  end
+end

data/lib/celery/resources/product.rb

@@ -0,0 +1,121 @@
+module Celery
+  class Product
+    attr_accessor :api
+
+    def initialize(api)
+      @api = api
+    end
+
+    # Returns a list of products you have.
+    # 
+    # @param [Integer] limit (optional) Limit the number of results.
+    # @param [Integer] skip (optional) Skip n results.
+    # @param [String] sort (optional) Field name to sort on.
+    # @param [String] order (optional) Either `asc` or `desc`.
+    #
+    # @return [JSON] A JSON object with the following attributes:
+    #   * total [Integer]
+    #   * count [Integer]
+    #   * offset [Integer]
+    #   * limit [Integer]
+    #   * has_more [Boolean]
+    #   * products [Array]
+    #
+    # @see https://www.trycelery.com/developer#list_products
+    #
+    # @example
+    #
+    #   products = celery.product.all(limit: 25, skip: 2, sort: 'created', order: 'asc')
+    #   products.total
+    #   => 28
+    #
+    def all(params = {})
+      @api.get("products", query: params)
+    end
+
+    # Retrieves a product that has previously been created.
+    # 
+    # @param [String] product_id (required) The identifier of the Product to be retrieved.
+    #
+    # @return [JSON] A Product object.
+    #
+    # @see https://www.trycelery.com/developer#retrieve_product
+    #
+    # @example
+    #
+    #   product = celery.product.find("123abc")
+    #   product["slug"]
+    #   => "test-product"
+    #
+    def find(product_id)
+      @api.get("products/#{product_id}")
+    end
+
+    # Creates a new product object.
+    # 
+    # @param [Hash] product A hash of product attributes.
+    # @option product [String] name (optional) the product name.
+    # @option product [Integer] price (optional) in cents.
+    # @option product [Integer] deposit (optional) in cents.
+    # @option product [Array] options (optional) 
+    #
+    # @return [JSON] A Product object.
+    #
+    # @see https://www.trycelery.com/developer#create_product
+    #
+    # @example
+    #
+    #   product = {
+    #     name: "New Product",
+    #     price: 1999,
+    #   }
+    #   new_product = celery.product.new(product)
+    #   new_product["name"]
+    #   => "New Product"
+    #
+    def new(product)
+      @api.post("products", body: {product: product})
+    end
+
+    # Updates an existing product object.
+    # 
+    # @param [String] product_id (required) The identifier of the Product to be updated.
+    # @param [Hash] product A hash of product attributes.
+    #
+    # @return [JSON] A Product object.
+    #
+    # @see https://www.trycelery.com/developer#update_product
+    #
+    # @example
+    #
+    #   product = {
+    #     name: "New Name"
+    #   }
+    #   updated = celery.product.update("123abc", product)
+    #   updated["name"]
+    #   => "New Name"
+    #
+    def update(product_id, product)
+      @api.put("products/#{product_id}", body: {product: product})
+    end
+
+    # Deletes an existing product object.
+    # 
+    # @param [String] product_id (required) The identifier of the Product to be deleted.
+    #
+    # @return [JSON] A JSON object with the following attributes:
+    #   * status [Boolean]
+    #
+    # @see https://www.trycelery.com/developer#delete_product
+    #
+    # @example
+    #
+    #   result = celery.product.destroy("123abc")
+    #   result["status"]
+    #   => true
+    #
+    def destroy(product_id)
+      @api.delete("products/#{product_id}")
+    end
+  end
+end

data/lib/celery/resources/shop.rb

@@ -0,0 +1,100 @@
+module Celery
+  class Shop
+    attr_accessor :api
+
+    def initialize(api)
+      @api = api
+    end
+
+    # Retrieves the public details of a Product or Collection that has
+    # previously been created.
+    # 
+    # @param [String] slug (required) The identifier of the Product or Collection to be retrieved.
+    #
+    # @return [JSON] A Product or Collection object
+    #
+    # @see https://www.trycelery.com/developer#retrieve_shop
+    #
+    # @example
+    #
+    #   shop = celery.shop.find("product-slug")
+    #   => { "product": { "_id": "123abc", ... } }
+    #
+    def find(slug)
+      @api.get("shop/#{slug}")
+    end
+
+    # Returns whether a product slug is being used.
+    # 
+    # @param [String] slug (required) The identifier of the slug to check.
+    #
+    # @return [JSON] A JSON object with the following attributes:
+    #   * slugify [Boolean]
+    #
+    # @see https://www.trycelery.com/developer#check_slug
+    #
+    # @example
+    #
+    #   check = celery.shop.check("test-slug")
+    #   check["slugify"]
+    #   => false
+    #
+    def check(slug)
+      @api.get("slugify", query: {slug: slug})
+    end
+
+    # TODO: This seems like a duplicate of Order#new.
+    # Checkout with credit card and creates a new order object.
+    # 
+    # @param [Hash] order A hash of order attributes.
+    #
+    # @return [JSON] An Order object.
+    #
+    # @see https://www.trycelery.com/developer#checkout
+    #
+    # @example
+    #
+    #   order = {
+    #     seller_id: "123abc456",
+    #     buyer: {
+    #       email: "joe@public.com",
+    #       ...
+    #     },
+    #     ...
+    #   }
+    #   checkout = celery.shop.checkout(order)
+    #   checkout["_id"]
+    #   => "51ad40901a7e9b0200000006"
+    #
+    def checkout(order)
+      @api.post("checkout", body: {order: order})
+    end
+
+    # TODO: This seems like a duplicate of Order#new.
+    # Checkout with PayPal and creates a new order object with PayPal.
+    # 
+    # @param [Hash] order A hash of order attributes.
+    #
+    # @return [JSON] An Order object.
+    #
+    # @see https://www.trycelery.com/developer#checkout_paypal
+    #
+    # @example
+    #
+    #   order = {
+    #     seller_id: "123abc456",
+    #     buyer: {
+    #       email: "joe@public.com",
+    #       ...
+    #     },
+    #     ...
+    #   }
+    #   checkout = celery.shop.checkout_paypal(order)
+    #   checkout["_id"]
+    #   => "51ad40901a7e9b0200000006"
+    #
+    def checkout_paypal(order)
+      @api.post("checkout/paypal", body: {order: order})
+    end
+  end
+end

data/lib/celery/resources/user.rb

@@ -0,0 +1,44 @@
+module Celery
+  class User
+    attr_accessor :api
+
+    def initialize(api)
+      @api = api
+    end
+
+    # Retrieves seller information about yourself.
+    #
+    # @return [JSON] A User object.
+    #
+    # @see https://www.trycelery.com/developer#retrieve_yourself
+    #
+    # @example
+    #
+    #   profile = celery.user.me
+    #   profile["email"]
+    #   => "joe@public.com"
+    #
+    def me
+      @api.get("users/me")
+    end
+
+    # TODO: Need to get the arguments for this method.
+    # Updates seller information about yourself.
+    # 
+    # @param [Hash] user A hash of user attributes.
+    #
+    # @return [JSON] A User object.
+    #
+    # @see https://www.trycelery.com/developer#update_yourself
+    #
+    # @example
+    #
+    #   profile = celery.user.update(email: 'john@public.com')
+    #   profile["email"]
+    #   => "john@public.com"
+    #
+    def update(user)
+      @api.put("users/me", body: {user: user})
+    end
+  end
+end

data/lib/celery/version.rb

@@ -0,0 +1,3 @@
+module Celery
+  VERSION = "0.0.2"
+end

data/rails/init.rb

@@ -0,0 +1 @@
+require 'celery'

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification
+name: celery
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Brian Getting
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: excon
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.31.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.31.0
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.1
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.14.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'
+description: Ruby wrapper for the Celery API
+email:
+- brian@tatem.ae
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- celery.gemspec
+- lib/celery.rb
+- lib/celery/.DS_Store
+- lib/celery/errors.rb
+- lib/celery/resources/coupon.rb
+- lib/celery/resources/order.rb
+- lib/celery/resources/product.rb
+- lib/celery/resources/shop.rb
+- lib/celery/resources/user.rb
+- lib/celery/version.rb
+- rails/init.rb
+homepage: https://github.com/tatemae-consultancy/celery-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.0.14
+signing_key: 
+specification_version: 4
+summary: Ruby wrapper for the Celery API
+test_files: []