샘플
Flag group constraints (mutually exclusive, required together, and one required) execute after PreRun hooks but before Run, aborting execution on violations while bypassing SetFlagErrorFunc.
sha256:642e6bb5a164411e03b08f623e81d7cd24ad1784fffe004a1b088e56055da69b
PUBLISHED
L3_CONTRACT_PASS
MIT-0
실행 증거
선언된 환경과 서명된 검증 실행을 분리해 이 샘플이 실제로 증명하는 범위를 보여줍니다.
증거 기준서명된 컨트랙트 통과
검증 영수증1
검증 수준L3_CONTRACT_PASS
선언된 환경
- 실행 컨텍스트
- go
- 운영체제
- linux
- 아키텍처
- x64
- 런타임
- go
- 언어
- go
- 패키지 매니저
- go
검증 실행 환경
- 실행 컨텍스트
- go 1.26
- 운영체제
- linux alpine · musl
- 아키텍처
- x64
- 런타임
- go 1.26
- 언어
- go
- 패키지 매니저
- go
- 실행 방식
- container · docker
CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · golang@1 · 2026-08-17
케이스
- 목표
- Flag group constraints (mutually exclusive, required together, and one required) execute after PreRun hooks but before Run, aborting execution on violations while bypassing SetFlagErrorFunc. HOW
- 패키지
-
github.com/spf13/cobra 1.10.2
- 환경
- go
- 생성일
- 2026-08-17T20:42:37Z
컨트랙트
- Flag group constraints defined with MarkFlagsMutuallyExclusive, MarkFlagsRequiredTogether, and MarkFlagsOneRequired execute after PreRun hooks and before Run, aborting execution on constraint violations while bypassing SetFlagErrorFunc.
- MarkFlagsMutuallyExclusive permits zero or one flag from the group and returns an error when two or more flags in the group are set.
- MarkFlagsRequiredTogether permits zero flags or all flags in the group, returning an error naming missing flags when only a subset is provided.
- MarkFlagsOneRequired requires at least one flag from the defined group to be provided, returning an error when zero flags from the group are set.
- Combining MarkFlagsOneRequired and MarkFlagsMutuallyExclusive on the same flags enforces an exact-one (XOR) constraint.
- Flag syntax errors route through SetFlagErrorFunc before PreRun, whereas positional argument errors, required flag errors, and flag group validation errors bypass SetFlagErrorFunc.
- Command execution runs flag syntax and positional argument validations before PreRun hooks, but runs MarkFlagRequired and flag group validations after PreRun hooks.
- InheritedFlags dynamically retrieves ancestor persistent flags, while LocalFlags and NonInheritedFlags isolate flags defined directly on the command.
- 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
검증 영수증
- go 1.26 · linux alpine/x64 · docker · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · golang@1 · 2026-08-17 · ed25519:d91480838ac982c9