philiprehberger-struct_kit 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fcc66136d59c7eb3cb37b487a849582ec4f2cd9c322a60dc924402aa380f1d7e
-  data.tar.gz: ad8bc697727169695feb41cc1dc37efcab5a3401e1190944e831f9612f252c1b
+  metadata.gz: a0152f7975b6372edce049e3983a3d488a1405514732dc49d0d18c2f650f5cb5
+  data.tar.gz: 9edcdd291201087f68ee11f08ca400d8fdfaac7403bdf8368ebec4dcee18ffa2
 SHA512:
-  metadata.gz: 747aeabf61174e81aff1f9792b8b3d4fd2044a201805716c0eac054ee33385bd86552c75c1d98177d61e13f94d55e6af581a84f6033cd6110cf235e7b09a7a0b
-  data.tar.gz: 6c60682cdcf912430453471cfd9ddba394a06110d9edcb8f44e40fd9e856fb5b0467cafa62792809f8f07035c44e66d13878a697a67f8d86db4bcfe4b80d69d7
+  metadata.gz: 923c971ee52f8e015b593e54f0cbb091522b05f2cd9ab4ef96a8ec980626c4785bddaf1d5ac5bed199d3f6ae2b25d792ed12319eb63cf7f9a0456724a07827c8
+  data.tar.gz: a24215634ee0dd5302f446821d2142a1e426a81a31c7597936f305a44b59f0a00c25b5481dd3b01ad43e1362f95d477231683e2bc385f00271a1ee2e363f610b

data/CHANGELOG.md

@@ -7,6 +7,18 @@ and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-04-15
+
+### Added
+- `#with(**changes)` instance method for non-destructive updates
+- `#to_a` instance method returning field values in declaration order
+- `.field_names` class method for introspecting declared fields
+- `presence:` option on `validate` DSL to reject nil/empty values
+
+### Changed
+- `spec.files` glob narrowed to `lib/**/*.rb` to match gemspec template
+- `required_ruby_version` normalized to `>= 3.1.0` to match gemspec template
+
 ## [0.2.0] - 2026-04-04
 
 ### Added
@@ -93,5 +105,7 @@ 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.1.0...HEAD
+[Unreleased]: https://github.com/philiprehberger/rb-struct-kit/compare/v0.3.0...HEAD
+[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
 [0.1.0]: https://github.com/philiprehberger/rb-struct-kit/releases/tag/v0.1.0

data/README.md

@@ -124,6 +124,49 @@ in { role: :user }
 end
 ```
 
+### Non-destructive Updates
+
+```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)
+older = alice.with(age: 31)
+
+alice.age # => 30 (unchanged)
+older.age # => 31
+```
+
+### Presence Validation
+
+```ruby
+Account = Philiprehberger::StructKit.define do
+  field :email, String
+  field :tags, Array, default: -> { [] }
+  validate :email, presence: true
+  validate :tags, presence: true
+end
+
+Account.new(email: '', tags: ['a']) # ArgumentError: email must be present
+Account.new(email: 'a@b', tags: []) # ArgumentError: tags must be present
+```
+
+### Introspection
+
+```ruby
+User = Philiprehberger::StructKit.define do
+  field :name, String
+  field :age, Integer, default: 0
+end
+
+User.field_names        # => [:name, :age]
+User.new(name: 'Alice', age: 30).to_a  # => ["Alice", 30]
+```
+
 ## API
 
 ### `Philiprehberger::StructKit.define(mutable: false, &block)`
@@ -135,14 +178,16 @@ Define a new struct class. Evaluates the block in DSL context.
 | Method | Description |
 |--------|-------------|
 | `field(name, type = nil, default: UNSET, coerce: nil)` | Declare a typed field with optional default and coercion |
-| `validate(name, range: nil, format: nil, &block)` | Add validation rule to a field |
+| `validate(name, range: nil, format: nil, presence: nil, &block)` | Add validation rule to a field |
 
 ### Instance Methods
 
 | Method | Description |
 |--------|-------------|
 | `#to_h` | Convert to a plain hash |
+| `#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 |
 | `#deconstruct_keys(keys)` | Pattern matching support |
 | `#==` | Value equality |
 | `#inspect` | Human-readable string representation |
@@ -152,6 +197,7 @@ Define a new struct class. Evaluates the block in DSL context.
 | Method | Description |
 |--------|-------------|
 | `.from_h(hash)` | Construct from hash (string or symbol keys) |
+| `.field_names` | Return the declared field names in order |
 
 ## Development
 

data/lib/philiprehberger/struct_kit/definition.rb

@@ -15,16 +15,17 @@ module Philiprehberger
         @fields[name] = Field.new(name, type, default: default, coerce: coerce)
       end
 
-      def validate(field_name, range: nil, format: nil, &block)
+      def validate(field_name, range: nil, format: nil, presence: nil, &block)
         @validations[field_name] ||= []
         rules = {}
         rules[:range] = range if range
         rules[:format] = format if format
+        rules[:presence] = presence unless presence.nil?
         @validations[field_name] << rules unless rules.empty?
         @validations[field_name] << block if block
       end
 
-      def build
+      def build # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
         fields = @fields.dup
         mutable = @mutable
 
@@ -83,16 +84,31 @@ module Philiprehberger
             end
           end
 
+          define_method(:to_a) do
+            self.class._fields.keys.map { |fname| instance_variable_get(:"@#{fname}") }
+          end
+
           define_method(:to_json) do |*args|
             require 'json'
             to_h.to_json(*args)
           end
 
+          define_method(:with) do |**changes|
+            unknown = changes.keys - self.class._fields.keys
+            raise ArgumentError, "unknown keyword: #{unknown.first}" unless unknown.empty?
+
+            self.class.new(**to_h, **changes)
+          end
+
           define_singleton_method(:from_h) do |hash|
             sym_hash = hash.transform_keys(&:to_sym)
             new(**sym_hash)
           end
 
+          define_singleton_method(:field_names) do
+            _fields.keys
+          end
+
           define_method(:deconstruct_keys) do |keys|
             h = to_h
             keys ? h.slice(*keys) : h

data/lib/philiprehberger/struct_kit/field.rb

@@ -52,6 +52,7 @@ module Philiprehberger
           when Hash
             errors << "#{@name} must be in range #{rule[:range]}" if rule[:range] && !rule[:range].include?(value)
             errors << "#{@name} does not match required format" if rule[:format] && !rule[:format].match?(value.to_s)
+            errors << "#{@name} must be present" if rule[:presence] && blank?(value)
           when Proc
             msg = rule.call(value)
             errors << msg if msg.is_a?(String)
@@ -60,6 +61,15 @@ module Philiprehberger
 
         errors
       end
+
+      private
+
+      def blank?(value)
+        return true if value.nil?
+        return true if value.respond_to?(:empty?) && value.empty?
+
+        false
+      end
     end
   end
 end

data/lib/philiprehberger/struct_kit/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module StructKit
-    VERSION = '0.2.0'
+    VERSION = '0.3.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-struct_kit
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-05 00:00:00.000000000 Z
+date: 2026-04-15 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,
@@ -43,7 +43,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: 3.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="