paper-gap 0.2.2

Local CLI for finding research papers with missing, weak, or stale public code
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

use std::process::Command;

fn bin() -> &'static str {
    env!("CARGO_BIN_EXE_paper-gap")
}

#[test]
fn help_command_runs() {
    let output = Command::new(bin()).arg("--help").output().unwrap();
    assert!(output.status.success());
    assert!(String::from_utf8_lossy(&output.stdout).contains("paper-gap"));
}

#[test]
fn sources_commands_emit_json() {
    for args in [
        vec!["sources"],
        vec!["sources", "--papers"],
        vec!["sources", "--repos"],
    ] {
        let output = Command::new(bin()).args(args).output().unwrap();
        assert!(output.status.success());
        serde_json::from_slice::<serde_json::Value>(&output.stdout).unwrap();
    }
}

#[test]
fn report_formats_json_input_as_markdown_and_json() {
    let input = std::env::temp_dir().join(format!("paper-gap-report-{}.json", std::process::id()));
    std::fs::write(&input, r#"{"paper_results":[]}"#).unwrap();

    let markdown = Command::new(bin())
        .args([
            "report",
            "--input",
            input.to_str().unwrap(),
            "--format",
            "markdown",
        ])
        .output()
        .unwrap();
    assert!(markdown.status.success());
    assert!(String::from_utf8_lossy(&markdown.stdout).contains("# paper-gap report"));

    let json = Command::new(bin())
        .args([
            "report",
            "--input",
            input.to_str().unwrap(),
            "--format",
            "json",
        ])
        .output()
        .unwrap();
    assert!(json.status.success());
    serde_json::from_slice::<serde_json::Value>(&json.stdout).unwrap();

    let _ = std::fs::remove_file(input);
}

#[test]
fn scan_rejects_missing_or_blank_selectors_without_network_access() {
    for args in [vec!["scan"], vec!["scan", "--query", "   "]] {
        let output = Command::new(bin()).args(args).output().unwrap();
        assert!(!output.status.success());
        assert!(String::from_utf8_lossy(&output.stderr).contains("scan needs"));
    }
}

#[test]
fn scan_rejects_incompatible_paper_sources_without_network_access() {
    for (args, message) in [
        (
            vec!["scan", "--paper-source", "openalex", "--category", "cs.PL"],
            "--category is only supported by arxiv",
        ),
        (
            vec!["scan", "--paper-source", "arxiv", "--from", "2026-06-01"],
            "--paper-source arxiv needs --query or --category",
        ),
    ] {
        let output = Command::new(bin()).args(args).output().unwrap();
        assert!(!output.status.success());
        assert!(String::from_utf8_lossy(&output.stderr).contains(message));
    }
}