zond-cli 0.8.0

Command-Line Interface (CLI) for the Zond Engine
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

// Copyright (c) 2026 Erik Lening (hollowpointer) and Contributors
//
// This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
// If a copy of the MPL was not distributed with this file, You can obtain one at
// https://mozilla.org/MPL/2.0/.

//! # CLI Presentation Configuration
//!
//! Presentation is a concern of the interface, not of the engine. The core
//! [`ZondConfig`](zond_engine::core::config::ZondConfig) exists to drive the
//! *scan* — how packets are placed on the wire, whether DNS is emitted — and
//! deliberately knows nothing about terminals, colors, or verbosity. That keeps
//! the engine reusable behind any front end: this CLI today, a TUI or a Web UI
//! tomorrow.
//!
//! [`DisplayConfig`] is where the terminal front end keeps *its* state. It is
//! built from the parsed [`CommandLine`] and consumed only by the
//! [`terminal`](crate::terminal) layer; the engine never sees it. Adding a new
//! output toggle means adding a field here, not widening the engine's config.

use crate::commands::CommandLine;

/// Runtime presentation preferences for the terminal front end.
///
/// Holds every flag that changes *how results are rendered* rather than *what is
/// scanned*. Constructed once from the CLI arguments and handed to
/// [`Print::init`](crate::terminal::print::Print::init).
#[derive(Debug, Clone, Copy, Default)]
pub struct DisplayConfig {
    /// Suppresses the startup ASCII banner while keeping logs and colors.
    pub no_banner: bool,

    /// Visual-density level, mapped from `-q` / `--quiet`.
    ///
    /// * `0` — full UI.
    /// * `1` — reduced styling.
    /// * `2` — raw, pipe-friendly output.
    pub quiet: u8,

    /// Masks sensitive fields (IPv6 suffixes, MAC addresses, hostnames) so
    /// output is safe to share.
    pub redact: bool,

    /// Expands each identified service into the full fingerprint evidence —
    /// vendor, environment `extrainfo`, CPE identifiers, and identification
    /// confidence — as a nested detail tree.
    ///
    /// Purely presentational: fingerprinting always runs in the engine, this
    /// only controls how much of its result reaches the terminal.
    pub detailed: bool,
}

impl From<&CommandLine> for DisplayConfig {
    fn from(cmd: &CommandLine) -> Self {
        Self {
            no_banner: cmd.no_banner,
            quiet: cmd.quiet,
            redact: cmd.redact,
            detailed: cmd.detailed,
        }
    }
}