Skip to main content

funcd-bundle

Bundles a Python funcd function for deployment: the handler, the exact versions of its runtime dependencies from uv.lock installed for the funcd runtime's Linux platform, and its contract file (funcd ADR-0247). funcdctl push turns the bundle into one OCI artifact.

uv add --dev funcd-bundle
uv run funcd-bundle                          # dist/<name>/ for linux/<host arch>
uv run funcd-bundle --platform linux/amd64   # from any host
funcdctl push dist/<name> <ref>                # entry main.py, contract dist/<name>/<name>.contract.yaml
  • Functions: each entry of [tool.funcd-bundle.functions] is a function, its name mapped to its entry, relative to the project root; without the table, the project is one function named after its directory, from src/main.py. funcdctl dev reads the same entries. An entry in a subdirectory is copied with its directory, so src/<name>/main.py lands as main.py, the entry funcdctl push assumes.
  • Contract: each function's <name>.contract.yaml (or .json) at the project root is copied to its bundle's root, where funcdctl push reads its runtime and contract. A function with neither, or both, fails. A funcdctl.yaml or <name>.funcdctl.yaml fails the build: nothing reads it any more.
[tool.funcd-bundle.functions]
orders = "src/orders/main.py"
orders-migrate = "src/orders-migrate/main.py"
  • Dependencies: uv export --frozen --no-dev of the project, without funcd-shim and the packages only it needs (the runtime ships them). Registry packages install as wheels only (--only-binary :all:) for CPython 3.14 and manylinux glibc 2.36, with their locked hashes. Workspace members are built as pure-Python wheels.
  • Check: the vendored modules the handler imports are imported in python:3.14-slim-bookworm for the target platform (--no-check skips it). A foreign platform needs QEMU on the Docker host.
  • Hermetic: --hermetic, or hermetic = true in [tool.funcd-bundle], installs with pip inside that image and then runs post-install, with FUNCD_BUNDLE_DIR and PYTHONPATH set to the bundle:
[tool.funcd-bundle]
hermetic = true
post-install = ["python", "scripts/install_extensions.py"]

Docker steps copy files in and out with docker cp and bind no host path.

Metadata

Release files for funcd-bundle 0.14.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for funcd-bundle 0.14.0
File Size Uploaded Provenance
funcd_bundle-0.14.0.tar.gz 36.1 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for funcd-bundle 0.14.0
File Interpreter ABI Platform
funcd_bundle-0.14.0-py3-none-any.whl Python 3 none any Details

Total release size: 45.8 kB

Release files / funcd_bundle-0.14.0.tar.gz

Download URL funcd_bundle-0.14.0.tar.gz
Size 36.1 kB
Tags Source
SHA-256 checksum
How to use checksums
e84d36f3996b2e9d829b608a3d43515b27999507b6bf546ce6054d5d88e66f3f
BLAKE2b-256 checksum
How to use checksums
414214bdd9373ba8593242058405991bada8986a9ffdef3502c2fb793103b585
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 19, 2026.

Transparency log

Release files / funcd_bundle-0.14.0-py3-none-any.whl

Download URL funcd_bundle-0.14.0-py3-none-any.whl
Size 9.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
60afe00a29d03b661f184c86cf5cc8474097861000e959b41cb037160cadffc5
BLAKE2b-256 checksum
How to use checksums
2c28c94a7031ceffcbe18fc2738d8e30099a90e89eb38a73a135478f45bbd24b
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 19, 2026.

Transparency log

Security for funcd-bundle 0.14.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.

Select from 2 files

Attestation for funcd_bundle-0.14.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 19, 2026.

Transparency log

A 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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page