CodeSampleX

Пример

clap 4.6.7: clap::error::ContextKind

Проверенный пример — cargo clap 4.6.7: clap::error::ContextKind. Контракт выполнен на rust 1 · linux alpine/x64 · docker и пройден.

sha256:b432fbbb21f57b1aed2e3a578ef33f7b4720636b016b82a66786d717ff867aa5

Эта сеть предлагает одно: образец, который собирается. Она запустила его в песочнице и сохранила подписанную квитанцию. Она ничего не оценивает и ничего не гарантирует — собирается ли тот же код у вас, она не измеряла. Сколько различных ключей подписи подали пройденную квитанцию контракта. Один — только автор; больше одного — значит, кто-то ещё тоже собрал. Ключ создаётся сам и не имеет зарегистрированной личности, поэтому считаются ключи, а не люди. 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 clap::error::ContextKind in pkg:cargo/clap@4.6.7
Пакеты
Символы
  • clap::error::ContextKind
Создан
2026-10-22T17:43:23Z

Контракт

  1. Unknown argument error populates ContextKind::InvalidArg with the offending flag string
  2. Invalid value error populates ContextKind::InvalidArg, ContextKind::InvalidValue, and ContextKind::ValidValue
  3. Invalid subcommand error populates ContextKind::InvalidSubcommand and ContextKind::Usage, and supports inserting ContextKind::Custom
  4. ContextKind::as_str returns display labels for argument, value, and subcommand kinds and None for ContextKind::Usage
  5. Error::context iterates over (ContextKind, &ContextValue) entries attached to a clap::Error

Файлы

  • 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-context-kind"
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-context-kind"
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 clap::error::ContextKind in pkg:cargo/clap@4.6.7
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:cargo/clap@4.6.7
Demonstrate these symbols/APIs:
  - clap::error::ContextKind

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:d9c419ab4a5e45fa4e2f4652bedbd0e027ea458e982a24cc9f6f6af1dde0b971","contract":["Unknown argument error populates ContextKind::InvalidArg with the offending flag string","Invalid value error populates ContextKind::InvalidArg, ContextKind::InvalidValue, and ContextKind::ValidValue","Invalid subcommand error populates ContextKind::InvalidSubcommand and ContextKind::Usage, and supports inserting ContextKind::Custom","ContextKind::as_str returns display labels for argument, value, and subcommand kinds and None for ContextKind::Usage","Error::context iterates over (ContextKind, \u0026ContextValue) entries attached to a clap::Error"],"goal":"verify clap::error::ContextKind in pkg:cargo/clap@4.6.7","kind":"HOW","packages":["pkg:cargo/clap@4.6.7"],"schemaVersion":1,"symbols":["clap::error::ContextKind"]},"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","symbols":["clap::error::ContextKind"],"verifierAdapter":"cargo@1"}
spec.json
{
  "schemaVersion": 1,
  "goal": "verify clap::error::ContextKind in pkg:cargo/clap@4.6.7",
  "kind": "HOW",
  "packages": [
    "pkg:cargo/clap@4.6.7"
  ],
  "symbols": [
    "clap::error::ContextKind"
  ]
}
src/lib.rs
//! Clean-room verification sample for clap::error::ContextKind.

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

fn main() {
    let cmd = Command::new("demo")
        .arg(
            Arg::new("mode")
                .long("mode")
                .value_parser(PossibleValuesParser::new(["fast", "slow"])),
        )
        .subcommand(Command::new("run"));

    // 1. Unknown argument error populates ContextKind::InvalidArg
    let err_unknown = cmd
        .clone()
        .try_get_matches_from(["demo", "--unknown"])
        .expect_err("unknown argument should fail");
    assert_eq!(err_unknown.kind(), ErrorKind::UnknownArgument);
    assert_eq!(
        err_unknown.get(ContextKind::InvalidArg),
        Some(&ContextValue::String("--unknown".to_string()))
    );

    // 2. Invalid value error populates ContextKind::InvalidArg, InvalidValue, and ValidValue
    let err_val = cmd
        .clone()
        .try_get_matches_from(["demo", "--mode", "medium"])
        .expect_err("invalid value should fail");
    assert_eq!(err_val.kind(), ErrorKind::InvalidValue);
    assert_eq!(
        err_val.get(ContextKind::InvalidArg),
        Some(&ContextValue::String("--mode <mode>".to_string()))
    );
    assert_eq!(
        err_val.get(ContextKind::InvalidValue),
        Some(&ContextValue::String("medium".to_string()))
    );
    assert_eq!(
        err_val.get(ContextKind::ValidValue),
        Some(&ContextValue::Strings(vec![
            "fast".to_string(),
            "slow".to_string()
        ]))
    );

    // 3. Invalid subcommand error populates ContextKind::InvalidSubcommand and Usage, and supports custom context insertion
    let mut err_sub = cmd
        .try_get_matches_from(["demo", "unknown-sub"])
        .expect_err("invalid subcommand should fail");
    assert_eq!(err_sub.kind(), ErrorKind::InvalidSubcommand);
    assert_eq!(
        err_sub.get(ContextKind::InvalidSubcommand),
        Some(&ContextValue::String("unknown-sub".to_string()))
    );
    assert!(err_sub.get(ContextKind::Usage).is_some());
    err_sub.insert(
        ContextKind::Custom,
        ContextValue::String("extra diagnostic".to_string()),
    );
    assert_eq!(
        err_sub.get(ContextKind::Custom),
        Some(&ContextValue::String("extra diagnostic".to_string()))
    );

    // 4. ContextKind::as_str returns human-readable labels for known variants and None for Usage
    assert_eq!(ContextKind::InvalidArg.as_str(), Some("Invalid Argument"));
    assert_eq!(ContextKind::InvalidValue.as_str(), Some("Invalid Value"));
    assert_eq!(ContextKind::ValidValue.as_str(), Some("Valid Value"));
    assert_eq!(
        ContextKind::InvalidSubcommand.as_str(),
        Some("Invalid Subcommand")
    );
    assert_eq!(ContextKind::Usage.as_str(), None);

    // 5. Error::context iterates over (ContextKind, &ContextValue) entries
    let kinds: Vec<ContextKind> = err_val.context().map(|(k, _)| k).collect();
    assert!(kinds.contains(&ContextKind::InvalidArg));
    assert!(kinds.contains(&ContextKind::InvalidValue));
    assert!(kinds.contains(&ContextKind::ValidValue));
}

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

аноним