debug

package

v0.17.0 Latest Latest Go to latest Published: May 5, 2026 License: MIT Imports: 8 Imported by: 0

Details

Package debug provides namespaced debug logging inspired by npm's debug package.

Loggers are created with a namespace (e.g. "auth:token", "http:request") and write to stderr only when enabled. Enable via:

When disabled, Log is a near-zero-cost no-op (single atomic bool check).

This section is empty.

This section is empty.

func Enable()

Enable turns on all debug loggers globally. Called by --verbose flag handling. Loggers created before Enable() is called are retroactively activated.

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

Logger is a namespaced debug logger. The zero value is a disabled no-op logger.

func New(namespace string) Logger

New creates a debug logger for the given namespace. The logger is enabled if GLEAN_DEBUG patterns match the namespace.

func (l Logger) Enabled() bool

Enabled reports whether this logger will produce output.

func (l Logger) Log(format string, args ...any)

Log writes a debug message to stderr if this logger is enabled. Format and args follow fmt.Sprintf conventions.