claude@clouddev1 6b4c4dcea4
ci / gate (push) Failing after 35s
ci / manifests (push) Successful in 3s
website / deploy (push) Successful in 35s
feat(types)!: drop the blob column type (ADR-0005 Amendment 2)
blob was a dead-end: declarable but never fillable (no literal in either
mode, seed-unsupported), so a blob column could only ever hold NULL. Remove
Type::Blob + Value/CellValue::Blob + the base64 CSV path + the grammar slot
+ completion/render/type-change/seed handling + the binder refusal (whose
message also carried a user-facing "DSL" copy-rule bug). The vocabulary is
now nine types; base64 stays (clipboard OSC-52).

Backward compat is the ADR-0015 migration framework's first real use: a
v1->v2 format bump (CURRENT_SCHEMA_VERSION across serializer/parser/skeleton)
with a migrator that rewrites `type: blob` -> `type: text`, and a forced .db
rebuild from the migrated text when a blob column was actually converted
(the stale .db keeps a STRICT BLOB engine column). Conversion to text is
non-destructive and CSV-free. Covered by a full-stack integration test and a
Tier-4 PTY test that opens a real legacy v1-blob project.

Also sweeps the nine-type vocabulary through CLAUDE.md, requirements.md, the
website (type reference, seed doc, highlight grammar), and the ADR-0030/0033/
0035 cross-references; CHANGELOG Removed entry; handoff-79.

BREAKING CHANGE: the `blob` column type is removed. Existing projects that
declared a blob column are migrated on first open (the column becomes text;
the original project.yaml is kept as a .v1.bak).
2026-06-22 21:25:38 +00:00

rdbms-playground

A cross-platform terminal app for learning relational database concepts — tables, columns, primary and foreign keys, relationships, indexes, queries, and query plans — in a safe sandbox.

It's a teaching tool, not a database administration tool. It meets beginners with guided, keyword-based commands (simple mode) and grows with them to raw SQL (advanced mode), so the same playground works from "what is a primary key?" through to writing real queries and reading their execution plans.

Website & documentation: https://relplay.org

Install

One line (Linux / macOS)

curl -fsSL https://git.lazyeval.net/oli/rdbms-playground/raw/branch/main/scripts/install.sh | sh

Detects your OS and CPU, downloads the matching release binary, verifies its SHA-256 checksum, and installs it to ~/.local/bin. Set RDBMS_INSTALL_DIR to install elsewhere, or RDBMS_VERSION=vX.Y.Z to pin a version. (Prefer to read before you run? The script lives at scripts/install.sh.)

One line (Windows, PowerShell)

irm https://git.lazyeval.net/oli/rdbms-playground/raw/branch/main/scripts/install.ps1 | iex

Downloads the matching .exe, verifies its checksum, installs to %LOCALAPPDATA%\Programs\rdbms-playground, and adds it to your user PATH. Or use a package manager (Scoop / winget) once those land.

With cargo binstall

If you have cargo-binstall (install it first — it is not part of cargo itself):

cargo binstall rdbms-playground

From source

cargo install rdbms-playground          # from crates.io
# or, from a clone:
cargo build --release                   # binary at target/release/rdbms-playground

Prebuilt binaries

Every release publishes static Linux, standalone Windows, and macOS binaries (x86_64 and aarch64) with .sha256 checksums on the releases page. Windows users can also use the binary directly (package-manager support is planned).

A quick taste

create table Customers with pk id(serial)
add column Customers: name (text)
add column Customers: email (text)
insert into Customers values ('Ann', 'ann@example.io')
show data Customers

Press F1 while typing for a contextual hint about the command you're building, or type help for the full command list. Switch to raw SQL with mode advanced (or prefix a single line with :).

Project status

Approaching its first public release. See the website for current features; installation via package managers (Homebrew, Scoop, winget) is on the roadmap.

License

Dual-licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual-licensed as above, without any additional terms or conditions. See CONTRIBUTING.md.

S
Description
No description provided
Readme
19 MiB
v0.2.0
Latest
2026-06-17 23:05:39 +01:00
Languages
Rust 96.3%
MDX 1.3%
Shell 0.8%
JavaScript 0.8%
Astro 0.2%
Other 0.5%