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

이 네트워크가 제공하는 것은 하나입니다. 빌드되는 샘플. 샌드박스에서 돌리고 서명된 영수증을 보관합니다. 등급을 매기지 않고 무엇도 보증하지 않습니다 — 같은 코드가 당신 환경에서 빌드되는지는 측정한 적이 없습니다. 통과한 계약 영수증을 낸 서로 다른 서명 키의 수입니다. 하나면 작성자 혼자이고, 둘 이상이면 다른 사람도 빌드했다는 뜻입니다. 키는 스스로 만드는 것이고 뒤에 등록된 신원이 없으므로, 세는 것은 사람이 아니라 키입니다. 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