visma_eaccounting 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a737f9498f23b71408ea0cb7354a4ab43f1a0d8857b45197264d2917a0a4bda8
+  data.tar.gz: 53477ec8fd7db0e6e6d21bbcb8c99e2d210fcf280be63998edbf6f6426a31276
+SHA512:
+  metadata.gz: 96c9e12c4139c153d476b980b8fe284b54529badab45f84887688e6a02d79f5db1433924f2217fba461a8981d243a514e7e7c51f6c2d5f82b234a5ef95e58ce4
+  data.tar.gz: 753cd063742597f284bafcec09031e9ad1bda77816c6155599fcb8be4803f93352127390ff7019512e5ea6bb4ba03e14b2740e07de5846b8b9b2ffc8372c3df1

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

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/.travis.yml

@@ -0,0 +1,10 @@
+language: ruby
+sudo: false
+cache: bundler
+before_install:
+  - gem install bundler # -v 1.7.14 if a specific version is needed
+rvm:
+  - 2.0.0
+  - 2.1.5
+  - 2.2.2
+  - 2.3.3

data/Gemfile

@@ -0,0 +1,12 @@
+source "https://rubygems.org"
+
+platforms :rbx do
+  gem 'rubysl', '~> 2.2.0'
+  gem 'rubinius-developer_tools'
+end
+
+group :development, :test do
+  gem 'webmock', '~>1.24.0'
+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,194 @@
+# visma_eaccounting
+
+VismaEaccounting is an API wrapper for the Visma eAccounting [API](https://developer.vismaonline.com/).
+
+## Important Notes
+
+VismaEaccounting returns a `VismaEaccounting::Response` instead of the response body directly. `VismaEaccounting::Response` exposes the parsed response `body` and `headers`.
+
+## Installation
+
+    $ gem install visma_eaccounting
+
+## Requirements
+
+A Visma eAccounting account and oAuth client id.
+
+## Usage
+
+First, create a *one-time use instance* of `VismaEaccounting::Request`:
+
+```ruby
+visma_eaccounting = VismaEaccounting::Request.new(token: "your_token")
+```
+
+***Note*** Only reuse instances of VismaEaccounting 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
+visma_eaccounting.timeout = 30
+visma_eaccounting.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 Visma eAccounting's docs](https://developer.vismaonline.com/#APIReference). Resource IDs
+are specified inline and a `CRUD` (`create`, `retrieve`, `update`, `upsert`, or `delete`) verb initiates the request. `upsert` lets you update a record, if it exists, or insert it otherwise where supported by Visma's API.
+
+You can specify `headers`, `params`, and `body` when calling a `CRUD` method. For example:
+
+```ruby
+visma_eaccounting.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 `token`, `timeout`, `open_timeout`, `faraday_adapter`, `proxy`, `symbolize_keys`, `logger`, and `debug` globally:
+
+```ruby
+VismaEaccounting::Request.token = "your_token"
+VismaEaccounting::Request.timeout = 15
+VismaEaccounting::Request.open_timeout = 15
+VismaEaccounting::Request.symbolize_keys = true
+VismaEaccounting::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/visma_eaccounting.rb).
+
+Assuming you've set an `token` on VismaEaccounting, you can conveniently make API calls on the class itself:
+
+```ruby
+VismaEaccounting::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
+visma_eaccounting = VismaEaccounting::Request.new(token: "your_token", symbolize_keys: true)
+```
+
+Visma's [API documentation](https://developer.vismaonline.com/#APIReference) is a list of available endpoints.
+
+## Environments
+
+The default environment is ```:production```. To use the sandbox environment you can set ```:sandbox``` in constructor or globally. This will set the default ```api_endpoint``` URL.
+
+## Debug Logging
+
+Pass `debug: true` to enable debug logging to STDOUT.
+
+```ruby
+visma_eaccounting = VismaEaccounting::Request.new(token: "your_token", debug: true)
+```
+
+### Custom logger
+
+Ruby `Logger.new` is used by default, but it can be overrided using:
+
+```ruby
+visma_eaccounting = VismaEaccounting::Request.new(token: "your_token", debug: true, logger: MyLogger.new)
+```
+
+Logger can be also set by globally:
+
+```ruby
+VismaEaccounting::Request.logger = MyLogger.new
+```
+
+## Examples
+
+### Customers
+
+Fetch all customers:
+
+```ruby
+visma_eaccounting.customers.retrieve
+```
+
+By default the Visma API returns 50 results. To set the count to 50:
+
+```ruby
+visma_eaccounting.customers.retrieve(params: {"pagesize": "100"})
+```
+
+And to retrieve the next 50 members:
+
+```ruby
+visma_eaccounting.customers.retrieve(params: {"pagesize": "100", "page": "2"})
+```
+
+Query using filters:
+
+```ruby
+visma_eaccounting.customers.retrieve(params: {"filter": "contains(Name, ‘MakePlans’)"})
+```
+
+Retrieving a specific customer looks like:
+
+```ruby
+visma_eaccounting.customers(customer_id).retrieve
+```
+
+Add a new customer:
+
+```ruby
+visma_eaccounting.customers.create(body: {"Name": "MakePlans AS"})
+```
+
+### Fields
+
+Only retrieve ids and names for fetched customers:
+
+```ruby
+visma_eaccounting.customers.retrieve(params: {"select": "Id, Name"})
+```
+
+### Error handling
+
+VismaEaccounting raises an error when the API returns an error.
+
+`VismaEaccounting::VismaEaccountingError` 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
+  visma_eaccounting.customers(customer_id).members.create(body: body)
+rescue VismaEaccounting::VismaEaccountingError => 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 VISMA_PROXY):
+
+```ruby
+visma_eaccounting.proxy = 'http://your_proxy.com:80'
+```
+
+You can set a different [Faraday adapter](https://github.com/lostisland/faraday) during initialization:
+
+```ruby
+visma_eaccounting = VismaEaccounting::Request.new(token: "your_token", faraday_adapter: :net_http)
+```
+
+#### Initialization
+
+```ruby
+visma_eaccounting = VismaEaccounting::Request.new(token: "your_token")
+```
+
+## Thanks
+
+Thanks to everyone who has [contributed](https://github.com/espen/visma_eaccounting/contributors) to VismaEaccounting'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/lib/visma_eaccounting/api_error.rb

@@ -0,0 +1,29 @@
+module VismaEaccounting
+  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/visma_eaccounting/api_request.rb

@@ -0,0 +1,193 @@
+module VismaEaccounting
+  class APIRequest
+
+    def initialize(builder: nil)
+      @request_builder = builder
+    end
+
+    def post(params: nil, headers: nil, body: nil)
+      validate_token
+
+      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)
+      validate_token
+
+      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)
+      validate_token
+
+      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)
+      validate_token
+
+      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)
+      validate_token
+
+      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 token
+      @request_builder.token
+    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.authorization :Bearer, self.token
+      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 validate_token
+      token = self.token
+      unless token
+        raise VismaEaccounting::VismaEaccountingError, "You must set an token prior to making a call"
+      end
+    end
+
+    def api_url
+      base_api_url + @request_builder.path
+    end
+
+    def base_api_url
+      case self.class.api_environment
+      when :sandbox
+        "https://eaccountingapi-sandbox.test.vismaonline.com/v2/"
+      when :production
+        "https://eaccountingapi.vismaonline.com/v2/"
+      end
+    end
+  end
+end

data/lib/visma_eaccounting/request.rb

@@ -0,0 +1,90 @@
+module VismaEaccounting
+  class Request
+    attr_accessor :token, :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(token: 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 = []
+      @token = token || self.class.token
+      @token = @token.strip if @token
+      @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['VISMA_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 :token, :timeout, :open_timeout, :api_environment, :api_endpoint, :proxy, :faraday_adapter, :symbolize_keys, :debug, :logger
+
+      def method_missing(sym, *args, &block)
+        new(token: self.token, 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/visma_eaccounting/response.rb

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

data/lib/visma_eaccounting/version.rb

@@ -0,0 +1,3 @@
+module VismaEaccounting
+  VERSION = "0.0.2"
+end

data/lib/visma_eaccounting/visma_eaccounting_error.rb

@@ -0,0 +1,3 @@
+module VismaEaccounting
+  class VismaEaccountingError < StandardError; end
+end

data/lib/visma_eaccounting.rb

@@ -0,0 +1,13 @@
+require 'faraday'
+require 'multi_json'
+require 'cgi'
+require 'logger'
+
+require 'visma_eaccounting/visma_eaccounting_error'
+require 'visma_eaccounting/api_error'
+require 'visma_eaccounting/request'
+require 'visma_eaccounting/api_request'
+require 'visma_eaccounting/response'
+
+module VismaEaccounting
+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 'visma_eaccounting'
+
+RSpec.configure do |config|
+  config.color = true
+end

data/spec/visma_eaccounting/api_error_spec.rb

@@ -0,0 +1,49 @@
+require 'spec_helper'
+
+describe VismaEaccounting::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
+    @visma_eaccounting = VismaEaccounting::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(@visma_eaccounting.message).to eq(expected_message)
+  end
+
+  it 'sets the title attribute' do
+    expect(@visma_eaccounting.title).to eq(params[:title])
+  end
+
+  it 'sets the detail attribute' do
+    expect(@visma_eaccounting.detail).to eq(params[:detail])
+  end
+
+  it 'sets the body attribute' do
+    expect(@visma_eaccounting.body).to eq(params[:body])
+  end
+
+  it 'sets the raw_body attribute' do
+    expect(@visma_eaccounting.raw_body).to eq(params[:raw_body])
+  end
+
+  it 'sets the status_code attribute' do
+    expect(@visma_eaccounting.status_code).to eq(params[:status_code])
+  end
+end

data/spec/visma_eaccounting/api_request_spec.rb

@@ -0,0 +1,60 @@
+require 'spec_helper'
+require 'webmock/rspec'
+
+describe VismaEaccounting::APIRequest do
+  let(:token) { "ionfean8hfaeo8AUfenao(ea" }
+
+  before do
+    @visma_eaccounting = VismaEaccounting::Request.new(token: token)
+    @api_root = "https://eaccountingapi-sandbox.test.vismaonline.com/v2"
+  end
+
+  it "surfaces client request exceptions as a VismaEaccounting::APIError" do
+    exception = Faraday::Error::ClientError.new("the server responded with status 503")
+    stub_request(:get, "#{@api_root}/customers").to_raise(exception)
+    expect { @visma_eaccounting.customers.retrieve }.to raise_error(VismaEaccounting::APIError)
+  end
+
+  it "surfaces an unparseable client request exception as a VismaEaccounting::APIError" do
+    exception = Faraday::Error::ClientError.new(
+      "the server responded with status 503")
+    stub_request(:get, "#{@api_root}/customers").to_raise(exception)
+    expect { @visma_eaccounting.customers.retrieve }.to raise_error(VismaEaccounting::APIError)
+  end
+
+  it "surfaces an unparseable response body as a VismaEaccounting::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}/customers").to_raise(exception)
+    expect { @visma_eaccounting.customers.retrieve }.to raise_error(VismaEaccounting::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 = VismaEaccounting::APIRequest.new(builder: VismaEaccounting::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 = VismaEaccounting::APIRequest.new(builder: VismaEaccounting::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/visma_eaccounting/visma_eaccounting_spec.rb

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

data/visma_eaccounting.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require 'visma_eaccounting/version'
+
+Gem::Specification.new do |s|
+  s.name        = "visma_eaccounting"
+  s.version     = VismaEaccounting::VERSION
+  s.authors     = ["Espen Antonsen", "Amro Mousa"]
+  s.homepage    = "http://github.com/espen/visma_eaccounting"
+
+  s.summary     = %q{A wrapper for Visma eAccounting API 2.0}
+  s.description = %q{A wrapper for Visma eAccounting API 2.0}
+  s.license     = "MIT"
+
+  s.rubyforge_project = "visma_eaccounting"
+
+  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', '>= 0.9.1')
+  s.add_dependency('multi_json', '>= 1.11.0')
+
+  s.add_development_dependency 'rake'
+  s.add_development_dependency "rspec", "3.5.0"
+  s.add_development_dependency 'webmock', '~> 1.21.0'
+
+end

metadata

@@ -0,0 +1,138 @@
+--- !ruby/object:Gem::Specification
+name: visma_eaccounting
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Espen Antonsen
+- Amro Mousa
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-12-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.11.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.11.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: 3.5.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.5.0
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.21.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.21.0
+description: A wrapper for Visma eAccounting API 2.0
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".document"
+- ".gitignore"
+- ".travis.yml"
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.markdown
+- Rakefile
+- lib/visma_eaccounting.rb
+- lib/visma_eaccounting/api_error.rb
+- lib/visma_eaccounting/api_request.rb
+- lib/visma_eaccounting/request.rb
+- lib/visma_eaccounting/response.rb
+- lib/visma_eaccounting/version.rb
+- lib/visma_eaccounting/visma_eaccounting_error.rb
+- spec/spec_helper.rb
+- spec/visma_eaccounting/api_error_spec.rb
+- spec/visma_eaccounting/api_request_spec.rb
+- spec/visma_eaccounting/visma_eaccounting_spec.rb
+- visma_eaccounting.gemspec
+homepage: http://github.com/espen/visma_eaccounting
+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: []
+rubyforge_project: visma_eaccounting
+rubygems_version: 2.7.3
+signing_key: 
+specification_version: 4
+summary: A wrapper for Visma eAccounting API 2.0
+test_files:
+- spec/spec_helper.rb
+- spec/visma_eaccounting/api_error_spec.rb
+- spec/visma_eaccounting/api_request_spec.rb
+- spec/visma_eaccounting/visma_eaccounting_spec.rb