EJIO.ctk_extender.app package

Submodules

EJIO.ctk_extender.app.base module

class EJIO.ctk_extender.app.base.Application(*args: object, **kwargs: object)

Базовые классы: Singleton

Глобальный оркестратор и единый фасадный интерфейс фреймворка ctk_extender. Предоставляет методы для управления событиями, навигацией и жизненным циклом окон без прямого обращения к внутренним контроллерам.

change_language(locale: str) → None

Переключает текущий язык интерфейса приложения в рантайме.

close_window(name: str) → None

Закрывает окно по его имени.

emit(event: Event) → None

Потокобезопасно отправляет событие в глобальную шину.

exit(exit_code: int = 0) → None

Полная каскадная выгрузка всех компонентов и завершение работы.

get_window(name: str) → Window

Возвращает живой объект активного окна по имени.

property is_running: bool

navigate_to(window_name: str, layout_name: str) → None

Переключает текущий макет указанного окна (с полной очисткой стека).

notify(notification_cls: type[BaseNotification], target: Literal['in_app', 'desktop'] = 'in_app', flags: StyleFlags = StyleFlags.DEFAULT, position: str = 'top_right', duration: float = 3.5, **kwargs: Any) → None

Единая полиморфная точка входа для отправки уведомлений во фреймворке. Прозрачно проксирует переданный ООП-класс уведомления в контроллеры.

open_window(name: str, *args: Any, **kwargs: Any) → Window

Создает и выводит на экран окно из WindowRegistry.

pop_screen(window_name: str) → None

Возвращает указанное окно на предыдущий экран навигационного стека.

popup_confirm(title: str, message: str, on_callback: Callable[[bool], None]) → None

Показывает модальный диалог подтверждения операции (Да/Нет) с защитой от крестика.

popup_image(title: str, source: str | Path | bytes) → None

Открывает независимое неблокирующее окно для просмотра картинок или байтовых графов.

popup_info(title: str, message: str) → None

Показывает модальное информационное окно.

popup_warning(title: str, message: str) → None

Показывает модальное предупреждение об ошибке.

push_screen(window_name: str, layout_name: str) → None

Помещает новый экран на вершину стека навигации указанного окна.

run() → None

Запускает приложение, инициализируя тему, локали и главный цикл Tkinter.

subscribe(event_type: type[E], callback: Callable[[E], None], *, sender: Any | None = None, predicate: Callable[[E], bool] | None = None) → None

Подписывает обработчик на определенное событие с фильтрацией.

translate(key_path: str, default: str | None = None) → str

Извлекает локализованную строку по её точечному пути. Дублирует поведение глобальной функции _().

unsubscribe(event_type: type[E], callback: Callable[[E], None]) → None

Отписывает обработчик от события.

Module contents

class EJIO.ctk_extender.app.Application(*args: object, **kwargs: object)

Базовые классы: Singleton

Глобальный оркестратор и единый фасадный интерфейс фреймворка ctk_extender. Предоставляет методы для управления событиями, навигацией и жизненным циклом окон без прямого обращения к внутренним контроллерам.

change_language(locale: str) → None

Переключает текущий язык интерфейса приложения в рантайме.

close_window(name: str) → None

Закрывает окно по его имени.

emit(event: Event) → None

Потокобезопасно отправляет событие в глобальную шину.

exit(exit_code: int = 0) → None

Полная каскадная выгрузка всех компонентов и завершение работы.

get_window(name: str) → Window

Возвращает живой объект активного окна по имени.

property is_running: bool

navigate_to(window_name: str, layout_name: str) → None

Переключает текущий макет указанного окна (с полной очисткой стека).

notify(notification_cls: type[BaseNotification], target: Literal['in_app', 'desktop'] = 'in_app', flags: StyleFlags = StyleFlags.DEFAULT, position: str = 'top_right', duration: float = 3.5, **kwargs: Any) → None

Единая полиморфная точка входа для отправки уведомлений во фреймворке. Прозрачно проксирует переданный ООП-класс уведомления в контроллеры.

open_window(name: str, *args: Any, **kwargs: Any) → Window

Создает и выводит на экран окно из WindowRegistry.

pop_screen(window_name: str) → None

Возвращает указанное окно на предыдущий экран навигационного стека.

popup_confirm(title: str, message: str, on_callback: Callable[[bool], None]) → None

Показывает модальный диалог подтверждения операции (Да/Нет) с защитой от крестика.

popup_image(title: str, source: str | Path | bytes) → None

Открывает независимое неблокирующее окно для просмотра картинок или байтовых графов.

popup_info(title: str, message: str) → None

Показывает модальное информационное окно.

popup_warning(title: str, message: str) → None

Показывает модальное предупреждение об ошибке.

push_screen(window_name: str, layout_name: str) → None

Помещает новый экран на вершину стека навигации указанного окна.

run() → None

Запускает приложение, инициализируя тему, локали и главный цикл Tkinter.

subscribe(event_type: type[E], callback: Callable[[E], None], *, sender: Any | None = None, predicate: Callable[[E], bool] | None = None) → None

Подписывает обработчик на определенное событие с фильтрацией.

translate(key_path: str, default: str | None = None) → str

Извлекает локализованную строку по её точечному пути. Дублирует поведение глобальной функции _().

unsubscribe(event_type: type[E], callback: Callable[[E], None]) → None

Отписывает обработчик от события.