jsonschema_rs 0.42.0 → 0.42.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 612136d54e48cbe70a384939de4ee760c240ebf37ffbb40924d8eb1bccf4e382
-  data.tar.gz: a3b9968753b319ef31129311c9598be508dc331eca081386eb8de8f645a40cf1
+  metadata.gz: f7f354d248faf1bee6e0165b05f80dbff15b3a3edc1d3ccc037d7cea59c798c4
+  data.tar.gz: 4ee7a0389b58e6d71fe410bfce9e52e881fb1a805cbf0c93aa24c400748a56e2
 SHA512:
-  metadata.gz: 93e07f2476489fcef0315b06b187895449435b072a269ce9cf29f302a481ba5a6e5ac4cf6bd75f79002f3aa5409d28283e76e6739bb7ce7578db7b2dd002e1dd
-  data.tar.gz: 032c5b841a42b9e3ee5e4a3a4c03826074cabfcc4d24d3b9d71c3e85eed7b0c417c352e7b95f5d0e6a9ac87c888df0520961f45298095c17df26117f0b6cbd5c
+  metadata.gz: '097f632cf1db882708a7b8e2e45e7e4659c52f3de17147e0680cd24f2ef86aaa34624a8a9edd665b3029e1cf94983bd8053421797fb3d4ea1a1bc78d5f1050a3'
+  data.tar.gz: a51f9f9969c44d8119960caac5e018bf91b0ecd9372122d53e24881f1b9a08139401b28db07f024e48afafa45a080b83c77406bb7d58190df9d42f72283abaaf

data/CHANGELOG.md

@@ -2,7 +2,16 @@
 
 ## [Unreleased]
 
+## [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.1...HEAD
+[0.42.1]: https://github.com/Stranger6667/jsonschema/compare/ruby-v0.42.0...ruby-v0.42.1

data/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "jsonschema-rb"
-version = "0.42.0"
+version = "0.42.1"
 edition = "2021"
 authors = ["Dmitry Dygalo <dmitry@dygalo.dev>"]
 license = "MIT"
@@ -13,7 +13,7 @@ publish = false
 crate-type = ["cdylib"]
 
 [dependencies]
-jsonschema = { version = "0.42.0", default-features = false, features = ["arbitrary-precision", "resolve-http", "resolve-file", "tls-ring"] }
+jsonschema = { version = "0.42.1", default-features = false, features = ["arbitrary-precision", "resolve-http", "resolve-file", "tls-ring"] }
 magnus = { version = "0.8", features = ["rb-sys"] }
 rb-sys = "0.9"
 serde = { workspace = true }

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({
@@ -149,7 +149,7 @@ Each custom keyword class must implement:
 
 ### 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 +165,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** — flat list of annotations from successfully validated nodes.
+When a node fails validation, its annotations appear as `droppedAnnotations` in the list/hierarchical output instead.
 
-# Collected annotations
-evaluation.annotations
-# => [{ "schemaLocation" => "/properties", "instanceLocation" => "",
-#        "absoluteKeywordLocation" => nil, "annotations" => ["age"] }]
+```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 +505,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++)
+- **30-117x** faster than `json_schemer` for complex schemas and large instances
+- **206-473x** faster than `json-schema` where supported
+- **7-118x** 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/ext/jsonschema/Cargo.lock

@@ -667,9 +667,9 @@ dependencies = [
 
 [[package]]
 name = "jsonschema"
-version = "0.42.0"
+version = "0.42.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c56489aa781cefb9c10edebf4469cf29cddfd6695408b6158acfec49cda73480"
+checksum = "6103dcd3815c9bd04239a6d0343dac2b7a18ee260e800d0a6e3eb5b9333504fb"
 dependencies = [
  "ahash",
  "bytecount",
@@ -697,7 +697,7 @@ dependencies = [
 
 [[package]]
 name = "jsonschema-rb-ext"
-version = "0.42.0"
+version = "0.42.1"
 dependencies = [
  "jsonschema",
  "magnus",
@@ -1044,9 +1044,9 @@ dependencies = [
 
 [[package]]
 name = "referencing"
-version = "0.42.0"
+version = "0.42.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1871aca1d163bb628f2282b79c169e9ad3b4aeda58ecea174ec4d6bddfdfa375"
+checksum = "1a76b0c93f3dd49da2900cfb3c6b883602471a0e3e34b1578a3310ca1269d418"
 dependencies = [
  "ahash",
  "fluent-uri",

data/ext/jsonschema/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "jsonschema-rb-ext"
-version = "0.42.0"
+version = "0.42.1"
 edition = "2021"
 publish = false
 
@@ -10,10 +10,10 @@ name = "jsonschema_rb"
 path = "../../src/lib.rs"
 
 [dependencies]
-jsonschema = { version = "0.42.0", default-features = false, features = ["arbitrary-precision", "resolve-http", "resolve-file", "tls-ring"] }
+jsonschema = { version = "0.42.1", default-features = false, features = ["arbitrary-precision", "resolve-http", "resolve-file", "tls-ring"] }
 magnus = { version = "0.8", features = ["rb-sys"] }
 rb-sys = "0.9"
-referencing = "0.42.0"
+referencing = "0.42.1"
 serde = { version = "1", features = ["derive"] }
 serde_json = { version = "1", features = ["arbitrary_precision"] }
 

data/lib/jsonschema/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jsonschema_rs
 version: !ruby/object:Gem::Version
-  version: 0.42.0
+  version: 0.42.1
 platform: ruby
 authors:
 - Dmitry Dygalo