Implement the debug flag and help command

I'm vacillating about the choice to have separate Config structs in the
`helm` and `run` packages. I can't tell whether it's "good separation of
concerns" or "cumbersome and over-engineered." It seems appropriate at
the moment, though.

internal/run/config.go

@@ -0,0 +1,22 @@
+package run
+
+import (
+	"io"
+)
+
+// Config contains configuration applicable to all helm commands
+type Config struct {
+	Debug          bool
+	KubeConfig     string
+	Values         string
+	StringValues   string
+	ValuesFiles    []string
+	Namespace      string
+	Token          string
+	SkipTLSVerify  bool
+	Certificate    string
+	APIServer      string
+	ServiceAccount string
+	Stdout         io.Writer
+	Stderr         io.Writer
+}

internal/run/help.go

@@ -1,7 +1,7 @@
 package run
 
 import (
-	"os"
+	"fmt"
 )
 
 // Help is a step in a helm Plan that calls `helm help`.
@@ -9,18 +9,25 @@ type Help struct {
 	cmd cmd
 }
 
-// Run launches the command.
-func (h *Help) Run() error {
+// Execute executes the `helm help` command.
+func (h *Help) Execute() error {
 	return h.cmd.Run()
 }
 
-// NewHelp returns a new Help.
-func NewHelp() *Help {
-	h := Help{}
+// Prepare gets the Help ready to execute.
+func (h *Help) Prepare(cfg Config) error {
+	args := []string{"help"}
+	if cfg.Debug {
+		args = append([]string{"--debug"}, args...)
+	}
 
-	h.cmd = command(helmBin, "help")
-	h.cmd.Stdout(os.Stdout)
-	h.cmd.Stderr(os.Stderr)
+	h.cmd = command(helmBin, args...)
+	h.cmd.Stdout(cfg.Stdout)
+	h.cmd.Stderr(cfg.Stderr)
 
-	return &h
+	if cfg.Debug {
+		fmt.Fprintf(cfg.Stderr, "Generated command: '%s'\n", h.cmd.String())
+	}
+
+	return nil
 }

internal/run/help_test.go

@@ -1,33 +1,72 @@
 package run
 
 import (
+	"fmt"
 	"github.com/golang/mock/gomock"
 	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/suite"
+	"strings"
 	"testing"
 )
 
-func TestHelp(t *testing.T) {
-	ctrl := gomock.NewController(t)
+type HelpTestSuite struct {
+	suite.Suite
+}
+
+func TestHelpTestSuite(t *testing.T) {
+	suite.Run(t, new(HelpTestSuite))
+}
+
+func (suite *HelpTestSuite) TestPrepare() {
+	ctrl := gomock.NewController(suite.T())
 	defer ctrl.Finish()
 
 	mCmd := NewMockcmd(ctrl)
 	originalCommand := command
 
 	command = func(path string, args ...string) cmd {
-		assert.Equal(t, helmBin, path)
-		assert.Equal(t, []string{"help"}, args)
+		assert.Equal(suite.T(), helmBin, path)
+		assert.Equal(suite.T(), []string{"help"}, args)
 		return mCmd
 	}
 	defer func() { command = originalCommand }()
 
+	stdout := strings.Builder{}
+	stderr := strings.Builder{}
+
 	mCmd.EXPECT().
-		Stdout(gomock.Any())
+		Stdout(&stdout)
 	mCmd.EXPECT().
-		Stderr(gomock.Any())
+		Stderr(&stderr)
 	mCmd.EXPECT().
 		Run().
 		Times(1)
 
-	h := NewHelp()
-	h.Run()
+	cfg := Config{
+		Stdout: &stdout,
+		Stderr: &stderr,
+	}
+
+	h := Help{}
+	err := h.Prepare(cfg)
+	suite.Require().Nil(err)
+	h.Execute()
+}
+
+func (suite *HelpTestSuite) TestPrepareDebugFlag() {
+	help := Help{}
+
+	stdout := strings.Builder{}
+	stderr := strings.Builder{}
+	cfg := Config{
+		Debug:  true,
+		Stdout: &stdout,
+		Stderr: &stderr,
+	}
+
+	help.Prepare(cfg)
+
+	want := fmt.Sprintf("Generated command: '%s --debug help'\n", helmBin)
+	suite.Equal(want, stderr.String())
+	suite.Equal("", stdout.String())
 }

internal/run/upgrade.go

@@ -1,31 +1,43 @@
 package run
 
 import (
-	"os"
+	"fmt"
 )
 
-// Upgrade is a step in a helm Plan that calls `helm upgrade`.
+// Upgrade is an execution step that calls `helm upgrade` when executed.
 type Upgrade struct {
 	Chart   string
 	Release string
-	cmd     cmd
+
+	ChartVersion string
+	Wait         bool
+	ReuseValues  bool
+	Timeout      string
+	Force        bool
+
+	cmd cmd
 }
 
-// Run launches the command.
-func (u *Upgrade) Run() error {
+// Execute executes the `helm upgrade` command.
+func (u *Upgrade) Execute() error {
 	return u.cmd.Run()
 }
 
-// NewUpgrade creates a new Upgrade.
-func NewUpgrade(release, chart string) *Upgrade {
-	u := Upgrade{
-		Chart:   chart,
-		Release: release,
-		cmd:     command(helmBin, "upgrade", "--install", release, chart),
+// Prepare gets the Upgrade ready to execute.
+func (u *Upgrade) Prepare(cfg Config) error {
+	args := []string{"upgrade", "--install", u.Release, u.Chart}
+
+	if cfg.Debug {
+		args = append([]string{"--debug"}, args...)
 	}
 
-	u.cmd.Stdout(os.Stdout)
-	u.cmd.Stderr(os.Stderr)
+	u.cmd = command(helmBin, args...)
+	u.cmd.Stdout(cfg.Stdout)
+	u.cmd.Stderr(cfg.Stderr)
 
-	return &u
+	if cfg.Debug {
+		fmt.Fprintf(cfg.Stderr, "Generated command: '%s'\n", u.cmd.String())
+	}
+
+	return nil
 }

internal/run/upgrade_test.go

@@ -1,34 +1,94 @@
 package run
 
 import (
+	"fmt"
 	"github.com/golang/mock/gomock"
-	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/suite"
+	"strings"
 	"testing"
 )
 
-func TestNewUpgrade(t *testing.T) {
-	ctrl := gomock.NewController(t)
-	defer ctrl.Finish()
+type UpgradeTestSuite struct {
+	suite.Suite
+	ctrl            *gomock.Controller
+	mockCmd         *Mockcmd
+	originalCommand func(string, ...string) cmd
+}
 
-	mCmd := NewMockcmd(ctrl)
-	originalCommand := command
+func (suite *UpgradeTestSuite) BeforeTest(_, _ string) {
+	suite.ctrl = gomock.NewController(suite.T())
+	suite.mockCmd = NewMockcmd(suite.ctrl)
+
+	suite.originalCommand = command
+	command = func(path string, args ...string) cmd { return suite.mockCmd }
+}
+
+func (suite *UpgradeTestSuite) AfterTest(_, _ string) {
+	command = suite.originalCommand
+}
+
+func TestUpgradeTestSuite(t *testing.T) {
+	suite.Run(t, new(UpgradeTestSuite))
+}
+
+func (suite *UpgradeTestSuite) TestPrepare() {
+	defer suite.ctrl.Finish()
+
+	u := Upgrade{
+		Chart:   "at40",
+		Release: "jonas_brothers_only_human",
+	}
 
 	command = func(path string, args ...string) cmd {
-		assert.Equal(t, helmBin, path)
-		assert.Equal(t, []string{"upgrade", "--install", "jonas_brothers_only_human", "at40"}, args)
+		suite.Equal(helmBin, path)
+		suite.Equal([]string{"upgrade", "--install", "jonas_brothers_only_human", "at40"}, args)
 
-		return mCmd
+		return suite.mockCmd
 	}
-	defer func() { command = originalCommand }()
 
-	mCmd.EXPECT().
+	suite.mockCmd.EXPECT().
 		Stdout(gomock.Any())
-	mCmd.EXPECT().
+	suite.mockCmd.EXPECT().
 		Stderr(gomock.Any())
-	mCmd.EXPECT().
+	suite.mockCmd.EXPECT().
 		Run().
 		Times(1)
 
-	u := NewUpgrade("jonas_brothers_only_human", "at40")
-	u.Run()
+	err := u.Prepare(Config{})
+	suite.Require().Nil(err)
+	u.Execute()
+}
+
+func (suite *UpgradeTestSuite) TestPrepareDebugFlag() {
+	u := Upgrade{
+		Chart:   "at40",
+		Release: "lewis_capaldi_someone_you_loved",
+	}
+
+	stdout := strings.Builder{}
+	stderr := strings.Builder{}
+	cfg := Config{
+		Debug:  true,
+		Stdout: &stdout,
+		Stderr: &stderr,
+	}
+
+	command = func(path string, args ...string) cmd {
+		suite.mockCmd.EXPECT().
+			String().
+			Return(fmt.Sprintf("%s %s", path, strings.Join(args, " ")))
+
+		return suite.mockCmd
+	}
+
+	suite.mockCmd.EXPECT().
+		Stdout(&stdout)
+	suite.mockCmd.EXPECT().
+		Stderr(&stderr)
+
+	u.Prepare(cfg)
+
+	want := fmt.Sprintf("Generated command: '%s --debug upgrade --install lewis_capaldi_someone_you_loved at40'\n", helmBin)
+	suite.Equal(want, stderr.String())
+	suite.Equal("", stdout.String())
 }