Yosoi Python SDK
Yosoi's Python package provides Pydantic authoring and typed outcomes over the public Rust SDK. The current Python surface includes documents, locator plans, typed Contracts, policy, asynchronous Requests, Map, Search, and caller-controlled cancellation. Python Contracts are bound to the Rust extraction and validation pipeline. Cross-language parity is tracked per public item; this package does not claim complete verified parity.
Pydantic models describe inputs and result values. The packaged PyO3 extension calls the public Rust SDK, which owns parsing, locator compilation and evaluation, acquisition and discovery, and complete policy validation. Python objects hold native handles; for example, a parsed document can be reused and closed explicitly or with a context manager. Pydantic 2 is the only declared Python runtime dependency; the native extension is part of the package.
Start with the runnable review examples to inspect Rust policy defaults, Contract schemas and evidence, local HTTP workflows, and network outcomes.
The earlier compatibility report records a local wheel matrix for the pre-Contract SDK snapshot. It does not verify the current Contract binding, CPython 3.14.8t, browser execution, all release platforms, or live Search providers. The public compatibility page records the current evidence boundary.
Interpreter targets and wheels
The package declares >=3.12,<3.16 and requires Pydantic >=2.14,<3.
Its interpreter targets are normal CPython 3.12–3.15, plus free-threaded
CPython 3.14.8t and 3.15.0t.
The native extension uses interpreter-specific wheels: cp312, cp313,
cp314, cp314t, cp315, and cp315t. These ABI tags do not promise a wheel for every
operating system or architecture. Check the artifacts for the release and
platform you plan to install.
Python CI is configured for all six targets. For each target it builds a wheel
from an sdist, installs that wheel, runs package checks, and requests the
policy, locate, contracts, and local examples. Workflow configuration
is not evidence of a completed hosted run or of published wheels for all
platforms. Local Search examples do not certify live providers.
Local workflow
Install one selected interpreter and the locked development environment from
the repository root. Substitute 3.13, 3.14, or the exact
3.14.8t, 3.15.0, or 3.15.0t selector to work with another target:
uv python install 3.12 3.13 3.14 3.14.8t 3.15.0 3.15.0t
uv sync --locked --python 3.12
For package checks that build and install a wheel from an sdist:
uv sync --locked --no-install-project --python 3.12
uv run --no-sync ruff check python
uv run --no-sync ruff format --check python
uv run --no-sync ty check python
interpreter=$(uv run --no-sync python -c 'import os, sys; print(os.path.realpath(sys.executable))')
CARGO_BUILD_JOBS=1 uv build --no-build-isolation --config-setting="build-args=--interpreter=$interpreter"
uv pip install --python .venv/bin/python --reinstall dist/*.whl
uv run --no-sync pytest
The build command produces an sdist and builds the wheel from it with the locked
development tools. Source builds need the Rust toolchain and native build
prerequisites. Use one Cargo worker. For iterative binding work,
uv sync --locked --python <interpreter> builds an editable installation.
The explicit resolved interpreter path keeps the normal and free-threaded
ABIs distinct when switching the project environment with a shared Cargo
target directory.
2 maintainers
Metadata
2 maintainers
Release files for yosoi 0.1.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 |
|---|---|---|---|---|
| yosoi-0.1.0.tar.gz | 2.2 MB | With provenance | Details for yosoi-0.1.0.tar.gz |
Built distributions (wheels)
Total release size: 160.5 MB
Release files / yosoi-0.1.0.tar.gz
| Download URL | yosoi-0.1.0.tar.gz |
|---|---|
| Size | 2.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d793b78f639784d6d5c11834f726afd2b7c8eaeb5745f225b4e54bfeede62e53
|
|
BLAKE2b-256 checksum How to use checksums |
8f59ea8142cd1d3401168845095047ebb541654f74696150a8f61918ea98d056
|
| 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 10, 2026.
Transparency logRelease files / yosoi-0.1.0-cp315-abi3.abi3t-win_amd64.whl
| Download URL | yosoi-0.1.0-cp315-abi3.abi3t-win_amd64.whl |
|---|---|
| Size | 9.9 MB |
| Tags | CPython 3.15 Windows x86-64 abi3 abi3t |
|
SHA-256 checksum How to use checksums |
2894abd2389ff64ce6314aa338faf32d66b1e2d8c4c9a02f733134a653db5bad
|
|
BLAKE2b-256 checksum How to use checksums |
62992bff3a9aab2ee127a49f38fdd27f988b2c07925420645234e416ac429fd4
|
| 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 10, 2026.
Transparency logRelease files / yosoi-0.1.0-cp315-abi3.abi3t-manylinux_2_28_x86_64.whl
| Download URL | yosoi-0.1.0-cp315-abi3.abi3t-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 11.2 MB |
| Tags | CPython 3.15 Linux glibc 2.28+ x86-64 abi3 abi3t |
|
SHA-256 checksum How to use checksums |
1ee7aa0c42c76950ebb792559e73abd6808157b1cfe93ea9116aae0c1356313d
|
|
BLAKE2b-256 checksum How to use checksums |
1d8a634a6630d33d59bfcf5c4180b5502ccce826e0ec0454535018b73f4c762e
|
| 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 10, 2026.
Transparency logRelease files / yosoi-0.1.0-cp315-abi3.abi3t-manylinux_2_28_aarch64.whl
| Download URL | yosoi-0.1.0-cp315-abi3.abi3t-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 11.5 MB |
| Tags | CPython 3.15 Linux glibc 2.28+ ARM64 abi3 abi3t |
|
SHA-256 checksum How to use checksums |
fbb8c1cd07641caf6656e51f1bd7043a6b852bb473ba65147a18e4033e88ade7
|
|
BLAKE2b-256 checksum How to use checksums |
509da0d8609365a6b4b83c73940008102d53052efa358accb050f159d31a9da5
|
| 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 10, 2026.
Transparency logRelease files / yosoi-0.1.0-cp315-abi3.abi3t-macosx_11_0_x86_64.whl
| Download URL | yosoi-0.1.0-cp315-abi3.abi3t-macosx_11_0_x86_64.whl |
|---|---|
| Size | 10.2 MB |
| Tags | CPython 3.15 abi3 abi3t macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
c11f6f91bc88c921987a24729d19d52ea713cfff4eada9fbd2e594c8b2a67a30
|
|
BLAKE2b-256 checksum How to use checksums |
e058645d81ec220c0753a90ae1684c3372d5375c90ffdf1eb7710f6dc8b44065
|
| 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 10, 2026.
Transparency logRelease files / yosoi-0.1.0-cp315-abi3.abi3t-macosx_11_0_arm64.whl
| Download URL | yosoi-0.1.0-cp315-abi3.abi3t-macosx_11_0_arm64.whl |
|---|---|
| Size | 10.1 MB |
| Tags | CPython 3.15 abi3 abi3t macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
68063d90760d1893ce13bca6b9def29f986a3a4aaabd6dc6fe477a7f8781a296
|
|
BLAKE2b-256 checksum How to use checksums |
f8ba2982518d531829213759beb08477ad73364caa61295d29ce15ab9ac50af7
|
| 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 10, 2026.
Transparency logRelease files / yosoi-0.1.0-cp314-cp314t-win_amd64.whl
| Download URL | yosoi-0.1.0-cp314-cp314t-win_amd64.whl |
|---|---|
| Size | 9.9 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Windows x86-64 |
|
SHA-256 checksum How to use checksums |
ed188900cdb58c744decaad2c6ea4bde10d6993abdf3bcef2b499a5673d00eab
|
|
BLAKE2b-256 checksum How to use checksums |
0e03a0004457a756fcf9c9fdc15f8430634a79fd4d4fb4e71dc2179f31ea08c8
|
| 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 10, 2026.
Transparency logRelease files / yosoi-0.1.0-cp314-cp314t-manylinux_2_28_x86_64.whl
| Download URL | yosoi-0.1.0-cp314-cp314t-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 11.1 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
580c9f424d90b043cab3d85dfb8c7c4bf69cf00a19e2e59ea58bf85651e3600b
|
|
BLAKE2b-256 checksum How to use checksums |
6e4395ed54ce70c343b5e0e5b9ddcc28882ac81d8d735ce7e72a8c659c79d440
|
| 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 10, 2026.
Transparency logRelease files / yosoi-0.1.0-cp314-cp314t-manylinux_2_28_aarch64.whl
| Download URL | yosoi-0.1.0-cp314-cp314t-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 11.4 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
fd9cbb85e8f39e37b3838998d88a23ac212b29afec4de32c9847d7e8208510c3
|
|
BLAKE2b-256 checksum How to use checksums |
e3ec786212af21686b104ff31b1bfa14d1d773e4e826b69f40f1d5a6970ac668
|
| 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 10, 2026.
Transparency logRelease files / yosoi-0.1.0-cp314-cp314t-macosx_11_0_x86_64.whl
| Download URL | yosoi-0.1.0-cp314-cp314t-macosx_11_0_x86_64.whl |
|---|---|
| Size | 10.2 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
f1092b5276a13ab24acad83e663e1e059647e816d82a5185e49fbcee989f3c52
|
|
BLAKE2b-256 checksum How to use checksums |
aff37151a6f0cf2e32befc11a68817e6b13015af1fb445367b36e0bb7013a018
|
| 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 10, 2026.
Transparency logRelease files / yosoi-0.1.0-cp314-cp314t-macosx_11_0_arm64.whl
| Download URL | yosoi-0.1.0-cp314-cp314t-macosx_11_0_arm64.whl |
|---|---|
| Size | 10.0 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
975d56f6ff5bcdfd2a3af797fe625e739472837ef904f8cd55c03c7607d82c16
|
|
BLAKE2b-256 checksum How to use checksums |
aed127aae2bfc9ed9cf7d0e2bcd26b74f3a4b3ad28bbe293c9075e87288be68a
|
| 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 10, 2026.
Transparency logRelease files / yosoi-0.1.0-cp312-abi3-win_amd64.whl
| Download URL | yosoi-0.1.0-cp312-abi3-win_amd64.whl |
|---|---|
| Size | 9.9 MB |
| Tags | CPython 3.12 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
0179bca4df6abbab2a092612edefa90b77be6d4f1c1cc69fc232d05233e43bbe
|
|
BLAKE2b-256 checksum How to use checksums |
0dd27f807b7052cf4703cfe7df10beb2300e28f8b3bcb24e71323e01cf44734d
|
| 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 10, 2026.
Transparency logRelease files / yosoi-0.1.0-cp312-abi3-manylinux_2_28_x86_64.whl
| Download URL | yosoi-0.1.0-cp312-abi3-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 11.1 MB |
| Tags | CPython 3.12 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
b192719ab0f948e931214a3ff5472a17226bb0c52b7436bf8bf487bc001a3f82
|
|
BLAKE2b-256 checksum How to use checksums |
e94e38245124957ec68649be946447c7f65c8f5581402166b7c8c7fe92b6c498
|
| 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 10, 2026.
Transparency logRelease files / yosoi-0.1.0-cp312-abi3-manylinux_2_28_aarch64.whl
| Download URL | yosoi-0.1.0-cp312-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 11.4 MB |
| Tags | CPython 3.12 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
d4e108fdc19d50e76d3f6799944794014219e8c79ccd2d3d18f408cefea6b3f2
|
|
BLAKE2b-256 checksum How to use checksums |
5d7eee2b8c64b2134a744f51dd3c5fd6f9dea467a397169f8ec47bbbc3c2a5b8
|
| 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 10, 2026.
Transparency logRelease files / yosoi-0.1.0-cp312-abi3-macosx_11_0_x86_64.whl
| Download URL | yosoi-0.1.0-cp312-abi3-macosx_11_0_x86_64.whl |
|---|---|
| Size | 10.2 MB |
| Tags | CPython 3.12 abi3 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
2b76c6c61029f859fb74e6716fa86c6d9fdacf4a73acdf53bdb79b518411c852
|
|
BLAKE2b-256 checksum How to use checksums |
b14fc1ed015fe2b47f708bc7dde1113758359d42263209edeac9c0c7351d4799
|
| 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 10, 2026.
Transparency logRelease files / yosoi-0.1.0-cp312-abi3-macosx_11_0_arm64.whl
| Download URL | yosoi-0.1.0-cp312-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 10.0 MB |
| Tags | CPython 3.12 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
96ae783b4d5fdd25d1cc0b901b7f6328aec950940d4d10aa8718316c4fbe7ca4
|
|
BLAKE2b-256 checksum How to use checksums |
370edb28c76ec435275ba2ed858d116d5bc7b01260b2ddb51d9c878bca890952
|
| 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 10, 2026.
Transparency logSecurity for yosoi 0.1.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 16 files in this release have been uploaded with provenance metadata.
Attestation for yosoi-0.1.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 10, 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.
