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.17.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.17.0
File Size Uploaded Provenance Actions
funcd_bundle-0.17.0.tar.gz 36.1 kB With provenance Details for funcd_bundle-0.17.0.tar.gz

Built distribution (wheel)

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

Total release size: 45.8 kB

Release files / funcd_bundle-0.17.0.tar.gz

Download URL funcd_bundle-0.17.0.tar.gz
Size 36.1 kB
Tags Source
SHA-256 checksum
How to use checksums
71ef95b457035b05a9526e0c0960148b1b32bae628102de39c8275eb90aaddd0
BLAKE2b-256 checksum
How to use checksums
7ff0c57299b073b7c7fcb685fa319559458f58610f6767e7969b43713adb1000
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 24, 2026.

Transparency log

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

Download URL funcd_bundle-0.17.0-py3-none-any.whl
Size 9.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c44a53d4cd5981de9e17e2d423dbdfb2fe29be25a9dad61bc63bebad20f9fe71
BLAKE2b-256 checksum
How to use checksums
358c671e6b4ce0cb5ec254a3ae2a01c4e5934c85e78ea7101508eb429c5294f5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 24, 2026.

Transparency log

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

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for funcd_bundle-0.17.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 24, 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.

Release history Release notifications | RSS feed

This release

0.17.0 This release

2 release files Full provenance

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