Source code for babase._appmodeselector

# Released under the MIT License. See LICENSE for details.
#
"""Contains AppModeSelector base class."""
from __future__ import annotations

from typing import TYPE_CHECKING

if TYPE_CHECKING:
    from babase import AppMode, AppIntent




class AppModeSelector:
    """Defines which app-modes should handle which app-intents.

    The app calls an instance of this class when passed an
    :class:`~babase.AppIntent` to determine which
    :class:`~babase.AppMode` to use to handle it. Plugins or spinoff
    projects can modify high level app behavior by replacing or
    modifying the app's :attr:`~babase.App.mode_selector` attr or by
    modifying settings used to construct the default one.
    """



    def app_mode_for_intent(self, intent: AppIntent) -> type[AppMode] | None:
        """Given an app-intent, return the app-mode that should handle it.

        If None is returned, the intent will be ignored.

        This may be called in a background thread, so avoid any calls
        limited to logic thread use/etc.
        """
        raise NotImplementedError()




# Docs-generation hack; import some stuff that we likely only forward-declared
# in our actual source code so that docs tools can find it.
from typing import (Coroutine, Any, Literal, Callable,
  Generator, Awaitable, Sequence, Self)
import asyncio
from concurrent.futures import Future
from pathlib import Path
from enum import Enum