{"id":24822319,"url":"https://github.com/controlplane-com/prefect-cpln","last_synced_at":"2025-10-30T18:45:44.665Z","repository":{"id":274885580,"uuid":"924230280","full_name":"controlplane-com/prefect-cpln","owner":"controlplane-com","description":"Prefect integrations for interacting with the Control Plane platform","archived":false,"fork":false,"pushed_at":"2025-06-05T20:23:42.000Z","size":347,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-06-27T16:48:39.711Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/controlplane-com.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-01-29T16:38:02.000Z","updated_at":"2025-06-09T14:09:49.000Z","dependencies_parsed_at":"2025-02-27T01:21:00.357Z","dependency_job_id":"66986948-b7f8-4b14-ad16-b30570a62e84","html_url":"https://github.com/controlplane-com/prefect-cpln","commit_stats":null,"previous_names":["controlplane-com/prefect-cpln"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/controlplane-com/prefect-cpln","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/controlplane-com%2Fprefect-cpln","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/controlplane-com%2Fprefect-cpln/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/controlplane-com%2Fprefect-cpln/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/controlplane-com%2Fprefect-cpln/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/controlplane-com","download_url":"https://codeload.github.com/controlplane-com/prefect-cpln/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/controlplane-com%2Fprefect-cpln/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281862808,"owners_count":26574703,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-30T02:00:06.501Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-30T18:40:59.253Z","updated_at":"2025-10-30T18:45:44.645Z","avatar_url":"https://github.com/controlplane-com.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# prefect-cpln\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://pypi.python.org/pypi/prefect-cpln/\" alt=\"PyPI version\"\u003e\n        \u003cimg alt=\"PyPI\" src=\"https://img.shields.io/pypi/v/prefect-cpln?color=26272B\u0026labelColor=090422\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://pypistats.org/packages/prefect-cpln/\" alt=\"Downloads\"\u003e\n        \u003cimg src=\"https://img.shields.io/pypi/dm/prefect-cpln?color=26272B\u0026labelColor=090422\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## Welcome!\n\n`prefect-cpln` is a collection of Prefect tasks, flows, and blocks enabling orchestration, observation and management of Control Plane resources.\n\nJump to [examples](#example-usage).\n\n## Resources\n\nFor more tips on how to use tasks and flows in an integration, check out [Use Integrations](https://docs.prefect.io/integrations/use-integrations)!\n\n### Installation\n\nInstall `prefect-cpln` with `pip`:\n\n```bash\n pip install prefect-cpln\n```\n\nRequires an installation of Python 3.8+.\n\nWe recommend using a Python virtual environment manager such as pipenv, conda or virtualenv.\n\nThese tasks are designed to work with Prefect 2. For more information about how to use Prefect, please refer to the [Prefect documentation](https://docs.prefect.io/).\n\nThen, to register [blocks](https://docs.prefect.io/integrations/use-integrations#register-blocks-from-an-integration) on Prefect Cloud:\n\n```bash\nprefect block register -m prefect_cpln\n```\n\nNote, to use the `load` method on Blocks, you must already have a block document [saved through code](https://docs.prefect.io/v3/develop/blocks#saving-blocks) or saved through the UI.\n\n### Example Usage\n\n#### Use `with_options` to customize options on any existing task or flow\n\n```python\nfrom prefect_cpln.flows import run_namespaced_job\n\ncustomized_run_namespaced_job = run_namespaced_job.with_options(\n    name=\"My flow running a Control Plane Job\",\n    retries=2,\n    retry_delay_seconds=10,\n) # this is now a new flow object that can be called\n```\n\nFor more tips on how to use tasks and flows in an integration, check out [Use Integrations](https://docs.prefect.io/integrations/use-integrations)!\n\n## Feedback\n\nIf you encounter any bugs while using `prefect-cpln`, feel free to open an issue in the [prefect-cpln](https://github.com/controlplane-com/prefect-cpln) repository.\n\nIf you have any questions or issues while using `prefect-cpln`, you can send an email to [support@controlplane.com](mailto:support@controlplane.com).\n\n## Contributing\n\nIf you'd like to help contribute to fix an issue or add a feature to `prefect-cpln`, please [propose changes through a pull request from a fork of the repository](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork).\n\nHere are the steps:\n\n1. [Fork the repository](https://docs.github.com/en/get-started/quickstart/fork-a-repo#forking-a-repository)\n2. [Clone the forked repository](https://docs.github.com/en/get-started/quickstart/fork-a-repo#cloning-your-forked-repository)\n3. Install the repository and its dependencies:\n\n```\npip install -e \".[dev]\"\n```\n\n4. Make desired changes\n5. Add tests\n6. Install `pre-commit` to perform quality checks prior to commit:\n\n```\n pre-commit install\n```\n\n8. `git commit`, `git push`, and create a pull request\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontrolplane-com%2Fprefect-cpln","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcontrolplane-com%2Fprefect-cpln","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontrolplane-com%2Fprefect-cpln/lists"}