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.24.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.24.0
File Size Uploaded Provenance Actions
funcd_bundle-0.24.0.tar.gz 36.1 kB With provenance Details for funcd_bundle-0.24.0.tar.gz

Built distribution (wheel)

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

Total release size: 45.7 kB

Release files / funcd_bundle-0.24.0.tar.gz

Download URL funcd_bundle-0.24.0.tar.gz
Size 36.1 kB
Tags Source
SHA-256 checksum
How to use checksums
f43fac6a5fa7d2e864e9c62d9fd94b5c03eb6d84fa8b928d03f1bd92f62eb0c4
BLAKE2b-256 checksum
How to use checksums
535a975041614071f5d73f3a30a6766ede6d43deef54bf682406acfe57bf3d34
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 Nov 14, 2026.

Transparency log

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

Download URL funcd_bundle-0.24.0-py3-none-any.whl
Size 9.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
695503fe26ae76f529c7726f525cc400ae4586e9a51b0a1492f34fdb8d9578d9
BLAKE2b-256 checksum
How to use checksums
1406637d85f715e3ac9596e5868bba588c44cdfe7329da51864d788dafaa2721
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 Nov 14, 2026.

Transparency log

Security for funcd-bundle 0.24.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.24.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 Nov 14, 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.24.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