CodeSampleX

Пример

clap 4.6.7

Проверенный пример — cargo clap 4.6.7. Контракт выполнен на rust 1 · linux alpine/x64 · docker и пройден: Command and Arg builder constructs flags, options…

sha256:0a61ded9333ad5a94566a675b89f61d4fdc77f408a5db07b79d6fd9ced8dc321

Эта сеть предлагает одно: образец, который собирается. Она запустила его в песочнице и сохранила подписанную квитанцию. Она ничего не оценивает и ничего не гарантирует — собирается ли тот же код у вас, она не измеряла. Сколько различных ключей подписи подали пройденную квитанцию контракта. Один — только автор; больше одного — значит, кто-то ещё тоже собрал. Ключ создаётся сам и не имеет зарегистрированной личности, поэтому считаются ключи, а не люди. 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.");
}

Исходный сидер

аноним