real-regex 2026.8.17

Linear-time, ReDoS-safe regular expressions with bounded lookarounds — Rust bindings to the REAL C++ engine.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

// Compiles the header-only REAL engine + the C ABI shim into a static lib the crate links.
// In-tree (the monorepo) always uses the LIVE sibling sources; the vendored copy is used only when packaged
// (off crates.io, where the sibling does not exist). Checking the sibling first — not vendor/ first — means a
// stale vendor/ left by `make crate-vendor` can never silently shadow the live shim during development.
use std::path::Path;

// Emit a rerun-if-changed for every header under `dir`. The shim is a thin .cpp that #includes the whole
// header-only engine, so an engine-header edit does not change the .cpp — without this, cc reuses its cached
// object and the crate silently tests stale engine behaviour (the trap that hid the dollar_endonly change).
fn watch_headers(dir: &Path) {
    let Ok(entries) = std::fs::read_dir(dir) else { return };
    for entry in entries.flatten() {
        let path = entry.path();
        if path.is_dir() {
            watch_headers(&path);
        } else if path.extension().is_some_and(|e| e == "hpp" || e == "h") {
            println!("cargo:rerun-if-changed={}", path.display());
        }
    }
}

fn main() {
    let (include, capi) = if Path::new("../../include/real").exists() {
        ("../../include", "../c") // in-tree: the live sibling sources
    } else {
        ("vendor/include", "vendor/c") // packaged: the vendored copy
    };
    println!("cargo:rerun-if-changed={capi}/real_capi.cpp");
    println!("cargo:rerun-if-changed={capi}/real_capi.h");
    watch_headers(Path::new(&format!("{include}/real")));
    cc::Build::new()
        .cpp(true)
        .std("c++20")
        .include(include)
        .include(capi)
        .file(format!("{capi}/real_capi.cpp"))
        .compile("real_capi");
}