duck-leveldb

Cross-platform LevelDB 接口，自动选择可用后端：plyvel（优先）→ ctypes + leveldb.dll（回退）。

Windows / Linux / macOS 均可使用，无需手动配置后端。

安装

pip install duck-leveldb

Windows 下 ctypes 模式需要 leveldb.dll，已内置在包中。如果不想内置，可通过 LEVELDB_DLL 环境变量指定路径。

快速开始

from duck_leveldb import LevelDB

with LevelDB("/tmp/my.db", create=True) as db:
    db.put(b"hello", b"world")
    print(db.get(b"hello"))  # b"world"

    db.delete(b"hello")
    print(db.get(b"hello"))  # None

API

LevelDB

Iterator

with db.iterator() as it:
    # 正向遍历
    for k, v in it:
        print(k, v)

    # 反向遍历
    it.seek_to_last()
    while it.valid():
        print(it.key(), it.value())
        it.prev()

    # 定位到指定 key
    it.seek(b"target")

后端

开发

# 测试
python scripts/run_tests.py

# 仅测试，跳过覆盖率
python scripts/run_tests.py --no-cov

# 按关键字筛选
python scripts/run_tests.py -k iterator

# 打包
python scripts/publish.py --build-only

# 发布到 PyPI
python scripts/publish.py

# 发布到 TestPyPI
python scripts/publish.py --repo testpypi

发布前需在 scripts/pypi_config.toml 中填入 PyPI token（参考 scripts/pypi_config.toml.example）。