CodeSampleX

示例

clap 4.6.7

已验证示例 — cargo clap 4.6.7. contract 在 rust 1 · linux alpine/x64 · docker 上运行并通过： Command and Arg builder constructs flags, options, and positional arguments

sha256:0a61ded9333ad5a94566a675b89f61d4fdc77f408a5db07b79d6fd9ced8dc321

本网络只提供一件事：能构建的样本。它在沙箱中运行并保留签名回执。它不评级、不担保——同样的代码能否在你的环境构建，它没有测量过。 提交了通过的契约回执的不同签名密钥数量。为 1 表示只有作者；大于 1 表示还有其他人构建过。密钥是自行生成的，背后没有注册身份，因此计的是密钥而非人。 MIT-0

执行证据

声明的环境与签名的运行分开呈现，你可以看到这个样本究竟运行了什么、在哪里运行。

证据依据
签名契约通过
验证回执
1
构建过它的签名密钥
1
声明的环境 linux · alpine · musl x64 cargo

验证运行环境

环境 契约 阶段 运行日期
rust 1 · linux alpine/x64 · docker ed25519:c1973797be207ac4 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · cargo@1rust:1-alpine@sha256:a10e64dd139b…		 2026-10-22

案例

HOW
目标
verify pkg:cargo/clap@4.6.7
包
创建时间
2026-10-22T10:30:51Z

契约

  1. Command and Arg builder constructs flags, options, and positional arguments
  2. try_get_matches_from parses valid inputs and respects default values and flags
  3. PossibleValuesParser validates allowed choices and rejects invalid values
  4. Missing required positional argument returns MissingRequiredArgument error
  5. Unknown argument returns UnknownArgument error
  6. Subcommands are recognized and dispatch sub-arguments correctly

文件

  • Cargo.lock
  • Cargo.toml
  • PROMPT.md
  • csx.json
  • spec.json
  • src/lib.rs
  • test/contract.rs

下载源代码构件 (tar.gz)

源代码

Cargo.lock
# This file is automatically @generated by Cargo.
# It is not intended for manual editing.
version = 4

[[package]]
name = "anstream"
version = "1.0.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "824a212faf96e9acacdbd09febd34438f8f711fb84e09a8916013cd7815ca28d"
dependencies = [
 "anstyle",
 "anstyle-parse",
 "anstyle-query",
 "anstyle-wincon",
 "colorchoice",
 "is_terminal_polyfill",
 "utf8parse",
]

[[package]]
name = "anstyle"
version = "1.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "940b3a0ca603d1eade50a4846a2afffd5ef57a9feac2c0e2ec2e14f9ead76000"

[[package]]
name = "anstyle-parse"
version = "1.0.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "52ce7f38b242319f7cabaa6813055467063ecdc9d355bbb4ce0c68908cd8130e"
dependencies = [
 "utf8parse",
]

[[package]]
name = "anstyle-query"
version = "1.1.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "40c48f72fd53cd289104fc64099abca73db4166ad86ea0b4341abe65af83dadc"
dependencies = [
 "windows-sys",
]

[[package]]
name = "anstyle-wincon"
version = "3.0.11"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "291e6a250ff86cd4a820112fb8898808a366d8f9f58ce16d1f538353ad55747d"
dependencies = [
 "anstyle",
 "once_cell_polyfill",
 "windows-sys",
]

[[package]]
name = "clap"
version = "4.6.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "aa8876b300ab35ba921adea3dfd70157a46249b33f95c9084ae5709785478946"
dependencies = [
 "clap_builder",
]

[[package]]
name = "clap_builder"
version = "4.6.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ec0797fb7aeb1406c84efac526901f7ec3ead2124f946b494e72879d4b54704d"
dependencies = [
 "anstream",
 "anstyle",
 "clap_lex",
 "strsim",
]

[[package]]
name = "clap_lex"
version = "1.1.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1c133bc6a41be0d194c306b5506d15e6feeea7b1d6604bd3f8310dfb2ca96486"

[[package]]
name = "colorchoice"
version = "1.0.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1d07550c9036bf2ae0c684c4297d503f838287c83c53686d05370d0e139ae570"

[[package]]
name = "is_terminal_polyfill"
version = "1.70.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a6cb138bb79a146c1bd460005623e142ef0181e3d0219cb493e02f7d08a35695"

[[package]]
name = "once_cell_polyfill"
version = "1.70.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "384b8ab6d37215f3c5301a95a4accb5d64aa607f1fcb26a11b5303878451b4fe"

[[package]]
name = "sample-clap"
version = "1.0.0"
dependencies = [
 "clap",
]

[[package]]
name = "strsim"
version = "0.11.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7da8b5736845d9f2fcb837ea5d9e2628564b3b043a70948a3f0b778838c5fb4f"

[[package]]
name = "utf8parse"
version = "0.2.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "06abde3611657adf66d383f00b093d7faecc7fa57071cce2578660c9f1010821"

[[package]]
name = "windows-link"
version = "0.2.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"

[[package]]
name = "windows-sys"
version = "0.61.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ae137229bcbd6cdf0f7b80a31df61766145077ddf49416a728b02cb3921ff3fc"
dependencies = [
 "windows-link",
]
Cargo.toml
[package]
name = "sample-clap"
version = "1.0.0"
edition = "2021"
publish = false

[dependencies]
clap = "=4.6.7"

[[bin]]
name = "contract"
path = "test/contract.rs"
PROMPT.md
Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify pkg:cargo/clap@4.6.7
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:cargo/clap@4.6.7

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.
csx.json
{"case":{"caseId":"case:sha256:0737ad32097782ed6988ff7b52df5f8748977721acfb0dc17ad32adda80d58d0","contract":["Command and Arg builder constructs flags, options, and positional arguments","try_get_matches_from parses valid inputs and respects default values and flags","PossibleValuesParser validates allowed choices and rejects invalid values","Missing required positional argument returns MissingRequiredArgument error","Unknown argument returns UnknownArgument error","Subcommands are recognized and dispatch sub-arguments correctly"],"goal":"verify pkg:cargo/clap@4.6.7","kind":"HOW","packages":["pkg:cargo/clap@4.6.7"],"schemaVersion":1},"contractCommand":["cargo","run","--offline"],"environment":{"arch":"x64","distro":"alpine","ecosystem":"cargo","libc":"musl","os":"linux","packageManager":"cargo","schemaVersion":1},"license":"MIT-0","packages":["pkg:cargo/clap@4.6.7"],"schemaVersion":1,"subject":"pkg:cargo/clap@4.6.7","verifierAdapter":"cargo@1"}
spec.json
{
  "schemaVersion": 1,
  "goal": "verify pkg:cargo/clap@4.6.7",
  "kind": "HOW",
  "packages": [
    "pkg:cargo/clap@4.6.7"
  ]
}
src/lib.rs
//! Clean-room verification sample for clap.

pub use clap::*;
test/contract.rs
use clap::builder::PossibleValuesParser;
use clap::error::ErrorKind;
use clap::{Arg, ArgAction, Command};

fn main() {
    // 1. Command and Arg builder constructs flags, options, and positional arguments
    let cmd = Command::new("testapp")
        .version("1.0.0")
        .about("A test CLI application using clap")
        .args_conflicts_with_subcommands(true)
        .arg(
            Arg::new("verbose")
                .short('v')
                .long("verbose")
                .action(ArgAction::Count)
                .help("Verbosity level"),
        )
        .arg(
            Arg::new("config")
                .short('c')
                .long("config")
                .action(ArgAction::Set)
                .default_value("config.toml")
                .help("Configuration file path"),
        )
        .arg(
            Arg::new("mode")
                .short('m')
                .long("mode")
                .action(ArgAction::Set)
                .value_parser(PossibleValuesParser::new(["fast", "safe"]))
                .help("Execution mode"),
        )
        .arg(
            Arg::new("input")
                .action(ArgAction::Set)
                .required(true)
                .help("Input file to process"),
        )
        .subcommand(
            Command::new("run")
                .about("Run the task")
                .arg(
                    Arg::new("dry-run")
                        .long("dry-run")
                        .action(ArgAction::SetTrue),
                ),
        );

    // 2. try_get_matches_from parses valid inputs and respects default values and flags
    let matches = cmd
        .clone()
        .try_get_matches_from(vec!["testapp", "-vv", "input.txt"])
        .expect("should parse valid arguments");

    assert_eq!(matches.get_count("verbose"), 2);
    assert_eq!(
        matches.get_one::<String>("config").map(String::as_str),
        Some("config.toml")
    );
    assert_eq!(
        matches.get_one::<String>("input").map(String::as_str),
        Some("input.txt")
    );
    assert_eq!(matches.get_one::<String>("mode"), None);

    // 3. PossibleValuesParser validates allowed choices and rejects invalid values
    let mode_matches = cmd
        .clone()
        .try_get_matches_from(vec!["testapp", "--mode", "fast", "input.txt"])
        .expect("fast is a valid mode");
    assert_eq!(
        mode_matches.get_one::<String>("mode").map(String::as_str),
        Some("fast")
    );

    let invalid_mode = cmd
        .clone()
        .try_get_matches_from(vec!["testapp", "--mode", "invalid", "input.txt"]);
    assert!(invalid_mode.is_err());
    assert_eq!(invalid_mode.unwrap_err().kind(), ErrorKind::InvalidValue);

    // 4. Missing required positional argument returns MissingRequiredArgument error
    let missing_input = cmd.clone().try_get_matches_from(vec!["testapp"]);
    assert!(missing_input.is_err());
    assert_eq!(
        missing_input.unwrap_err().kind(),
        ErrorKind::MissingRequiredArgument
    );

    // 5. Unknown argument returns UnknownArgument error
    let unknown_arg = cmd
        .clone()
        .try_get_matches_from(vec!["testapp", "--nonexistent", "input.txt"]);
    assert!(unknown_arg.is_err());
    assert_eq!(
        unknown_arg.unwrap_err().kind(),
        ErrorKind::UnknownArgument
    );

    // 6. Subcommands are recognized and dispatch sub-arguments correctly
    let subcmd_matches = cmd
        .clone()
        .try_get_matches_from(vec!["testapp", "run", "--dry-run"])
        .expect("subcommand run should parse");
    let (sub_name, sub_matches) = subcmd_matches.subcommand().unwrap();
    assert_eq!(sub_name, "run");
    assert!(sub_matches.get_flag("dry-run"));

    println!("All clap contract assertions passed successfully.");
}

原始种子者

匿名