mirror of
https://github.com/BurntSushi/ripgrep.git
synced 2024-12-18 03:19:36 +02:00
d9ca529356
libripgrep is not any one library, but rather, a collection of libraries that roughly separate the following key distinct phases in a grep implementation: 1. Pattern matching (e.g., by a regex engine). 2. Searching a file using a pattern matcher. 3. Printing results. Ultimately, both (1) and (3) are defined by de-coupled interfaces, of which there may be multiple implementations. Namely, (1) is satisfied by the `Matcher` trait in the `grep-matcher` crate and (3) is satisfied by the `Sink` trait in the `grep2` crate. The searcher (2) ties everything together and finds results using a matcher and reports those results using a `Sink` implementation. Closes #162
36 lines
1.0 KiB
Markdown
36 lines
1.0 KiB
Markdown
grep-regex
|
|
----------
|
|
The `grep-regex` crate provides an implementation of the `Matcher` trait from
|
|
the `grep-matcher` crate. This implementation permits Rust's regex engine to
|
|
be used in the `grep` crate for fast line oriented searching.
|
|
|
|
[![Linux build status](https://api.travis-ci.org/BurntSushi/ripgrep.svg)](https://travis-ci.org/BurntSushi/ripgrep)
|
|
[![Windows build status](https://ci.appveyor.com/api/projects/status/github/BurntSushi/ripgrep?svg=true)](https://ci.appveyor.com/project/BurntSushi/ripgrep)
|
|
[![](https://img.shields.io/crates/v/grep-regex.svg)](https://crates.io/crates/grep-regex)
|
|
|
|
Dual-licensed under MIT or the [UNLICENSE](http://unlicense.org).
|
|
|
|
### Documentation
|
|
|
|
[https://docs.rs/grep-regex](https://docs.rs/grep-regex)
|
|
|
|
**NOTE:** You probably don't want to use this crate directly. Instead, you
|
|
should prefer the facade defined in the
|
|
[`grep`](https://docs.rs/grep)
|
|
crate.
|
|
|
|
### Usage
|
|
|
|
Add this to your `Cargo.toml`:
|
|
|
|
```toml
|
|
[dependencies]
|
|
grep-regex = "0.1"
|
|
```
|
|
|
|
and this to your crate root:
|
|
|
|
```rust
|
|
extern crate grep_regex;
|
|
```
|