82 lines
2.6 KiB
Python
82 lines
2.6 KiB
Python
from functools import lru_cache
|
|
from typing import TYPE_CHECKING, Callable, Type, Any
|
|
|
|
if TYPE_CHECKING:
|
|
from source.gui.window import Window
|
|
from source.gui.widget import Widget
|
|
|
|
|
|
class Scene:
|
|
"""
|
|
A scene that can be attached to a window.
|
|
It allows to switch the whole comportment of the window in a simpler way.
|
|
|
|
It can react to any "on_" event from the window.
|
|
"""
|
|
|
|
def __init__(self, window: "Window", *args, **kwargs):
|
|
self.window = window
|
|
self._widgets: set["Widget"] = set()
|
|
|
|
# Widget Managing
|
|
|
|
def add_widget(self, widget_class: Type["Widget"], *widget_args, **widget_kwargs) -> "Widget":
|
|
"""
|
|
Add a widget to the scene.
|
|
:widget_class: the class of the widget to add.
|
|
:widget_args: args for the creation of the widget object.
|
|
:widget_kwargs: kwargs for the creation of the widget object.
|
|
:return: the new created widget.
|
|
"""
|
|
|
|
widget: "Widget" = widget_class(self, *widget_args, **widget_kwargs)
|
|
self._widgets.add(widget)
|
|
return widget
|
|
|
|
def remove_widget(self, widget: "Widget") -> None:
|
|
"""
|
|
Remove a widget from the scene.
|
|
:scene: the widget to remove.
|
|
"""
|
|
|
|
self._widgets.remove(widget)
|
|
|
|
def clear_widget(self) -> None:
|
|
"""
|
|
Clear the scene from all the widgets.
|
|
"""
|
|
|
|
self._widgets.clear()
|
|
|
|
# Event Handling
|
|
|
|
@lru_cache
|
|
def _event_wrapper(self, item: str) -> Callable:
|
|
"""
|
|
Un wrapper permettant d'appeler l'événement de tous les widgets attachées.
|
|
:param item: nom de la fonction à appeler dans le widget.
|
|
:return: une fonction appelant l'événement original ainsi que ceux des scènes.
|
|
"""
|
|
|
|
# Récupère la fonction originale. S'il n'y en a pas, renvoie une fonction sans effet.
|
|
try:
|
|
func = super().__getattribute__(item)
|
|
except AttributeError:
|
|
func = lambda *_, **__: "pass" # NOQA E731
|
|
|
|
def _func(*args, **kwargs) -> None:
|
|
func(*args, **kwargs)
|
|
for widget in self._widgets:
|
|
getattr(widget, item, lambda *_, **__: "pass")(*args, **kwargs)
|
|
|
|
return _func
|
|
|
|
def __getattribute__(self, item: str) -> Any:
|
|
"""
|
|
Fonction appelée dès que l'on essaye d'accéder à l'un des attributs de l'objet.
|
|
:param item: nom de l'attribut recherché
|
|
:return: l'attribut de l'objet correspondant.
|
|
"""
|
|
|
|
# si l'attribut est un événement (commence par "on_"), alors renvoie le dans un wrapper
|
|
return self._event_wrapper(item) if item.startswith("on_") else super().__getattribute__(item)
|