dsviper-tools

dsviper-tools is the runtime-side developer toolkit: CLI utilities, GUI database editors, 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). A parallel QML variant (dsviper-tools-qml) provides Qt Quick versions of the same database browsers — see its repository for status.

For IDE integration (VS Code and JetBrains plugins for DSM syntax), see IDE Integration — the plugins target the DSM language, not dsviper, so they live in the DSM section. For Python wheel packaging, see Python Wheels — the wheel layout is one of the features emitted by the viper template pack.

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
  • What’s Next

Database Tools

• Database Editors
  • cdbe.py - CommitDatabase Editor
  • dbe.py - Database Editor
  • ds_components - Shared GUI Library
  • What’s Next
• Database Server & Administration
  • commit_database_server.py
  • commit_admin.py
  • What’s Next

Status

Part of DevKit 1.2.x. The toolkit evolves alongside the dsviper runtime and the Kibo template ecosystem.