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.

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

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

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

LicenseRef-Proprietary
View SPDX License List

Requires

Python >=3.13

Classifiers

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-1.3.0.tar.gz (749.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-1.3.0-py3-none-any.whl (962.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: dhis2w_core-1.3.0.tar.gz
  • Upload date:
  • Size: 749.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-1.3.0.tar.gz
Algorithm Hash digest
SHA256 ff7d0a5173922fb2b865799d797c0f6395829b23a63a5ed213a5ee6edec7cdf8
MD5 b6bde5705d613dd85eef3a026615165e
BLAKE2b-256 4caf0ea1c4b74862cd1cd824bd875875693ac4eb441c7e6d5878aaf59febe1ae

See more details on using hashes here.

Provenance

The following attestation bundles were made for dhis2w_core-1.3.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-1.3.0-py3-none-any.whl.

File metadata

  • Download URL: dhis2w_core-1.3.0-py3-none-any.whl
  • Upload date:
  • Size: 962.2 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-1.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 86b906bb8b801f12853408ac439d7fa9b594f7183f86446c4e6705ddbd69e3ef
MD5 f469d53d99aa3910af89740eb9221eee
BLAKE2b-256 c7da05ce4307201a837733c84704f990fc3ff0710d6b315258006632d7d819a8

See more details on using hashes here.

Provenance

The following attestation bundles were made for dhis2w_core-1.3.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