gocardless-pro 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2e33f63f8abea3896aec595f634b37a52562fbcd
+  data.tar.gz: 6f124e195e6d05ba7133971f8d5d9a1412292d32
+SHA512:
+  metadata.gz: f866986ee59d10a38c4ab3299886e32bf99c17b0464a4cca7a5be7bb8184b6d97f5efd23f972cf5409e970fe7bbe42ad5e285ec3247f74b44674ec573ba3b705
+  data.tar.gz: efa3c4880e5d1e713d74174a8c0e703717b711a08bfdd07822cb781b7ccf408293309be9628a2de3745a0cfa78fa5dab4b7f5d8c798e2980310bff113b9ae84a

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 GoCardless
+
+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,132 @@
+# Client for GoCardless Enterprise API
+
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'gocardless-pro'
+```
+
+## Usage Examples
+
+- In the case of a single response, the client will return you an instance of the resource
+- In the case of list responses, the client will return an instance of `ListResponse`, which is enumerable.
+- You can also call `#all` to get a lazily paginated list of resource that will deal with making extra API requests to paginate through all the data
+
+### Initialising the client
+
+The client is initialised with the API Key ID and the API Key `key` property.
+
+You can also pass in `environment` as `:sandbox` to make requests to the sandbox environment rather than the live one.
+
+```rb
+@client = GoCardless::Client.new(
+  api_key: ENV["GOCARDLESS_API_ID"],
+  api_secret: ENV["GOCARDLESS_API_KEY"]
+)
+```
+
+### GET requests
+
+You can make a request to get a list of resources using the `list` method:
+
+```rb
+@client.customers.list
+```
+
+This README will use `customers` throughout but each of the resources in the API is available in this library. They are defined in [`gocardless.rb`](https://github.com/gocardless/pro-client-ruby/blob/master/lib/gocardless.rb#L87).
+
+If you need to pass any options, the last (or in the absence of URL params, the only) argument is an options hash. This is used to pass query parameters for `GET` requests:
+
+```rb
+@client.customers.list(limit: 400)
+```
+
+A call to `list` returns an instance of `GoCardless::ListResponse`. This is a enumerable which lets you iterate over every item returned:
+
+```rb
+@client.customers.list do |customer|
+  p customer.given_name
+end
+```
+
+In the case where a url parameter is needed, the method signature will contain required arguments:
+
+```rb
+@client.customers.get(customers_id)
+```
+
+As with list, the last argument can be an options hash:
+
+```rb
+@client.customers.get(customers_id, limit: 200)
+```
+
+### POST/PUT Requests
+
+For POST and PUT requests you need to pass in the body in as the last argument.
+
+```rb
+@client.customers.create(
+  first_name: "Pete",
+  last_name: "Hamilton",
+  ...
+)
+```
+
+As with GET requests, if any parameters are required they come first:
+
+```rb
+@client.customers.update(customer_id, {...})
+```
+
+### Custom Headers
+
+If you need to pass in a custom header to an endpoint, you can pass in a separate hash as the last argument:
+
+```rb
+@client.helpers.mandate({
+  account_number: 200000,
+  ...
+}, {
+  'Accept': 'application/pdf'
+})
+```
+
+There are very few endpoints in the API that require custom headers. Currently, the only ones that do are [helpers](https://developer.gocardless.com/pro/#api-endpoints-helpers).
+
+### Handling failures
+
+When an API returns an error, the client __will raise__ an error that corresponds to the type of error. All errors subclass `GoCardless::Error`. There are four errors that could be thrown:
+
+- `GoCardless::GoCardlessError`
+- `GoCardless::InvalidApiUsageError`
+- `GoCardless::InvalidStateError`
+- `GoCardless::ValidationError`
+
+These errors are fully documented in the [API documentation](https://developer.gocardless.com/pro/#overview-errors).
+
+The error has the following methods to allow you to access the information from the API response:
+
+- `#documentation_url`
+- `#message`
+- `#type`
+- `#code`
+- `#request_id`
+- `#errors`
+
+## Supporting Ruby < 2.0.0
+The client only supports Ruby >= 2.0.0 out of the box due to our use of
+Enumerable::Lazy for lazy loading of paginated API resources.
+
+However, support for previous ruby versions can be added using a gem such as
+[backports](https://github.com/marcandre/backports).
+
+1. Add backports to your Gemfile
+   ```gem 'backports'```
+2. Require lazy enumerables
+   ```require 'backports/2.0.0/enumerable/lazy.rb'```
+
+## Contributing
+
+This client is auto-generated from Crank, a toolchain that we hope to soon open source. Issues should for now be reported on this repository. __Please do not modify the source code yourself, your changes will be overriden!__

data/circle.yml

@@ -0,0 +1,18 @@
+machine:
+  ruby:
+    version: 2.0.0-p353
+
+deployment:
+  git:
+    branch: master
+    commands:
+      - bundle exec yard doc
+      - git config user.name "Circle CI"
+      - git config user.email "robot+circleci@gocardless.com"
+      - git checkout gh-pages
+      - rm -r css GoCardless js
+      - mv doc/* .
+      - touch .nojekyll
+      - git add .
+      - git commit -m "[ci skip] Generate Yard Doc"
+      - git push origin gh-pages

data/demo.rb

@@ -0,0 +1,10 @@
+ require_relative 'lib/gocardless'
+
+@client = GoCardless::Client.new(
+  api_key: ENV["GOCARDLESS_KEY"],
+  api_secret: ENV["GOCARDLESS_TOKEN"],
+  environment: :sandbox
+)
+
+puts "Your first customer:"
+puts "-> #{@client.customers.list.first.inspect}"

data/gocardless-pro.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'gocardless-pro/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "gocardless-pro"
+  spec.version       = GoCardless::VERSION
+  spec.authors       = %w(GoCardless)
+  spec.email         = %w(engineering@gocardless.com)
+  spec.summary       = %q{A gem for calling the GoCardless Pro API}
+  spec.homepage      = "https://developer.gocardless.com/pro"
+  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_development_dependency 'rspec', '~> 3.1'
+  spec.add_development_dependency 'webmock', '~> 1.18'
+  spec.add_development_dependency 'rubocop', '~> 0.30.0'
+  spec.add_development_dependency 'yard', '~> 0.8.7.6'
+
+  spec.add_dependency 'faraday', '~> 0.8.9'
+  spec.add_dependency 'activesupport', '~> 4.1'
+end

data/lib/gocardless-pro.rb

@@ -0,0 +1,243 @@
+# encoding: utf-8
+#
+# WARNING: Do not edit by hand, this file was generated by Crank:
+#
+#   https://github.com/gocardless/crank
+#
+
+require 'json'
+require 'zlib'
+require 'active_support/inflector'
+require 'faraday'
+require 'time'
+require 'active_support/core_ext/hash/indifferent_access'
+
+require 'uri'
+
+module GoCardless
+end
+
+version_file = 'gocardless-pro/version'
+
+if File.file? File.expand_path("#{version_file}.rb", File.dirname(__FILE__))
+  require_relative version_file
+else
+  GoCardless::VERSION = ''
+end
+
+require_relative 'gocardless-pro/api_service'
+require_relative 'gocardless-pro/list_response'
+require_relative 'gocardless-pro/error'
+require_relative 'gocardless-pro/error/validation_error'
+require_relative 'gocardless-pro/error/gocardless_error'
+require_relative 'gocardless-pro/error/invalid_api_usage_error'
+require_relative 'gocardless-pro/error/invalid_state_error'
+require_relative 'gocardless-pro/paginator'
+require_relative 'gocardless-pro/request'
+require_relative 'gocardless-pro/response'
+
+require_relative 'gocardless-pro/resources/api_key'
+require_relative 'gocardless-pro/services/api_key_service'
+
+require_relative 'gocardless-pro/resources/creditor'
+require_relative 'gocardless-pro/services/creditor_service'
+
+require_relative 'gocardless-pro/resources/creditor_bank_account'
+require_relative 'gocardless-pro/services/creditor_bank_account_service'
+
+require_relative 'gocardless-pro/resources/customer'
+require_relative 'gocardless-pro/services/customer_service'
+
+require_relative 'gocardless-pro/resources/customer_bank_account'
+require_relative 'gocardless-pro/services/customer_bank_account_service'
+
+require_relative 'gocardless-pro/resources/event'
+require_relative 'gocardless-pro/services/event_service'
+
+require_relative 'gocardless-pro/resources/helper'
+require_relative 'gocardless-pro/services/helper_service'
+
+require_relative 'gocardless-pro/resources/mandate'
+require_relative 'gocardless-pro/services/mandate_service'
+
+require_relative 'gocardless-pro/resources/payment'
+require_relative 'gocardless-pro/services/payment_service'
+
+require_relative 'gocardless-pro/resources/payout'
+require_relative 'gocardless-pro/services/payout_service'
+
+require_relative 'gocardless-pro/resources/publishable_api_key'
+require_relative 'gocardless-pro/services/publishable_api_key_service'
+
+require_relative 'gocardless-pro/resources/redirect_flow'
+require_relative 'gocardless-pro/services/redirect_flow_service'
+
+require_relative 'gocardless-pro/resources/refund'
+require_relative 'gocardless-pro/services/refund_service'
+
+require_relative 'gocardless-pro/resources/role'
+require_relative 'gocardless-pro/services/role_service'
+
+require_relative 'gocardless-pro/resources/subscription'
+require_relative 'gocardless-pro/services/subscription_service'
+
+require_relative 'gocardless-pro/resources/user'
+require_relative 'gocardless-pro/services/user_service'
+
+module GoCardless
+  # A class for working with and talking to the GoCardless API
+  class Client
+    extend Forwardable
+
+    # Access to the service for api_key to make API calls
+    def api_keys
+      @api_keys ||= Services::ApiKeyService.new(@api_service)
+    end
+
+    # Access to the service for creditor to make API calls
+    def creditors
+      @creditors ||= Services::CreditorService.new(@api_service)
+    end
+
+    # Access to the service for creditor_bank_account to make API calls
+    def creditor_bank_accounts
+      @creditor_bank_accounts ||= Services::CreditorBankAccountService.new(@api_service)
+    end
+
+    # Access to the service for customer to make API calls
+    def customers
+      @customers ||= Services::CustomerService.new(@api_service)
+    end
+
+    # Access to the service for customer_bank_account to make API calls
+    def customer_bank_accounts
+      @customer_bank_accounts ||= Services::CustomerBankAccountService.new(@api_service)
+    end
+
+    # Access to the service for event to make API calls
+    def events
+      @events ||= Services::EventService.new(@api_service)
+    end
+
+    # Access to the service for helper to make API calls
+    def helpers
+      @helpers ||= Services::HelperService.new(@api_service)
+    end
+
+    # Access to the service for mandate to make API calls
+    def mandates
+      @mandates ||= Services::MandateService.new(@api_service)
+    end
+
+    # Access to the service for payment to make API calls
+    def payments
+      @payments ||= Services::PaymentService.new(@api_service)
+    end
+
+    # Access to the service for payout to make API calls
+    def payouts
+      @payouts ||= Services::PayoutService.new(@api_service)
+    end
+
+    # Access to the service for publishable_api_key to make API calls
+    def publishable_api_keys
+      @publishable_api_keys ||= Services::PublishableApiKeyService.new(@api_service)
+    end
+
+    # Access to the service for redirect_flow to make API calls
+    def redirect_flows
+      @redirect_flows ||= Services::RedirectFlowService.new(@api_service)
+    end
+
+    # Access to the service for refund to make API calls
+    def refunds
+      @refunds ||= Services::RefundService.new(@api_service)
+    end
+
+    # Access to the service for role to make API calls
+    def roles
+      @roles ||= Services::RoleService.new(@api_service)
+    end
+
+    # Access to the service for subscription to make API calls
+    def subscriptions
+      @subscriptions ||= Services::SubscriptionService.new(@api_service)
+    end
+
+    # Access to the service for user to make API calls
+    def users
+      @users ||= Services::UserService.new(@api_service)
+    end
+
+    # Get a Client configured to use HTTP Basic authentication with the GC Api
+    #
+    # @param options [Hash<Symbol,String>] configuration for creating the client
+    # @option options [Symbol] :environment the environment to connect to - one of `:live` or `:sandbox`.
+    # @option options [Symbol] :api_key the ID of the API Key
+    # @option options [Symbol] :api_secret the key of the API Key
+    # @option options [Symbol] :url the full URL used to make requests to. If you specify this, it will be used over the `environment` option.
+    # @return [Client] A client configured to use the API with HTTP Basic
+    #   authentication.
+    #
+    def initialize(options)
+      api_key = options.delete(:api_key) || fail('No API key ID given to GoCardless Client')
+      api_secret = options.delete(:api_secret) || fail('No API secret given to GoCardless Client')
+      environment = options.delete(:environment) || :live
+      url = options.delete(:url) || url_for_environment(environment)
+      options = custom_options(options)
+      @api_service = ApiService.new(url, api_key, api_secret, options)
+    end
+
+    private
+
+    def url_for_environment(environment)
+      if environment === :live
+        'https://api.gocardless.com'
+      elsif environment === :sandbox
+        'https://api-sandbox.gocardless.com'
+      else
+        fail "Unknown environment key: #{environment}"
+      end
+    end
+
+    # Get customized options.
+    def custom_options(options)
+      return default_options if options.nil?
+
+      return default_options.merge(options) unless options[:default_headers]
+
+      opts = default_options.merge(options)
+      opts[:default_headers] = default_options[:default_headers].merge(options[:default_headers])
+
+      opts
+    end
+
+    # Get the default options.
+    def default_options
+      {
+        default_headers: {
+          'GoCardless-Version' => '2014-11-03',
+          'User-Agent' => "#{user_agent}",
+          'Content-Type' => 'application/json'
+        }
+      }
+    end
+
+    def user_agent
+      @user_agent ||=
+        begin
+          gem_name = 'gocardless-pro'
+          gem_info = "#{gem_name}"
+          gem_info += "/v#{ GoCardless::VERSION}" if defined?(GoCardless::VERSION)
+          ruby_engine = defined?(RUBY_ENGINE) ? RUBY_ENGINE : 'ruby'
+          ruby_version = RUBY_VERSION
+          ruby_version += " p#{RUBY_PATCHLEVEL}" if defined?(RUBY_PATCHLEVEL)
+          comment = ["#{ruby_engine} #{ruby_version}"]
+          comment << "gocardless-pro v#{ GoCardless::VERSION}"
+          comment << "faraday v#{Faraday::VERSION}"
+          comment << RUBY_PLATFORM if defined?(RUBY_PLATFORM)
+          "#{gem_info} (#{comment.join('; ')})"
+        end
+    end
+  end
+end