fetchapp-api-ruby 1.2.5 → 2.0.0

data/CHANGELOG

@@ -1,3 +1,5 @@
+v.2.0.0 ** API version 2.0 **
+
 v.1.2.5 Upload Support
 
 v.1.2.4 Removed dependency on ActiveRecord and Active Support

data/Manifest

@@ -4,9 +4,11 @@ init.rb
 lib/fetchapp-api-ruby/account.rb
 lib/fetchapp-api-ruby/base.rb
 lib/fetchapp-api-ruby/download.rb
+lib/fetchapp-api-ruby/file.rb
 lib/fetchapp-api-ruby/upload.rb
-lib/fetchapp-api-ruby/item.rb
+lib/fetchapp-api-ruby/product.rb
 lib/fetchapp-api-ruby/order.rb
+lib/fetchapp-api-ruby/order_item.rb
 lib/fetchapp-api-ruby-ruby.rb
 LICENSE
 Manifest

data/README.md

@@ -4,52 +4,85 @@
 
 # Setup
 ```ruby
-	FetchAPI::Base.basic_auth('youraccount.fetchapp.com', 'demokey', 'demotoken')
+	FetchAppAPI::Base.basic_auth('demokey', 'demotoken')
 ```
 # Account
 ```ruby
-	account = FetchAPI::Account.details
+	account = FetchAppAPI::Account.details
 
-	token = FetchAPI::Account.new_token  #Subsequent calls will use the new token automatically
+	token = FetchAppAPI::Account.new_token  # Subsequent calls will use the new token automatically
 ```
 # Downloads
 ```ruby
-	downloads = FetchAPI::Download.find(:all, :per_page => 50, :page => 2)
+	downloads = FetchAppAPI::Download.find(:all, :per_page => 50, :page => 2)
 
-	download = FetchAPI::Download.find(1)
+	download = FetchAppAPI::Download.find(1)
 ```
 
-# Items
+# Products
 ```ruby
-	items = FetchAPI::Item.find(:all, :per_page => 10, :page => 3)
+	products = FetchAppAPI::Product.find(:all, :per_page => 10, :page => 3)
 
-	item = FetchAPI::Item.find("CJ0001")
+	product = FetchAppAPI::Product.find("CJ0001")
 
-	item = FetchAPI::Item.create(:sku => "CJ0001", :name => "Carrot Juice")
+	product = FetchAppAPI::Product.create(:sku => "CJ0001", :name => "Carrot Juice")
 
-	item.update(:name => "Tomato Juice")
+	product.update(:name => "Tomato Juice")
 
-	item.destroy
+	product.destroy
 
-	downloads = item.downloads  #Returns an array of FetchAPI::Downloads for this item
+	product.stats  # Returns a FetchAppAPI::Product with only statistical fields filled in
+
+	downloads = product.downloads  # Returns an array of FetchAppAPI::Download for this product
+
+	files = product.files  # Returns an array of FetchAppAPI::File for this product
 ```
 # Orders
 ```ruby
-	all_orders = FetchAPI::Order.find(:all)
+	all_orders = FetchAppAPI::Order.find(:all)
 
-	current_orders = FetchAPI::Order.find(:current, :page => 3)
+	current_orders = FetchAppAPI::Order.find(:current, :page => 3)
 
-	manual_orders = FetchAPI::Order.find(:manual, :per_page => 10)
+	manual_orders = FetchAppAPI::Order.find(:manual, :per_page => 10)
 
-	expired_orders = FetchAPI::Order.find(:expired, :per_page => 10, :page => 3)
+	expired_orders = FetchAppAPI::Order.find(:expired, :per_page => 10, :page => 3)
 
-	order = FetchAPI::Order.find("1001")
+	order = FetchAppAPI::Order.find("1001")
 
-	order = FetchAPI::Order.create(:id => "1015", :title => "Test Order", :first_name => "Donald", :last_name => "Duck", :email => "donald@duck.com", :order_items => [{:sku => 'ABC0001'}, {:sku => 'ABC0002}])
+	order = FetchAppAPI::Order.create(
+	    :id => "1015",
+	    :title => "Test Order",
+	    :first_name => "Donald",
+	    :last_name => "Duck",
+	    :email => "donald@duck.com",
+	    :order_items => [{:sku => 'ABC0001'}, {:sku => 'ABC0002'}]
+	)
 
 	order.update(:first_name => "Daffy")
 
 	order.destroy
 
-	downloads = order.downloads  #Returns an array of FetchAPI::Downloads for this order
+	order.expire # Expires the order
+
+	order.send_email # Reopens the order and sends out an email to the customer
+
+	order.stats  # Returns a FetchAppAPI::Order with only statistical fields filled in
+
+	order_items = order.order_items # Returns an array of FetchAppAPI::OrderItem for this order
+
+	downloads = order.downloads  # Returns an array of FetchAppAPI::Download for this order
+
+```
+
+# OrderItems
+```ruby
+	order_items = order.order_items # Returns an array of FetchAppAPI::OrderItem for this order
+
+	order_item = FetchAppAPI::Order.find("445566")
+
+    order_item.expire # Expires the OrderItem
+
+	downloads = order_item.downloads  # Returns an array of FetchAppAPI::Download for this order item
+
+	files = order_item.files  # Returns an array of FetchAppAPI::File for this order item
 ```

data/fetchapp-api-ruby.gemspec

@@ -2,15 +2,15 @@
 
 Gem::Specification.new do |s|
   s.name = %q{fetchapp-api-ruby}
-  s.version = "1.2.5"
+  s.version = "2.0.0"
   s.platform = Gem::Platform::RUBY
   s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
   s.authors = ["Michael Larkin"]
   s.date = Date.today.strftime('%Y-%m-%d')
   s.description = %q{Integrate your site with http://fetchapp.com for seamless digital delivery.}
   s.email = %q{support@fetchapp.com}
-  s.extra_rdoc_files = ["CHANGELOG", "lib/fetchapp-api-ruby/account.rb", "lib/fetchapp-api-ruby/base.rb", "lib/fetchapp-api-ruby/download.rb", "lib/fetchapp-api-ruby/upload.rb", "lib/fetchapp-api-ruby/item.rb", "lib/fetchapp-api-ruby/order.rb", "lib/fetchapp-api-ruby.rb", "LICENSE", "README.md"]
-  s.files = ["CHANGELOG", "fetchapp-api-ruby.gemspec", "init.rb", "lib/fetchapp-api-ruby/account.rb", "lib/fetchapp-api-ruby/base.rb", "lib/fetchapp-api-ruby/download.rb", "lib/fetchapp-api-ruby/upload.rb", "lib/fetchapp-api-ruby/item.rb", "lib/fetchapp-api-ruby/order.rb", "lib/fetchapp-api-ruby.rb", "LICENSE", "Manifest", "Rakefile", "README.md"]
+  s.extra_rdoc_files = ["CHANGELOG", "lib/fetchapp-api-ruby/account.rb", "lib/fetchapp-api-ruby/base.rb", "lib/fetchapp-api-ruby/download.rb", "lib/fetchapp-api-ruby/upload.rb", "lib/fetchapp-api-ruby/product.rb", "lib/fetchapp-api-ruby/order.rb", "lib/fetchapp-api-ruby/order_item.rb", "lib/fetchapp-api-ruby/file.rb", "lib/fetchapp-api-ruby.rb", "LICENSE", "README.md"]
+  s.files = ["CHANGELOG", "fetchapp-api-ruby.gemspec", "init.rb", "lib/fetchapp-api-ruby/account.rb", "lib/fetchapp-api-ruby/base.rb", "lib/fetchapp-api-ruby/download.rb", "lib/fetchapp-api-ruby/upload.rb", "lib/fetchapp-api-ruby/order_item.rb", "lib/fetchapp-api-ruby/file.rb", "lib/fetchapp-api-ruby/product.rb", "lib/fetchapp-api-ruby/order.rb", "lib/fetchapp-api-ruby.rb", "LICENSE", "Manifest", "Rakefile", "README.md"]
   s.has_rdoc = true
   s.homepage = %q{http://github.com/getsy/fetchapp-api-ruby}
   s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "fetchapp-api-ruby", "--main", "README.md"]

data/lib/fetchapp-api-ruby.rb

@@ -6,6 +6,8 @@ $:.unshift(File.dirname(__FILE__))
 require 'fetchapp-api-ruby/base'
 require 'fetchapp-api-ruby/account'
 require 'fetchapp-api-ruby/download'
-require 'fetchapp-api-ruby/upload'
-require 'fetchapp-api-ruby/item'
+require 'fetchapp-api-ruby/file'
 require 'fetchapp-api-ruby/order'
+require 'fetchapp-api-ruby/order_item'
+require 'fetchapp-api-ruby/upload'
+require 'fetchapp-api-ruby/product'

data/lib/fetchapp-api-ruby/account.rb

@@ -1,15 +1,15 @@
-module FetchAPI
-  class Account < FetchAPI::Base
-   attr_accessor :attributes
+module FetchAppAPI
+  class Account < FetchAppAPI::Base
+    attr_accessor :attributes
     #--
     ################ Class Methods ###############
     #--
 
     # Retrieves information about the Account
     def self.details
-    account = Account.new({})
-    account.attributes = execute(:get, "/account")["account"]
-    account
+      account = Account.new({})
+      account.attributes = execute(:get, "/account")["account"]
+      account
     end
 
     # Generates a new API token.  Subsequent API calls using the
@@ -18,7 +18,7 @@ module FetchAPI
       token = execute(:get, "/new_token")
       unless token["message"].nil? || token["message"].empty?
         # Reauthorize
-        Connector.basic_auth(FetchAPI::Base.key, token["message"])
+        Connector.basic_auth(FetchAppAPI::Base.key, token["message"])
         token
       end
     end

data/lib/fetchapp-api-ruby/base.rb

@@ -1,4 +1,13 @@
-module FetchAPI
+
+# Extend the String class to have the handy .blank? method
+class String
+  def blank?
+    self.empty? || self.nil?
+  end
+end
+
+module FetchAppAPI
+
   class Base
     require 'pp'
 
@@ -35,10 +44,12 @@ module FetchAPI
     end
 
     # Initializes the connection to the API
-    def self.basic_auth(url, key, token)
-      @key = key # Save this in case they generate a new token later
-      Connector.base_uri(url+"/api")
-      Connector.basic_auth(key, token)
+    def self.basic_auth(params={})
+      return false if params[:key].blank? || params[:token].blank?
+
+      @key = params[:key] # Save this in case they generate a new token later
+      Connector.base_uri((params[:url] || 'app.fetchapp.com')+"/api/v2")
+      Connector.basic_auth(params[:key], params[:token])
     end
 
     def self.key #:nodoc:
@@ -82,11 +93,11 @@ module FetchAPI
         when 200..299 then
           response
         when 300.399 then
-          raise(response.messsage)
+          raise("#{response.message}: #{response['message']}")
         when 400..499 then
-          raise(response.message)
+           raise("#{response.message}: #{response['message']}")
         when 500..599 then
-          raise(response.message)
+          raise("#{response.message}: #{response['message']}")
         else
           raise("Unknown Response")
       end
@@ -94,7 +105,7 @@ module FetchAPI
     end
 
 
-    # Access attributes as class methods of the Item object
+    # Access attributes as class methods of the object
     def method_missing(method) #:nodoc:
       return super unless attributes.has_key?(method.to_s)
       attributes[method.to_s]

data/lib/fetchapp-api-ruby/download.rb

@@ -1,5 +1,5 @@
-module FetchAPI
-  class Download < FetchAPI::Base
+module FetchAppAPI
+  class Download < FetchAppAPI::Base
     attr_accessor :id, :attributes
 
    # Find :all downloads or the specified ID

data/lib/fetchapp-api-ruby/file.rb

@@ -0,0 +1,11 @@
+module FetchAppAPI
+  class File < FetchAppAPI::Base
+    attr_accessor :id, :attributes
+
+   # Find :all files or the specified ID
+   def self.find(selector, params={})
+       super(selector, params)
+    end
+
+  end
+end

data/lib/fetchapp-api-ruby/order.rb

@@ -1,48 +1,48 @@
-module FetchAPI
+module FetchAppAPI
 
-  class Order < FetchAPI::Base
+  class Order < FetchAppAPI::Base
     attr_accessor :id, :attributes
 
     #--
     ################ Class Methods ###############
     #--
 
-   # Finds an Order or orders based on the specified parameters
-   # :all, :current, :manual, :expired, or by ID
+    # Finds an Order or orders based on the specified parameters
+    # :all, :current, :manual, :expired, or by ID
     def self.find(selector, params={})
       case selector
-      when :current
-        params.merge!(:filter => "current")
-        orders = execute(:get, "/orders", params)
-        if orders["orders"].nil? || orders["orders"].empty?
-          return []
+        when :current
+          params.merge!(:filter => "current")
+          orders = execute(:get, "/orders", params)
+          if orders["orders"].nil? || orders["orders"].empty?
+            return []
+          else
+            orders["orders"].map { |data| new(data) }
+          end
+        when :manual
+          params.merge!(:filter => "manual")
+          orders = execute(:get, "/orders", params)
+          if orders["orders"].nil? || orders["orders"].empty?
+            return []
+          else
+            orders["orders"].map { |data| new(data) }
+          end
+        when :expired
+          params.merge!(:filter => "expired")
+          orders = execute(:get, "/orders", params)
+          if orders["orders"].nil? || orders["orders"].empty?
+            return []
+          else
+            orders["orders"].map { |data| new(data) }
+          end
         else
-          orders["orders"].map { |data| new(data) }
-        end
-      when :manual
-        params.merge!(:filter => "manual")
-        orders = execute(:get, "/orders", params)
-        if orders["orders"].nil? || orders["orders"].empty?
-          return []
-        else
-          orders["orders"].map { |data| new(data) }
-        end
-      when :expired
-        params.merge!(:filter => "expired")
-        orders = execute(:get, "/orders", params)
-        if orders["orders"].nil? || orders["orders"].empty?
-          return []
-        else
-          orders["orders"].map { |data| new(data) }
-        end
-      else
-        super
+          super
       end
     end
 
     # Creates a new Order
     def self.create(options={})
-      return FetchAPI::Order.new(execute(:post, "/orders/create", :order => options)["order"])
+      return FetchAppAPI::Order.new(execute(:post, "/orders/create", :order => options)["order"])
     end
 
     #--
@@ -72,11 +72,27 @@ module FetchAPI
       self.attributes = put("/orders/#{id}", :order => options)["order"]
     end
 
-   # Returns all the downloads associated with this Order
+    # Returns all the downloads associated with this Order
+    def order_items(params={})
+      order_items = get("/orders/#{id}/order_items")
+      if order_items
+        order_items["order_items"].map { |data| FetchAppAPI::OrderItem.new(data) }
+      end
+    end
+
+
+    # Returns all the downloads associated with this Order
     def downloads(params={})
       downloads = get("/orders/#{id}/downloads")
       if downloads
-        downloads["downloads"].map { |data| FetchAPI::Download.new(data) }
+        downloads["downloads"].map { |data| FetchAppAPI::Download.new(data) }
+      end
+    end
+
+    def stats
+      stats = get("/orders/#{id}/stats")
+      if stats
+        FetchAppAPI::Order.new(stats["order"])
       end
     end
 

data/lib/fetchapp-api-ruby/order_item.rb

@@ -0,0 +1,45 @@
+module FetchAppAPI
+
+  class OrderItem < FetchAppAPI::Base
+    attr_accessor :id, :attributes
+
+    #--
+    ################ Class Methods ###############
+    #--
+
+    # Finds an Order or orders based on the specified parameters
+    # :all or by ID
+    def self.find(selector, params={})
+      super(selector, params)
+    end
+
+    #--
+    ################# Instance Methods ###############
+    #--
+
+    # Sets the expiration date to Time.now, stopping future downloads
+    def expire
+      post("/orders/#{order_id}/order_items/#{id}/expire")
+    end
+
+    # Returns all the downloads associated with this Order
+    def downloads(params={})
+      downloads = get("/orders/#{order_id}/order_items/#{id}/downloads")
+      if downloads
+        downloads["downloads"].map { |data| FetchAppAPI::Download.new(data) }
+      else
+        return []
+      end
+    end
+
+    def files(params={})
+      files = get("/orders/#{order_id}/order_items/#{id}/files")
+      if files
+        files["files"].map { |data| FetchAppAPI::File.new(data) }
+      else
+        return []
+      end
+    end
+
+  end
+end

data/lib/fetchapp-api-ruby/product.rb

@@ -0,0 +1,71 @@
+module FetchAppAPI
+  class Product < FetchAppAPI::Base
+    attr_accessor :id, :attributes
+
+    def initialize(id_or_attributes) #:nodoc:
+      case id_or_attributes
+        when Integer, String
+          @attributes = get("/#{self.class.pluralized_class_name}/#{id_or_attributes.to_s}")
+          @attributes = @attributes[self.class.singularized_class_name]
+        when Hash
+          @attributes = id_or_attributes
+      end
+    end
+
+
+    #--
+    ################ Class Methods ###############
+    #--
+
+    # Find :all products or a specific SKU
+    def self.find(selector, params={})
+      super(selector, params)
+    end
+
+
+    # Creates a new Product
+    def self.create(options)
+      return FetchAppAPI::Product.new(execute(:post, "/products/create", :product => options)["product"])
+    end
+
+    #--
+    ################# Instance Methods ###############
+    #--
+
+    # Permanently deletes the Product
+    def destroy
+      delete("/products/#{self.sku}/delete")
+    end
+
+    # Immediately updates the Product
+    def update(options)
+      self.attributes = put("/products/#{self.sku}", :product => options)["product"]
+      self.id = self.sku
+    end
+
+    # Returns all the downloads associated with this Product
+    def downloads
+      downloads = get("/products/#{sku}/downloads")
+      if downloads
+        downloads["downloads"].map { |data| FetchAppAPI::Download.new(data) }
+      end
+    end
+
+    # Returns all the downloads associated with this Product
+    def files
+      files = get("/products/#{sku}/files")
+      if files
+        files["files"].map { |data| FetchAppAPI::File.new(data) }
+      end
+    end
+
+    # Returns stats about this Product
+    def stats
+      stats = get("/products/#{sku}/stats")
+      if stats
+        FetchAppAPI::Product.new(stats["product"])
+      end
+    end
+
+  end
+end

data/lib/fetchapp-api-ruby/upload.rb

@@ -1,5 +1,5 @@
-module FetchAPI
-  class Upload < FetchAPI::Base
+module FetchAppAPI
+  class Upload < FetchAppAPI::Base
     attr_accessor :id, :attributes
 
    # Find :all uploads or the specified ID

metadata

@@ -1,83 +1,67 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: fetchapp-api-ruby
-version: !ruby/object:Gem::Version 
-  hash: 21
+version: !ruby/object:Gem::Version
+  version: 2.0.0
   prerelease: 
-  segments: 
-  - 1
-  - 2
-  - 5
-  version: 1.2.5
 platform: ruby
-authors: 
+authors:
 - Michael Larkin
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2012-04-13 00:00:00 -04:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2012-08-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: httparty
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: &70198023540320 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :runtime
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: fakeweb
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  version_requirements: *70198023540320
+- !ruby/object:Gem::Dependency
+  name: fakeweb
+  requirement: &70198023539340 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
-  name: mocha
   prerelease: false
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  version_requirements: *70198023539340
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: &70198023538340 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id003
+  prerelease: false
+  version_requirements: *70198023538340
 description: Integrate your site with http://fetchapp.com for seamless digital delivery.
 email: support@fetchapp.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - CHANGELOG
 - lib/fetchapp-api-ruby/account.rb
 - lib/fetchapp-api-ruby/base.rb
 - lib/fetchapp-api-ruby/download.rb
 - lib/fetchapp-api-ruby/upload.rb
-- lib/fetchapp-api-ruby/item.rb
+- lib/fetchapp-api-ruby/product.rb
 - lib/fetchapp-api-ruby/order.rb
+- lib/fetchapp-api-ruby/order_item.rb
+- lib/fetchapp-api-ruby/file.rb
 - lib/fetchapp-api-ruby.rb
 - LICENSE
 - README.md
-files: 
+files:
 - CHANGELOG
 - fetchapp-api-ruby.gemspec
 - init.rb
@@ -85,52 +69,45 @@ files:
 - lib/fetchapp-api-ruby/base.rb
 - lib/fetchapp-api-ruby/download.rb
 - lib/fetchapp-api-ruby/upload.rb
-- lib/fetchapp-api-ruby/item.rb
+- lib/fetchapp-api-ruby/order_item.rb
+- lib/fetchapp-api-ruby/file.rb
+- lib/fetchapp-api-ruby/product.rb
 - lib/fetchapp-api-ruby/order.rb
 - lib/fetchapp-api-ruby.rb
 - LICENSE
 - Manifest
 - Rakefile
 - README.md
-has_rdoc: true
 homepage: http://github.com/getsy/fetchapp-api-ruby
 licenses: []
-
 post_install_message: 
-rdoc_options: 
+rdoc_options:
 - --line-numbers
 - --inline-source
 - --title
 - fetchapp-api-ruby
 - --main
 - README.md
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 11
-      segments: 
-      - 1
-      - 2
-      version: "1.2"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '1.2'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.5.3
+rubygems_version: 1.8.6
 signing_key: 
 specification_version: 3
-summary: This Ruby library allows you to integrate your site with http://fetchapp.com for seamless digital delivery so you can build additional functionality while retaining the core features of Fetch.  Credit for the bulk of the code goes to Thomas Reynolds.
+summary: This Ruby library allows you to integrate your site with http://fetchapp.com
+  for seamless digital delivery so you can build additional functionality while retaining
+  the core features of Fetch.  Credit for the bulk of the code goes to Thomas Reynolds.
 test_files: []
-

data/lib/fetchapp-api-ruby/item.rb

@@ -1,55 +0,0 @@
-module FetchAPI
-  class Item < FetchAPI::Base
-    attr_accessor :id, :attributes
-
-    def initialize(id_or_attributes) #:nodoc:
-      case id_or_attributes
-      when Integer, String
-        @attributes = get("/#{self.class.pluralized_class_name}/#{id_or_attributes.to_s}")
-        @attributes = @attributes[self.class.singularized_class_name]
-      when Hash
-        @attributes = id_or_attributes
-      end
-    end
-
-
-    #--
-    ################ Class Methods ###############
-    #--
-
-    # Find :all items or a specific SKU
-    def self.find(selector, params={})
-      super(selector, params)
-    end
-
-
-    # Creates a new Item
-    def self.create(options)
-      return FetchAPI::Item.new(execute(:post, "/items/create", :item => options)["item"])
-    end
-
-    #--
-    ################# Instance Methods ###############
-    #--
-
-    # Permanently deletes the Item
-    def destroy
-      delete("/items/#{sku}/delete")
-    end
-
-    # Immediately updates the Item
-    def update(options)
-      self.attributes = put("/items/#{sku}", :item => options)["item"]
-      self.id = self.sku
-    end
-
-    # Returns all the downloads associated with this Item
-    def downloads
-      downloads = get("/items/#{sku}/downloads")
-      if downloads
-        downloads["downloads"].map { |data| FetchAPI::Download.new(data) }
-      end
-    end
-
-  end
-end