Class AppContext

src/quart/ctx.py:237–295

The context relating to the app bound to the current task. Do not use directly, prefer the :func:`~quart.Quart.app_context` instead. Attributes: app: The app itself. url_adapter: An adapter bound to the server, but not a specific task, useful for route build

class AppContext:
    """The context relating to the app bound to the current task.

    Do not use directly, prefer the
    :func:`~quart.Quart.app_context` instead.

    Attributes:
        app: The app itself.
        url_adapter: An adapter bound to the server, but not a
            specific task, useful for route building.
        g: An instance of the ctx globals class.
    """

    def __init__(self, app: Quart) -> None:
        self.app = app
        self.url_adapter = app.create_url_adapter(None)
        self.g = app.app_ctx_globals_class()
        self._cv_tokens: list[Token] = []

    def copy(self) -> AppContext:
        app_context = self.__class__(self.app)
        app_context.g = self.g
        return app_context

    async def push(self) -> None:
        self._cv_tokens.append(_cv_app.set(self))
        await appcontext_pushed.send_async(
            self.app,
            _sync_wrapper=self.app.ensure_async,  # type: ignore[arg-type]
        )

    async def pop(self, exc: BaseException | None = _sentinel) -> None:  # type: ignore
        try:
            if len(self._cv_tokens) == 1:
                if exc is _sentinel:
                    exc = sys.exc_info()[1]
                await self.app.do_teardown_appcontext(exc)
        finally:
            ctx = _cv_app.get()
            _cv_app.reset(self._cv_tokens.pop())

            if ctx is not self:
                raise AssertionError(
                    f"Popped wrong app context. ({ctx!r} instead of {self!r})"
                )

        await appcontext_popped.send_async(
            self.app,
            _sync_wrapper=self.app.ensure_async,  # type: ignore[arg-type]
        )

    async def __aenter__(self) -> AppContext:
        await self.push()
        return self

    async def __aexit__(
        self, exc_type: type, exc_value: BaseException, tb: TracebackType
    ) -> None: