cli

package
v0.1.0 Latest Latest
Warning

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

 Go to latest Published: Jul 10, 2025 License: Apache-2.0 Imports: 45 Imported by: 0

Documentation

Overview

Package cli contains utility for the cli

Package cli contains utility for the cli

Index

Constants

View Source 
const GitHubActionsEndpoint = "ACTIONS_ID_TOKEN_REQUEST_URL"

GitHubActionsEndpoint is the environment variable GitHub uses to signal the endpoint for GitHub Actions OIDC token requests

View Source 
const GitHubActionsTokenEnv = "ACTIONS_ID_TOKEN_REQUEST_TOKEN"

GitHubActionsTokenEnv is the environment variable GitHub uses to authenticate the calls to the GitHubActionsEndpoint

View Source 
const MinderAuthTokenEnvVar = "MINDER_AUTH_TOKEN"

MinderAuthTokenEnvVar is the environment variable for the minder auth token

Variables

View Source 
var (
	// PrimaryColor is the primary color for the cli.
	PrimaryColor = lipgloss.Color("#00BBBE")
	// SecondaryColor is the secondary color for the cli.
	SecondaryColor = lipgloss.Color("#59CFA8")
	// AccentColor is the accent color for the cli.
	AccentColor = lipgloss.Color("#3D34E0")
	// WhiteColor is the white color for the cli.
	WhiteColor = lipgloss.Color("#FFFFFF")
	// BlackColor is the black color for the cli.
	BlackColor = lipgloss.Color("#000000")
)

Color Palette

View Source 
var (
	// DefaultBannerWidth is the default width for a banner
	DefaultBannerWidth = 80
	// Header is the style to use for headers
	Header = lipgloss.NewStyle().
			Bold(true).
			Foreground(PrimaryColor).
			PaddingTop(1).
			PaddingBottom(1).
			PaddingLeft(1).
			PaddingRight(1).
			MaxWidth(80)
	WarningBanner = lipgloss.NewStyle().
					Bold(true).
					Background(BlackColor).
					Foreground(WhiteColor).
					BorderForeground(AccentColor).
					PaddingTop(2).
					PaddingBottom(2).
					PaddingLeft(4).
					PaddingRight(4).
					Width(DefaultBannerWidth)
	// SuccessBanner is the style to use for a success banner
	SuccessBanner = lipgloss.NewStyle().
					Bold(true).
					Background(AccentColor).
					Foreground(WhiteColor).
					PaddingTop(1).
					PaddingBottom(1).
					PaddingLeft(4).
					PaddingRight(4).
					Width(DefaultBannerWidth)
)

Banner styles

View Source 
var (
	CursorStyle = lipgloss.NewStyle().Foreground(SecondaryColor)
)

Common styles

View Source 
var ErrGettingRefreshToken = errors.New("error refreshing credentials")

ErrGettingRefreshToken is an error for when we can't get a refresh token

Functions

func ConcatenateAndWrap 

func ConcatenateAndWrap(input string, maxLen int) string

ConcatenateAndWrap takes a string and a maximum line length (maxLen), then outputs the string as a multiline string where each line does not exceed maxLen characters.

func EnsureCredentials 

func EnsureCredentials(cmd *cobra.Command, _ []string) error

EnsureCredentials is a PreRunE function to ensure that the user has valid credentials, opening a browser for login if needed.

func ExitNicelyOnError 

func ExitNicelyOnError(err error, userMsg string)

ExitNicelyOnError print a message and exit with the right code

func GRPCClientWrapRunE 

func GRPCClientWrapRunE(
	runEFunc func(ctx context.Context, cmd *cobra.Command, args []string, c *grpc.ClientConn) error,
) func(cmd *cobra.Command, args []string) error

GRPCClientWrapRunE is a wrapper for cobra commands that sets up the grpc client and context

func GetAppContext 

func GetAppContext(ctx context.Context, v *viper.Viper) (context.Context, context.CancelFunc)

GetAppContext is a helper for getting the cmd app context

func GetAppContextWithTimeoutDuration 

func GetAppContextWithTimeoutDuration(ctx context.Context, v *viper.Viper, tout int) (context.Context, context.CancelFunc)

GetAppContextWithTimeoutDuration is a helper for getting the cmd app context with a custom timeout

func GetConfigDirPath added in v0.0.84 

func GetConfigDirPath() (string, error)

GetConfigDirPath returns the path to the config directory

func GetGrpcConnection added in v0.0.84 

func GetGrpcConnection(
	cfg clientconfig.GRPCClientConfig,
	issuerUrl string, realm string, clientId string,
	opts ...grpc.DialOption) (
	*grpc.ClientConn, error)

GetGrpcConnection is a helper for getting a testing connection for grpc

func GetNameAndOwnerFromRepository 

func GetNameAndOwnerFromRepository(repository string) (string, string)

GetNameAndOwnerFromRepository returns the owner and name from a repository name in the format owner/name

func GetRealmUrl added in v0.0.86 

func GetRealmUrl(serverAddress string, opts []grpc.DialOption, issuerUrl string, realm string) (string, error)

GetRealmUrl determines the authentication realm URL, preferring to fetch it from the server headers using the minder.v1.UserService.GetUser method (and extracting the realm from the "WWW-Authenticate" header), but falling back to static configuration if that fails.

func GetRepositoryName 

func GetRepositoryName(owner, name string) string

GetRepositoryName returns the repository name in the format owner/name

func GetToken added in v0.0.84 

func GetToken(serverAddress string, opts []grpc.DialOption, issuerUrl string, realm string, clientId string) (string, error)

GetToken retrieves the access token from the credentials file and refreshes it if necessary

func GetTokenFromGitHub added in v0.1.0 

func GetTokenFromGitHub() (string, error)

GetTokenFromGitHub uses the GitHub $ACTIONS_ID_TOKEN_REQUEST_URL to fetch an OIDC token from GitHub which can be used to authenticate to Minder if the machine_accounts flag is enabled.

func GrpcForCommand 

func GrpcForCommand(cmd *cobra.Command, v *viper.Viper) (*grpc.ClientConn, error)

GrpcForCommand is a helper for getting a testing connection from cobra flags

func IsYAMLFileAndNotATest added in v0.0.68 

func IsYAMLFileAndNotATest(path string) bool

IsYAMLFileAndNotATest checks if a file is a YAML file and not a test file

func Login 

func Login(
	ctx context.Context,
	cmd *cobra.Command,
	cfg *clientconfig.Config,
	extraScopes []string,
	skipBroswer bool,
) (*oidc.Tokens[*oidc.IDTokenClaims], error)

Login is a helper function to handle the login process and return the access token

func LoginAndSaveCreds 

func LoginAndSaveCreds(ctx context.Context, cmd *cobra.Command, clientConfig *clientconfig.Config) (string, error)

LoginAndSaveCreds runs a login flow for the user, opening a browser if needed. If the credentials need to be refreshed, the new credentials will be saved for future use.

func MessageAndError 

func MessageAndError(msg string, err error) error

MessageAndError prints a message and returns an error.

func MultiSelect 

func MultiSelect(choices []string) ([]string, error)

MultiSelect implements the necessary logic to implement an interactive multi-select menu for the CLI.

Given a list of string as choices, returns those interactively selected by the user.

func PrintYesNoPrompt 

func PrintYesNoPrompt(cmd *cobra.Command, promptMsg, confirmMsg, fallbackMsg string, defaultYes bool) bool

PrintYesNoPrompt prints a yes/no prompt to the user and returns false if the user did not respond with yes or y

func RemoveCredentials added in v0.0.84 

func RemoveCredentials(serverAddress string) error

RemoveCredentials removes the local credentials file

func RenderMarkdown 

func RenderMarkdown(payload string, opts ...glamour.TermRendererOption) string

RenderMarkdown renders the given string as markdown.

func RevokeOfflineToken added in v0.0.84 

func RevokeOfflineToken(token string, issuerUrl string, realm string, clientId string) error

RevokeOfflineToken revokes the given offline token using OAuth2.0's Token Revocation endpoint from RFC 7009.

func RevokeToken added in v0.0.84 

func RevokeToken(token string, issuerUrl string, realm string, clientId string, tokenHint string) error

RevokeToken revokes the given token using OAuth2.0's Token Revocation endpoint from RFC 7009. The tokenHint is the type of token being revoked, such as "access_token" or "refresh_token". In the case of an offline token, the tokenHint should be "refresh_token".

func SaveCredentials added in v0.0.84 

func SaveCredentials(serverAddress string, tokens OpenIdCredentials) (string, error)

SaveCredentials saves the credentials to a file

func SetProviderConfig 

func SetProviderConfig(
	ctx context.Context,
	provCli minderv1.ProvidersServiceClient,
	project, providerName string,
	serde *ProviderConfigUnion,
) error

SetProviderConfig sets the provider configuration in the minder service

func ValidateRepositoryName 

func ValidateRepositoryName(repository string) error

ValidateRepositoryName checks if a repository name is valid

func WidthFraction added in v0.1.0 

func WidthFraction(fraction float64) glamour.TermRendererOption

WidthFraction sets the width of the markdown text to the fraction of the terminal width (0.0 to 1.0).

Types

type ErrWrappedCLIError 

type ErrWrappedCLIError struct {
	Message string
	Err     error
}

ErrWrappedCLIError is an error that wraps another error and provides a message used from within the CLI

func (*ErrWrappedCLIError) Error 

func (e *ErrWrappedCLIError) Error() string

type JWTTokenCredentials added in v0.0.84 

type JWTTokenCredentials struct {
	// contains filtered or unexported fields
}

JWTTokenCredentials is a helper struct for grpc

func (JWTTokenCredentials) GetRequestMetadata added in v0.0.84 

func (jwt JWTTokenCredentials) GetRequestMetadata(_ context.Context, _ ...string) (map[string]string, error)

GetRequestMetadata implements the PerRPCCredentials interface.

func (JWTTokenCredentials) RequireTransportSecurity added in v0.0.84 

func (JWTTokenCredentials) RequireTransportSecurity() bool

RequireTransportSecurity implements the PerRPCCredentials interface.

type OpenIdCredentials added in v0.0.84 

type OpenIdCredentials struct {
	AccessToken          string    `json:"access_token"`
	RefreshToken         string    `json:"refresh_token"`
	AccessTokenExpiresAt time.Time `json:"expiry"`
}

OpenIdCredentials is a struct to hold the access and refresh tokens

func LoadCredentials added in v0.0.84 

func LoadCredentials(serverAddress string) (OpenIdCredentials, error)

LoadCredentials loads the credentials from a file

func RefreshCredentials added in v0.0.84 

func RefreshCredentials(serverAddress string, refreshToken string, realmUrl string, clientId string) (OpenIdCredentials, error)

RefreshCredentials uses a refresh token to get and save a new set of credentials

type ProviderConfigUnion 

type ProviderConfigUnion struct {
	*minderv1.ProviderConfig
	//nolint:lll
	GitHub *minderv1.GitHubProviderConfig `json:"github,omitempty" yaml:"github" mapstructure:"github" validate:"required"`
	//nolint:lll
	GitHubApp *minderv1.GitHubAppProviderConfig `json:"github_app,omitempty" yaml:"github_app" mapstructure:"github_app" validate:"required"`
}

ProviderConfigUnion is a union type for the different provider configurations this is a temporary kludge until we can autogenerate the possible attributes

func GetProviderConfig 

func GetProviderConfig(
	ctx context.Context,
	provCli minderv1.ProvidersServiceClient,
	project, providerName string,
) (*ProviderConfigUnion, error)

GetProviderConfig retrieves the provider configuration from the minder service

Source Files

View all Source files

Directories

Path Synopsis
Package table contains utilities for rendering tables
 Package table contains utilities for rendering tables
layouts
Package layouts defines the available table layouts
 Package layouts defines the available table layouts
Package types provides normalization types for CLI rendering.
 Package types provides normalization types for CLI rendering.
Package useragent contains utilities for setting up the CLI's user agent
 Package useragent contains utilities for setting up the CLI's user agent

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.