Exemplo

PersistentPreRun and PersistentPostRun hooks do not cascade hierarchically; intermediate and leaf definitions shadow ancestor hooks entirely, executing only the nearest hook.

sha256:37621daef2c59c6541a26f603ca227a0a4c9ca669ae8669090859a929c393a3e

PUBLISHED L3_CONTRACT_PASS MIT-0

Evidência de execução

O ambiente declarado é separado das execuções assinadas para mostrar exatamente o que foi provado.

Base da evidênciaContrato assinado aprovado

Recibos de verificação1

Nível de verificaçãoL3_CONTRACT_PASS

CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · golang@1 · 2026-08-17

Objetivo: PersistentPreRun and PersistentPostRun hooks do not cascade hierarchically; intermediate and leaf definitions shadow ancestor hooks entirely, executing only the nearest hook. HOW
Pacotes: github.com/spf13/cobra 1.10.2
Ambiente: go
Criado: 2026-08-17T18:26:15Z

Defining PersistentPreRun on a subcommand or group executes in addition to ancestor PersistentPreRun hooks in hierarchical root-to-leaf order.

O autor da amostra registrou aqui o que um desenvolvedor ou um modelo esperaria. O contrato abaixo é o que de fato rodou.

PersistentPreRun on a subcommand or group completely shadows ancestor PersistentPreRun hooks, executing only the nearest hook and skipping root initialization unless manually chained.
A subcommand defining only PreRun executes the nearest ancestor PersistentPreRun first followed by its own PreRun.
When a single command defines both PersistentPreRun and PreRun, PersistentPreRun executes first followed by PreRun before Run.
When both error-returning (*E) and non-error variants are set on the same hook, Cobra executes the *E variant and silently ignores the non-E function.
Returning an error from PersistentPreRunE or PreRunE immediately short-circuits execution, skipping Run, PostRun, and PersistentPostRun.
Returning an error from RunE aborts before PostRun and PersistentPostRun execute, returning the error to Execute.
Context mutations performed via cmd.SetContext in PersistentPreRun or PreRun are preserved and accessible via cmd.Context in Run and PostRun hooks.
PostRun executes on the active command before the nearest PersistentPostRun, which is similarly shadowed by intermediate definitions.

go 1.26 · linux alpine/x64 · docker · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · golang@1 · 2026-08-17 · ed25519:d91480838ac982c9