confrater 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a657e0b6f40bcefaa6e75445c188f3d58219958248dc01ce7aed33db8524524e
+  data.tar.gz: 01cdb26c479da1ad3c89f5b8f4f8a64a466e8810760884cd43b41084dbee3ed2
+SHA512:
+  metadata.gz: 106feff91b10bc8a688178cfb4bd0a8837602b073b4d2014c0155689270bf57f1218e31443220d51b1306f04db2a55d7c2fed02e9abfd7dda40711f932992090
+  data.tar.gz: d86f4dce95ec98cc07e9224c6ad7b29d4b0b990af89f50d498e976b9fb2133db1ea2da03812777a9780cc53ca484b6ab9e8d454f74367066e3b128854dd12f18

data/.gitignore

@@ -0,0 +1,49 @@
+# rcov generated
+coverage
+
+# rdoc generated
+rdoc
+
+# yard generated
+doc
+.yardoc
+
+# bundler
+.bundle
+
+# jeweler generated
+pkg
+
+# Have editor/IDE/OS specific files you need to ignore? Consider using a global gitignore: 
+#
+# * Create a file at ~/.gitignore
+# * Include files you want ignored
+# * Run: git config --global core.excludesfile ~/.gitignore
+#
+# After doing this, these files will be ignored in all your git projects,
+# saving you from having to 'pollute' every project you touch with them
+#
+# Not sure what to needs to be ignored for particular editors/OSes? Here's some ideas to get you started. (Remember, remove the leading # of the line)
+#
+# For MacOS:
+#
+.DS_Store
+#
+# For TextMate
+#*.tmproj
+#tmtags
+#
+# For emacs:
+#*~
+#\#*
+#.\#*
+#
+# For vim:
+#*.swp
+
+bin
+cache
+gems
+specifications
+Gemfile.lock
+.rvmrc

data/Gemfile

@@ -0,0 +1,8 @@
+source "https://rubygems.org"
+
+platforms :rbx do
+  gem 'rubysl'
+  gem 'rubinius-developer_tools'
+end
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2010-2017 Espen Antonsen and Amro Mousa
+
+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.markdown

@@ -0,0 +1,191 @@
+# Confrere Ruby API Wrapper
+
+Confrere is an API wrapper for the [Confrere API](https://developer.confrere.com/).
+
+## Important Notes
+
+Confrere returns a `Confrere::Response` instead of the response body directly. `Confrere::Response` exposes the parsed response `body` and `headers`.
+
+## Installation
+
+    $ gem install confrere
+
+## Authentication
+
+The Confrere API authenticates using username and password which you can retrieve from your Confrere account.
+
+## Usage
+
+First, create a *one-time use instance* of `Confrere::Request`:
+
+```ruby
+confrere = Confrere::Request.new(username: "your client id", password: "your secret")
+```
+
+***Note*** Only reuse instances of Confrere after terminating a call with a verb, which makes a request. Requests are light weight objects that update an internal path based on your call chain. When you terminate a call chain with a verb, a request instance makes a request and resets the path.
+
+You can set an individual request's `timeout` and `open_timeout` like this:
+
+```ruby
+confrere.timeout = 30
+confrere.open_timeout = 30
+```
+
+You can read about `timeout` and `open_timeout` in the [Net::HTTP](https://ruby-doc.org/stdlib-2.3.3/libdoc/net/http/rdoc/Net/HTTP.html) doc.
+
+Now you can make requests using the resources defined in [the Confrere's docs](https://developer.confrere.com/reference). Resource IDs
+are specified inline and a `CRUD` (`create`, `retrieve`, `update`, or `delete`) verb initiates the request.
+
+You can specify `headers`, `params`, and `body` when calling a `CRUD` method. For example:
+
+```ruby
+confrere.customers.retrieve(headers: {"SomeHeader": "SomeHeaderValue"}, params: {"query_param": "query_param_value"})
+```
+
+Of course, `body` is only supported on `create` and `update` calls. Those map to HTTP `POST` and `PUT` verbs respectively.
+
+You can set `username`, `password`, `api_endpoint`, `timeout`, `open_timeout`, `faraday_adapter`, `proxy`, `symbolize_keys`, `logger`, and `debug` globally:
+
+```ruby
+Confrere::Request.username = "your_client_id"
+Confrere::Request.password = "your_secret"
+Confrere::Request.timeout = 15
+Confrere::Request.open_timeout = 15
+Confrere::Request.symbolize_keys = true
+Confrere::Request.debug = false
+```
+
+For example, you could set the values above in an `initializer` file in your `Rails` app (e.g. your\_app/config/initializers/confrere.rb).
+
+Assuming you've set the credentials on Confrere, you can conveniently make API calls on the class itself:
+
+```ruby
+Confrere::Request.customers.retrieve
+```
+
+***Note*** Substitute an underscore if a resource name contains a hyphen.
+
+Pass `symbolize_keys: true` to use symbols (instead of strings) as hash keys in API responses.
+
+```ruby
+confrere = Confrere::Request.new(username: "your_client_id", password: "your_secret", symbolize_keys: true)
+```
+
+Confrere's [API documentation](https://developer.confrere.com/reference) is a list of available endpoints.
+
+## Debug Logging
+
+Pass `debug: true` to enable debug logging to STDOUT.
+
+```ruby
+confrere = Confrere::Request.new(username: "your_client_id", password: "your_secret", debug: true)
+```
+
+### Custom logger
+
+Ruby `Logger.new` is used by default, but it can be overrided using:
+
+```ruby
+confrere = Confrere::Request.new(username: "your_client_id", password: "your_secret", debug: true, logger: MyLogger.new)
+```
+
+Logger can be also set by globally:
+
+```ruby
+Confrere::Request.logger = MyLogger.new
+```
+
+## Examples
+
+### Customers
+
+Fetch all customers:
+
+```ruby
+confrere.customers.retrieve
+```
+
+By default the Confrere API returns 50 results. To set the count to 50:
+
+```ruby
+confrere.customers.retrieve(params: {"pagesize": "100"})
+```
+
+And to retrieve the next 50 customers:
+
+```ruby
+confrere.customers.retrieve(params: {"pagesize": "100", "page": "2"})
+```
+
+Query using filters:
+
+```ruby
+confrere.customers.retrieve(params: {"filter": "contains(Name, ‘MakePlans’)"})
+```
+
+Retrieving a specific customer looks like:
+
+```ruby
+confrere.customers(customer_id).retrieve
+```
+
+Add a new customer:
+
+```ruby
+confrere.customers.create(body: {"Name": "MakePlans AS"})
+```
+
+### Fields
+
+Only retrieve ids and names for fetched customers:
+
+```ruby
+confrere.customers.retrieve(params: {"select": "Id, Name"})
+```
+
+### Error handling
+
+Confrere raises an error when the API returns an error.
+
+`Confrere::ConfrereError` has the following attributes: `title`, `detail`, `body`, `raw_body`, `status_code`. Some or all of these may not be
+available depending on the nature of the error. For example:
+
+```ruby
+begin
+  confrere.customers.create(body: body)
+rescue Confrere::ConfrereError => e
+  puts "Houston, we have a problem: #{e.message} - #{e.raw_body}"
+end
+```
+
+### Other
+
+You can set an optional proxy url like this (or with an environment variable CONFRERE_PROXY):
+
+```ruby
+confrere.proxy = 'http://your_proxy.com:80'
+```
+
+You can set a different [Faraday adapter](https://github.com/lostisland/faraday) during initialization:
+
+```ruby
+confrere = Confrere::Request.new(username: "your_client_id", password: "your_secret", faraday_adapter: :net_http)
+```
+
+#### Initialization
+
+```ruby
+confrere = Confrere::Request.new(username: "your_client_id", password: "your_secret")
+```
+
+## Thanks
+
+Thanks to everyone who has [contributed](https://github.com/espen/confrere/contributors) to Confrere's development.
+
+## Credits
+
+Based on [Gibbon](https://github.com/amro/gibbon) by [Amro Mousa](https://github.com/amro).
+
+## Copyright
+
+* Copyright (c) 2010-2017 Espen Antonsen and Amro Mousa. See LICENSE.txt for details.

data/Rakefile

@@ -0,0 +1,11 @@
+require 'rubygems'
+require 'rspec/core/rake_task'
+require 'rubygems/specification'
+require 'bundler/gem_tasks'
+
+task :default => :spec
+desc "Run specs"
+RSpec::Core::RakeTask.new do |t|
+  t.pattern = FileList['spec/**/*_spec.rb']
+  t.rspec_opts = %w(-fd --color)
+end

data/confrere.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require 'confrere/version'
+
+Gem::Specification.new do |s|
+  s.name        = "confrater"
+  s.version     = Confrere::VERSION
+  s.authors     = ["Espen Antonsen", "Amro Mousa"]
+  s.homepage    = "http://github.com/espen/confrere"
+
+  s.summary     = %q{A wrapper for Confrere API}
+  s.description = %q{A wrapper for Confrere API}
+  s.license     = "MIT"
+
+  s.rubyforge_project = "confrere"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  s.required_ruby_version = '>= 2.0.0'
+
+  s.add_dependency('faraday')
+  s.add_dependency('multi_json')
+
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'webmock'
+
+end

data/lib/confrere.rb

@@ -0,0 +1,13 @@
+require 'faraday'
+require 'multi_json'
+require 'cgi'
+require 'logger'
+
+require 'confrere/confrere_error'
+require 'confrere/api_error'
+require 'confrere/request'
+require 'confrere/api_request'
+require 'confrere/response'
+
+module Confrere
+end

data/lib/confrere/api_error.rb

@@ -0,0 +1,29 @@
+module Confrere
+  class APIError < StandardError
+    attr_reader :title, :detail, :body, :raw_body, :status_code
+
+    def initialize(message = "", params = {})
+      @title       = params[:title]
+      @detail      = params[:detail]
+      @body        = params[:body]
+      @raw_body    = params[:raw_body]
+      @status_code = params[:status_code]
+
+      super(message)
+    end
+
+    def to_s
+      super + " " + instance_variables_to_s
+    end
+
+    private
+
+    def instance_variables_to_s
+      [:title, :detail, :body, :raw_body, :status_code].map do |attr|
+        attr_value = send(attr)
+
+        "@#{attr}=#{attr_value.inspect}"
+      end.join(", ")
+    end
+  end
+end

data/lib/confrere/api_request.rb

@@ -0,0 +1,204 @@
+module Confrere
+  class APIRequest
+
+    def initialize(builder: nil)
+      @request_builder = builder
+    end
+
+    def post(params: nil, headers: nil, body: nil)
+      ensure_credentials
+
+      begin
+        response = self.rest_client.post do |request|
+          configure_request(request: request, params: params, headers: headers, body: MultiJson.dump(body))
+        end
+        parse_response(response)
+      rescue => e
+        handle_error(e)
+      end
+    end
+
+    def patch(params: nil, headers: nil, body: nil)
+      ensure_credentials
+
+      begin
+        response = self.rest_client.patch do |request|
+          configure_request(request: request, params: params, headers: headers, body: MultiJson.dump(body))
+        end
+        parse_response(response)
+      rescue => e
+        handle_error(e)
+      end
+    end
+
+    def put(params: nil, headers: nil, body: nil)
+      ensure_credentials
+
+      begin
+        response = self.rest_client.put do |request|
+          configure_request(request: request, params: params, headers: headers, body: MultiJson.dump(body))
+        end
+        parse_response(response)
+      rescue => e
+        handle_error(e)
+      end
+    end
+
+    def get(params: nil, headers: nil)
+      ensure_credentials
+
+      begin
+        response = self.rest_client.get do |request|
+          configure_request(request: request, params: params, headers: headers)
+        end
+        parse_response(response)
+      rescue => e
+        handle_error(e)
+      end
+    end
+
+    def delete(params: nil, headers: nil)
+      ensure_credentials
+
+      begin
+        response = self.rest_client.delete do |request|
+          configure_request(request: request, params: params, headers: headers)
+        end
+        parse_response(response)
+      rescue => e
+        handle_error(e)
+      end
+    end
+
+    protected
+
+    # Convenience accessors
+
+    def username
+      @request_builder.username
+    end
+
+    def password
+      @request_builder.password
+    end
+
+    def api_endpoint
+      @request_builder.api_endpoint
+    end
+
+    def api_environment
+      @request_builder.api_environment
+    end
+
+    def timeout
+      @request_builder.timeout
+    end
+
+    def open_timeout
+      @request_builder.open_timeout
+    end
+
+    def proxy
+      @request_builder.proxy
+    end
+
+    def adapter
+      @request_builder.faraday_adapter
+    end
+
+    def symbolize_keys
+      @request_builder.symbolize_keys
+    end
+
+    # Helpers
+
+    def handle_error(error)
+      error_params = {}
+
+      begin
+        if error.is_a?(Faraday::Error::ClientError) && error.response
+          error_params[:status_code] = error.response[:status]
+          error_params[:raw_body] = error.response[:body]
+
+          parsed_response = MultiJson.load(error.response[:body], symbolize_keys: symbolize_keys)
+
+          if parsed_response
+            error_params[:body] = parsed_response
+
+            title_key = symbolize_keys ? :title : "title"
+            detail_key = symbolize_keys ? :detail : "detail"
+
+            error_params[:title] = parsed_response[title_key] if parsed_response[title_key]
+            error_params[:detail] = parsed_response[detail_key] if parsed_response[detail_key]
+          end
+
+        end
+      rescue MultiJson::ParseError
+      end
+
+      error_to_raise = APIError.new(error.message, error_params)
+
+      raise error_to_raise
+    end
+
+    def configure_request(request: nil, params: nil, headers: nil, body: nil)
+      if request
+        request.params.merge!(params) if params
+        request.headers['Content-Type'] = 'application/json'
+        request.headers.merge!(headers) if headers
+        request.body = body if body
+        request.options.timeout = self.timeout
+        request.options.open_timeout = self.open_timeout
+      end
+    end
+
+    def rest_client
+      client = Faraday.new(self.api_url, proxy: self.proxy, ssl: { version: "TLSv1_2" }) do |faraday|
+        faraday.response :raise_error
+        faraday.adapter adapter
+        if @request_builder.debug
+          faraday.response :logger, @request_builder.logger, bodies: true
+        end
+      end
+      client.basic_auth self.username, self.password
+      client
+    end
+
+    def parse_response(response)
+      parsed_response = nil
+
+      if response.body && !response.body.empty?
+        begin
+          headers = response.headers
+          body = MultiJson.load(response.body, symbolize_keys: symbolize_keys)
+          parsed_response = Response.new(headers: headers, body: body)
+        rescue MultiJson::ParseError
+          error_params = { title: "UNPARSEABLE_RESPONSE", status_code: 500 }
+          error = APIError.new("Unparseable response: #{response.body}", error_params)
+          raise error
+        end
+      end
+
+      parsed_response
+    end
+
+    def ensure_credentials
+      username = self.username
+      password = self.password
+      unless username && password
+        raise Confrere::ConfrereError, "You must set credentials prior to making a call"
+      end
+    end
+
+    def api_url
+      base_api_url + @request_builder.path
+    end
+
+    def base_api_url
+      case @request_builder.api_environment
+      when :production
+        "https://api.confrere.com/v1/"
+      end
+    end
+  end
+end

data/lib/confrere/confrere_error.rb

@@ -0,0 +1,3 @@
+module Confrere
+  class ConfrereError < StandardError; end
+end

data/lib/confrere/request.rb

@@ -0,0 +1,90 @@
+module Confrere
+  class Request
+    attr_accessor :username, :password, :api_environment, :api_endpoint, :timeout, :open_timeout, :proxy, :faraday_adapter, :symbolize_keys, :debug, :logger
+
+    DEFAULT_TIMEOUT = 60
+    DEFAULT_OPEN_TIMEOUT = 60
+    DEFAULT_API_ENVIRONMENT = :production
+
+    def initialize(username: nil, password: nil, api_environment: nil, api_endpoint: nil, timeout: nil, open_timeout: nil, proxy: nil, faraday_adapter: nil, symbolize_keys: false, debug: false, logger: nil)
+      @path_parts = []
+      @username = username || self.class.username
+      @password = password || self.class.password
+      @api_environment = api_environment || self.class.api_environment || DEFAULT_API_ENVIRONMENT
+      @api_endpoint = api_endpoint || self.class.api_endpoint
+      @timeout = timeout || self.class.timeout || DEFAULT_TIMEOUT
+      @open_timeout = open_timeout || self.class.open_timeout || DEFAULT_OPEN_TIMEOUT
+      @proxy = proxy || self.class.proxy || ENV['CONFRERE_PROXY_URL']
+      @faraday_adapter = faraday_adapter || Faraday.default_adapter
+      @symbolize_keys = symbolize_keys || self.class.symbolize_keys || false
+      @debug = debug || self.class.debug || false
+      @logger = logger || self.class.logger || ::Logger.new(STDOUT)
+    end
+
+    def method_missing(method, *args)
+      # To support underscores, we replace them with hyphens when calling the API
+      @path_parts << method.to_s.gsub("_", "-").downcase
+      @path_parts << args if args.length > 0
+      @path_parts.flatten!
+      self
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      true
+    end
+
+    def send(*args)
+      if args.length == 0
+        method_missing(:send, args)
+      else
+        __send__(*args)
+      end
+    end
+
+    def path
+      @path_parts.join('/')
+    end
+
+    def create(params: nil, headers: nil, body: nil)
+      APIRequest.new(builder: self).post(params: params, headers: headers, body: body)
+    ensure
+      reset
+    end
+
+    def update(params: nil, headers: nil, body: nil)
+      APIRequest.new(builder: self).put(params: params, headers: headers, body: body)
+    ensure
+      reset
+    end
+
+    def retrieve(params: nil, headers: nil)
+      APIRequest.new(builder: self).get(params: params, headers: headers)
+    ensure
+      reset
+    end
+
+    def delete(params: nil, headers: nil)
+      APIRequest.new(builder: self).delete(params: params, headers: headers)
+    ensure
+      reset
+    end
+
+    protected
+
+    def reset
+      @path_parts = []
+    end
+
+    class << self
+      attr_accessor :username, :password, :api_environment, :api_endpoint, :timeout, :open_timeout, :proxy, :faraday_adapter, :symbolize_keys, :debug, :logger
+
+      def method_missing(sym, *args, &block)
+        new(username: self.username, password: self.password, api_environment: self.api_environment, api_endpoint: self.api_endpoint, timeout: self.timeout, open_timeout: self.open_timeout, faraday_adapter: self.faraday_adapter, symbolize_keys: self.symbolize_keys, debug: self.debug, proxy: self.proxy, logger: self.logger).send(sym, *args, &block)
+      end
+
+      def respond_to_missing?(method_name, include_private = false)
+        true
+      end
+    end
+  end
+end

data/lib/confrere/response.rb

@@ -0,0 +1,10 @@
+module Confrere
+  class Response
+    attr_accessor :body, :headers
+
+    def initialize(body: {}, headers: {})
+      @body = body
+      @headers = headers
+    end
+  end
+end

data/lib/confrere/version.rb

@@ -0,0 +1,3 @@
+module Confrere
+  VERSION = "0.0.1"
+end

data/spec/confrere/api_error_spec.rb

@@ -0,0 +1,49 @@
+require 'spec_helper'
+
+describe Confrere::APIError do
+  let(:message) { 'Foo' }
+  let(:params) do
+    {
+      title: 'error_title',
+      detail: 'error_detail',
+      body: 'error_body',
+      raw_body: 'error_raw_body',
+      status_code: 'error_status_code'
+    }
+  end
+
+  before do
+    @confrere = Confrere::APIError.new(message, params)
+  end
+
+  it "adds the error params to the error message" do
+    expected_message = "Foo "                               \
+                       "@title=\"error_title\", "           \
+                       "@detail=\"error_detail\", "         \
+                       "@body=\"error_body\", "             \
+                       "@raw_body=\"error_raw_body\", "     \
+                       "@status_code=\"error_status_code\""
+
+    expect(@confrere.message).to eq(expected_message)
+  end
+
+  it 'sets the title attribute' do
+    expect(@confrere.title).to eq(params[:title])
+  end
+
+  it 'sets the detail attribute' do
+    expect(@confrere.detail).to eq(params[:detail])
+  end
+
+  it 'sets the body attribute' do
+    expect(@confrere.body).to eq(params[:body])
+  end
+
+  it 'sets the raw_body attribute' do
+    expect(@confrere.raw_body).to eq(params[:raw_body])
+  end
+
+  it 'sets the status_code attribute' do
+    expect(@confrere.status_code).to eq(params[:status_code])
+  end
+end

data/spec/confrere/api_request_spec.rb

@@ -0,0 +1,60 @@
+require 'spec_helper'
+require 'webmock/rspec'
+
+describe Confrere::APIRequest do
+  let(:username) { "42" }
+  let(:password) { "hemmelig" }
+
+  before do
+    @confrere = Confrere::Request.new(username: username, password: password)
+    @api_root = "https://api.confrere.com/v1"
+  end
+
+  it "surfaces client request exceptions as a Confrere::APIError" do
+    exception = Faraday::Error::ClientError.new("the server responded with status 503")
+    stub_request(:get, "#{@api_root}/users").with(basic_auth: [username, password]).to_raise(exception)
+    expect { @confrere.users.retrieve }.to raise_error(Confrere::APIError)
+  end
+
+  it "surfaces an unparseable client request exception as a Confrere::APIError" do
+    exception = Faraday::Error::ClientError.new(
+      "the server responded with status 503")
+    stub_request(:get, "#{@api_root}/users").with(basic_auth: [username, password]).to_raise(exception)
+    expect { @confrere.users.retrieve }.to raise_error(Confrere::APIError)
+  end
+
+  it "surfaces an unparseable response body as a Confrere::APIError" do
+    response_values = {:status => 503, :headers => {}, :body => '[foo]'}
+    exception = Faraday::Error::ClientError.new("the server responded with status 503", response_values)
+    stub_request(:get, "#{@api_root}/users").with(basic_auth: [username, password]).to_raise(exception)
+    expect { @confrere.users.retrieve }.to raise_error(Confrere::APIError)
+  end
+
+  context "handle_error" do
+    it "includes status and raw body even when json can't be parsed" do
+      response_values = {:status => 503, :headers => {}, :body => 'A non JSON response'}
+      exception = Faraday::Error::ClientError.new("the server responded with status 503", response_values)
+      api_request = Confrere::APIRequest.new(builder: Confrere::Request)
+      begin
+        api_request.send :handle_error, exception
+      rescue => boom
+        expect(boom.status_code).to eq 503
+        expect(boom.raw_body).to eq "A non JSON response"
+      end
+    end
+
+    context "when symbolize_keys is true" do
+      it "sets title and detail on the error params" do
+        response_values = {:status => 422, :headers => {}, :body => '{"title": "foo", "detail": "bar"}'}
+        exception = Faraday::Error::ClientError.new("the server responded with status 422", response_values)
+        api_request = Confrere::APIRequest.new(builder: Confrere::Request.new(symbolize_keys: true))
+        begin
+          api_request.send :handle_error, exception
+        rescue => boom
+          expect(boom.title).to eq "foo"
+          expect(boom.detail).to eq "bar"
+        end
+      end
+    end
+  end
+end

data/spec/confrere/confrere_spec.rb

@@ -0,0 +1,241 @@
+require 'spec_helper'
+require 'cgi'
+
+describe Confrere do
+  describe "attributes" do
+    before do
+      Confrere::APIRequest.send(:public, *Confrere::APIRequest.protected_instance_methods)
+
+      @username = "42"
+      @password = "hemmelig"
+      @proxy = 'the_proxy'
+    end
+
+    it "have no API by default" do
+      @confrere = Confrere::Request.new
+      expect(@confrere.username).to be_nil
+    end
+
+    it "sets an API key in the constructor" do
+      @confrere = Confrere::Request.new(username: @username, password: @password)
+      expect(@confrere.username).to eq(@username)
+      expect(@confrere.password).to eq(@password)
+    end
+
+    it "sets an API key via setter" do
+      @confrere = Confrere::Request.new
+      @confrere.username = @username
+      @confrere.password = @password
+      expect(@confrere.username).to eq(@username)
+      expect(@confrere.password).to eq(@password)
+    end
+
+    it "sets timeout and get" do
+      @confrere = Confrere::Request.new
+      timeout = 30
+      @confrere.timeout = timeout
+      expect(timeout).to eq(@confrere.timeout)
+    end
+
+    it "sets the open_timeout and get" do
+      @confrere = Confrere::Request.new
+      open_timeout = 30
+      @confrere.open_timeout = open_timeout
+      expect(open_timeout).to eq(@confrere.open_timeout)
+    end
+
+    it "timeout properly passed to APIRequest" do
+      @confrere = Confrere::Request.new
+      timeout = 30
+      @confrere.timeout = timeout
+      @request = Confrere::APIRequest.new(builder: @confrere)
+      expect(timeout).to eq(@request.timeout)
+    end
+
+    it "timeout properly based on open_timeout passed to APIRequest" do
+      @confrere = Confrere::Request.new
+      open_timeout = 30
+      @confrere.open_timeout = open_timeout
+      @request = Confrere::APIRequest.new(builder: @confrere)
+      expect(open_timeout).to eq(@request.open_timeout)
+    end
+
+    it "has no Proxy url by default" do
+      @confrere = Confrere::Request.new
+      expect(@confrere.proxy).to be_nil
+    end
+
+    it "sets an proxy url key from the 'CONFRERE_PROXY_URL' ENV variable" do
+      ENV['CONFRERE_PROXY_URL'] = @proxy
+      @confrere = Confrere::Request.new
+      expect(@confrere.proxy).to eq(@proxy)
+      ENV.delete('CONFRERE_PROXY_URL')
+    end
+
+    it "sets an API key via setter" do
+      @confrere = Confrere::Request.new
+      @confrere.proxy = @proxy
+      expect(@confrere.proxy).to eq(@proxy)
+    end
+
+    it "sets an adapter in the constructor" do
+      adapter = :em_synchrony
+      @confrere = Confrere::Request.new(faraday_adapter: adapter)
+      expect(@confrere.faraday_adapter).to eq(adapter)
+    end
+
+    it "symbolize_keys false by default" do
+      @confrere = Confrere::Request.new
+      expect(@confrere.symbolize_keys).to be false
+    end
+
+    it "sets symbolize_keys in the constructor" do
+      @confrere = Confrere::Request.new(symbolize_keys: true)
+      expect(@confrere.symbolize_keys).to be true
+    end
+
+    it "sets symbolize_keys in the constructor" do
+      @confrere = Confrere::Request.new(symbolize_keys: true)
+      expect(@confrere.symbolize_keys).to be true
+    end
+
+    it "debug false by default" do
+      @confrere = Confrere::Request.new
+      expect(@confrere.debug).to be false
+    end
+
+    it "sets debug in the constructor" do
+      @confrere = Confrere::Request.new(debug: true)
+      expect(@confrere.debug).to be true
+    end
+
+    it "sets logger in constructor" do
+      logger = double(:logger)
+      @confrere = Confrere::Request.new(logger: logger)
+      expect(@confrere.logger).to eq(logger)
+    end
+
+    it "is a Logger instance by default" do
+      @confrere = Confrere::Request.new
+      expect(@confrere.logger).to be_a Logger
+    end
+
+    it "api_environment production by default" do
+      @confrere = Confrere::Request.new
+      expect(@confrere.api_environment).to be :production
+    end
+
+    it "sets api_environment in the constructor" do
+      @confrere = Confrere::Request.new(api_environment: :sandbox)
+      expect(@confrere.api_environment).to be :sandbox
+    end
+
+  end
+
+  describe "supports different environments" do
+    before do
+      Confrere::APIRequest.send(:public, *Confrere::APIRequest.protected_instance_methods)
+    end
+
+    it "has correct api url" do
+      @confrere = Confrere::Request.new()
+      @request = Confrere::APIRequest.new(builder: @confrere)
+      expect(@request.send(:base_api_url)).to eq("https://api.confrere.com/v1/")
+    end
+
+  end
+
+  describe "build api url" do
+    before do
+      Confrere::APIRequest.send(:public, *Confrere::APIRequest.protected_instance_methods)
+
+      @confrere = Confrere::Request.new
+    end
+
+    it "doesn't allow empty api username or password" do
+      expect {@confrere.try.retrieve}.to raise_error(Confrere::ConfrereError)
+    end
+
+  end
+
+  describe "class variables" do
+    let(:logger) { double(:logger) }
+
+    before do
+      Confrere::Request.username = "42"
+      Confrere::Request.password = "hemmelig"
+      Confrere::Request.timeout = 15
+      Confrere::Request.api_environment = :sandbox
+      Confrere::Request.api_endpoint = 'https://confrere.example.org/v1337/'
+      Confrere::Request.logger = logger
+      Confrere::Request.proxy = "http://1234.com"
+      Confrere::Request.symbolize_keys = true
+      Confrere::Request.faraday_adapter = :net_http
+      Confrere::Request.debug = true
+    end
+
+    after do
+      Confrere::Request.username = nil
+      Confrere::Request.password = nil
+      Confrere::Request.timeout = nil
+      Confrere::Request.api_environment = nil
+      Confrere::Request.api_endpoint = nil
+      Confrere::Request.logger = nil
+      Confrere::Request.proxy = nil
+      Confrere::Request.symbolize_keys = nil
+      Confrere::Request.faraday_adapter = nil
+      Confrere::Request.debug = nil
+    end
+
+    it "set username on new instances" do
+      expect(Confrere::Request.new.username).to eq(Confrere::Request.username)
+    end
+
+    it "set password on new instances" do
+      expect(Confrere::Request.new.password).to eq(Confrere::Request.password)
+    end
+
+    it "set timeout on new instances" do
+      expect(Confrere::Request.new.timeout).to eq(Confrere::Request.timeout)
+    end
+
+    it "set api_environment on new instances" do
+      expect(Confrere::Request.api_environment).not_to be_nil
+      expect(Confrere::Request.new.api_environment).to eq(Confrere::Request.api_environment)
+    end
+
+    it "set api_endpoint on new instances" do
+      expect(Confrere::Request.api_endpoint).not_to be_nil
+      expect(Confrere::Request.new.api_endpoint).to eq(Confrere::Request.api_endpoint)
+    end
+
+    it "set proxy on new instances" do
+      expect(Confrere::Request.new.proxy).to eq(Confrere::Request.proxy)
+    end
+
+    it "set symbolize_keys on new instances" do
+      expect(Confrere::Request.new.symbolize_keys).to eq(Confrere::Request.symbolize_keys)
+    end
+
+    it "set debug on new instances" do
+      expect(Confrere::Request.new.debug).to eq(Confrere::Request.debug)
+    end
+
+    it "set faraday_adapter on new instances" do
+      expect(Confrere::Request.new.faraday_adapter).to eq(Confrere::Request.faraday_adapter)
+    end
+
+    it "set logger on new instances" do
+      expect(Confrere::Request.new.logger).to eq(logger)
+    end
+  end
+
+  describe "missing methods" do
+    it "respond to .method call on class" do
+      expect(Confrere::Request.method(:customers)).to be_a(Method)
+    end
+    it "respond to .method call on instance" do
+      expect(Confrere::Request.new.method(:customers)).to be_a(Method)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+require 'rubygems'
+require 'bundler'
+
+Bundler.setup(:default, :development)
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'confrere'
+
+RSpec.configure do |config|
+  config.color = true
+end

metadata

@@ -0,0 +1,135 @@
+--- !ruby/object:Gem::Specification
+name: confrater
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Espen Antonsen
+- Amro Mousa
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-02-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !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'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  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'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  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: A wrapper for Confrere API
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.markdown
+- Rakefile
+- confrere.gemspec
+- lib/confrere.rb
+- lib/confrere/api_error.rb
+- lib/confrere/api_request.rb
+- lib/confrere/confrere_error.rb
+- lib/confrere/request.rb
+- lib/confrere/response.rb
+- lib/confrere/version.rb
+- spec/confrere/api_error_spec.rb
+- spec/confrere/api_request_spec.rb
+- spec/confrere/confrere_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/espen/confrere
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.2
+signing_key: 
+specification_version: 4
+summary: A wrapper for Confrere API
+test_files:
+- spec/confrere/api_error_spec.rb
+- spec/confrere/api_request_spec.rb
+- spec/confrere/confrere_spec.rb
+- spec/spec_helper.rb