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 but…

sha256:642e6bb5a164411e03b08f623e81d7cd24ad1784fffe004a1b088e56055da69b

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