Merge pull request #13 from button/chris/customers_api

Add Customers resouce to Rubygem

Author: chrismaddern

CHANGELOG.md

@@ -1,3 +1,6 @@
+2.1.0 March 29, 2017
+  - Add `Customers` resource
+
 2.0.0 January 6, 2017
   - Add `Accounts` resource
   - Add `Merchants` resource

README.md

@@ -80,6 +80,7 @@ The supported options are as follows:
 We currently expose the following resources to manage:
 
 * [`Accounts`](#accounts)
+* [`Customers`](#customers)
 * [`Merchants`](#merchants)
 * [`Orders`](#orders)
 
@@ -127,6 +128,24 @@ while !cursor.nil? do
 end
 ```
 
+### Customers
+
+##### Create
+
+```ruby
+require 'button'
+
+client = Button::Client.new('sk-XXX')
+
+response = client.customers.create({
+  id: 'internal-customer-id',
+  email_sha256: 'a665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae3'
+})
+
+puts response
+# => Button::Response(id: internal-customer-id, email_sha256: a665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae3)
+```
+
 ### Merchants
 
 ##### all

lib/button/client.rb

@@ -1,4 +1,5 @@
 require 'button/resources/accounts'
+require 'button/resources/customers'
 require 'button/resources/merchants'
 require 'button/resources/orders'
 require 'button/errors'
@@ -26,6 +27,7 @@ def initialize(api_key, config = {})
       config_with_defaults = merge_defaults(config)
 
       @accounts = Accounts.new(api_key, config_with_defaults)
+      @customers = Customers.new(api_key, config_with_defaults)
       @merchants = Merchants.new(api_key, config_with_defaults)
       @orders = Orders.new(api_key, config_with_defaults)
     end
@@ -41,7 +43,7 @@ def merge_defaults(config)
       }
     end
 
-    attr_reader :accounts, :merchants, :orders
+    attr_reader :accounts, :customers, :merchants, :orders
     private :merge_defaults
   end
 end

lib/button/resources/customers.rb

@@ -0,0 +1,21 @@
+require 'button/resources/resource'
+
+module Button
+  # https://www.usebutton.com/developers/api-reference/
+  #
+  class Customers < Resource
+    def path(customer_id = nil)
+      return "/v1/customers/#{customer_id}" if customer_id
+      '/v1/customers'
+    end
+
+    # Create a Customer
+    #
+    # @param [Hash] customer the customer to create
+    # @return [Button::Response] the API response
+    #
+    def create(customer)
+      api_post(path, customer)
+    end
+  end
+end

lib/button/version.rb

@@ -1,3 +1,3 @@
 module Button
-  VERSION = '2.0.0'.freeze
+  VERSION = '2.1.0'.freeze
 end

test/button/resources/customers_test.rb

@@ -0,0 +1,31 @@
+require File.expand_path('../../../test_helper', __FILE__)
+
+class CustomersTest < Test::Unit::TestCase
+  def setup
+    @customers = Button::Customers.new(
+      'sk-XXX',
+      secure: true,
+      timeout: nil,
+      hostname: 'api.usebutton.com',
+      port: 443
+    )
+
+    @headers = {
+      'Authorization' => 'Basic c2stWFhYOg==',
+      'User-Agent' => Button::Resource::USER_AGENT
+    }
+  end
+
+  def teardown
+    WebMock.reset!
+  end
+
+  def test_create
+    stub_request(:post, 'https://api.usebutton.com/v1/customers')
+      .with(body: '{"id":"1234"}', headers: @headers)
+      .to_return(status: 200, body: '{ "meta": { "status": "ok" }, "object": { "id": "1234" } }')
+
+    response = @customers.create(id: '1234')
+    assert_equal(response.data[:id], '1234')
+  end
+end