Skip to content

dhis2w-client API reference

Auto-generated from the dhis2w-client source via mkdocstrings. Every class, method, and function listed here is importable from dhis2w_client (top-level re-exports) or from its module.

For prose explanations with worked examples, see the dhis2w-client step-by-step guide.

Layout

  • Client + lifecycle — Dhis2Client, connect, close, raw escape hatches
  • Auth providers — BasicAuth, PatAuth, OAuth2Auth, the AuthProvider Protocol, OAuth2Token, TokenStore
  • Errors — the exception hierarchy
  • Envelopes + responses — WebMessageResponse, Conflict, ImportCount, ObjectReport, ImportReport
  • Route auth schemes — the 5-variant discriminated AuthScheme union
  • Sharing — typed SharingObject + SharingBuilder + get_sharing / apply_sharing helpers over /api/sharing
  • Generated-model helpers — Dhis2 enum, available_versions, load
  • OpenAPI-derived models — the 562+ classes emitted under generated/v42/oas/ from /api/openapi.json
  • System module — Me, SystemInfo, SystemModule
  • Tracker reads — instance models, status enums
  • Aggregate — DataValue, DataValueSet
  • Data values (streaming) — DataValuesAccessor on Dhis2Client.data_values (streaming /api/dataValueSets imports)
  • Analytics — Grid, GridHeader (OAS-emitted) + AnalyticsMetaData (typed parser helper over Grid.metaData)
  • Analytics streaming — AnalyticsAccessor on Dhis2Client.analytics (chunked /api/analytics* downloads)
  • Maintenance — Notification, DataIntegrityCheck, DataIntegrityResult, DataIntegrityReport
  • Metadata accessor — MetadataAccessor on Dhis2Client.metadata (bulk delete + multi-resource operations)
  • Customize — CustomizeAccessor, LoginCustomization, CustomizationResult
  • Files — FilesAccessor, Document, FileResource, FileResourceDomain — documents + file-resource uploads/downloads
  • Messaging — MessagingAccessor on Dhis2Client.messaging (/api/messageConversations)
  • Apps — AppsAccessor on Dhis2Client.apps — install / uninstall / update over /api/apps + /api/appHub
  • Validation + predictors — ValidationAccessor + PredictorsAccessor for the run-rules + run-predictors workflow
  • Visualizations + dashboards — VisualizationsAccessor + VisualizationSpec + DashboardsAccessor + DashboardSlot for authoring saved analytics + composing dashboards
  • Maps — MapsAccessor + MapSpec + MapLayerSpec for thematic choropleths + map composition
  • Legend sets — LegendSetsAccessor + LegendSetSpec + LegendSpec — colour-range authoring attached to visualizations and maps
  • Organisation units — OrganisationUnitsAccessor + OrganisationUnitGroupsAccessor + OrganisationUnitGroupSetsAccessor + OrganisationUnitLevelsAccessor — tree-aware reads, per-level naming, group + group-set membership
  • Data elements — DataElementsAccessor + DataElementGroupsAccessor + DataElementGroupSetsAccessor — aggregate + tracker DE authoring, thematic groups, analytics dimensions
  • Indicators — IndicatorsAccessor + IndicatorGroupsAccessor + IndicatorGroupSetsAccessor — computed-ratio authoring with expression validation, per-item membership shortcuts
  • Program indicators — ProgramIndicatorsAccessor + ProgramIndicatorGroupsAccessor — tracker-analytics authoring (pair only; DHIS2 doesn't expose a ProgramIndicatorGroupSet)
  • Category options — CategoryOptionsAccessor + CategoryOptionGroupsAccessor + CategoryOptionGroupSetsAccessor — disaggregation values + validity windows + analytics dimensions
  • SQL views — SqlViewsAccessor + SqlViewRunner for DHIS2 SqlView execution workflows
  • Periods — PeriodType StrEnum
  • UIDs — client-side UID generator + validator