ccflow (Composable Configuration Flow) is a collection of tools for workflow configuration, orchestration, and dependency injection.
It is intended to be flexible enough to handle diverse use cases, including data retrieval, validation, transformation, and loading (i.e. ETL workflows), model training, microservice configuration, and automated report generation.
The framework provides:
- a way to manage hierarchical, strongly typed configurations and the relationships between them through composition
- a way to associate user-defined functions with configurations, and in doing so, to define and name configurable workflow graphs
- a way to manage dependency injection and inversion of control for objects in these graphs
- flexibility in how to interact with configurations and workflows, including files/command line, native python/Jupyter notebook, Airflow/job scheduler, REST API, etc (in progress)
It heavily leverages pydantic, and users are expected to implement their own configuration and workflow building blocks by implementing pydantic models.
It also integrates closely with hydra for file-based configuration and command line interaction, but can also be used natively from Python without it.
This library was partially inspired by this blog post by Suneeta Mall (@suneeta-mall).
We have taken these ideas a step further by introducing the concept of the ModelRegistry, which allows for the configs to be managed without hydra, and also allows us to implement dependency injection.
We aim to provide additional (and optional) tools for workflow orchestration on top of the configuration framework.
Documentation
Our wiki is organized along the four kinds of documentation:
- Tutorials — hands-on lessons, from First Steps through building ETL applications to a configurable calculator driven from the CLI.
- How-to Guides — recipes for specific tasks like configuring complex values, caching, and retries.
- Reference — the core types, built-in models, and options.
- Explanation — the design goals, core concepts, and why ccflow leans on Hydra.
Installation
ccflow can be installed via pip or conda, the two primary package managers for the Python ecosystem.
To install ccflow via pip, run this command in your terminal:
pip install ccflow
To install ccflow via conda, run this command in your terminal:
conda install ccflow -c conda-forge
Community
- Contribute to
ccflowand help improve the project
License
This software is licensed under the Apache 2.0 license. See the LICENSE file for details.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ccflow-0.9.0.tar.gz.
File metadata
- Download URL: ccflow-0.9.0.tar.gz
- Upload date:
- Size: 376.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d6dd59b68418afa48dffce93bf884e495927bb420b9ebf804183f43b0754dc30
|
|
| MD5 |
e2369cf5be5dbe2f079c3deacdc60476
|
|
| BLAKE2b-256 |
980a994bf859392024b92946861552ee7d07e9790564acb6a162758be7e5afc4
|
File details
Details for the file ccflow-0.9.0-py3-none-any.whl.
File metadata
- Download URL: ccflow-0.9.0-py3-none-any.whl
- Upload date:
- Size: 455.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1eb0586966b827e7278224ffc6405f720af6c8901aa7725655d8f3242e86aab6
|
|
| MD5 |
a048b1e66ea071c4ff228d4909d702ea
|
|
| BLAKE2b-256 |
b73e326d8fc84cb174e1cf582a7cef6f852b8d6bfc0f9ce8705d700e1f8ea993
|
