dhis2w-core

Shared runtime for dhis2w-cli and dhis2w-mcp: 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 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 registry — walks dhis2w_core.v{41,42,43}.plugins.* plus entry_points("dhis2.plugins") for external plugins. Each plugin exposes register_cli(app) and register_mcp(server).
  • 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}/plugins/<name>/ (per-version subpackage; one tree per DHIS2 major) with service.py (typed business logic), cli.py (Typer commands), and mcp.py (FastMCP tools) — both surfaces call the same service.py.

Documentation

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

dhis2w-core is one member of the dhis2w-utils workspace.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.3.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for mortenoh from gravatar.com mortenoh

Credits

PyPI data
Data sourced directly from PyPI's database.

Author: Morten Hansen

Requires

Python >=3.13

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dhis2w_core-0.99.0.tar.gz (740.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dhis2w_core-0.99.0-py3-none-any.whl (952.5 kB view details)

Uploaded Python 3

File details

Details for the file dhis2w_core-0.99.0.tar.gz.

File metadata

  • Download URL: dhis2w_core-0.99.0.tar.gz
  • Upload date:
  • Size: 740.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for dhis2w_core-0.99.0.tar.gz
Algorithm Hash digest
SHA256 07c1b75675d629e7b7e6719129db964e44b1741c97aee3cdfb29d52a859ddc16
MD5 937a26e10938ce07256759caf9aa5fc8
BLAKE2b-256 19e2379aecb63d975eb9f9fc8df582f2cf929ab53efdfe9a434a6210e8755dec

See more details on using hashes here.

Provenance

The following attestation bundles were made for dhis2w_core-0.99.0.tar.gz:

Publisher: pypi-publish.yml on winterop-com/dhis2w-utils

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file dhis2w_core-0.99.0-py3-none-any.whl.

File metadata

  • Download URL: dhis2w_core-0.99.0-py3-none-any.whl
  • Upload date:
  • Size: 952.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for dhis2w_core-0.99.0-py3-none-any.whl
Algorithm Hash digest
SHA256 87bccd7a4782ea07431335b02ca6938fe63d2321b9e719b82db36e9fe92b1649
MD5 a7d447b26a22eccc1817eaf10216e287
BLAKE2b-256 e85a40dd98b057afd6ce0463f3476d7444ff30553ca6aa296fac327e6e324548

See more details on using hashes here.

Provenance

The following attestation bundles were made for dhis2w_core-0.99.0-py3-none-any.whl:

Publisher: pypi-publish.yml on winterop-com/dhis2w-utils

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page