GlavnaQt 0.1.1

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)
• Event handling (EventBus, transitions.py)
• 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 app:

python glavnaqt/examples/example.py

• Cycle layouts:

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

• Change settings in glavnaqt/core/config.py.

Project Structure

glavnaqt/
├── core/
│   ├── config.py
│   ├── logger.py
│   ├── profiler.py
│   └── thread_manager.py
├── ui/
│   ├── main_window.py
│   ├── layout.py
│   ├── status_bar_manager.py
│   ├── theme_manager.py
│   ├── theme_watcher.py
│   └── widget_adjustment.py
├── events/
│   ├── bus.py
│   └── window.py
├── examples/
│   └── example.py
├── transitions.py
├── setup.py
└── requirements.txt

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

AGPLv3. See LICENSE.

Contact

Open an issue on the public Codeberg mirror.