cli

type ExitError struct {
	Code int
	Err  error
}

type Options struct {
	ConfigFlags *genericclioptions.ConfigFlags

	// Wavefront names the Wavefront to operate on; empty auto-selects the
	// only one.
	Wavefront string
	// Output is one of the output* constants.
	Output string
	// NoColor suppresses colour even on a terminal.
	NoColor bool
	// Yes skips the confirmation prompt of the write commands. It is declared
	// here because it is a persistent flag of the tree, not of any one command.
	Yes bool
	// DryRun prints a write command's plan and stops. Unlike Yes it is a local
	// flag of each write command, because a read command has no plan to print.
	DryRun bool
	// Derive re-derives the picture live instead of reading published status.
	Derive bool
	// Poll adds a ref-advertisement sweep to a derivation.
	Poll bool
	// PollTimeout bounds one ref listing.
	PollTimeout time.Duration
	// PerHostConcurrency bounds concurrent listings per git host; 0 takes the
	// Wavefront's own spec.poll.perHostConcurrency.
	PerHostConcurrency int
	// From replays a captured snapshot instead of reading a cluster.
	From string

	// Now is the clock every rendered age is anchored to; nil means the wall
	// clock. render.Options.Now is always set from it, so no renderer ever
	// falls back to a clock of its own.
	Now func() time.Time
	// NewReader builds the cluster reader; nil means the real one, built from
	// ConfigFlags. Tests substitute a fake so the command tree can be driven
	// without an apiserver.
	NewReader func() (client.Reader, error)
	// NewClient builds the read-write client the write commands operate
	// through; nil means the real one, built from ConfigFlags. It is separate
	// from NewReader so that the read commands stay unable to write even by
	// accident.
	NewClient func() (client.Client, error)
	// Lister lists a source's advertised refs for `pin --poll` and
	// `force-admit`; nil means the production go-git lister.
	Lister gitpoll.Lister
	// StdinTTY reports whether stdin is an interactive terminal, i.e. whether
	// there is anybody to answer a confirmation prompt; nil means "ask
	// os.Stdin".
	StdinTTY func() bool
	// Identity names who is running the command, for the audit note; nil means
	// the kubeconfig-derived one.
	Identity func() string
	// ColorTTY reports whether the output is an interactive terminal; nil
	// means "ask os.Stdout".
	ColorTTY func() bool
	// ClusterIdent stamps a captured snapshot with the cluster it came from;
	// nil means the kubeconfig-derived one. It is a seam because the default
	// reads the ambient kubeconfig, which a test must not depend on even when
	// NewReader has replaced the client.
	ClusterIdent func() snapshot.ClusterIdent
}