cmdutil

Documentation

Index

• Constants
• func CheckAuthentication(cfg *config.Config) func(cmd *cobra.Command, args []string) error
• func DeployRequestBranchToNumber(ctx context.Context, client *ps.Client, organization string, database string, ...) (uint64, error)
• func ErrCode(err error) planetscale.ErrorCode
• func HandleError(err error) error
• func HasHomebrew() bool
• func IsUnderHomebrew(binpath string) bool
• func MySQLClientPath() (string, mysql.AuthMethodDescription, error)
• func NewZapLogger(debug bool) *zap.Logger
• func OpenBrowser(goos, url string) *exec.Cmd
• func ParseSSLMode(sslMode string) ps.ExternalDataSourceSSLVerificationMode
• func RequiredArgs(reqArgs ...string) cobra.PositionalArgs
• func TimeToMilliseconds(t time.Time) int64
• func ToClusterSizeSlug(c ps.ClusterSize) string
• type Error
  • func (e *Error) Error() string
• type Helper
  • func (h *Helper) Debug() bool
  • func (h *Helper) SetDebug(debug *bool)
• type PasswordRole
  • func RoleFromString(r string) (PasswordRole, error)
  • func (r PasswordRole) ToString() string

Constants

const (
	ActionRequestedExitCode = 1
	FatalErrExitCode        = 2
)

const ApplicationURL = "https://app.planetscale.com"

const WarnAuthMessage = "not authenticated yet. Please run 'pscale auth login'"

Functions

func CheckAuthentication

func CheckAuthentication(cfg *config.Config) func(cmd *cobra.Command, args []string) error

CheckAuthentication checks whether the user is authenticated and returns a actionable error message.

func DeployRequestBranchToNumber

func DeployRequestBranchToNumber(ctx context.Context, client *ps.Client, organization string, database string, branch string, state string) (uint64, error)

func ErrCode

func ErrCode(err error) planetscale.ErrorCode

ErrCode returns the code from a *planetscale.Error, if available. If the error is not of type *planetscale.Error or is nil, it returns an empty, undefined error code.

func HandleError

func HandleError(err error) error

HandleError checks whether the given err is an *planetscale.Error and returns a descriptive, human readable error if the error code matches a certain planetscale Error types. If the error doesn't match these requirements, err is returned unmodified.

func HasHomebrew

func HasHomebrew() bool

HasHomebrew check whether the user has installed brew

func IsUnderHomebrew

func IsUnderHomebrew(binpath string) bool

IsUnderHomebrew checks whether the given binary is under the homebrew path. copied from: https://github.com/cli/cli/blob/trunk/cmd/gh/main.go#L298

func MySQLClientPath

func MySQLClientPath() (string, mysql.AuthMethodDescription, error)

MySQLClientPath checks whether the 'mysql' client exists and returns the path to the binary. The returned error contains instructions to install the client.

func NewZapLogger

func NewZapLogger(debug bool) *zap.Logger

NewZapLogger returns a logger to be used with the sql-proxy. By default it only outputs error leveled messages, unless debug is true.

func OpenBrowser

func OpenBrowser(goos, url string) *exec.Cmd

OpenBrowser opens a web browser at the specified url.

func ParseSSLMode

func ParseSSLMode(sslMode string) ps.ExternalDataSourceSSLVerificationMode

func RequiredArgs

func RequiredArgs(reqArgs ...string) cobra.PositionalArgs

required arguments are not available.

func TimeToMilliseconds

func TimeToMilliseconds(t time.Time) int64

func ToClusterSizeSlug

func ToClusterSizeSlug(c ps.ClusterSize) string

Types

type Error

type Error struct {
	Msg string
	// Status
	ExitCode int
}

Error can be used by a command to change the exit status of the CLI.

func (*Error) Error

func (e *Error) Error() string

type Helper

type Helper struct {
	// Config contains globally sourced configuration
	Config *config.Config

	ConfigFS *config.ConfigFS

	// Client returns the PlanetScale API client
	Client func() (*ps.Client, error)

	// Printer is used to print output of a command to stdout.
	Printer *printer.Printer
	// contains filtered or unexported fields
}

Helper is passed to every single command and is used by individual subcommands.

func (*Helper) Debug

func (h *Helper) Debug() bool

func (*Helper) SetDebug

func (h *Helper) SetDebug(debug *bool)

type PasswordRole

type PasswordRole int

const (
	ReaderRole PasswordRole = iota
	WriterRole
	ReadWriterRole
	AdministratorRole
)

func RoleFromString

func RoleFromString(r string) (PasswordRole, error)

func (PasswordRole) ToString

func (r PasswordRole) ToString() string