jsonschema_rs 0.42.0-aarch64-linux → 0.42.2-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 29e5bf1c85875f60a2e1d02f769b203839c377a3d72c63f8ae0aecf3c47ed7b3
-  data.tar.gz: 30e5f0a7e3e427eb2b1d4f5d34b995cf79c2b3fe06649b1a3d3a804d74f85e1f
+  metadata.gz: 021caf2f915f392daf60de381ba97591416e2bbdf1a62373d3d9290b88f8e095
+  data.tar.gz: 918d7d998823717abcce53e3b08ced90567025a535d5888332d3795dddfa4419
 SHA512:
-  metadata.gz: 226a01d9b43a84e8e29cd2c373ff133a79fb0c9b7ff151d760040b5b8314a22efb873748f95e5a72afdcfd980099cedcdc8aed3004379d8920248912876c0b13
-  data.tar.gz: 921ca6bae055f06fbd00f9e680102b67ff69f87ee8b69e7f1cbb29235e02917b894b652a60676429e65831062259f063eb07968eef72356d255f48521dfe9a5c
+  metadata.gz: f76bc26b78ad1e70ff97ef1164c0b9f88001f010660c8cb7da90e5dc997fb0d85a503002a57bff010dee5fc98b7deb0f3446f71a71b83a1b1ddc32983d140b4f
+  data.tar.gz: 4634c084b338805ca2f90174c94c55dbf3bf23340c25704e02802de70db302d4c1a2521008eff8756d1228568bd77e4a844408032177b26fb26ecc0d307e2368

data/CHANGELOG.md

@@ -2,7 +2,32 @@
 
 ## [Unreleased]
 
+## [0.42.2] - 2026-02-26
+
+### Changed
+
+- Custom keyword validation exceptions are now chained to the resulting `ValidationError` via `cause`, preserving the original exception class and message.
+
+### Fixed
+
+- SWAR digit parser accepted bytes `:`–`?` (0x3A–0x3F) as valid digits during `date`, `time`, and `date-time` format validation, potentially allowing malformed values to pass.
+
+### Performance
+
+- Extend `pattern` prefix optimization to handle escaped slashes (`^\/`) and exact-match patterns (`^\$ref$`).
+- Specialize `enum` for cases when all variants are strings.
+
+## [0.42.1] - 2026-02-17
+
+### Performance
+
+- Reduce dynamic dispatch overhead for non-recursive `$ref` resolution.
+- Cache ECMA regex transformations during `format: "regex"` validation.
+
 ## 0.42.0 - 2026-02-15
 
 - Initial public release
 
+[Unreleased]: https://github.com/Stranger6667/jsonschema/compare/ruby-v0.42.2...HEAD
+[0.42.2]: https://github.com/Stranger6667/jsonschema/compare/ruby-v0.42.1...ruby-v0.42.2
+[0.42.1]: https://github.com/Stranger6667/jsonschema/compare/ruby-v0.42.0...ruby-v0.42.1

data/README.md

@@ -36,8 +36,8 @@ validator.valid?(instance)  # => true
 
 # Structured output (JSON Schema Output v1)
 evaluation = validator.evaluate(instance)
-evaluation.annotations.each do |ann|
-  puts "Annotation at #{ann[:schemaLocation]}: #{ann[:annotations]}"
+evaluation.errors.each do |err|
+  puts "Error at #{err[:instanceLocation]}: #{err[:error]}"
 end
 ```
 
@@ -86,7 +86,7 @@ If no pre-built gem is available for your platform, it will be compiled from sou
 ### Reusable validators
 
 For validating multiple instances against the same schema, create a reusable validator.
-`validator_for` automatically detects the draft version from the `$schema` keyword in the schema:
+`validator_for` automatically detects the draft version from the `$schema` keyword in the schema and falls back to Draft 2020-12:
 
 ```ruby
 validator = JSONSchema.validator_for({
@@ -147,9 +147,20 @@ Each custom keyword class must implement:
 - `initialize(parent_schema, value, schema_path)` - called during schema compilation
 - `validate(instance)` - raise on failure, return normally on success
 
+When `validate` raises, the original exception is preserved as the `cause` of the `ValidationError`, so callers can inspect it:
+
+```ruby
+begin
+  validator.validate!(3)
+rescue JSONSchema::ValidationError => e
+  puts e.cause.class    # => RuntimeError
+  puts e.cause.message  # => "3 is not even"
+end
+```
+
 ### Structured evaluation output
 
-When you need more than a boolean result, use the `evaluate` API to access the JSON Schema Output v1 formats:
+When you need more than a boolean result, use the `evaluate` API to access the [JSON Schema Output v1](https://json-schema.org/draft/2020-12/json-schema-core#name-output-formatting) formats:
 
 ```ruby
 schema = {
@@ -165,34 +176,79 @@ validator = JSONSchema.validator_for(schema)
 evaluation = validator.evaluate({ "age" => "not_an_integer" })
 
 evaluation.valid?  # => false
+```
+
+**Flag output** — simplest, just valid/invalid:
 
-# Flag output (simplest)
+```ruby
 evaluation.flag
-# => { "valid" => false }
+# => {valid: false}
+```
+
+**List output** — flat list of all evaluation nodes:
 
-# List output (flat)
+```ruby
 evaluation.list
-# => { "valid" => false, "details" => [
-#   { "valid" => false, "evaluationPath" => "", "instanceLocation" => "", "schemaLocation" => "" },
-#   { "valid" => false, "evaluationPath" => "/required", "instanceLocation" => "", "schemaLocation" => "/required",
-#     "errors" => { "required" => "\"name\" is a required property" } },
-#   ...
-# ] }
-
-# Hierarchical output (nested tree following schema structure)
+# => {valid: false,
+#     details: [
+#       {valid: false, evaluationPath: "", schemaLocation: "", instanceLocation: ""},
+#       {valid: true, evaluationPath: "/type", schemaLocation: "/type", instanceLocation: ""},
+#       {valid: false, evaluationPath: "/required", schemaLocation: "/required",
+#        instanceLocation: "",
+#        errors: {"required" => "\"name\" is a required property"}},
+#       {valid: false, evaluationPath: "/properties", schemaLocation: "/properties",
+#        instanceLocation: "", droppedAnnotations: ["age"]},
+#       {valid: false, evaluationPath: "/properties/age", schemaLocation: "/properties/age",
+#        instanceLocation: "/age"},
+#       {valid: false, evaluationPath: "/properties/age/type",
+#        schemaLocation: "/properties/age/type", instanceLocation: "/age",
+#        errors: {"type" => "\"not_an_integer\" is not of type \"integer\""}}
+#     ]}
+```
+
+**Hierarchical output** — nested tree following schema structure:
+
+```ruby
 evaluation.hierarchical
-# => { "valid" => false, "evaluationPath" => "", "instanceLocation" => "", "schemaLocation" => "",
-#   "details" => [ ... ] }
+# => {valid: false, evaluationPath: "", schemaLocation: "", instanceLocation: "",
+#     details: [
+#       {valid: true, evaluationPath: "/type", schemaLocation: "/type", instanceLocation: ""},
+#       {valid: false, evaluationPath: "/required", schemaLocation: "/required",
+#        instanceLocation: "",
+#        errors: {"required" => "\"name\" is a required property"}},
+#       {valid: false, evaluationPath: "/properties", schemaLocation: "/properties",
+#        instanceLocation: "", droppedAnnotations: ["age"],
+#        details: [
+#          {valid: false, evaluationPath: "/properties/age",
+#           schemaLocation: "/properties/age", instanceLocation: "/age",
+#           details: [
+#             {valid: false, evaluationPath: "/properties/age/type",
+#              schemaLocation: "/properties/age/type", instanceLocation: "/age",
+#              errors: {"type" => "\"not_an_integer\" is not of type \"integer\""}}
+#           ]}
+#        ]}
+#     ]}
+```
 
-# Collected errors across all nodes
+**Collected errors** — flat list of all errors across evaluation nodes:
+
+```ruby
 evaluation.errors
-# => [{ "schemaLocation" => "/required", "instanceLocation" => "",
-#        "absoluteKeywordLocation" => nil, "error" => "\"name\" is a required property" }, ...]
+# => [{schemaLocation: "/required", absoluteKeywordLocation: nil,
+#      instanceLocation: "", error: "\"name\" is a required property"},
+#     {schemaLocation: "/properties/age/type", absoluteKeywordLocation: nil,
+#      instanceLocation: "/age",
+#      error: "\"not_an_integer\" is not of type \"integer\""}]
+```
 
-# Collected annotations
-evaluation.annotations
-# => [{ "schemaLocation" => "/properties", "instanceLocation" => "",
-#        "absoluteKeywordLocation" => nil, "annotations" => ["age"] }]
+**Collected annotations** — flat list of annotations from successfully validated nodes.
+When a node fails validation, its annotations appear as `droppedAnnotations` in the list/hierarchical output instead.
+
+```ruby
+valid_eval = validator.evaluate({ "name" => "Alice", "age" => 30 })
+valid_eval.annotations
+# => [{schemaLocation: "/properties", absoluteKeywordLocation: nil,
+#      instanceLocation: "", annotations: ["age", "name"]}]
 ```
 
 ## Meta-Schema Validation
@@ -460,14 +516,12 @@ Valid draft symbols: `:draft4`, `:draft6`, `:draft7`, `:draft201909`, `:draft202
 
 `jsonschema` is designed for high performance, outperforming other Ruby JSON Schema validators in most scenarios:
 
-- **26-141x** faster than `json_schemer` for complex schemas and large instances
-- **174-535x** faster than `json-schema` where supported
-- **7-125x** faster than `rj_schema` (RapidJSON/C++)
+- **28-148x** faster than `json_schemer` for complex schemas and large instances
+- **200-567x** faster than `json-schema` where supported
+- **7-130x** faster than `rj_schema` (RapidJSON/C++)
 
 For detailed benchmarks, see our [full performance comparison](https://github.com/Stranger6667/jsonschema/blob/master/crates/jsonschema-rb/BENCHMARKS.md).
 
-**Tips:** Reuse validators. Use `valid?` for boolean checks (short-circuits on first error).
-
 ## Acknowledgements
 
 This library draws API design inspiration from the Python [`jsonschema`](https://github.com/python-jsonschema/jsonschema) package. We're grateful to the Python `jsonschema` maintainers and contributors for their pioneering work in JSON Schema validation.

data/lib/jsonschema/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module JSONSchema
-  VERSION = "0.42.0"
+  VERSION = "0.42.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jsonschema_rs
 version: !ruby/object:Gem::Version
-  version: 0.42.0
+  version: 0.42.2
 platform: aarch64-linux
 authors:
 - Dmitry Dygalo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-02-15 00:00:00.000000000 Z
+date: 2026-02-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal