cloudcoil
Typed Kubernetes clients, controllers and admission policies for Python 3.14.
Use Pydantic resource classes for typed API calls. Build controllers that return changed resources, define CRDs from Python models, and add admission policies to built-in or custom resources.
Installation
uv add 'cloudcoil[kubernetes]'
# Include HTTPS hosting for admission:
uv add 'cloudcoil[operator,kubernetes]'
The Kubernetes extra currently installs published 1.32 models. Until supported model packages are released, follow the checkout installation instructions to generate matching models. See VERSIONING.md for Kubernetes support and migration details.
Read resources
from cloudcoil.models.kubernetes.core.v1 import Pod
for pod in Pod.list(namespace="default").items:
print(pod.name)
Async applications use await Pod.async_list(...). Cloudcoil uses your kubeconfig
locally and ServiceAccount credentials in a Pod.
Write a controller
from cloudcoil.controller import Controller, Request
from cloudcoil.models.kubernetes.core.v1 import ConfigMap
from cloudcoil.application import Application
async def reconcile(request: Request[ConfigMap]) -> ConfigMap | None:
obj = request.resource
if obj is None or (obj.metadata and obj.metadata.deletion_timestamp):
return None
obj.data = {**(obj.data or {}), "managed-by": "cloudcoil"}
return obj
app = Application(
"configmap-labeler",
Controller(ConfigMap, reconcile, label_selector="example.com/manage=true"),
)
if __name__ == "__main__":
app.main()
Save as app.py. Run python app.py manifests to review generated permissions,
or python app.py run to start reconciliation. Cloudcoil handles watch recovery,
retries, guarded main/status patches and shutdown. Unchanged returns cause no write.
See the quickstart to try it against a cluster.
Documentation
The documentation site contains the full guides. The same pages are available in this checkout:
| Task | Guide |
|---|---|
| Install and run your first controller | Getting started |
| API operations and builders | Resources |
| Workload logs | Logs |
| CRD/OpenAPI model generation and typing | Models |
| Define CRDs from Python | Custom resources |
| Reconcile, manage children and write status | Controllers |
| Live clients and informer reads | Reads |
| Admission on built-in and custom resources | Admission |
| Manifests, RBAC, TLS and deployment | Applications |
| Executable controller/operator examples | Patterns |
| Caching, leadership and observability | Caching, runtime |
| Kubernetes integration tests | Testing |
| Existing model packages | Integrations |
The Widget demo builds and deploys a complete operator with a CRD, ConfigMap, Deployment, Service, readiness and HTTPS admission.
Licensed under Apache-2.0.
1 maintainer
Metadata
1 maintainer
Release files for cloudcoil 0.7.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cloudcoil-0.7.0.tar.gz | 690.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cloudcoil-0.7.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 853.9 kB
Release files / cloudcoil-0.7.0.tar.gz
| Download URL | cloudcoil-0.7.0.tar.gz |
|---|---|
| Size | 690.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
51dbe2ceb5e8dc7cb1d3f65d96dca9795d520a08eab1429260ea2fa72d670dd7
|
|
BLAKE2b-256 checksum How to use checksums |
00922b5a03b8500f29ef33a8bdf21639f3fda47cf5d88472e13f29cc96d71889
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 7, 2026.
Transparency logRelease files / cloudcoil-0.7.0-py3-none-any.whl
| Download URL | cloudcoil-0.7.0-py3-none-any.whl |
|---|---|
| Size | 163.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
48686288e924649525d2df5e61935eaa0b9e687d00cc7d7179b5a88ab1b17120
|
|
BLAKE2b-256 checksum How to use checksums |
216319d5bce9beb1e7d248c770ec25876959d5a7ae7497b3b7337e263bcb6790
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 7, 2026.
Transparency log
