filament-cli 0.6.0

P2P file transfer between terminals and browsers, no upload, no account. The terminal end of filament.autumated.com.
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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

//! Tests for `filament man` command behavior.
//!
//! These tests verify that `filament man` emits readable help on TTY and
//! roff when piped, and handles unknown pages correctly.

use std::process::Command;

/// Get the path to the filament binary built with test-hooks feature.
fn filament_bin() -> std::path::PathBuf {
    let mut path = std::env::current_exe().unwrap();
    path.pop(); // remove test binary name
    path.pop(); // remove deps/
    path.push("filament");
    path
}

/// Test that `filament man` piped emits roff (contains ".TH").
#[test]
fn man_piped_emits_roff() {
    let bin = filament_bin();

    let output = Command::new(&bin)
        .arg("man")
        .output()
        .expect("failed to execute filament");

    let stdout = String::from_utf8_lossy(&output.stdout);

    // Should contain roff control sequences
    assert!(
        stdout.contains(".TH"),
        "Expected '.TH' in piped man output, got: {}",
        &stdout[..stdout.len().min(500)]
    );
}

/// Test that `filament man` with simulated TTY emits readable help.
/// Gated to Linux: `script -qec` is util-linux syntax; macOS/Windows lack it.
#[test]
#[cfg(target_os = "linux")]
fn man_tty_emits_readable_help() {
    let bin = filament_bin();

    // Use script to simulate a TTY
    let output = Command::new("script")
        .arg("-qec")
        .arg(format!("{} man", bin.display()))
        .arg("/dev/null")
        .output()
        .expect("failed to execute script");

    let stdout = String::from_utf8_lossy(&output.stdout);

    // Should contain readable help text (not roff)
    assert!(
        stdout.contains("Commands:") || stdout.contains("Usage:"),
        "Expected readable help in TTY man output, got: {}",
        &stdout[..stdout.len().min(500)]
    );

    // Should NOT contain roff control sequences
    assert!(
        !stdout.contains(".TH"),
        "Expected no '.TH' in TTY man output, got roff instead",
    );
}

/// Test that `filament man settings` (unknown page) shows error message.
/// Gated to Linux: `script -qec` is util-linux syntax; macOS/Windows lack it.
#[test]
#[cfg(target_os = "linux")]
fn man_unknown_page_shows_error() {
    let bin = filament_bin();

    // Use script to simulate a TTY (script merges stdout+stderr)
    let output = Command::new("script")
        .arg("-qec")
        .arg(format!("{} man settings", bin.display()))
        .arg("/dev/null")
        .output()
        .expect("failed to execute script");

    let combined = String::from_utf8_lossy(&output.stdout);

    // Should contain error message about unknown page
    assert!(
        combined.contains("no manual page 'settings'"),
        "Expected 'no manual page' error, got: {}",
        combined
    );

    // Should mention available pages
    assert!(
        combined.contains("routing"),
        "Expected 'routing' in available pages, got: {}",
        combined
    );
}

/// Test that `filament man routing` shows routing documentation.
#[test]
fn man_routing_shows_doc() {
    let bin = filament_bin();

    let output = Command::new(&bin)
        .arg("man")
        .arg("routing")
        .output()
        .expect("failed to execute filament");

    let stdout = String::from_utf8_lossy(&output.stdout);

    // Should contain routing documentation
    assert!(
        stdout.contains("filament-routing") || stdout.contains("THE ROUTE"),
        "Expected routing documentation, got: {}",
        &stdout[..stdout.len().min(500)]
    );
}