Beispiel

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

sha256:37621daef2c59c6541a26f603ca227a0a4c9ca669ae8669090859a929c393a3e

Fall

Ziel

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

Pakete

github.com/spf13/cobra 1.10.2

Umgebung

go

Erstellt

2026-08-17T18:26:15Z

Häufige Annahme

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

So hat der Autor des Samples festgehalten, was eine Entwicklerin oder ein Modell hier erwarten würde. Der Vertrag darunter ist das, was tatsächlich lief.

Contract

• 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.

Dateien

• NOTES.md
• csx.json
• go.mod
• go.sum
• lifecycle_test.go

Quellartefakt herunterladen (tar.gz)

Ursprungs-Seeder

csx-seed

Verifizierungsbelege

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