ctl-core 0.6.13

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
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157

[package]
name = "ctl-core"
version = "0.6.13"
edition = "2024"
rust-version = "1.99.0"
description = "Shared clap chassis for the *ctl CLIs"
license = "MIT"
repository = "https://github.com/victor-software-house/ctl-core"
keywords = ["clap", "cli", "help", "color"]
categories = ["command-line-interface", "development-tools"]

[package.metadata.docs.rs]
all-features = true
rustdoc-args = ["--cfg", "docsrs"]

[package.metadata.cargo-machete]
ignored = ["usage-lib"]

# ctl-core baseline: begin lints
[lints.rust]
unsafe_code = "forbid"
missing_docs = "deny"
missing_debug_implementations = "deny"
unreachable_pub = "deny"
rust_2018_idioms = { level = "deny", priority = -1 }

[lints.rustdoc]
broken_intra_doc_links = "deny"
private_intra_doc_links = "deny"
invalid_html_tags = "deny"
invalid_codeblock_attributes = "deny"

[lints.clippy]
all = { level = "deny", priority = -1 }
pedantic = { level = "deny", priority = -1 }
cargo = { level = "deny", priority = -1 }
dbg_macro = "deny"
todo = "deny"
unimplemented = "deny"
unwrap_used = "deny"
expect_used = "deny"
disallowed_macros = "deny"
wildcard_enum_match_arm = "deny"
match_wildcard_for_single_variants = "deny"
allow_attributes = "deny"
allow_attributes_without_reason = "deny"
# Duplicate versions come from transitive dependencies the crate does not
# control; cargo-deny reports them (`bans.multiple-versions`).
multiple_crate_versions = "allow"
# ctl-core baseline: end lints

[features]
default = ["app"]

## Complete typed CLI lifecycle over the shared help and view layers.
app = ["cli", "view", "help", "dep:anyhow"]

## Clap derive helpers (`OutputArgs`, `DryRunArgs`) and parser defaults.
cli = ["dep:clap"]

## Semantic presentation documents without a terminal engine.
document = []

## Serde models and the JSON view.
json = ["dep:serde", "dep:serde_json"]

## Terminal rendering for semantic documents. Engine crates stay private.
render = [
  "document",
  "dep:anstyle",
  "dep:comfy-table",
  "dep:unicode-bidi",
  "dep:unicode-general-category",
  "dep:unicode-width",
]

## JSON Schema for the envelope and enums (`schemars`).
schema = ["json", "dep:schemars"]

## Styled `-h/--help` through the shared document renderer.
help = ["cli", "render", "dep:anstream"]

## Pretty / JSON / colorless emitters over serializable models.
view = ["render", "json", "dep:anstream"]

## Clap-derived operator metadata without serialization or a template engine.
surface-model = ["cli", "usage"]

## Serializable Surface metadata without a template engine.
surface-serde = ["surface-model", "dep:serde"]

## Shared MiniJinja fragments for committed operator documents.
surface-templates = ["surface-serde", "dep:minijinja"]

## Compatibility aggregate for the complete operator-document surface.
surface = ["surface-templates"]

## Files a repository serves, rendered from templates that declare their own
## target (`served::render`, `Served::write`).
served = ["surface-templates", "validate", "garde/derive", "minijinja/deserialization"]

## The shared Rust configuration, rendered for a repository from its
## `.ctl/rust.yaml` (`baseline::render`).
baseline = ["served", "input"]

## Garde rules every declared schema shares (`validate`).
validate = ["dep:garde"]

## Declared input: read, parse with serde-saphyr, validate once with garde,
## and place every problem on its file and line through yamled.
input = ["validate", "dep:serde", "dep:serde-saphyr", "dep:yamled"]

## Temporary file trees for integration tests: `Suite`, its scenarios,
## and one call per file.
fixture = ["dep:tempfile"]

## Mise Usage spec from clap (`--usage-spec`, served-task mount).
usage = ["cli", "dep:usage-lib"]

[dependencies]
anyhow = { version = "1.0.104", optional = true }
anstream = { version = "1.0.0", optional = true }
anstyle = { version = "1.0.14", optional = true }
clap = { version = "4.6.6", optional = true, features = ["derive", "env"] }
garde = { version = "0.23.0", optional = true, default-features = false }
comfy-table = { version = "8.0.0", optional = true, default-features = false, features = ["custom_styling", "tty"] }
document-features = "0.2.12"
indoc = "2.0.7"
minijinja = { version = "2.24.0", optional = true, features = ["serde"] }
schemars = { version = "1.2.2", optional = true }
serde = { version = "1.0.229", optional = true, features = ["derive"] }
serde_json = { version = "1.0.151", optional = true }
serde-saphyr = { version = "1.3.0", optional = true, default-features = false, features = ["deserialize"] }
tempfile = { version = "3.27.0", optional = true }
yamled = { version = "0.0.5", optional = true, default-features = false }
usage-lib = { version = "6.0.0", default-features = false, features = ["clap"], optional = true }
unicode-bidi = { version = "0.3.18", optional = true, default-features = false }
unicode-general-category = { version = "1.1.0", optional = true }
unicode-width = { version = "0.2.2", optional = true }

[dev-dependencies]
garde = { version = "0.23.0", default-features = false, features = ["derive"] }
indoc = "2.0.7"

[[example]]
name = "gallery"
required-features = ["view"]

# Line tables keep backtraces readable at a fraction of full debug info.
[profile.dev]
debug = "line-tables-only"

[profile.release]
codegen-units = 1
lto = "thin"
panic = "abort"
strip = "symbols"