sharedbox
sharedbox lets several Python processes share one record, as if they all
held the same dataclass. You declare the fields once, and every process that
opens the record reads and writes the same values in shared memory, so no
process has to send them to another.
Installation
sharedbox needs CPython 3.11 or newer on Windows x64 or Linux x86_64. PyPI
has compiled wheels, so you don't need a compiler:
pip install sharedbox
or, in a project that uv manages:
uv add sharedbox
Quick start
import multiprocessing as mp
from typing import Annotated
from sharedbox import Capacity, SharedBox
class Motor(SharedBox):
position: int
enabled: bool
label: Annotated[str, Capacity(32)]
def worker() -> None:
motor = Motor.attach() # finds the box by its class
motor.position = 10
motor.close()
if __name__ == "__main__":
with Motor(1, False, "x-axis") as motor:
motor.events.position.connect(lambda new, old: print(old, "->", new))
child = mp.Process(target=worker)
child.start()
child.join() # prints: 1 -> 10
Motor.unlink()
The child finds the box by its class alone, and the parent prints the change as soon as the child makes it.
Documentation
The documentation site starts with three tutorials, then has how-to guides, explanations of how a box works, and the API reference. C and C++ code can use a box too, either handed over from Python or opened by name; the C and C++ guides show how.
Development
To change sharedbox itself you need git, uv, CMake 3.30 or newer and a
C++20 compiler (MSVC or GCC):
git clone https://github.com/jacopoabramo/sharedbox.git
cd sharedbox
uv sync --dev
uv run pytest
How to set up a development environment has the details.
License
Licensed under Apache 2.0
1 maintainer
Metadata
1 maintainer
Release files for sharedbox 0.5.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 | |
|---|---|---|---|---|
| sharedbox-0.5.0.tar.gz | 530.0 kB | With provenance | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| sharedbox-0.5.0-cp314-cp314t-win_amd64.whl | CPython 3.14 | CPython 3.14 free-threading | Windows x86-64 | Details |
| sharedbox-0.5.0-cp314-cp314t-musllinux_1_2_x86_64.whl | CPython 3.14 | CPython 3.14 free-threading | Linux musl 1.2+ x86-64 | Details |
| sharedbox-0.5.0-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl | CPython 3.14 | CPython 3.14 free-threading | Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 | Details |
| sharedbox-0.5.0-cp312-abi3-win_amd64.whl | CPython 3.12 | abi3 | Windows x86-64 | Details |
| sharedbox-0.5.0-cp312-abi3-musllinux_1_2_x86_64.whl | CPython 3.12 | abi3 | Linux musl 1.2+ x86-64 | Details |
| sharedbox-0.5.0-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl | CPython 3.12 | abi3 | Linux glibc 2.27+ x86-64, Linux glibc 2.28+ x86-64 | Details |
| sharedbox-0.5.0-cp311-cp311-win_amd64.whl | CPython 3.11 | CPython 3.11 | Windows x86-64 | Details |
| sharedbox-0.5.0-cp311-cp311-musllinux_1_2_x86_64.whl | CPython 3.11 | CPython 3.11 | Linux musl 1.2+ x86-64 | Details |
| sharedbox-0.5.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 |
Total release size: 4.4 MB
Release files / sharedbox-0.5.0.tar.gz
| Download URL | sharedbox-0.5.0.tar.gz |
|---|---|
| Size | 530.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b7574ce28ecdcbc18b2af829a4df1b60b04dbc068e7c1344ce843239d45cd23f
|
|
BLAKE2b-256 checksum How to use checksums |
c7d947c7dd5f6c3ac86f08e2a48212be000f937d4b3f4e9410f8b4998d7d386c
|
| 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 8, 2026.
Transparency logRelease files / sharedbox-0.5.0-cp314-cp314t-win_amd64.whl
| Download URL | sharedbox-0.5.0-cp314-cp314t-win_amd64.whl |
|---|---|
| Size | 534.4 kB |
| Tags | CPython 3.14 CPython 3.14 free-threading Windows x86-64 |
|
SHA-256 checksum How to use checksums |
fce5b82a6bcbc8fc6f88fd895aec0f6dc7015eead58566a333e4268ff4e9d0d9
|
|
BLAKE2b-256 checksum How to use checksums |
e30a18364bee8377d13c62a05986bb7eb8bbc5d0b180d93ade34217970cc2678
|
| 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 8, 2026.
Transparency logRelease files / sharedbox-0.5.0-cp314-cp314t-musllinux_1_2_x86_64.whl
| Download URL | sharedbox-0.5.0-cp314-cp314t-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 428.2 kB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
925f5efa110b83a6f9eaad9b365b96feb5ffdfac2eaa06a30b01ba24bfdfa00f
|
|
BLAKE2b-256 checksum How to use checksums |
3fa3d37f5d464f878de3fc4b624e5336b700996cbb008bb7c697f08dcd13aba2
|
| 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 8, 2026.
Transparency logRelease files / sharedbox-0.5.0-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | sharedbox-0.5.0-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 329.2 kB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
b4f4bb6183021403670411dc0e6eccf4bc159ef94c368cdad70c4647fd4103ed
|
|
BLAKE2b-256 checksum How to use checksums |
e8dba6f043a9948630f2502316c56851c33e8ab241aa0fb58c42f5fdfacc5983
|
| 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 8, 2026.
Transparency logRelease files / sharedbox-0.5.0-cp312-abi3-win_amd64.whl
| Download URL | sharedbox-0.5.0-cp312-abi3-win_amd64.whl |
|---|---|
| Size | 519.8 kB |
| Tags | CPython 3.12 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
222dbd54175d4853d7103c8c17c3fb32d4b1be0843f1fbd69fec58ba86daaec3
|
|
BLAKE2b-256 checksum How to use checksums |
992e9f7fd28a45820a3f38c55d3ca93d2b1c0a3f618a6ca777b48855e97344dc
|
| 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 8, 2026.
Transparency logRelease files / sharedbox-0.5.0-cp312-abi3-musllinux_1_2_x86_64.whl
| Download URL | sharedbox-0.5.0-cp312-abi3-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 421.8 kB |
| Tags | CPython 3.12 Linux musl 1.2+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
885cca0acd3068451c39dc56b48cc809727b3562f21c5b978c62ef18ed16b4e0
|
|
BLAKE2b-256 checksum How to use checksums |
f39c0e390963ca928c46bd624f703e3eb032797c098d3b6f9646aecc4df5f129
|
| 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 8, 2026.
Transparency logRelease files / sharedbox-0.5.0-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | sharedbox-0.5.0-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 323.7 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 |
35af87b521afdcb4302af24dd5cf62979d0902523e0819287ebe2909b02a8939
|
|
BLAKE2b-256 checksum How to use checksums |
f4d9526a75b657d3428fbeca83adb10e206286b6fe8eea8ec240e5eac7561871
|
| 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 8, 2026.
Transparency logRelease files / sharedbox-0.5.0-cp311-cp311-win_amd64.whl
| Download URL | sharedbox-0.5.0-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 519.7 kB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
f0c10af5a4a97559f5a070b7d249d1e6f50ddb2bcbedc8688666be37875ff15d
|
|
BLAKE2b-256 checksum How to use checksums |
26ae6fd76cdb28a2e1515cbbc8b512581aca3b14b08d5074e29dd160fa909d43
|
| 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 8, 2026.
Transparency logRelease files / sharedbox-0.5.0-cp311-cp311-musllinux_1_2_x86_64.whl
| Download URL | sharedbox-0.5.0-cp311-cp311-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 425.4 kB |
| Tags | CPython 3.11 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
161afbab710a232590db442d561e22c042dce209ce5ba53157ce2f92e8a71f56
|
|
BLAKE2b-256 checksum How to use checksums |
8148f36523622f2068481ee16c7b6f5122dee48c8db9f78ffaf5566f1558e732
|
| 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 8, 2026.
Transparency logRelease files / sharedbox-0.5.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | sharedbox-0.5.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 327.7 kB |
| Tags | CPython 3.11 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
8b174ea97b29a4dd2f46987b8b6d147af269c910429c1ce1e6c377e30c35e98b
|
|
BLAKE2b-256 checksum How to use checksums |
b7d9ac895faa1a32c7b702b6ea916a2b05d4d6c05066f07dacfe9e485bb6ac06
|
| 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 8, 2026.
Transparency logSecurity for sharedbox 0.5.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 10 files in this release have been uploaded with provenance metadata.
Attestation for sharedbox-0.5.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 Oct 8, 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.
