nosj 0.3.2-aarch64-linux → 0.4.0-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 10e414d3326f37cb0ce77ac5cf270f1ad1570af4d81a9913ab60f3ddadb7f803
-  data.tar.gz: 68c7283d8fa6f206ffec6256158f61cf051c2c3d420d9e386972a7f1f5936d98
+  metadata.gz: fd883bdfebc07e316c4baa1706cd9ba6b8036645a8cbd0b8b9b5a888c3a0e3c5
+  data.tar.gz: f73808429bfdf03043716ceb4b3d01a3536a4b6d2f1c092f15b54dff52ef9c82
 SHA512:
-  metadata.gz: a591cfc2b26aea52dde5eb3ec512f9b22cc7217cf6e47c8d9c0f0ef1a199c4d55064c3632b490cb5c61ea7149f005fcd5284b91fb2e0fc26fbdd8626fddb2a29
-  data.tar.gz: 5c804ad40c4046c11a6faa07a5f72920a62ea13234436805f19db5306bae516e472a7cd61fb3724d9be2093c94adf625608592d7a0646e95d2d6cd12eaeff7f3
+  metadata.gz: 7dab8b234f37fa22a4ab1a5f0bfb906df9ecb6d85ecba50f63e5634d309387ea0ce4302eda8e2280d182ae69d0067ee852d4b23773d1c1c4164c1b6ed708cadf
+  data.tar.gz: '0909f76cdcd4d49f015ee951d14f785312d91e6cc6ff61c18be8fe5c091f068c546f7a5f2d5a41cbce0db75de9fd4c20ddfbcca249906997f2c7a09fc8380f96'

data/CHANGELOG.md

@@ -1,3 +1,14 @@
+## [0.4.0] - 2026-09-05
+
+- Ractors: on Ruby 4.0+, `NOSJ.parse`, `NOSJ.generate`, and every
+  other entry point (lazy documents, partial parsing, the file APIs,
+  NDJSON, patches, reformatting, statistics) can be called from inside
+  a Ractor. Before this release each of them raised
+  `Ractor::UnsafeError` outside the main Ractor. Values parsed with
+  `freeze: true` are Ractor-shareable, so a document parsed in one
+  Ractor can be handed to another without copying.
+- Updated Rust dependencies.
+
 ## [0.3.2] - 2026-07-19
 
 - **IMPORTANT**—Fixed: the precompiled platform gems linked `libruby`

data/README.md

@@ -16,6 +16,7 @@ faster than Yajl—[see Benchmarks](#benchmarks).
 - It does **byte-splicing edits**: `NOSJ.splice` changes a field inside a passing payload 10–51× faster than parse-mutate-generate, and RFC 6902 JSON Patch / RFC 7386 merge patch apply straight to the raw string.
 - It is **great to debug with**: parse errors carry line, column, and a caret snippet pointing at the break, and `NOSJ.stats` X-rays a mystery blob (depth, value counts, key histogram) faster than parsing it.
 - It accelerates a **Rails** application in both encoding and decoding.
+- It is **Ractor-safe**: call it from any Ractor on Ruby 4.0+, and parse with `freeze: true` to get shareable results.
 - It comes **precompiled** (platform gems built with per-platform optimizations,
 nothing to compile on install).
 - Otherwise, same API and option names as gem json.
@@ -300,6 +301,22 @@ NOSJ.parse(%({\n  "a": 1,\n  "b": }))
 #                         ^
 ```
 
+### Ractors
+
+On Ruby 4.0+, every entry point works inside a Ractor: parse and
+generate, lazy documents, partial parsing, the file APIs, NDJSON,
+patches, reformatting, and statistics.
+
+```ruby
+workers = Array.new(4) do
+  Ractor.new(payload) { |src| NOSJ.parse(src, freeze: true) }
+end
+workers.map(&:value)
+```
+
+`freeze: true` returns deeply frozen, Ractor-shareable values, so a
+document parsed in one Ractor can be handed to another without a copy.
+
 ## Benchmarks
 
 Every installed JSON gem, benchmark-ips: AWS EC2 c7a.2xlarge (AMD EPYC 9R14, Zen 4), Ruby 4.0.6 + YJIT, json 2.21.1, Oj 3.17.4, RapidJSON 0.4.0, FastJsonparser 0.6.0, Yajl 1.4.3, PGO build, 2026-07-16. `×N` = times slower than nosj. 

data/lib/nosj/version.rb

@@ -2,5 +2,5 @@
 
 module NOSJ
   # The gem version.
-  VERSION = "0.3.2"
+  VERSION = "0.4.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nosj
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.4.0
 platform: aarch64-linux
 authors:
 - Yaroslav Markin