philiprehberger-struct_kit 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a50ed52bad42906d2452f7e16fa3713287f263582554a7f8d67ab404a47d65e
-  data.tar.gz: a4e55b469fc1e50ca7388f66b309f69d3046a2100b58c50fb88a06c67150799e
+  metadata.gz: 66d55207190faed7e2f44c1b5917c0c61740b9bbf4e285de11dd93c105d31cac
+  data.tar.gz: 5c263bcd332817762a19a4d01ae73209a8f98ae33f1fcbd9178881181af014e0
 SHA512:
-  metadata.gz: 92f45e162b4c8e851bf33345ecc19bdbfd37a171174dd2a76351e98462bb0f44052b079a12651dd935aa46729e7368755c8b0926060e6c51af3411bd8907ed43
-  data.tar.gz: 6ea2cb19cc04d6888b9aa31567cbcb3a22105f95138090b3b7308e4d4ed96e63fd082a1530de83f88bb440331fedaaa69b3941b563cd3d73068682f1cbb79549
+  metadata.gz: eccb9ffe556b54ba950157125c6a7e6e7a4fdda5a121b4ffa193956d9ebd313e0810dde4d37b7f51d4508807903d9cd06ba22b464f1cfd4552cb2b0951b11ea8
+  data.tar.gz: 18b5d0674d7b1d7d87c395cc0f284e225d735852f826399902cde508ad2527c0bebc788f66f31a53e4155c99f5d82f8f50386d01be364aa988d9151d7f9733a4

data/CHANGELOG.md

@@ -7,6 +7,11 @@ 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
@@ -117,7 +122,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.4.0...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

data/README.md

@@ -177,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
@@ -220,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.4.0'
+    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.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-16 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,