message

package
v0.38.0 Latest Latest
Warning

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

 Go to latest Published: Aug 8, 2024 License: Apache-2.0 Imports: 13 Imported by: 17

Documentation

Overview

Package message provides a rich set of functions for displaying messages to the user.

Package message provides a rich set of functions for displaying messages to the user.

Package message provides a rich set of functions for displaying messages to the user.

Package message provides a rich set of functions for displaying messages to the user.

Package message provides a rich set of functions for displaying messages to the user.

Package message provides a rich set of functions for displaying messages to the user.

Package message provides a rich set of functions for displaying messages to the user.

Package message provides a rich set of functions for displaying messages to the user.

Index

Constants

View Source 
const (
	RegistryKey     = "registry"
	RegistryReadKey = "registry-readonly"
	GitKey          = "git"
	GitReadKey      = "git-readonly"
	ArtifactKey     = "artifact"
	AgentKey        = "agent"
)

Common constants for printing credentials

Variables

View Source 
var NoProgress bool

NoProgress tracks whether spinner/progress bars show updates.

View Source 
var RuleLine = strings.Repeat("━", TermWidth)

RuleLine creates a line of ━ as wide as the terminal

Functions

func ColorEnabled 

func ColorEnabled() bool

ColorEnabled returns true if color printing is enabled.

func ColorWrap 

func ColorWrap(str string, attr color.Attribute) string

ColorWrap changes a string to an ansi color code and appends the default color to the end preventing future characters from taking on the given color returns string as normal if color is disabled

func Command 

func Command(format string, a ...any)

Command prints a zarf terminal command.

func Debug 

func Debug(payload ...any)

Debug prints a debug message.

func Debugf 

func Debugf(format string, a ...any)

Debugf prints a debug message with a given format.

func DisableColor 

func DisableColor()

DisableColor disables color in output 

func GetLogo() string

GetLogo returns the awesome menu ascii logo.

func HeaderInfof 

func HeaderInfof(format string, a ...any)

HeaderInfof prints a large header with a formatted message.

func HorizontalRule 

func HorizontalRule()

HorizontalRule prints a white horizontal rule to separate the terminal

func Info 

func Info(message string)

Info prints an info message.

func Infof 

func Infof(format string, a ...any)

Infof prints an info message with a given format.

func InitializePTerm 

func InitializePTerm(w io.Writer)

InitializePTerm sets the default styles and output for pterm.

func Note 

func Note(text string)

Note prints a note message.

func Notef 

func Notef(format string, a ...any)

Notef prints a note message with a given format.

func Paragraph 

func Paragraph(format string, a ...any) string

Paragraph formats text into a paragraph matching the TermWidth

func Paragraphn 

func Paragraphn(n int, format string, a ...any) string

Paragraphn formats text into an n column paragraph

func PrintComponentCredential 

func PrintComponentCredential(state *types.ZarfState, componentName string)

PrintComponentCredential displays credentials for a single component

func PrintConnectStringTable 

func PrintConnectStringTable(connectStrings types.ConnectStrings)

PrintConnectStringTable prints a table of connect strings.

func PrintCredentialTable 

func PrintCredentialTable(state *types.ZarfState, componentsToDeploy []types.DeployedComponent)

PrintCredentialTable displays credentials in a table

func PrintCredentialUpdates 

func PrintCredentialUpdates(oldState *types.ZarfState, newState *types.ZarfState, services []string)

PrintCredentialUpdates displays credentials that will be updated

func Question 

func Question(text string)

Question prints a user prompt description message.

func Questionf 

func Questionf(format string, a ...any)

Questionf prints a user prompt description message with a given format.

func SetLogLevel 

func SetLogLevel(lvl LogLevel)

SetLogLevel sets the log level.

func Success 

func Success(message string)

Success prints a success message.

func Successf 

func Successf(format string, a ...any)

Successf prints a success message with a given format.

func Table 

func Table(header []string, data [][]string)

Table prints a padded table containing the specified header and data

func Title 

func Title(title string, help string)

Title prints a title and an optional help description for that section

func Warn 

func Warn(message string)

Warn prints a warning message.

func WarnErr 

func WarnErr(err any, message string)

WarnErr prints an error message as a warning.

func WarnErrf 

func WarnErrf(err any, format string, a ...any)

WarnErrf prints an error message as a warning with a given format.

func Warnf 

func Warnf(format string, a ...any)

Warnf prints a warning message with a given format.

func ZarfCommand 

func ZarfCommand(format string, a ...any)

ZarfCommand prints a zarf terminal command.

Types

type DebugWriter 

type DebugWriter struct{}

DebugWriter represents a writer interface that writes to message.Debug

func (*DebugWriter) Write 

func (d *DebugWriter) Write(raw []byte) (int, error)

type LogLevel 

type LogLevel int

LogLevel is the level of logging to display. 

const (
	// WarnLevel level. Non-critical entries that deserve eyes.
	WarnLevel LogLevel = iota
	// InfoLevel level. General operational entries about what's going on inside the
	// application.
	InfoLevel
	// DebugLevel level. Usually only enabled when debugging. Very verbose logging.
	DebugLevel
	// TraceLevel level. Designates finer-grained informational events than the Debug.
	TraceLevel

	// TermWidth sets the width of full width elements like progressbars and headers
	TermWidth = 100
)

type PausableWriter 

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

PausableWriter is a pausable writer

func NewPausableWriter 

func NewPausableWriter(wr io.Writer) *PausableWriter

NewPausableWriter creates a new pausable writer

func UseLogFile 

func UseLogFile(f *os.File) (*PausableWriter, error)

UseLogFile wraps a given file in a PausableWriter and sets it as the log file used by the message package.

func (*PausableWriter) Pause 

func (pw *PausableWriter) Pause()

Pause sets the output writer to io.Discard

func (*PausableWriter) Resume 

func (pw *PausableWriter) Resume()

Resume sets the output writer back to the original writer

func (*PausableWriter) Write 

func (pw *PausableWriter) Write(p []byte) (n int, err error)

Write writes the data to the underlying output writer

type ProgressBar 

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

ProgressBar is a struct used to drive a pterm ProgressbarPrinter.

func NewProgressBar 

func NewProgressBar(total int64, text string) *ProgressBar

NewProgressBar creates a new ProgressBar instance from a total value and a format.

func (*ProgressBar) Add 

func (p *ProgressBar) Add(n int)

Add updates the ProgressBar with completed progress.

func (*ProgressBar) Close 

func (p *ProgressBar) Close() error

Close stops the ProgressBar from continuing.

func (*ProgressBar) Failf 

func (p *ProgressBar) Failf(format string, a ...any)

Failf marks the ProgressBar as failed in the CLI.

func (*ProgressBar) GetCurrent 

func (p *ProgressBar) GetCurrent() int

GetCurrent returns the current total

func (*ProgressBar) Successf 

func (p *ProgressBar) Successf(format string, a ...any)

Successf marks the ProgressBar as successful in the CLI.

func (*ProgressBar) Update 

func (p *ProgressBar) Update(complete int64, text string)

Update updates the ProgressBar with completed progress and new text.

func (*ProgressBar) Updatef 

func (p *ProgressBar) Updatef(format string, a ...any)

Updatef updates the ProgressBar with new text.

func (*ProgressBar) Write 

func (p *ProgressBar) Write(data []byte) (int, error)

Write updates the ProgressBar with the number of bytes in a buffer as the completed progress.

type Spinner 

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

Spinner is a wrapper around pterm.SpinnerPrinter.

func NewProgressSpinner 

func NewProgressSpinner(format string, a ...any) *Spinner

NewProgressSpinner creates a new progress spinner.

func (*Spinner) DisablePreserveWrites 

func (p *Spinner) DisablePreserveWrites()

DisablePreserveWrites disables preserving writes to the terminal.

func (*Spinner) EnablePreserveWrites 

func (p *Spinner) EnablePreserveWrites()

EnablePreserveWrites enables preserving writes to the terminal.

func (*Spinner) Errorf 

func (p *Spinner) Errorf(err error, format string, a ...any)

Errorf prints an error message with the spinner.

func (*Spinner) Stop 

func (p *Spinner) Stop()

Stop the spinner.

func (*Spinner) Success 

func (p *Spinner) Success()

Success prints a success message and stops the spinner.

func (*Spinner) Successf 

func (p *Spinner) Successf(format string, a ...any)

Successf prints a success message with the spinner and stops it.

func (*Spinner) Updatef 

func (p *Spinner) Updatef(format string, a ...any)

Updatef updates the spinner text.

func (*Spinner) Write 

func (p *Spinner) Write(raw []byte) (int, error)

Write the given text to the spinner.

type ZarfHandler 

type ZarfHandler struct{}

ZarfHandler is a simple handler that implements the slog.Handler interface

func (ZarfHandler) Enabled 

func (z ZarfHandler) Enabled(_ context.Context, _ slog.Level) bool

Enabled is always set to true as zarf logging functions are already aware of if they are allowed to be called

func (ZarfHandler) Handle 

func (z ZarfHandler) Handle(_ context.Context, record slog.Record) error

Handle prints the respective logging function in zarf This function ignores any key pairs passed through the record

func (ZarfHandler) WithAttrs 

func (z ZarfHandler) WithAttrs(_ []slog.Attr) slog.Handler

WithAttrs is not supported

func (ZarfHandler) WithGroup 

func (z ZarfHandler) WithGroup(_ string) slog.Handler

WithGroup is not supported

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.