philiprehberger-struct_kit 0.1.9 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +20 -0
- data/README.md +36 -3
- data/lib/philiprehberger/struct_kit/definition.rb +4 -2
- data/lib/philiprehberger/struct_kit/field.rb +10 -2
- data/lib/philiprehberger/struct_kit/version.rb +1 -1
- metadata +6 -6
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: fcc66136d59c7eb3cb37b487a849582ec4f2cd9c322a60dc924402aa380f1d7e
|
|
4
|
+
data.tar.gz: ad8bc697727169695feb41cc1dc37efcab5a3401e1190944e831f9612f252c1b
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 747aeabf61174e81aff1f9792b8b3d4fd2044a201805716c0eac054ee33385bd86552c75c1d98177d61e13f94d55e6af581a84f6033cd6110cf235e7b09a7a0b
|
|
7
|
+
data.tar.gz: 6c60682cdcf912430453471cfd9ddba394a06110d9edcb8f44e40fd9e856fb5b0467cafa62792809f8f07035c44e66d13878a697a67f8d86db4bcfe4b80d69d7
|
data/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,26 @@ and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [0.2.0] - 2026-04-04
|
|
11
|
+
|
|
12
|
+
### Added
|
|
13
|
+
- Type coercion support via `coerce:` option on `field` DSL
|
|
14
|
+
- GitHub issue template gem version field
|
|
15
|
+
- Feature request "Alternatives considered" field
|
|
16
|
+
|
|
17
|
+
### Fixed
|
|
18
|
+
- Gemspec author and email to match standard template
|
|
19
|
+
|
|
20
|
+
## [0.1.11] - 2026-03-31
|
|
21
|
+
|
|
22
|
+
### Added
|
|
23
|
+
- Add GitHub issue templates, dependabot config, and PR template
|
|
24
|
+
|
|
25
|
+
## [0.1.10] - 2026-03-31
|
|
26
|
+
|
|
27
|
+
### Changed
|
|
28
|
+
- Standardize README badges, support section, and license format
|
|
29
|
+
|
|
10
30
|
## [0.1.9] - 2026-03-26
|
|
11
31
|
|
|
12
32
|
### Fixed
|
data/README.md
CHANGED
|
@@ -2,8 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://github.com/philiprehberger/rb-struct-kit/actions/workflows/ci.yml)
|
|
4
4
|
[](https://rubygems.org/gems/philiprehberger-struct_kit)
|
|
5
|
-
[](https://github.com/sponsors/philiprehberger)
|
|
5
|
+
[](https://github.com/philiprehberger/rb-struct-kit/commits/main)
|
|
7
6
|
|
|
8
7
|
Enhanced struct builder with typed fields, defaults, validation, and pattern matching
|
|
9
8
|
|
|
@@ -98,6 +97,22 @@ user.to_json # => '{"name":"Alice","age":30,"role":"user"}'
|
|
|
98
97
|
User.from_h({ 'name' => 'Bob', 'age' => 25 }) # string keys OK
|
|
99
98
|
```
|
|
100
99
|
|
|
100
|
+
### Coercion
|
|
101
|
+
|
|
102
|
+
```ruby
|
|
103
|
+
require "philiprehberger/struct_kit"
|
|
104
|
+
|
|
105
|
+
User = Philiprehberger::StructKit.define do
|
|
106
|
+
field :age, Integer, coerce: ->(v) { Integer(v) }
|
|
107
|
+
field :status, Symbol, coerce: ->(v) { v.to_sym }
|
|
108
|
+
validate :age, range: 0..150
|
|
109
|
+
end
|
|
110
|
+
|
|
111
|
+
user = User.new(age: "25", status: "active")
|
|
112
|
+
user.age # => 25 (Integer)
|
|
113
|
+
user.status # => :active (Symbol)
|
|
114
|
+
```
|
|
115
|
+
|
|
101
116
|
### Pattern Matching
|
|
102
117
|
|
|
103
118
|
```ruby
|
|
@@ -119,7 +134,7 @@ Define a new struct class. Evaluates the block in DSL context.
|
|
|
119
134
|
|
|
120
135
|
| Method | Description |
|
|
121
136
|
|--------|-------------|
|
|
122
|
-
| `field(name, type = nil, default: UNSET)` | Declare a typed field with optional default |
|
|
137
|
+
| `field(name, type = nil, default: UNSET, coerce: nil)` | Declare a typed field with optional default and coercion |
|
|
123
138
|
| `validate(name, range: nil, format: nil, &block)` | Add validation rule to a field |
|
|
124
139
|
|
|
125
140
|
### Instance Methods
|
|
@@ -146,6 +161,24 @@ bundle exec rspec
|
|
|
146
161
|
bundle exec rubocop
|
|
147
162
|
```
|
|
148
163
|
|
|
164
|
+
## Support
|
|
165
|
+
|
|
166
|
+
If you find this project useful:
|
|
167
|
+
|
|
168
|
+
⭐ [Star the repo](https://github.com/philiprehberger/rb-struct-kit)
|
|
169
|
+
|
|
170
|
+
🐛 [Report issues](https://github.com/philiprehberger/rb-struct-kit/issues?q=is%3Aissue+is%3Aopen+label%3Abug)
|
|
171
|
+
|
|
172
|
+
💡 [Suggest features](https://github.com/philiprehberger/rb-struct-kit/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement)
|
|
173
|
+
|
|
174
|
+
❤️ [Sponsor development](https://github.com/sponsors/philiprehberger)
|
|
175
|
+
|
|
176
|
+
🌐 [All Open Source Projects](https://philiprehberger.com/open-source-packages)
|
|
177
|
+
|
|
178
|
+
💻 [GitHub Profile](https://github.com/philiprehberger)
|
|
179
|
+
|
|
180
|
+
🔗 [LinkedIn Profile](https://www.linkedin.com/in/philiprehberger)
|
|
181
|
+
|
|
149
182
|
## License
|
|
150
183
|
|
|
151
184
|
[MIT](LICENSE)
|
|
@@ -11,8 +11,8 @@ module Philiprehberger
|
|
|
11
11
|
@mutable = mutable
|
|
12
12
|
end
|
|
13
13
|
|
|
14
|
-
def field(name, type = nil, default: Field::UNSET)
|
|
15
|
-
@fields[name] = Field.new(name, type, default: default)
|
|
14
|
+
def field(name, type = nil, default: Field::UNSET, coerce: nil)
|
|
15
|
+
@fields[name] = Field.new(name, type, default: default, coerce: coerce)
|
|
16
16
|
end
|
|
17
17
|
|
|
18
18
|
def validate(field_name, range: nil, format: nil, &block)
|
|
@@ -54,6 +54,8 @@ module Philiprehberger
|
|
|
54
54
|
raise ArgumentError, "missing keyword: #{fname}"
|
|
55
55
|
end
|
|
56
56
|
|
|
57
|
+
value = f.coerce_value(value)
|
|
58
|
+
|
|
57
59
|
unless f.type_valid?(value)
|
|
58
60
|
expected = f.type.is_a?(Array) ? f.type.map(&:name).join(' or ') : f.type.name
|
|
59
61
|
raise TypeError, "#{fname} must be #{expected}, got #{value.class}"
|
|
@@ -5,15 +5,23 @@ module Philiprehberger
|
|
|
5
5
|
class Field
|
|
6
6
|
UNSET = Object.new.freeze
|
|
7
7
|
|
|
8
|
-
attr_reader :name, :type, :validations
|
|
8
|
+
attr_reader :name, :type, :validations, :coerce
|
|
9
9
|
|
|
10
|
-
def initialize(name, type = nil, default: UNSET)
|
|
10
|
+
def initialize(name, type = nil, default: UNSET, coerce: nil)
|
|
11
11
|
@name = name
|
|
12
12
|
@type = type
|
|
13
13
|
@default = default
|
|
14
|
+
@coerce = coerce
|
|
14
15
|
@validations = []
|
|
15
16
|
end
|
|
16
17
|
|
|
18
|
+
def coerce_value(value)
|
|
19
|
+
return value if @coerce.nil?
|
|
20
|
+
return @coerce.call(value) if @coerce.is_a?(Proc)
|
|
21
|
+
|
|
22
|
+
value
|
|
23
|
+
end
|
|
24
|
+
|
|
17
25
|
def has_default?
|
|
18
26
|
@default != UNSET
|
|
19
27
|
end
|
metadata
CHANGED
|
@@ -1,20 +1,20 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: philiprehberger-struct_kit
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.2.0
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
|
-
-
|
|
7
|
+
- Philip Rehberger
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: bin
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2026-
|
|
11
|
+
date: 2026-04-05 00:00:00.000000000 Z
|
|
12
12
|
dependencies: []
|
|
13
13
|
description: Define data classes with typed fields, default values, validation rules,
|
|
14
14
|
and pattern matching support. Immutable by default with keyword-only construction,
|
|
15
15
|
JSON/Hash serialization, and runtime type checking.
|
|
16
16
|
email:
|
|
17
|
-
- philiprehberger
|
|
17
|
+
- me@philiprehberger.com
|
|
18
18
|
executables: []
|
|
19
19
|
extensions: []
|
|
20
20
|
extra_rdoc_files: []
|
|
@@ -26,11 +26,11 @@ files:
|
|
|
26
26
|
- lib/philiprehberger/struct_kit/definition.rb
|
|
27
27
|
- lib/philiprehberger/struct_kit/field.rb
|
|
28
28
|
- lib/philiprehberger/struct_kit/version.rb
|
|
29
|
-
homepage: https://
|
|
29
|
+
homepage: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-struct_kit
|
|
30
30
|
licenses:
|
|
31
31
|
- MIT
|
|
32
32
|
metadata:
|
|
33
|
-
homepage_uri: https://
|
|
33
|
+
homepage_uri: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-struct_kit
|
|
34
34
|
source_code_uri: https://github.com/philiprehberger/rb-struct-kit
|
|
35
35
|
changelog_uri: https://github.com/philiprehberger/rb-struct-kit/blob/main/CHANGELOG.md
|
|
36
36
|
bug_tracker_uri: https://github.com/philiprehberger/rb-struct-kit/issues
|