philiprehberger-json_schema 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2a67bbf9af3550800b697cffb7061d297e1cc4d4d658b1db1f4c3eb3133c5125
-  data.tar.gz: a805669bc1f806de5fd76ac8ff9b28414676b2772ef71c67bdbad40ba5ebf66d
+  metadata.gz: 3878362183aecd77cf0023b5317baf1c16da11a9dec7e668f337ec17ac4b4f18
+  data.tar.gz: 4312a4bb78e80baa4be65ac0ac110bac0fe9049b1090f56d748059a1bc6bf4e2
 SHA512:
-  metadata.gz: f14027b317fc2d9b1f36dd79351e5da1ef2b43ebe14a00877cff83221db2e2e63d5802f5142389147285fd020992d5338583850947edb49f244383157710aa17
-  data.tar.gz: 4290e58110711d0ad8e9ed236d4d7dbea255621ca7dd985a48e63fe2c20b100545fbca3b5437406653fd448a54b74f44cfcdbb45a4ed22ffcd1c4f49b8fad3fe
+  metadata.gz: cc5ba7df69818c016c0c5bb4234962ca3708a1ec6792a5d771f9730a6ec27efe871ba9864805006f4941dcc340191c2b78eab4aefcb3e0d064191bd2ab051d08
+  data.tar.gz: 8d7ada27d85454c1c729a67bfb1f56a0eadc16eab6c48b590da21f2cf50d8342bc1c7ae2d509442c441c51edc0ee7c5f45f9732a4596d3ad6cc4cb305a5fc1b9

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-05-07
+
+### Added
+- `JsonSchema.validate!(data, schema)` — bang variant that returns the data on success and raises `JsonSchema::Error` with joined error messages on failure. Pairs with the existing `validate` (returns errors) and `valid?` (boolean).
+
 ## [0.3.0] - 2026-04-17
 
 ### Added

data/README.md

@@ -43,6 +43,10 @@ errors = Philiprehberger::JsonSchema.validate({ 'name' => 'Alice', 'age' => 30 }
 
 Philiprehberger::JsonSchema.valid?({ 'name' => 'Alice', 'age' => 30 }, schema)
 # => true
+
+payload = { 'name' => 'Alice', 'age' => 30 }
+data = Philiprehberger::JsonSchema.validate!(payload, schema)
+# raises Philiprehberger::JsonSchema::Error if invalid; returns payload otherwise
 ```
 
 ### Schema Composition (allOf, anyOf, oneOf)
@@ -195,6 +199,7 @@ compiled.validate({ 'id' => 'x' }) # => ["$.id: expected type integer..."]
 |--------|-------------|
 | `.validate(data, schema)` | Validate data against a schema, returns array of error strings |
 | `.valid?(data, schema)` | Returns `true` if data passes validation |
+| `.validate!(data, schema)` | Validates and returns the data; raises Error on validation failure |
 | `.compile(schema)` | Returns a `CompiledSchema` for repeated validation |
 
 ### `Philiprehberger::JsonSchema::CompiledSchema`

data/lib/philiprehberger/json_schema/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module JsonSchema
-    VERSION = '0.3.0'
+    VERSION = '0.4.0'
   end
 end

data/lib/philiprehberger/json_schema.rb

@@ -25,6 +25,19 @@ module Philiprehberger
       validate(data, schema).empty?
     end
 
+    # Validate data against a JSON Schema; raise on failure.
+    #
+    # @param data [Object] the data to validate
+    # @param schema [Hash] the JSON Schema definition
+    # @return [Object] the validated data, unchanged
+    # @raise [Error] when validation fails (message is the joined errors)
+    def self.validate!(data, schema)
+      errors = validate(data, schema)
+      raise Error, errors.join('; ') unless errors.empty?
+
+      data
+    end
+
     # Compile a schema for repeated validation
     #
     # @param schema [Hash] the JSON Schema definition

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-json_schema
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-17 00:00:00.000000000 Z
+date: 2026-05-07 00:00:00.000000000 Z
 dependencies: []
 description: Validate Ruby data structures against JSON Schema definitions with support
   for type checking, required properties, pattern matching, numeric ranges, enums,