Skip to content

Latest commit

 

History

History
62 lines (49 loc) · 1.18 KB

CONTRIBUTING.md

File metadata and controls

62 lines (49 loc) · 1.18 KB
Raw

Contributing

Issues and pull requests are more than welcome.

dev install

$ git clone https://github.com/cogeotiff/rio-tiler.git
$ cd rio-tiler
$ pip install -e .[dev]

pre-commit

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

Docs

$ git clone https://github.com/cogeotiff/rio-tiler.git
$ cd rio-tiler
$ pip install -e .["docs"]

Hot-reloading docs:

$ mkdocs serve

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

$ mkdocs gh-deploy
pdocs as_markdown \
   --output_dir docs/api/ \
   --exclude_source \
   --overwrite \
   rio_tiler.colormap \
   rio_tiler.constants \
   rio_tiler.errors \
   rio_tiler.expression \
   rio_tiler.models \
   rio_tiler.io.base \
   rio_tiler.io.cogeo \
   rio_tiler.io.stac \
   rio_tiler.mosaic.methods.base \
   rio_tiler.mosaic.methods.defaults \
   rio_tiler.mosaic.reader \
   rio_tiler.profiles \
   rio_tiler.reader \
   rio_tiler.tasks \
   rio_tiler.utils