Makefile

.DEFAULT_GOAL := help
RABBITMQ_CONTAINER := "prs-rabbitmq"
SWAGGER_CONTAINER := "prs-swagger-ui"

define BROWSER_PYSCRIPT
import os, webbrowser, sys
try:
	from urllib import pathname2url
except:
	from urllib.request import pathname2url

webbrowser.open("file://" + pathname2url(os.path.abspath(sys.argv[1])))
endef
export BROWSER_PYSCRIPT
BROWSER := python -c "$$BROWSER_PYSCRIPT"

clean: clean-build clean-pyc clean-test ## remove all build, test, coverage and Python artifacts

clean-build: ## remove build artifacts
	rm -fr build/
	rm -fr dist/
	rm -fr .eggs/
	find . -name '*.egg-info' -exec rm -fr {} +
	find . -name '*.egg' -exec rm -f {} +

clean-pyc: ## remove Python file artifacts
	find . -name '*.pyc' -exec rm -f {} +
	find . -name '*.pyo' -exec rm -f {} +
	find . -name '*~' -exec rm -f {} +
	find . -name '__pycache__' -exec rm -fr {} +

clean-test: ## remove test and coverage artifacts
	rm -fr .tox/
	rm -f .coverage
	rm -fr htmlcov/
	rm -fr .pytest_cache

.PHONY: lint
lint: ## Check code style
	@echo "+ $@"
	@ruff check

.PHONY: test
test: export DJANGO_SETTINGS_MODULE = polarrouteserver.settings.test
test: ## Run tests quickly with the default Python
	@echo "+ $@"
	@pytest

.PHONY: cov-badge
test: ## Generate the coverage badge from .coverage file
	@echo "+ $@"
	@coverage-badge -o coverage.svg

# .PHONY: docs
# docs: ## Generate Sphinx HTML documentation, including API docs
# 	@echo "+ $@"
# 	@tox -e docs
# 	@$(BROWSER) docs/_build/html/index.html

# .PHONY: servedocs
# servedocs: ## Rebuild docs automatically
# 	@echo "+ $@"
# 	@tox -e servedocs

.PHONY: migrate
migrate: ## Apply database migrations (or create for first time)
	@echo "+ $@"
	@python manage.py migrate

.PHONY: migrations
migrations: ## Create database migration files from changes to models
	@echo "+ $@"
	@python manage.py makemigrations

.PHONY: start-dev-server
start-dev-server: export DJANGO_SETTINGS_MODULE = polarrouteserver.settings.development
start-dev-server: ## start Django dev server
	@echo "+ $@"
	@python manage.py runserver &

.PHONY: stop-dev-server
stop-dev-server: ## Stop Django dev server
	@echo "+ $@"
	@pkill -9 -f 'python manage.py runserver'

.PHONY: start-django-server
start-django-server: ## Start Django server (gunicorn)
	@echo "+ $@"
	@gunicorn polarrouteserver.wsgi &

.PHONY: stop-django-server
stop-django-server: ## Stop Django dev server
	@echo "+ $@"
	@pkill -9 -f 'gunicorn polarrouteserver.wsgi'

.PHONY: start-celery
start-celery: start-rabbitmq ## Start celery
	@echo "+ $@"
	@DJANGO_SETTINGS_MODULE='polarrouteserver.settings.development' celery -A polarrouteserver  worker --beat --scheduler django --loglevel=info --detach

.PHONY: stop-celery
stop-celery: ## Stop celery
	@echo "+ $@"
	@pkill -9 -f 'celery -A polarrouteserver'

.PHONY: start-rabbitmq
start-rabbitmq: ## Start rabbitmq via docker
	@echo "+ $@"
	@docker run -d -p 5672:5672 --name ${RABBITMQ_CONTAINER} rabbitmq

.PHONY: stop-rabbitmq
stop-rabbitmq: ## Stop rabbitmq docker container
	@echo "+ $@"
	@docker stop ${RABBITMQ_CONTAINER}
	@docker rm ${RABBITMQ_CONTAINER}

.PHONY: serve-dev
export DJANGO_SETTINGS_MODULE=polarrouteserver.settings.development
serve-dev: start-rabbitmq start-celery start-dev-server ## Run all the components for serving a development instance.

.PHONY: stop-serve-dev
export DJANGO_SETTINGS_MODULE=polarrouteserver.settings.development
stop-serve-dev: stop-rabbitmq stop-celery stop-dev-server # stop all dev serve components (rabbitmq, celery, devserver)

.PHONY: start-swagger
start-swagger: ## Start swagger-ui container with API schema
	@echo "+ $@"
	@docker run -p 80:8080 -e SWAGGER_JSON=/schema.yml -v ${PWD}/schema.yml:/schema.yml --name ${SWAGGER_CONTAINER} swaggerapi/swagger-ui

.PHONY: stop-swagger
stop-swagger: ## Stop swagger-ui docker container
	@echo "+ $@"
	@docker stop ${SWAGGER_CONTAINER}
	@docker rm ${SWAGGER_CONTAINER}

.PHONY: build
build: ## Build package
	@echo "+ $@"
	@python -m build

.PHONY: release
release: ## tag the HEAD commit and update version in pyproject.toml with the value of: "version=0.1.2", e.g. make release version=0.1.2
	@echo "+ $@"
	@sed -i "s/^version = \".*\"/version = \"$(version)\"/" pyproject.toml
	@git add pyproject.toml
	@git commit -m 'release version $(version)'
	@git tag v$(version) HEAD

.PHONY: help
help:
	@echo "Note: Remember to activate your virtual environment (if used)."
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-16s\033[0m %s\n", $$1, $$2}'