fdb-utils

Python library for users and admins of FDB.

Installation

Dependencies

FDB Utils depends on the FDB and Eccodes libraries, these are not installed with pip. The following environment variables need to be set:

export FDB5_CONFIG_FILE=<path/to/fdb-config.yaml>
export FDB5_DIR=<path/to/fdb/home>
export ECCODES_HOME=<path/to/eccodes/home>

See MeteoSwiss Confluence for the environment variables to use for MeteoSwiss's realtime FDB (at CSCS).

Install the package from PyPI (MeteoSwiss Nexus, see how to setup Nexus PyPI access from CSCS)

pip install fdb-utils

fdb-utils --help

Development

Setup virtual environment

cd fdb-utils
poetry install

Run tests

poetry run pytest

Run tests within the uenv

uenv start --view=realtime fdb/5.18:<latest_version>
poetry install
poetry run pytest

Generate documentation

poetry run sphinx-build doc doc/_build

Then open the index.html file generated in fdb-utils/build/_build/

Build wheels

poetry build