1
0
mirror of https://github.com/BurntSushi/ripgrep.git synced 2025-01-13 21:28:13 +02:00
ripgrep/crates/pcre2
Andrew Gallant 81341702af regex: push more pattern handling to matcher construction
Previously, ripgrep core was responsible for escaping regex patterns and
implementing the --line-regexp flag. This commit moves that
responsibility down into the matchers such that ripgrep just needs to
hand the patterns it gets off to the matcher builder. The builder will
then take care of escaping and all that.

This was done to make pattern construction completely owned by the
matcher builders. With the arrival regex-automata, this means we can
move to the HIR very quickly and then never move back to the concrete
syntax. We can then build our regex directly from the HIR. This overall
can save quite a bit of time, especially when searching for large
dictionaries.

We still aren't quite as fast as GNU grep when searching something on
the scale of /usr/share/dict/words, but we are basically within spitting
distance. Prior to this, we were about an order of magnitude slower.

This architecture in particular lets us write a pretty simple fast path
that avoids AST parsing and HIR translation entirely: the case where one
is just searching for a literal. In that case, we can hand construct the
HIR directly.
2023-07-05 14:04:29 -04:00
..
src regex: push more pattern handling to matcher construction 2023-07-05 14:04:29 -04:00
Cargo.toml regex: push more pattern handling to matcher construction 2023-07-05 14:04:29 -04:00
LICENSE-MIT repo: move all source code in crates directory 2020-02-17 19:24:53 -05:00
README.md edition: manual changes 2021-06-01 21:07:37 -04:00
UNLICENSE repo: move all source code in crates directory 2020-02-17 19:24:53 -05:00

grep-pcre2

The grep-pcre2 crate provides an implementation of the Matcher trait from the grep-matcher crate. This implementation permits PCRE2 to be used in the grep crate for fast line oriented searching.

Build status

Dual-licensed under MIT or the UNLICENSE.

Documentation

https://docs.rs/grep-pcre2

NOTE: You probably don't want to use this crate directly. Instead, you should prefer the facade defined in the grep crate.

If you're looking to just use PCRE2 from Rust, then you probably want the pcre2 crate, which provide high level safe bindings to PCRE2.

Usage

Add this to your Cargo.toml:

[dependencies]
grep-pcre2 = "0.1"