bootic_client 0.0.30 → 0.0.32

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 88fee920f8b9082a62647609e19ca3492a3eba9028c581ce6df09a2560335b34
-  data.tar.gz: 05b7c8e729b035f486252716392c74563ce0a0cb513a19a90b49309d135c8d6d
+  metadata.gz: 6eb630196e916b01799d6ff1079895e608073f9cf141c2fb66496c08494f2825
+  data.tar.gz: f84b45a3e467863a71f21e8560985302197ca3e7b1e1598945fb9502ce10cd51
 SHA512:
-  metadata.gz: b205b02d5020df2a8dbb2d104a9b2110e2ae5fd39e48961214b85fc7ef562f81169d3b9021529324dd8d873a94fe58a9195a1113994a9d655d50f53a47ce421d
-  data.tar.gz: 193493b1e377c8db82e8adb6744186892d0ff6d02e31b3ed1dac1e21c9d4e18dea04dc155af082fc8064f5deb6d143e46ea4730fa6e6a7163bdbb51ba4230551
+  metadata.gz: a8ce6a6af2642f5d73122e7c7097b57efaf0594509ca8119e0d4c62606b60b094aa4debeb070b1ea42a9d04007fc7e66f56c27ee517a0a2d854c114893b9fd11
+  data.tar.gz: f5979b3ca50b880006d29ab0555d2fb5ab063f8805e1415785d64cdeb729b7514d3ab833c2d429075206acf45cb8d3db4d92cbe8e5893bb151c6aacf4b0a7f1a

data/README.md

@@ -320,6 +320,40 @@ messaging_api_root = client.from_url("https://some.api.com")
 messaging_api.do_something(foo: "bar") # etc
 ```
 
+## Testing
+
+# What
+
+This library provides methods to simplify testing. For example, to stub a chain of links you can simply do:
+
+```rb
+BooticClient.stub_chain('root.shops.first').and_return_data({
+  'name' => 'Foo bar'
+})
+
+client = BooticClient.client(:authorized, access_token: 'abc')
+shop = client.root.shops.first
+expect(shop).to be_a BooticClient::Entity
+expect(shop.name).to eq 'Foo bar'
+```
+
+You can also stub links that requires arguments, like this:
+
+```rb
+BooticClient.stub_chain('root.shops', foo: 1).and_return_data({
+  'name' => 'Foo 1'
+})
+BooticClient.stub_chain('root.shops', foo: 1, bar: { hello: 123 }).and_return_data({
+  'name' => 'Foo 2'
+})
+
+client = BooticClient.client(:authorized, access_token: 'abc')
+expect(client.root.shops(foo: 1).name).to eq 'Foo 1'
+
+# arg order doesn't matter
+expect(client.root.shops(bar: { hello: 123 }, foo: 2).name).to eq 'Foo 2'
+```
+
 ## Contributing
 
 1. Fork it

data/bootic_client.gemspec

@@ -17,7 +17,8 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-  spec.add_dependency "faraday", '>= 0.15'
+  spec.add_dependency "faraday", '~> 2.2'
+  spec.add_dependency 'faraday-net_http_persistent', '~> 2.0'
   spec.add_dependency "uri_template", '~> 0.7'
   spec.add_dependency "faraday-http-cache", '~> 2'
   spec.add_dependency "net-http-persistent", '~> 4'

data/lib/bootic_client/client.rb

@@ -4,7 +4,7 @@ require 'base64'
 require 'faraday'
 require 'faraday-http-cache'
 require "bootic_client/errors"
-require 'faraday/adapter/net_http_persistent'
+require 'faraday/net_http_persistent'
 
 module BooticClient
 

data/lib/bootic_client/entity.rb

@@ -15,9 +15,14 @@ module BooticClient
 
       Enumerator.new do |yielder|
         loop do
-          page.each{|item| yielder.yield item }
+          page.each { |item| yielder.yield(item) }
           raise StopIteration unless page.has_rel?(:next)
           page = page.next
+
+          if page.has?(:errors) # && page.errors.first.messages.first['cannot be higher'] # reached last page
+            yielder.yield(nil, page.errors) # yield a nil value so caller can stop gracefully
+            raise StopIteration
+          end
         end
       end
     end

data/lib/bootic_client/strategies/basic_auth.rb

@@ -19,7 +19,7 @@ module BooticClient
 
       def client
         @client ||= Client.new(options) do |c|
-          c.request :basic_auth, options[:username], options[:password]
+          c.request :authorization, :basic, options[:username], options[:password]
         end
       end
     end

data/lib/bootic_client/stubbing.rb

@@ -0,0 +1,118 @@
+module BooticClient
+  module Stubbing
+    MissingStubError = Class.new(StandardError)
+
+    module Stubber
+      def from_hash(h)
+        self
+      end
+
+      def stub_chain(method_path, opts = {})
+        meths = method_path.split('.')
+        c = 0
+        opts = stringify_keys(opts)
+
+        meths.reduce(self) do |stub, method_name|
+          c += 1
+          a = c == meths.size ? opts : {}
+          stub.stub(method_name, a)
+        end
+      end
+
+      def stub(method_name, opts = {})
+        key = stub_key(method_name, opts)
+        if st = stubs[key]
+          st.stub(method_name, opts)
+          st
+        else
+          stubs[key] = Stub.new(method_name, opts)
+        end
+      end
+
+      def method_missing(method_name, *args, &block)
+        opts = stringify_keys(args.first)
+        if stub = stubs[stub_key(method_name, opts)]
+          stub.returns? ? stub.returns : stub
+        else
+          raise MissingStubError, "No method stubbed for '#{method_name}' with options #{opts.inspect}"
+        end
+      end
+
+      def respond_to_missing?(method_name, include_private = false)
+        stubs.keys.any?{|k|
+          k.to_s =~ /^#{method_name.to_s}/
+        }
+      end
+
+      private
+      def stub_key(method_name, opts)
+        [method_name.to_s, options_key(opts || {})].join('_')
+      end
+
+      def options_key(opts)
+        # sort keys
+        keys = opts.keys.sort
+        hash = keys.each_with_object({}) do |key, h|
+          value = if opts[key].is_a?(Hash)
+            options_key(opts[key])
+          else
+            opts[key].to_s
+          end
+
+          h[key] = value
+        end
+
+        hash.inspect
+      end
+
+      def stringify_keys(hash)
+        return hash unless hash.is_a?(Hash)
+
+        hash.each_with_object({}) do |(k, v), h|
+          h[k.to_s] = stringify_keys(v)
+        end
+      end
+    end
+
+    class StubRoot
+      include Stubber
+
+      def initialize
+        @stubs = {}
+      end
+
+      private
+      attr_reader :stubs
+    end
+
+    class Stub
+      include Stubber
+
+      def initialize(method_name = '', opts = {})
+        @method_name, @opts = method_name, opts
+        @return_data = nil
+        @stubs = {}
+      end
+
+      def and_return_data(data)
+        @return_data = data
+        self
+      end
+
+      def returns?
+        !!@return_data
+      end
+
+      def returns
+        if @return_data.is_a?(Array)
+          @return_data.map{|d| BooticClient::Entity.new(d, nil)}
+        else
+          BooticClient::Entity.new(@return_data || {}, nil)
+        end
+      end
+
+      private
+      attr_reader :stubs
+    end
+  end
+end

data/lib/bootic_client/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BooticClient
-  VERSION = "0.0.30".freeze
+  VERSION = "0.0.32".freeze
 end

data/lib/bootic_client.rb

@@ -12,6 +12,7 @@ module BooticClient
     end
 
     def client(strategy_name, client_opts = {}, &on_new_token)
+      return @stubber if @stubber
       opts = client_opts.dup
       opts[:logging] = configuration.logging
       opts[:logger] = configuration.logger if configuration.logging
@@ -21,6 +22,10 @@ module BooticClient
       strategies.fetch(strategy_name.to_sym).new configuration, opts, &on_new_token
     end
 
+    def auth_host
+      @auth_host || AUTH_HOST
+    end
+
     def configure(&block)
       yield configuration
     end
@@ -28,5 +33,18 @@ module BooticClient
     def configuration
       @configuration ||= Configuration.new
     end
+
+    def stub!
+      require "bootic_client/stubbing"
+      @stubber = Stubbing::StubRoot.new
+    end
+
+    def stub_chain(method_chain, opts = {})
+      @stubber.stub_chain(method_chain, opts)
+    end
+
+    def unstub!
+      @stubber = nil
+    end
   end
 end

data/spec/entity_spec.rb

@@ -232,6 +232,34 @@ describe BooticClient::Entity do
         titles = results.map(&:title)
         expect(titles).to match_array(['iPhone 4', 'iPhone 5', 'Item 3', 'Item 4'])
       end
+
+      it 'handles errors gracefully' do
+        error_data = {
+          "_embedded" => {
+            'errors' => [
+              { field: 'foo', messages: ['Ugly error'] }
+            ]
+          }
+        }
+
+        error_page = BooticClient::Entity.new(error_data, client)
+        expect(client).to receive(:request_and_wrap).with(:get, '/foo?page=2', {}).and_return(error_page)
+        expect(client).to_not receive(:request_and_wrap).with(:get, '/foo?page=3', {})
+
+        valid = []
+        errors = nil
+        entity.full_set.each do |item, errors|
+          if item
+            valid.push(item)
+          else
+            expect(valid.count).to eq(2)
+            expect(errors.first.to_hash).to eq({ field: 'foo', messages: ['Ugly error']})
+          end
+        end
+
+        titles = valid.map(&:title)
+        expect(titles).to match_array(['iPhone 4', 'iPhone 5'])
+      end
     end
   end
 

data/spec/stubbing_spec.rb

@@ -0,0 +1,96 @@
+require 'spec_helper'
+
+describe "stubbing" do
+  before do
+    BooticClient.stub!
+  end
+
+  after do
+    BooticClient.unstub!
+  end
+
+  it "stubs method chains and returns entities" do
+    BooticClient.stub_chain('root.shops.first').and_return_data({
+      'name' => 'Foo bar'
+    })
+
+    client = BooticClient.client(:authorized, access_token: 'abc')
+    shop = client.root.shops.first
+    expect(shop).to be_a BooticClient::Entity
+    expect(shop.name).to eq 'Foo bar'
+  end
+
+  it "stubs method chains and returns arrays of entities" do
+    BooticClient.stub_chain('root.shops').and_return_data([
+      {'name' => 'Foo bar'},
+      {'name' => 'Bar foo'}
+    ])
+
+    client = BooticClient.client(:authorized, access_token: 'abc')
+    shops = client.root.shops
+    expect(shops.first).to be_a BooticClient::Entity
+    expect(shops.last).to be_a BooticClient::Entity
+    expect(shops.first.name).to eq 'Foo bar'
+  end
+
+  it 'can be chained further' do
+    BooticClient.stub_chain('foo.bar')
+    client = BooticClient.client(:authorized, access_token: 'abc')
+
+    stub = client.foo.bar
+    stub.stub_chain('another.stubz').and_return_data({
+      'id' => 123
+    })
+
+    expect(stub.another.stubz.id).to eq 123
+  end
+
+  it 'stubs depending on arguments' do
+    BooticClient.stub_chain('root.shops', foo: 0).and_return_data({
+      'name' => 'Foo 0'
+    })
+    BooticClient.stub_chain('root.shops', foo: 1).and_return_data({
+      'name' => 'Foo 1'
+    })
+    BooticClient.stub_chain('root.shops', foo: 2, bar: {yup: 'yiss'}).and_return_data({
+      'name' => 'Foo 2'
+    })
+
+    client = BooticClient.client(:authorized, access_token: 'abc')
+
+    expect(client.root.shops(foo: 0).name).to eq 'Foo 0'
+    expect(client.root.shops(foo: 1).name).to eq 'Foo 1'
+    expect(client.root.shops(foo: 2, bar: {yup: 'yiss'}).name).to eq 'Foo 2'
+    # arg order shouldn't matter
+    expect(client.root.shops(bar: {yup: 'yiss'}, foo: 2).name).to eq 'Foo 2'
+
+    expect {
+      client.root.shops(foo: 2, bar: {yup: 'nope'})
+    }.to raise_error BooticClient::Stubbing::MissingStubError
+  end
+
+  it "stubs multiple chains with arguments" do
+    BooticClient.stub_chain('one.two', arg: 1).stub_chain('three.four').and_return_data('name' => 'example 1')
+    BooticClient.stub_chain('one.two', arg: 2).stub_chain('three.four').and_return_data('name' => 'example 2')
+
+    client = BooticClient.client(:authorized, access_token: 'abc')
+
+    expect(client.one.two(arg: 1).three.four.name).to eq 'example 1'
+    expect(client.one.two(arg: 2).three.four.name).to eq 'example 2'
+  end
+
+  it "treats symbol and string keys the same" do
+    BooticClient.stub_chain('one.two', arg: 1).and_return_data('name' => 'example 1')
+    client = BooticClient.client(:authorized, access_token: 'abc')
+
+    expect(client.one.two("arg" => 1).name).to eq 'example 1'
+  end
+
+  it "raises known exception if no stub found" do
+    client = BooticClient.client(:authorized, access_token: 'abc')
+
+    expect{
+      client.nope
+    }.to raise_error BooticClient::Stubbing::MissingStubError
+  end
+end

metadata

@@ -1,29 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: bootic_client
 version: !ruby/object:Gem::Version
-  version: 0.0.30
+  version: 0.0.32
 platform: ruby
 authors:
 - Ismael Celis
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-05-05 00:00:00.000000000 Z
+date: 2023-11-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.15'
+        version: '2.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+- !ruby/object:Gem::Dependency
+  name: faraday-net_http_persistent
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.15'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: uri_template
   requirement: !ruby/object:Gem::Requirement
@@ -167,6 +181,7 @@ files:
 - lib/bootic_client/strategies/client_credentials.rb
 - lib/bootic_client/strategies/oauth2_strategy.rb
 - lib/bootic_client/strategies/strategy.rb
+- lib/bootic_client/stubbing.rb
 - lib/bootic_client/version.rb
 - lib/bootic_client/whiny_uri.rb
 - spec/authorized_strategy_spec.rb
@@ -184,12 +199,13 @@ files:
 - spec/safe_cache_serializer_spec.rb
 - spec/spec_helper.rb
 - spec/strategy_spec.rb
+- spec/stubbing_spec.rb
 - spec/whiny_uri_spec.rb
 homepage: https://developers.bootic.net
 licenses:
 - MIT
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -204,8 +220,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key:
+rubygems_version: 3.4.6
+signing_key: 
 specification_version: 4
 summary: Official Ruby client for the Bootic API
 test_files:
@@ -224,4 +240,5 @@ test_files:
 - spec/safe_cache_serializer_spec.rb
 - spec/spec_helper.rb
 - spec/strategy_spec.rb
+- spec/stubbing_spec.rb
 - spec/whiny_uri_spec.rb