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.18.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.18.0
File Size Uploaded Provenance Actions
funcd_bundle-0.18.0.tar.gz 36.1 kB With provenance Details for funcd_bundle-0.18.0.tar.gz

Built distribution (wheel)

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

Total release size: 45.8 kB

Release files / funcd_bundle-0.18.0.tar.gz

Download URL funcd_bundle-0.18.0.tar.gz
Size 36.1 kB
Tags Source
SHA-256 checksum
How to use checksums
14c28a0f8c5d24c3cdbe156b3885d12668f6169dd0d548e3a888c1dc2dd4d87f
BLAKE2b-256 checksum
How to use checksums
cb7fdcf3caa14038142e4a709db29dbfa525d33ea40211fa2214343fd490312f
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 27, 2026.

Transparency log

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

Download URL funcd_bundle-0.18.0-py3-none-any.whl
Size 9.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f42b6843cf35a0c0d9fb55405eaa477c4f30a0855ec5e71ca2ca2d46daf6398f
BLAKE2b-256 checksum
How to use checksums
33859ef44c69ce864c00ae7b298f3a6c2afd8b41a418af1fdfbca0affb4154a5
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 27, 2026.

Transparency log

Security for funcd-bundle 0.18.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.18.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 27, 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.18.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