ODIN-Stream
A data streaming utility designed as an extension to the odin object dictionary.
How it works
This library is designed to stream out data. It separates the data into two packets, an identifier packet and a data packet. The identifier packet contains the metadata of the data packets, and the data packets contain the actual data. These packets can be send at different rates, and the identifier packet can be sent less frequently than the data packets to save bandwidth.
Packet definition
Common header The header contains the following content:
type: The type of the identifier packet, must be 1id: The id of packet content, this is must be unique for each packet definition, and is used to identify the packet content in the data stream.
Identifier packet type=0x01
This packet contains the required metadata to process the data packets. They are sent less frequently than the data packets to save bandwidth.
In addition to the common header, the header contains the following content:
od_identifier: The identifier of the odin packet, this marks which Od definition is used.
There remaining data in the packet contains a fixed list of identifiers, each of which is a tuple of the following:
id: Ths id of the entry as referenced in odinsize: The size of the entry in bytes as it will be encoded in the data stream
Data packet type=0x02
This packet contains the data which is streamed out.
In addition to the common header, the header contains the following content:
timestamp: The timestamp of the packet, this is used to identify the time when the packet was sent.sequence: The sequence number of the packet, this is used to identify the order of the packets.
There remaining data in the packet contains the data in a specific order, which is defined in the identifier packet.
Event packet type=0x0B
This packet contains custom event data which can be streamed out. Details of the events need to br predefined on both sides of the stream.
Prebuilt Wheels
Prebuilt wheels are available for Windows, Linux and MacOS, they can be installed using pip:
pip install odin-stream
From Source
Note: You need a valid C++ compiler and Python 3.7+ installed on your system.
Basic installation
uv pip install --reinstall -ve .
Fast build
uv pip install --reinstall --no-build-isolation -ve .
Auto rebuild on run
uv pip install --reinstall --no-build-isolation -Ceditable.rebuild=true -ve .
WIP
pip install --no-build-isolation -Ceditable.rebuild=true -ve .
Python Stub files generation
They are generated automatically buy can also be generated
python -m nanobind.stubgen -m odin_stream
Test
pytest test
Release
Create wheel
uv run pip wheel . --wheel-dir ./dist --no-deps --no-build-isolation -v
Metadata
Release files for odin-stream 0.2.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 |
|---|---|---|---|---|
| odin_stream-0.2.0.tar.gz | 1.4 MB | With provenance | Details for odin_stream-0.2.0.tar.gz |
Built distributions (wheels)
Total release size: 3.7 MB
Release files / odin_stream-0.2.0.tar.gz
| Download URL | odin_stream-0.2.0.tar.gz |
|---|---|
| Size | 1.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9e560a1202daefee3b28326547e6881b750e1f8160b34525b2a19e6f88d39ed7
|
|
BLAKE2b-256 checksum How to use checksums |
0923829362821cc78d560ee75bee200e4eba7b23c5d213474477c81cff20ba3a
|
| 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 1, 2026.
Transparency logRelease files / odin_stream-0.2.0-cp312-abi3-win_amd64.whl
| Download URL | odin_stream-0.2.0-cp312-abi3-win_amd64.whl |
|---|---|
| Size | 334.7 kB |
| Tags | CPython 3.12 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
e0f8249ee87b6eaaa830ab985236d12c930a0370ccc0241b08a27b9f6261d5c2
|
|
BLAKE2b-256 checksum How to use checksums |
b38c6ef08b32dc1af8f0529d9122dcd292b1d92ccf113b43446ba99ee867d812
|
| 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 1, 2026.
Transparency logRelease files / odin_stream-0.2.0-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | odin_stream-0.2.0-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 163.8 kB |
| Tags | CPython 3.12 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
ea8ec85db518def9a5f965d5e77868a8e87ee19974a37baccda0f80bda429083
|
|
BLAKE2b-256 checksum How to use checksums |
43123d24686b0518ae10fa7ebfda63b0fdfc4690b59f2feddc8627e1f67b3a46
|
| 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 1, 2026.
Transparency logRelease files / odin_stream-0.2.0-cp312-abi3-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
| Download URL | odin_stream-0.2.0-cp312-abi3-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 152.0 kB |
| Tags | CPython 3.12 Linux glibc 2.26+ ARM64 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
1fbaae365999800f015b03c64854f70afc91f6518d015f09279f510b4cfffafc
|
|
BLAKE2b-256 checksum How to use checksums |
cc86ede09f0e07755eed753ab95a13a360e729fd844fc351e8ed75347eaf8240
|
| 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 1, 2026.
Transparency logRelease files / odin_stream-0.2.0-cp312-abi3-macosx_11_0_arm64.whl
| Download URL | odin_stream-0.2.0-cp312-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 116.4 kB |
| Tags | CPython 3.12 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
aa5bd9d1118744186684e554014deec2df244aa14e757e9a3cec4820c26e69d6
|
|
BLAKE2b-256 checksum How to use checksums |
badd2f16f6df6b9cf91db4c5f0b384adabaa26382bd21b74adbcd1e76501d60f
|
| 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 1, 2026.
Transparency logRelease files / odin_stream-0.2.0-cp311-cp311-win_amd64.whl
| Download URL | odin_stream-0.2.0-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 335.1 kB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
12dacae9ec1b6145c07ab169c007c0eabf6c3ae297e84ba2e3561fc726bf01bb
|
|
BLAKE2b-256 checksum How to use checksums |
6aef4e509c3a779dd5faba9b954e4a17c3a7dd8016e51fc399b5873d1944fae9
|
| 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 1, 2026.
Transparency logRelease files / odin_stream-0.2.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | odin_stream-0.2.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 168.0 kB |
| Tags | CPython 3.11 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
536fffa7449d87ffcc18138b6f649fa1f3209d83eaf8c130dfad542669837467
|
|
BLAKE2b-256 checksum How to use checksums |
ada716a317afafeed32f11b8bfaa1f74cb052fc604819940d7f92bf38128a35c
|
| 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 1, 2026.
Transparency logRelease files / odin_stream-0.2.0-cp311-cp311-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
| Download URL | odin_stream-0.2.0-cp311-cp311-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 155.6 kB |
| Tags | CPython 3.11 Linux glibc 2.26+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
d832ba7363a2d42802a8d8e097439d0bb65b1283fc199af5dcc732284fcd677d
|
|
BLAKE2b-256 checksum How to use checksums |
989f17efaccdc09ab929b2a2e61ebb2b409fcb90d832e66c3bf2982728e2e557
|
| 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 1, 2026.
Transparency logRelease files / odin_stream-0.2.0-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | odin_stream-0.2.0-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 118.0 kB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
44bbd4d4db0517117f408c45476613f5ae8bbb472d1143d22310856a8d1ec139
|
|
BLAKE2b-256 checksum How to use checksums |
daed014a286e33b1207d671b4445fe619b635dfd366ad23edfa2f1563c1a1c97
|
| 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 1, 2026.
Transparency logRelease files / odin_stream-0.2.0-cp310-cp310-win_amd64.whl
| Download URL | odin_stream-0.2.0-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 334.8 kB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
5c7368125d0587d968ce818823e3b0e1bf5ce92e63dc8cae7bab1e0def35ad39
|
|
BLAKE2b-256 checksum How to use checksums |
17ed01b646e9bc7d5cf41fa1ac3f403217bd2c0f2904e6ef5de2d0427cb7fbd8
|
| 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 1, 2026.
Transparency logRelease files / odin_stream-0.2.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | odin_stream-0.2.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 168.2 kB |
| Tags | CPython 3.10 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
9214f9a62032598777d760d0fdf522e53a22c7305220e6dbe948ccb0eceb259c
|
|
BLAKE2b-256 checksum How to use checksums |
f7ecd2f8091204d1330d988bb31f8bf7bf3f089f9c854fbbd8248c0aadac4cd4
|
| 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 1, 2026.
Transparency logRelease files / odin_stream-0.2.0-cp310-cp310-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
| Download URL | odin_stream-0.2.0-cp310-cp310-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 156.2 kB |
| Tags | CPython 3.10 Linux glibc 2.26+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
874139fee0cd6de8cc5cbf9d657bc3ed3a190ae6ab5776fd3a696ecddd2aa5ce
|
|
BLAKE2b-256 checksum How to use checksums |
0a9dd66cea86b1b3660cef10301bb05ada775dd58032c14bc42c12217b40949b
|
| 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 1, 2026.
Transparency logRelease files / odin_stream-0.2.0-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | odin_stream-0.2.0-cp310-cp310-macosx_11_0_arm64.whl |
|---|---|
| Size | 118.2 kB |
| Tags | CPython 3.10 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
db4d8d30e308e03ae88eeda6d8330ce0f0a1621883fbebd0e70fc1782200f609
|
|
BLAKE2b-256 checksum How to use checksums |
0c06ad58a4eff3816c9b366f6716bada72af947f3cd7b77a0ab969ac370f11cf
|
| 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 1, 2026.
Transparency logSecurity for odin-stream 0.2.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 13 files in this release have been uploaded with provenance metadata.
Attestation for odin_stream-0.2.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 1, 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.