Add the commandeer in Run

Author: bep

README.md

@@ -7,14 +7,15 @@ So, [Cobra](https://github.com/spf13/cobra) is a Go CLI library with a feature s
 I welcome suggestions to improve/simplify this further, but the core idea is that the command graph gets built in one go with a tree of struct pointers implementing a simple `Commander` interface:
 
 ```go
+// Commander is the interface that must be implemented by all commands.
 type Commander interface {
 	// The name of the command.
 	Name() string
 
 	// The command execution.
-	Run(ctx context.Context, args []string) error
+	Run(ctx context.Context, cd *Commandeer, args []string) error
 
-	// Init called on all commands in this tree, before execution, starting from the root.
+	// Init called on all ancestors and the executing command itself, before execution, starting from the root.
 	// This is the place to evaluate flags and set up the command.
 	Init(*Commandeer) error
 

simplecobra.go

@@ -15,9 +15,9 @@ type Commander interface {
 	Name() string
 
 	// The command execution.
-	Run(ctx context.Context, args []string) error
+	Run(ctx context.Context, cd *Commandeer, args []string) error
 
-	// Init called on all commands in this tree, before execution, starting from the root.
+	// Init called on all ancestors and the executing command itself, before execution, starting from the root.
 	// This is the place to evaluate flags and set up the command.
 	Init(*Commandeer) error
 
@@ -109,7 +109,7 @@ func (c *Commandeer) compile() error {
 	c.CobraCommand = &cobra.Command{
 		Use: c.Command.Name(),
 		RunE: func(cmd *cobra.Command, args []string) error {
-			if err := c.Command.Run(cmd.Context(), args); err != nil {
+			if err := c.Command.Run(cmd.Context(), c, args); err != nil {
 				return &runErr{err: err}
 			}
 			return nil

simplecobra_test.go

@@ -25,7 +25,7 @@ func testCommands() *rootCommand {
 
 }
 
-func TestSimplecobra(t *testing.T) {
+func TestSimpleCobra(t *testing.T) {
 	c := qt.New(t)
 
 	rootCmd := testCommands()
@@ -191,7 +191,7 @@ func (c *rootCommand) Name() string {
 	return c.name
 }
 
-func (c *rootCommand) Run(ctx context.Context, args []string) error {
+func (c *rootCommand) Run(ctx context.Context, cd *simplecobra.Commandeer, args []string) error {
 	c.ctx = ctx
 	return nil
 }
@@ -235,7 +235,7 @@ func (c *lvl1Command) Name() string {
 	return c.name
 }
 
-func (c *lvl1Command) Run(ctx context.Context, args []string) error {
+func (c *lvl1Command) Run(ctx context.Context, cd *simplecobra.Commandeer, args []string) error {
 	c.ctx = ctx
 	return nil
 }
@@ -271,7 +271,7 @@ func (c *lvl2Command) Name() string {
 	return c.name
 }
 
-func (c *lvl2Command) Run(ctx context.Context, args []string) error {
+func (c *lvl2Command) Run(ctx context.Context, cd *simplecobra.Commandeer, args []string) error {
 	c.ctx = ctx
 	return nil
 }