flags

type FieldInfo struct {
	FieldName    string
	FieldPath    []int // Indices to navigate from root struct to this field
	FieldType    reflect.Type
	FlagName     string
	Help         string
	Category     string
	DefaultValue string
	ShortFlag    string
	Required     bool
	Hidden       bool
	IsStdin      bool
	IsArgs       bool
	LiteralSlice bool
	// CLIFileRead and RPCFileRead opt the field into `@file`/`@url` expansion,
	// from `clicky:"cli-file-read"` and `clicky:"rpc-file-read"`. They are
	// separate because the two paths read from different machines: the CLI
	// reads the operator's disk, the RPC handler reads the server's. See
	// fileaccess.go.
	CLIFileRead bool
	RPCFileRead bool
	// Enum is the field's closed set of accepted values, from an
	// `enum:"a,b,c"` tag. It travels into the OpenAPI parameter and the
	// published action schema, so a front end renders the real choices instead
	// of hardcoding a list that drifts from the server's.
	Enum []string
}

type FileReadPolicy struct {
	// Enabled is the field's opt-in for this path. False passes the value
	// through untouched.
	Enabled bool
	// Remote marks a value that arrived over the network. It tightens the URL
	// rules, because a server fetching a caller-supplied URL can reach hosts
	// the caller cannot.
	Remote bool
	// contains filtered or unexported fields
}

type FileReference struct {
	Name string
	Body io.ReadCloser
}

type FileReferenceOptions struct {
	// BaseDir anchors relative paths; empty uses the working directory.
	BaseDir string
	// Root confines local files to this real directory. Remote callers must set
	// it or Roots.
	Root string
	// Roots extends Root: a local file is accepted when it lies under Root or any
	// of these. Every entry must exist.
	Roots []string
	// Remote uses defensive HTTP and forbids unrooted local files.
	Remote bool
}

type FlagValue struct {
	FieldName      string
	FieldPath      []int // Field indices for navigating embedded structs
	FieldType      reflect.Type
	DefaultValue   string
	Required       bool
	IsStdin        bool
	IsArgs         bool
	CLIFileRead    bool
	StringPtr      *string
	IntPtr         *int
	Float64Ptr     *float64
	BoolPtr        *bool
	StringSlicePtr *[]string
	IntSlicePtr    *[]int
	DurationPtr    *duration.Duration
	TimePtr        *time.Time
}

type RequestOption func(*populateRequestOptions)

type SpreadsheetReader func(r io.Reader) (sheet string, rows [][]string, err error)

type URLFetcher interface {
	// Fetch GETs url. defensive is set for values supplied by remote (RPC)
	// callers, which must be guarded against SSRF.
	Fetch(ctx context.Context, url string, defensive bool) (*http.Response, error)
}