Skip to content

Foldlite DB 0.3.0

Choose a tag to compare

@martyn martyn released this 03 Nov 05:54
99ff520

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_key and inclusive or
    exclusive endpoints, plus string and structural array prefix selection.
  • 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.