async-graph-data-flow

Full Documentation

Please visit https://async-graph-data-flow.readthedocs.io

Please also check out this blog post introducing this package.

License

BSD 3-Clause License. Please see LICENSE.txt in the GitHub source code for details.

Setting up a Development Environment

The latest code under development is available on GitHub at https://github.com/civisanalytics/async-graph-data-flow. To obtain this version for experimental features or for development, we recommend using uv to manage the development environment:

git clone https://github.com/civisanalytics/async-graph-data-flow.git
cd async-graph-data-flow
uv pip install -e ".[dev]"

To run tests and styling checks:

uv run pytest
uv run flake8 src tests examples
uv run black --check src tests examples

Building Documentation

We use the Sphinx framework. The documentation source files are in docs/. These files can be updated as necessary.

The public documentation is accessible at https://async-graph-data-flow.readthedocs.io. The doc build is configured by .readthedocs.yaml. Normally, even when we need to update the documentation or make a new release of async-graph-data-flow, neither this configuration YAML file nor Civis's account on the Read the Docs site need any updates. The builds by the Read The Docs site generate the necessary files (the HTML pages and other things) for the public documentation. All these auto-generated files are explicitly not versioned (see .gitignore).

To build the documentation locally (for testing and development), install the full doc-related dependencies: uv pip install -r docs/requirements.txt, then run uv run sphinx-build -b html docs/ docs/build/.