debug

Documentation

Overview

Package debug provides a process-global, stderr-based debug logger.

It is a leaf package (no imports of client/config/cmd) so any layer can emit debug lines via Logf without plumbing a logger through call sites. Enabling is a single switch: set Enabled = true (done by the --debug flag / APTBASE_DEBUG / config). All output goes to stderr so it never pollutes --json on stdout.

Index

• Variables
• func Logf(format string, args ...any)
• func Redact(b []byte) string
• func Section(title string)

Variables

var Enabled bool

Enabled turns debug output on. When false, all logging is a no-op.

Functions

func Logf

func Logf(format string, args ...any)

Logf writes a timestamped debug line to stderr when Enabled.

func Redact

func Redact(b []byte) string

Redact masks the values of known sensitive JSON fields in b, returning a string safe to log.

func Section

func Section(title string)

Section writes a bold debug header to group related output.