Metadata-Version: 2.4
Name: ddsapi
Version: 2026.6.3
Summary: Python Client to access and download data from CMCC Data Delivery System (DDS)
Author-email: CMCC Data Delivery System Team <dds-support@cmcc.it>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/CMCC-Foundation/ddsapi-client/
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
Classifier: Topic :: Scientific/Engineering :: Hydrology
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Requires-Dist: urllib3
Provides-Extra: data
Requires-Dist: xarray; extra == "data"
Requires-Dist: dask; extra == "data"
Requires-Dist: zarr; extra == "data"
Requires-Dist: netCDF4; extra == "data"
Requires-Dist: h5netcdf; extra == "data"
Requires-Dist: cf-xarray; extra == "data"
Requires-Dist: requests; extra == "data"
Requires-Dist: aiohttp; extra == "data"
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Dynamic: license-file

# DDSAPI-Client
Python Client to access and download data from [CMCC Data Delivery System (DDS)](https://dds.cmcc.it)

## Requirements
Python 3.11 or greater is required

### Installation

The base client is lightweight (HTTP only). The libraries needed to **open** the
retrieved datasets (xarray, zarr, netCDF4, …) are optional — install them only if you
need to work with the downloaded data.

#### conda

From the `cmcc-dds` channel:
```bash
$ conda install -c cmcc-dds ddsapi
```

To also open the downloaded datasets, add the data stack (from conda-forge):
```bash
$ conda install -c conda-forge xarray zarr netcdf4 h5netcdf dask cf-xarray
```

#### pip
```bash
$ pip install ddsapi
```

To also open the downloaded datasets, install the optional `data` extra:
```bash
$ pip install 'ddsapi[data]'
```

### Configuration
To use the tool a file `$HOME/.ddsapirc` must be created as following

```bash
url: https://ddshub.cmcc.it/api/v2
key: <api-key>
```
