Struct OutputConfig 

pub struct OutputConfig {
    pub color_enabled: bool,
    pub limit: Option<usize>,
    pub page_size: Option<usize>,
    pub target: OutputTarget,
    pub overwrite: bool,
}

Configuration for table formatter output behavior

This struct controls how query results are formatted and displayed, including color support, row limits, pagination settings, and output destination.

Fields

color_enabled: bool

Whether to enable colored output in table formatting. This is the inverse of the --no-color CLI flag. When true, output will include ANSI color codes for better readability.

limit: Option<usize>

Maximum number of rows to display in query results. When None, all rows will be displayed. This can be used to prevent overwhelming output from large result sets.

page_size: Option<usize>

Number of rows per page for pagination. When None, pagination is disabled and all rows are shown at once. Default is 50 rows per page, matching cqlsh behavior.

target: OutputTarget

Output target (stdout or file path). When Stdout, output is written to standard output. When File(path), output is written atomically to the specified file.

overwrite: bool

Whether to overwrite existing files when writing to a file target. Only relevant when target is File.

Implementations

impl OutputConfig

pub fn from_cli( config: &Config, no_color_flag: bool, limit_flag: Option<usize>, page_size_flag: Option<usize>, output_flag: Option<PathBuf>, overwrite_flag: bool, ) -> Self

Create a new OutputConfig from resolved Config and CLI flags

This method respects the precedence chain: CLI flags > env vars > config file > defaults. The Config object passed in has already resolved this chain via ConfigBuilder.

Arguments

• config - The resolved Config object containing env/file/default values
• no_color_flag - The --no-color CLI flag (if present, overrides config)
• limit_flag - The --limit CLI flag (if present, overrides config)
• page_size_flag - The --page-size CLI flag (if present, overrides config)
• output_flag - The --output CLI flag for file destination
• overwrite_flag - The --overwrite CLI flag for overwriting existing files

Precedence

• color_enabled: –no-color flag > CQLITE_NO_COLOR env > config.output.colors > default (true)
• limit: –limit flag > CQLITE_LIMIT env > config.query_limit > default (None)
• page_size: –page-size flag > CQLITE_PAGE_SIZE env > config.repl.page_size > default (50)
• target: –output flag > CQLITE_OUTPUT env > default (Stdout)
• overwrite: –overwrite flag > default (false)

Examples

use cqlite_cli::config::{Config, OutputConfig};
use cqlite_cli::cli_types::Cli;
use clap::Parser;

// Create config with defaults
let cli = Cli::parse_from(&["cqlite"]);
let config = Config::load(None, &cli).unwrap();
let output = OutputConfig::from_cli(&config, false, None, None, None, false);
assert!(output.color_enabled);
assert_eq!(output.page_size, Some(50));

// CLI flag overrides config
let output = OutputConfig::from_cli(&config, true, Some(100), Some(25), None, false);
assert!(!output.color_enabled);
assert_eq!(output.limit, Some(100));
assert_eq!(output.page_size, Some(25));

Trait Implementations

impl Clone for OutputConfig

fn clone(&self) -> OutputConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for OutputConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for OutputConfig

fn default() -> Self

Default output configuration

Returns an OutputConfig with:

• color_enabled: true (colors enabled by default)
• limit: None (no row limit)
• page_size: Some(50) (50 rows per page, matching cqlsh)
• target: Stdout (write to standard output)
• overwrite: false (don’t overwrite existing files)