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).

Documentation

Full documentation: https://docs.digitalsubstrate.io/dsviper-components/

Part of the DevKit ecosystem.

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: LTS-X.Y is the canonical line, aligned with the dsviper ecosystem; main is currently a mirror of it.

License

This project is licensed under the MIT License — see LICENSE.

Runtime dependency

At runtime, this project depends on the dsviper Python package (distributed on PyPI), which is proprietary (PyPI classifier License :: Other/Proprietary License). See https://pypi.org/project/dsviper/ for the package's licensing posture and contact information.