Documentation ¶
Overview ¶
Package flag implements flag-related functionality.
Index ¶
- Constants
- Variables
- func Add(cmd *cobra.Command, flags ...Flag)
- func Args(ctx context.Context) []string
- func ExtraArgsFromContext(ctx context.Context) []string
- func FirstArg(ctx context.Context) string
- func FromContext(ctx context.Context) *pflag.FlagSet
- func GetApp(ctx context.Context) string
- func GetAppConfigFilePath(ctx context.Context) string
- func GetBindAddr(ctx context.Context) string
- func GetBool(ctx context.Context, name string) bool
- func GetBuildOnly(ctx context.Context) bool
- func GetDetach(ctx context.Context) bool
- func GetDuration(ctx context.Context, name string) time.Duration
- func GetFlagsName(ctx context.Context, ignoreFlags []string) []string
- func GetFloat64(ctx context.Context, name string) float64
- func GetInt(ctx context.Context, name string) int
- func GetLocalOnly(ctx context.Context) bool
- func GetMachineGuest(ctx context.Context, guest *fly.MachineGuest) (*fly.MachineGuest, error)
- func GetOrg(ctx context.Context) string
- func GetProcessGroup(ctx context.Context) string
- func GetRegion(ctx context.Context) string
- func GetRemoteOnly(ctx context.Context) bool
- func GetString(ctx context.Context, name string) string
- func GetStringArray(ctx context.Context, name string) []string
- func GetStringSlice(ctx context.Context, name string) []string
- func GetWireguard(ctx context.Context) bool
- func GetYes(ctx context.Context) bool
- func IsSpecified(ctx context.Context, name string) bool
- func NewContext(ctx context.Context, fs *pflag.FlagSet) context.Context
- func SetString(ctx context.Context, name, value string) error
- func WithExtraArgs(ctx context.Context, extraArgs []string) context.Context
- type Bool
- type Duration
- type Flag
- type Float64
- type Int
- type Set
- type String
- func App() String
- func AppConfig() String
- func BpDockerHost() String
- func BuildTarget() String
- func Dockerfile() String
- func Ignorefile() String
- func Image() String
- func ImageLabel() String
- func Org() String
- func ProcessGroup(desc string) String
- func Region() String
- func ReplicaRegions() String
- func Strategy() String
- type StringArray
- type StringSlice
Constants ¶
const BuildpacksDockerHost = "buildpacks-docker-host"
BuildpacksDockerHost address to docker daemon that will be exposed to the buildpacks build container
const BuildpacksVolume = "buildpacks-volume"
BuildpacksVolume the host volume that will be mounted to the buildpacks build container
Variables ¶
var VMSizeFlags = Set{ String{ Name: "vm-size", Description: `The VM size to set machines to. See "fly platform vm-sizes" for valid values`, }, Int{ Name: "vm-cpus", Description: "Number of CPUs", Aliases: []string{"cpus"}, }, String{ Name: "vm-cpu-kind", Description: "The kind of CPU to use ('shared' or 'performance')", Aliases: []string{"vm-cpukind"}, }, String{ Name: "vm-memory", Description: "Memory (in megabytes) to attribute to the VM", Aliases: []string{"memory"}, }, Int{ Name: "vm-gpus", Description: "Number of GPUs. Must also choose the GPU model with --vm-gpu-kind flag", }, String{ Name: "vm-gpu-kind", Description: fmt.Sprintf("If set, the GPU model to attach (%v)", strings.Join(validGPUKinds, ", ")), Aliases: []string{"vm-gpukind"}, }, String{ Name: "host-dedication-id", Description: "The dedication id of the reserved hosts for your organization (if any)", }, }
Functions ¶
func ExtraArgsFromContext ¶ added in v0.2.32
ExtraArgsFromContext returns the extraArgs ctx carries.
func FirstArg ¶
FirstArg returns the first arg ctx carries or an empty string in case ctx carries an empty argument set. It panics in case ctx carries no FlagSet.
func FromContext ¶
FromContext returns the FlagSet ctx carries. It panics in case ctx carries no FlagSet.
func GetAppConfigFilePath ¶
GetAppConfigFilePath is shorthand for GetString(ctx, AppConfigFilePath).
func GetBindAddr ¶ added in v0.1.59
GetBindAddr is shorthand for GetString(ctx, BindAddr).
func GetBuildOnly ¶
func GetDuration ¶ added in v0.0.500
GetDuration returns the value of the named duration flag ctx carries.
func GetFlagsName ¶ added in v0.1.1
GetFlagsName returns the name of flags that have been set except unwanted flags.
func GetFloat64 ¶ added in v0.1.75
GetFloat64 returns the value of the named int flag ctx carries. It panics in case ctx carries no flags or in case the named flag isn't a float64 one.
func GetInt ¶
GetInt returns the value of the named int flag ctx carries. It panics in case ctx carries no flags or in case the named flag isn't an int one.
func GetLocalOnly ¶
func GetMachineGuest ¶ added in v0.1.86
func GetMachineGuest(ctx context.Context, guest *fly.MachineGuest) (*fly.MachineGuest, error)
Returns a MachineGuest based on the flags provided overwriting a default VM
func GetProcessGroup ¶ added in v0.1.86
func GetRemoteOnly ¶
func GetStringArray ¶ added in v0.1.1
GetStringArray returns the values of the named string flag ctx carries. Preserves commas (unlike the following `GetStringSlice`): in `--flag x,y` the value is string[]{`x,y`}. This is useful to pass key-value pairs like environment variables or build arguments.
func GetStringSlice ¶
GetStringSlice returns the values of the named string flag ctx carries. Can be comma separated or passed "by repeated flags": `--flag x,y` is equivalent to `--flag x --flag y`.
func GetWireguard ¶ added in v0.2.12
func IsSpecified ¶ added in v0.0.475
IsSpecified returns whether a flag has been specified at all or not. This is useful, for example, when differentiating between 0/"" and unspecified.
func NewContext ¶
NewContext derives a context that carries fs from ctx.
Types ¶
type Bool ¶
type Bool struct { Name string Shorthand string Description string Default bool Hidden bool Aliases []string }
Bool wraps the set of boolean flags.
func BuildOnly ¶
func BuildOnly() Bool
BuildOnly returns a boolean flag for building without a deployment
func GenerateName ¶
func GenerateName() Bool
GenerateName returns a boolean flag for generating an application name
func JSONOutput ¶ added in v0.0.519
func JSONOutput() Bool
func Push ¶ added in v0.0.311
func Push() Bool
Push returns a boolean flag to force pushing a build image to the registry
func RemoteOnly ¶
RemoteOnly returns a boolean flag for deploying remotely
type Duration ¶ added in v0.0.500
type Duration struct { Name string Shorthand string Description string Default time.Duration ConfName string EnvName string Hidden bool Aliases []string }
Duration wraps the set of duration flags.
type Flag ¶
type Flag interface {
// contains filtered or unexported methods
}
Flag wraps the set of flags.
type Float64 ¶ added in v0.1.75
type Float64 struct { Name string Shorthand string Description string Default float64 Hidden bool Aliases []string }
Int wraps the set of int flags.
type Int ¶
type Int struct { Name string Shorthand string Description string Default int Hidden bool Aliases []string }
Int wraps the set of int flags.
type String ¶
type String struct { Name string Shorthand string Description string Default string ConfName string EnvName string Hidden bool Aliases []string CompletionFn func(ctx context.Context, cmd *cobra.Command, args []string, partial string) ([]string, error) }
String wraps the set of string flags.
func BpDockerHost ¶ added in v0.1.135
func BpDockerHost() String
func BuildTarget ¶ added in v0.0.337
func BuildTarget() String
func Dockerfile ¶ added in v0.0.335
func Dockerfile() String
func Ignorefile ¶ added in v0.0.433
func Ignorefile() String
func ImageLabel ¶ added in v0.0.337
func ImageLabel() String
func ProcessGroup ¶ added in v0.1.86
func ReplicaRegions ¶ added in v0.1.70
func ReplicaRegions() String
type StringArray ¶ added in v0.1.1
type StringArray struct { Name string Shorthand string Description string Default []string ConfName string EnvName string Hidden bool Aliases []string }
StringArray wraps the set of string array flags.
func BuildArg ¶ added in v0.0.337
func BuildArg() StringArray
func BuildSecret ¶ added in v0.0.337
func BuildSecret() StringArray