ctl-core 0.6.12

Shared clap chassis for the *ctl CLIs
Documentation 
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

//! Shared clap chassis and presentation kernel for the `*ctl` CLIs.
//!
//! Not a command. Import as [`ctl_core`](crate). Domain handlers return typed
//! data. [`Document`] describes the human view, [`View`] chooses pretty,
//! colorless, or JSON, and the terminal engine remains private to this crate.
//!
//! ## Cargo features
#![doc = document_features::document_features!()]
//!
//! Unused features do not compile `clap`, `comfy-table`, or `schemars`.
//!
//! Crate docs live here. The GitHub README is not rustdoc.

#![deny(missing_docs, rustdoc::broken_intra_doc_links)]
#![expect(
    clippy::missing_errors_doc,
    reason = "each fallible function returns one typed error whose variants carry the docs"
)]

/// Fluent typed CLI lifecycle.
#[cfg(feature = "app")]
pub mod app;
/// Color policy (`auto` / `always` / `never`).
pub mod color;
/// Semantic human presentation independent of a terminal engine.
#[cfg(feature = "document")]
pub mod document;
/// Output representation (`pretty` / `json`).
pub mod format;
/// Schema-first wire types.
pub mod model;

/// The Rust configuration every ctl repository shares, served from this
/// release.
#[cfg(feature = "baseline")]
pub mod baseline;
/// Temporary file trees for integration tests.
#[cfg(feature = "fixture")]
pub mod fixture;
/// Clap flatten structs for shared flags.
#[cfg(feature = "cli")]
pub mod flags;
/// Styled `-h` / `--help` renderer.
#[cfg(feature = "help")]
pub mod help;
/// Declared input: read, parse, validate once, and place every problem.
#[cfg(feature = "input")]
pub mod input;
#[cfg(feature = "render")]
mod layout;
/// Parser defaults (`-h` / `-V` stay on).
#[cfg(feature = "cli")]
pub mod parser;
/// One-import surface for a *ctl binary (`use ctl_core::prelude::*`).
pub mod prelude;
/// Semantic document renderer.
#[cfg(feature = "render")]
pub mod render;
/// Files a repository serves, rendered from templates that declare where
/// they go.
#[cfg(feature = "served")]
pub mod served;
#[cfg(feature = "render")]
mod style;
/// Shared Clap-derived operator metadata and optional Jinja fragments.
#[cfg(feature = "surface-model")]
pub mod surface;
/// Compact pretty tables for command output.
#[cfg(feature = "render")]
pub mod table;
/// Mise Usage spec from a clap command.
#[cfg(feature = "usage")]
pub mod usage;
/// Garde rules every declared schema shares.
#[cfg(feature = "validate")]
pub mod validate;
/// Pretty / JSON / colorless emitters.
#[cfg(feature = "view")]
pub mod view;

#[cfg(feature = "app")]
pub use app::App;
pub use color::ColorMode;
#[cfg(feature = "document")]
pub use document::{
    Block, Document, Fields, Notice, NoticeLevel, Role, Rule, Section, Span, Table, Text,
};
#[cfg(feature = "cli")]
pub use flags::{
    ColorLong, DryRunArgs, FlagWarning, FormatArgs, FormatLong, OutputArgs, WarningKind,
    chassis_warnings, emit_warnings, resolve_color, switch, warn_opposites,
};
pub use format::OutputFormat;
pub use indoc::{concatdoc, eprintdoc, formatdoc, indoc, printdoc, writedoc};
pub use model::{Envelope, ErrorBody, SCHEMA_VERSION};
#[cfg(feature = "render")]
pub use render::{
    DEFAULT_COLUMN_BUFFER, DEFAULT_COLUMN_BUFFER_ENV, DEFAULT_COLUMN_BUFFER_ENVS,
    DEFAULT_FALLBACK_WIDTH, DEFAULT_LIST_STYLE_ENV, DEFAULT_LIST_STYLE_ENVS,
    DEFAULT_MINIMUM_AUTOMATIC_WIDTH, DEFAULT_RECORD_STYLE_ENV, DEFAULT_RECORD_STYLE_ENVS,
    DEFAULT_ROW_SEPARATION_ENV, DEFAULT_ROW_SEPARATION_ENVS, ListStyle, RecordStyle, RenderOptions,
    Renderer, RowSeparation,
};
#[cfg(feature = "surface-model")]
pub use surface::{Surface, SurfaceArgument, SurfaceCommand, SurfaceRequirement, SurfaceScope};
#[cfg(feature = "render")]
pub use table::{grid, kv};
#[cfg(feature = "usage")]
pub use usage::{mount_line, spec, spec_bin, take};
#[cfg(feature = "view")]
pub use view::{
    Captured, DEFAULT_JSON_LAYOUT_ENV, DEFAULT_JSON_LAYOUT_ENVS, JsonLayout, MessageKind, Present,
    Stream, View,
};