CodeSampleX

サンプル

github.com/spf13/cobra 1.10.2: Flag group constraints (mutually exclusive, required together, and one required) execute after PreRun hooks but before Run, aborting execution on violations while bypassing SetFlagErrorFunc.

検証済みサンプル — golang github.com/spf13/cobra 1.10.2: Flag group constraints (mutually exclusive, required together, and one required) execute after PreRun hooks…

sha256:642e6bb5a164411e03b08f623e81d7cd24ad1784fffe004a1b088e56055da69b

このネットワークが提供するのは一つだけです。ビルドされるサンプル。サンドボックスで実行し、署名済みの受領証を保管します。等級はつけず、何も保証しません — 同じコードがあなたの環境でビルドされるかは測定していません。 合格した契約受領証を提出した異なる署名鍵の数です。1 なら作者だけ、2 以上なら他の誰かもビルドしています。鍵は自己生成で背後に登録された身元がないため、数えているのは人ではなく鍵です。 MIT-0

実行証拠

宣言された環境と署名済みの実行を分けてあります。このサンプルが何をどこで実行したかをそのまま確認できます。

証拠の基準
署名済みコントラクト合格
検証レシート
2
ビルドした署名鍵
2
宣言された環境 go linux x64 go go go

検証実行環境

環境 コントラクト ステージ 実行日
go 1.26 · linux alpine/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · golang@1
2026-08-17
go 1.26 · linux alpine/x64 · docker ed25519:2175b912ea1c23b1 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · golang@1
2026-08-18

ケース

HOW
ゴール
Flag group constraints (mutually exclusive, required together, and one required) execute after PreRun hooks but before Run, aborting execution on violations while bypassing SetFlagErrorFunc.
パッケージ
シンボル
  • Command.MarkFlagsMutuallyExclusive
  • Command.MarkFlagsRequiredTogether
  • Command.MarkFlagsOneRequired
  • Command.SetFlagErrorFunc
  • Command.Flags
  • Command.InheritedFlags
  • Command.LocalFlags
  • Command.NonInheritedFlags
  • Command.SilenceUsage
  • Command.SilenceErrors
環境
go
作成日
2026-08-17T20:42:37Z

コントラクト

  1. Flag group constraints defined with MarkFlagsMutuallyExclusive, MarkFlagsRequiredTogether, and MarkFlagsOneRequired execute after PreRun hooks and before Run, aborting execution on constraint violations while bypassing SetFlagErrorFunc.
  2. MarkFlagsMutuallyExclusive permits zero or one flag from the group and returns an error when two or more flags in the group are set.
  3. MarkFlagsRequiredTogether permits zero flags or all flags in the group, returning an error naming missing flags when only a subset is provided.
  4. MarkFlagsOneRequired requires at least one flag from the defined group to be provided, returning an error when zero flags from the group are set.
  5. Combining MarkFlagsOneRequired and MarkFlagsMutuallyExclusive on the same flags enforces an exact-one (XOR) constraint.
  6. Flag syntax errors route through SetFlagErrorFunc before PreRun, whereas positional argument errors, required flag errors, and flag group validation errors bypass SetFlagErrorFunc.
  7. Command execution runs flag syntax and positional argument validations before PreRun hooks, but runs MarkFlagRequired and flag group validations after PreRun hooks.
  8. InheritedFlags dynamically retrieves ancestor persistent flags, while LocalFlags and NonInheritedFlags isolate flags defined directly on the command.
  9. SilenceUsage suppresses usage synopsis printing on RunE errors while preserving the returned error object.

ファイル

  • NOTES.md
  • csx.json
  • flag_constraints_test.go
  • go.mod
  • go.sum
  • validation_order_test.go

ソースアーティファクトをダウンロード (tar.gz)

オリジンシーダー

csx-seed