Development

Get Started!

Check out code from the esgf-pyclient GitHub repo and start the installation:

$ git clone https://github.com/ESGF/esgf-pyclient.git
$ cd esgf-pyclient
$ conda env create -f environment.yml
$ pip install -e .[dev]

When you’re done making changes, check that your changes pass flake8 and the tests:

$ flake8
$ pytest

Or use the Makefile:

$ make lint
$ make test  # skip slow tests
$ make test-all

Write Documentation

You can find the documentation in the docs/source folder. To generate the Sphinx documentation locally you can use the Makefile:

$ make docs

Bump a new version

Make a new version of esgf-pyclient in the following steps:

  • Make sure everything is commit to GitHub.

  • Update CHANGES.rst with the next version.

  • Dry Run: bumpversion --dry-run --verbose --new-version 0.3.1 patch

  • Do it: bumpversion --new-version 0.3.1 patch

  • … or: bumpversion --new-version 0.4.0 minor

  • Push it: git push --tags

See the bumpversion documentation for details.