Source code for babase._appsubsystem

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

from typing import TYPE_CHECKING

import _babase

if TYPE_CHECKING:
    from babase import UIScale




class AppSubsystem:
    """Base class for an app subsystem.

    An app 'subsystem' is a bit of a vague term, as pieces of the app
    can technically be any class and are not required to use this, but
    building one out of this base class provides conveniences such as
    predefined callbacks during app state changes.

    Subsystems must be registered with the app before it completes its
    transition to the 'running' state.
    """

    def __init__(self) -> None:
        _babase.app.register_subsystem(self)



    def on_app_loading(self) -> None:
        """Called when the app reaches the loading state.

        Note that subsystems created after the app switches to the
        loading state will not receive this callback. Subsystems created
        by plugins are an example of this.
        """




    def on_app_running(self) -> None:
        """Called when app enters :attr:`~AppState.RUNNING` state."""




    def on_app_suspend(self) -> None:
        """Called when app enters :attr:`~AppState.SUSPENDED` state."""




    def on_app_unsuspend(self) -> None:
        """Called when app exits :attr:`~AppState.SUSPENDED` state."""




    def on_app_shutdown(self) -> None:
        """Called when app enters :attr:`~AppState.SHUTTING_DOWN` state."""




    def on_app_shutdown_complete(self) -> None:
        """Called when app enters :attr:`~AppState.SHUTDOWN_COMPLETE` state."""




    def do_apply_app_config(self) -> None:
        """Called when the app config should be applied."""




    def on_ui_scale_change(self) -> None:
        """Called when screen ui-scale changes.

        Will not be called for the initial ui scale.
        """




    def on_screen_size_change(self) -> None:
        """Called when the screen size changes.

        Will not be called for the initial screen size.
        """




    def reset(self) -> None:
        """Reset the subsystem to a default state.

        This is called when switching app modes, but may be called at
        other times too.
        """




# 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