gmuse.logging

Structured logging for gmuse with debug mode support.

This module provides a centralized logging configuration that can be toggled via the GMUSE_DEBUG environment variable.

Public API:

• setup_logger: Configure and return a logger with appropriate settings

• get_logger: Get an existing logger or create a new one

• configure_litellm_logging: Configure litellm library logging

Environment Variables:

• GMUSE_DEBUG: Set to “1”, “true”, or “yes” to enable debug logging

Module Contents

Functions

setup_logger	Configure and return a logger with appropriate settings.
get_logger	Get an existing logger or create a new one with default settings.
configure_litellm_logging	Configure litellm library logging based on debug mode.

Data

_DEBUG_ENV_VALUES	Environment variable values that enable debug mode.
_LOG_FORMAT	Log message format (simple, no timestamps for CLI tool).

API

gmuse.logging._DEBUG_ENV_VALUES: Final[frozenset[str]] = 'frozenset(...)'

Environment variable values that enable debug mode.

gmuse.logging._LOG_FORMAT: Final[str] = '[%(levelname)s] %(message)s'

Log message format (simple, no timestamps for CLI tool).

gmuse.logging.setup_logger(name: str = 'gmuse', level: Optional[int] = None, log_file: Optional[str] = None) → logging.Logger

Configure and return a logger with appropriate settings.

Args:

name: Logger name, defaults to “gmuse” level: Logging level, defaults to INFO or DEBUG based on GMUSE_DEBUG env var log_file: Optional file path for log output. If provided, logs go to file instead of stderr.

Returns:

Configured logger instance

Example:

>>> logger = setup_logger()
>>> logger.debug("This only shows when GMUSE_DEBUG=1")
>>> logger.info("This always shows")
>>> # With file logging:
>>> logger = setup_logger(log_file="~/.cache/gmuse/debug.log")

gmuse.logging.get_logger(name: str = 'gmuse') → logging.Logger

Get an existing logger or create a new one with default settings.

Args:

name: Logger name, defaults to “gmuse”

Returns:

Logger instance

Example:

>>> from gmuse.logging import get_logger
>>> logger = get_logger()
>>> logger.info("Loading configuration...")

gmuse.logging.configure_litellm_logging() → None

Configure litellm library logging based on debug mode.

Suppresses litellm’s verbose debug output unless GMUSE_DEBUG is enabled. This should be called once when the llm_client module is imported.