rusty-pdfgrep 0.1.0

Grep through PDF files — a Rust port of Hans-Peter Deifel's `pdfgrep(1)` with lopdf-backed text extraction, regex + fancy-regex pluggable engines, --password retry for encrypted PDFs, GNU-grep-compatible color output, recursive walking with fnmatch include/exclude, and a typed library API.
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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

//! US3 (Strict-compat) integration tests.

mod common;

#[test]
fn strict_excluded_short_flag_w_rejected() {
    // FR-035 + Clarifications Q10: -w is upstream-grep-only, excluded from v0.1.0.
    let assert = common::rusty_pdfgrep_cmd()
        .arg("--strict")
        .arg("-w")
        .arg("term")
        .assert()
        .code(2);
    let stderr = String::from_utf8_lossy(&assert.get_output().stderr);
    assert!(
        stderr.contains("invalid option") && stderr.contains("'w'"),
        "got: {stderr:?}"
    );
}

#[test]
fn strict_excluded_short_flag_a_rejected() {
    // -A is page-context, excluded from v0.1.0.
    let assert = common::rusty_pdfgrep_cmd()
        .arg("--strict")
        .arg("-A")
        .assert()
        .code(2);
    let stderr = String::from_utf8_lossy(&assert.get_output().stderr);
    assert!(stderr.contains("invalid option"), "got: {stderr:?}");
}

#[test]
fn strict_excluded_long_flag_cache_rejected() {
    // FR-035 long-flag form: "unrecognized option '--<name>'" per Clarifications Q10.
    let assert = common::rusty_pdfgrep_cmd()
        .arg("--strict")
        .arg("--cache")
        .arg("term")
        .assert()
        .code(2);
    let stderr = String::from_utf8_lossy(&assert.get_output().stderr);
    assert!(
        stderr.contains("unrecognized option") && stderr.contains("--cache"),
        "got: {stderr:?}"
    );
}

#[test]
fn strict_excluded_long_flag_password_list_rejected() {
    let assert = common::rusty_pdfgrep_cmd()
        .arg("--strict")
        .arg("--password-list")
        .arg("/tmp/list.txt")
        .arg("term")
        .assert()
        .code(2);
    let stderr = String::from_utf8_lossy(&assert.get_output().stderr);
    assert!(
        stderr.contains("unrecognized option") && stderr.contains("--password-list"),
        "got: {stderr:?}"
    );
}

#[test]
fn strict_activates_via_env_var() {
    // Strict mode activates without the --strict flag when env var set.
    let assert = common::rusty_pdfgrep_cmd()
        .env("RUSTY_PDFGREP_STRICT", "1")
        .arg("-w")
        .arg("term")
        .assert()
        .code(2);
    let stderr = String::from_utf8_lossy(&assert.get_output().stderr);
    assert!(
        stderr.contains("invalid option") && stderr.contains("'w'"),
        "env-var strict should reject -w; got: {stderr:?}"
    );
}

#[test]
fn no_strict_overrides_env_var() {
    // --no-strict beats env var; -w should be a clap-style error, not the strict format.
    let assert = common::rusty_pdfgrep_cmd()
        .env("RUSTY_PDFGREP_STRICT", "1")
        .arg("--no-strict")
        .arg("-w")
        .arg("term")
        .assert()
        .failure();
    let stderr = String::from_utf8_lossy(&assert.get_output().stderr);
    // Default mode rejects unknown short via clap; the error message differs.
    assert!(
        !stderr.contains("invalid option -- 'w'") || stderr.contains("Usage"),
        "default-mode rejection should NOT use the upstream getopt format verbatim; got: {stderr:?}"
    );
}