サンプル

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

sha256:37621daef2c59c6541a26f603ca227a0a4c9ca669ae8669090859a929c393a3e

ケース

ゴール

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

パッケージ

github.com/spf13/cobra 1.10.2

環境

go

作成日

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.

このサンプルの作者が、ここで開発者やモデルが期待するであろうこととして記録したもの。下の契約が実際に実行されたものだ。

コントラクト

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

ファイル

• NOTES.md
• csx.json
• go.mod
• go.sum
• lifecycle_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