darudb
The Python package of DaruDB, an embedded database that keeps an application's data in one local file. It is a native extension over the DaruDB engine, which is written in Rust, so the same file reads the same from Python, Rust, Node.js and Dart.
Installation
pip install darudb
The package needs CPython 3.11 or later. Wheels are built for Linux (glibc 2.17 or later, and musl), macOS and Windows, on x86-64 and ARM64, and for the free-threaded build of Python 3.14 as well, so installing it needs no Rust toolchain.
Usage
Each collection is a class. The decorator makes it a frozen, keyword-only dataclass, and its annotations are its fields' types; field adds an index, a primary key, a link or a default:
import darudb
from darudb import F, field, where
@darudb.collection("users")
class User:
id: int | None = None
name: str
email: str | None = field(default=None, unique=True)
age: int = field(default=0, index=True)
db = darudb.Database.open("app.darudb", schema=darudb.Schema(1, [User]))
with db.write() as txn:
txn.collection(User).insert_many([User(name="Alice", age=31), User(name="Bob", age=17)])
with db.read() as txn:
users = txn.collection(User)
adults = users.find(where(F.age >= 18).sort_by(F.age, descending=True).limit(10))
same = users.find("age >= $0 SORT BY age DESC LIMIT 10", 18)
db.close()
A write block commits when it ends and aborts when it raises, and db.write(durability="deferred") commits without waiting for the disk. An object read is an instance of its class. Every failure is a darudb.DaruError whose code is the engine's, the same string in every language DaruDB ships to.
The engine releases the GIL while it works, so other threads run while one waits for the disk. Every operation also has an asynchronous twin for asyncio, which runs the engine's work on a thread of the package's pool:
db = await darudb.Database.open_async("app.darudb", schema=darudb.Schema(1, [User]))
async with db.write_async() as txn:
await txn.collection(User).insert(User(name="Carol"))
async with db.read_async() as txn:
count = await txn.collection(User).count()
await db.close_async()
A program that opens a file it did not write needs no classes of its own. Opened without a schema, a database works with the one the file holds: db.stored_schema describes its collections, fields, keys and indexes, and the collections are reached by name, with objects read and written as dicts by the names the file stores, and the file's checks and indexes kept as ever.
with darudb.Database.open("app.darudb") as db, db.read() as txn:
for collection in db.stored_schema.collections if db.stored_schema else ():
print(collection.name, txn.collection(collection.name).count())
Raising the schema's version migrates the file when it opens, with renames, deletions and a Python function of your own. Encryption, the integrity check, backup, compaction and salvage are all there; the guide has the details.
License
1 maintainer
Metadata
1 maintainer
Release files for darudb 1.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| darudb-1.3.0.tar.gz | 493.3 kB | Details |
Built distributions (wheels)
Total release size: 18.1 MB
Release files / darudb-1.3.0.tar.gz
| Download URL | darudb-1.3.0.tar.gz |
|---|---|
| Size | 493.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9f40230370c2f23be630b380c7b13748aea775a557e66da1a9de1e6ccae283b8
|
|
BLAKE2b-256 checksum How to use checksums |
c38acfc732e5b872658f4bb0acb90b9c7c0c1e50592272c679773653eb0aa807
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / darudb-1.3.0-cp314-cp314t-win_arm64.whl
| Download URL | darudb-1.3.0-cp314-cp314t-win_arm64.whl |
|---|---|
| Size | 951.8 kB |
| Tags | CPython 3.14 CPython 3.14 free-threading Windows ARM64 |
|
SHA-256 checksum How to use checksums |
0f18561fa650f7b966c4d9ef6f258ee31239cca7324974bec024f09acd08039b
|
|
BLAKE2b-256 checksum How to use checksums |
34bfd3601684b9c302eabe0896be97ef84d054460fe8d0a7d522c7ab66dabca3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / darudb-1.3.0-cp314-cp314t-win_amd64.whl
| Download URL | darudb-1.3.0-cp314-cp314t-win_amd64.whl |
|---|---|
| Size | 1.0 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Windows x86-64 |
|
SHA-256 checksum How to use checksums |
1fc6decea16813adfd1d7715c00368d29fe877dd83a88af7c54091a65bcd504e
|
|
BLAKE2b-256 checksum How to use checksums |
9c5a23d70e8fe1abf3f4629fb5392c69d77787e9e2bd279e33f1e94cff722ba3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / darudb-1.3.0-cp314-cp314t-musllinux_1_2_x86_64.whl
| Download URL | darudb-1.3.0-cp314-cp314t-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
b7e5f40fe73f9af12b2d47e77da3853dedddb961a6b7263d7687f0e5a30c418e
|
|
BLAKE2b-256 checksum How to use checksums |
0d3b8894de19ca2267c02ac3e1dae6264146edac1e6ed168e93e9557c9d6d35e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / darudb-1.3.0-cp314-cp314t-musllinux_1_2_aarch64.whl
| Download URL | darudb-1.3.0-cp314-cp314t-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux musl 1.2+ ARM64 |
|
SHA-256 checksum How to use checksums |
38e7c8bd721c01a9ebd943f625560b5e6979537242f4beaca402799a7b37cc5a
|
|
BLAKE2b-256 checksum How to use checksums |
174deb4c9c4fa90dae20b694074a53f9168dcc0c52afc671adcce648e2165497
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / darudb-1.3.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | darudb-1.3.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
c203fa3836fafc36f1e64c034942e25b6fa3f5a59a907109940fe3492c29fb35
|
|
BLAKE2b-256 checksum How to use checksums |
0caea5ec1eeb4134848bdc67506d26dd2b041cfb49b37323242cc0184f504715
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / darudb-1.3.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | darudb-1.3.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 987.2 kB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
0dc58b2864c9bfb687979e483d0cf17c9a5b1e8a192c027de6a93973ad10f863
|
|
BLAKE2b-256 checksum How to use checksums |
26ad9c05cebb196c3862101fd4ac1a8c6893d7cd40ed1a0b8de4bbb331ac71bc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / darudb-1.3.0-cp314-cp314t-macosx_11_0_arm64.whl
| Download URL | darudb-1.3.0-cp314-cp314t-macosx_11_0_arm64.whl |
|---|---|
| Size | 956.2 kB |
| Tags | CPython 3.14 CPython 3.14 free-threading macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
f434fc6764ef44754980e4954f1b3fab81d7e1b63bb1bd6d707031adbede3be8
|
|
BLAKE2b-256 checksum How to use checksums |
91933ac701b7967d87d2a6e78030be046457e36167f2ccb83f7671fda42483f0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / darudb-1.3.0-cp314-cp314t-macosx_10_12_x86_64.whl
| Download URL | darudb-1.3.0-cp314-cp314t-macosx_10_12_x86_64.whl |
|---|---|
| Size | 1.0 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
008804fcd2fd61c739a101a40d0c64936ddb3781d8f01df392e4f56972f2891c
|
|
BLAKE2b-256 checksum How to use checksums |
fdf391558b071cd5a7a2f0ac62d4150dc679324b7c8326aa9a1693d683e83714
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / darudb-1.3.0-cp311-abi3-win_arm64.whl
| Download URL | darudb-1.3.0-cp311-abi3-win_arm64.whl |
|---|---|
| Size | 962.7 kB |
| Tags | CPython 3.11 Windows ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
dee049c2c7868da239d56d14fb5d40cca950ad0b5960a953801d1cc542dc2371
|
|
BLAKE2b-256 checksum How to use checksums |
1652a0332ef506f06a2ad233d4ed9241c00d36ab444a343b640c078488e62c3d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / darudb-1.3.0-cp311-abi3-win_amd64.whl
| Download URL | darudb-1.3.0-cp311-abi3-win_amd64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.11 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
701c6e2b7e05413b036d3184346ba4b2456392a9fd930cd3f00b317de6f2730c
|
|
BLAKE2b-256 checksum How to use checksums |
edeb03e62abf7b3bfaf9a9815554af5bc7ca4c51705373412b7ef618c1253ff6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / darudb-1.3.0-cp311-abi3-win32.whl
| Download URL | darudb-1.3.0-cp311-abi3-win32.whl |
|---|---|
| Size | 1.0 MB |
| Tags | CPython 3.11 Windows x86-32 abi3 |
|
SHA-256 checksum How to use checksums |
609d5de96e1e39e36851f8c3f0fe2649655567a70f8cf7d96881e19f279ad40f
|
|
BLAKE2b-256 checksum How to use checksums |
d9eab342663ec5b2b18d9b29fc298bc71404065466a2626bd3e932e247b07433
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / darudb-1.3.0-cp311-abi3-musllinux_1_2_x86_64.whl
| Download URL | darudb-1.3.0-cp311-abi3-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.11 Linux musl 1.2+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
a6b1954b097b06da883c89bb2a322269c2ae58bed1f8d531bac07eb36fe2ddd5
|
|
BLAKE2b-256 checksum How to use checksums |
21afb1df5fe4d9bc55c7cae9a82e4f834f7155e673e7c25012bb55a53c30996c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / darudb-1.3.0-cp311-abi3-musllinux_1_2_aarch64.whl
| Download URL | darudb-1.3.0-cp311-abi3-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.11 Linux musl 1.2+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
9ab3ec8abb26f3dfa6ee7cf5aca0b228598e1b0bb5ccf2a072dc6981d9b25c74
|
|
BLAKE2b-256 checksum How to use checksums |
f2e98f50be3db3b8d2f11fb499b93186181d935c4a33cf4f594b8d8f57bbf402
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / darudb-1.3.0-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | darudb-1.3.0-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
a347da8fc9ce1d805502517cfbd8d0891c7ddb3a67099e2ad272088781f9eff6
|
|
BLAKE2b-256 checksum How to use checksums |
1c163e6dca0f28895608e10a25226309884b28505e8f98bf332e5dfb04dce9c5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / darudb-1.3.0-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | darudb-1.3.0-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 993.9 kB |
| Tags | CPython 3.11 Linux glibc 2.17+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
7ce0cb4003756a75d0142a721bcffaa65fbf42d20192457e9f2f048c68380d18
|
|
BLAKE2b-256 checksum How to use checksums |
92b0f2f4db02f521130ceb2f599bc37bd42714d71c31b545ef9728a2e7442614
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / darudb-1.3.0-cp311-abi3-macosx_11_0_arm64.whl
| Download URL | darudb-1.3.0-cp311-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 966.3 kB |
| Tags | CPython 3.11 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
a1d0efa46d00eaf58877394e75ec0c5b46e8fc5f982fccf1cd2c93b1228188e4
|
|
BLAKE2b-256 checksum How to use checksums |
962a25f5f2417814405ed0c8e62d6aee3f28673b6f44f068269643ca3bf7215a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / darudb-1.3.0-cp311-abi3-macosx_10_12_x86_64.whl
| Download URL | darudb-1.3.0-cp311-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 1.0 MB |
| Tags | CPython 3.11 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
b15ee89e98f39eb757096c0344079607f3a6b891f0ec5eae674becbe6f0f0cf1
|
|
BLAKE2b-256 checksum How to use checksums |
53b9123578a4f28b3292d4302261278d039a73ba8a1ec277746e46edd653b5fc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency log
