dsviper-tools

dsviper-tools is the runtime-side developer toolkit: CLI utilities, two GUI editors (cdbe.py for the commit-based CommitDatabase and dbe.py for the plain Database — see Database Editors for the distinction), and the server that exposes a CommitDatabase over the network. Together with Kibo, it forms the day-to-day developer experience around the dsviper runtime.

The toolkit covered here is the Qt Widgets variant; dsviper-tools-qml provides Qt Quick versions of the same database browsers.

See also IDE Integration (VS Code / JetBrains plugins) and Python Wheels (Python wheel packaging).

Place in the ecosystem

• Depends on — DSM, dsviper, Qt (for the GUI editors).

• Consumed by — developer toolchains. Not a runtime dependency of applications.

• Source repositories —

  • digital-substrate/dsviper-tools — Qt Widgets.

  • digital-substrate/dsviper-tools-qml — Qt Quick / QML.

• Distribution — bundled in the DevKit ZIP.

Quickstart

Validate a DSM model:

python3 tools/dsm_util.py check model.dsm

Create a versioned database from a DSM model:

python3 tools/dsm_util.py create_commit_database model.dsm project.cdb

Open the database in the GUI editor:

python3 tools/cdbe.py project.cdb

Expose the database over the network for multi-client editing:

python3 tools/commit_database_server.py project.cdb

Topics

Development

• dsm_util.py
  • Commands
  • Check Syntax
  • Create Commit Database
  • Create Database
  • Create Python Package
  • Encode to JSON
  • Decode from JSON
  • Workflow Example

Database Tools

• Database Editors
  • cdbe.py - Commit Database Editor
  • dbe.py - Database Editor
  • ds_components - Shared GUI Library
• Database Server
  • commit_database_server.py
  • commit_admin.py

Status

Part of DevKit 1.2.x (LTS, feature-locked).