Function configure

src/codex_self_evolution/logging_setup.py:79–121

Install (or reset) a JSON-lines file handler for the plugin logger. Idempotent: subsequent calls close any existing handlers first so test harnesses and repeated CLI invocations don't accumulate handlers. The ``home`` arg exists for tests to point logs at ``tmp_path`` instead of the

(home: str | Path | None = None)

def configure(home: str | Path | None = None) -> logging.Logger:
    """Install (or reset) a JSON-lines file handler for the plugin logger.

    Idempotent: subsequent calls close any existing handlers first so test
    harnesses and repeated CLI invocations don't accumulate handlers. The
    ``home`` arg exists for tests to point logs at ``tmp_path`` instead
    of the user's real home dir.
    """
    logger = logging.getLogger(LOGGER_NAME)
    # Swap handlers atomically; don't leak FDs from previous invocations.
    for handler in list(logger.handlers):
        logger.removeHandler(handler)
        try:
            handler.close()
        except Exception:  # noqa: BLE001 — cleanup must never raise
            pass

    home_dir = Path(home).expanduser().resolve() if home else get_home_dir()
    log_dir = home_dir / "logs"
    try:
        log_dir.mkdir(parents=True, exist_ok=True)
    except OSError:
        # Disk full / permission denied: log to stderr rather than blowing
        # up the whole CLI. The plugin itself still works.
        stderr = logging.StreamHandler()
        stderr.setFormatter(JsonFormatter())
        logger.addHandler(stderr)
        logger.setLevel(logging.INFO)
        return logger

    file_handler = logging.handlers.TimedRotatingFileHandler(
        log_dir / LOG_FILENAME,
        when="midnight",
        backupCount=DEFAULT_RETENTION_DAYS,
        encoding="utf-8",
    )
    file_handler.setFormatter(JsonFormatter())
    logger.addHandler(file_handler)
    logger.setLevel(logging.INFO)
    # Don't bubble up to the root logger — avoids double-printing if the
    # host process (tests, Codex hook runner) attaches its own stderr handler.
    logger.propagate = False
    return logger


def get_logger() -> logging.Logger: