Skip to content

TxnStage v0.1.0

Choose a tag to compare

@0then0 0then0 released this 21 Oct 09:55
· 29 commits to main since this release
1d52414

First public release of TxnStage, a local visual laboratory for concurrent SQLite transactions.

Highlights

  • Run real SQL across two or three independent worker processes on a disposable database.
  • Explore six built-in schedules covering stale snapshots, writer contention, DEFERRED/IMMEDIATE transactions and WAL checkpoints.
  • Inspect typed results, busy callbacks, SQLite error codes, transaction state and an event timeline.
  • Edit and export schedules, inspect recordings without executing SQL, and replay them in a fresh database.
  • Use the workbench in a browser or execute scenarios from the command line. The native executable embeds the frontend and SQLite 3.53.2.

Downloads

Choose the archive for your platform: Linux x86_64, macOS ARM64, or Windows x86_64. Each archive includes the executable, documentation, scenarios and sample recordings. Node.js and a system SQLite installation are not required to run it.

Each archive has a matching .sha256 file and .environment.json file containing the compiled SQLite version, source ID, options and platform.

Extract the archive and run:

./txnstage serve

On Windows, use txnstage.exe serve. Open the complete local URL printed in the terminal. Press Ctrl+C to stop the server and remove its disposable database.

macOS and Windows executables are unsigned. The Linux archive requires glibc 2.39 or newer. Experiments are limited to TxnStage's own temporary databases; existing user databases cannot be opened.

See the included README and documentation for scenario format, resource limits and development instructions.

Platform qualification

The Linux x86_64, macOS ARM64 and Windows x86_64 release jobs passed their native and UI tests.

A macOS Intel archive is not included: its release job twice failed the large-recording UI check because the completion message did not appear within the five-second assertion window after a successful server response. Native tests and the other 15 UI tests passed on that target. This target is not qualified for this release.