GlavnaQt 0.2.2

PyQt6 app framework with event bus, layout management, and theming helpers

GlavnaQt

GlavnaQt is a PyQt6-based GUI framework for building desktop applications with customizable layouts and basic UI features.

Features

• Layouts with splitters and sidebars (CollapsibleSplitter, LayoutManager)
• Framework-internal Qt signals (FrameworkSignals) kept separate from the app-level EventBus
• Configuration via UIConfig (Confumo)
• Status bar updates (StatusBarManager)
• Background tasks (ThreadManager, TaskRunnable)
• Light/dark theme support (ThemeManager, ThemeWatcher)
• Optional profiling (profiler.py) and logging (logger.py)

Installation

For normal use, install the published package:

pip install GlavnaQt

For development from source, use a checkout from the canonical VPS host or public mirror, then create a virtual environment:

cd GlavnaQt
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt
python glavnaqt/examples/example.py

Usage

Start the example app:

python glavnaqt/examples/example.py

Cycle layouts:

python glavnaqt/examples/example.py --cycle-layouts

Load a data-only YAML/TOML layout file:

python glavnaqt/examples/example.py --layout-file layout.yaml

During local UI development, enable explicit data-layout hot reload:

python glavnaqt/examples/example.py --layout-file layout.yaml --dev-layout-hot-reload

Hot reload only recompiles the declarative layout data into LayoutSpec; it does not import or reload Python modules. During rebuilds, GlavnaQt preserves generic UI state for widgets with stable objectName values where feasible: splitter sizes/collapsed flags, tab or stack selection indexes, and scroll-bar positions.

Adjust application defaults in glavnaqt/core/config.py.

Event APIs

GlavnaQt framework plumbing uses typed Qt signals on FrameworkSignals. Framework-owned events are not bridged through EventBus. Application-specific events that GlavnaQt does not own can continue to use EventBus, but downstream applications are responsible for triggering their own startup refreshes.

Development

Run the local packaging check:

scripts/ci/check

Run the fuller local pass, including the optional Qt smoke import:

scripts/ci/full

For a tagged release candidate:

scripts/ci/release-check v0.1.0

License

This repository ships under 0BSD; see LICENSE and NOTICE.

Contact

Open an issue on the public Codeberg mirror.