The Python SDK for composition functions
Go to file
Bob Haddleton 6e65599e58
Merge pull request #150 from crossplane/renovate/ruff-0.x
chore(deps): update dependency ruff to v0.11.9
2025-05-09 11:41:51 -05:00
.github chore(deps): update pypa/gh-action-pypi-publish action to v1.12.4 2025-01-24 05:16:53 +00:00
crossplane/function Merge pull request #140 from negz/terminal 2025-04-23 14:06:31 -05:00
tests Merge branch 'main' into main 2025-01-15 10:01:42 +01:00
.gitignore Generate and publish API docs to GitHub pages 2024-01-05 13:08:30 -08:00
CODEOWNERS Add OWNERS and CODEOWNERS 2025-04-01 06:42:19 -07:00
LICENSE Initial commit 2023-11-20 15:00:23 -08:00
OWNERS.md Add OWNERS and CODEOWNERS 2025-04-01 06:42:19 -07:00
README.md Use the new hatch fmt command to run linters and formatting 2024-10-09 19:54:19 -07:00
pyproject.toml Merge pull request #150 from crossplane/renovate/ruff-0.x 2025-05-09 11:41:51 -05:00
renovate.json Add renovate.json 2023-11-21 02:22:01 +00:00

README.md

function-sdk-python

CI GitHub release (latest SemVer) PyPI - Version

The Python SDK for writing composition functions.

This SDK is currently a beta. We try to avoid breaking changes, but it will not have a stable API until it reaches v1.0.0. It follows the same contributing guidelines as Crossplane.

To learn how to use this SDK:

The RunFunctionRequest and RunFunctionResponse types provided by this SDK are generated from a proto3 protocol buffer schema. Their fields behave similarly to built-in Python types like lists and dictionaries, but there are some differences. Read the generated code documentation to familiarize yourself with the the differences.

If you just want to jump in and get started, consider using the function-template-python template repository.

Contributing

This project follows the Crossplane contributing guidelines, where applicable to Python. It is linted, tested, and built using Hatch.

Some useful commands:

# Generate gRPC stubs.
hatch run generate:protoc

# Format and lint the code.
hatch fmt

# Run unit tests.
hatch test

# Build an sdist and wheel.
hatch build