datum

Documentation

Overview

Package datum is our cobra/viper cli implementation

Index

• Variables
• func Execute()
• func GetInviteStatusEnum(status string) (enums.InviteStatus, error)
• func GetKeyring() (keyring.Keyring, error)
• func GetRoleEnum(role string) (enums.Role, error)
• func GetTokenFromKeyring(ctx context.Context) (*oauth2.Token, string, error)
• func JSONPrint(s []byte) error
• func StoreSession(session string) error
• func StoreSessionCookies(client *datumclient.Client)
• func StoreToken(token *oauth2.Token) error
• func ViperBindFlag(name string, flag *pflag.Flag)
• type CLI
  • func GetGraphClient(ctx context.Context) (*CLI, error)
  • func GetRestClient(ctx context.Context) (*CLI, error)
• type RequiredFieldMissingError
  • func NewRequiredFieldMissingError(f string) *RequiredFieldMissingError
  • func (e *RequiredFieldMissingError) Error() string

Variables

var (
	// ErrTokenRequired is returned when no authentication token is provided
	ErrTokenRequired = errors.New("DATUM_ACCESS_TOKEN not set")

	// ErrInvalidRole is returned when an invalid role is provided for a member
	ErrInvalidRole = errors.New("invalid role, only member and admin are allowed")

	// ErrInvalidInviteStatus is returned when an invalid status is provided for an invite
	ErrInvalidInviteStatus = errors.New("invalid status, only sent, required, accepted, expired are allowed")

	// ErrUnsupportedProvider is returned when an invalid provider is specified during login
	ErrUnsupportedProvider = errors.New("invalid provider, only Github and Google are supported")

	// ErrNotFound is returned when a resource is not found
	ErrNotFound = errors.New("resource not found")
)

var (
	// DatumHost contains the root url for the Datum API
	DatumHost string
	// GraphAPIHost contains the url for the Datum graph api
	GraphAPIHost string
)

var (
	Logger *zap.SugaredLogger
)

var RootCmd = &cobra.Command{
	Use:   appName,
	Short: "the datum cli",
}

RootCmd represents the base command when called without any subcommands

Functions

func Execute

func Execute()

Execute adds all child commands to the root command and sets flags appropriately. This is called by main.main(). It only needs to happen once to the rootCmd.

func GetInviteStatusEnum

func GetInviteStatusEnum(status string) (enums.InviteStatus, error)

GetInviteStatusEnum returns the invitation status if valid, otherwise returns an error

func GetKeyring

func GetKeyring() (keyring.Keyring, error)

GetKeyring will return the already loaded keyring so that we don't prompt users for passwords multiple times

func GetRoleEnum

func GetRoleEnum(role string) (enums.Role, error)

GetRoleEnum returns the Role if valid, otherwise returns an error

func GetTokenFromKeyring

func GetTokenFromKeyring(ctx context.Context) (*oauth2.Token, string, error)

GetTokenFromKeyring will return the oauth token from the keyring if the token is expired, but the refresh token is still valid, the token will be refreshed

func JSONPrint

func JSONPrint(s []byte) error

func StoreSession

func StoreSession(session string) error

StoreSession in local keyring

func StoreSessionCookies

func StoreSessionCookies(client *datumclient.Client)

StoreSessionCookies gets the session cookie from the cookie jar and stores it in the keychain for future requests

func StoreToken

func StoreToken(token *oauth2.Token) error

StoreToken in local keyring

func ViperBindFlag

func ViperBindFlag(name string, flag *pflag.Flag)

ViperBindFlag provides a wrapper around the viper bindings that panics if an error occurs

Types

type CLI

type CLI struct {
	Client      datumclient.DatumClient
	Interceptor clientv2.RequestInterceptor
	AccessToken string
}

func GetGraphClient

func GetGraphClient(ctx context.Context) (*CLI, error)

func GetRestClient

func GetRestClient(ctx context.Context) (*CLI, error)

type RequiredFieldMissingError

type RequiredFieldMissingError struct {
	// Field contains the required field that was missing from the input
	Field string
}

RequiredFieldMissingError is returned when a field is required but not provided

func NewRequiredFieldMissingError

func NewRequiredFieldMissingError(f string) *RequiredFieldMissingError

NewRequiredFieldMissingError returns an error for a missing required field

func (*RequiredFieldMissingError) Error

func (e *RequiredFieldMissingError) Error() string

Error returns the RequiredFieldMissingError in string format