Skip to content


Issues and pull requests are more than welcome.

dev install

$ git clone
$ cd rio-cogeo
$ pip install -e .["test","dev"]
You can then run the tests with the following command:

python -m pytest --cov rio_cogeo --cov-report term-missing


This repo is set to use pre-commit to run isort, flake8, pydocstring, black ("uncompromising Python code formatter") and mypy when committing new code.

$ pre-commit install


$ git clone
$ cd rio-cogeo
$ pip install -e .["docs"]

Hot-reloading docs (from repository root):

$ mkdocs serve -f docs/mkdocs.yml

To manually deploy docs (note you should never need to do this because Github Actions deploys automatically for new commits.):

$ mkdocs gh-deploy