nosj 0.3.2-x86_64-linux → 0.4.1-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ebfb1f3235c863a322c75dcbfa3b7ea1514787d3d20ec4aac4dcee4df7fc4288
-  data.tar.gz: 75141c5cd1f8aeed9c637895d70a390ea8a50f6839223a24f5a9845c29b6a173
+  metadata.gz: 1b1ee57c8d059a5906baba48a25a9cd0ddb58c259110e62b6ce6fe3ba4377e0f
+  data.tar.gz: 312af7ca03bb1ea8bf65d8f55d68d4e5a49f8ebccc512246cd14b6652ddf6f09
 SHA512:
-  metadata.gz: 276f5b7c940d0472c1aa6be96a36291a06c30732a39b1b6410625a4194e5803731c0c89823ea076df7c4e0505b5e7944f614ae135039b3cd73bcc8ee9a5ebe8e
-  data.tar.gz: 56c66d7600e92632d5f310bc01ecb8e8d3416c38be081f128b09949d58927fc03e513426b5de7f30cbfeeba171d6ba061f117256176a4506df5741ed9e1e2300
+  metadata.gz: 7f5cec4abab64a013bddbee26c0813750c3d66942dcb94c50c54f499e0d34e5515b34ffe8f2e4cf1ebc6e4c3647604120e3003194f4f87637d8230314e4eecfc
+  data.tar.gz: 7916c28d532c41a458d8b0b6aa7e6d37a411574728a0b44e7d526dd397bdd6ce8627060a3255ce4f7685931ee778f67c11fa206af97df9d432e1929d89c168ba

data/CHANGELOG.md

@@ -1,3 +1,58 @@
+## [0.4.1] - 2026-09-25
+
+- Fixed a crash in `NOSJ.generate`: an object whose `to_json` or
+  `to_s` shrank the array being generated (for example with
+  `Array#clear`) made the generator read freed memory, usually a
+  segfault. The array length is now re-read for every element, like
+  the json gem, so elements a callback appends are emitted too.
+- Fixed memory corruption in `NOSJ.splice`: a replacement value whose
+  `to_json` modified the source string, deduplicated a frozen String
+  subclass (`-str`), or removed entries from the edits hash could make
+  splice read freed memory, copying unrelated heap bytes into the
+  result or crashing. All values are now generated before the source
+  is read.
+- Fixed `NOSJ.lazy` and `NOSJ.each_line` reading freed memory when the
+  source is a frozen String subclass (such as
+  `ActiveSupport::SafeBuffer`) or a frozen string carrying instance
+  variables, and it is deduplicated with `-str` while the lazy
+  document is alive or between lines: Ruby swaps such a string's
+  buffer, and the old one kept being read (wrong values, or a crash).
+- Fixed a memory leak in `NOSJ.generate` and `NOSJ.write_file`: an
+  exception raised by user code the generator calls bypassed its
+  cleanup and leaked its output buffer (megabytes per call after large
+  documents). Affected: a raising `respond_to?` or
+  `respond_to_missing?`, a raising `to_s` on an encoding-conversion
+  error, a raising autoload of `JSON::Fragment` (strict and Rails
+  modes), and a raising `Errno` constructor for a failed write. The
+  exception still propagates unchanged.
+- Fixed: after a `NoMemoryError` in the middle of a parse (or
+  `minify`/`reformat`), the next call on that thread aborted the whole
+  process. Per-thread parser state is now recovered instead.
+- `NOSJ::Lazy` nodes now take part in generational GC: holding many
+  nodes no longer slows down every minor GC (200,000 live nodes: 2.9 ms
+  per minor GC before, 0.1 ms now), and they are freed immediately
+  when collected.
+- Fixed: lazy documents opened with `allow_trailing_comma: true` or
+  `allow_nan: true` could not be walked. `size`, `keys`, `each`, and
+  any lookup that missed or stepped over a trailing comma or a `NaN`
+  raised `NOSJ::ParserError`, even though `value` worked.
+- `NOSJ.at_pointer`, `NOSJ.at_pointers`, and `NOSJ.at_pointer_file`
+  now honor `allow_nan` and `allow_trailing_comma` while resolving the
+  pointer, not only when materializing the matched value.
+- Updated the nosj crate to 0.2.2.
+- Updated dependencies, Magnus bumped to 0.9.0.
+
+## [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.
@@ -150,7 +151,8 @@ Example: an early field resolves in ~0.35µs where `JSON.parse(json).dig(...)`
 costs ~980µs on the same document—three orders of magnitude. A field
 at the far end of a 570 KB document costs ~71µs, still 13× faster
 than parse-then-dig. Misses return nil; matched subtrees materialize
-with the same options as `parse` (`symbolize_names:`, `freeze:`).
+with the same options as `parse` (`symbolize_names:`, `freeze:`), and
+`allow_nan:`/`allow_trailing_comma:` govern the walk to them too.
 
 ### Files API
 
@@ -300,6 +302,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.1"
 end

data/lib/nosj.rb

@@ -205,7 +205,8 @@ module NOSJ
 
   # Partial parsing by JSON Pointer (with the standard +~0+/+~1+
   # escapes). The matched subtree materializes under the same options
-  # as {.parse}.
+  # as {.parse}; +allow_nan+ and +allow_trailing_comma+ also govern the
+  # walk to it.
   #
   # @example
   #   NOSJ.at_pointer(json, "/users/3/name")  #=> "grace" or nil

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nosj
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.4.1
 platform: x86_64-linux
 authors:
 - Yaroslav Markin
@@ -66,7 +66,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 3.3.11
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 4.0.20
 specification_version: 4
 summary: An extremely fast JSON parser and generator for Ruby, written in Rust and
   SIMD-accelerated on every platform.