rch 2.1.15

Remote Compilation Helper - PreToolUse hook CLI
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
120
121

//! UI output abstraction layer for the RCH CLI.
//!
//! This module provides a consistent interface for CLI output that handles:
//! - Color detection and NO_COLOR compliance
//! - TTY vs piped output detection
//! - JSON output mode for machine consumption
//! - Quiet/verbose modes
//! - Unicode vs ASCII fallback
//! - Thread-safe output for concurrent operations
//! - Adaptive colors for light/dark terminal backgrounds
//!
//! # Usage
//!
//! ```rust,ignore
//! use rch::ui::{OutputConfig, OutputContext};
//!
//! // Create from CLI args
//! let config = OutputConfig {
//!     json: args.json,
//!     verbose: args.verbose,
//!     quiet: args.quiet,
//!     color: ColorChoice::from_str(&args.color),
//!     ..Default::default()
//! };
//! let ctx = OutputContext::new(config);
//!
//! // Use for output
//! ctx.header("Workers");
//! ctx.key_value("Status", "Healthy");
//! ctx.success("Operation completed");
//!
//! // Or JSON mode
//! ctx.json(&WorkersResponse { workers })?;
//! ```
//!
//! # Output Modes
//!
//! - **Human**: Colored output with unicode symbols
//! - **Plain**: No colors, ASCII fallback, for dumb terminals or pipes
//! - **JSON**: Machine-readable output to stdout (json/toon)
//! - **Quiet**: Errors only
//!
//! # Standards Compliance
//!
//! - Respects `NO_COLOR` environment variable (<https://no-color.org/>)
//! - Respects `CLICOLOR_FORCE` for forcing colors
//! - Respects `TERM=dumb` for plain output
//! - Detects pipe/redirection to disable colors
//! - Detects terminal background (light/dark) via COLORFGBG
//! - Detects color level (16/256/true color)

pub mod adaptive;
#[cfg(unix)]
pub mod benchmark;
#[cfg(unix)]
pub mod config;
pub mod console;
pub mod context;
pub mod markdown;
#[cfg(unix)]
pub mod probe;
pub mod progress;
#[cfg(unix)]
pub mod status;
pub mod styled;
pub mod test_utils;
pub mod theme;
#[cfg(unix)]
pub mod workers;
pub mod writer;

// Re-export main types for convenience
pub use adaptive::{
    AdaptiveColor, Background, ColorLevel, detect_background, detect_color_level,
    detect_hyperlink_support, palette,
};
pub use context::{
    ColorChoice, OutputConfig, OutputContext, OutputFormat, OutputMode, TerminalCaps, Verbosity,
    default_context,
};
pub use markdown::{render_markdown, strip_markdown};
pub use progress::{
    MultiProgressManager, Spinner, StepProgress, TransferProgress, with_spinner,
    with_spinner_result,
};
pub use styled::{
    Align, BorderChars, BorderStyle, BoxStyle, Margin, Padding, Spacing, join_horizontal,
    join_vertical, place, presets,
};
pub use theme::{SemanticColors, StatusIndicator, Symbols, Theme};
pub use writer::{OutputBuffer, OutputWriter, SharedOutputBuffer};

// Rich console wrapper (requires rich-ui feature for full functionality)
pub use console::{RchConsole, console};

// Rich status display (Unix only - uses rich_rust)
#[cfg(unix)]
pub use status::{StatusTable, render_daemon_offline};

// Rich worker table display (Unix only)
#[cfg(unix)]
pub use workers::WorkerTable;

// Rich probe result display (Unix only)
#[cfg(unix)]
pub use probe::{DetailedProbeResult, LatencyCategory, ProbeResultTable, ProbeSummary};

// Rich benchmark table display (Unix only)
#[cfg(unix)]
pub use benchmark::BenchmarkTable;

// Rich config display (Unix only)
#[cfg(unix)]
pub use config::ConfigDisplay;

// Test utilities are public for integration tests
pub use test_utils::{
    OutputCapture, OutputContextBuilder, assert_has_ansi, assert_no_ansi, assert_stderr_contains,
    assert_stderr_not_contains, assert_stdout_contains, assert_stdout_not_contains,
    assert_valid_json, strip_ansi,
};