Skip to main content

spec_driven_docs/cli/
payload.rs

1//! `payload` subcommand: parse-shape.
2//!
3//! Holds the clap derive struct only. No I/O, no business logic.
4
5/// Report what a release carries, through the release seam.
6#[derive(Debug, clap::Args)]
7pub struct PayloadArgs {
8    /// A published version, or the release this binary carries.
9    ///
10    /// `latest` resolves the highest stable, non-yanked release at the
11    /// registry. An exact version is fetched, verified against the index
12    /// checksum, and cached.
13    #[arg(long)]
14    pub release: Option<String>,
15
16    /// Forbid every network read.
17    ///
18    /// An exact version already cached still resolves. `latest` refuses,
19    /// because only the index says which release is newest.
20    #[arg(long)]
21    pub offline: bool,
22
23    /// Print one JSON object instead of text.
24    #[arg(long)]
25    pub json: bool,
26}