Contributing to the code#
To contribute to the code, we recommend to install PyDAP
within a containerized testing environment, and to follow the approach used worflows in out CI/CD:
conda create -n pydap_tests -c conda-forge python=3.10
conda env update -n pydap_tests -f ci/environment.yml
conda activate pydap_tests
This will create and activate a test environment called pydap_tests
which will contain many of the dependencies necessary for appropriately testing pydap.
Note
If you already have mamba
installed, you can replace all conda
in the commands with mamba
.
Then install pydap in development mode:
pip install -e ".[tests]"
At this point, you can use git for making commits to pydap. Make sure the code follows the style guide by running:
conda install -c conda-forge pre-commit
pre-commit run --all
The above commands install and will automatically run all the pre-commit formatting configuration specified in the yaml-file each time git commit is used.
Lastly, make sure the code is well tested by adding or improving tests in the src/pydap/tests
repository. pydap uses pytest. To run tests run the following command:
pytest -v