RubyGems - protovalidate - Versions diffs - 0.1.0.beta1 - Mend

protovalidate 0.1.0.beta1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1827) hide show

data/ext/protovalidate/Cargo.lock ADDED Viewed

@@ -0,0 +1,342 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+[[package]]
+name = "aho-corasick"
+version = "1.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c982642fa9e8606056828ee9a8505737230110bb1099153c79efe865c59d12ba"
+dependencies = [
+ "memchr",
+]
+[[package]]
+name = "bindgen"
+version = "0.72.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "993776b509cfb49c750f11b8f07a46fa23e0a1386ffc01fb1e7d343efc387895"
+dependencies = [
+ "bitflags",
+ "cexpr",
+ "clang-sys",
+ "itertools",
+ "proc-macro2",
+ "quote",
+ "regex",
+ "rustc-hash",
+ "shlex 1.3.0",
+ "syn",
+]
+[[package]]
+name = "bitflags"
+version = "2.13.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3ded4057c258ba199e2d26386d3af3780957ecaee6c4ef4041c6b4b8b97c0b06"
+[[package]]
+name = "cc"
+version = "1.4.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "54413ede23c2daf518f35156dfde027feb2374004d63bd497f983c8db9c0e313"
+dependencies = [
+ "find-msvc-tools",
+ "jobserver",
+ "libc",
+ "shlex 2.0.1",
+]
+[[package]]
+name = "cexpr"
+version = "0.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6fac387a98bb7c37292057cffc56d62ecb629900026402633ae9160df93a8766"
+dependencies = [
+ "nom",
+]
+[[package]]
+name = "cfg-if"
+version = "1.0.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4e7648175b45a9a48536d676f68d918270699102aa8dab5496df06904c914600"
+[[package]]
+name = "clang-sys"
+version = "1.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "157a8ba7b480713b56f4c09fd13fc3e0a22a5dfab8097ba61cbc5feef950788a"
+dependencies = [
+ "glob",
+ "libc",
+ "libloading",
+]
+[[package]]
+name = "either"
+version = "1.18.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "252afb9ae5eaa683babdc6a068b3f5726eb19e05070c731f9b2a23a7c3e8ed34"
+[[package]]
+name = "find-msvc-tools"
+version = "0.1.13"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ef25905e51abafe4dcea6c15fec58c57b601cdbd0ee53d22ea1d3016c587d39b"
+[[package]]
+name = "getrandom"
+version = "0.4.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "300e883d756b2e4ec94e02791f39b04b522276138852cfc41d9fb7e904106099"
+dependencies = [
+ "cfg-if",
+ "libc",
+ "r-efi",
+]
+[[package]]
+name = "glob"
+version = "0.3.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e4eba85ea1d0a966a983acd07deee566e67395d2d96b6fb39e62b5a833f1eb0b"
+[[package]]
+name = "itertools"
+version = "0.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "413ee7dfc52ee1a4949ceeb7dbc8a33f2d6c088194d9f922fb8318faf1f01186"
+dependencies = [
+ "either",
+]
+[[package]]
+name = "jobserver"
+version = "0.1.35"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1c00acbd29eabad4a2392fa0e921c874934dbbf4194312ad20f04a0ed67a3cb3"
+dependencies = [
+ "getrandom",
+ "libc",
+]
+[[package]]
+name = "lazy_static"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bbd2bcb4c963f2ddae06a2efc7e9f3591312473c50c6685e1f298068316e66fe"
+[[package]]
+name = "libc"
+version = "0.2.189"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3eaf3ede3fee6db1a4c2ee091bf8a8b4dccdc6d17f656fb07896ee72867612f2"
+[[package]]
+name = "libloading"
+version = "0.8.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d7c4b02199fee7c5d21a5ae7d8cfa79a6ef5bb2fc834d6e9058e89c825efdc55"
+dependencies = [
+ "cfg-if",
+ "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"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98"
+[[package]]
+name = "minimal-lexical"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "68354c5c6bd36d73ff3feceb05efa59b6acb7626617f4962be322a825e61f79a"
+[[package]]
+name = "nom"
+version = "7.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d273983c5a657a70a3e8f2a01329822f3b8c8172b73826411a55751e404a0a4a"
+dependencies = [
+ "memchr",
+ "minimal-lexical",
+]
+[[package]]
+name = "proc-macro2"
+version = "1.0.107"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
+dependencies = [
+ "unicode-ident",
+]
+[[package]]
+name = "protovalidate-cc-sys"
+version = "0.1.0"
+dependencies = [
+ "cc",
+]
+[[package]]
+name = "protovalidate_native"
+version = "0.1.0"
+dependencies = [
+ "magnus",
+ "protovalidate-cc-sys",
+ "rb-sys",
+ "rb-sys-env",
+]
+[[package]]
+name = "quote"
+version = "1.0.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
+dependencies = [
+ "proc-macro2",
+]
+[[package]]
+name = "r-efi"
+version = "6.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8dcc9c7d52a811697d2151c701e0d08956f92b0e24136cf4cf27b57a6a0d9bf"
+[[package]]
+name = "rb-sys"
+version = "0.9.130"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "02faf625bb10ba893e3ae620f19c9fb1b5f8fcae0fe4eb86bb3f2230fad75edb"
+dependencies = [
+ "rb-sys-build",
+]
+[[package]]
+name = "rb-sys-build"
+version = "0.9.130"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "05be6f9c86fe5482808162826f6c047d093b3670582296c770de1d94f8066694"
+dependencies = [
+ "bindgen",
+ "lazy_static",
+ "proc-macro2",
+ "quote",
+ "regex",
+ "shell-words",
+ "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"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f020237b6c8eed93db2e2cb53c00c60a8e1bc73da7d073199a1180401450218d"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-automata",
+ "regex-syntax",
+]
+[[package]]
+name = "regex-automata"
+version = "0.4.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ad8553b9b26413251cbf30e620595c7a41b3887f03da04579c0e6b0d6a06b4b2"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-syntax",
+]
+[[package]]
+name = "regex-syntax"
+version = "0.8.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d6f6ff9a378485b298a5286656da665ba74413d36db0979633275d2e708145d4"
+[[package]]
+name = "rustc-hash"
+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"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dc6fe69c597f9c37bfeeeeeb33da3530379845f10be461a66d16d03eca2ded77"
+[[package]]
+name = "shlex"
+version = "1.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"
+[[package]]
+name = "shlex"
+version = "2.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8fadd59c855ef2080decdef8ff161eb6661b86933c9d82e5ba29dc602a55aba"
+[[package]]
+name = "syn"
+version = "2.0.119"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+[[package]]
+name = "unicode-ident"
+version = "1.0.26"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d245f478577f809a851594d02313b640fb437e0bb33866753cff937863096954"
+[[package]]
+name = "windows-link"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"

data/ext/protovalidate/Cargo.toml ADDED Viewed

@@ -0,0 +1,27 @@
+[package]
+name = "protovalidate_native"
+version = "0.1.0"
+edition = "2024"
+publish = false
+description = "Ruby native extension for the protovalidate gem"
+license = "Apache-2.0"
+[lib]
+crate-type = ["cdylib"]
+[dependencies]
+magnus = "0.8"
+rb-sys = { version = "0.9.130", default-features = false, features = ["stable-api-compiled-fallback"] }
+protovalidate-cc-sys = { path = "sys" }
+[build-dependencies]
+rb-sys-env = "0.2"
+[workspace]
+members = ["sys"]
+[profile.release]
+debug = 0
+strip = true
+lto = true
+codegen-units = 1

data/ext/protovalidate/build.rs ADDED Viewed

@@ -0,0 +1,4 @@
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    let _ = rb_sys_env::activate()?;
+    Ok(())
+}

data/ext/protovalidate/extconf.rb ADDED Viewed

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+require "mkmf"
+require "rb_sys/mkmf"
+create_rust_makefile("protovalidate/protovalidate_native") do |r|
+  r.profile = ENV.fetch("RB_SYS_CARGO_PROFILE", :release).to_sym
+end

data/ext/protovalidate/src/lib.rs ADDED Viewed

@@ -0,0 +1,161 @@
+//! Ruby binding to the protovalidate-cc engine, exposed as
+//! `Protovalidate::Native::Engine`. Only bytes cross the boundary: serialized
+//! `FileDescriptorProto`s and messages in, serialized `buf.validate.Violations`
+//! out. Everything else, including the error classes, is defined in Ruby.
+use magnus::Module as _;
+use magnus::Object as _;
+/// The engine, shared between Ruby threads. `validate` takes the read lock and
+/// `add_file` the write lock, matching the shim's thread-safety contract.
+#[magnus::wrap(class = "Protovalidate::Native::Engine", free_immediately)]
+struct Engine {
+    inner: std::sync::RwLock<protovalidate_cc_sys::Engine>,
+}
+impl Engine {
+    fn new(ruby: &magnus::Ruby) -> Result<Self, magnus::Error> {
+        let inner = protovalidate_cc_sys::Engine::new()
+            .map_err(|message| crate::protovalidate_error(ruby, "Error", message))?;
+        Ok(Self {
+            inner: std::sync::RwLock::new(inner),
+        })
+    }
+    /// Adds a serialized `FileDescriptorProto` to the engine's descriptor pool.
+    fn add_file(
+        ruby: &magnus::Ruby,
+        rb_self: &Self,
+        file: magnus::RString,
+    ) -> Result<(), magnus::Error> {
+        // SAFETY: the bytes are copied out before any other Ruby call.
+        let bytes = unsafe { file.as_slice() }.to_vec();
+        let mut engine = rb_self
+            .inner
+            .write()
+            .unwrap_or_else(std::sync::PoisonError::into_inner);
+        engine
+            .add_file(&bytes)
+            .map_err(|error| crate::to_ruby_error(ruby, error))
+    }
+    /// Validates a serialized message of the named type, returning serialized
+    /// violations or `nil` when it is valid.
+    fn validate(
+        ruby: &magnus::Ruby,
+        rb_self: &Self,
+        type_name: String,
+        payload: magnus::RString,
+        fail_fast: bool,
+    ) -> Result<Option<magnus::RString>, magnus::Error> {
+        // SAFETY: the bytes are copied out before any other Ruby call, and the
+        // copy is what the GVL-free section reads.
+        let payload = unsafe { payload.as_slice() }.to_vec();
+        let result = crate::gvl::without_gvl(|| {
+            let engine = rb_self
+                .inner
+                .read()
+                .unwrap_or_else(std::sync::PoisonError::into_inner);
+            engine.validate(&type_name, &payload, fail_fast)
+        });
+        match result {
+            Ok(None) => Ok(None),
+            Ok(Some(buffer)) => Ok(Some(ruby.str_from_slice(buffer.as_slice()))),
+            Err(error) => Err(crate::to_ruby_error(ruby, error)),
+        }
+    }
+}
+/// Maps an engine failure onto the Ruby error hierarchy. The
+/// compilation/evaluation split is observable behaviour: the conformance
+/// harness buckets results by it.
+fn to_ruby_error(ruby: &magnus::Ruby, error: protovalidate_cc_sys::PvError) -> magnus::Error {
+    match error {
+        protovalidate_cc_sys::PvError::Compilation(message) => {
+            crate::protovalidate_error(ruby, "CompilationError", message)
+        }
+        protovalidate_cc_sys::PvError::Evaluation(message) => {
+            crate::protovalidate_error(ruby, "EvaluationError", message)
+        }
+        protovalidate_cc_sys::PvError::Argument(message) => {
+            magnus::Error::new(ruby.exception_arg_error(), message)
+        }
+        protovalidate_cc_sys::PvError::Unexpected(message) => {
+            crate::protovalidate_error(ruby, "Error", message)
+        }
+        protovalidate_cc_sys::PvError::Unknown(code, message) => {
+            crate::protovalidate_error(ruby, "Error", format!("unknown status {code}: {message}"))
+        }
+    }
+}
+/// An error of the class `Protovalidate::<name>`, defined by the Ruby side of
+/// the gem before this extension is loaded.
+fn protovalidate_error(ruby: &magnus::Ruby, name: &str, message: String) -> magnus::Error {
+    let class = ruby
+        .class_object()
+        .const_get::<_, magnus::RModule>("Protovalidate")
+        .and_then(|module| module.const_get::<_, magnus::ExceptionClass>(name));
+    match class {
+        Ok(class) => magnus::Error::new(class, message),
+        Err(lookup_error) => lookup_error,
+    }
+}
+mod gvl {
+    struct Slot<F, R> {
+        func: Option<F>,
+        result: Option<std::thread::Result<R>>,
+    }
+    unsafe extern "C" fn trampoline<F, R>(data: *mut std::ffi::c_void) -> *mut std::ffi::c_void
+    where
+        F: FnOnce() -> R,
+    {
+        // SAFETY: `data` is the `Slot` that `without_gvl` keeps alive on its
+        // stack for the duration of the call.
+        let slot = unsafe { &mut *data.cast::<Slot<F, R>>() };
+        let func = slot.func.take().expect("the callback runs once");
+        // A panic must not unwind through Ruby's C frames.
+        slot.result = Some(std::panic::catch_unwind(std::panic::AssertUnwindSafe(func)));
+        std::ptr::null_mut()
+    }
+    /// Runs `func` with the GVL released. The closure must not touch Ruby.
+    pub(crate) fn without_gvl<F, R>(func: F) -> R
+    where
+        F: FnOnce() -> R,
+    {
+        let mut slot: Slot<F, R> = Slot {
+            func: Some(func),
+            result: None,
+        };
+        // SAFETY: the trampoline reads `slot` only while this frame is live.
+        // No unblocking function is registered, so interrupts are delivered
+        // once the (short, CPU-bound) validation returns.
+        unsafe {
+            rb_sys::rb_thread_call_without_gvl(
+                Some(trampoline::<F, R>),
+                (&raw mut slot).cast::<std::ffi::c_void>(),
+                None,
+                std::ptr::null_mut(),
+            );
+        }
+        match slot.result.take().expect("the callback ran") {
+            Ok(value) => value,
+            Err(payload) => std::panic::resume_unwind(payload),
+        }
+    }
+}
+#[magnus::init]
+fn init(ruby: &magnus::Ruby) -> Result<(), magnus::Error> {
+    let module = ruby
+        .define_module("Protovalidate")?
+        .define_module("Native")?;
+    let class = module.define_class("Engine", ruby.class_object())?;
+    class.define_singleton_method("new", magnus::function!(Engine::new, 0))?;
+    class.define_method("add_file", magnus::method!(Engine::add_file, 1))?;
+    class.define_method("validate", magnus::method!(Engine::validate, 3))?;
+    Ok(())
+}

data/ext/protovalidate/sys/Cargo.toml ADDED Viewed

@@ -0,0 +1,11 @@
+[package]
+name = "protovalidate-cc-sys"
+version = "0.1.0"
+edition = "2024"
+publish = false
+links = "protovalidate_cc"
+description = "protovalidate-cc and its C++ dependencies, compiled from vendored sources behind a small C ABI"
+license = "Apache-2.0"
+[build-dependencies]
+cc = { version = "1", features = ["parallel"] }