sift-core 0.6.0

Indexed regex search over codebases (library + grep-like CLI)
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
39
40

# search/

Regex execution: pattern compilation, file scanning, output formatting, and parallelism. This layer receives already-resolved candidates and knows nothing about index internals.

## Design

The search layer is the final stage of the pipeline. By the time code reaches here, candidates have already been narrowed by the index registry and filtered by the candidate filter. The search layer compiles regex patterns, scans candidate files in parallel, and emits formatted output.

This strict separation means the search layer works identically regardless of which index types produced the candidates -- trigram, AST, vector, or any future kind.

## Modules

| Directory | Description |
|-----------|-------------|
| [`options/`](options/) | `SearchOptions`, `SearchMatchFlags`, `CaseMode`, `BinaryMode` |
| [`pattern/`](pattern/) | `PatternCompiler`: composable regex builder |
| [`query/`](query/) | `SearchQuery`, `Match` |
| [`request/`](request/) | `SearchExecution`, `WalkOptions`, `LinkTraversal` |
| [`filter/`](filter/) | `CandidateFilter`, `CandidateFilterConfig`, ignore/type_filter |
| [`output/`](output/) | `SearchOutput`, style/mode/format/passthru, `CandidateCoverage` |
| [`candidates/`](candidates/) | Candidate resolution for indexed and walk paths |
| [`scan/`](scan/) | Text / summary / JSON scanning workers |
| [`emit/`](emit/) | Output formatting, result chunks, and stats helpers |
| [`mod.rs`](mod.rs) | Module declarations, `SearchError` aggregate, public re-exports |

## API

```rust
use sift_core::{SearchQuery, SearchOptions, CandidateFilter};

let search = SearchQuery::new(&patterns, SearchOptions::default())?;
search.run(SearchExecution {
    candidates: &candidates,
    output,
    separators,
    collect: SearchCollection::none(),
})?;
```

`SearchQuery` compiles the regex once; repeated calls reuse the compiled matcher and searcher cache.