Metadata-Version: 2.4
Name: eumdac
Version: 4.0.0
Summary: EUMETSAT Data Access Client
Keywords: EUMETSAT,satellite data,data access,eumdac
Author: EUMETSAT
Author-email: EUMETSAT <ops@eumetsat.int>
License-Expression: MIT
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.15
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
Requires-Dist: paho-mqtt>=2.1.0
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: requests>=2.32.5
Requires-Dist: urllib3>=2.6.3
Requires-Python: >=3.11
Project-URL: API Reference, https://usc.tools.eumetsat.int/docs/eumdac/
Project-URL: Documentation, https://user.eumetsat.int/resources/user-guides/eumetsat-data-access-client-eumdac-guide
Project-URL: Homepage, https://gitlab.eumetsat.int/eumetlab/data-services/eumdac
Description-Content-Type: text/markdown

# EUMDAC - EUMETSAT Data Access Client

**EUMDAC** is the **EUM**ETSAT **D**ata **A**ccess **C**lient. It provides simple access to the EUMETSAT data of all satellite missions. As a **Python library**, it comes with many methods and helpers to use EUMETSATs APIs and services, like Data Store and Data Tailor. As a **CLI**, it provides a variety of useful command line utilities for data search, translation and processing.

Please consult the following documentation for more information:
- [EUMDAC User Guide](https://user.eumetsat.int/resources/user-guides/eumetsat-data-access-client-eumdac-guide) - Installing and using the CLI and library.
- [EUMDAC API Reference](https://usc.tools.eumetsat.int/docs/eumdac/) - Detailed information on classes, functions, and modules, including method descriptions and parameter usage.


## Prerequisites
 
You will need a Python environment to run the library. EUMDAC requires Python **3.11** or higher. 

The [uv package manager](https://docs.astral.sh/uv/) is suggested for working with eumdac.

## Dependencies

The project uses modern tooling and its dependencies are declared in `pyproject.toml`. The runtime dependencies are:
- `paho-mqtt>=2.1.0`
- `pyyaml>=6.0.3`
- `requests>=2.32.5`
- `urllib3>=2.6.3`

## Installing the EUMDAC library and CLI

### Installing with PIP

The EUMDAC Python package is available through [PyPI](https://pypi.org/):
```bash
pip install eumdac
```

### Installing with Conda

To install EUMDAC on the Anaconda Python distribution, please visit the [EUMETSAT conda-forge page](https://anaconda.org/Eumetsat/repo) for install instructions.
```bash
conda install -c eumetsat-forge eumdac
```

### Installing from source

To install EUMDAC from the development source, clone the repository and install it locally. 

You will need `uv` to follow the instructions below, see https://docs.astral.sh/uv/.

```bash
git clone https://gitlab.eumetsat.int/eumetlab/data-services/eumdac.git
cd eumdac
# Install runtime dependencies
uv sync
# Install the package in development mode
uv pip install -e .
```

## Using the EUMDAC CLI binaries (no installation required)
If an installation of EUMDAC is not possible due to missing technical prerequisites, we recommend to use our binaries. These executable applications allow you to use all the functions of the CLI without installation. 

The binaries are available for Windows, Linux and Mac in the [Releases section](https://gitlab.eumetsat.int/eumetlab/data-services/eumdac/-/releases).

You can find more information in the [EUMDAC User Guide](https://user.eumetsat.int/resources/user-guides/eumetsat-data-access-client-eumdac-guide#ID-Command-Line-guide).

## Contributing
If you feel like something is missing, should work differently or you find a bug in EUMDAC you are encouraged to provide feedback to the development team. Please contact us via the [EUMETSAT User Support Helpdesk](mailto:ops@eumetsat.int) if you have suggestions or questions.

## Authors
See AUTHORS.txt for the list of contributors.

## License
 
This code is licensed under an MIT license. See file LICENSE.txt for details on the usage and distribution terms. No dependencies are distributed as part of this package.

All product names, logos, and brands are property of their respective owners. All company, product and service names used in this website are for identification purposes only.

