strict 2.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7a4d9b33782e029a5bdaf97e300a83ccb21fc76629e92d9dbbf3d12c373eaa4
-  data.tar.gz: 715e362a7bb394c4f18d6eb46d828d5c5dbfe0090f85ed971a89369981254532
+  metadata.gz: f2cf2282196d21b0f929b9339bd7e93f6f97ce80796c47b29330519241d2ae11
+  data.tar.gz: 63ee491ee31552fa9b6449cedd24b2754f83222e362cf9cc4c0fca51cd367426
 SHA512:
-  metadata.gz: 696e79a02adafa97c27575b5b3ac787aeb4923d07753d3149efbdf283a5357a0c74ccea46367cd6d0d8d49996e45e668418c203652738aa2a0efcc5ec24dbdf0
-  data.tar.gz: 751a0ebdc18322f456ebc834ec7a215dc28b0de66dc010be82bcb03a5cbfdfa4c160a66110d0b60e22c056cfe34d0827b2e13533ee580c1761987c570939a4be
+  metadata.gz: f8cb4a343d08ef27c01ffa3d8bc02da8657cdcd98663e235e3ffe79598c0de55a9dc571b09524b6d2da31bb9cdc87e67494395eb71caff53bc90198d99d55699
+  data.tar.gz: e22d700e910206b31514c3661cbac6f3df04001082e4307922cd2f0203eb3e5f0b29129c1d2aab74bc03d68f561cd38a4114fd94f759a9197f0f3808b7b6d132

data/API.md

@@ -116,10 +116,12 @@ There is no default discriminator. A union can declare zero or one `attributes`
 
 A variant name must be a lower snake-case string or symbol, and Strict generates its PascalCase nested subclass. By default, the discriminator tag is the name's corresponding symbol. The optional `tag:` can assign a different string or symbol. For example, `variant :requires_action, tag: "action-required"` generates `PaymentResult::RequiresAction < PaymentResult` with the tag `"action-required"`.
 
+Each variant name also generates a class-level convenience constructor and an instance interrogation method. `PaymentResult.authorized(...)` calls `PaymentResult::Authorized.new(...)`. Every union member responds to `authorized?`, which is true for authorized members and false for other variants. These methods use the variant name even when the discriminator tag differs.
+
 The variant block configures the generated subclass. It can include modules, define methods, and contain zero or one `attributes` block. Strict combines the discriminator, shared union attributes, and variant attributes in that order. The discriminator is an implicit first attribute with a fixed default value:
 
 ```ruby
-PaymentResult::Authorized.new(
+PaymentResult.authorized(
   request_id: "request_123",
   authorization_id: "auth_123",
   amount_in_cents: 1_000
@@ -127,7 +129,7 @@ PaymentResult::Authorized.new(
 # => { status: "payment.authorized", request_id: "request_123", authorization_id: "auth_123", amount_in_cents: 1_000 }
 ```
 
-Variants therefore use the documented `Strict::Value` behavior for initialization, validation, coercion, defaults, copying, equality, hashing, conversion, inspection, pattern matching, and declaration errors. A variant attribute cannot duplicate or share a backing instance variable with the discriminator or a shared union attribute, and generated readers cannot collide with methods defined in the variant block. The union base cannot be instantiated directly.
+Variants therefore use the documented `Strict::Value` behavior for initialization, validation, coercion, defaults, copying, equality, hashing, conversion, inspection, pattern matching, and declaration errors. A variant attribute cannot duplicate or share a backing instance variable with the discriminator or a shared union attribute, and generated readers cannot collide with methods defined in the variant block. Generated convenience constructors and interrogation methods cannot collide with existing class or instance methods or with variant behavior. The union base cannot be instantiated directly.
 
 `PaymentResult === value` is true only when `value` has the exact class of a registered variant. Generated variant classes retain normal Ruby class matching, including matching instances of their subclasses. Union and variant inheritance are outside the compatibility boundary.
 
@@ -147,7 +149,7 @@ payment_result PaymentResult
 strict_payment_result PaymentResult, coerce: false
 ```
 
-Declaring a discriminator more than once, declaring equivalent duplicate string or symbol tags, using an invalid variant name or tag, replacing an existing generated constant, declaring multiple union or variant attribute blocks, declaring union attributes after a variant, or redeclaring the discriminator raises `ArgumentError`. Declaration return values, generated-class reflection details, and the exact text of declaration and coercion errors are outside the compatibility boundary.
+Declaring a discriminator more than once, declaring equivalent duplicate string or symbol tags, using an invalid or conflicting variant name or tag, replacing an existing generated constant, declaring multiple union or variant attribute blocks, declaring union attributes after a variant, or redeclaring the discriminator raises `ArgumentError`. Declaration return values, generated-class reflection details, and the exact text of declaration and coercion errors are outside the compatibility boundary.
 
 ### Signed methods
 

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [2.1.0] - 2026-08-21
+
+### Added
+
+- Add class-level convenience constructors and instance interrogation methods for every `Strict::Union` variant.
+
 ## [2.0.0] - 2026-08-20
 
 ### Added
@@ -102,7 +108,8 @@ The equal-weight geometric mean of the eight after/before timing ratios is 0.57,
 
 - Start initial development.
 
-[Unreleased]: https://github.com/kylekthompson/strict/compare/v2.0.0...HEAD
+[Unreleased]: https://github.com/kylekthompson/strict/compare/v2.1.0...HEAD
+[2.1.0]: https://github.com/kylekthompson/strict/compare/v2.0.0...v2.1.0
 [2.0.0]: https://github.com/kylekthompson/strict/compare/v1.5.0...v2.0.0
 [1.5.0]: https://github.com/kylekthompson/strict/compare/v1.4.0...v1.5.0
 [1.4.0]: https://github.com/kylekthompson/strict/compare/v1.3.1...v1.4.0

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    strict (2.0.0)
+    strict (2.1.0)
       zeitwerk (~> 2.6)
 
 GEM

data/README.md

@@ -103,7 +103,7 @@ class PaymentResult
   end
 end
 
-authorized = PaymentResult::Authorized.new(
+authorized = PaymentResult.authorized(
   request_id: "request_123",
   authorization_id: "auth_123",
   amount_in_cents: 1_000
@@ -111,6 +111,12 @@ authorized = PaymentResult::Authorized.new(
 authorized.to_h
 # => { status: "payment.authorized", request_id: "request_123", authorization_id: "auth_123", amount_in_cents: 1_000 }
 
+authorized.authorized?
+# => true
+
+authorized.declined?
+# => false
+
 authorized.successful?
 # => true
 

data/lib/strict/union.rb

@@ -43,6 +43,7 @@ module Strict
         tag_key = strict_union_tag_key(tag)
         constant_name = strict_union_validate_variant!(name, tag, tag_key)
         variant_class = strict_union_build_variant(discriminator, name, tag, definition)
+        strict_union_validate_interrogation_method!(name, variant_class)
         strict_union_register_variant(name, tag, tag_key, constant_name, variant_class)
       end
 
@@ -66,17 +67,50 @@ module Strict
         raise ArgumentError, "tag #{tag.inspect} already declared for #{self}" if @strict_union_variants.key?(tag_key)
         raise ArgumentError, "constant #{constant_name} is already defined for #{self}" if
           const_defined?(constant_name, false)
+        raise ArgumentError, "variant convenience method #{name.inspect} already exists for #{self}" if
+          strict_union_method_defined?(singleton_class, name)
 
         constant_name
       end
 
+      def strict_union_validate_interrogation_method!(name, variant_class)
+        method_name = strict_union_interrogation_method(name)
+        owners = [self, *@strict_union_variant_names.values, variant_class]
+        conflicting_owner = owners.find { |owner| strict_union_method_defined?(owner, method_name) }
+        raise ArgumentError, "interrogation method #{method_name.inspect} already exists for #{conflicting_owner}" if
+          conflicting_owner
+
+        strict_union_validate_existing_interrogation_methods!(variant_class)
+      end
+
+      def strict_union_validate_existing_interrogation_methods!(variant_class)
+        @strict_union_variant_names.each_key do |variant_name|
+          existing_method = strict_union_interrogation_method(variant_name)
+          next if variant_class.instance_method(existing_method).owner.equal?(self)
+
+          raise ArgumentError, "interrogation method #{existing_method.inspect} already exists for #{variant_class}"
+        end
+      end
+
       def strict_union_register_variant(name, tag, tag_key, constant_name, variant_class)
         const_set(constant_name, variant_class)
         @strict_union_variant_names[name] = variant_class
         @strict_union_variants[tag_key] = Variant.new(tag:, variant_class:)
+        define_singleton_method(name) { |**attributes| variant_class.new(**attributes) }
+        define_method(strict_union_interrogation_method(name)) { variant_class === self }
         variant_class
       end
 
+      def strict_union_interrogation_method(name)
+        :"#{name}?"
+      end
+
+      def strict_union_method_defined?(owner, name)
+        owner.public_method_defined?(name) ||
+          owner.protected_method_defined?(name) ||
+          owner.private_method_defined?(name)
+      end
+
       def strict_union_discriminator!
         @strict_union_discriminator ||
           raise(ArgumentError, "declare a discriminator before variants for #{self}")

data/lib/strict/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Strict
-  VERSION = "2.0.0"
+  VERSION = "2.1.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: strict
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.1.0
 platform: ruby
 authors:
 - Kyle Thompson