#vellum

• 用 get、put、delete 读写数据。
• 一次事务可以修改多个键，最后统一 commit，或用 abort 撤销。
• 重新打开时自动恢复完整已提交的 WAL，并检查页结构。

#快速开始

import {
  "Nanaloveyuki/vellum@0.3.0",
}

import {
  "Nanaloveyuki/vellum",
  "moonbitlang/async",
}
pkgtype(kind: "executable")

async fn main {
  let db = @vellum.open("notes.db")
  defer db.close()
  let txn = db.begin()
  txn.put(b"hello", b"vellum")
  txn.commit()
  db.close()

  let again = @vellum.open("notes.db")
  defer again.close()
  let read = again.begin()
  match read.get(b"hello") {
    Some(value) => println(value.to_string())
    None => println("missing")
  }
  read.abort()
}

#事务与错误处理

1. 关闭当前 Db，不要直接重试提交。
2. 重新打开同一路径，让数据库完成恢复；打开失败时处理该错误。
3. 查询相关键，确认最终状态后再决定下一步操作。

#使用前须知

• 同一路径只打开一个 Db。 没有文件锁，同一进程或不同进程同时写入会损坏数据；没有并行读快照。
• open 会把整个库载入内存并验证结构，内存占用随库大小增长。删除后的空间会复用，但文件不会缩小。
• 固定 4096 字节页。单个 value 最多 4000 字节，且 key.length() + value.length() <= 4085；键和值不能跨页，分支分隔键也必须能放进页。超限抛 ValueTooLarge。
• 版本 1 的键序是 shortlex：先比较字节长度，长度相同再按字节比较，例如 b"z" 在 b"aa" 之前。get 返回独立拥有的值。
• 主文件与 WAL 都显式同步。恢复覆盖进程中断及日志记录页的部分写入，不能补回日志中没有的缺失页。首次创建的父目录项未同步，尚未验证整机掉电耐久性。
• 数据页没有 CRC，value 的位翻转不一定能检出；WAL 完整帧损坏会报 Corrupt，但格式 1 没有事务级页数或摘要，不能保证检出按完整帧边界丢失的日志。恢复不是备份。

#0.3.0

moon run src/cmd/bench --target native --release

#开发

moon fmt --check
moon check --target native --deny-warn
moon test --target native
moon test --target wasm-gc -p Nanaloveyuki/vellum

#许可证