philiprehberger-struct_kit 0.3.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 060eddbc858baf2efcdca822e058cec8816d86e3fadc155ec945af905ee396d6
-  data.tar.gz: 5e2701e97abcf3e3b714169cb2eea451d4c4f8fb3eec05daec75bbf09595ec24
+  metadata.gz: 66d55207190faed7e2f44c1b5917c0c61740b9bbf4e285de11dd93c105d31cac
+  data.tar.gz: 5c263bcd332817762a19a4d01ae73209a8f98ae33f1fcbd9178881181af014e0
 SHA512:
-  metadata.gz: 463cba608aa49db99449dc5064ca41664d13ac0a8cb919b995d2dd2928c2d731a5361aac0bc1dadc3e4b0f93087037eaf250b8a301a2999f26e0c33dead47bbd
-  data.tar.gz: 57d159e69465225e616471143a80a6758ab3217c804c46f6c99e62d65d34577c78523301228c8744d00bee9cb3fbe680cb8f35790616e9b2da00acac1271d7cc
+  metadata.gz: eccb9ffe556b54ba950157125c6a7e6e7a4fdda5a121b4ffa193956d9ebd313e0810dde4d37b7f51d4508807903d9cd06ba22b464f1cfd4552cb2b0951b11ea8
+  data.tar.gz: 18b5d0674d7b1d7d87c395cc0f284e225d735852f826399902cde508ad2527c0bebc788f66f31a53e4155c99f5d82f8f50386d01be364aa988d9151d7f9733a4

data/CHANGELOG.md

@@ -7,6 +7,16 @@ and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+## [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
+- `#with(**overrides)` instance method on generated structs for immutable copy-with-changes
+
 ## [0.3.1] - 2026-04-15
 
 ### Changed
@@ -112,7 +122,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.3.1...HEAD
+[Unreleased]: https://github.com/philiprehberger/rb-struct-kit/compare/v0.5.0...HEAD
+[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
 [0.2.0]: https://github.com/philiprehberger/rb-struct-kit/compare/v0.1.0...v0.2.0

data/README.md

@@ -141,6 +141,28 @@ alice.age # => 30 (unchanged)
 older.age # => 31
 ```
 
+### Copy With Changes
+
+```ruby
+require 'philiprehberger/struct_kit'
+
+User = Philiprehberger::StructKit.define do
+  field :name, String
+  field :age, Integer, default: 0
+end
+
+alice = User.new(name: 'Alice', age: 30)
+bob   = alice.with(name: 'Bob')
+
+alice.name # => "Alice" (unchanged)
+bob.name   # => "Bob"
+bob.age    # => 30 (retained)
+
+# Overrides are re-validated through the existing type/validation system:
+alice.with(age: 'oops') # TypeError: age must be Integer, got String
+alice.with(nope: 1)     # ArgumentError: unknown keyword: nope
+```
+
 ### Presence Validation
 
 ```ruby
@@ -155,6 +177,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
@@ -188,6 +228,7 @@ Define a new struct class. Evaluates the block in DSL context.
 | `#to_a` | Convert to an array of values in field-declaration order |
 | `#to_json` | Convert to JSON string |
 | `#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 |
 | `#==` | Value equality |
 | `#inspect` | Human-readable string representation |
@@ -197,6 +238,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

@@ -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

data/lib/philiprehberger/struct_kit/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module StructKit
-    VERSION = '0.3.1'
+    VERSION = '0.5.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-struct_kit
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.5.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-15 00:00:00.000000000 Z
+date: 2026-04-19 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,