pty

Documentation

Index

• func Start(cmd *exec.Cmd, opt ...StartOption) (PTY, Process, error)
• type Option
  • func WithGPGTTY() Option
  • func WithLogger(logger *log.Logger) Option
  • func WithSSHRequest(req ssh.Pty) Option
• type PTY
  • func New(opts ...Option) (PTY, error)
• type Process
• type ReadWriter
  • func (rw ReadWriter) Read(p []byte) (int, error)
  • func (rw ReadWriter) Write(p []byte) (int, error)
• type StartOption
  • func WithPTYOption(opts ...Option) StartOption
• type WithFlags

Functions

func Start

func Start(cmd *exec.Cmd, opt ...StartOption) (PTY, Process, error)

Start the command in a TTY. The calling code must not use cmd after passing it to the PTY, and instead rely on the returned Process to manage the command/process.

Types

type Option

type Option func(*ptyOptions)

Options represents a an option for a PTY.

func WithGPGTTY

func WithGPGTTY() Option

WithGPGTTY sets the GPG_TTY environment variable to the PTY name. This only applies to non-Windows platforms.

func WithLogger

func WithLogger(logger *log.Logger) Option

WithLogger sets a logger for logging errors.

func WithSSHRequest

func WithSSHRequest(req ssh.Pty) Option

WithSSHRequest applies the ssh.Pty request to the PTY.

Only partially supported on Windows (e.g. window size).

type PTY

type PTY interface {
	io.Closer

	// Name of the TTY. Example on Linux would be "/dev/pts/1".
	Name() string

	// Output handles TTY output.
	//
	// cmd.SetOutput(pty.Output()) would be used to specify a command
	// uses the output stream for writing.
	//
	// The same stream could be read to validate output.
	Output() ReadWriter

	// Input handles TTY input.
	//
	// cmd.SetInput(pty.Input()) would be used to specify a command
	// uses the PTY input for reading.
	//
	// The same stream would be used to provide user input: pty.Input().Write(...)
	Input() ReadWriter

	// Resize sets the size of the PTY.
	Resize(height uint16, width uint16) error
}

PTY is a minimal interface for interacting with a TTY.

func New

func New(opts ...Option) (PTY, error)

New constructs a new Pty.

type Process

type Process interface {
	// Wait for the command to complete.  Returned error is as for exec.Cmd.Wait()
	Wait() error

	// Kill the command process.  Returned error is as for os.Process.Kill()
	Kill() error
}

Process represents a process running in a PTY. We need to trigger special processing on the PTY on process completion, meaning that we will have goroutines calling Wait() on the process. Since the caller will also typically wait for the process, and it is not safe for multiple goroutines to Wait() on a process, this abstraction provides a goroutine-safe interface for interacting with the process.

type ReadWriter

type ReadWriter struct {
	Reader *os.File
	Writer *os.File
}

ReadWriter is an implementation of io.ReadWriter that wraps two separate underlying file descriptors, one for reading and one for writing, and allows them to be accessed separately.

func (ReadWriter) Read

func (rw ReadWriter) Read(p []byte) (int, error)

func (ReadWriter) Write

func (rw ReadWriter) Write(p []byte) (int, error)

type StartOption

type StartOption func(*startOptions)

StartOption represents a configuration option passed to Start.

func WithPTYOption

func WithPTYOption(opts ...Option) StartOption

WithPTYOption applies the given options to the underlying PTY.

type WithFlags

type WithFlags interface {
	PTY

	// EchoEnabled determines whether local echo is currently enabled for this terminal.
	EchoEnabled() (bool, error)
}

WithFlags represents a PTY whose flags can be inspected, in particular to determine whether local echo is enabled.