dsviper-components

Shared Qt Widgets library for the dsviper Python ecosystem. Provides the common dialogs, views, and helpers used by dsviper-tools (cdbe, dbe, …) and ge-py (graph editor).

Extracted from com.digitalsubstrate.dsviper-tools/ds_components/.

Architectural position

Sits above the runtime layer. Consumes the public API of:

• dsviper (Python wheel) — runtime + binding.
• PySide6 — Qt Widgets toolkit.

No coupling to the Viper C++ runtime sources.

Layout

dsviper_components/         # Python package (importable as `dsviper_components`)
├── *.py                    # source — component logic
├── *.ui                    # source — Qt Designer XML
├── images/                 # source — 53 PNG icons
├── resources.qrc           # source — Qt resource manifest
├── ui_*.py                 # GENERATED by dev/build.py (gitignored)
└── resources_rc.py         # GENERATED by dev/build.py (gitignored)

The Python package is named dsviper_components; Qt resources are registered under the matching prefix :/dsviper_components/.

Build

After cloning or modifying any .ui or resources.qrc:

pip install -r requirements.txt
python dev/build.py

This regenerates dsviper_components/ui_*.py and dsviper_components/resources_rc.py. The PySide6 version is pinned in requirements.txt to avoid phantom diffs.

Conventions

• Documentation in English.
• Tag convention: vMAJOR.MINOR.PATCH.
• Branches: main + LTS-X.Y aligned with the dsviper ecosystem.