Developer Tools

vstorage-audit

Which storage builtins are live, from flat files to embedded databases.

Released v1.0.0 · 2026-09-28
Import
use "stdlib/storage_audit.ven"

Checks every storage builtin the interpreter offers, such as the archive and container formats it supports, with a real call, so a program can see which storage operations are live on the virtual machine it runs under.

vstorage-audit.ven
print storage_audit_summary()
Reference (9 functions)

API reference

owner(name, owner_file, live, status)

Builds one implementation-ownership registry entry as a Map.

owner("Example family", "builtins", yes, "live: it works")["name"]

file_io_status(probe_path)

Proves flat file I/O is live on THIS running VM with a real round-trip through a temp file, not an assertion from prose.

file_io_status("/tmp/vstorage_audit_docs_probe.txt")

json_persistence_status()

Proves JSON structured-document persistence is live: a real encode/decode round-trip of a Map, not an assertion.

json_persistence_status()

sql_engine_status()

Proves the embedded SQLite engine is live: a real create/insert/ query/close sequence against an in-memory database, not an assertion.

sql_engine_status()

dbm_engine_status(probe_path)

Proves the embedded ndbm key-value engine is live: a real open/set/get/close sequence, not an assertion.

dbm_engine_status("/tmp/vstorage_audit_docs_dbm_probe")

archive_status(work_dir)

Proves the archive/compression container family is live: a real zip_create/zip_extract_all round-trip through real OS file paths, not an assertion.

archive_status("/tmp")

storage_owners(work_dir)

The full ownership map.

length(storage_owners("/tmp"))

storage_audit_summary(work_dir)

A plain map summary ({"total": N, "live": M}) for callers (including tests) that want the count without parsing report text.

storage_audit_summary("/tmp")["total"]

storage_audit_report(work_dir)

Human-readable report, the body of venutian storage-audit.

split_text(storage_audit_report("/tmp"), "\n")[0]

Get notified when vstorage-audit changes

Get notified about

New versions and security advisories.

New and updated packages, once a day.

News on the math model built in Venutian.