bigcommerce 0.9.0 → 0.10.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a54eb51eb08fb56817334d0725b0f58f7815e882
+  data.tar.gz: 293bfd8af80d9a3ebdc19a0c5c49c39ed1f3b1ff
+SHA512:
+  metadata.gz: 839f079c9d4f3aef25dbbf2faf5455c3496084784243b4cb92ed9df643968ff6acba952d71eebb2b43799cc6f0845611cde3315844ff56b9d01d0ec2c9f67624
+  data.tar.gz: 19da39343bff9cd3f49a140478c5300f6dbfd071ed33d0ba894c2b44deceba26630fd13ecdba098be5a7c5e94b4d9abba9ba657e09386106b7452ba27cc51070

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (C) Bigcommerce, 2011.
+Copyright (C) Bigcommerce, 2015.
 All rights reserved.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy

data/README.md

@@ -1,5 +1,4 @@
-Bigcommerce API V2 - Ruby Client
-================================
+# Bigcommerce API V2 - Ruby Client
 
 [![Gem Version](https://badge.fury.io/rb/bigcommerce.png)](https://rubygems.org/gems/bigcommerce)
 [![Build Status](https://travis-ci.org/bigcommerce/bigcommerce-api-ruby.png?branch=master)](https://travis-ci.org/bigcommerce/bigcommerce-api-ruby)
@@ -10,121 +9,101 @@ Bigcommerce API V2 - Ruby Client
 This library provides a wrapper around the Bigcommerce REST API for use within
 Ruby apps or via the console.
 
-Note
-----
+### Note
+
 If you find anything that is missing or needs clean up, please feel free to fork
 it and submit a changes with your pull request.
 
-Requirements
-------------
+## Requirements
 
 - Ruby 1.9+
 
 To connect to the API, you need the following credentials:
 
+For the OAuth API:
+
+- Create and register an app at [developer.bigcommerce.com](https://developer.bigcommerce.com).
+- Have a callback URL defined
+- Prepare the `client_id` credential
+
+For the Legacy API:
+
 - Secure URL pointing to a Bigcommerce store
 - Username of an authorized admin user of the store
 - API key for the user
 
-A valid API key is required to authenticate requests. To grant API access for a
-user, go to Control Panel > Users > Edit User and make sure that the
-'Enable API access?' checkbox is ticked.
+A valid API key is required to authenticate requests. To grant API access for a user, go to Control Panel > Users > Edit User and make sure that the 'Enable API access?' checkbox is ticked.
 
-Installation
-------------
+## Installation
 
 Download the lib folder and copy it to a path accessible within your app, or
 install the package directly from Rubygems:
 
-```
+```sh
 gem install bigcommerce
 ```
 
-Note that the RubyGems version of this gem might be outdated. You can install the
-gem directly from this repo. If you are using Rails, you can point your Gemfile
-to this git repo directly or do a local install of the gem by -
+## Configuration
 
-```
-rake build
-gem install pkg/bigcommerce-*.gem
-```
+#### OAuth Authentication
 
-Configuration
--------------
+In order to create a new Bigcommerce application, please visit [developer.bigcommerce.com](https://developer.bigcommerce.com). Its free to sign up and only takes a moment. Once you have created your app, you can get a `client_id`.
 
 To use the API client in your Ruby code, provide the required credentials as
 follows:
 
-```
+```rb
 require 'bigcommerce'
 
 api = Bigcommerce::Api.new({
-	:store_url => "https://store.mybigcommerce.com",
-	:username  => "admin",
-	:api_key   => "d81aada4c19c34d913e18f07fd7f36ca"
-})
-```
-
-If you want to enable SSL certificates -
-
-```
-require 'bigcommerce'
-api = Bigcommerce::Api.new({
-	:store_url => "https://store.mybigcommerce.com",
-	:username  => "admin",
-	:api_key   => "d81aada4c19c34d913e18f07fd7f36ca"
-	:ssl_client_cert  =>  OpenSSL::X509::Certificate.new(File.read("cert.pem")),
-  	:ssl_client_key   =>  OpenSSL::PKey::RSA.new(File.read("key.pem"), "passphrase, if any"),
-  	:ssl_ca_file      =>  "ca_certificate.pem",
-  	:verify_ssl       =>  OpenSSL::SSL::VERIFY_PEER 
+  :store_hash    => 'STORE_HASH',
+  :client_id     => 'CLIENT_ID',
+  :access_token  => 'ACCESS_TOKEN'
 })
 ```
-Remember that the fields `:ssl_client_cert`, `:ssl_client_key`, `:ssl_ca_file` 
-and `:verify_ssl` are all required when enabling SSL certificates.
-
-Connecting to the store
------------------------
 
-Ping the get_time method to check that your configuration is working and you
-can connect successfully to the store:
+__NOTE:__ You do not need extra SSL certificates when connecting to the OAuth version of the api.
 
-```
-ping = api.get_time
-```
+#### Legacy Credentials
 
-Usage
------
+To use the API client with the legacy credentials you can visit the main store page and under the "Setup & Tools" dropdown, you will see a link for the legacy API credentials.
 
-The API object acts as a gateway to all top level resources in the V2 API.
+```rb
+require 'bigcommerce'
 
-Fetch Data
+api = Bigcommerce::Api.new({
+  :store_url => "https://store.mybigcommerce.com",
+  :username  => "username",
+  :api_key   => "api_key"
+})
 ```
-orders = api.get_orders
-orders = api.get_orders({:min_id=>100,:max_id=>101})
-orders = api.get_orders(:is_deleted => true)
 
-products = api.get_products
-products = api.get_products(:description=>"iphone", :condition=>"New")
+You can also enable SSL for the Legacy API.
 
-options = api.get_options
-options = api.get_options(:type=>"MT")
-...
+```rb
+require 'bigcommerce'
 
+api = Bigcommerce::Api.new({
+  :store_url => "https://store.mybigcommerce.com",
+  :username  => "username",
+  :api_key   => "api_key",
+  :ssl_client_cert  =>  OpenSSL::X509::Certificate.new(File.read("cert.pem")),
+  :ssl_client_key   =>  OpenSSL::PKey::RSA.new(File.read("key.pem"), "passphrase, if any"),
+  :ssl_ca_file      =>  "ca_certificate.pem",
+  :verify_ssl       =>  OpenSSL::SSL::VERIFY_PEER
+})
 ```
-Create Data
-```
-api.create_products({:name => "Spiderman - The best return",:price => 9.99,:categories => [17],:type =>"physical",:availability => "available", :weight => 1})
-
-api.update_products(31,{:name => "marvel comics spiderman",:sku => "marvel-spidey-1", :inventory_tracking => "simple", :inventory_level => 500})
+Remember that the fields `:ssl_client_cert`, `:ssl_client_key`, `:ssl_ca_file`
+and `:verify_ssl` are all required when enabling SSL certificates.
 
-api.update_orders(101,{:status_id => 12, :is_deleted => true})
+## Connecting to the store
 
-```
-Update Data
+Once you have authenticated with the OAuth or Legacy credentials, ping the time method to check that your configuration is working and you can connect successfully to the store:
 
+```rb
+ping = api.time()
 ```
-api.update_products(31,{:name => "marvel comics spiderman",:sku => "marvel-spidey-1", :inventory_tracking => "simple", :inventory_level => 500})
 
-api.update_optionsets(13,{:name => "Marvel toys"})
+## Reference
 
-```
+For full reference about the resources and supported endpoints, please see [developer.bigcommerce.com](https://developer.bigcommerce.com).

data/bigcommerce.gemspec

@@ -1,31 +1,59 @@
 # -*- encoding: utf-8 -*-
-require File.expand_path('../lib/bigcommerce/version', __FILE__)
+# stub: bigcommerce 0.9.0 ruby lib
 
 Gem::Specification.new do |s|
-  s.add_dependency('activesupport')
-  s.add_dependency('json')
-  s.add_dependency('rest-client')
-  if RUBY_VERSION >= '1.9'
-    s.add_development_dependency("coveralls")
-  end
-  s.add_development_dependency("ci_reporter")
-  s.add_development_dependency("mocha")
-  s.add_development_dependency("rake")
-  s.add_development_dependency("rspec", '~> 2.11')
-  s.add_development_dependency("vcr")
-  s.add_development_dependency("webmock", '1.9')
-  s.authors  = ["Mark Rickerby", "Rob Howard", "Saranyan Vigraham", "Sasha Gerrand"]
-  s.date     = Time.now.strftime("%Y-%m-%d")
+  s.name = "bigcommerce"
+  s.version = "0.10.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Mark Rickerby", "Rob Howard", "Saranyan Vigraham", "Sasha Gerrand"]
+  s.date = "2015-01-27"
   s.description = "Enables Ruby applications to communicate with the Bigcommerce API V2."
-  s.email    = ["mark.rickerby@bigcommerce.com",
-                "rob.howard@bigcommerce.com",
-                "saranyan.vigraham@bigcommerce.com",
-                "sasha.gerrand@bigcommerce.com"]
-  s.files = ["LICENSE", "Rakefile", "README.md", "bigcommerce.gemspec"] + Dir['./**/*.rb'] + Dir['./**/*.crt']
-  s.has_rdoc = false
+  s.license = 'MIT'
+  s.email = ["mark.rickerby@bigcommerce.com", "rob.howard@bigcommerce.com", "saranyan.vigraham@bigcommerce.com", "sasha.gerrand@bigcommerce.com"]
+  s.files = ["LICENSE", "Rakefile", "README.md", "bigcommerce.gemspec", "./lib/big_commerce.rb", "./lib/bigcommerce/api.rb", "./lib/bigcommerce/connection.rb", "./lib/bigcommerce/version.rb", "./lib/bigcommerce/resource.rb", "./lib/bigcommerce/product.rb", "./lib/bigcommerce.rb", "./spec/big_commerce_spec.rb", "./spec/integration/orders_spec.rb", "./spec/spec_helper.rb", "./spec/support/integration_context.rb", "./spec/support/mock_api_context.rb", "./spec/unit/api_request_spec.rb", "./spec/unit/api_spec.rb", "./spec/unit/connection_spec.rb", "./spec/unit/date_time_spec.rb", "./spec/unit/version_spec.rb", "spec/big_commerce_spec.rb", "spec/integration/orders_spec.rb", "spec/unit/api_request_spec.rb", "spec/unit/api_spec.rb", "spec/unit/connection_spec.rb", "spec/unit/date_time_spec.rb", "spec/unit/version_spec.rb"]
   s.homepage = "http://github.com/bigcommerce/bigcommerce-api-ruby"
-  s.name     = "bigcommerce"
-  s.summary  = "Enables Ruby applications to communicate with the Bigcommerce API"
-  s.test_files = Dir.glob('spec/**/*_spec.rb')
-  s.version  = Bigcommerce::VERSION
+  s.require_paths = ["lib"]
+  s.rubygems_version = "2.1.11"
+  s.summary = "Enables Ruby applications to communicate with the Bigcommerce API"
+  s.test_files = ["spec/big_commerce_spec.rb", "spec/integration/orders_spec.rb", "spec/unit/api_request_spec.rb", "spec/unit/api_spec.rb", "spec/unit/connection_spec.rb", "spec/unit/date_time_spec.rb", "spec/unit/version_spec.rb"]
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activesupport>, [">= 0"])
+      s.add_runtime_dependency(%q<json>, [">= 0"])
+      s.add_runtime_dependency(%q<rest-client>, [">= 0"])
+      s.add_development_dependency(%q<coveralls>, [">= 0"])
+      s.add_development_dependency(%q<ci_reporter_rspec>, [">= 0"])
+      s.add_development_dependency(%q<mocha>, [">= 0"])
+      s.add_development_dependency(%q<rake>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.11"])
+      s.add_development_dependency(%q<vcr>, [">= 0"])
+      s.add_development_dependency(%q<webmock>, ["= 1.9"])
+    else
+      s.add_dependency(%q<activesupport>, [">= 0"])
+      s.add_dependency(%q<json>, [">= 0"])
+      s.add_dependency(%q<rest-client>, [">= 0"])
+      s.add_dependency(%q<coveralls>, [">= 0"])
+      s.add_dependency(%q<ci_reporter_rspec>, [">= 0"])
+      s.add_dependency(%q<mocha>, [">= 0"])
+      s.add_dependency(%q<rake>, [">= 0"])
+      s.add_dependency(%q<rspec>, ["~> 2.11"])
+      s.add_dependency(%q<vcr>, [">= 0"])
+      s.add_dependency(%q<webmock>, ["= 1.9"])
+    end
+  else
+    s.add_dependency(%q<activesupport>, [">= 0"])
+    s.add_dependency(%q<json>, [">= 0"])
+    s.add_dependency(%q<rest-client>, [">= 0"])
+    s.add_dependency(%q<coveralls>, [">= 0"])
+    s.add_dependency(%q<ci_reporter_rspec>, [">= 0"])
+    s.add_dependency(%q<mocha>, [">= 0"])
+    s.add_dependency(%q<rake>, [">= 0"])
+    s.add_dependency(%q<rspec>, ["~> 2.11"])
+    s.add_dependency(%q<vcr>, [">= 0"])
+    s.add_dependency(%q<webmock>, ["= 1.9"])
+  end
 end

data/lib/bigcommerce.rb

@@ -5,3 +5,5 @@ require "uri"
 require 'bigcommerce/api'
 require 'bigcommerce/connection'
 require 'bigcommerce/version'
+require 'bigcommerce/resource'
+require 'bigcommerce/product'

data/lib/bigcommerce/api.rb

@@ -1,8 +1,11 @@
 require 'date'
+require 'ostruct'
 
 module Bigcommerce
   class Api
 
+    attr_reader :page
+
     def initialize(configuration={})
       @connection = Connection.new(configuration)
     end
@@ -35,19 +38,23 @@ module Bigcommerce
       datetime.strftime("%a, %d %b %Y %H:%M:%S %z")
     end
 
-    def get_time
+    def time
       @connection.get '/time'
     end
 
-    def get_brands(options={})
+    def store_information
+      @connection.get '/store'
+    end
+
+    def brands(options={})
       @connection.get("/brands", options)
     end
 
-    def get_brands_count
+    def brands_count
       @connection.get '/brands/count'
     end
 
-    def get_brand(id)
+    def brand(id)
       @connection.get("/brands/#{id}", {})
     end
 
@@ -63,7 +70,7 @@ module Bigcommerce
        @connection.delete("/brands/#{id}")
     end
 
-    def get_coupons(options={})
+    def coupons(options={})
       @connection.get("/coupons", options)
     end
 
@@ -75,15 +82,15 @@ module Bigcommerce
        @connection.put("/coupons/#{id}", options)
     end
 
-    def get_categories(options={})
+    def categories(options={})
        @connection.get("/categories", options)
     end
 
-    def get_categories_count
+    def categories_count
       @connection.get '/categories/count'
     end
 
-    def get_category(id)
+    def category(id)
       @connection.get("/categories/#{id}", {})
     end
 
@@ -99,47 +106,47 @@ module Bigcommerce
        @connection.delete("/categories/#{id}")
     end
 
-    def get_countries(options={})
+    def countries(options={})
       @connection.get("/countries", options)
     end
 
-    def get_country(id)
+    def country(id)
       @connection.get("/countries/#{id}", {})
     end
 
-    def get_countries_states(options={})
+    def countries_states(options={})
       @connection.get("/countries/states", options)
     end
 
-    def get_countries_state(id, options={})
+    def countries_state(id, options={})
       @connection.get("/countries/#{id}/states", {})
     end
 
-    def get_customers(options = {})
+    def customers(options = {})
       @connection.get("/customers", options)
     end
 
-    def get_customer(id)
+    def customer(id)
       @connection.get('/customers/' + id.to_s, {})
     end
 
-    def get_customer_addresses(id, options = {})
+    def customer_addresses(id, options = {})
       @connection.get("/customers/#{id}/addresses", options)
     end
 
-    def get_customer_address(customer_id, address_id)
+    def customer_address(customer_id, address_id)
       @connection.get("/customers/#{customer_id}/addresses/#{address_id}",{})
     end
 
-    def get_options(options={})
+    def options(options={})
        @connection.get("/options", options)
     end
 
-    def get_options_count
+    def options_count
        @connection.get '/options/count'
     end
 
-    def get_option(id)
+    def option(id)
       @connection.get("/options/#{id}",{})
     end
 
@@ -155,12 +162,12 @@ module Bigcommerce
       @connection.delete("/options/#{id}")
     end
 
-    def get_options_values(options={})
+    def options_values(options={})
        @connection.get("/options/values", options)
     end
 
-    def get_options_value(id)
-      @connection.get("/options/#{id}/values",{})
+    def options_value(id, options={})
+      @connection.get("/options/#{id}/values", options)
     end
 
     def create_options_values(options_id, options={})
@@ -169,17 +176,17 @@ module Bigcommerce
 
     def update_options_value(options_id, values_id, options={})
       @connection.put("/options/#{options_id}/values/#{values_id}", options)
-    end   
+    end
 
-    def get_optionsets(options={})
+    def optionsets(options={})
        @connection.get("/optionsets", options)
     end
 
-    def get_optionsets_count
+    def optionsets_count
        @connection.get '/optionsets/count'
     end
 
-    def get_optionset(id)
+    def optionset(id)
       @connection.get("/optionsets/#{id}", {})
     end
 
@@ -195,15 +202,15 @@ module Bigcommerce
       @connection.delete("/optionsets/#{id}")
     end
 
-    def get_optionsets_options(options={})
+    def optionsets_options(options={})
        @connection.get("/optionsets/options", options)
     end
 
-    def get_optionset_options(id)
+    def optionset_options(id)
       @connection.get("/optionsets/#{id}/options", {})
     end
 
-    def get_optionsets_option(id)
+    def optionsets_option(id)
       @connection.get("/optionsets/options/#{id}", {})
     end
 
@@ -215,90 +222,90 @@ module Bigcommerce
       @connection.put("/optionsets/#{optionset_id}/options/#{option_id}", options)
     end
 
-    def get_orders(options={})
+    def orders(options={})
       @connection.get("/orders", options)
     end
 
-    def get_orders_by_date(date, options={})
+    def orders_by_date(date, options={})
       if date.is_a?(String)
         date = DateTime.parse(date)
       end
       @connection.get('/orders', options.merge!(:min_date_created => to_rfc2822(date)))
     end
 
-    def get_orders_modified_since(date)
+    def orders_modified_since(date)
       @connection.get('/orders', {}, {'If-Modified-Since' => to_rfc2822(date)})
     end
 
-    def get_order(id)
-      @connection.get("/orders/#{id}", {})
+    def order(id,options={})
+      @connection.get("/orders/#{id}", options)
     end
 
     def update_order(id,options={})
       @connection.put("/orders/#{id}", options)
     end
 
-    def get_orders_coupons(id)
-      @connection.get("/orders/#{id}/coupons", {})
+    def orders_coupons(id,options={})
+      @connection.get("/orders/#{id}/coupons", options)
     end
 
-    def get_orders_coupon(order_id,coupon_id)
-      @connection.get("/orders/#{order_id}/coupons/#{coupon_id}", {})
+    def orders_coupon(order_id,coupon_id,options={})
+      @connection.get("/orders/#{order_id}/coupons/#{coupon_id}", options)
     end
 
-    def get_orders_products(id)
-      @connection.get("/orders/#{id}/products", {})
+    def orders_products(id,options={})
+      @connection.get("/orders/#{id}/products", options)
     end
 
-    def get_orders_product(order_id,product_id)
-      @connection.get("/orders/#{order_id}/products/#{product_id}", {})
+    def orders_product(order_id,product_id,options={})
+      @connection.get("/orders/#{order_id}/products/#{product_id}", options)
     end
 
-    def get_orders_shipments(id)
-      @connection.get("/orders/#{id}/shipments", {})
+    def orders_shipments(id,options={})
+      @connection.get("/orders/#{id}/shipments", options)
     end
 
-    def create_orders_shipments(id)
-      @connection.post("/orders/#{id}/shipments", {})
+    def create_orders_shipments(id, options={})
+      @connection.post("/orders/#{id}/shipments", options)
     end
 
-    def get_orders_shipment(order_id,shipment_id)
-      @connection.get("/orders/#{order_id}/shipments/#{shipment_id}", {})
+    def orders_shipment(order_id,shipment_id,options={})
+      @connection.get("/orders/#{order_id}/shipments/#{shipment_id}", options)
     end
 
     def update_orders_shipment(order_id,shipment_id,options={})
       @connection.put("/orders/#{order_id}/shipments/#{shipment_id}", options)
     end
 
-    def get_orders_shippingaddresses(id)
-      @connection.get("/orders/#{id}/shippingaddresses", {})
+    def orders_shippingaddresses(id,options={})
+      @connection.get("/orders/#{id}/shippingaddresses", options)
     end
 
-    def get_orders_shippingaddress(order_id,shippingaddress_id)
-      @connection.get("/orders/#{order_id}/shippingaddresses/#{shippingaddress_id}", {})
+    def orders_shippingaddress(order_id,shippingaddress_id,options={})
+      @connection.get("/orders/#{order_id}/shippingaddresses/#{shippingaddress_id}", options)
     end
 
-    def get_orderstatuses(options={})
+    def orderstatuses(options={})
       @connection.get("/orderstatuses", options)
     end
 
-    def get_orderstatus(id)
-      @connection.get("/orderstatuses/#{id}", {})
+    def orderstatus(id,options={})
+      @connection.get("/orderstatuses/#{id}", options)
     end
 
-    def get_products(options={})
+    def products(options={})
       @connection.get("/products", options)
     end
 
-    def get_products_count
+    def products_count
       @connection.get '/products/count'
     end
 
-    def get_product(id)
-      @connection.get("/products/#{id}", {})
+    def product(id,options={})
+      @connection.get("/products/#{id}", options)
     end
 
-     def create_products(options={})
+    def create_products(options={})
       @connection.post('/products', options)
     end
 
@@ -306,43 +313,63 @@ module Bigcommerce
       @connection.put("/products/#{id}", options)
     end
 
-    def get_products_discountrules(options={})
+    def delete_products(id)
+      @connection.delete("/products/#{id}")
+    end
+
+    def products_discountrules(options={})
       @connection.get("/products/discountrules", options)
     end
 
-    def get_product_discountrules(product_id, options={})
+    def product_discountrules(product_id, options={})
       @connection.get("/products/#{product_id}/discountrules", options)
     end
 
-    def get_products_discountrule(product_id, discountrule_id)
-      @connection.get("/products/#{product_id}/discountrules/#{discountrule_id}", {})
+    def products_discountrule(product_id, discountrule_id,options={})
+      @connection.get("/products/#{product_id}/discountrules/#{discountrule_id}", options)
     end
 
-    def get_products_configurablefields(options={})
+    def products_configurablefields(options={})
       @connection.get("/products/configurablefields", options)
     end
 
-    def get_product_configurablefields(product_id, options={})
+    def product_configurablefields(product_id, options={})
       @connection.get("/products/#{product_id}/configurablefields", options)
     end
 
-    def get_products_configurablefield(product_id, configurable_field_id)
-      @connection.get("/products/#{product_id}/configurablefields/#{configurable_field_id}", {})
+    def products_configurablefield(product_id, configurable_field_id, options={})
+      @connection.get("/products/#{product_id}/configurablefields/#{configurable_field_id}", options)
     end
 
-    def get_products_customfields(options={})
+    def products_customfields(options={})
       @connection.get("/products/customfields", options)
     end
 
-    def get_product_customfields(product_id, options={})
+    def product_customfields(product_id, options={})
       @connection.get("/products/#{product_id}/customfields", options)
     end
 
-    def get_products_customfield(product_id, custom_field_id)
-      @connection.get("/products/#{product_id}/customfields/#{custom_field_id}", {})
+    def create_product_customfield(product_id, options={})
+      @connection.post("/products/#{product_id}/customfields", options)
+    end
+
+    def update_product_customfield(product_id, custom_field_id, options={})
+      @connection.put("/products/#{product_id}/customfields/#{custom_field_id}", options)
     end
 
-    def get_product_images(product_id, options={})
+    def delete_product_customfield(product_id, custom_field_id)
+      @connection.delete("/products/#{product_id}/customfields/#{custom_field_id}")
+    end
+
+    def delete_product_customfields(product_id)
+      @connection.delete("/products/#{product_id}/customfields")
+    end
+
+    def products_customfield(product_id, custom_field_id, options={})
+      @connection.get("/products/#{product_id}/customfields/#{custom_field_id}", options)
+    end
+
+    def product_images(product_id, options={})
       @connection.get("/products/#{product_id}/images", options)
     end
 
@@ -350,39 +377,27 @@ module Bigcommerce
       @connection.post("/products/#{product_id}/images", options)
     end
 
-    def get_products_images(options={})
-      @connection.get("/products/images", options)
-    end
-
     def create_products_images(options={})
       @connection.post("/products/images", options)
     end
 
-    def get_products_image(product_id, image_id)
-      @connection.get("/products/#{product_id}/images/#{image_id}", {})
+    def products_image(product_id, image_id, options={})
+      @connection.get("/products/#{product_id}/images/#{image_id}", options)
     end
 
     def update_products_image(product_id,image_id,options={})
       @connection.put("/products/#{product_id}/images/#{image_id}", options)
     end
 
-    def get_products_customfields(options={})
-      @connection.get("/products/options", options)
-    end
-
-    def get_product_options(product_id, options={})
+    def product_options(product_id, options={})
       @connection.get("/products/#{product_id}/options", options)
     end
 
-    def get_products_option(product_id,option_id)
-      @connection.get("/products/#{product_id}/options/#{option_id}", {})
+    def products_option(product_id,option_id, options={})
+      @connection.get("/products/#{product_id}/options/#{option_id}", options)
     end
 
-    def get_products_rules(options={})
-      @connection.get("/products/rules", options)
-    end
-
-    def get_product_rules(product_id, options={})
+    def product_rules(product_id, options={})
       @connection.get("/products/#{product_id}/rules", options)
     end
 
@@ -390,19 +405,15 @@ module Bigcommerce
       @connection.post("/products/rules", options)
     end
 
-    def get_products_rule(product_id,rule_id)
-      @connection.get("/products/#{product_id}/rules/#{rule_id}", {})
+    def products_rule(product_id,rule_id,options={})
+      @connection.get("/products/#{product_id}/rules/#{rule_id}", options)
     end
 
     def update_products_rule(product_id, rule_id, options={})
       @connection.put("/products/#{product_id}/rules/#{rule_id}", options)
     end
 
-    def get_products_skus(options={})
-      @connection.get("/products/skus", options)
-    end
-
-    def get_product_skus(product_id, options={})
+    def product_skus(product_id, options={})
       @connection.get("/products/#{product_id}/skus", options)
     end
 
@@ -410,39 +421,53 @@ module Bigcommerce
       @connection.post("/products/skus", options)
     end
 
-    def get_products_sku(product_id, sku_id)
-      @connection.get("/products/#{product_id}/skus/#{sku_id}", {})
+    def products_sku(product_id, sku_id, options={})
+      @connection.get("/products/#{product_id}/skus/#{sku_id}", options)
     end
 
     def update_products_sku(product_id, sku_id, options={})
       @connection.put("/products/#{product_id}/skus/#{sku_id}", options)
     end
 
-    def get_products_videos(options={})
-      @connection.get("/products/videos", options)
-    end
-
-    def get_product_videos(product_id, options={})
+    def product_videos(product_id, options={})
       @connection.get("/products/#{product_id}/videos", options)
     end
 
-    def get_products_video(product_id, video_id)
-      @connection.get("/products/#{product_id}/videos/#{video_id}", {})
+    def products_video(product_id, video_id, options={})
+      @connection.get("/products/#{product_id}/videos/#{video_id}", options)
     end
 
-    private
-
-    def get_count(result)
+    def count(result)
       result["count"]
     end
 
-    def get_resource(result)
-      result
+    def collection(resource_path, options={})
+      if (options["resource_class"])
+        klass = options["resource_class"]
+      else
+        klass = Resource
+      end
+      Enumerator.new do |yielder|
+        count = -1
+        if options[:starting_page]
+          @page = options[:starting_page]
+        else
+          @page = 1
+        end
+        until count == 0
+          buffer = @connection.get(resource_path, {page: page})
+          count = buffer.count
+          buffer.each do |item|
+            yielder << klass.new(item, @connection)
+            p @connection.remaining_rate_limit
+          end
+          @page += 1
+        end
+      end
     end
 
-    def get_collection(result)
+    def resource(result)
       result
     end
-
   end
 end