lhs 21.2.4 → 22.1.0

data/spec/record/includes_warning_spec.rb

@@ -37,7 +37,7 @@ describe LHS::Record do
 
     it 'warns if linked data was simply included but is paginated' do
       expect(lambda {
-        Customer.includes(:contracts).find(1)
+        Customer.includes_first_page(:contracts).find(1)
       }).to output(
         %r{\[WARNING\] You included `http://datastore/customers/1/contracts`, but this endpoint is paginated. You might want to use `includes_all` instead of `includes` \(https://github.com/local-ch/lhs#includes_all-for-paginated-endpoints\)\.}
       ).to_stderr

data/spec/record/mapping_spec.rb

@@ -75,7 +75,7 @@ describe LHS::Record do
         status: 200, body: { 'href' => preceding_agb_url }.to_json, headers: {}
       )
 
-      agb = Agb.includes(:preceding_agb).first!
+      agb = Agb.includes_first_page(:preceding_agb).first!
       expect(agb.pdf_url).to be == 'de'
     end
 
@@ -94,7 +94,7 @@ describe LHS::Record do
       stub_request(:get, "#{datastore}/favorites/1")
         .to_return(body: { local_entry: { href: "#{datastore}/local-entries/1" } }.to_json)
 
-      favorite = Favorite.includes(:local_entry).find(1)
+      favorite = Favorite.includes_first_page(:local_entry).find(1)
       expect(favorite.local_entry).to be_kind_of LocalEntry
       expect(favorite.local_entry.name).to eq 'local.ch'
     end

data/spec/record/references_spec.rb

@@ -40,7 +40,7 @@ describe LHS::Record do
 
     it 'uses the "references" hash for all symbols of the "including" array' do
       Customer
-        .includes(:electronic_addresses, :contact_addresses)
+        .includes_first_page(:electronic_addresses, :contact_addresses)
         .references(
           electronic_addresses: referencing_options,
           contact_addresses: referencing_options

data/spec/record/relation_caching_spec.rb

@@ -92,7 +92,7 @@ describe LHS::Record do
         .to_return(body: place_hash.to_json)
       place = Place
         .options(auth: { bearer: 'XYZ' })
-        .includes_all(:available_assets)
+        .includes(:available_assets)
         .find(place_id)
       expect(place.available_assets.first).to be_a(AvailableAsset)
     end
@@ -102,7 +102,7 @@ describe LHS::Record do
         .to_return(body: place_hash.to_json)
       place = Place
         .options(auth: { bearer: 'XYZ' })
-        .includes_all(:available_assets)
+        .includes(:available_assets)
         .where(id: place_id)
       expect(place.available_assets.first).to be_a(AvailableAsset)
     end
@@ -112,7 +112,7 @@ describe LHS::Record do
         .to_return(body: place_hash.to_json)
       place = Place
         .options(auth: { bearer: 'XYZ' })
-        .includes_all(:available_assets)
+        .includes(:available_assets)
         .find_by(id: place_id)
       expect(place.available_assets.first).to be_a(AvailableAsset)
     end

data/spec/record/update_spec.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require 'rails_helper'
+
+describe LHS::Record do
+  context 'update' do
+
+    before do
+      class Record < LHS::Record
+        endpoint 'http://datastore/records/{id}'
+      end
+    end
+
+    it 'allows to directly update a record without fetching it first' do
+      stub_request(:post, "http://datastore/records/123")
+        .with(body: { name: 'Steve' }.to_json)
+        .to_return(status: 200, body: {}.to_json)
+
+      Record.update(
+        id: '123',
+        name: 'Steve'
+      )
+    end
+
+    it 'does not fail during an error with update' do
+      stub_request(:post, "http://datastore/records/123")
+        .with(body: { name: 'Steve' }.to_json)
+        .to_return(status: 404, body: {}.to_json)
+
+      record = Record.update(
+        id: '123',
+        name: 'Steve'
+      )
+
+      expect(record.errors.status_code).to eq 404
+    end
+
+    it 'allows to directly update! a record without fetching it first' do
+      stub_request(:post, "http://datastore/records/123")
+        .with(body: { name: 'Steve' }.to_json)
+        .to_return(status: 200)
+
+      Record.update!(
+        id: '123',
+        name: 'Steve'
+      )
+    end
+
+    it 'raises an error when trying to update! but retrieving an error status' do
+      stub_request(:post, "http://datastore/records/123")
+        .with(body: { name: 'Steve' }.to_json)
+        .to_return(status: 404)
+
+      expect(-> {
+        Record.update!(
+          id: '123',
+          name: 'Steve'
+        )
+      }).to raise_error(LHC::NotFound)
+    end
+  end
+end

data/spec/request_cycle_cache_spec.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 require 'rails_helper'
-require 'lhc/test/cache_helper.rb'
+require 'lhc/rspec'
 
 describe 'Request Cycle Cache', type: :request do
   let!(:request) do
@@ -37,7 +37,7 @@ describe 'Request Cycle Cache', type: :request do
     expect(lambda do
       get '/request_cycle_cache/no_caching_interceptor'
     end).to output(
-      %r{\[WARNING\] Can't enable request cycle cache as LHC::Caching interceptor is not enabled/configured \(see https://github.com/local-ch/lhc/blob/master/docs/interceptors/caching.md#caching-interceptor\)!}
+      %r{\[WARNING\] Can't enable request cycle cache as LHC::Caching interceptor is not enabled/configured \(see https://github.com/local-ch/lhc/blob/master/README.md#caching-interceptor\)!}
     ).to_stderr
     expect(request).to have_been_made.times(2)
   end
@@ -70,7 +70,7 @@ describe 'Request Cycle Cache', type: :request do
       expect(lambda do
         get '/request_cycle_cache/no_caching_interceptor'
       end).not_to output(
-        %r{\[WARNING\] Can't enable request cycle cache as LHC::Caching interceptor is not enabled/configured \(see https://github.com/local-ch/lhc/blob/master/docs/interceptors/caching.md#caching-interceptor\)!}
+        %r{\[WARNING\] Can't enable request cycle cache as LHC::Caching interceptor is not enabled/configured \(see https://github.com/local-ch/lhc/blob/master/README.md#caching-interceptor\)!}
       ).to_stderr
       expect(request).to have_been_made.times(2)
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lhs
 version: !ruby/object:Gem::Version
-  version: 21.2.4
+  version: 22.1.0
 platform: ruby
 authors:
 - https://github.com/local-ch/lhs/graphs/contributors
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-04-20 00:00:00.000000000 Z
+date: 2020-07-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -146,16 +146,16 @@ dependencies:
   name: rollbar
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "<="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.24.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "<="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.24.0
 - !ruby/object:Gem::Dependency
   name: rspec-rails
   requirement: !ruby/object:Gem::Requirement
@@ -283,6 +283,7 @@ files:
 - lib/lhs/concerns/item/save.rb
 - lib/lhs/concerns/item/update.rb
 - lib/lhs/concerns/item/validation.rb
+- lib/lhs/concerns/o_auth.rb
 - lib/lhs/concerns/option_blocks.rb
 - lib/lhs/concerns/proxy/accessors.rb
 - lib/lhs/concerns/proxy/create.rb
@@ -311,9 +312,12 @@ files:
 - lib/lhs/concerns/record/request.rb
 - lib/lhs/concerns/record/scope.rb
 - lib/lhs/concerns/record/tracing.rb
+- lib/lhs/concerns/record/update.rb
 - lib/lhs/config.rb
 - lib/lhs/data.rb
 - lib/lhs/endpoint.rb
+- lib/lhs/interceptors/auto_oauth/interceptor.rb
+- lib/lhs/interceptors/auto_oauth/thread_registry.rb
 - lib/lhs/interceptors/extended_rollbar/handler.rb
 - lib/lhs/interceptors/extended_rollbar/interceptor.rb
 - lib/lhs/interceptors/extended_rollbar/thread_registry.rb
@@ -340,6 +344,7 @@ files:
 - lib/lhs/version.rb
 - script/ci/build.sh
 - spec/.DS_Store
+- spec/auto_oauth_spec.rb
 - spec/autoloading_spec.rb
 - spec/collection/accessors_spec.rb
 - spec/collection/collection_items_spec.rb
@@ -372,6 +377,7 @@ files:
 - spec/dummy/app/assets/javascripts/application.js
 - spec/dummy/app/assets/stylesheets/application.css
 - spec/dummy/app/controllers/application_controller.rb
+- spec/dummy/app/controllers/automatic_authentication_controller.rb
 - spec/dummy/app/controllers/concerns/.keep
 - spec/dummy/app/controllers/error_handling_with_chains_controller.rb
 - spec/dummy/app/controllers/extended_rollbar_controller.rb
@@ -383,8 +389,14 @@ files:
 - spec/dummy/app/models/concerns/.keep
 - spec/dummy/app/models/dummy_customer.rb
 - spec/dummy/app/models/dummy_record.rb
+- spec/dummy/app/models/dummy_record_with_auto_oauth_provider.rb
+- spec/dummy/app/models/dummy_record_with_multiple_oauth_providers1.rb
+- spec/dummy/app/models/dummy_record_with_multiple_oauth_providers2.rb
+- spec/dummy/app/models/dummy_record_with_multiple_providers_per_endpoint.rb
+- spec/dummy/app/models/dummy_record_with_oauth.rb
 - spec/dummy/app/models/dummy_user.rb
 - spec/dummy/app/models/providers/customer_system.rb
+- spec/dummy/app/models/providers/internal_services.rb
 - spec/dummy/app/views/error_handling_with_chains/error.html.erb
 - spec/dummy/app/views/error_handling_with_chains/show.html.erb
 - spec/dummy/app/views/form_for.html.erb
@@ -489,7 +501,7 @@ files:
 - spec/record/href_for_spec.rb
 - spec/record/ignore_errors_spec.rb
 - spec/record/immutable_chains_spec.rb
-- spec/record/includes_all_spec.rb
+- spec/record/includes_first_page_spec.rb
 - spec/record/includes_spec.rb
 - spec/record/includes_warning_spec.rb
 - spec/record/item_key_spec.rb
@@ -519,6 +531,7 @@ files:
 - spec/record/to_hash_spec.rb
 - spec/record/to_json_spec.rb
 - spec/record/tracing_spec.rb
+- spec/record/update_spec.rb
 - spec/record/where_chains_spec.rb
 - spec/record/where_spec.rb
 - spec/record/where_values_hash_spec.rb
@@ -559,6 +572,7 @@ specification_version: 4
 summary: 'REST services accelerator: Rails gem providing an easy, active-record-like
   interface for http (hypermedia) json services'
 test_files:
+- spec/auto_oauth_spec.rb
 - spec/autoloading_spec.rb
 - spec/collection/accessors_spec.rb
 - spec/collection/collection_items_spec.rb
@@ -591,6 +605,7 @@ test_files:
 - spec/dummy/app/assets/javascripts/application.js
 - spec/dummy/app/assets/stylesheets/application.css
 - spec/dummy/app/controllers/application_controller.rb
+- spec/dummy/app/controllers/automatic_authentication_controller.rb
 - spec/dummy/app/controllers/concerns/.keep
 - spec/dummy/app/controllers/error_handling_with_chains_controller.rb
 - spec/dummy/app/controllers/extended_rollbar_controller.rb
@@ -602,8 +617,14 @@ test_files:
 - spec/dummy/app/models/concerns/.keep
 - spec/dummy/app/models/dummy_customer.rb
 - spec/dummy/app/models/dummy_record.rb
+- spec/dummy/app/models/dummy_record_with_auto_oauth_provider.rb
+- spec/dummy/app/models/dummy_record_with_multiple_oauth_providers1.rb
+- spec/dummy/app/models/dummy_record_with_multiple_oauth_providers2.rb
+- spec/dummy/app/models/dummy_record_with_multiple_providers_per_endpoint.rb
+- spec/dummy/app/models/dummy_record_with_oauth.rb
 - spec/dummy/app/models/dummy_user.rb
 - spec/dummy/app/models/providers/customer_system.rb
+- spec/dummy/app/models/providers/internal_services.rb
 - spec/dummy/app/views/error_handling_with_chains/error.html.erb
 - spec/dummy/app/views/error_handling_with_chains/show.html.erb
 - spec/dummy/app/views/form_for.html.erb
@@ -708,7 +729,7 @@ test_files:
 - spec/record/href_for_spec.rb
 - spec/record/ignore_errors_spec.rb
 - spec/record/immutable_chains_spec.rb
-- spec/record/includes_all_spec.rb
+- spec/record/includes_first_page_spec.rb
 - spec/record/includes_spec.rb
 - spec/record/includes_warning_spec.rb
 - spec/record/item_key_spec.rb
@@ -738,6 +759,7 @@ test_files:
 - spec/record/to_hash_spec.rb
 - spec/record/to_json_spec.rb
 - spec/record/tracing_spec.rb
+- spec/record/update_spec.rb
 - spec/record/where_chains_spec.rb
 - spec/record/where_spec.rb
 - spec/record/where_values_hash_spec.rb

data/spec/record/includes_all_spec.rb

@@ -1,693 +0,0 @@
-# frozen_string_literal: true
-
-require 'rails_helper'
-
-describe LHS::Record do
-  context 'includes all' do
-    before do
-      class Customer < LHS::Record
-        endpoint 'http://datastore/customers/{id}'
-      end
-
-      class User < LHS::Record
-        configuration pagination_strategy: 'link'
-        endpoint 'http://datastore/users'
-      end
-    end
-
-    let(:amount_of_contracts) { 33 }
-    let(:amount_of_products) { 22 }
-    let(:amount_of_users_1st_page) { 10 }
-    let(:amount_of_users_2nd_page) { 3 }
-    let(:amount_of_users) { amount_of_users_1st_page + amount_of_users_2nd_page }
-
-    let!(:customer_request) do
-      stub_request(:get, 'http://datastore/customers/1')
-        .to_return(
-          body: {
-            contracts: { href: 'http://datastore/customers/1/contracts' },
-            users: { href: 'http://datastore/users?limit=10' }
-          }.to_json
-        )
-    end
-
-    #
-    # Contracts
-    #
-
-    let!(:contracts_request) do
-      stub_request(:get, "http://datastore/customers/1/contracts?limit=100")
-        .to_return(
-          body: {
-            items: 10.times.map do
-              {
-                products: { href: 'http://datastore/products' }
-              }
-            end,
-            limit: 10,
-            offset: 0,
-            total: amount_of_contracts
-          }.to_json
-        )
-    end
-
-    def additional_contracts_request(offset, amount)
-      stub_request(:get, "http://datastore/customers/1/contracts?limit=10&offset=#{offset}")
-        .to_return(
-          body: {
-            items: amount.times.map do
-              {
-                products: { href: 'http://datastore/products' }
-              }
-            end,
-            limit: 10,
-            offset: offset,
-            total: amount_of_contracts
-          }.to_json
-        )
-    end
-
-    let!(:contracts_request_page_2) do
-      additional_contracts_request(10, 10)
-    end
-
-    let!(:contracts_request_page_3) do
-      additional_contracts_request(20, 10)
-    end
-
-    let!(:contracts_request_page_4) do
-      additional_contracts_request(30, 3)
-    end
-
-    #
-    # Products
-    #
-
-    let!(:products_request) do
-      stub_request(:get, "http://datastore/products?limit=100")
-        .to_return(
-          body: {
-            items: 10.times.map do
-              { name: 'LBC' }
-            end,
-            limit: 10,
-            offset: 0,
-            total: amount_of_products
-          }.to_json
-        )
-    end
-
-    def additional_products_request(offset, amount)
-      stub_request(:get, "http://datastore/products?limit=10&offset=#{offset}")
-        .to_return(
-          body: {
-            items: amount.times.map do
-              { name: 'LBC' }
-            end,
-            limit: 10,
-            offset: offset,
-            total: amount_of_products
-          }.to_json
-        )
-    end
-
-    let!(:products_request_page_2) do
-      additional_products_request(10, 10)
-    end
-
-    let!(:products_request_page_3) do
-      additional_products_request(20, 2)
-    end
-
-    #
-    # Users
-    #
-
-    let!(:users_request) do
-      stub_request(:get, 'http://datastore/users?limit=10')
-        .to_return(
-          body: {
-            items: amount_of_users_1st_page.times.map do
-              { name: 'Hans Muster' }
-            end,
-            limit: 10,
-            next: { href: 'http://datastore/users?for_user_id=10&limit=10' }
-          }.to_json
-        )
-    end
-
-    let!(:users_request_page_2) do
-      stub_request(:get, 'http://datastore/users?for_user_id=10&limit=10')
-        .to_return(
-          body: {
-            items: amount_of_users_2nd_page.times.map do
-              { name: 'Lisa Müller' }
-            end,
-            limit: 10,
-            next: { href: 'http://datastore/users?for_user_id=13&limit=10' }
-          }.to_json
-        )
-    end
-
-    let!(:users_request_page_3) do
-      stub_request(:get, 'http://datastore/users?for_user_id=13&limit=10')
-        .to_return(
-          body: {
-            items: [],
-            limit: 10
-          }.to_json
-        )
-    end
-
-    it 'includes all linked business objects no matter pagination' do
-      customer = nil
-
-      expect(lambda do
-        customer = Customer
-          .includes_all(:users, contracts: :products)
-          .find(1)
-      end).to output(
-        %r{\[WARNING\] You are loading all pages from a resource paginated with links only. As this is performed sequentially, it can result in very poor performance! \(https://github.com/local-ch/lhs#pagination-strategy-link\).}
-      ).to_stderr
-
-      expect(customer.users.length).to eq amount_of_users
-      expect(customer.contracts.length).to eq amount_of_contracts
-      expect(customer.contracts.first.products.length).to eq amount_of_products
-      expect(customer_request).to have_been_requested.at_least_once
-      expect(contracts_request).to have_been_requested.at_least_once
-      expect(contracts_request_page_2).to have_been_requested.at_least_once
-      expect(contracts_request_page_3).to have_been_requested.at_least_once
-      expect(contracts_request_page_4).to have_been_requested.at_least_once
-      expect(products_request).to have_been_requested.at_least_once
-      expect(products_request_page_2).to have_been_requested.at_least_once
-      expect(products_request_page_3).to have_been_requested.at_least_once
-      expect(users_request).to have_been_requested.at_least_once
-      expect(users_request_page_2).to have_been_requested.at_least_once
-      expect(users_request_page_3).to have_been_requested.at_least_once
-    end
-
-    context 'links already contain pagination parameters' do
-      let!(:customer_request) do
-        stub_request(:get, 'http://datastore/customers/1')
-          .to_return(
-            body: {
-              contracts: { href: 'http://datastore/customers/1/contracts?limit=5&offset=0' }
-            }.to_json
-          )
-      end
-
-      let!(:contracts_request) do
-        stub_request(:get, "http://datastore/customers/1/contracts?limit=100")
-          .to_return(
-            body: {
-              items: 10.times.map do
-                {
-                  products: { href: 'http://datastore/products' }
-                }
-              end,
-              limit: 10,
-              offset: 0,
-              total: amount_of_contracts
-            }.to_json
-          )
-      end
-
-      it 'overwrites existing pagination paramters if they are already contained in a string' do
-        expect(LHC).to receive(:request)
-          .with(url: "http://datastore/customers/1").and_call_original
-
-        expect(LHC).to receive(:request)
-          .with(url: "http://datastore/customers/1/contracts",
-                all: true,
-                params: { limit: 100 }).and_call_original
-
-        expect(LHC).to receive(:request)
-          .with([{ url: "http://datastore/customers/1/contracts",
-                   all: true,
-                   params: { limit: 10, offset: 10 } },
-                 { url: "http://datastore/customers/1/contracts",
-                   all: true,
-                   params: { limit: 10, offset: 20 } },
-                 { url: "http://datastore/customers/1/contracts",
-                   all: true,
-                   params: { limit: 10, offset: 30 } }]).and_call_original
-
-        customer = Customer
-          .includes_all(:contracts)
-          .find(1)
-        expect(customer.contracts.length).to eq amount_of_contracts
-      end
-    end
-
-    context 'includes for an empty array' do
-      before do
-        class Contract < LHS::Record
-          endpoint 'http://datastore/contracts/{id}'
-        end
-        stub_request(:get, %r{http://datastore/contracts/\d})
-          .to_return(body: {
-            options: nested_resources
-          }.to_json)
-      end
-
-      context 'empty array' do
-        let(:nested_resources) { [] }
-
-        it 'includes_all in case of an empty array' do
-          expect(
-            -> { Contract.includes(:product).includes_all(:options).find(1) }
-          ).not_to raise_error
-          expect(
-            -> { Contract.includes(:product).includes_all(:options).find(1, 2) }
-          ).not_to raise_error
-        end
-      end
-
-      context 'weird array without hrefs' do
-        before do
-          stub_request(:get, "http://datastore/options/1?limit=100")
-            .to_return(body: { type: 'REACH_EXT' }.to_json)
-        end
-
-        let(:nested_resources) { [{ href: 'http://datastore/options/1' }, { type: 'E_COMMERCE' }] }
-
-        it 'includes_all in case of an unexpect objects within array' do
-          expect(
-            -> { Contract.includes(:product).includes_all(:options).find(1) }
-          ).not_to raise_error
-          expect(
-            -> { Contract.includes(:product).includes_all(:options).find(1, 2) }
-          ).not_to raise_error
-        end
-      end
-    end
-
-    context 'include a known/identifiable record' do
-      before do
-        class Contract < LHS::Record
-          endpoint 'http://datastore/contracts/{id}'
-        end
-
-        class Entry < LHS::Record
-          endpoint '{+datastore}/entry/v1/{id}.json'
-        end
-
-        LHC.config.placeholder(:datastore, 'http://datastore')
-      end
-
-      let!(:customer_request) do
-        stub_request(:get, %r{http://datastore/customers/\d+})
-          .to_return(
-            body: {
-              contracts: [{ href: 'http://datastore/contracts/1' }, { href: 'http://datastore/contracts/2' }]
-            }.to_json
-          )
-      end
-
-      let!(:contracts_request) do
-        stub_request(:get, %r{http://datastore/contracts/\d+})
-          .to_return(
-            body: {
-              type: 'contract',
-              entry: { href: 'http://datastore/entry/v1/1.json' }
-            }.to_json
-          )
-      end
-
-      let!(:entry_request) do
-        stub_request(:get, %r{http://datastore/entry/v1/\d+.json})
-          .to_return(
-            body: {
-              name: 'Casa Ferlin'
-            }.to_json
-          )
-      end
-
-      it 'loads included identifiable records without raising exceptions' do
-        customer = Customer.includes_all(contracts: :entry).find(1, 2).first
-        expect(customer.contracts.first.href).to eq 'http://datastore/contracts/1'
-        expect(customer.contracts.first.type).to eq 'contract'
-        expect(customer.contracts.first.entry.name).to eq 'Casa Ferlin'
-      end
-    end
-
-    context 'includes all for parallel loaded ids' do
-      before do
-        class Place < LHS::Record
-          endpoint 'http://datastore/places/{id}'
-        end
-      end
-
-      let!(:place_request_1) do
-        stub_request(:get, %r{http://datastore/places/1})
-          .to_return(
-            body: {
-              category_relations: [
-                { href: 'http://datastore/category_relations/1' },
-                { href: 'http://datastore/category_relations/2' }
-              ]
-            }.to_json
-          )
-      end
-
-      let!(:place_request_2) do
-        stub_request(:get, %r{http://datastore/places/2})
-          .to_return(
-            body: {
-              category_relations: []
-            }.to_json
-          )
-      end
-
-      let!(:place_request_3) do
-        stub_request(:get, %r{http://datastore/places/3})
-          .to_return(
-            body: {
-              category_relations: [
-                { href: 'http://datastore/category_relations/1' },
-                { href: 'http://datastore/category_relations/3' }
-              ]
-            }.to_json
-          )
-      end
-
-      let!(:category_relation_request_1) do
-        stub_request(:get, %r{http://datastore/category_relations/1})
-          .to_return(
-            body: {
-              name: "Category 1"
-            }.to_json
-          )
-      end
-
-      let!(:category_relation_request_2) do
-        stub_request(:get, %r{http://datastore/category_relations/2})
-          .to_return(
-            body: {
-              name: "Category 2"
-            }.to_json
-          )
-      end
-
-      let!(:category_relation_request_3) do
-        stub_request(:get, %r{http://datastore/category_relations/3})
-          .to_return(
-            body: {
-              name: "Category 3"
-            }.to_json
-          )
-      end
-
-      let(:category_name) { 'Category Relation' }
-
-      it 'requests places in parallel and includes category relation' do
-        places = Place.includes_all(:category_relations).find(1, 2, 3)
-        expect(places[0].category_relations[0].name).to eq 'Category 1'
-        expect(places[0].category_relations[1].name).to eq 'Category 2'
-        expect(places[2].category_relations[0].name).to eq 'Category 1'
-        expect(places[2].category_relations[1].name).to eq 'Category 3'
-      end
-    end
-  end
-
-  context 'Linked resources' do
-    before do
-      stub_request(:get, 'http://datastore/places/1/contracts?offset=0&limit=10')
-        .to_return(
-          body: {
-            href:  "http://datastore/v2/places/1/contracts?offset=0&limit=10",
-            items: [{ href: "http://datastore/v2/contracts/1" }],
-            offset: 0,
-            limit: 10,
-            total: 10
-          }.to_json
-        )
-
-      stub_request(:get, "http://datastore/v2/contracts/1")
-        .to_return(
-          body: {
-            customer: { name: 'Swisscom Directories AG' }
-          }.to_json
-        )
-
-      stub_request(:get, 'http://datastore/places/1?limit=1')
-        .to_return(
-          body: { href: 'http://datastore/places/1', contracts: { href: 'http://datastore/places/1/contracts?offset=0&limit=10' } }.to_json
-        )
-
-      class Place < LHS::Record
-        endpoint 'http://datastore/places/{id}'
-      end
-
-      class Contract < LHS::Record
-        endpoint 'http://datastore/places/{place_id}/contracts'
-      end
-    end
-
-    it 'does not use the root record endpoints when including nested records' do
-      place = Place
-        .includes_all(:contracts)
-        .find_by(id: 1)
-      expect(place.contracts.first.customer.name).to eq 'Swisscom Directories AG'
-    end
-  end
-
-  context 'nested includes_all' do
-    context 'with optional children' do
-
-      let(:favorites_request_stub) do
-        stub_request(:get, %r{http://datastore/favorites})
-          .to_return(
-            body: {
-              items: [{
-                href: "http://datastore/favorites/1",
-                place: {
-                  href: "http://datastore/places/1"
-                }
-              }, {
-                href: "http://datastore/favorite/2",
-                place: {
-                  href: "http://datastore/places/2"
-                }
-              }, {
-                href: "http://datastore/favorite/3",
-                place: {
-                  href: "http://datastore/places/3"
-                }
-              }],
-              total: 3,
-              offset: 0,
-              limit: 100
-            }.to_json
-          )
-      end
-
-      let(:place1_request_stub) do
-        stub_request(:get, %r{http://datastore/places/1})
-          .to_return(
-            body: {
-              href: "http://datastore/places/1",
-              name: 'Place 1',
-              contracts: {
-                href: "http://datastore/places/1/contracts"
-              }
-            }.to_json
-          )
-      end
-
-      let(:place2_request_stub) do
-        stub_request(:get, %r{http://datastore/places/2})
-          .to_return(
-            body: {
-              href: "http://datastore/places/2",
-              name: 'Place 2'
-            }.to_json
-          )
-      end
-
-      let(:place3_request_stub) do
-        stub_request(:get, %r{http://datastore/places/3})
-          .to_return(
-            body: {
-              href: "http://datastore/places/3",
-              name: 'Place 3',
-              contracts: {
-                href: "http://datastore/places/3/contracts"
-              }
-            }.to_json
-          )
-      end
-
-      let(:contracts_request_for_place1_stub) do
-        stub_request(:get, %r{http://datastore/places/1/contracts})
-          .to_return(
-            body: {
-              items: [{
-                href: "http://datastore/places/1/contracts/1",
-                name: 'Contract 1'
-              }],
-              total: 1,
-              offset: 0,
-              limit: 10
-            }.to_json
-          )
-      end
-
-      let(:contracts_request_for_place3_stub) do
-        stub_request(:get, %r{http://datastore/places/3/contracts})
-          .to_return(
-            body: {
-              items: [{
-                href: "http://datastore/places/3/contracts/1",
-                name: 'Contract 3'
-              }],
-              total: 1,
-              offset: 0,
-              limit: 10
-            }.to_json
-          )
-      end
-
-      before do
-        class Favorite < LHS::Record
-          endpoint 'http://datastore/favorites'
-        end
-
-        class Place < LHS::Record
-          endpoint 'http://datastore/places/{id}'
-        end
-
-        class Contract < LHS::Record
-          endpoint 'http://datastore/places/{place_id}/contracts'
-        end
-
-        favorites_request_stub
-        place1_request_stub
-        place2_request_stub
-        place3_request_stub
-        contracts_request_for_place1_stub
-        contracts_request_for_place3_stub
-      end
-
-      it 'includes nested objects when they exist' do
-        favorites = Favorite.includes(:place).includes_all(place: :contracts).all
-
-        expect(favorites.first.place.name).to eq('Place 1')
-        expect(favorites.first.place.contracts.first.name).to eq('Contract 1')
-      end
-
-      it 'does not include nested objects when they are not there' do
-        favorites = Favorite.includes(:place).includes_all(place: :contracts).all
-
-        expect(favorites[1].place.name).to eq('Place 2')
-        expect(favorites[1].place.contracts).to be(nil)
-      end
-
-      it 'does include and merges objects after nil objects in collections' do
-        favorites = Favorite.includes(:place).includes_all(place: :contracts).all
-
-        expect(favorites.last.place.name).to eq('Place 3')
-        expect(favorites.last.place.contracts.first.name).to eq('Contract 3')
-      end
-    end
-  end
-
-  context 'includes collection trough single item' do
-
-    before do
-      class Place < LHS::Record
-        endpoint 'https://places/{id}'
-      end
-
-      stub_request(:get, 'https://places/1')
-        .to_return(
-          body: {
-            customer: { href: 'https://customers/1' }
-          }.to_json
-        )
-
-      stub_request(:get, 'https://customers/1?limit=100')
-        .to_return(
-          body: {
-            addresses: { 'href': 'https://customer/1/addresses' }
-          }.to_json
-        )
-
-      stub_request(:get, 'https://customer/1/addresses?limit=100')
-        .to_return(
-          body: {
-            items: [
-              { city: 'Zurich', no: 1 },
-              { city: 'Zurich', no: 2 }
-            ],
-            total: 2
-          }.to_json
-        )
-    end
-
-    it 'includes a collection trough a single item without exceptions' do
-      place = Place
-        .includes_all(customer: :addresses)
-        .find(1)
-      expect(place.customer.addresses.map(&:no)).to eq [1, 2]
-    end
-  end
-
-  context 'does not fail including all linked resources' do
-
-    before do
-      class CustomerOnboardingToken < LHS::Record
-        endpoint 'https://token/{id}'
-      end
-
-      class Place < LHS::Record
-        endpoint 'https://places/{id}'
-      end
-
-      class AvailableAsset < LHS::Record
-        endpoint 'https://assets'
-      end
-
-      stub_request(:get, 'https://token/1')
-        .to_return(
-          body: {
-            places: [{ href: 'https://places/1' }]
-          }.to_json
-        )
-
-      stub_request(:get, 'https://places/1?limit=100')
-        .to_return(
-          body: {
-            available_assets: { 'href': 'https://assets?limit=10&offset=0' }
-          }.to_json
-        )
-
-      stub_request(:get, 'https://assets?limit=10&offset=0')
-        .to_return(
-          body: {
-            items: 10.times.map { { asset_code: 'CATEGORIES' } },
-            total: 17,
-            offset: 0,
-            limit: 10
-          }.to_json
-        )
-
-      stub_request(:get, 'https://assets?limit=10&offset=10')
-        .to_return(
-          body: {
-            items: 7.times.map { { asset_code: 'CATEGORIES' } },
-            total: 17,
-            offset: 0,
-            limit: 10
-          }.to_json
-        )
-    end
-
-    it 'includes a collection trough a single item without exceptions' do
-      token = CustomerOnboardingToken
-        .includes_all(places: :available_assets)
-        .find(1)
-      expect(token.places.first.available_assets.length).to eq 17
-    end
-  end
-end