Repository navigation
Foldlite DB 0.3.0
Not published to PyPI. The release workflow correctly stopped when Windows validation found two test portability errors: default-locale decoding of the Unicode fixture and reading the exclusively locked log. The runtime compiled successfully. The corrections are published as 0.3.1; this 0.3.0 tag will remain unchanged.
Portable range and prefix queries are available in the native Python API, callback views, and browser worker. Key ordering is numeric and recursive across JSON types, and stable continuation tokens bind the complete selection.
Upgrade: existing 0.2.0 logs and compatible caches require no migration. Start a fresh query traversal after upgrading; existing snapshot/change cursors remain valid with a compatible cache. See the upgrade guide.
Queries
- Add ascending range queries with
start_key/end_keyand inclusive or
exclusive endpoints, plus string and structural arrayprefixselection. - Expose the same selectors in Python
query()/rows(), named callback views,
and the browser worker. Ranges return existing per-key results; query-time
reduction across selected keys is not implemented. - Order keys by JSON type, numbers numerically, strings by Unicode codepoint,
and compound keys recursively. This replaces serialized-JSON row ordering;
string collation is binary rather than CouchDB's ICU ordering. - Bind versioned query continuations to the complete selector and snapshot.
Preserve stable pages during ingestion and allow page-size changes. Reject
changed selectors and legacy query tokens explicitly. - Maintain a derived ordered native query index without changing canonical
group identity, ingestion order, or sequence allocation. Existing 0.2.0 logs
and compatible caches require no migration; snapshot/change cursors and
document pagination remain compatible. Start a fresh query traversal after
upgrading from 0.2.0.
Documentation
- Add this consolidated history and a dedicated upgrade guide with backup,
migration, verification, cutover, rollback, and compatibility steps. - Document range/prefix semantics, executable examples, and the 0.2.0-to-0.3.0
query compatibility steps. Include the changelog in source distributions.
Validation includes 340 Python tests, 22 real-Chromium tests, 61 Rust tests, 13 SDK tests, executable documentation and desktop/mobile checks, and a real 0.2.0 cache/cursor upgrade fixture. The release workflow builds and tests five native wheel platforms and the rebuilt source archive before PyPI publication. Distribution hashes and the publishing run will be attached as a receipt after verification.