Function _setup_logging

relay/server.py:806–831

Configure stderr + rotating file logging. File handler creation is best-effort: if the log directory cannot be created or the file cannot be opened, logging falls back to stderr only.

(level: int)

def _setup_logging(level: int) -> None:
    """Configure stderr + rotating file logging.

    File handler creation is best-effort: if the log directory cannot be
    created or the file cannot be opened, logging falls back to stderr only.
    """
    handlers: list[logging.Handler] = [logging.StreamHandler()]

    try:
        log_path = get_log_path()
        log_path.parent.mkdir(parents=True, exist_ok=True)
        file_handler = RotatingFileHandler(
            log_path,
            maxBytes=LOG_MAX_BYTES,
            backupCount=LOG_BACKUP_COUNT,
            delay=True,
        )
        file_handler.setFormatter(logging.Formatter(LOG_FORMAT))
        handlers.append(file_handler)
    except OSError as e:
        # Fall back to stderr-only; warn after basicConfig sets up the handler
        logging.basicConfig(level=level, format=LOG_FORMAT, handlers=handlers, force=True)
        logger.warning(f"Failed to set up file logging: {e}")
        return

    logging.basicConfig(level=level, format=LOG_FORMAT, handlers=handlers, force=True)


def main() -> None: