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…

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