duck_typer 0.6.0 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e7c4910b3357c23523997ed6cbb76cc1add4824af460fe8845390f1f69cfe2e6
-  data.tar.gz: 4aea61000506666b3ce649e08398247c9ab72c75826cc9e4819e91471547f8dd
+  metadata.gz: 9d83b2db8bd9f4f9286edacaeecaf978aed251b15c0295d697a529c542f4e5c8
+  data.tar.gz: 176b5e8a8b555749b3e6f56f7ef36225e32db086ca54f9085b0a0db2ef5f09c6
 SHA512:
-  metadata.gz: 48bcd0be970572a490e373064d3894bd174aaffc29b52a0c7b8beea030530b0661bde8221b01a0b681d3511478259cb7edfe858383def4a1e8f22f1afec36577
-  data.tar.gz: 923d8722ae7ac8fb7f86aa12292056014fb00f5328c2034d63ed8b3c87984a0cce8890a0983d48fb2148b7d9ff1eb68888079cbaac90d4a7a7ebf33c8b5d6156
+  metadata.gz: aef37fad60ebeb09be165d46ff2fb0cdcb2e0ec330d4a773c71b412d265fe0e6ed3de2a2ec2daec5f0a19fbae8b32fb66541c29f6c1705e9e4528199fe12063a
+  data.tar.gz: d9f172fd026f220574582025803bdd887eead27d97d8b37a71f11cb6ee046508b1dc7e1efda88a1727ba60161a80fa47d0199f046a055263ee6fcd1cadc2cd7e

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.6.1] - 2026-05-20
+
+### Added
+- `assert_canonical_duck_type_match` Minitest alias for
+  `assert_canonical_interface_match`
+- `implement_canonical_duck_type` RSpec alias for
+  `implement_canonical_interface`
+- `canonical:` keyword support in the shared example
+  (`it_behaves_like "an interface"`)
+
 ## [0.6.0] - 2026-05-15
 
 ### Added

data/README.md

@@ -240,6 +240,9 @@ assert_canonical_interface_match PaymentGateway, [StripeProcessor, PaypalProcess
   name: "PaymentProcessor"
 ```
 
+> If you prefer duck typing terminology,
+> `assert_canonical_duck_type_match` is available as an alias.
+
 ### RSpec
 
 Require the RSpec integration in your `spec_helper.rb`:
@@ -354,6 +357,9 @@ expect([StripeProcessor, PaypalProcessor])
 When multiple classes fail, the failure message reports all of them
 at once.
 
+> If you prefer duck typing terminology,
+> `implement_canonical_duck_type` is available as an alias.
+
 #### Shared example
 
 If you prefer shared examples, register one in `spec_helper.rb`
@@ -398,6 +404,25 @@ To check all classes in a module, pass it with `namespace:`:
 it_behaves_like "an interface", namespace: Payments
 ```
 
+To check against a canonical reference class, pass
+`canonical:`:
+
+```ruby
+it_behaves_like "an interface", [
+  StripeProcessor,
+  PaypalProcessor,
+  BraintreeProcessor
+], canonical: PaymentGateway
+```
+
+To combine `canonical:` with `namespace:`:
+
+```ruby
+it_behaves_like "an interface",
+  canonical: PaymentGateway,
+  namespace: Payments
+```
+
 ## Limitations
 
 By default, Duck Typer checks the **structure** of public method

data/lib/duck_typer/minitest.rb

@@ -22,5 +22,8 @@ module DuckTyper
       result = checker.call
       assert result.match?, result.failure_message
     end
+
+    alias_method :assert_canonical_duck_type_match,
+      :assert_canonical_interface_match
   end
 end

data/lib/duck_typer/rspec.rb

@@ -19,7 +19,8 @@ RSpec::Matchers.define :have_matching_interfaces do |name: nil, type: :instance_
   end
 end
 
-RSpec::Matchers.alias_matcher :have_matching_duck_types, :have_matching_interfaces
+RSpec::Matchers.alias_matcher :have_matching_duck_types,
+  :have_matching_interfaces
 
 RSpec::Matchers.define :implement_canonical_interface do |canonical, name: nil, type: :instance_methods, methods: nil, strict: false|
   match do |actual|
@@ -38,25 +39,41 @@ RSpec::Matchers.define :implement_canonical_interface do |canonical, name: nil,
   end
 end
 
+RSpec::Matchers.alias_matcher :implement_canonical_duck_type,
+  :implement_canonical_interface
+
 module DuckTyper
   module RSpec
     def self.define_shared_example(name = "an interface")
-      ::RSpec.shared_examples name do |*args, namespace: nil, name: nil, type: :instance_methods, methods: nil, strict: false|
+      ::RSpec.shared_examples name do |*args, canonical: nil, namespace: nil, name: nil, type: :instance_methods, methods: nil, strict: false|
         objects = namespace ? nil : args.first
 
-        # We intentionally avoid reusing the have_matching_interfaces matcher
-        # here. Since this shared example is defined in gem code, RSpec filters
-        # it from its backtrace, causing the Failure/Error: line to show an
-        # internal RSpec constant instead of useful context.
-        it "has compatible interfaces" do
-          checker = DuckTyper::BulkInterfaceChecker
-            .new(objects, namespace:, type:, methods:, strict:, name:)
+        # We intentionally avoid reusing the matchers here. Since this shared
+        # example is defined in gem code, RSpec filters it from its backtrace,
+        # causing the Failure/Error: line to show an internal RSpec constant
+        # instead of useful context.
+        if canonical
+          it "implements the canonical interface" do
+            checker = DuckTyper::CanonicalInterfaceChecker
+              .new(objects, canonical:, namespace:, type:, methods:, strict:, name:)
+
+            result = checker.call
+
+            if !result.match?
+              raise ::RSpec::Expectations::ExpectationNotMetError, result.failure_message
+            end
+          end
+        else
+          it "has compatible interfaces" do
+            checker = DuckTyper::BulkInterfaceChecker
+              .new(objects, namespace:, type:, methods:, strict:, name:)
 
-          failures = checker.call.reject(&:match?)
+            failures = checker.call.reject(&:match?)
 
-          if failures.any?
-            message = failures.map(&:failure_message).join("\n")
-            raise ::RSpec::Expectations::ExpectationNotMetError, message
+            if failures.any?
+              message = failures.map(&:failure_message).join("\n")
+              raise ::RSpec::Expectations::ExpectationNotMetError, message
+            end
           end
         end
       end

data/lib/duck_typer/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DuckTyper
-  VERSION = "0.6.0"
+  VERSION = "0.6.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: duck_typer
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.6.1
 platform: ruby
 authors:
 - Thiago A. Silva
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-15 00:00:00.000000000 Z
+date: 2026-05-20 00:00:00.000000000 Z
 dependencies: []
 description:
 email: