#!/usr/bin/python3 """Centralised logging configuration for Fungus Launcher. Sets up a root logger with a single console handler that writes to stderr (so stdout remains clean for pipes). All submodules should obtain their logger via ``get_logger(name)`` rather than calling ``logging.getLogger`` directly — this ensures the handler is installed exactly once at first call. Usage:: from fungus.logger import get_logger, set_level log = get_logger(__name__) log.info("something happened") log.debug("verbose details") log.error("something went wrong: %s", exc) # Enable debug output from the CLI:: set_level(logging.DEBUG) """ import logging import sys _handler: logging.Handler | None = None def set_level(level: int) -> None: """Set the minimum logging level for all loggers. Installs the handler if it has not yet been created, then sets both the root logger and the handler to *level*. """ global _handler if not _handler: _handler = logging.StreamHandler(sys.stderr) _handler.setFormatter( logging.Formatter("[%(name)s] %(levelname)s %(message)s") ) logging.root.addHandler(_handler) logging.root.setLevel(level) _handler.setLevel(level) def get_logger(name: str | None = None) -> logging.Logger: """Return a logger named *name* (or the root logger). The first call installs a ``StreamHandler`` writing to ``sys.stderr`` with a simple ``[name] level message`` format. Subsequent calls reuse the same handler. """ global _handler logger = logging.getLogger(name) if not _handler: _handler = logging.StreamHandler(sys.stderr) _handler.setFormatter( logging.Formatter("[%(name)s] %(levelname)s %(message)s") ) logger.addHandler(_handler) # Leave the logger at NOTSET so it inherits from the root logger. # The handler's own level (INFO by default) controls the minimum # severity; passing -v/--verbose raises it to DEBUG. return logger