nosj 0.3.2-x86_64-linux → 0.4.0-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ebfb1f3235c863a322c75dcbfa3b7ea1514787d3d20ec4aac4dcee4df7fc4288
-  data.tar.gz: 75141c5cd1f8aeed9c637895d70a390ea8a50f6839223a24f5a9845c29b6a173
+  metadata.gz: effa3ad5689bc6b7db21ff87769eb797fb7a5930ed8859b4ff7537e70a8301f4
+  data.tar.gz: 3c0d90a1732b7ec4db785a91754cea7bb0eb2cd97802eaeb3b3018ea45c0e884
 SHA512:
-  metadata.gz: 276f5b7c940d0472c1aa6be96a36291a06c30732a39b1b6410625a4194e5803731c0c89823ea076df7c4e0505b5e7944f614ae135039b3cd73bcc8ee9a5ebe8e
-  data.tar.gz: 56c66d7600e92632d5f310bc01ecb8e8d3416c38be081f128b09949d58927fc03e513426b5de7f30cbfeeba171d6ba061f117256176a4506df5741ed9e1e2300
+  metadata.gz: d54505db98dde8ba148900bae939ef2db8f1d95ca9e837d7acd2eb8efde5dc51f7b576faa5ee79ddf2b306e79ca5dc5c8330760d9521cb076c3c482a38e93a66
+  data.tar.gz: cfd0a649d0afd2c6f18d0ba11e1293fd2bf7030d4d103e23ff8c68df9519308d99660edd4c431eb0fbddd35ed9959e8bff969e9918fac2a1293884772d7cf114

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: x86_64-linux
 authors:
 - Yaroslav Markin