Skip to content

Latest commit

 

History

History
70 lines (50 loc) · 1.33 KB

CONTRIBUTING.md

File metadata and controls

70 lines (50 loc) · 1.33 KB

How to Contribute

Features or Bug Fixes

  1. Fork the raster_tools repo.

  2. Clone your fork.

  3. Move to the raster_tools project root:

    $ cd raster_tools
  4. Create a python virtual environment

    With conda:

    $ conda env create -f requirements/dev.yml
    $ conda activate rts

    With python:

    $ python -m venv venv
    $ . venv/bin/activate
    $ pip install -r ./requirements/dev.txt
  5. Install the project into the virtual environment:

    $ pip install -e .
  6. Setup pre-commit hooks

    $ pre-commit install
  7. Create your development branch:

    $ git checkout -b my-dev-branch
  8. Run the tests and fix anything that broke:

    $ pytest
  9. (Optional) Run pre-commit to find/fix any formatting and flake8 issues:

    $ pre-commit run --all-files

    This will run isort, black, and flake8 on the repo's files. It is recommended to do this and fix any errors that are flagged so that the changes can be cleanly commited.

  10. Commit your changes to your branch and push to your remote repo:

    $ git add .
    $ git commit -m "A detailed description of the changes."
    $ git push origin my-dev-branch
  11. Submit a pull request through GitHub.