async-graph-data-flow 1.4.0__tar.gz → 1.5.0__tar.gz

async_graph_data_flow-1.5.0/CHANGELOG.md

@@ -0,0 +1,60 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
+and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
+
+## [Unreleased] - YYYY-MM-DD
+
+### Added
+
+### Changed
+
+### Deprecated
+
+### Removed
+
+### Fixed
+
+### Security
+
+## [1.5.0] - 2024-10-30
+
+### Added
+- Python 3.13 is officially supported and tested on CI. (#11)
+
+### Changed
+- Migrated the docs to the Read The Docs site. (#11)
+
+## [1.4.0] - 2023-11-30
+
+### Added
+- Python 3.12 is officially supported and tested on CI.
+- Added a technical notes page to the Sphinx documentation.
+
+## [1.3.0] - 2023-06-20
+
+### Added
+- `AsyncGraph.add_node` has the new keyword argument `check_async_gen` 
+  to optionally disable the async generator function check for advanced usage.
+
+## [1.2.0] - 2023-04-25
+
+### Added
+- An `AsyncExecutor` instance now has the `start_nodes` property.
+  It maps start nodes to their arguments passed in at the beginning of graph execution. 
+
+### Fixed
+- Before a graph executes, the `exceptions` property of an `AsyncExecutor` instance 
+  now returns `None`. Previously, accessing this property before graph execute
+  would raise an exception.
+
+## [1.1.0] - 2023-03-02
+
+### Added
+- Keep track of and expose exceptions. (#6)
+
+## [1.0.0] - 2023-01-05
+
+First release!

{async-graph-data-flow-1.4.0 → async_graph_data_flow-1.5.0}/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2022-2023, Civis Analytics
+Copyright (c) 2022-2024, Civis Analytics
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

async_graph_data_flow-1.5.0/MANIFEST.in

@@ -0,0 +1 @@
+include CHANGELOG.md

{async-graph-data-flow-1.4.0/src/async_graph_data_flow.egg-info → async_graph_data_flow-1.5.0}/PKG-INFO

@@ -1,9 +1,10 @@
 Metadata-Version: 2.1
 Name: async-graph-data-flow
-Version: 1.4.0
+Version: 1.5.0
 Summary: Asynchronous functions that pass data along a directed acyclic graph
 Author-email: Civis Analytics <opensource@civisanalytics.com>
 License: BSD 3-Clause
+Project-URL: Documentation, https://async-graph-data-flow.readthedocs.io
 Project-URL: Source, https://github.com/civisanalytics/async-graph-data-flow
 Keywords: async,asynchronous,asyncio,data flow,graph
 Classifier: Development Status :: 5 - Production/Stable
@@ -17,21 +18,23 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Framework :: AsyncIO
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 Provides-Extra: dev
-Requires-Dist: black==23.11.0; extra == "dev"
-Requires-Dist: flake8==6.1.0; extra == "dev"
-Requires-Dist: pytest==7.4.3; extra == "dev"
-Requires-Dist: build==1.0.3; extra == "dev"
-Requires-Dist: twine==4.0.2; extra == "dev"
-Requires-Dist: Sphinx==7.2.6; extra == "dev"
-Requires-Dist: furo==2023.9.10; extra == "dev"
-Requires-Dist: numpydoc==1.6.0; extra == "dev"
-Requires-Dist: sphinx-copybutton==0.5.2; extra == "dev"
-Requires-Dist: sphinxcontrib-mermaid==0.9.2; extra == "dev"
+Requires-Dist: black==24.10.0; extra == "dev"
+Requires-Dist: flake8==7.1.1; extra == "dev"
+Requires-Dist: pytest==8.3.3; extra == "dev"
+Requires-Dist: build==1.2.2; extra == "dev"
+Requires-Dist: twine==5.1.1; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: Sphinx==8.1.3; extra == "docs"
+Requires-Dist: furo==2024.8.6; extra == "docs"
+Requires-Dist: numpydoc==1.8.0; extra == "docs"
+Requires-Dist: sphinx-copybutton==0.5.2; extra == "docs"
+Requires-Dist: sphinxcontrib-mermaid==1.0.0; extra == "docs"
 
 # async-graph-data-flow
 
@@ -41,7 +44,7 @@ Requires-Dist: sphinxcontrib-mermaid==0.9.2; extra == "dev"
 
 ## Full Documentation
 
-Please visit https://civisanalytics.github.io/async-graph-data-flow
+Please visit https://async-graph-data-flow.readthedocs.io
 
 Please also check out this
 [blog post](https://www.civisanalytics.com/blog/open-source-software-release-introducing-async-graph-data-flow-a-python-library-for-efficient-data-pipelines/)
@@ -71,17 +74,18 @@ flake8 src tests examples
 black --check src tests examples
 ```
 
-## For Maintainers
+## Building Documentation
 
-To update the Sphinx documentation,
-the source files that need editing are under `docs/source/`;
-everything else under `docs/` is auto-generated.
-After the manual updates under `docs/source/` are ready,
-the HTML pages are updated as follows:
+We use the Sphinx framework. The documentation source files are in `docs/source/`.
+These files can be updated as necessary.
 
-```bash
-rm -r docs/_sources docs/_static && rm docs/*.html
+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`).
 
-# Run the following command *twice* -- certain HTML updates only show up after multiple `sphinx-build` runs.
-sphinx-build docs/source docs
-```
+To build the documentation locally (for testing and development),
+install the full doc-related dependencies: `pip install -r docs/requirements.txt`,
+then run `sphinx-build -b html docs/ docs/build/`.

{async-graph-data-flow-1.4.0 → async_graph_data_flow-1.5.0}/README.md

@@ -6,7 +6,7 @@
 
 ## Full Documentation
 
-Please visit https://civisanalytics.github.io/async-graph-data-flow
+Please visit https://async-graph-data-flow.readthedocs.io
 
 Please also check out this
 [blog post](https://www.civisanalytics.com/blog/open-source-software-release-introducing-async-graph-data-flow-a-python-library-for-efficient-data-pipelines/)
@@ -36,17 +36,18 @@ flake8 src tests examples
 black --check src tests examples
 ```
 
-## For Maintainers
+## Building Documentation
 
-To update the Sphinx documentation,
-the source files that need editing are under `docs/source/`;
-everything else under `docs/` is auto-generated.
-After the manual updates under `docs/source/` are ready,
-the HTML pages are updated as follows:
+We use the Sphinx framework. The documentation source files are in `docs/source/`.
+These files can be updated as necessary.
 
-```bash
-rm -r docs/_sources docs/_static && rm docs/*.html
+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`).
 
-# Run the following command *twice* -- certain HTML updates only show up after multiple `sphinx-build` runs.
-sphinx-build docs/source docs
-```
+To build the documentation locally (for testing and development),
+install the full doc-related dependencies: `pip install -r docs/requirements.txt`,
+then run `sphinx-build -b html docs/ docs/build/`.

{async-graph-data-flow-1.4.0 → async_graph_data_flow-1.5.0}/pyproject.toml

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["setuptools >= 65.3.0", "wheel"]
+requires = ["setuptools >= 69.0.0", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "async-graph-data-flow"
-version = "1.4.0"
+version = "1.5.0"
 description = "Asynchronous functions that pass data along a directed acyclic graph"
 readme = "README.md"
 requires-python = ">= 3.10"
@@ -29,29 +29,31 @@ classifiers = [
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Framework :: AsyncIO",
 ]
 
 [project.urls]
+Documentation = "https://async-graph-data-flow.readthedocs.io"
 Source = "https://github.com/civisanalytics/async-graph-data-flow"
 
 [project.optional-dependencies]
 dev = [
     # Running tests and linters
-    "black == 23.11.0",
-    "flake8 == 6.1.0",
-    "pytest == 7.4.3",
+    "black == 24.10.0",
+    "flake8 == 7.1.1",
+    "pytest == 8.3.3",
 
     # Managing source distributions
-    "build == 1.0.3",
-    "twine == 4.0.2",
-
-    # Documentation
-    "Sphinx == 7.2.6",
-    "furo == 2023.9.10",
-    "numpydoc == 1.6.0",
+    "build == 1.2.2",
+    "twine == 5.1.1",
+]
+docs = [
+    "Sphinx == 8.1.3",
+    "furo == 2024.8.6",
+    "numpydoc == 1.8.0",
     "sphinx-copybutton == 0.5.2",
-    "sphinxcontrib-mermaid == 0.9.2",
+    "sphinxcontrib-mermaid == 1.0.0",
 ]
 
 [tool.setuptools.packages.find]
@@ -62,5 +64,5 @@ zip-safe = false
 package-dir = { "" = "src" }
 
 [tool.pytest.ini_options]
-addopts = "-vv --durations=0"
+addopts = "-vv --durations=0 --strict-markers"
 testpaths = ["tests"]

{async-graph-data-flow-1.4.0 → async_graph_data_flow-1.5.0}/src/async_graph_data_flow/executor.py

@@ -106,7 +106,7 @@ class AsyncExecutor:
         node_filter: Iterable[str] | None = None,
         time_interval: int | None = None,
         logger: logging.Logger | None = None,
-    ):
+    ) -> None:
         """Turn on and configure data flow logging.
 
         For a long-running graph execution,
@@ -148,7 +148,7 @@ class AsyncExecutor:
         if logger and isinstance(logger, logging.Logger):
             self._logger = logger
 
-    def turn_off_data_flow_logging(self):
+    def turn_off_data_flow_logging(self) -> None:
         """Turn off data flow logging."""
         self._data_flow_logging = False
 

{async-graph-data-flow-1.4.0 → async_graph_data_flow-1.5.0/src/async_graph_data_flow.egg-info}/PKG-INFO

@@ -1,9 +1,10 @@
 Metadata-Version: 2.1
 Name: async-graph-data-flow
-Version: 1.4.0
+Version: 1.5.0
 Summary: Asynchronous functions that pass data along a directed acyclic graph
 Author-email: Civis Analytics <opensource@civisanalytics.com>
 License: BSD 3-Clause
+Project-URL: Documentation, https://async-graph-data-flow.readthedocs.io
 Project-URL: Source, https://github.com/civisanalytics/async-graph-data-flow
 Keywords: async,asynchronous,asyncio,data flow,graph
 Classifier: Development Status :: 5 - Production/Stable
@@ -17,21 +18,23 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Framework :: AsyncIO
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 Provides-Extra: dev
-Requires-Dist: black==23.11.0; extra == "dev"
-Requires-Dist: flake8==6.1.0; extra == "dev"
-Requires-Dist: pytest==7.4.3; extra == "dev"
-Requires-Dist: build==1.0.3; extra == "dev"
-Requires-Dist: twine==4.0.2; extra == "dev"
-Requires-Dist: Sphinx==7.2.6; extra == "dev"
-Requires-Dist: furo==2023.9.10; extra == "dev"
-Requires-Dist: numpydoc==1.6.0; extra == "dev"
-Requires-Dist: sphinx-copybutton==0.5.2; extra == "dev"
-Requires-Dist: sphinxcontrib-mermaid==0.9.2; extra == "dev"
+Requires-Dist: black==24.10.0; extra == "dev"
+Requires-Dist: flake8==7.1.1; extra == "dev"
+Requires-Dist: pytest==8.3.3; extra == "dev"
+Requires-Dist: build==1.2.2; extra == "dev"
+Requires-Dist: twine==5.1.1; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: Sphinx==8.1.3; extra == "docs"
+Requires-Dist: furo==2024.8.6; extra == "docs"
+Requires-Dist: numpydoc==1.8.0; extra == "docs"
+Requires-Dist: sphinx-copybutton==0.5.2; extra == "docs"
+Requires-Dist: sphinxcontrib-mermaid==1.0.0; extra == "docs"
 
 # async-graph-data-flow
 
@@ -41,7 +44,7 @@ Requires-Dist: sphinxcontrib-mermaid==0.9.2; extra == "dev"
 
 ## Full Documentation
 
-Please visit https://civisanalytics.github.io/async-graph-data-flow
+Please visit https://async-graph-data-flow.readthedocs.io
 
 Please also check out this
 [blog post](https://www.civisanalytics.com/blog/open-source-software-release-introducing-async-graph-data-flow-a-python-library-for-efficient-data-pipelines/)
@@ -71,17 +74,18 @@ flake8 src tests examples
 black --check src tests examples
 ```
 
-## For Maintainers
+## Building Documentation
 
-To update the Sphinx documentation,
-the source files that need editing are under `docs/source/`;
-everything else under `docs/` is auto-generated.
-After the manual updates under `docs/source/` are ready,
-the HTML pages are updated as follows:
+We use the Sphinx framework. The documentation source files are in `docs/source/`.
+These files can be updated as necessary.
 
-```bash
-rm -r docs/_sources docs/_static && rm docs/*.html
+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`).
 
-# Run the following command *twice* -- certain HTML updates only show up after multiple `sphinx-build` runs.
-sphinx-build docs/source docs
-```
+To build the documentation locally (for testing and development),
+install the full doc-related dependencies: `pip install -r docs/requirements.txt`,
+then run `sphinx-build -b html docs/ docs/build/`.

{async-graph-data-flow-1.4.0 → async_graph_data_flow-1.5.0}/src/async_graph_data_flow.egg-info/SOURCES.txt

@@ -1,9 +1,12 @@
+CHANGELOG.md
 LICENSE.txt
+MANIFEST.in
 README.md
 pyproject.toml
 src/async_graph_data_flow/__init__.py
 src/async_graph_data_flow/executor.py
 src/async_graph_data_flow/graph.py
+src/async_graph_data_flow/py.typed
 src/async_graph_data_flow.egg-info/PKG-INFO
 src/async_graph_data_flow.egg-info/SOURCES.txt
 src/async_graph_data_flow.egg-info/dependency_links.txt

async_graph_data_flow-1.5.0/src/async_graph_data_flow.egg-info/requires.txt

@@ -0,0 +1,14 @@
+
+[dev]
+black==24.10.0
+flake8==7.1.1
+pytest==8.3.3
+build==1.2.2
+twine==5.1.1
+
+[docs]
+Sphinx==8.1.3
+furo==2024.8.6
+numpydoc==1.8.0
+sphinx-copybutton==0.5.2
+sphinxcontrib-mermaid==1.0.0

async-graph-data-flow-1.4.0/src/async_graph_data_flow.egg-info/requires.txt

@@ -1,12 +0,0 @@
-
-[dev]
-black==23.11.0
-flake8==6.1.0
-pytest==7.4.3
-build==1.0.3
-twine==4.0.2
-Sphinx==7.2.6
-furo==2023.9.10
-numpydoc==1.6.0
-sphinx-copybutton==0.5.2
-sphinxcontrib-mermaid==0.9.2