Development notes

Conda environment

Only required if you wish to install all the required prerequisites in Miniconda/Anaconda for local development and testing.

conda env create -f environment.yml

Then activate with conda activate synthia.

During development:

pip install -e .[full]
pip install pytest

sphinx-build -v -b html docs/ docs/_build/

Use SKIP_NB=1 to skip building the example notebooks (they take a while to build):

SKIP_NB=1 sphinx-build -v -b html docs/ docs/_build/

Note that type hints are intentionally not rendered as some of them become too complex and are better described in prose, following xarray's style.

python -m pytest -s tests/

Create and upload a new release with the following commands

python setup.py bdist_wheel
pip install --upgrade twine
python -m twine upload dist/*