dirigent-fhir 0.29.0__tar.gz

dirigent_fhir-0.29.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_fhir-0.29.0/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: dirigent-fhir
+Version: 0.29.0
+Summary: The FHIR pack for dirigent: a connection kind and the REST blocks for one FHIR server.
+License-Expression: LicenseRef-Proprietary
+License-File: LICENSE
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: dhis2w-fhir-engine>=1.38.2,<2
+Requires-Dist: dirigent-common==0.29.0
+Requires-Dist: dirigent-plugin==0.29.0
+Requires-Dist: httpx2>=2.12.0
+Requires-Python: >=3.13
+Project-URL: Documentation, https://winterop-com.github.io/dirigent-fhir/
+Project-URL: Repository, https://github.com/winterop-com/dirigent-fhir
+Description-Content-Type: text/markdown
+
+# dirigent-fhir
+
+The FHIR pack for [dirigent](https://github.com/winterop-com/dirigent). It contributes the `fhir`
+connection kind and the REST blocks for one FHIR R4 server:
+
+| Block | Effect | What it does |
+| --- | --- | --- |
+| `fhir.read` | reads | Reads one resource by type and id. |
+| `fhir.search` | reads | Searches one type, following `Bundle.link[next]` on the connection's origin under a page cap. |
+| `fhir.create` | writes | Creates a resource, conditionally with `ifNoneExist`. |
+| `fhir.update` | writes | Updates a resource with a conditional update on its identifier, never on a source server's id. |
+| `fhir.transaction` | writes | Writes many resources in one transaction or batch Bundle, references between them rewritten to `urn:uuid` entries. |
+
+It is FHIR as a system of its own, not a DHIS2 pack: FHIR to FHIR is as much its purpose as
+feeding DHIS2. Between steps a resource or a Bundle is plain FHIR JSON. Inside a block the R4
+models of `dhis2w-fhir-engine` type what they cover, and a resource they do not model passes
+through as JSON. A server's `OperationOutcome` fails the step classified by its status and its
+issue types, so a `transient` or `throttled` issue is retried and an `invalid` one is not.
+
+Documentation: the [`docs/`](docs/) directory, built with `uv run mkdocs build --strict`.
+
+## Install
+
+The pack is not on PyPI yet. Install it from a checkout:
+
+```bash
+uv add /path/to/dirigent-fhir
+```
+
+An instance discovers the pack by installing it: the `dirigent.plugins.v1` entry point in
+`pyproject.toml` is the whole registration.
+
+## Develop
+
+```bash
+uv sync
+uv run ruff format --check . && uv run ruff check .
+uv run mypy && uv run pyright
+uv run pytest -m "not live"
+uv run mkdocs build --strict
+```
+
+The tests are offline: every block runs against a fake FHIR server in `tests/fhirserver.py`, and
+the response bounds against a hostile server on loopback. `tests/test_fhir_live.py` reads a real
+server with `DIRIGENT_LIVE=1 FHIR_LIVE_URL=http://localhost:8090/fhir`.
+
+The pack follows dirigent's version: 0.29.0 is built against dirigent 0.29.0.

dirigent_fhir-0.29.0/README.md

@@ -0,0 +1,47 @@
+# dirigent-fhir
+
+The FHIR pack for [dirigent](https://github.com/winterop-com/dirigent). It contributes the `fhir`
+connection kind and the REST blocks for one FHIR R4 server:
+
+| Block | Effect | What it does |
+| --- | --- | --- |
+| `fhir.read` | reads | Reads one resource by type and id. |
+| `fhir.search` | reads | Searches one type, following `Bundle.link[next]` on the connection's origin under a page cap. |
+| `fhir.create` | writes | Creates a resource, conditionally with `ifNoneExist`. |
+| `fhir.update` | writes | Updates a resource with a conditional update on its identifier, never on a source server's id. |
+| `fhir.transaction` | writes | Writes many resources in one transaction or batch Bundle, references between them rewritten to `urn:uuid` entries. |
+
+It is FHIR as a system of its own, not a DHIS2 pack: FHIR to FHIR is as much its purpose as
+feeding DHIS2. Between steps a resource or a Bundle is plain FHIR JSON. Inside a block the R4
+models of `dhis2w-fhir-engine` type what they cover, and a resource they do not model passes
+through as JSON. A server's `OperationOutcome` fails the step classified by its status and its
+issue types, so a `transient` or `throttled` issue is retried and an `invalid` one is not.
+
+Documentation: the [`docs/`](docs/) directory, built with `uv run mkdocs build --strict`.
+
+## Install
+
+The pack is not on PyPI yet. Install it from a checkout:
+
+```bash
+uv add /path/to/dirigent-fhir
+```
+
+An instance discovers the pack by installing it: the `dirigent.plugins.v1` entry point in
+`pyproject.toml` is the whole registration.
+
+## Develop
+
+```bash
+uv sync
+uv run ruff format --check . && uv run ruff check .
+uv run mypy && uv run pyright
+uv run pytest -m "not live"
+uv run mkdocs build --strict
+```
+
+The tests are offline: every block runs against a fake FHIR server in `tests/fhirserver.py`, and
+the response bounds against a hostile server on loopback. `tests/test_fhir_live.py` reads a real
+server with `DIRIGENT_LIVE=1 FHIR_LIVE_URL=http://localhost:8090/fhir`.
+
+The pack follows dirigent's version: 0.29.0 is built against dirigent 0.29.0.

dirigent_fhir-0.29.0/pyproject.toml

@@ -0,0 +1,121 @@
+[project]
+name = "dirigent-fhir"
+version = "0.29.0"
+description = "The FHIR pack for dirigent: a connection kind and the REST blocks for one FHIR server."
+readme = "README.md"
+requires-python = ">=3.13"
+license = "LicenseRef-Proprietary"
+license-files = ["LICENSE"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "dhis2w-fhir-engine>=1.38.2,<2",
+    "dirigent-common==0.29.0",
+    "dirigent-plugin==0.29.0",
+    "httpx2>=2.12.0",
+]
+
+[project.urls]
+Documentation = "https://winterop-com.github.io/dirigent-fhir/"
+Repository = "https://github.com/winterop-com/dirigent-fhir"
+
+[project.entry-points."dirigent.plugins.v1"]
+fhir = "dirigent_fhir:plugin"
+
+[dependency-groups]
+dev = [
+    "dirigent-testing==0.29.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 FHIR server; opt in with DIRIGENT_LIVE=1 and FHIR_LIVE_URL"]
+
+[tool.ruff]
+target-version = "py313"
+line-length = 120
+src = [
+    "src",
+    "tests",
+]
+
+[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_fhir",
+    "dirigent_plugin",
+    "dirigent_testing",
+]
+
+[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 = ["tests"]
+
+[tool.pyright]
+pythonVersion = "3.13"
+typeCheckingMode = "strict"
+include = [
+    "src",
+    "tests",
+]
+extraPaths = ["tests"]
+reportMissingTypeStubs = false

dirigent_fhir-0.29.0/pyproject.toml.orig

@@ -0,0 +1,93 @@
+[project]
+name = "dirigent-fhir"
+version = "0.29.0"
+description = "The FHIR pack for dirigent: a connection kind and the REST blocks for one FHIR server."
+readme = "README.md"
+requires-python = ">=3.13"
+license = "LicenseRef-Proprietary"
+license-files = ["LICENSE"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "dhis2w-fhir-engine>=1.38.2,<2",
+    "dirigent-common==0.29.0",
+    "dirigent-plugin==0.29.0",
+    "httpx2>=2.12.0",
+]
+
+[project.urls]
+Documentation = "https://winterop-com.github.io/dirigent-fhir/"
+Repository = "https://github.com/winterop-com/dirigent-fhir"
+
+[project.entry-points."dirigent.plugins.v1"]
+fhir = "dirigent_fhir:plugin"
+
+[dependency-groups]
+dev = [
+    "dirigent-testing==0.29.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 FHIR server; opt in with DIRIGENT_LIVE=1 and FHIR_LIVE_URL",
+]
+
+[tool.ruff]
+target-version = "py313"
+line-length = 120
+src = ["src", "tests"]
+
+[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_fhir", "dirigent_plugin", "dirigent_testing"]
+
+[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 = ["tests"]
+
+[tool.pyright]
+pythonVersion = "3.13"
+typeCheckingMode = "strict"
+include = ["src", "tests"]
+extraPaths = ["tests"]
+reportMissingTypeStubs = false

dirigent_fhir-0.29.0/src/dirigent_fhir/__init__.py

@@ -0,0 +1,79 @@
+"""The FHIR pack: the ``fhir`` connection kind and the REST blocks for one FHIR server."""
+
+from collections.abc import Sequence
+from importlib.resources import files
+from importlib.resources.abc import Traversable
+
+from dirigent_fhir.client import FhirClient
+from dirigent_fhir.connection import FhirConnectionConfig, FhirConnectionKind, build_client, client_for
+from dirigent_fhir.create import FhirCreateConfig, FhirCreateOperator
+from dirigent_fhir.messages import FHIR
+from dirigent_fhir.r4 import FhirIssue
+from dirigent_fhir.read import FhirReadConfig, FhirReadOperator, FhirReadOutput
+from dirigent_fhir.search import FhirSearchConfig, FhirSearchOperator, FhirSearchOutput
+from dirigent_fhir.transaction import (
+    FhirEntryResult,
+    FhirTransactionConfig,
+    FhirTransactionOperator,
+    FhirTransactionOutput,
+)
+from dirigent_fhir.update import FhirUpdateConfig, FhirUpdateOperator
+from dirigent_fhir.writes import FhirWriteOutput
+from dirigent_plugin import Contribution, extension
+
+#: The directory the pack's example shelves live in, inside this distribution.
+SHELVES_DIRECTORY = "shelves"
+
+
+class FhirPlugin:
+    """The plugin object the host discovers under the dirigent.plugins.v1 entry-point group."""
+
+    @extension
+    def contribute(self) -> Contribution:
+        """Contribute the FHIR blocks and the ``fhir`` connection kind they are configured from."""
+        return Contribution(
+            operators=[
+                FhirReadOperator(),
+                FhirSearchOperator(),
+                FhirCreateOperator(),
+                FhirUpdateOperator(),
+                FhirTransactionOperator(),
+            ],
+            connection_kinds=[FhirConnectionKind()],
+            labels=[FHIR],
+        )
+
+    @extension
+    def examples(self) -> Sequence[Traversable]:
+        """Contribute the example shelves this distribution carries."""
+        return [files(__package__ or "dirigent_fhir") / SHELVES_DIRECTORY]
+
+
+plugin = FhirPlugin()
+
+__all__ = [
+    "SHELVES_DIRECTORY",
+    "FhirClient",
+    "FhirConnectionConfig",
+    "FhirConnectionKind",
+    "FhirCreateConfig",
+    "FhirCreateOperator",
+    "FhirEntryResult",
+    "FhirIssue",
+    "FhirPlugin",
+    "FhirReadConfig",
+    "FhirReadOperator",
+    "FhirReadOutput",
+    "FhirSearchConfig",
+    "FhirSearchOperator",
+    "FhirSearchOutput",
+    "FhirTransactionConfig",
+    "FhirTransactionOperator",
+    "FhirTransactionOutput",
+    "FhirUpdateConfig",
+    "FhirUpdateOperator",
+    "FhirWriteOutput",
+    "build_client",
+    "client_for",
+    "plugin",
+]