cli_fmt

CLI output formatting utilities for command-line applications.

Purpose

This crate provides utilities specifically designed for building command-line applications, including output processing, formatting, and other CLI-specific helpers.

Distinction from strs_tools

• strs_tools: General-purpose string and ANSI manipulation (any application)
• cli_fmt: CLI-application-specific functionality (command-line tools only)

Scope

Responsibilities: Provides CLI-application-specific output processing utilities for command-line tools. Focuses on stream selection, line filtering (head/tail), and ANSI-aware width truncation. Delegates to strs_tools for general-purpose string and ANSI manipulation. Designed for command-line applications requiring output formatting and processing.

In Scope:

• CLI output processing with stream selection (stdout, stderr, both)
• Head/tail line filtering for limiting output volume
• ANSI-aware width truncation with configurable suffixes
• Stream merging with stderr-before-stdout ordering convention
• Builder pattern configuration API for ergonomic usage
• Integration with strs_tools for underlying string operations

Out of Scope:

• General-purpose string manipulation (see strs_tools crate)
• ANSI escape code generation (see strs_tools crate)
• Progress bars, tables, or interactive prompts (see indicatif, tabled crates)
• Terminal control or cursor manipulation (see crossterm crate)
• Configuration file parsing (see config, serde crates)
• Command-line argument parsing (see clap crate)

Modules

• output - Process command output with head/tail filtering, width truncation, and stream merging

Usage

use cli_fmt::output::*;

let config = OutputConfig::default()
  .with_head(10)
  .with_width(80);

let result = process_output(stdout_str, stderr_str, &config);
println!("{}", result.content);

Features

• output - Output processing module (enabled by default)

License

MIT