Merge branch 'development' of https://github.com/hotosm/fmtm into dev…

…elopment

.github/labeler.yml

@@ -10,6 +10,7 @@
   - "**/Dockerfile"
   - "**/*.dockerfile"
   - "**/*entrypoint.sh"
+  - "Justfile"
 "migration":
   - "src/backend/migrations/**/*"
 "documentation":

Justfile

@@ -0,0 +1,107 @@
+# Copyright (c) 2020, 2021 Humanitarian OpenStreetMap Team
+#
+# This file is part of FMTM.
+#
+#     FMTM is free software: you can redistribute it and/or modify
+#     it under the terms of the GNU General Public License as published by
+#     the Free Software Foundation, either version 3 of the License, or
+#     (at your option) any later version.
+#
+#     FMTM is distributed in the hope that it will be useful,
+#     but WITHOUT ANY WARRANTY; without even the implied warranty of
+#     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#     GNU General Public License for more details.
+#
+#     You should have received a copy of the GNU General Public License
+#     along with FMTM.  If not, see <https:#www.gnu.org/licenses/>.
+#
+
+# Builds
+
+build-backend:
+  docker compose build api
+
+build-frontend:
+  docker compose build ui
+
+build: build-backend build-frontend
+
+# Run
+
+run:
+  docker compose up -d
+
+run-without-central:
+  docker compose --profile no-odk up -d
+
+run-with-josm:
+  docker compose \
+    -f docker-compose.yml \
+    -f josm/docker-compose.yml \
+    up -d
+
+stop:
+  docker compose down
+
+clean-db:
+  docker compose down -v
+
+# Tests
+
+test-backend:
+  docker compose run --rm api pytest
+
+test-frontend:
+  docker compose run -e CI=True --rm --entrypoint='sh -c' ui 'npm run test'
+
+test: test-backend test-frontend
+
+# Maintenance
+
+lint:
+  TAG_OVERRIDE=ci TARGET_OVERRIDE=ci docker compose run --rm --no-deps \
+    --volume $PWD:$PWD --workdir $PWD \
+    --entrypoint='sh -c' api \
+    'git config --global --add safe.directory $PWD \
+    && pre-commit run --all-files'
+
+bump:
+  TAG_OVERRIDE=ci TARGET_OVERRIDE=ci docker compose run --rm --no-deps \
+    --volume $PWD:$PWD --workdir $PWD \
+    --entrypoint='sh -c' api \
+    'git config --global --add safe.directory $PWD \
+    && git config --global user.name svcfmtm \
+    && git config --global user.email [email protected] \
+    && cd src/backend \
+    && cz bump --check-consistency'
+
+# Docs
+
+docs-rebuild: docs-clean docs-doxygen docs-uml
+
+docs-clean:
+	@rm -rf docs/{apidocs,html,docbook,man} docs/packages.png docs/classes.png
+
+docs-doxygen:
+	cd docs && doxygen
+
+docs-uml:
+	cd docs && pyreverse -o png ../src/backend/app
+
+docs-pdf:
+  # Strip any unicode out of the markdown file before converting to PDF
+  # FIXME
+  MDS := \
+    docs/dev/Backend.md \
+    docs/dev/Database-Tips.md \
+    docs/dev/Deployment-Flow.md \
+    docs/dev/Frontend.md \
+    docs/dev/Production.md \
+    docs/dev/Version-Control.md \
+    docs/dev/Setup.md \
+    docs/dev/Troubleshooting.md \
+  PDFS := $(MDS:.md=.pdf)
+	@echo "Converting $PDFS to a PDF"
+	@new=$(notdir $(basename $PDFS)); \
+	iconv -f utf-8 -t US $PDFS -c | \
+	pandoc $PDFS -f markdown -t pdf -s -o /tmp/$$new.pdf