cli

type ColorMode int

type Config struct {
	transport.BaseConfig

	// Stdout overrides os.Stdout. Info / debug entries write here.
	Stdout io.Writer

	// Stderr overrides os.Stderr. Warn / error / fatal entries
	// write here.
	Stderr io.Writer

	// Color controls ANSI color output. Zero value is [ColorAuto].
	Color ColorMode

	// ShowFields, when true, appends fields and metadata after the
	// message in `key=value` form (logfmt). Default false: CLI
	// users don't want structured noise on user-facing output.
	// Useful when wiring `-vv` / `--debug` to a verbose mode that
	// includes diagnostic context.
	ShowFields bool

	// LevelPrefix overrides the default per-level prefix map.
	// Missing entries fall back to the defaults:
	//
	//   Trace: ""
	//   Debug: "debug: "
	//   Info:  ""
	//   Warn:  "warning: "
	//   Error: "error: "
	//   Fatal: "fatal: "
	//   Panic: "panic: "
	//
	// Set an entry to "" to suppress the default prefix for that
	// level. Use a non-default string to localize or rebrand
	// (e.g. "WARN: "). Override only the levels you want to
	// change; the remaining levels keep their defaults.
	//
	// To suppress every prefix at once, set DisableLevelPrefix
	// instead of populating an empty map for every level.
	LevelPrefix map[loglayer.LogLevel]string

	// DisableLevelPrefix, when true, suppresses every per-level
	// prefix unconditionally. Set this when the host CLI already
	// renders its own urgency markers (e.g. an icon column) and
	// the transport's prefixes would be redundant.
	DisableLevelPrefix bool

	// LevelColor overrides the default per-level color map.
	// Missing entries fall back to the defaults:
	//
	//   Trace, Debug:  dim grey  (color.FgHiBlack)
	//   Info:          no color
	//   Warn:          yellow
	//   Error:         red
	//   Fatal, Panic:  bold red
	//
	// Set an entry to nil to render that level without color while
	// keeping all other defaults. Use a custom *color.Color (from
	// fatih/color) to rebrand: e.g. cyan for warn, magenta for
	// fatal. color.New is the only fatih/color symbol you need;
	// the transport shallow-copies each entry and handles the
	// per-instance flag toggling that bypasses fatih/color's
	// process-global NoColor, so a *color.Color passed here can
	// be shared safely across multiple transports.
	//
	// Color is then resolved through Config.Color (Auto / Always /
	// Never), so an override here doesn't force ANSI on a piped
	// stdout unless you also set Color: ColorAlways.
	LevelColor map[loglayer.LogLevel]*color.Color
}

type Transport struct {
	transport.BaseTransport
	// contains filtered or unexported fields
}