dhis2w-core

Shared runtime for dhis2w-cli and the dhis2w-mcp MCP server: profile discovery, plugin registry, auth factory, token store, and the first-party plugins (metadata, data, analytics, users, tracker, files, messaging, apps, route, maintenance, doctor, customize, system, profile, dev).

dhis2w-core is the bridge between dhis2w-client (the pure async API client) and the user-facing surfaces (CLI, MCP). End users typically don't install this directly — they install dhis2w-cli or dhis2w-mcp (the MCP plugin pack, in its own repository), which pull dhis2w-core in transitively.

Install

# Direct (rare — usually you want dhis2w-cli or dhis2w-mcp instead)
uv add dhis2w-core

What's in the box

Profile system — auto-discovers a profile from .dhis2/profiles.toml (CWD walk-up) or ~/.config/dhis2/profiles.toml. Profile model + profile_from_env() env-var fallback.
Plugin host — a pluginkit manager that walks dhis2w_core.v{41,42,43,44}.plugins.* plus the dhis2w.plugins.v1 entry-point group for external packs. Each plugin answers the contribute(version_key) extension point with a Contribution naming its CLI and MCP modules.
Auth factory — turns a Profile into the matching AuthProvider from dhis2w-client, wires the token store, manages OAuth2 PKCE redirect capture.
Token store — SQLite-backed (aiosqlite) at .dhis2/tokens.sqlite, keyed by profile name.
open_client(profile) context manager — the canonical "give me a connected client" entry point for plugin services.

Plugins shipped

metadata, data, analytics, tracker, user, user_group, user_role, route, apps, messaging, files, maintenance, doctor, customize, system, profile, dev, browser (CLI-only, opt-in via [browser] extra).

Each plugin lives at packages/dhis2w-core/src/dhis2w_core/v{41,42,43,44}/plugins/<name>/ (per-version subpackage; one tree per DHIS2 major) with service.py (typed business logic) and cli.py (Typer commands). The plugin's FastMCP tools live in the dhis2w-mcp pack as dhis2w_mcp/tools/v{N}/<name>.py — both surfaces call the same service.py.

Documentation

Full architecture: https://winterop-com.github.io/dhis2w/architecture/overview/.

dhis2w-core is one member of the dhis2w workspace.

Metadata

Release files for dhis2w-core 1.31.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dhis2w-core 1.31.0
File	Size	Uploaded
dhis2w_core-1.31.0.tar.gz	758.2 kB	Oct 1, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for dhis2w-core 1.31.0
File	Interpreter	ABI	Platform	Reset
dhis2w_core-1.31.0-py3-none-any.whl 940.5 kB Oct 1, 2026	Python 3	none	any	Details

Total release size: 1.7 MB

Release files / dhis2w_core-1.31.0.tar.gz

Download URL	dhis2w_core-1.31.0.tar.gz
Size	758.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`67bd4f5db1f5464b358c1cfe1fc3dd70655e68b14c0c35e6c450c8f5af3863a8`
BLAKE2b-256 checksum How to use checksums	`32efc642658893fe07184257334ff07b65ff8fa94d68a9e831489a5baa2fd120`
Upload date	Oct 1, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/winterop-com/dhis2w
Publishing commit: github.com/winterop-com/dhis2w/tree/6bb8e1f97e1e7220eccf40c23f2cf64aac299f9d

Workflow

Publishing configuration: github.com/winterop-com/dhis2w/blob/6bb8e1f97e1e7220eccf40c23f2cf64aac299f9d/.github/workflows/pypi-publish.yml
Publishing logs: github.com/winterop-com/dhis2w/actions/runs/36844750475/attempts/1

Artifact

Subject: dhis2w_core-1.31.0.tar.gz
SHA-256 checksum: 67bd4f5db1f5464b358c1cfe1fc3dd70655e68b14c0c35e6c450c8f5af3863a8 Verifying attestations

Release files / dhis2w_core-1.31.0-py3-none-any.whl

Download URL	dhis2w_core-1.31.0-py3-none-any.whl
Size	940.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`2c9c972879ff8a4f2bc88a4d8ff358c3710ad9414e85f32c8f55f260a02fc170`
BLAKE2b-256 checksum How to use checksums	`16656b267851a1bd2c940abb9115099be3667867acd9e819d53b58e8e0b1810a`
Upload date	Oct 1, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/winterop-com/dhis2w
Publishing commit: github.com/winterop-com/dhis2w/tree/6bb8e1f97e1e7220eccf40c23f2cf64aac299f9d

Workflow

Publishing configuration: github.com/winterop-com/dhis2w/blob/6bb8e1f97e1e7220eccf40c23f2cf64aac299f9d/.github/workflows/pypi-publish.yml
Publishing logs: github.com/winterop-com/dhis2w/actions/runs/36844750475/attempts/1

Artifact

Subject: dhis2w_core-1.31.0-py3-none-any.whl
SHA-256 checksum: 2c9c972879ff8a4f2bc88a4d8ff358c3710ad9414e85f32c8f55f260a02fc170 Verifying attestations