sqlite-vfs 0.2.0

Build SQLite virtual file systems (VFS) by implementing a simple Rust trait.
Documentation
  • Coverage
  • 73.58%
    39 out of 53 items documented0 out of 29 items with examples
  • Size
  • Source code size: 252.69 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 4.55 MB This is the summed size of all files generated by rustdoc for all configured targets
  • Ø build duration
  • this release: 15s Average build duration of successful builds.
  • all releases: 15s Average build duration of successful builds in releases after 2024-10-23.
  • Links
  • rkusa/sqlite-vfs
    100 13 3
  • crates.io
  • Dependencies
  • Versions
  • Owners
  • rkusa

sqlite-vfs

Build SQLite virtual file systems (VFS) by implementing a simple Rust trait.

Documentation | Example

This library is build for my own use-case. It doesn't expose everything a SQLite VFS provides (e.g. memory mapped files). Feel free to propose additions if the current state doesn't work for your use-case.

Status

This library is still in prototype state and not ready to be used (except for maybe prototypes). While progress will be slow, it is actively worked on.

  • ✅ It passes most of SQLite's TCL test harness.
    • ⚠️ CI only runs full.test and not all.test.
    • ⚠️ Some tests are skipped.
  • ✅ Successfully runs experiments like do-sqlite.
  • ⚠️ It uses unsafe Rust, which hasn't been peer-reviewed yet.
  • ⚠️ It is not used in any production-capacity yet.

Limitations

  • WAL is not supported (but in progress)
  • Memory mapping not supported (xFetch/xUnfetch)
  • Loading extensions not supported (xDl*)
  • Tests run only on UNIX right now (due to std::os::unix usage in tests)
  • Directory sync is not supported
  • Sector size is always 1024
  • Custom device characteristic are not supported (xDeviceCharacteristics)