visio-schema
The wire contract for the Visio sensor ecosystem: the generated protobuf
message bindings plus a small, hand-written framing codec, packaged so you can
read a live device or a recording with one pip install. It is the single
source of truth for what Visio data looks like on the wire; the transport,
bus, and recording stack live in a separate layer.
Imported as visio_schema. Full docs, the wire spec, and C++ sources are in the
GitHub repository.
Install
pip install visio-schema
One install includes MCAP read/write (read_mcap / McapWriter) and the
visio-display live viewer — no extras to choose. Released wheels (Linux
manylinux_2_28 x86_64, macOS universal2, CPython 3.10–3.13) bundle an optional
native reader for higher throughput. If no wheel matches your platform, the sdist
installs a pure-Python reader with identical behavior — only throughput differs.
Quickstart
from visio_schema import read_serial, read_mcap, message_class
# live device -> (Message, Channel) rows
for msg, ch in read_serial("/dev/ttyACM0"):
cls = message_class(ch.schema_name) # resolve the payload type
payload = cls.FromString(msg.payload)
print(ch.topic, payload)
# replay a recording
for msg, ch in read_mcap("run.mcap"):
...
Send commands and read replies with serial_endpoint(...) + command_message.
See usage.md
for the three end-to-end recipes.
visio-display viewer
The package installs a visio-display console command that reads a live device
(serial or TCP) or replays an MCAP, and fans it out to a live
Foxglove WebSocket, a live Rerun
viewer, and/or an MCAP recording:
visio-display --serial /dev/ttyACM0 --rerun
visio-display --tcp my-device.local --foxglove
visio-display --mcap-in run.mcap --rerun
# also runnable as: python -m visio_schema.display
License
MIT — see LICENSE.
1 maintainer
Metadata
1 maintainer
Release files for visio-schema 0.9.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 | |
|---|---|---|---|
| visio_schema-0.9.0.tar.gz | 571.4 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| visio_schema-0.9.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl | CPython 3.13 | CPython 3.13 | Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 | Details |
| visio_schema-0.9.0-cp313-cp313-macosx_11_0_universal2.whl | CPython 3.13 | CPython 3.13 | macOS 11.0+ universal2 (ARM64, x86-64) | Details |
| visio_schema-0.9.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 | Details |
| visio_schema-0.9.0-cp312-cp312-macosx_11_0_universal2.whl | CPython 3.12 | CPython 3.12 | macOS 11.0+ universal2 (ARM64, x86-64) | Details |
| visio_schema-0.9.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl | CPython 3.11 | CPython 3.11 | Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 | Details |
| visio_schema-0.9.0-cp311-cp311-macosx_11_0_universal2.whl | CPython 3.11 | CPython 3.11 | macOS 11.0+ universal2 (ARM64, x86-64) | Details |
| visio_schema-0.9.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl | CPython 3.10 | CPython 3.10 | Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 | Details |
| visio_schema-0.9.0-cp310-cp310-macosx_11_0_universal2.whl | CPython 3.10 | CPython 3.10 | macOS 11.0+ universal2 (ARM64, x86-64) | Details |
Total release size: 12.8 MB
Release files / visio_schema-0.9.0.tar.gz
| Download URL | visio_schema-0.9.0.tar.gz |
|---|---|
| Size | 571.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c3882206fe6552c022f313a52925cf3c7acb2df493438440ea8f0efe909f0808
|
|
BLAKE2b-256 checksum How to use checksums |
01749eb0b312354b9cbeb6657dc36a531f31590fe1d1efea083d66234f52f20f
|
| 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 11, 2026.
Transparency logRelease files / visio_schema-0.9.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | visio_schema-0.9.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.13 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
e8045bf171ba6d53855d994bf34516833d9ba450381ed4169f876ccd49d8bd25
|
|
BLAKE2b-256 checksum How to use checksums |
cad380f01978cdaa4dea363fc6b53c1e760d15ebdea6494cf8c067aff85da146
|
| 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 11, 2026.
Transparency logRelease files / visio_schema-0.9.0-cp313-cp313-macosx_11_0_universal2.whl
| Download URL | visio_schema-0.9.0-cp313-cp313-macosx_11_0_universal2.whl |
|---|---|
| Size | 628.7 kB |
| Tags | CPython 3.13 macOS 11.0+ universal2 (ARM64, x86-64) |
|
SHA-256 checksum How to use checksums |
97bd9924f60d3e7e3050c83779d22711944918fc64d17fd56f50e1035b14986e
|
|
BLAKE2b-256 checksum How to use checksums |
80e3474b88156633e1cdf97e312124fab865af8d7aa1b89897a74eb975ed0def
|
| 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 11, 2026.
Transparency logRelease files / visio_schema-0.9.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | visio_schema-0.9.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.12 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
ea817bb4b8276523ca924af409602f9c723abaac5ad8d9fe084cecc409b2987e
|
|
BLAKE2b-256 checksum How to use checksums |
96bf293bea9961d061faa365d0bd9352b945fb2543af3030ca13330792f2e537
|
| 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 11, 2026.
Transparency logRelease files / visio_schema-0.9.0-cp312-cp312-macosx_11_0_universal2.whl
| Download URL | visio_schema-0.9.0-cp312-cp312-macosx_11_0_universal2.whl |
|---|---|
| Size | 628.5 kB |
| Tags | CPython 3.12 macOS 11.0+ universal2 (ARM64, x86-64) |
|
SHA-256 checksum How to use checksums |
484bc33a3cfdcb4dd09ecd870c656be80df3d08a888b6c783cfbbff436223901
|
|
BLAKE2b-256 checksum How to use checksums |
9020d45fc751779a03840efecb264e5b538e66cd5ba457fbffa7f215d466c305
|
| 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 11, 2026.
Transparency logRelease files / visio_schema-0.9.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | visio_schema-0.9.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.11 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
d94313d7ed5aee111a565606ed416a22d9b8b9e8faf12326631c775c6abf5007
|
|
BLAKE2b-256 checksum How to use checksums |
a93b29a52fda56db8c3f93a0ebd08f72150647613d4daa554fca63a277d7dc91
|
| 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 11, 2026.
Transparency logRelease files / visio_schema-0.9.0-cp311-cp311-macosx_11_0_universal2.whl
| Download URL | visio_schema-0.9.0-cp311-cp311-macosx_11_0_universal2.whl |
|---|---|
| Size | 624.6 kB |
| Tags | CPython 3.11 macOS 11.0+ universal2 (ARM64, x86-64) |
|
SHA-256 checksum How to use checksums |
5ebeb23ab1d188465e2a29831b85415b25fa39e180cc9e721419a5b3694be25d
|
|
BLAKE2b-256 checksum How to use checksums |
db829cde51d56898713ffc341d2216d80db9c40da4fe3280a9331283a4b472b9
|
| 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 11, 2026.
Transparency logRelease files / visio_schema-0.9.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | visio_schema-0.9.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.10 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
b91a91c0f28c5e9b06f09507d5c6344dcf46c93e91f02726837572539a7eece0
|
|
BLAKE2b-256 checksum How to use checksums |
647590c31f59d4cd243c1dffe27a9c4fc3fd6f3af4c82c7613946e0d7480a512
|
| 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 11, 2026.
Transparency logRelease files / visio_schema-0.9.0-cp310-cp310-macosx_11_0_universal2.whl
| Download URL | visio_schema-0.9.0-cp310-cp310-macosx_11_0_universal2.whl |
|---|---|
| Size | 622.2 kB |
| Tags | CPython 3.10 macOS 11.0+ universal2 (ARM64, x86-64) |
|
SHA-256 checksum How to use checksums |
a3c2865113676adcddf48c000695eaa96044c6ec57c4429db7b9bb15b2725579
|
|
BLAKE2b-256 checksum How to use checksums |
e72faa6a0652097713726dede9cca4ed3efdc18a2fc22d72955b91fffabcc984
|
| 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 11, 2026.
Transparency log
