Function set_global_context

tortoise/context.py:71–96

Set the global fallback context for cross-task access. This is used by RegisterTortoise (FastAPI) where asgi-lifespan runs lifespan in a background task, but requests/tests run in a different task. The global context allows these cross-task scenarios to work without explicit co

(ctx: TortoiseContext)

def set_global_context(ctx: TortoiseContext) -> None:
    """
    Set the global fallback context for cross-task access.

    This is used by RegisterTortoise (FastAPI) where asgi-lifespan runs lifespan
    in a background task, but requests/tests run in a different task.
    The global context allows these cross-task scenarios to work without
    explicit context passing.

    Args:
        ctx: The TortoiseContext to set as global fallback.

    Raises:
        ConfigurationError: If a global context is already set. Only one global
            context can be active at a time. For multiple isolated contexts,
            use explicit TortoiseContext() without global fallback.
    """
    global _global_context
    if _global_context is not None:
        raise ConfigurationError(
            "Global context fallback is already enabled by another Tortoise.init() call. "
            "Only one global context can be active at a time. "
            "Use explicit TortoiseContext() for multiple isolated contexts, "
            "or set _enable_global_fallback=False for secondary apps."
        )
    _global_context = ctx


def require_context() -> TortoiseContext: