logging

const (

	// DestinationStdErr indicates logs should be written to os.StdErr.
	DestinationStdErr Destination

	// DestinationStdOut indicates logs should be written to os.StdOut.
	DestinationStdOut

	// DestinationNil indicates log messages should be silently dropped.
	DestinationNil
)

const (

	// FormatJSON indicates logs should be written in JSON format.
	FormatJSON Format

	// FormatText indicates logs should be written in simple Text format. If
	// the Logger's configured Destination is connected to a TTY, logs will be
	// written in an easy-to-visually-parse format. Otherwise they are written
	// in the format expected by the system journal.
	FormatText
)

const (

	// LevelTrace is the trace logging level. Trace log messages are typically
	// reserved for particularly in-depth log messages during a debugging dev
	// loop.
	LevelTrace Level

	// LevelDebug is the debug logging level. Debug log messages typically
	// provide low level detail of an individual unit of program input event.
	LevelDebug

	// LevelInfo is the info logging level. Info log messages typically provide
	// insight into the operational state of the process and the start and
	// outcome of an individual program input event.
	LevelInfo

	// LevelWarning is the warning logging level. Warning log messages
	// typically document recoverable or otherwise known unhappy-path states.
	LevelWarning

	// LevelError is the error logging level. Error log messages typically
	// document unrecoverable or otherwise extreme unhappy-path states.
	LevelError

	// LevelPanic is the panic logging level. Panic log messages document
	// a processes' imminent shutdown.
	LevelPanic
)