dqlite-wire
Pure-Python codec for the dqlite wire protocol — encode and decode the messages a dqlite server speaks.
dqlite is Canonical's distributed SQLite, built on Raft. This package implements the bytes-on-the-wire layer: it turns request/response objects into frames and back, following the official wire-protocol specification. It does no networking, pooling, or SQL — just framing.
Is this the package you want?
Probably not, unless you are building a driver or doing wire-level work (a proxy, traffic capture/replay, a custom client). If you just want to run SQL against dqlite from Python, use one of the higher layers — see The dqlite Python stack below.
Installation
pip install dqlite-wire
Requires Python 3.13+.
Usage
from dqlitewire import encode_message, decode_message
from dqlitewire.messages import LeaderRequest
# Encode a request to bytes
data = encode_message(LeaderRequest())
# Decode bytes back into a message object
message = decode_message(data, is_request=True)
The dqlite Python stack
This is the lowest of four layered packages. Each builds on the one below:
| Package | Role |
|---|---|
| sqlalchemy-dqlite | SQLAlchemy 2.0 dialect |
| dqlite-dbapi | PEP 249 (DB-API 2.0) driver — sync & async |
| dqlite-client | Async wire client — pooling, leader discovery |
| dqlite-wire — this package | Wire-protocol codec |
Most applications should use dqlite-dbapi or sqlalchemy-dqlite.
Documentation
- Thread-safety — codec objects are single-owner; read this before sharing one.
- Divergences from upstream — the defensive caps and stricter validations this codec adds on top of the C server and go-dqlite.
Development
See DEVELOPMENT.md for setup and contribution guidelines.
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for dqlite-wire 0.8.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 | Provenance | Actions |
|---|---|---|---|---|
| dqlite_wire-0.8.0.tar.gz | 229.3 kB | With provenance | Details for dqlite_wire-0.8.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| dqlite_wire-0.8.0-py3-none-any.whl | Python 3 | none | any | Details for dqlite_wire-0.8.0-py3-none-any.whl |
Total release size: 286.7 kB
Release files / dqlite_wire-0.8.0.tar.gz
| Download URL | dqlite_wire-0.8.0.tar.gz |
|---|---|
| Size | 229.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e54e697f7d8c76a65d867c7313fd1f4cf473dd8dce610ae467d044a942c96611
|
|
BLAKE2b-256 checksum How to use checksums |
354bde95ea1f011ab287c192ba40034e6d81053ff1ed49fe543a67b8bd2d7635
|
| 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 Sep 13, 2026.
Transparency logRelease files / dqlite_wire-0.8.0-py3-none-any.whl
| Download URL | dqlite_wire-0.8.0-py3-none-any.whl |
|---|---|
| Size | 57.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4fe299b53de361690c2ed4f0304967ffbbf33dd95a9d9848f265d22fa22953f4
|
|
BLAKE2b-256 checksum How to use checksums |
d24cd8fa431a827d346de2a2d0ffa0b636e9a42ea0f6c32d6a36f679b756ec8b
|
| 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 Sep 13, 2026.
Transparency logSecurity for dqlite-wire 0.8.0
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.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for dqlite_wire-0.8.0.tar.gz
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 Sep 13, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
