schemurai 3.0.1 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f82df02813a6067fc242975190077fb66c9d104866c0e373497ad639f1ba12e3
-  data.tar.gz: d8ba792bfd5a7fbbdf2295bfa98f26e5804c702ad249ebf6efd3e8ba683af76e
+  metadata.gz: 663b805a46f6c7bf28678bcc50b2ffae37d3337b3025710a75c0782a5d7c8182
+  data.tar.gz: 41a280754bfa72b41626e44176ef7cf0c983cc27a504aedf049759df005498b1
 SHA512:
-  metadata.gz: ce2508c012b1bf512bd51c7d2d67f1feacb6935e78d73577e0769cb2dd4664b12eaa6fbf58b57f3027f6d46b30aa684fde9cfda15ced02b24eaf004488be6a18
-  data.tar.gz: 1282ae16eed2abaecb7f352c9030e5d6ef1417c55c4c24b4c5e4860214a3e01fa2cbeed81a9aea506e43b57e62373f53f2f669e4d3e46b2db02bc43064ab9140
+  metadata.gz: 88be3ae2e41ce4d46cbb5c79dc66e9bfe7d9041d63619b17dc27dc7977384679435df13f0e234701033eca5f829f9d4e7321b9b08ad8e9b6fdfdf0fa5d64c03c
+  data.tar.gz: a0ea620a03a983a0ad22319c4a22727c316ced09711bd8565a716d8ebcf4c523bc827e957b347c0b19886d487f7529d305b425f63e1e0ffa4b3b7d8f1822e406

data/README.md

@@ -189,7 +189,7 @@ must not be shared between threads or Ractors. With the VM and native backends,
 the registry compiles and shares its bytecode before this transition. The native
 backend also prepares shared native instruction tables for all four combinations
 of `content` and `format`; `validator_for` does not recompile them in each Ractor.
-Native regex search caches and VM fallback evaluation state belong to each
+Native regex search caches and Ruby runtime helper state belong to each
 validator. Preparing these tables adds time and memory to `make_shareable`.
 
 ### Meta-schema validation
@@ -255,13 +255,15 @@ applicator trials do not consume the cap. Boolean checks ignore the error cap
 and use the ordinary evaluator when no timeout is set.
 
 The timeout uses a monotonic elapsed-time deadline, including diagnostic
-rendering and native-to-VM fallback. It checks at entry, before returning and
-every 256 checkpoints in evaluation, container scans and structural traversal.
+rendering and native runtime helper calls and retries. It checks at entry,
+before returning and every 256 checkpoints in evaluation, container scans and
+structural traversal.
 Ruby string/content operations also check before and after expensive calls.
 Zero seconds stops even a trivial call. Expiry raises `LimitExceeded` with
 `limit == :timeout`; `maximum` and `attempted` are configured and elapsed seconds.
 Native returns an exhaustion status and releases Rust resources before Ruby
-raises. A limit hit is terminal and does not trigger fallback.
+raises. A limit hit is terminal. Native validation does not fall back to VM
+execution, with or without invocation limits.
 
 This implementation never uses Ruby `Timeout`, timer threads, signals or
 asynchronous exception injection. It is cooperative: one regexp search, scalar
@@ -286,9 +288,28 @@ scans use per-item evaluation so successful scans can poll.
 `Schemurai.backend`, `SchemaRegistry#backend`, and `Validator#backend` expose
 the selected backend. Pass `backend: :ruby` to force the Ruby oracle or
 `backend: :vm` to ahead-of-time compile schemas for the validator virtual machine.
-Pass `backend: :native` to use the experimental Rust VM extension. Building the
-native extension requires a C toolchain, Ruby development headers, and Rust
-1.93 or newer. If cargo is absent, gem installation skips the optional native
+Pass `backend: :native` to use the experimental Rust VM extension. Releases
+include precompiled gems on RubyGems.org for CRuby 4.0 on these platforms:
+
+| OS | CPU | libc | Gem platform |
+| --- | --- | --- | --- |
+| Linux | x64 | glibc 2.36+ | `x86_64-linux-gnu` |
+| Linux | arm64 | glibc 2.36+ | `aarch64-linux-gnu` |
+| Linux | x64 | musl (Alpine 3.23+) | `x86_64-linux-musl` |
+| Linux | arm64 | musl (Alpine 3.23+) | `aarch64-linux-musl` |
+| macOS 14+ | x64 | — | `x86_64-darwin` |
+| macOS 14+ | arm64 | — | `arm64-darwin` |
+
+RubyGems/Bundler selects the matching platform gem during normal installation;
+these gems need no C compiler, Rust, or Ruby development headers. Each platform
+gem bundles its supported Ruby minor ABIs and restricts `required_ruby_version`
+to that range. Ruby patch releases share the same binary. To build from source,
+use `gem install schemurai --platform ruby` or Bundler's `force_ruby_platform`.
+See [native gem releases](docs/native-gem-releases.md) for the build matrix.
+
+Building the native extension from source requires a C toolchain, Ruby
+development headers, and Rust 1.93 or newer. If cargo is absent, installation of
+the source gem skips the optional native
 extension and Ruby/VM remain available; explicitly selecting `:native` then
 raises `LoadError`. Native execution borrows Ruby values directly; its current coverage and
 remaining VM delegation are documented below.

data/ext/schemurai_native/Cargo.lock

@@ -11,6 +11,12 @@ dependencies = [
  "memchr",
 ]
 
+[[package]]
+name = "autocfg"
+version = "1.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f2032f911046de80f0a198e0901378627c33f59ea0ac00e363d481118bd70a53"
+
 [[package]]
 name = "base64-simd"
 version = "0.8.0"
@@ -51,6 +57,55 @@ version = "2.8.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98"
 
+[[package]]
+name = "num-bigint"
+version = "0.4.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c89e69e7e0f03bea5ef08013795c25018e101932225a656383bd384495ecc367"
+dependencies = [
+ "num-integer",
+ "num-traits",
+]
+
+[[package]]
+name = "num-bigint"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "93e7820bc0a80a0238e650327316f929ba18d5be054b647490a3a6a339f3e7c0"
+dependencies = [
+ "num-integer",
+ "num-traits",
+]
+
+[[package]]
+name = "num-integer"
+version = "0.1.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7ce2d95d4b3734dc35aa2f45e1aa22cd416814592a4f9d9205e11affd5b8e10b"
+dependencies = [
+ "num-traits",
+]
+
+[[package]]
+name = "num-rational"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f83d14da390562dca69fc84082e73e548e1ad308d24accdedd2720017cb37824"
+dependencies = [
+ "num-bigint 0.4.8",
+ "num-integer",
+ "num-traits",
+]
+
+[[package]]
+name = "num-traits"
+version = "0.2.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
+dependencies = [
+ "autocfg",
+]
+
 [[package]]
 name = "outref"
 version = "0.5.2"
@@ -82,11 +137,14 @@ checksum = "9774ba4a74de5f7b1c1451ed6cd5285a32eddb5cccb8cc655a4e50009e06477f"
 
 [[package]]
 name = "schemurai-native"
-version = "3.0.1"
+version = "3.1.0"
 dependencies = [
  "base64-simd",
  "base64-turbo",
  "memchr",
+ "num-bigint 0.5.1",
+ "num-rational",
+ "num-traits",
  "regex-automata",
  "regex-syntax",
  "ryu",

data/ext/schemurai_native/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "schemurai-native"
-version = "3.0.1"
+version = "3.1.0"
 edition = "2024"
 rust-version = "1.93"
 publish = false
@@ -9,6 +9,9 @@ publish = false
 base64-simd = "0.8.0"
 base64-turbo = "0.5.0"
 memchr = "2.8.3"
+num-bigint = "0.5.1"
+num-rational = { version = "0.4.2", default-features = false, features = ["std"] }
+num-traits = "0.2.19"
 regex-automata = "0.4.18"
 regex-syntax = "0.8.11"
 ryu = "1.0.23"

data/ext/schemurai_native/extconf.rb

@@ -2,6 +2,10 @@
 
 require "mkmf"
 
+# Platform gems resolve Ruby symbols from the running interpreter so the same
+# binary also works with Rubies built without a shared libruby.
+$LIBRUBYARG = "" unless enable_config("link-ruby", true) # rubocop:disable Style/GlobalVars -- mkmf build configuration.
+
 unless find_executable("cargo")
   warn "cargo was not found; skipping the optional native backend (Ruby and VM remain available)"
   File.write("Makefile", dummy_makefile(".").join)
@@ -57,7 +61,7 @@ File.open("Makefile", "a") do |file|
 
     glue.o: $(srcdir)/protocol.h $(srcdir)/protocol.def
 
-    $(srcdir)/target/release/libschemurai_native.a: $(srcdir)/Cargo.toml $(srcdir)/Cargo.lock $(srcdir)/build.rs $(srcdir)/protocol.def $(wildcard $(srcdir)/src/*.rs)
+    $(srcdir)/target/release/libschemurai_native.a: $(srcdir)/Cargo.toml $(srcdir)/Cargo.lock $(srcdir)/build.rs $(srcdir)/protocol.def $(wildcard $(srcdir)/src/*.rs $(srcdir)/src/*/*.rs)
     \tcargo build --manifest-path $(srcdir)/Cargo.toml --release --locked
   MAKE
 end