pkg

package
v1.15.0-beta.1 Latest Latest
Warning

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

 Go to latest Published: Oct 10, 2024 License: Apache-2.0 Imports: 24 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	// MembershipURIFlag specifies the URI for membership
	MembershipURIFlag = "membership-uri"
	// FileFlag specifies the configuration file
	FileFlag = "config"
	// ProfileFlag specifies the profile to use
	ProfileFlag = "profile"
	// OutputFlag specifies the output format
	OutputFlag = "output"
	// DebugFlag specifies whether to run the command in debug mode
	DebugFlag = "debug"
	// TelemetryFlag specifies whether to enable telemetry
	TelemetryFlag = "telemetry"
)
View Source 
const AuthClient = "mdz"

AuthClient is the name of the OIDC client.

Variables

View Source 
var (

	// ErrOrganizationNotSpecified indicates that no organization was specified when one was required.
	ErrOrganizationNotSpecified = errors.New("organization not specified")

	// ErrMultipleOrganizationsFound indicates that more than one organization was found when only one was expected, and no specific organization was specified.
	ErrMultipleOrganizationsFound = errors.New("found more than one organization and no organization specified")
)
View Source 
var ErrOpenningBrowser = errors.New("opening browser")

ErrOpenningBrowser is a struct that return an error when opening browser

Functions

func ContainValue 

func ContainValue[V comparable](array []V, value V) bool

ContainValue func that valid if contains value

func GetAuthRelyingParty 

func GetAuthRelyingParty(ctx context.Context, httpClient *http.Client, membershipURI string) (rp.RelyingParty, error)

GetAuthRelyingParty returns a NewRelyingPartyOIDC that creates an (OIDC)

func GetBool 

func GetBool(cmd *cobra.Command, flagName string) bool

GetBool retrieves the boolean value of the specified flag from the command.

func GetCurrentProfileName 

func GetCurrentProfileName(cmd *cobra.Command, config *Config) string

GetCurrentProfileName retrieves the name of the current profile from the given cobra.Command and configuration. If the ProfileFlag is set, it returns the value of the ProfileFlag. Otherwise, it returns the current profile name from the configuration.

func GetDateTime 

func GetDateTime(cmd *cobra.Command, flagName string) (*time.Time, error)

GetDateTime retrieves the time value of the specified flag from the command.

func GetHTTPClient 

func GetHTTPClient(cmd *cobra.Command, defaultHeaders map[string][]string) *http.Client

GetHTTPClient creates and returns a new HTTP client configured based on the provided cobra.Command flags and default headers. It utilizes the NewHTTPClient function, passing in the values of the InsecureTlsFlag and DebugFlag, along with any defaultHeaders specified. This allows for the creation of a customized http.Client instance tailored to the needs of the application, including support for insecure TLS connections and debugging capabilities.

func GetInt 

func GetInt(cmd *cobra.Command, flagName string) int

GetInt retrieves the integer value of the specified flag from the command.

func GetSelectedOrganization 

func GetSelectedOrganization(cmd *cobra.Command) string

GetSelectedOrganization retrieves the selected organization from the command.

func GetSelectedStackID 

func GetSelectedStackID(cmd *cobra.Command) string

GetSelectedStackID retrieves the selected stack ID from the command.

func GetString 

func GetString(cmd *cobra.Command, flagName string) string

GetString retrieves the string value of the specified flag from the command.

func GetStringSlice 

func GetStringSlice(cmd *cobra.Command, flagName string) []string

GetStringSlice retrieves the string slice value of the specified flag from the command.

func IsInvalidAuthentication 

func IsInvalidAuthentication(err error) bool

IsInvalidAuthentication checks if the provided error is an instance of ErrInvalidAuthentication.

func ListProfiles 

func ListProfiles(cmd *cobra.Command, toComplete string) ([]string, error)

ListProfiles generates a list of profiles based on the toComplete string.

Parameters: 

cmd: *cobra.Command - the command object
toComplete: string - the string to complete

Return type: 

[]string: list of profile strings
error: any error that occurred

func Map 

func Map[SRC, DST any](srcs []SRC, mapper func(SRC) DST) []DST

Map func that appends slices

func MapKeys 

func MapKeys[K comparable, V any](m map[K]V) []K

MapKeys func that compare and appends slices

func MapMap 

func MapMap[KEY comparable, VALUE, DST any](srcs map[KEY]VALUE, mapper func(KEY, VALUE) DST) []DST

MapMap func that compare and appends slices

func NewCommand 

func NewCommand(use string, opts ...CommandOption) *cobra.Command

NewCommand creates a new cobra command with the specified use string and options.

Parameters: - use: a string representing the use of the command. - opts: variadic CommandOption options. Return type: - *cobra.Command: a pointer to the created cobra command.

func NewHTTPClient 

func NewHTTPClient(debug bool, defaultHeaders map[string][]string) *http.Client

NewHTTPClient initializes and returns a new http.Client with customizable behavior. It allows for the configuration of TLS insecurity (skipping TLS verification), enabling a debug mode for additional logging, and setting default headers for all requests.

Parameters:

  • insecureTLS: If true, the client will accept any TLS certificate presented by the server and any host name in that certificate. This is useful for testing with self-signed certificates.
  • debug: If true, wraps the transport in a debugging layer that logs all requests and responses. This is helpful for development and troubleshooting.
  • defaultHeaders: A map of header names to their values which will be added to every request made by this client. Useful for setting headers like `Authorization` or `User-Agent` that should be included in all requests.

Returns: - A pointer to an initialized http.Client configured as specified.

func NewMembershipCommand 

func NewMembershipCommand(use string, opts ...CommandOption) *cobra.Command

NewMembershipCommand is a helper function that returns a new membership command with the given options.

func NewStackCommand 

func NewStackCommand(use string, opts ...CommandOption) *cobra.Command

NewStackCommand is a helper function that returns a new stack command with the given options.

func Prepend 

func Prepend[V any](array []V, items ...V) []V

Prepend func that return two append items

func Ptr 

func Ptr[T any](t T) *T

Ptr returns a pointer to the given value.

func RetrieveOrganizationIDFromFlagOrProfile 

func RetrieveOrganizationIDFromFlagOrProfile(cmd *cobra.Command, cfg *Config) (string, error)

RetrieveOrganizationIDFromFlagOrProfile retrieves the organization ID from the command flag or profile.

func WithRender 

func WithRender[T any](cmd *cobra.Command, args []string, controller Controller[T], renderable Renderable) error

WithRender handles the rendering of the output based on the output flag.

Types

type CommandOption 

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

CommandOption is an interface for options that can be applied to a cobra.Command.

type CommandOptionFn 

type CommandOptionFn func(cmd *cobra.Command)

CommandOptionFn is a function that applies a CommandOption to a cobra.Command.

func WithAliases 

func WithAliases(aliases ...string) CommandOptionFn

WithAliases is a helper function that returns a CommandOptionFn that applies aliases to a cobra.Command.

func WithArgs 

func WithArgs(p cobra.PositionalArgs) CommandOptionFn

WithArgs is a helper function that returns a CommandOptionFn that applies positional arguments to a cobra.Command.

func WithBoolFlag 

func WithBoolFlag(name string, defaultValue bool, help string) CommandOptionFn

WithBoolFlag is a helper function that returns a CommandOptionFn that applies a boolean flag to a cobra.Command.

func WithChildCommands 

func WithChildCommands(cmds ...*cobra.Command) CommandOptionFn

WithChildCommands is a helper function that returns a CommandOptionFn that applies child commands to a cobra.Command.

func WithController 

func WithController[T any](c Controller[T]) CommandOptionFn

WithController wraps a controller's Run method as a cobra command's RunE function.

func WithDeprecated 

func WithDeprecated(message string) CommandOptionFn

WithDeprecated is a helper function that returns a CommandOptionFn that applies a deprecated flag to a cobra.Command.

func WithDeprecatedFlag 

func WithDeprecatedFlag(name, message string) CommandOptionFn

WithDeprecatedFlag is a helper function that returns a CommandOptionFn that applies a deprecated flag to a cobra.Command.

func WithDescription 

func WithDescription(v string) CommandOptionFn

WithDescription is a helper function that returns a CommandOptionFn that applies a description to a cobra.Command.

func WithHidden 

func WithHidden() CommandOptionFn

WithHidden is a helper function that returns a CommandOptionFn that applies a hidden flag to a cobra.Command.

func WithHiddenFlag 

func WithHiddenFlag(name string) CommandOptionFn

WithHiddenFlag is a helper function that returns a CommandOptionFn that applies a hidden flag to a cobra.Command.

func WithIntFlag 

func WithIntFlag(name string, defaultValue int, help string) CommandOptionFn

WithIntFlag is a helper function that returns a CommandOptionFn that applies an integer flag to a cobra.Command.

func WithPersistentBoolFlag 

func WithPersistentBoolFlag(name string, defaultValue bool, help string) CommandOptionFn

WithPersistentBoolFlag is a helper function that returns a CommandOptionFn that applies a persistent boolean flag to a cobra.Command.

func WithPersistentBoolPFlag 

func WithPersistentBoolPFlag(name, short string, defaultValue bool, help string) CommandOptionFn

WithPersistentBoolPFlag is a helper function that returns a CommandOptionFn that applies a persistent boolean flag to a cobra.Command.

func WithPersistentPreRunE 

func WithPersistentPreRunE(fn func(cmd *cobra.Command, args []string) error) CommandOptionFn

WithPersistentPreRunE is a helper function that returns a CommandOptionFn that applies a persistent pre-run function to a cobra.Command.

func WithPersistentStringFlag 

func WithPersistentStringFlag(name, defaultValue, help string) CommandOptionFn

WithPersistentStringFlag is a helper function that returns a CommandOptionFn that applies a persistent string flag to a cobra.Command.

func WithPersistentStringPFlag 

func WithPersistentStringPFlag(name, short, defaultValue, help string) CommandOptionFn

WithPersistentStringPFlag is a helper function that returns a CommandOptionFn that applies a persistent string flag to a cobra.Command.

func WithPreRunE 

func WithPreRunE(fn func(cmd *cobra.Command, args []string) error) CommandOptionFn

WithPreRunE is a helper function that returns a CommandOptionFn that applies a pre-run function to a cobra.Command.

func WithRunE 

func WithRunE(fn func(cmd *cobra.Command, args []string) error) CommandOptionFn

WithRunE is a helper function that returns a CommandOptionFn that applies a run function to a cobra.Command.

func WithShortDescription 

func WithShortDescription(v string) CommandOptionFn

WithShortDescription is a helper function that returns a CommandOptionFn that applies a short description to a cobra.Command.

func WithSilenceError 

func WithSilenceError() CommandOptionFn

WithSilenceError is a helper function that returns a CommandOptionFn that applies silence error to a cobra.Command.

func WithSilenceUsage 

func WithSilenceUsage() CommandOptionFn

WithSilenceUsage is a helper function that returns a CommandOptionFn that applies silence usage to a cobra.Command.

func WithStringArrayFlag 

func WithStringArrayFlag(name string, defaultValue []string, help string) CommandOptionFn

WithStringArrayFlag is a helper function that returns a CommandOptionFn that applies a string array flag to a cobra.Command.

func WithStringFlag 

func WithStringFlag(name, defaultValue, help string) CommandOptionFn

WithStringFlag is a helper function that returns a CommandOptionFn that applies a string flag to a cobra.Command.

func WithStringSliceFlag 

func WithStringSliceFlag(name string, defaultValue []string, help string) CommandOptionFn

WithStringSliceFlag is a helper function that returns a CommandOptionFn that applies a string slice flag to a cobra.Command.

func WithValidArgs 

func WithValidArgs(validArgs ...string) CommandOptionFn

WithValidArgs is a helper function that returns a CommandOptionFn that applies valid arguments to a cobra.Command.

func WithValidArgsFunction 

func WithValidArgsFunction(fn func(cmd *cobra.Command, args []string, toComplete string) ([]string, cobra.ShellCompDirective)) CommandOptionFn

WithValidArgsFunction returns a CommandOptionFn that sets a custom validation function for command arguments.

type Config 

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

Config represents the configuration for the application. It encapsulates details such as the current profile in use, a unique identifier for the configuration, a map of profile names to Profile instances, and a reference to the ConfigManager responsible for managing this configuration.

func GetConfig 

func GetConfig(cmd *cobra.Command) (*Config, error)

GetConfig retrieves the configuration from the file system. It uses the ConfigManager to load the configuration from the file system.

func (*Config) DeleteProfile 

func (c *Config) DeleteProfile(s string) error

DeleteProfile removes a profile from the configuration by name. If the profile does not exist, it returns an error.

func (*Config) GetCurrentProfileName 

func (c *Config) GetCurrentProfileName() string

GetCurrentProfileName retrieves the name of the current profile from the configuration.

func (*Config) GetProfile 

func (c *Config) GetProfile(name string) *Profile

GetProfile retrieves a profile by name from the configuration. If the profile does not exist, it returns nil.

func (*Config) GetProfileOrDefault 

func (c *Config) GetProfileOrDefault(name, membershipURI string) *Profile

GetProfileOrDefault retrieves a profile by name from the configuration. If the profile does not exist, it creates a new profile with the given membership URI and returns it.

func (*Config) GetProfiles 

func (c *Config) GetProfiles() map[string]*Profile

GetProfiles retrieves the map of profile names to Profile instances from the configuration.

func (*Config) GetUniqueID 

func (c *Config) GetUniqueID() string

GetUniqueID retrieves the unique identifier for the configuration.

func (*Config) MarshalJSON 

func (c *Config) MarshalJSON() ([]byte, error)

MarshalJSON implements the json.Marshaler interface for Config. It converts the Config instance into a JSON-encoded byte slice.

func (*Config) Persist 

func (c *Config) Persist() error

Persist saves the configuration to the file system. It uses the ConfigManager to update the configuration file with the current configuration.

func (*Config) SetCurrentProfile 

func (c *Config) SetCurrentProfile(name string, profile *Profile)

SetCurrentProfile sets the current profile to the given name and profile. It also updates the current profile name to the given name.

func (*Config) SetCurrentProfileName 

func (c *Config) SetCurrentProfileName(s string)

SetCurrentProfileName sets the name of the current profile to the given string.

func (*Config) SetProfile 

func (c *Config) SetProfile(name string, profile *Profile)

SetProfile sets the profile with the given name to the given profile.

func (*Config) SetUniqueID 

func (c *Config) SetUniqueID(id string)

SetUniqueID sets the unique identifier for the configuration.

func (*Config) UnmarshalJSON 

func (c *Config) UnmarshalJSON(data []byte) error

UnmarshalJSON implements the json.Unmarshaler interface for Config. It populates the Config instance with data from a JSON-encoded byte slice.

type ConfigManager 

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

ConfigManager is a struct that use a string configFilePath

func GetConfigManager 

func GetConfigManager(cmd *cobra.Command) *ConfigManager

GetConfigManager retrieves the ConfigManager instance associated with the given cobra.Command. It uses the FileFlag to determine the configuration file path and returns a new ConfigManager instance.

func NewConfigManager 

func NewConfigManager(configFilePath string) *ConfigManager

NewConfigManager is a func that return a struc of *ConfigManager

func (*ConfigManager) Load 

func (m *ConfigManager) Load() (*Config, error)

Load is a func that load a filepath and return a *Config of application

func (*ConfigManager) UpdateConfig 

func (m *ConfigManager) UpdateConfig(config *Config) error

UpdateConfig is a func that update a *Config of application

type Controller 

type Controller[T any] interface {
	GetStore() T
	Run(cmd *cobra.Command, args []string) (Renderable, error)
}

Controller is a generic interface that defines the structure of a controller capable of handling commands. It requires two methods:

  • GetStore, which returns a store of type T.
  • Run, which takes a cobra.Command and a slice of strings (arguments), and returns a Renderable and an error. This method is responsible for executing the command's logic.

type CurrentProfile 

type CurrentProfile Profile

CurrentProfile profile

type ErrInvalidAuthentication 

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

ErrInvalidAuthentication is an error that occurs when the authentication token is invalid.

func (ErrInvalidAuthentication) Error 

func (e ErrInvalidAuthentication) Error() string

Error returns the error message for ErrInvalidAuthentication.

No parameters. Returns a string.

func (ErrInvalidAuthentication) Is 

func (e ErrInvalidAuthentication) Is(err error) bool

Is checks if the provided error is of type ErrInvalidAuthentication.

func (ErrInvalidAuthentication) Unwrap 

func (e ErrInvalidAuthentication) Unwrap() error

Unwrap returns the underlying error of ErrInvalidAuthentication.

No parameters. Returns an error.

type ExportedData 

type ExportedData struct {
	Data any `json:"data"`
}

ExportedData represents a generic structure for data that can be exported. It contains a single field, Data, which can hold any type of value. The field is tagged with `json:"data"` to specify its JSON key when serialized.

type Profile 

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

Profile represents a user profile.

func GetCurrentProfile 

func GetCurrentProfile(cmd *cobra.Command, cfg *Config) *Profile

GetCurrentProfile retrieves the current profile from the given cobra.Command and configuration. It returns the current profile from the configuration. If the current profile does not exist, it creates a new profile with the default membership URI and returns it.

func (*Profile) GetClaims 

func (p *Profile) GetClaims() (jwt.MapClaims, error)

GetClaims returns the jwt claims and an error.

No parameters. Returns jwt.MapClaims and error.

func (*Profile) GetDefaultOrganization 

func (p *Profile) GetDefaultOrganization() string

GetDefaultOrganization returns the default organization for the Profile.

No parameters. Returns a string.

func (*Profile) GetMembershipURI 

func (p *Profile) GetMembershipURI() string

GetMembershipURI returns the membership URI of the Profile.

No parameters. Returns a string.

func (*Profile) GetToken 

func (p *Profile) GetToken(ctx context.Context, httpClient *http.Client) (*oauth2.Token, error)

GetToken retrieves and refreshes the OAuth2 token if needed.

Parameters:

  • ctx: the context for the HTTP request
  • httpClient: the HTTP client to use for making HTTP requests

Returns:

  • *oauth2.Token: the OAuth2 token retrieved or refreshed
  • error: an error if any occurred during the token retrieval or refresh

func (*Profile) IsConnected 

func (p *Profile) IsConnected() bool

IsConnected is connected

func (*Profile) MarshalJSON 

func (p *Profile) MarshalJSON() ([]byte, error)

MarshalJSON generates the JSON encoding for the Profile struct.

No parameters. Returns a byte slice and an error.

func (*Profile) SetDefaultOrganization 

func (p *Profile) SetDefaultOrganization(o string)

SetDefaultOrganization sets the default organization

func (*Profile) SetMembershipURI 

func (p *Profile) SetMembershipURI(v string)

SetMembershipURI sets the membership URI for the Profile.

Takes a string parameter.

func (*Profile) UnmarshalJSON 

func (p *Profile) UnmarshalJSON(data []byte) error

UnmarshalJSON parses the JSON-encoded data and stores the result in the Profile struct.

It takes a byte slice data as a parameter. Returns an error.

func (*Profile) UpdateToken 

func (p *Profile) UpdateToken(token *oidc.AccessTokenResponse)

UpdateToken updates the token for the Profile.

token *oidc.AccessTokenResponse - The new access token to be set.

type Renderable 

type Renderable interface {
	Render(cmd *cobra.Command, args []string) error
}

Renderable defines an interface for objects that can render themselves. It requires implementing the Render method, which takes a cobra.Command and a slice of strings (arguments) and returns an error.

type RoundTripperFn 

type RoundTripperFn func(req *http.Request) (*http.Response, error)

RoundTripperFn is a function type that implements the http.RoundTripper interface. It allows any function with the appropriate signature to be used as an http.RoundTripper. This is useful for creating custom transport behaviors in an http.Client.

func (RoundTripperFn) RoundTrip 

func (fn RoundTripperFn) RoundTrip(req *http.Request) (*http.Response, error)

RoundTrip executes the RoundTripperFn function, effectively making RoundTripperFn an http.RoundTripper. This method allows RoundTripperFn to satisfy the http.RoundTripper interface, enabling its use as a custom transport mechanism within an http.Client.

Source Files

View all Source files

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.