philiprehberger-struct_kit 0.3.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 060eddbc858baf2efcdca822e058cec8816d86e3fadc155ec945af905ee396d6
-  data.tar.gz: 5e2701e97abcf3e3b714169cb2eea451d4c4f8fb3eec05daec75bbf09595ec24
+  metadata.gz: 0a50ed52bad42906d2452f7e16fa3713287f263582554a7f8d67ab404a47d65e
+  data.tar.gz: a4e55b469fc1e50ca7388f66b309f69d3046a2100b58c50fb88a06c67150799e
 SHA512:
-  metadata.gz: 463cba608aa49db99449dc5064ca41664d13ac0a8cb919b995d2dd2928c2d731a5361aac0bc1dadc3e4b0f93087037eaf250b8a301a2999f26e0c33dead47bbd
-  data.tar.gz: 57d159e69465225e616471143a80a6758ab3217c804c46f6c99e62d65d34577c78523301228c8744d00bee9cb3fbe680cb8f35790616e9b2da00acac1271d7cc
+  metadata.gz: 92f45e162b4c8e851bf33345ecc19bdbfd37a171174dd2a76351e98462bb0f44052b079a12651dd935aa46729e7368755c8b0926060e6c51af3411bd8907ed43
+  data.tar.gz: 6ea2cb19cc04d6888b9aa31567cbcb3a22105f95138090b3b7308e4d4ed96e63fd082a1530de83f88bb440331fedaaa69b3941b563cd3d73068682f1cbb79549

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+## [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 +117,8 @@ 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.4.0...HEAD
+[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
@@ -188,6 +210,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 |

data/lib/philiprehberger/struct_kit/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module StructKit
-    VERSION = '0.3.1'
+    VERSION = '0.4.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.4.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-15 00:00:00.000000000 Z
+date: 2026-04-16 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,