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.22.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.22.0
File Size Uploaded Provenance Actions
funcd_bundle-0.22.0.tar.gz 36.1 kB With provenance Details for funcd_bundle-0.22.0.tar.gz

Built distribution (wheel)

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

Total release size: 45.7 kB

Release files / funcd_bundle-0.22.0.tar.gz

Download URL funcd_bundle-0.22.0.tar.gz
Size 36.1 kB
Tags Source
SHA-256 checksum
How to use checksums
e2b64261c90d31df78cde18beb32ee260c4f0d5505e584348c878bd021cf4b18
BLAKE2b-256 checksum
How to use checksums
c4e5b97a5484b154398703aa48c5b0c8eed5d02382b7627ae6b516ed0143eda5
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 13, 2026.

Transparency log

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

Download URL funcd_bundle-0.22.0-py3-none-any.whl
Size 9.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6a174e4a8cfb64963aacb9f351627db4b7b32ca303d27a6897b7536d1e2edde2
BLAKE2b-256 checksum
How to use checksums
808a23f5104942ac241cf1accf1755ad346ed3fe30410746447ba215d6d7b658
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 13, 2026.

Transparency log

Security for funcd-bundle 0.22.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.22.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 13, 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.22.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