zrip 0.1.2 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3a2a6ebe092e7300362703f683d2716ffc66750bd51e4b4f9cd62d1e6aef1a5c
-  data.tar.gz: ea416eb330e63ba0f228bc2f5cf43f217d03f5e87cf57df0c6c0ae5c4e9c4e11
+  metadata.gz: 8a16cab574ece332812f7e25c48b75152a11c63418619527273e974353c7279b
+  data.tar.gz: 9504303323b72ca6b079ddcb528a3be99d550a56125241c669613221d5aea4e7
 SHA512:
-  metadata.gz: 5b5a2ee2834a146ccd72b7c08bbf20fbe60409377055bf4be840338baa3101f21fd3fc800e5bf2faee5fc211600ea5d853088d9f78702e59876acd0fcc18cf27
-  data.tar.gz: 25ecf73ec1e2d9874672ef06f4fc55e5e9a09eb522b1c3c55c4ee87032d4572330725c555fd54e4314f4e3454f78daf076ebac43ddeb03c44014d9d79d7e1d57
+  metadata.gz: f80dfc72c92ce4a072d186ba75efa88f88281aab64cc94a19d15e3e15f1548aa52fa7b9cec4d7593db1dc6b4a8ac37cf28e37d14cb38beb059d85f7b6c460288
+  data.tar.gz: 910c850499f28d49c02fdfca756770a4d182ac7688891efa7cccc920f1dd2180b30fbcb984cf8b34e143d049374cd0d6da947f5f8f55998a89d9183753a17c9b

data/CHANGELOG.md

@@ -2,6 +2,39 @@
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-10-11
+
+- Update the `zrip` crate dependency to 0.8.11 and `rb-sys` to 0.9.130.
+- Make `FrameCodec` instances Ractor-shareable as documented, with native
+  dictionary copies that leave caller strings mutable.
+- Unlock input strings and free native results when Ruby interrupts a call
+  that released the GVL.
+- Protect mutable inputs when mutex contention releases the GVL, including
+  calls below the normal size threshold.
+- Catch Rust panics inside native callbacks instead of aborting the process.
+- Preserve Ruby exceptions, `Thread#kill`, and `catch`/`throw` through
+  protected native calls.
+- Avoid trainer deadlocks during sample coercion and borrow decompression
+  input after size coercion.
+- Enforce `max_output_size:` inside the native decoder across concatenated
+  frames, before allocating or decoding past the limit.
+- Validate complete frame headers when reading frame content sizes.
+- Correct the README compression level example to the supported maximum.
+- Update GitHub Actions checkout to v7 and check Rust tests, formatting, and
+  Clippy in CI.
+
+## [0.2.0] - 2026-08-07
+
+- Release the Ruby GVL around large frame/block compression and frame
+  decompression calls.
+- Update the `zrip` crate dependency to 0.8.5.
+- Replace Magnus with direct `rb-sys` bindings, add TruffleRuby build support,
+  and lower the Ruby requirement to 3.4.
+- Apply `max_output_size:` to the total decompressed output of concatenated
+  Zstandard frames.
+- Add RubyDoc metadata and move API reference details from `README.md` into
+  YARD comments.
+
 ## [0.1.2] - 2026-08-05
 
 - Update `zrip` crate dependency from 0.8.3 to 0.8.4.

data/Cargo.lock

@@ -31,9 +31,9 @@ dependencies = [
 
 [[package]]
 name = "bitflags"
-version = "2.13.1"
+version = "2.13.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b588b76d00fde79687d7646a9b5bdf3cc0f655e0bbd080335a95d7e96f3587da"
+checksum = "3ded4057c258ba199e2d26386d3af3780957ecaee6c4ef4041c6b4b8b97c0b06"
 
 [[package]]
 name = "cexpr"
@@ -46,9 +46,9 @@ dependencies = [
 
 [[package]]
 name = "cfg-if"
-version = "1.0.4"
+version = "1.0.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+checksum = "4e7648175b45a9a48536d676f68d918270699102aa8dab5496df06904c914600"
 
 [[package]]
 name = "clang-sys"
@@ -63,15 +63,15 @@ dependencies = [
 
 [[package]]
 name = "either"
-version = "1.17.0"
+version = "1.19.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9e5e8f6c15a24b9a3ee5efec809ccd006d3b30e8b3bb63c39af737c7f87daa1d"
+checksum = "0e9c71c2167ca323c882b99918929403426e2373ea17242ff5653e0d5e1058be"
 
 [[package]]
 name = "fearless_simd"
-version = "0.6.0"
+version = "1.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e0f5f895dac0865bc235f1364793899569a7db538137f1024dccea56bf41c78d"
+checksum = "3296eb97d869113eaf148a6bdf01884e90b3828ad7ae2340b0f93362fc158611"
 
 [[package]]
 name = "glob"
@@ -90,15 +90,15 @@ dependencies = [
 
 [[package]]
 name = "lazy_static"
-version = "1.5.0"
+version = "1.5.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bbd2bcb4c963f2ddae06a2efc7e9f3591312473c50c6685e1f298068316e66fe"
+checksum = "20870f649af7073d53e38067b2a84312175d56ea15217e1b15bc83506ec50afb"
 
 [[package]]
 name = "libc"
-version = "0.2.189"
+version = "0.2.190"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3eaf3ede3fee6db1a4c2ee091bf8a8b4dccdc6d17f656fb07896ee72867612f2"
+checksum = "ce5d3ddc6d3fa000eb1536d85e147bfe31aacaba692ed6a876f95cb7c855be78"
 
 [[package]]
 name = "libloading"
@@ -110,29 +110,6 @@ dependencies = [
  "windows-link",
 ]
 
-[[package]]
-name = "magnus"
-version = "0.8.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3b36a5b126bbe97eb0d02d07acfeb327036c6319fd816139a49824a83b7f9012"
-dependencies = [
- "magnus-macros",
- "rb-sys",
- "rb-sys-env",
- "seq-macro",
-]
-
-[[package]]
-name = "magnus-macros"
-version = "0.8.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "47607461fd8e1513cb4f2076c197d8092d921a1ea75bd08af97398f593751892"
-dependencies = [
- "proc-macro2",
- "quote",
- "syn",
-]
-
 [[package]]
 name = "memchr"
 version = "2.8.3"
@@ -175,18 +152,18 @@ dependencies = [
 
 [[package]]
 name = "rb-sys"
-version = "0.9.128"
+version = "0.9.130"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "45ca28513560e56cfb79a62b1fce363c73af170a182024ce880c77ee9429920a"
+checksum = "02faf625bb10ba893e3ae620f19c9fb1b5f8fcae0fe4eb86bb3f2230fad75edb"
 dependencies = [
  "rb-sys-build",
 ]
 
 [[package]]
 name = "rb-sys-build"
-version = "0.9.128"
+version = "0.9.130"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ce04b2c55eff3a21aaa623fcc655d94373238e72cac6b3e1a3641ff31649f99a"
+checksum = "05be6f9c86fe5482808162826f6c047d093b3670582296c770de1d94f8066694"
 dependencies = [
  "bindgen",
  "lazy_static",
@@ -197,12 +174,6 @@ dependencies = [
  "syn",
 ]
 
-[[package]]
-name = "rb-sys-env"
-version = "0.2.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cca7ad6a7e21e72151d56fe2495a259b5670e204c3adac41ee7ef676ea08117a"
-
 [[package]]
 name = "regex"
 version = "1.13.1"
@@ -238,12 +209,6 @@ version = "2.1.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "6b1e7f9a428571be2dc5bc0505c13fb6bf936822b894ec87abf8a08a4e51742d"
 
-[[package]]
-name = "seq-macro"
-version = "0.3.6"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1bc711410fbe7399f390ca1c3b60ad0f53f80e95c5eb935e52268a0e2cd49acc"
-
 [[package]]
 name = "shell-words"
 version = "1.1.1"
@@ -269,9 +234,9 @@ dependencies = [
 
 [[package]]
 name = "unicode-ident"
-version = "1.0.24"
+version = "1.0.26"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+checksum = "d245f478577f809a851594d02313b640fb437e0bb33866753cff937863096954"
 
 [[package]]
 name = "windows-link"
@@ -281,18 +246,17 @@ checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
 
 [[package]]
 name = "zrip"
-version = "0.1.2"
+version = "0.2.1"
 dependencies = [
- "magnus",
  "rb-sys",
- "zrip 0.8.4",
+ "zrip 0.8.11",
 ]
 
 [[package]]
 name = "zrip"
-version = "0.8.4"
+version = "0.8.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1d6514da35b51d81bfc515782396980ac909fe46925fd19701b36329ddec46e8"
+checksum = "9e85bd0b02784d8753fe5cc435dfb65043be505cb621643a3ac4a0c43eb49e4a"
 dependencies = [
  "zrip-core",
  "zrip-decode",
@@ -301,15 +265,15 @@ dependencies = [
 
 [[package]]
 name = "zrip-core"
-version = "0.9.1"
+version = "0.11.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9335acd94c1f09f729178fc339f9d49790254c1e98ba076f88df3a3f534c4e7d"
+checksum = "6dec95be8c75252532ba0ef5e738d9da26a6f51ad52cb45f4ed90c89979727c1"
 
 [[package]]
 name = "zrip-decode"
-version = "0.8.4"
+version = "0.8.10"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "16c26a2ea54a97d013b6f2a430b659fb77e0d5feb0aa3f80cb8c141d6827beba"
+checksum = "aca029cf83b6a6e282008a9aa1079e13f216b28bac670eb1fb0769c1d256cb0e"
 dependencies = [
  "fearless_simd",
  "zrip-core",
@@ -317,9 +281,10 @@ dependencies = [
 
 [[package]]
 name = "zrip-encode"
-version = "0.8.4"
+version = "0.9.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "38e7e22b665b947f0240b44805713e87a15c34e86d0891cbe2856c575c5cda1d"
+checksum = "b657fa83287fe6799596e53540a7b1f179ca34ffd8589d5c576a5b8a1bcc4260"
 dependencies = [
+ "fearless_simd",
  "zrip-core",
 ]

data/Cargo.toml

@@ -6,4 +6,3 @@ resolver = "2"
 opt-level     = 3
 lto           = true
 codegen-units = 1
-panic         = "abort"

data/README.md

@@ -1,13 +1,13 @@
-# zrip — Ractor-safe Zstandard for Ruby
+# zrip: Ractor-safe Zstandard for Ruby
 
 [![CI](https://github.com/paddor/zrip-rb/actions/workflows/ci.yml/badge.svg)](https://github.com/paddor/zrip-rb/actions/workflows/ci.yml)
 [![Gem Version](https://img.shields.io/gem/v/zrip?color=e9573f)](https://rubygems.org/gems/zrip)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![Ruby](https://img.shields.io/badge/Ruby-%3E%3D%204.0-CC342D?logo=ruby&logoColor=white)](https://www.ruby-lang.org)
+[![Ruby](https://img.shields.io/badge/Ruby-%3E%3D%203.4-CC342D?logo=ruby&logoColor=white)](https://www.ruby-lang.org)
 
 Ruby bindings for [zrip](https://crates.io/crates/zrip), a pure-Rust Zstandard
-implementation. Built with [magnus](https://github.com/matsadler/magnus) and
-declared Ractor-safe so you can compress from any Ractor without a global lock.
+implementation. Built as an `rb-sys` native extension and declared Ractor-safe
+so you can compress from any Ractor without a global lock.
 
 ## Features
 
@@ -22,7 +22,7 @@ declared Ractor-safe so you can compress from any Ractor without a global lock.
 
 ## Install
 
-Requires Ruby >= 4.0 and a Rust toolchain (for building the native extension):
+Requires Ruby >= 3.4 and a Rust toolchain (for building the native extension):
 
 ```sh
 gem install zrip
@@ -58,7 +58,7 @@ original   = codec.decompress(compressed)
 
 ```ruby
 fast   = Zrip::FrameCodec.new(level: -3)   # negative = faster
-strong = Zrip::FrameCodec.new(level: 19)    # higher = smaller output
+strong = Zrip::FrameCodec.new(level: 4)    # highest supported level
 ```
 
 ### Bounded decompression
@@ -66,8 +66,8 @@ strong = Zrip::FrameCodec.new(level: 19)    # higher = smaller output
 ```ruby
 codec = Zrip::FrameCodec.new
 
-# Limit output size to 1 MiB
-codec.decompress(compressed, max_output_size: 1_048_576)
+# Limit total output size to 1 MiB
+codec.decompress(compressed, max_output_size: 1024 * 1024)
 
 # Read frame content size from header (without decompressing)
 Zrip::FrameCodec.get_frame_content_size(compressed)  #=> 12000
@@ -96,6 +96,9 @@ codec = Zrip::FrameCodec.new(dict: dict)
 
 ### Ractor safety
 
+On Ruby VMs without Ractor support, the codecs still work normally; the
+Ractor-specific guarantees and examples do not apply.
+
 ```ruby
 codec = Zrip::FrameCodec.new
 
@@ -111,39 +114,9 @@ end
 ractors.each { |r| p r.value }  # => :ok, :ok, :ok, :ok
 ```
 
-## API
-
-| Class / Module | Method | Description |
-|---|---|---|
-| `Zrip::FrameCodec` | `.new(dict: nil, level: 1)` | Create a frame codec, optionally with a `Dictionary`, raw `String` dict, or compression level |
-| | `.get_frame_content_size(string)` | Read Frame_Content_Size from a Zstd frame header |
-| | `#compress(string)` | Compress to Zstd frame |
-| | `#decompress(string, max_output_size: nil)` | Decompress a Zstd frame, optionally bounded |
-| | `#has_dict?` | Whether a dictionary is loaded |
-| | `#id` | Dictionary ID (nil without dict) |
-| | `#size` | Dictionary size in bytes (0 without dict) |
-| | `#level` | Compression level |
-| `Zrip::BlockCodec` | `.new(dict: nil, level: 1)` | Create a block codec, optionally with a dict |
-| | `#compress(string)` | Compress to Zstd block |
-| | `#decompress(string, max_output_size: nil)` | Decompress a Zstd block, optionally bounded |
-| | `#has_dict?` | Whether a dictionary is loaded |
-| | `#size` | Dictionary size in bytes (0 without dict) |
-| | `#level` | Compression level |
-| `Zrip::Dictionary` | `.new(bytes:, id: nil)` | Immutable dictionary value object (`Data.define`) |
-| | `#bytes` | Frozen binary dict bytes |
-| | `#id` | 32-bit dictionary ID (auto-detected from ZDICT header or SHA-256) |
-| | `#size` | Dictionary size in bytes |
-| `Zrip::DictTrainer` | `.new(max_dict_size)` | Create a trainer |
-| | `#add_sample(string)` | Feed a training sample (skips < 4 bytes) |
-| | `#train` | Consume the trainer, return dict bytes |
-| | `#sample_count` | Number of accepted samples |
-| | `#total_bytes` | Total bytes of accepted samples |
-| | `#trained?` | Whether `#train` has been called |
-| | `#max_dict_size` | Configured max dict size |
-| `Zrip::DecompressError` | | Raised on decompression failure |
-| `Zrip::CompressError` | | Raised on compression failure |
-| `Zrip::MissingContentSizeError` | | Raised when Frame_Content_Size is absent (subclass of `DecompressError`) |
-| `Zrip::OutputSizeLimitError` | | Raised when declared content size exceeds limit (subclass of `DecompressError`) |
+## Documentation
+
+Reference: <https://rubydoc.info/gems/zrip>
 
 ## License
 

data/ext/zrip/Cargo.toml

@@ -1,16 +1,16 @@
 [package]
 name    = "zrip"
-version = "0.1.2"
+version = "0.2.1"
 edition = "2021"
+build   = "build.rs"
 
 [lib]
 name       = "zrip"
 crate-type = ["cdylib", "rlib"]
 
 [dependencies]
-zstd   = { version = "0.8.4", package = "zrip", features = ["frame", "dict_builder"] }
-magnus = "0.8"
-rb-sys = "0.9"
+zstd   = { version = "0.8.11", package = "zrip", features = ["frame", "dict_builder"] }
+rb-sys = "0.9.130"
 
 [build-dependencies]
-rb-sys = "0.9"
+rb-sys = "0.9.130"

data/ext/zrip/build.rs

@@ -0,0 +1,23 @@
+use std::process::Command;
+
+fn main() {
+    println!("cargo:rerun-if-env-changed=RUBY");
+    println!("cargo:rustc-check-cfg=cfg(ruby_engine, values(\"mri\", \"truffleruby\"))");
+
+    let ruby = std::env::var("RUBY").unwrap_or_else(|_| "ruby".to_string());
+    let output = Command::new(&ruby)
+        .arg("-rrbconfig")
+        .arg("-e")
+        .arg("print RbConfig::CONFIG.fetch('ruby_install_name')")
+        .output()
+        .unwrap_or_else(|err| panic!("failed to run {ruby}: {err}"));
+
+    if !output.status.success() {
+        panic!("failed to query Ruby engine with {ruby}");
+    }
+
+    match String::from_utf8_lossy(&output.stdout).trim() {
+        "truffleruby" => println!("cargo:rustc-cfg=ruby_engine=\"truffleruby\""),
+        _ => println!("cargo:rustc-cfg=ruby_engine=\"mri\""),
+    }
+}