fortnox-api 0.9.2 → 1.0.0.rc2

data/spec/fortnox/api/mappers/order_spec.rb

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'fortnox/api'
-require 'fortnox/api/mappers/order'
-require 'fortnox/api/mappers/examples/mapper'
-
-describe Fortnox::API::Mapper::Order do
-  key_map =
-    {
-      administration_fee_vat: 'AdministrationFeeVAT',
-      freight_vat: 'FreightVAT',
-      housework: 'HouseWork',
-      total_vat: 'TotalVAT',
-      vat_included: 'VATIncluded'
-    }
-  json_entity_type = 'Order'
-  json_entity_collection = 'Orders'
-
-  it_behaves_like 'mapper', key_map, json_entity_type, json_entity_collection do
-    let(:mapper) { described_class.new }
-  end
-end

data/spec/fortnox/api/mappers/project_spec.rb

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'fortnox/api'
-require 'fortnox/api/mappers/project'
-require 'fortnox/api/mappers/examples/mapper'
-
-describe Fortnox::API::Mapper::Project do
-  it_behaves_like 'mapper', {}, 'Project', 'Projects' do
-    let(:mapper) { described_class.new }
-  end
-end

data/spec/fortnox/api/mappers/terms_of_payment_spec.rb

@@ -1,16 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'fortnox/api'
-require 'fortnox/api/mappers/terms_of_payment'
-require 'fortnox/api/mappers/examples/mapper'
-
-describe Fortnox::API::Mapper::TermsOfPayment do
-  key_map = {}
-  json_entity_type = 'TermsOfPayment'
-  json_entity_collection = 'TermsOfPayments'
-
-  it_behaves_like 'mapper', key_map, json_entity_type, json_entity_collection do
-    let(:mapper) { described_class.new }
-  end
-end

data/spec/fortnox/api/mappers/unit_spec.rb

@@ -1,56 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'fortnox/api'
-require 'fortnox/api/mappers/unit'
-require 'fortnox/api/models/unit'
-require 'fortnox/api/mappers/examples/mapper'
-
-module Fortnox
-  module API
-    module Mapper
-      describe Unit do
-        context 'when mapping model' do
-          let(:model) { Model::Unit.new(code: 'lbs', description: 'Pounds') }
-          let(:serialised_model_hash) { { 'Unit' => { 'Code' => 'lbs', 'Description' => 'Pounds' } } }
-          let(:model_hash) { { code: 'lbs', description: 'Pounds' } }
-
-          describe '#entity_to_hash' do
-            subject { described_class.new.entity_to_hash(model, {}) }
-
-            it { is_expected.to eq(serialised_model_hash) }
-          end
-
-          describe '#wrapped_json_hash_to_entity_hash' do
-            subject { described_class.new.wrapped_json_hash_to_entity_hash(serialised_model_hash) }
-
-            it { is_expected.to eq(model_hash) }
-          end
-        end
-
-        context 'when mapping collection' do
-          let(:serialised_collection_hash) do
-            { 'Units' => [
-              { 'Unit' => { 'Code' => 'lbs', 'Description' => 'Pounds' } },
-              { 'Unit' => { 'Code' => 'ohm', 'Description' => 'Ω' } },
-              { 'Unit' => { 'Code' => 'A/V', 'Description' => 'Ampere volt' } }
-            ] }
-          end
-          let(:collection_hash) do
-            [
-              { unit: { code: 'lbs', description: 'Pounds' } },
-              { unit: { code: 'ohm', description: 'Ω' } },
-              { unit: { code: 'A/V', description: 'Ampere volt' } }
-            ]
-          end
-
-          describe '#wrapped_json_collection_to_entities_hash' do
-            subject { described_class.new.wrapped_json_collection_to_entities_hash(serialised_collection_hash) }
-
-            it { is_expected.to eq(collection_hash) }
-          end
-        end
-      end
-    end
-  end
-end

data/spec/fortnox/api/models/article_spec.rb

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'fortnox/api/models/article'
-require 'fortnox/api/models/examples/model'
-
-describe Fortnox::API::Model::Article, type: :model do
-  it_behaves_like 'a model', '1'
-end

data/spec/fortnox/api/models/base_spec.rb

@@ -1,117 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'fortnox/api/models/base'
-require 'fortnox/api/types'
-
-describe Fortnox::API::Model::Base do
-  let(:entity_class) do
-    Class.new(Fortnox::API::Model::Base) do
-      attribute :private, Fortnox::API::Types::String.is(:read_only)
-      attribute :string, Fortnox::API::Types::Required::String
-      attribute :number, Fortnox::API::Types::Nullable::Integer
-      attribute :account, Fortnox::API::Types::AccountNumber
-    end
-  end
-
-  describe '.new' do
-    context 'with basic attribute' do
-      subject { entity_class.new(string: 'Test') }
-
-      it { is_expected.to be_a entity_class }
-      it { is_expected.to be_new }
-      it { is_expected.not_to be_saved }
-    end
-
-    context 'without required attribute' do
-      it do
-        expect do
-          entity_class.new({})
-        end.to raise_error Fortnox::API::MissingAttributeError, /Missing attribute :string/
-      end
-    end
-
-    context 'with invalid attribute value' do
-      it do
-        expect do
-          entity_class.new(string: 'Test', account: 13_337)
-        end.to raise_error Fortnox::API::AttributeError, /invalid type for :account/
-      end
-    end
-  end
-
-  describe '.update' do
-    let(:original) { entity_class.new(string: 'Test') }
-
-    context 'with new, simple value' do
-      subject(:updated_model) { original.update(string: 'Variant') }
-
-      it { is_expected.to be_new }
-      it { is_expected.not_to be_saved }
-
-      it 'returns a new object' do
-        expect(updated_model).not_to eql(original)
-      end
-
-      describe 'updated attribute' do
-        subject { updated_model.string }
-
-        it { is_expected.to eql('Variant') }
-      end
-
-      describe 'returned class' do
-        subject { updated_model.class }
-
-        it { is_expected.to eql(original.class) }
-      end
-    end
-
-    context 'with the same, simple value' do
-      subject(:updated_model) { original.update(string: 'Test') }
-
-      it 'returns the same object' do
-        expect(updated_model).to eql(original)
-      end
-
-      it 'returns a object with the same value' do
-        expect(updated_model.string).to eql('Test')
-      end
-
-      it { is_expected.to be_new }
-      it { is_expected.not_to be_saved }
-    end
-
-    context 'when updating a saved entity' do
-      let(:updated_entity) do
-        saved_entity = entity_class.new(string: 'Saved', new: false, unsaved: false)
-        saved_entity.update(string: 'Updated')
-      end
-
-      describe 'updated entity' do
-        subject { updated_entity }
-
-        it { is_expected.not_to be_saved }
-        it { is_expected.not_to be_new }
-      end
-
-      describe 'updated attribute value' do
-        subject { updated_entity.string }
-
-        it { is_expected.to eq('Updated') }
-      end
-    end
-
-    context 'when updating a saved entity with nil values' do
-      subject(:updated_entity) { original.update(number: nil) }
-
-      let(:original) { entity_class.new(string: 'Saved', new: false, unsaved: false) }
-
-      it 'returns the same object' do
-        expect(updated_entity).to eql(original)
-      end
-
-      it { is_expected.not_to be_new }
-      it { is_expected.to be_saved }
-    end
-  end
-end

data/spec/fortnox/api/models/customer_spec.rb

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'fortnox/api/models/customer'
-require 'fortnox/api/models/examples/model'
-
-describe Fortnox::API::Model::Customer, type: :model do
-  it_behaves_like 'a model', '1'
-end

data/spec/fortnox/api/models/examples/document_base.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-require 'fortnox/api/models/examples/model'
-
-shared_examples_for 'DocumentBase Model' do |row_class, row_attribute, valid_row_hash: {}|
-  it_behaves_like 'a model', 1
-
-  context "when having a(n) #{row_class}" do
-    it 'returns the correct object' do
-      row = row_class.new(valid_row_hash)
-      document = described_class.new(customer_number: '123', row_attribute => [row])
-      expect(document.send(row_attribute)).to eq([row])
-    end
-  end
-end

data/spec/fortnox/api/models/examples/model.rb

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-shared_examples_for 'a model' do |unique_id|
-  let(:required_attributes) { described_class::STUB.dup }
-  let(:unique_id_attribute) { described_class::UNIQUE_ID }
-
-  it 'can be initialized' do
-    expect { described_class.new(required_attributes) }.not_to raise_error
-  end
-
-  describe '.unique_id' do
-    subject { model.unique_id }
-
-    let(:model) do
-      described_class.new(
-        required_attributes.merge(unique_id_attribute => unique_id)
-      )
-    end
-
-    it { is_expected.to eq unique_id }
-  end
-end

data/spec/fortnox/api/models/invoice_spec.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'fortnox/api/models/invoice'
-require 'fortnox/api/models/examples/document_base'
-
-describe Fortnox::API::Model::Invoice, type: :model do
-  it_behaves_like 'DocumentBase Model',
-                  Fortnox::API::Types::InvoiceRow,
-                  :invoice_rows
-end

data/spec/fortnox/api/models/order_spec.rb

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'fortnox/api/models/order'
-require 'fortnox/api/models/examples/document_base'
-
-describe Fortnox::API::Model::Order, type: :model do
-  it_behaves_like 'DocumentBase Model',
-                  Fortnox::API::Types::OrderRow,
-                  :order_rows,
-                  valid_row_hash: { ordered_quantity: 1.1 }
-end

data/spec/fortnox/api/models/project_spec.rb

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'fortnox/api/models/project'
-require 'fortnox/api/models/examples/model'
-
-describe Fortnox::API::Model::Project, type: :model do
-  it_behaves_like 'a model', '1'
-end

data/spec/fortnox/api/models/terms_of_payment_spec.rb

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'fortnox/api/models/terms_of_payment'
-require 'fortnox/api/models/examples/model'
-
-describe Fortnox::API::Model::TermsOfPayment, type: :model do
-  it_behaves_like 'a model', '1'
-end

data/spec/fortnox/api/models/unit_spec.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'fortnox/api/models/unit'
-
-module Fortnox
-  module API
-    # Shhh Rubocop, we don't need a comment here ... Really
-    module Model
-      describe Unit, type: :model do
-        context 'when created from empty hash' do
-          it {
-            expect do
-              described_class.new
-            end.to raise_error(Fortnox::API::MissingAttributeError, /Missing attribute.*:code/)
-          }
-        end
-
-        context 'when created from stub' do
-          subject { described_class.stub }
-
-          it { is_expected.to have_attributes(code: '', description: nil) }
-        end
-
-        context 'when created with all attributes' do
-          subject { described_class.new(code: 'lbs', description: 'Pounds') }
-
-          it { is_expected.to have_attributes(code: 'lbs', description: 'Pounds') }
-        end
-      end
-    end
-  end
-end

data/spec/fortnox/api/repositories/article_spec.rb

@@ -1,80 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'fortnox/api'
-require 'fortnox/api/mappers'
-require 'fortnox/api/repositories/customer'
-require 'fortnox/api/repositories/examples/all'
-require 'fortnox/api/repositories/examples/find'
-require 'fortnox/api/repositories/examples/save'
-require 'fortnox/api/repositories/examples/save_with_specially_named_attribute'
-require 'fortnox/api/repositories/examples/search'
-
-describe Fortnox::API::Repository::Article, integration: true, order: :defined do
-  include Helpers::Configuration
-  include Helpers::Repositories
-
-  subject(:repository) { described_class.new }
-
-  before { set_api_test_configuration }
-
-  # VCR: Requires a Financial Year in Fortnox, otherwise the sales account is not be available.
-  # VCR: Update requires that default accounts exists in the chart of accounts
-  include_examples '.save',
-                   :description,
-                   additional_attrs: { sales_account: 1250 }
-
-  include_examples '.save with specially named attribute',
-                   { description: 'Test article' },
-                   :ean,
-                   '5901234123457'
-
-  # VCR: expected matches must be increased
-  include_examples '.all', 6
-
-  # VCR: Expected matches must be increased
-  # VCR: Create the searched Articles manually in Fortnox
-  include_examples '.find', '1' do
-    let(:find_by_hash_failure) { { description: 'Not Found' } }
-    let(:single_param_find_by_hash) { { find_hash: { articlenumber: 101 }, matches: 1 } }
-
-    let(:multi_param_find_by_hash) do
-      { find_hash: { articlenumber: 101, description: 'Hammer' }, matches: 1 }
-    end
-  end
-
-  # VCR: Expected mathes must be updated
-  include_examples '.search', :description, 'Test article', 3
-
-  describe 'limits' do
-    let(:article) do
-      VCR.use_cassette("#{vcr_dir}/#{cassette}") do
-        repository.save(described_class::MODEL.new(**attributes))
-      end
-    end
-
-    describe 'quantity_in_stock' do
-      let(:cassette) { 'limits/quantity_in_stock_min_value' }
-      let(:attributes) do
-        {
-          description: 'Test article',
-          quantity_in_stock: quantity_in_stock
-        }
-      end
-      let(:quantity_in_stock) { -99_999_999_999_999.9 }
-
-      it 'has a lower limit' do
-        expect(article.quantity_in_stock).to eq(-100_000_000_000_000.0)
-      end
-
-      context 'when positive' do
-        let(:cassette) { 'limits/quantity_in_stock_rounding_positive_value' }
-        let(:quantity_in_stock) { 1.123 }
-
-        it 'rounds to two decimals' do
-          expect(article.quantity_in_stock).to eq(1.12)
-        end
-      end
-    end
-  end
-end

data/spec/fortnox/api/repositories/authentication_spec.rb

@@ -1,103 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'fortnox/api'
-require 'fortnox/api/repositories/authentication'
-
-describe Fortnox::API::Repository::Authentication, integration: true do
-  include Helpers::Configuration
-
-  subject(:repository) { described_class.new }
-
-  before { set_api_test_configuration }
-
-  let(:vcr_dir) { 'authentication' }
-
-  let(:valid_response) do
-    VCR.use_cassette("#{vcr_dir}/valid_request") do
-      repository.renew_tokens(
-        refresh_token: ENV.fetch('FORTNOX_API_REFRESH_TOKEN'),
-        client_id: ENV.fetch('FORTNOX_API_CLIENT_ID'),
-        client_secret: ENV.fetch('FORTNOX_API_CLIENT_SECRET')
-      )
-    end
-  end
-
-  describe '#renew_tokens' do
-    context 'with invalid authorization' do
-      let(:request_with_nonsense_credentials) do
-        VCR.use_cassette("#{vcr_dir}/invalid_authorization") do
-          repository.renew_tokens(
-            refresh_token: ENV.fetch('FORTNOX_API_REFRESH_TOKEN'),
-            client_id: 'nonsense_id',
-            client_secret: 'nonsense_secret'
-          )
-        end
-      end
-
-      it 'raises an error' do
-        expect { request_with_nonsense_credentials }.to(
-          raise_error(Fortnox::API::RemoteServerError, /Unauthorized request(.)*Error:(.)*invalid_client/)
-        )
-      end
-    end
-
-    context 'with invalid refresh token' do
-      let(:request_with_invalid_refresh_token) do
-        VCR.use_cassette("#{vcr_dir}/invalid_refresh_token") do
-          repository.renew_tokens(
-            refresh_token: 'invalid_refresh_token',
-            client_id: ENV.fetch('FORTNOX_API_CLIENT_ID'),
-            client_secret: ENV.fetch('FORTNOX_API_CLIENT_SECRET')
-          )
-        end
-      end
-
-      it 'raises an error' do
-        expect { request_with_invalid_refresh_token }.to(
-          raise_error(Fortnox::API::RemoteServerError, /Bad request(.)*Error:(.)*Invalid refresh token/)
-        )
-      end
-    end
-
-    describe 'returned hash' do
-      subject { valid_response }
-
-      it { is_expected.to include(:access_token, :refresh_token, :expires_in, :token_type, :scope) }
-    end
-
-    describe 'access_token' do
-      subject { valid_response[:access_token] }
-
-      it { is_expected.to be_a(String) }
-      it { is_expected.not_to be_empty }
-    end
-
-    describe 'refresh_token' do
-      subject { valid_response[:refresh_token] }
-
-      it { is_expected.to be_a(String) }
-      it { is_expected.not_to be_empty }
-    end
-
-    describe 'expires_in' do
-      subject { valid_response[:expires_in] }
-
-      it { is_expected.to be_a(Integer) }
-    end
-
-    describe 'token_type' do
-      subject { valid_response[:token_type] }
-
-      it { is_expected.to be_a(String) }
-      it { is_expected.not_to be_empty }
-    end
-
-    describe 'scope' do
-      subject { valid_response[:scope] }
-
-      it { is_expected.to be_a(String) }
-      it { is_expected.not_to be_empty }
-    end
-  end
-end