Function search_one_file 

pub fn search_one_file(
    path: &Path,
    pattern: &str,
    opts: &SearchOptions,
    root: &Path,
) -> Vec<SearchResult>

Low-level single-file matcher for callers that already selected the files.

Returns rich SearchResults (including column and context when requested via SearchOptions). Intended for advanced library users (e.g. custom WalkBuilder with extra ignores, size caps, depth limits, custom truncation) who then want to apply patchloom’s matching logic.

Prefer search_file for simple per-file use and search_directory for full directory walking with built-in ignore support.