BUILDING.md

Building

Project Overview

• pyproject.toml specified
• src-layout organized files
• its API documentation web is automated with pdoc
• dynamic versioning with setuptools_csm
• unit tests with pytest
• built & published on a gitlab-ci pipeline running on the latest-qgis docker container running
• published on pypi

Manual Steps

# clean (-n is dry-run, remove to delete)
git clean -dfX -n

# tags check
git tag

# tag create locally & upload
git tag -a v0.3.1 -m 'agglomerative clustering outputs polygon and sieves' && git push origin v0.3.1

# delete tag locally & upstream
git tag --delete v0.3.1 && git push --delete origin v0.3.1

# view calculated version to check is not dirty
python -m setuptools_scm

# build : creates `dist` with .whl & tar.gz files
python -m build

Build the full static webpage locally

if directory exists remove, then build
```bash
rm -rf doc/*
touch doc/.gitkeep
pdoc --output-directory doc --math --show-source --logo https://www.fire2a.com/static/img/logo_1_.png --favicon https://www.fire2a.com/static/img/logo_1_.png fire2a fire2template

Then check the generated webpage

firefox doc/index.html