prompter

type FileReader ¶

type FileReader interface {
	io.Reader
	Fd() uintptr
}

FileReader provides a minimal readable interface for stdin.

type FileWriter ¶

type FileWriter interface {
	io.Writer
	Fd() uintptr
}

FileWriter provides a minimal writable interface for stdout and stderr.

type Prompter ¶

type Prompter struct {
	// contains filtered or unexported fields
}

Prompter provides methods for prompting the user.

term := term.FromEnv()
in, ok := term.In().(*os.File)
if !ok {
	log.Fatal("error casting to file")
}
out, ok := term.Out().(*os.File)
if !ok {
	log.Fatal("error casting to file")
}
errOut, ok := term.ErrOut().(*os.File)
if !ok {
	log.Fatal("error casting to file")
}
prompter := New(in, out, errOut)
response, err := prompter.Confirm("Shall we play a game", true)
if err != nil {
	log.Fatal(err)
}
fmt.Println(response)

Output:

func New(stdin FileReader, stdout FileWriter, stderr FileWriter) *Prompter

func (p *Prompter) Confirm(prompt string, defaultValue bool) (bool, error)

func (p *Prompter) Input(prompt, defaultValue string) (string, error)

func (p *Prompter) MultiSelect(prompt string, defaultValues, options []string) ([]int, error)

func (p *Prompter) Password(prompt string) (string, error)

func (p *Prompter) Select(prompt, defaultValue string, options []string) (int, error)

type PrompterMock ¶

type PrompterMock struct {
	// contains filtered or unexported fields
}

PrompterMock provides stubbed out methods for prompting the user for use in tests. PrompterMock has a superset of the methods on Prompter so they both can satisfy the same interface.

A basic example of how PrompterMock can be used:

type ConfirmPrompter interface {
	Confirm(string, bool) (bool, error)
}

func PlayGame(prompter ConfirmPrompter) (int, error) {
	confirm, err := prompter.Confirm("Shall we play a game", true)
	if err != nil {
		return 0, err
	}
	if confirm {
		return 1, nil
	}
	return 2, nil
}

func TestPlayGame(t *testing.T) {
	expectedOutcome := 1
	mock := NewMock(t)
	mock.RegisterConfirm("Shall we play a game", func(prompt string, defaultValue bool) (bool, error) {
		return true, nil
	})
	outcome, err := PlayGame(mock)
	if err != nil {
		t.Fatalf("unexpected error: %v", err)
	}
	if outcome != expectedOutcome {
		t.Errorf("expected %q, got %q", expectedOutcome, outcome)
	}
}

func NewMock(t *testing.T) *PrompterMock

func (m *PrompterMock) Confirm(prompt string, defaultValue bool) (bool, error)

func (m *PrompterMock) Input(prompt, defaultValue string) (string, error)

func (m *PrompterMock) MultiSelect(prompt string, defaultValues, options []string) ([]int, error)

func (m *PrompterMock) Password(prompt string) (string, error)

func (m *PrompterMock) RegisterConfirm(prompt string, stub func(_ string, _ bool) (bool, error))

func (m *PrompterMock) RegisterInput(prompt string, stub func(_, _ string) (string, error))

func (m *PrompterMock) RegisterMultiSelect(prompt string, d, opts []string, stub func(_ string, _, _ []string) ([]int, error))

func (m *PrompterMock) RegisterPassword(prompt string, stub func(string) (string, error))

func (m *PrompterMock) RegisterSelect(prompt string, opts []string, stub func(_, _ string, _ []string) (int, error))

func (m *PrompterMock) Select(prompt, defaultValue string, options []string) (int, error)