philiprehberger-struct_kit 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a50ed52bad42906d2452f7e16fa3713287f263582554a7f8d67ab404a47d65e
-  data.tar.gz: a4e55b469fc1e50ca7388f66b309f69d3046a2100b58c50fb88a06c67150799e
+  metadata.gz: 68b7bec33faa5c7e50b69e236a0787c370b8303e8024ea4d2a26f6751e3e5850
+  data.tar.gz: c04c4c2eea2bbc45a7d12cf8e6b3560b1f75699917c105378e3b67f4c5a44e42
 SHA512:
-  metadata.gz: 92f45e162b4c8e851bf33345ecc19bdbfd37a171174dd2a76351e98462bb0f44052b079a12651dd935aa46729e7368755c8b0926060e6c51af3411bd8907ed43
-  data.tar.gz: 6ea2cb19cc04d6888b9aa31567cbcb3a22105f95138090b3b7308e4d4ed96e63fd082a1530de83f88bb440331fedaaa69b3941b563cd3d73068682f1cbb79549
+  metadata.gz: baafc26c5ed314e8968fffe950acfdec20de931582a47002ccb26bcba7906caf11add73365f3a637b15fa128be1e4467cbee907b7194fe926d3927a076e1a751
+  data.tar.gz: 56cda98ec744f87b058f66f0afa69d3ac7d087a0ba7350662707c12495758b2e4992210cd581fd01f6d79faaa3d2e08063f13e8a6d1377f11a501e8fd8336d03

data/CHANGELOG.md

@@ -2,11 +2,24 @@
 
 All notable changes to this gem will be documented in this file.
 
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-05-07
+
+### Added
+- Generated structs gain `#match?(**pattern)` — returns `true` when every key in the pattern matches the struct's value via `===` (case equality). Pairs with `deconstruct_keys` for partial-attribute checks.
+
+### Changed
+- CHANGELOG header normalised to reference Keep a Changelog v1.0.0 and "this project adheres" to match every other Ruby gem.
+
+## [0.5.0] - 2026-04-18
+
+### Added
+- `.from_a(array)` class method on generated structs — constructs an instance from field values in declaration order; inverse of `#to_a`; raises `ArgumentError` on length mismatch
+
 ## [0.4.0] - 2026-04-16
 
 ### Added
@@ -117,7 +130,9 @@ and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 - Value equality via `#==`
 - Keyword-only constructor
 
-[Unreleased]: https://github.com/philiprehberger/rb-struct-kit/compare/v0.4.0...HEAD
+[Unreleased]: https://github.com/philiprehberger/rb-struct-kit/compare/v0.6.0...HEAD
+[0.6.0]: https://github.com/philiprehberger/rb-struct-kit/compare/v0.5.0...v0.6.0
+[0.5.0]: https://github.com/philiprehberger/rb-struct-kit/compare/v0.4.0...v0.5.0
 [0.4.0]: https://github.com/philiprehberger/rb-struct-kit/compare/v0.3.1...v0.4.0
 [0.3.1]: https://github.com/philiprehberger/rb-struct-kit/compare/v0.3.0...v0.3.1
 [0.3.0]: https://github.com/philiprehberger/rb-struct-kit/compare/v0.2.0...v0.3.0

data/README.md

@@ -124,6 +124,15 @@ in { role: :user }
 end
 ```
 
+### Pattern-Style Match
+
+```ruby
+user = User.new(name: 'Alice', age: 30, role: :user)
+user.match?(role: :user)         # => true
+user.match?(age: 18..30)         # => true (uses === for case equality)
+user.match?(name: /^A/)          # => true
+```
+
 ### Non-destructive Updates
 
 ```ruby
@@ -177,6 +186,24 @@ Account.new(email: '', tags: ['a']) # ArgumentError: email must be present
 Account.new(email: 'a@b', tags: []) # ArgumentError: tags must be present
 ```
 
+### Positional constructor
+
+```ruby
+require 'philiprehberger/struct_kit'
+
+Point = Philiprehberger::StructKit.define do
+  field :x, Integer
+  field :y, Integer
+end
+
+p = Point.from_a([1, 2])
+p.x # => 1
+p.y # => 2
+
+# Roundtrip with #to_a
+Point.from_a(p.to_a) == p # => true
+```
+
 ### Introspection
 
 ```ruby
@@ -212,6 +239,7 @@ Define a new struct class. Evaluates the block in DSL context.
 | `#with(**changes)` | Return a new instance with the given fields changed |
 | `#with(**overrides)` | Immutable copy-with: return a new instance with selected fields replaced (re-validated) |
 | `#deconstruct_keys(keys)` | Pattern matching support |
+| `#match?(**pattern)` | Returns true when every key in pattern matches via `===` |
 | `#==` | Value equality |
 | `#inspect` | Human-readable string representation |
 
@@ -220,6 +248,7 @@ Define a new struct class. Evaluates the block in DSL context.
 | Method | Description |
 |--------|-------------|
 | `.from_h(hash)` | Construct from hash (string or symbol keys) |
+| `.from_a(array)` | Construct from an array of values in field-declaration order (inverse of `#to_a`) |
 | `.field_names` | Return the declared field names in order |
 
 ## Development

data/lib/philiprehberger/struct_kit/definition.rb

@@ -25,7 +25,7 @@ module Philiprehberger
         @validations[field_name] << block if block
       end
 
-      def build # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+      def build # rubocop:disable Metrics/AbcSize, Metrics/MethodLength, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
         fields = @fields.dup
         mutable = @mutable
 
@@ -105,6 +105,15 @@ module Philiprehberger
             new(**sym_hash)
           end
 
+          define_singleton_method(:from_a) do |array|
+            if array.length != _fields.size
+              raise ArgumentError,
+                    "expected #{_fields.size} values for #{_fields.keys}, got #{array.length}"
+            end
+
+            new(**_fields.keys.zip(array).to_h)
+          end
+
           define_singleton_method(:field_names) do
             _fields.keys
           end
@@ -114,6 +123,13 @@ module Philiprehberger
             keys ? h.slice(*keys) : h
           end
 
+          define_method(:match?) do |**pattern|
+            unknown = pattern.keys - self.class._fields.keys
+            raise ArgumentError, "unknown keyword: #{unknown.first}" unless unknown.empty?
+
+            pattern.all? { |k, v| v === instance_variable_get(:"@#{k}") } # rubocop:disable Style/CaseEquality
+          end
+
           define_method(:==) do |other|
             other.is_a?(self.class) && to_h == other.to_h
           end

data/lib/philiprehberger/struct_kit/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module StructKit
-    VERSION = '0.4.0'
+    VERSION = '0.6.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-struct_kit
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-16 00:00:00.000000000 Z
+date: 2026-05-07 00:00:00.000000000 Z
 dependencies: []
 description: Define data classes with typed fields, default values, validation rules,
   and pattern matching support. Immutable by default with keyword-only construction,