vectorscan-rs-sys

Overview

This crate implements minimal Rust bindings to the Vectorscan fork of Hyperscan, the high-performance regular expression engine. This crate builds a vendored copy of Vectorscan from source.

Dependencies

• Boost >= 1.57
• CMake
• patch
• Optional: Clang, when building with the bindgen feature

This has been tested on x86_64 Linux, x86_64 macOS, and aarch64 macOS.

Implementation Notes

This crate was originally written as part of Nosey Parker. It was adapted from the pyperscan project, which uses Rust to expose Hyperscan to Python. (That project is released under either the Apache 2.0 or MIT license.)

The only bindings exposed at present are for Vectorscan's block-based matching APIs. The various other APIs such as stream- and vector-based matching are not exposed. Other features, such as the Chimera PCRE library, test code, benchmark code, and supporting utilities are disabled.

The source of Vectorscan 5.4.11 is included here in the 5.4.11.tar.gz file.

At build time, a patch is applied to the Vectorscan sources. This patch does a few things:

• The CMake-based build system is modified to eliminate the build-time dependency on ragel

• The precompiled version of 4 Ragel .rl files are added to the source tree

• The CMake-based build system is modified to allow disabling several components that are not used in this crate

License

This project is licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE)

• MIT License (LICENSE-MIT)

at your option.

This project contains a vendored copy of Vectorscan, which is released under a 3-clause BSD license (LICENSE-VECTORSCAN).

Contributing

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in vectorscan-rs-sys by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.