# Get all datasets
datasets = dhis.meta.datasets()

# With pagination
datasets = dhis.meta.datasets(
    page=1,
    pageSize=100
)

# With filters
datasets = dhis.meta.datasets(
    filters=["name:ilike:monthly"]
)

# Custom fields
datasets = dhis.meta.datasets(
    fields="id,name,shortName,periodType,dataSetElements[dataElement[id,name]]"
)

# Get datasets with full details
response = dhis.api.get(
    "dataSets",
    params={
        "fields": "id,name,shortName,code,periodType,"
                  "dataSetElements[dataElement[id,name]],"
                  "organisationUnits[id,name]",
        "paging": False
    }
)
datasets = response.get("dataSets", [])

def get_dataset(dhis, dataset_id: str) -> dict:
    """Get single dataset with full details."""
    return dhis.api.get(
        f"dataSets/{dataset_id}",
        params={
            "fields": "*,dataSetElements[*,dataElement[id,name,valueType]],"
                      "organisationUnits[id,name,level],"
                      "sections[id,name,dataElements[id,name]]"
        }
    )

def get_datasets_for_org_unit(dhis, org_unit_id: str) -> list:
    """Get all datasets assigned to an org unit."""
    response = dhis.api.get(
        "dataSets",
        params={
            "fields": "id,name,periodType",
            "filter": f"organisationUnits.id:eq:{org_unit_id}",
            "paging": False
        }
    )
    return response.get("dataSets", [])

def get_dataset_data_elements(dhis, dataset_id: str) -> list:
    """Get all data elements in a dataset."""
    dataset = dhis.api.get(
        f"dataSets/{dataset_id}",
        params={
            "fields": "dataSetElements[dataElement[id,name,valueType,categoryCombo[id,name]]]"
        }
    )
    return [
        dse["dataElement"]
        for dse in dataset.get("dataSetElements", [])
    ]

def get_dataset_sections(dhis, dataset_id: str) -> list:
    """Get dataset form sections."""
    dataset = dhis.api.get(
        f"dataSets/{dataset_id}",
        params={
            "fields": "sections[id,name,sortOrder,dataElements[id,name]]"
        }
    )
    return dataset.get("sections", [])

id,name,shortName,code,
periodType,openFuturePeriods,
expiryDays,timelyDays,
dataSetElements[dataElement[id,name]],
organisationUnits[id,name],
sections[id,name,sortOrder]

def get_dataset_completeness(dhis, dataset_id: str, period: str, org_unit_id: str) -> dict:
    """Get completeness stats for a dataset."""
    response = dhis.api.get(
        "completeDataSetRegistrations",
        params={
            "dataSet": dataset_id,
            "period": period,
            "orgUnit": org_unit_id,
            "children": True
        }
    )
    return response