dirigent-contrib 0.28.0__tar.gz

dirigent_contrib-0.28.0/LICENSE

@@ -0,0 +1,15 @@
+Copyright (c) 2026 Morten Olav Hansen <morten@winterop.com>. All rights reserved.
+
+This source code and accompanying documentation are the property of
+Morten Olav Hansen. No license, express or implied, is granted to use, copy,
+modify, merge, publish, distribute, sublicense, or sell copies of this
+software or its derivatives.
+
+The source is published for reference only. Any use beyond reading
+requires written permission from the copyright holder.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES,
+OR OTHER LIABILITY ARISING FROM THE USE OF THE SOFTWARE.

dirigent_contrib-0.28.0/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: dirigent-contrib
+Version: 0.28.0
+Summary: Block packs for dirigent that reach outside systems: Chap and the open climate service.
+License-Expression: LicenseRef-Proprietary
+License-File: LICENSE
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: dirigent-common==0.28.0
+Requires-Dist: dirigent-plugin==0.28.0
+Requires-Dist: httpx2>=2.12.0
+Requires-Dist: pydantic>=2.13.5
+Requires-Python: >=3.13
+Project-URL: Documentation, https://winterop-com.github.io/dirigent-contrib/
+Project-URL: Repository, https://github.com/winterop-com/dirigent-contrib
+Description-Content-Type: text/markdown
+
+# dirigent-contrib
+
+[![CI](https://github.com/winterop-com/dirigent-contrib/actions/workflows/ci.yaml/badge.svg?branch=main)](https://github.com/winterop-com/dirigent-contrib/actions/workflows/ci.yaml)
+[![Docs](https://img.shields.io/badge/docs-winterop--com.github.io%2Fdirigent--contrib-2b2f38)](https://winterop-com.github.io/dirigent-contrib/)
+
+Block packs for [dirigent](https://github.com/winterop-com/dirigent) that reach outside systems,
+all in one package. Installing `dirigent-contrib` is the whole of the configuration: the host
+finds each pack through its entry point.
+
+```bash
+uv tool install dirigent-cli --with dirigent-contrib
+```
+
+Documentation: <https://winterop-com.github.io/dirigent-contrib/>.
+
+## Chap
+
+The `chap` connection kind and the blocks that drive one Chap (chap-core) server, in
+`dirigent_contrib.chap`: import observations as a dataset, run a backtest, forecast from a saved
+prediction setup, read the forecast's quantiles, list the configured models, compute the endemic
+channel, and record a forecast's alerts and wait for a person to review them in Chap.
+
+| Block | Kind | What it does |
+| --- | --- | --- |
+| `chap.dataset.import` | operator, probed | Validates observations, imports them as a dataset, and waits for the import job. |
+| `chap.backtest.run` | operator, probed | Runs a backtest of a configured model on a stored dataset. |
+| `chap.prediction.run` | operator, probed | Forecasts from a saved prediction setup with fresh observations. |
+| `chap.prediction.read` | operator | Reads a prediction's forecasts at the quantiles asked for. |
+| `chap.models.list` | operator | Lists the server's configured models. |
+| `chap.thresholds` | operator | Computes outbreak thresholds, the endemic channel, for a dataset. |
+| `chap.alerts.record` | operator | Records alerts against a policy, each one waiting for review. |
+| `chap.alerts.reviewed` | sensor | Waits until a prediction's alerts are reviewed, and hands on the approved ones. |
+| `chap.alerts.list` | operator | Reads where alerts stand in the review, once. |
+
+## The open climate service
+
+The `climate` connection kind and the blocks that drive one instance of the open climate service,
+in `dirigent_contrib.climate`: list its datasets, aggregate one to org units, run a batch job and
+download what it made, deliver a saved export to DHIS2, and ingest or sync a managed dataset.
+
+| Block | Kind | What it does |
+| --- | --- | --- |
+| `climate.datasets.list` | operator | Lists the published datasets. |
+| `climate.aggregate` | operator | Runs a process graph synchronously and keeps its payload. |
+| `climate.job.run` | operator, probed | Runs a process graph as an openEO batch job. |
+| `climate.job.result` | operator | Downloads a finished job's payload into the run's storage. |
+| `climate.export` | operator, probed | Delivers a job's saved export through the service's own DHIS2 connection. |
+| `climate.ingest` | operator, probed | Creates or updates a managed dataset. |
+| `climate.sync` | operator, probed | Brings a managed dataset forward from its latest time step. |
+
+## Working on it
+
+One package, with a subpackage per system under `src/dirigent_contrib/` and its tests under
+`tests/`. The gates CI runs:
+
+```bash
+make sync
+make check
+make test
+make docs
+```
+
+Live checks against a real server only read, and are opt-in:
+
+```bash
+DIRIGENT_LIVE=1 uv run pytest -m live
+DIRIGENT_LIVE=1 CHAP_LIVE_URL=http://localhost:8000 uv run pytest -m live
+```
+
+## Licence
+
+Copyright (c) 2026 Morten Olav Hansen. All rights reserved. The source is published for
+reference only: no licence to use, copy, modify or distribute it is granted, and any use
+beyond reading requires written permission.

dirigent_contrib-0.28.0/README.md

@@ -0,0 +1,74 @@
+# dirigent-contrib
+
+[![CI](https://github.com/winterop-com/dirigent-contrib/actions/workflows/ci.yaml/badge.svg?branch=main)](https://github.com/winterop-com/dirigent-contrib/actions/workflows/ci.yaml)
+[![Docs](https://img.shields.io/badge/docs-winterop--com.github.io%2Fdirigent--contrib-2b2f38)](https://winterop-com.github.io/dirigent-contrib/)
+
+Block packs for [dirigent](https://github.com/winterop-com/dirigent) that reach outside systems,
+all in one package. Installing `dirigent-contrib` is the whole of the configuration: the host
+finds each pack through its entry point.
+
+```bash
+uv tool install dirigent-cli --with dirigent-contrib
+```
+
+Documentation: <https://winterop-com.github.io/dirigent-contrib/>.
+
+## Chap
+
+The `chap` connection kind and the blocks that drive one Chap (chap-core) server, in
+`dirigent_contrib.chap`: import observations as a dataset, run a backtest, forecast from a saved
+prediction setup, read the forecast's quantiles, list the configured models, compute the endemic
+channel, and record a forecast's alerts and wait for a person to review them in Chap.
+
+| Block | Kind | What it does |
+| --- | --- | --- |
+| `chap.dataset.import` | operator, probed | Validates observations, imports them as a dataset, and waits for the import job. |
+| `chap.backtest.run` | operator, probed | Runs a backtest of a configured model on a stored dataset. |
+| `chap.prediction.run` | operator, probed | Forecasts from a saved prediction setup with fresh observations. |
+| `chap.prediction.read` | operator | Reads a prediction's forecasts at the quantiles asked for. |
+| `chap.models.list` | operator | Lists the server's configured models. |
+| `chap.thresholds` | operator | Computes outbreak thresholds, the endemic channel, for a dataset. |
+| `chap.alerts.record` | operator | Records alerts against a policy, each one waiting for review. |
+| `chap.alerts.reviewed` | sensor | Waits until a prediction's alerts are reviewed, and hands on the approved ones. |
+| `chap.alerts.list` | operator | Reads where alerts stand in the review, once. |
+
+## The open climate service
+
+The `climate` connection kind and the blocks that drive one instance of the open climate service,
+in `dirigent_contrib.climate`: list its datasets, aggregate one to org units, run a batch job and
+download what it made, deliver a saved export to DHIS2, and ingest or sync a managed dataset.
+
+| Block | Kind | What it does |
+| --- | --- | --- |
+| `climate.datasets.list` | operator | Lists the published datasets. |
+| `climate.aggregate` | operator | Runs a process graph synchronously and keeps its payload. |
+| `climate.job.run` | operator, probed | Runs a process graph as an openEO batch job. |
+| `climate.job.result` | operator | Downloads a finished job's payload into the run's storage. |
+| `climate.export` | operator, probed | Delivers a job's saved export through the service's own DHIS2 connection. |
+| `climate.ingest` | operator, probed | Creates or updates a managed dataset. |
+| `climate.sync` | operator, probed | Brings a managed dataset forward from its latest time step. |
+
+## Working on it
+
+One package, with a subpackage per system under `src/dirigent_contrib/` and its tests under
+`tests/`. The gates CI runs:
+
+```bash
+make sync
+make check
+make test
+make docs
+```
+
+Live checks against a real server only read, and are opt-in:
+
+```bash
+DIRIGENT_LIVE=1 uv run pytest -m live
+DIRIGENT_LIVE=1 CHAP_LIVE_URL=http://localhost:8000 uv run pytest -m live
+```
+
+## Licence
+
+Copyright (c) 2026 Morten Olav Hansen. All rights reserved. The source is published for
+reference only: no licence to use, copy, modify or distribute it is granted, and any use
+beyond reading requires written permission.

dirigent_contrib-0.28.0/pyproject.toml

@@ -0,0 +1,122 @@
+[project]
+name = "dirigent-contrib"
+version = "0.28.0"
+description = "Block packs for dirigent that reach outside systems: Chap and the open climate service."
+readme = "README.md"
+requires-python = ">=3.13"
+license = "LicenseRef-Proprietary"
+license-files = ["LICENSE"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "dirigent-common==0.28.0",
+    "dirigent-plugin==0.28.0",
+    "httpx2>=2.12.0",
+    "pydantic>=2.13.5",
+]
+
+[project.urls]
+Documentation = "https://winterop-com.github.io/dirigent-contrib/"
+Repository = "https://github.com/winterop-com/dirigent-contrib"
+
+[project.entry-points."dirigent.plugins.v1"]
+chap = "dirigent_contrib.chap:plugin"
+climate = "dirigent_contrib.climate:plugin"
+
+[dependency-groups]
+dev = [
+    "dirigent-testing==0.28.0",
+    "mkdocs>=1.6.1",
+    "mkdocs-material>=9.7.7",
+    "mypy>=1.19",
+    "pymdown-extensions>=11.0.2",
+    "pyright>=1.1",
+    "pytest>=8",
+    "pytest-asyncio>=0.24",
+    "pyyaml>=6",
+    "ruff>=0.16",
+    "types-pyyaml>=6",
+]
+
+[build-system]
+requires = ["uv_build>=0.12.0,<0.14.0"]
+build-backend = "uv_build"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+testpaths = ["tests"]
+markers = ["live: reaches a real Chap or open climate service; opt in with DIRIGENT_LIVE=1 and the URLs it names"]
+
+[tool.ruff]
+target-version = "py313"
+line-length = 120
+src = [
+    "src",
+    ".",
+]
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "W",
+    "F",
+    "I",
+    "D",
+    "SIM",
+    "UP",
+    "B",
+    "TID",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = [
+    "D103",
+    "D100",
+    "D101",
+    "D102",
+    "D104",
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.isort]
+known-first-party = [
+    "dirigent_common",
+    "dirigent_contrib",
+    "dirigent_plugin",
+    "dirigent_testing",
+    "tests",
+]
+
+[tool.ruff.format]
+quote-style = "double"
+docstring-code-format = true
+
+[tool.mypy]
+python_version = "3.13"
+disallow_untyped_defs = true
+warn_return_any = true
+warn_unused_configs = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+no_implicit_optional = true
+strict_equality = true
+plugins = ["pydantic.mypy"]
+files = [
+    "src",
+    "tests",
+]
+mypy_path = ["src"]
+
+[tool.pyright]
+pythonVersion = "3.13"
+typeCheckingMode = "strict"
+include = [
+    "src",
+    "tests",
+]
+reportMissingTypeStubs = false

dirigent_contrib-0.28.0/pyproject.toml.orig

@@ -0,0 +1,93 @@
+[project]
+name = "dirigent-contrib"
+version = "0.28.0"
+description = "Block packs for dirigent that reach outside systems: Chap and the open climate service."
+readme = "README.md"
+requires-python = ">=3.13"
+license = "LicenseRef-Proprietary"
+license-files = ["LICENSE"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "dirigent-common==0.28.0",
+    "dirigent-plugin==0.28.0",
+    "httpx2>=2.12.0",
+    "pydantic>=2.13.5",
+]
+
+[project.urls]
+Documentation = "https://winterop-com.github.io/dirigent-contrib/"
+Repository = "https://github.com/winterop-com/dirigent-contrib"
+
+[project.entry-points."dirigent.plugins.v1"]
+chap = "dirigent_contrib.chap:plugin"
+climate = "dirigent_contrib.climate:plugin"
+
+[dependency-groups]
+dev = [
+    "dirigent-testing==0.28.0",
+    "mkdocs>=1.6.1",
+    "mkdocs-material>=9.7.7",
+    "mypy>=1.19",
+    "pymdown-extensions>=11.0.2",
+    "pyright>=1.1",
+    "pytest>=8",
+    "pytest-asyncio>=0.24",
+    "pyyaml>=6",
+    "ruff>=0.16",
+    "types-pyyaml>=6",
+]
+
+[build-system]
+requires = ["uv_build>=0.12.0,<0.14.0"]
+build-backend = "uv_build"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+testpaths = ["tests"]
+markers = [
+    "live: reaches a real Chap or open climate service; opt in with DIRIGENT_LIVE=1 and the URLs it names",
+]
+
+[tool.ruff]
+target-version = "py313"
+line-length = 120
+src = ["src", "."]
+
+[tool.ruff.lint]
+select = ["E", "W", "F", "I", "D", "SIM", "UP", "B", "TID"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["D103", "D100", "D101", "D102", "D104"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.isort]
+known-first-party = ["dirigent_common", "dirigent_contrib", "dirigent_plugin", "dirigent_testing", "tests"]
+
+[tool.ruff.format]
+quote-style = "double"
+docstring-code-format = true
+
+[tool.mypy]
+python_version = "3.13"
+disallow_untyped_defs = true
+warn_return_any = true
+warn_unused_configs = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+no_implicit_optional = true
+strict_equality = true
+plugins = ["pydantic.mypy"]
+files = ["src", "tests"]
+mypy_path = ["src"]
+
+[tool.pyright]
+pythonVersion = "3.13"
+typeCheckingMode = "strict"
+include = ["src", "tests"]
+reportMissingTypeStubs = false

dirigent_contrib-0.28.0/src/dirigent_contrib/__init__.py

@@ -0,0 +1 @@
+"""Block packs for dirigent that reach outside systems, each a subpackage with an entry point of its own."""

dirigent_contrib-0.28.0/src/dirigent_contrib/chap/__init__.py

@@ -0,0 +1,103 @@
+"""The Chap pack: the ``chap`` connection kind and the blocks for one Chap server."""
+
+from collections.abc import Sequence
+from importlib.resources import files
+from importlib.resources.abc import Traversable
+
+from dirigent_contrib.chap.alerts import (
+    ChapAlertCounts,
+    ChapAlertsListConfig,
+    ChapAlertsListOperator,
+    ChapAlertsOutput,
+    ChapAlertsRecordConfig,
+    ChapAlertsRecordOperator,
+    ChapAlertsRecordOutput,
+    ChapAlertsReviewedConfig,
+    ChapAlertsReviewedSensor,
+)
+from dirigent_contrib.chap.backtests import ChapBacktestRunConfig, ChapBacktestRunOperator, ChapBacktestRunOutput
+from dirigent_contrib.chap.configured_models import ChapModelsListConfig, ChapModelsListOperator, ChapModelsListOutput
+from dirigent_contrib.chap.connection import ChapConnectionConfig, ChapConnectionKind, build_client, client_for
+from dirigent_contrib.chap.datasets import ChapDatasetImportConfig, ChapDatasetImportOperator, ChapDatasetImportOutput
+from dirigent_contrib.chap.messages import CHAP
+from dirigent_contrib.chap.predictions import (
+    ChapPredictionReadConfig,
+    ChapPredictionReadOperator,
+    ChapPredictionReadOutput,
+    ChapPredictionRunConfig,
+    ChapPredictionRunOperator,
+    ChapPredictionRunOutput,
+)
+from dirigent_contrib.chap.thresholds import ChapThresholdsConfig, ChapThresholdsOperator, ChapThresholdsOutput
+from dirigent_plugin import Contribution, extension
+
+#: The directory the pack's example shelves live in, inside this distribution.
+SHELVES_DIRECTORY = "shelves"
+
+
+class ChapPlugin:
+    """The plugin object the host discovers under the dirigent.plugins.v1 entry-point group."""
+
+    @extension
+    def contribute(self) -> Contribution:
+        """Contribute the Chap blocks and the ``chap`` connection kind they are configured from."""
+        return Contribution(
+            operators=[
+                ChapDatasetImportOperator(),
+                ChapBacktestRunOperator(),
+                ChapPredictionRunOperator(),
+                ChapPredictionReadOperator(),
+                ChapModelsListOperator(),
+                ChapThresholdsOperator(),
+                ChapAlertsRecordOperator(),
+                ChapAlertsListOperator(),
+            ],
+            sensors=[ChapAlertsReviewedSensor()],
+            connection_kinds=[ChapConnectionKind()],
+            labels=[CHAP],
+        )
+
+    @extension
+    def examples(self) -> Sequence[Traversable]:
+        """Contribute the example shelves this distribution carries."""
+        return [files(__package__ or "dirigent_contrib.chap") / SHELVES_DIRECTORY]
+
+
+plugin = ChapPlugin()
+
+__all__ = [
+    "SHELVES_DIRECTORY",
+    "ChapAlertCounts",
+    "ChapAlertsListConfig",
+    "ChapAlertsListOperator",
+    "ChapAlertsOutput",
+    "ChapAlertsRecordConfig",
+    "ChapAlertsRecordOperator",
+    "ChapAlertsRecordOutput",
+    "ChapAlertsReviewedConfig",
+    "ChapAlertsReviewedSensor",
+    "ChapBacktestRunConfig",
+    "ChapBacktestRunOperator",
+    "ChapBacktestRunOutput",
+    "ChapConnectionConfig",
+    "ChapConnectionKind",
+    "ChapDatasetImportConfig",
+    "ChapDatasetImportOperator",
+    "ChapDatasetImportOutput",
+    "ChapModelsListConfig",
+    "ChapModelsListOperator",
+    "ChapModelsListOutput",
+    "ChapPlugin",
+    "ChapPredictionReadConfig",
+    "ChapPredictionReadOperator",
+    "ChapPredictionReadOutput",
+    "ChapPredictionRunConfig",
+    "ChapPredictionRunOperator",
+    "ChapPredictionRunOutput",
+    "ChapThresholdsConfig",
+    "ChapThresholdsOperator",
+    "ChapThresholdsOutput",
+    "build_client",
+    "client_for",
+    "plugin",
+]