Struct PdfGrepBuilder 

pub struct PdfGrepBuilder { /* private fields */ }

Builder for PdfGrep (FR-039). All methods are independent and order-agnostic; password(...) appends to the retry list and is the only repeatable setter.

Implementations

impl PdfGrepBuilder

pub fn new() -> Self

Fresh builder with all defaults applied.

pub fn pattern(self, p: impl Into<String>) -> Self

Required pattern (PCRE or fixed string per fixed_strings/perl_regexp).

pub fn fixed_strings(self, on: bool) -> Self

-F/--fixed-strings — escape metacharacters in pattern.

pub fn perl_regexp(self, on: bool) -> Self

-P/--perl-regexp — use fancy-regex engine instead of regex.

pub fn case_insensitive(self, on: bool) -> Self

-i/--ignore-case.

pub fn invert_match(self, on: bool) -> Self

-v/--invert-match.

pub fn only_matching(self, on: bool) -> Self

-o/--only-matching — Match.text is the matched span only.

pub fn max_count(self, n: Option<usize>) -> Self

-m N/--max-count — stop after N matches.

pub fn page_range(self, range: Option<(u32, u32)>) -> Self

--page-range N-M (1-indexed inclusive).

pub fn password(self, pwd: impl Into<String>) -> Self

--password PWD — repeatable; each call APPENDS to the retry list (FR-025, FR-039 + Clarifications Q4).

pub fn build(self) -> Result<PdfGrep, PdfGrepError>

Build a configured PdfGrep. FALLIBLE — regex compile failure maps to PdfGrepError::RegexCompile; invalid page_range maps to PdfGrepError::PageRange.

Errors

• PdfGrepError::RegexCompile if the pattern fails to compile.
• PdfGrepError::PageRange if the page range is reverse (start > end).

Trait Implementations

impl Clone for PdfGrepBuilder

fn clone(&self) -> PdfGrepBuilder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PdfGrepBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PdfGrepBuilder

fn default() -> PdfGrepBuilder

Returns the “default value” for a type.