flag

Documentation

Overview

Package flag implements flag-related functionality.

Index

• Constants
• func Add(cmd *cobra.Command, flags ...Flag)
• func Args(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 GetBool(ctx context.Context, name string) bool
• func GetBuildOnly(ctx context.Context) bool
• func GetDetach(ctx context.Context) bool
• func GetInt(ctx context.Context, name string) int
• func GetLocalOnly(ctx context.Context) bool
• func GetOrg(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 GetStringSlice(ctx context.Context, name string) []string
• func GetYes(ctx context.Context) bool
• func IsSpecified(ctx context.Context, name string) bool
• func NewContext(ctx context.Context, fs *pflag.FlagSet) context.Context
• type Bool
  • func BuildOnly() Bool
  • func Detach() Bool
  • func GenerateName() Bool
  • func LocalOnly() Bool
  • func Nixpacks() Bool
  • func NoCache() Bool
  • func NoDeploy() Bool
  • func Now() Bool
  • func Push() Bool
  • func RemoteOnly(defaultValue bool) Bool
  • func Yes() Bool
• type Flag
• type Int
• type Set
• type String
  • func App() String
  • func AppConfig() String
  • func BuildTarget() String
  • func Dockerfile() String
  • func Ignorefile() String
  • func Image() String
  • func ImageLabel() String
  • func Org() String
  • func Region() String
  • func Strategy() String
• type StringSlice
  • func BuildArg() StringSlice
  • func BuildSecret() StringSlice

Constants

const (
	// AccessTokenName denotes the name of the access token flag.
	AccessTokenName = "access-token"

	// VerboseName denotes the name of the verbose flag.
	VerboseName = "verbose"

	// JSONOutputName denotes the name of the json output flag.
	JSONOutputName = "json"

	// LocalOnlyName denotes the name of the local-only flag.
	LocalOnlyName = "local-only"

	// OrgName denotes the name of the org flag.
	OrgName = "org"

	// RegionName denotes the name of the region flag.
	RegionName = "region"

	// YesName denotes the name of the yes flag.
	YesName = "yes"

	// AppName denotes the name of the app flag.
	AppName = "app"

	// AppConfigFilePathName denotes the name of the app config file path flag.
	AppConfigFilePathName = "config"

	// ImageName denotes the name of the image flag.
	ImageName = "image"

	// NowName denotes the name of the now flag.
	NowName = "now"

	// NoDeploy denotes the name of the no deploy flag.
	NoDeployName = "no-deploy"

	// GenerateName denotes the name of the generate name flag.
	GenerateNameFlagName = "generate-name"

	// DetachName denotes the name of the detach flag.
	DetachName = "detach"
)

Functions

func Add

func Add(cmd *cobra.Command, flags ...Flag)

Add adds flag to cmd, binding them on v should v not be nil.

func Args

func Args(ctx context.Context) []string

Args is shorthand for FromContext(ctx).Args().

func FirstArg

func FirstArg(ctx context.Context) string

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

func FromContext(ctx context.Context) *pflag.FlagSet

FromContext returns the FlagSet ctx carries. It panics in case ctx carries no FlagSet.

func GetApp

func GetApp(ctx context.Context) string

GetApp is shorthand for GetString(ctx, AppName).

func GetAppConfigFilePath

func GetAppConfigFilePath(ctx context.Context) string

GetAppConfigFilePath is shorthand for GetString(ctx, AppConfigFilePathName).

func GetBool

func GetBool(ctx context.Context, name string) bool

GetBool returns the value of the named boolean flag ctx carries.

func GetBuildOnly

func GetBuildOnly(ctx context.Context) bool

func GetDetach

func GetDetach(ctx context.Context) bool

func GetInt

func GetInt(ctx context.Context, name string) int

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 GetLocalOnly(ctx context.Context) bool

func GetOrg

func GetOrg(ctx context.Context) string

GetOrg is shorthand for GetString(ctx, OrgName).

func GetRegion

func GetRegion(ctx context.Context) string

GetRegion is shorthand for GetString(ctx, RegionName).

func GetRemoteOnly

func GetRemoteOnly(ctx context.Context) bool

func GetString

func GetString(ctx context.Context, name string) string

GetString returns the value of the named string flag ctx carries.

func GetStringSlice

func GetStringSlice(ctx context.Context, name string) []string

GetString returns the value of the named string flag ctx carries.

func GetYes

func GetYes(ctx context.Context) bool

GetYes is shorthand for GetBool(ctx, YesName).

func IsSpecified

func IsSpecified(ctx context.Context, name string) bool

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

func NewContext(ctx context.Context, fs *pflag.FlagSet) context.Context

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
}

Bool wraps the set of boolean flags.

func BuildOnly

func BuildOnly() Bool

BuildOnly returns a boolean flag for building without a deployment

func Detach

func Detach() Bool

Detach returns a boolean flag for detaching during deployment

func GenerateName

func GenerateName() Bool

GenerateName returns a boolean flag for generating an application name

func LocalOnly

func LocalOnly() Bool

RemoteOnly returns a boolean flag for deploying remotely

func Nixpacks

func Nixpacks() Bool

func NoCache

func NoCache() Bool

func NoDeploy

func NoDeploy() Bool

func Now

func Now() Bool

Now returns a boolean flag for deploying immediately

func Push

func Push() Bool

Push returns a boolean flag to force pushing a build image to the registry

func RemoteOnly

func RemoteOnly(defaultValue bool) Bool

RemoteOnly returns a boolean flag for deploying remotely

func Yes

func Yes() Bool

Yes returns a yes bool flag.

type Flag

type Flag interface {
	// contains filtered or unexported methods
}

Flag wraps the set of flags.

type Int

type Int struct {
	Name        string
	Shorthand   string
	Description string
	Default     int
	Hidden      bool
}

Int wraps the set of int flags.

type Set

type Set []Flag

type String

type String struct {
	Name        string
	Shorthand   string
	Description string
	Default     string
	ConfName    string
	EnvName     string
	Hidden      bool
}

String wraps the set of string flags.

func App

func App() String

App returns an app string flag.

func AppConfig

func AppConfig() String

AppConfig returns an app config string flag.

func BuildTarget

func BuildTarget() String

func Dockerfile

func Dockerfile() String

func Ignorefile

func Ignorefile() String

func Image

func Image() String

Image returns a Docker image config string flag.

func ImageLabel

func ImageLabel() String

func Org

func Org() String

Org returns an org string flag.

func Region

func Region() String

Region returns a region string flag.

func Strategy

func Strategy() String

type StringSlice

type StringSlice struct {
	Name        string
	Shorthand   string
	Description string
	Default     []string
	ConfName    string
	EnvName     string
	Hidden      bool
}

StringSlice wraps the set of string slice flags.

func BuildArg

func BuildArg() StringSlice

func BuildSecret

func BuildSecret() StringSlice