dhis2w-cli
Typer console script d2w for working with DHIS2 instances from the shell. Discovers plugins from dhis2w-core — sixteen top-level domains covering metadata, data, analytics, tracker, users, routes, files, messaging, apps, doctor, and developer tools.
Install
# Drops `d2w` on $PATH
uv tool install dhis2w-cli
# With Playwright UI automation (browser screenshots, OIDC login, PAT minting)
uv tool install 'dhis2w-cli[browser]'
playwright install chromium # one-time, after the install above
# Update later
uv tool upgrade dhis2w-cli
Or run on demand without installing:
uvx --from dhis2w-cli d2w --help
Configure
The CLI reads a profile from .dhis2/profiles.toml (project) or ~/.config/dhis2/profiles.toml (user). One-shot bootstrap:
d2w profile bootstrap mywork
Or set env vars and skip the profile system entirely:
export DHIS2_URL=https://dhis2.example.org
export DHIS2_PAT=d2p_...
d2w system info
Surface
d2w analytics DHIS2 analytics queries.
d2w apps DHIS2 apps — /api/apps + /api/appHub.
d2w browser Playwright UI automation (only with [browser] extra).
d2w data DHIS2 data values (aggregate + tracker).
d2w dev Developer/operator tools.
d2w doctor Probe a DHIS2 instance for known gotchas + requirements.
d2w files Manage DHIS2 documents + file resources.
d2w maintenance DHIS2 maintenance (tasks, cache, integrity, cleanup, refresh).
d2w messaging DHIS2 internal messaging.
d2w metadata DHIS2 metadata inspection.
d2w profile Manage DHIS2 profiles.
d2w route DHIS2 integration routes.
d2w system DHIS2 system info.
d2w user DHIS2 user administration.
d2w user-group DHIS2 user-group administration.
d2w user-role DHIS2 user-role administration.
d2w --help for the full tree; d2w <group> --help for each.
Documentation
Full CLI reference: https://winterop-com.github.io/dhis2w-utils/cli-reference/.
dhis2w-cli is one member of the dhis2w-utils workspace. The MCP server (dhis2w-mcp) exposes the same plugin surface as MCP tools.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file dhis2w_cli-1.2.0.tar.gz.
File metadata
- Download URL: dhis2w_cli-1.2.0.tar.gz
- Upload date:
- Size: 5.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ca9169358bf3b10913525f4a5172e9832fbbc74d60f488c34fc76bf129d919ae
|
|
| MD5 |
c478d366f111b9dbdee6561321262488
|
|
| BLAKE2b-256 |
f20a863aad1a90f165b45169786793baed8215c99b0145645a4814a5e7beb29c
|
Provenance
The following attestation bundles were made for dhis2w_cli-1.2.0.tar.gz:
Publisher:
pypi-publish.yml on winterop-com/dhis2w-utils
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
dhis2w_cli-1.2.0.tar.gz -
Subject digest:
ca9169358bf3b10913525f4a5172e9832fbbc74d60f488c34fc76bf129d919ae - Sigstore transparency entry: 2152565516
- Sigstore integration time:
-
Permalink:
winterop-com/dhis2w-utils@eb467a761da1ad9a08ade6834e0bbf669ea6003c -
Branch / Tag:
refs/tags/v1.2.0 - Owner: https://github.com/winterop-com
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi-publish.yml@eb467a761da1ad9a08ade6834e0bbf669ea6003c -
Trigger Event:
push
-
Statement type:
File details
Details for the file dhis2w_cli-1.2.0-py3-none-any.whl.
File metadata
- Download URL: dhis2w_cli-1.2.0-py3-none-any.whl
- Upload date:
- Size: 7.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cde8b9a19e5ceee5bebda2f3b77ef21a1c6201fea614ae19d6cb706626ac9bb7
|
|
| MD5 |
e6aa468804bf9fed515fb1fbc9631b30
|
|
| BLAKE2b-256 |
0b82a0c5fd98fc2d569ded537916dee82e17942738c2ab7e2d8575cfcf89898c
|
Provenance
The following attestation bundles were made for dhis2w_cli-1.2.0-py3-none-any.whl:
Publisher:
pypi-publish.yml on winterop-com/dhis2w-utils
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
dhis2w_cli-1.2.0-py3-none-any.whl -
Subject digest:
cde8b9a19e5ceee5bebda2f3b77ef21a1c6201fea614ae19d6cb706626ac9bb7 - Sigstore transparency entry: 2152566155
- Sigstore integration time:
-
Permalink:
winterop-com/dhis2w-utils@eb467a761da1ad9a08ade6834e0bbf669ea6003c -
Branch / Tag:
refs/tags/v1.2.0 - Owner: https://github.com/winterop-com
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi-publish.yml@eb467a761da1ad9a08ade6834e0bbf669ea6003c -
Trigger Event:
push
-
Statement type:
