cli

package
v1.5.5 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 3, 2026 License: Apache-2.0 Imports: 35 Imported by: 0

Documentation

Index

Constants

View Source 
const MaxTextWidth = 100

MaxTextWidth caps wrapped CLI text output at a readable line length.

Variables

View Source 
var ErrRunRequestChoiceCanceled = errors.New("request selection canceled")

Functions

func BoolVarAliases added in v0.39.4 

func BoolVarAliases(fs *flag.FlagSet, dst *bool, value bool, usage string, names ...string)

func CleanExecPath added in v0.28.1 

func CleanExecPath(path string) string

func CommandFileConflict 

func CommandFileConflict(app, name, hint string) error

func DetectWidth added in v0.46.1 

func DetectWidth(w io.Writer) int

DetectWidth resolves the terminal width. COLUMNS overrides everything, otherwise writer, the standard streams and finally /dev/tty are probed so a redirected stderr still yields the real width. defaultWidth is the last resort.

func DurationVarAliases added in v0.39.4 

func DurationVarAliases(
	fs *flag.FlagSet,
	dst *time.Duration,
	value time.Duration,
	usage string,
	names ...string,
)

func ExitCode 

func ExitCode(err error) int

func HasFileConflict 

func HasFileConflict(name string) bool

func IntVarAliases added in v0.39.4 

func IntVarAliases(fs *flag.FlagSet, dst *int, value int, usage string, names ...string)

func IsExitCodeOnly added in v0.36.1 

func IsExitCodeOnly(err error) bool

IsExitCodeOnly reports whether err is only an exit-code carrier.

Commands use this after they have already written their output and need to return a non-zero process status without producing another stderr diagnostic.

func NewExecClient added in v0.28.1 

func NewExecClient(version string, f ExecFlags) (*httpx.Client, func() error, error)

func NewFlagSet 

func NewFlagSet(name string) *flag.FlagSet

func NewSubcommandFlagSet 

func NewSubcommandFlagSet(app, name string, w io.Writer) *flag.FlagSet

func ParseCompareTargets 

func ParseCompareTargets(raw string) ([]string, error)

func ParseRunDoc added in v0.28.1 

func ParseRunDoc(src RunSource) (*restfile.Document, error)

func PrintFlagDefaults added in v0.39.4 

func PrintFlagDefaults(w io.Writer, fs *flag.FlagSet)

func PrintFlagSetUsage 

func PrintFlagSetUsage(w io.Writer, app string, fs *flag.FlagSet)

func StdinRunPath added in v0.28.1 

func StdinRunPath(workspace string) string

StdinRunPath gives stdin-backed runs a stable request-file path so relative resolution still has a workspace anchor.

func StringListVarAliases added in v0.50.0 

func StringListVarAliases(fs *flag.FlagSet, dst *[]string, usage string, names ...string)

func StringVar added in v0.28.1 

func StringVar(fs *flag.FlagSet, dst *string, name, value, usage string)

func StringVarAliases added in v0.39.4 

func StringVarAliases(fs *flag.FlagSet, dst *string, value, usage string, names ...string)

func WriteRunRequestChoices added in v0.28.1 

func WriteRunRequestChoices(
	w io.Writer,
	path string,
	choices []RunRequestChoice,
) error

func WriteTextStyled added in v0.29.2 

func WriteTextStyled(
	w io.Writer,
	rep *runfmt.Report,
	color termcolor.Config,
	def *theme.Definition,
) error

WriteTextStyled writes a runfmt text report with CLI-owned ANSI styling.

Types

type ExecConfig added in v0.28.1 

type ExecConfig struct {
	FilePath  string
	Workspace string
	Recursive bool
	Env       vars.Config
	HTTPOpts  httpx.Options
	GRPCOpts  grpcx.Options
	Compare   engine.CompareConfig
}

type ExecFlags added in v0.28.1 

type ExecFlags struct {
	EnvName           string
	EnvFile           string
	Workspace         string
	Timeout           time.Duration
	Insecure          bool
	Follow            bool
	ProxyURL          string
	MaxResponseSize   string
	MaxRedirects      int
	Recursive         bool
	CompareTargetsRaw string
	CompareBaseline   string
	CompareGroup      string
	EnvGroups         GroupFlags
	// contains filtered or unexported fields
}

func NewExecFlags added in v0.28.1 

func NewExecFlags() ExecFlags

func (*ExecFlags) Bind added in v0.28.1 

func (f *ExecFlags) Bind(fs *flag.FlagSet)

func (*ExecFlags) BindTelemetryFlags added in v0.28.1 

func (f *ExecFlags) BindTelemetryFlags(fs *flag.FlagSet)

func (ExecFlags) Resolve added in v0.28.1 

func (f ExecFlags) Resolve(filePath string) (ExecConfig, error)

Resolve builds a run configuration and requires a valid environment file.

func (ExecFlags) ResolveSession added in v1.2.1 

func (f ExecFlags) ResolveSession(filePath string) (ExecConfig, error)

ResolveSession builds an editor configuration. Parse errors are returned in Env.FileErr so the editor can open the file, while other load errors remain fatal. Requests stay blocked until the file parses successfully.

func (ExecFlags) TelemetryConfig added in v0.28.1 

func (f ExecFlags) TelemetryConfig(version string) telemetry.Config

func (ExecFlags) ValidateEnvFlag added in v0.28.1 

func (f ExecFlags) ValidateEnvFlag() error

type ExitErr 

type ExitErr struct {
	Err  error
	Code int
}

func (ExitErr) Error 

func (e ExitErr) Error() string

func (ExitErr) ExitCode 

func (e ExitErr) ExitCode() int

func (ExitErr) Unwrap 

func (e ExitErr) Unwrap() error

type GroupFlags added in v0.49.1 

type GroupFlags map[string]string

func (*GroupFlags) Set added in v0.49.1 

func (f *GroupFlags) Set(value string) error

func (GroupFlags) String added in v0.49.1 

func (f GroupFlags) String() string

type RunRequestChoice added in v0.28.1 

type RunRequestChoice struct {
	Line   int
	Method string
	Name   string
	Target string
	Label  string
}

func BuildRunRequestChoices added in v0.28.1 

func BuildRunRequestChoices(doc *restfile.Document) []RunRequestChoice

func PromptRunRequestChoice added in v0.28.1 

func PromptRunRequestChoice(
	r io.Reader,
	w io.Writer,
	path string,
	choices []RunRequestChoice,
	opt RunRequestPromptOptions,
) (RunRequestChoice, error)

type RunRequestPromptOptions added in v0.28.1 

type RunRequestPromptOptions struct {
	TTY   bool
	Color termcolor.Config
	Theme *theme.Definition
}

type RunSource added in v0.28.1 

type RunSource struct {
	Path  string
	Data  []byte
	Stdin bool
}

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.