Makefile

SHELL := /bin/bash

PACKAGE_DIR := rest_registration
TESTS_DIR := tests
DIST_DIR := dist
BUILD_DIR := build
DOCS_DIR := docs
DOCS_SRC_DIR := ${DOCS_DIR}
DOCS_BUILD_DIR := "${DOCS_DIR}/_build"
DOCS_REFERENCE_DIR := "${DOCS_DIR}/reference"

GREP := grep
AWK := awk
SORT := sort
RM := rm
FIND := find
XARGS := xargs
CAT := cat

PYTHON := python
FLAKE8 := flake8
FLAKE8_OPTS :=
MYPY := mypy
MYPY_OPTS :=
PYLINT := pylint
PYLINT_OPTS := --rcfile=pyproject.toml
PYTEST := pytest
PYTEST_OPTS :=  --failed-first
TWINE := twine
TWINE_REPOSITORY := django-rest-registration
PIP := pip
PIP_COMPILE := pip-compile
PIP_COMPILE_OPTS := --upgrade --resolver=backtracking
SPHINXBUILD := sphinx-build
SPHINXBUILD_OPTS :=
SPHINXBUILD_WARNING_LOG = sphinx-warnings.log
SPHINXAUTOBUILD := sphinx-autobuild
SPHINXAUTOBUILD_OPTS := --watch ${PACKAGE_DIR} --ignore ${DOCS_REFERENCE_DIR}

BUMPVERSION_DIFF_FILES := diff-files.txt

.PHONY: help
help: ## Display this help screen
	@grep -E '^[\.a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'

.PHONY: all
all: check test build check-package  ## check code, test, build, check package

.PHONY: install-dev
install-dev:  ## install all pip requirements and the package as editable
	${PYTHON} -m pip install -r requirements/requirements-dev.lock.txt ${ARGS}
	${PYTHON} -m pip install -e .

.PHONY: install-ci
install-ci:  ## install all pip requirements needed for CI and the package as editable
	${PYTHON} -m pip install -r requirements/requirements-ci.lock.txt ${ARGS}
	${PYTHON} -m pip install -e .

.PHONY: install-test
install-test:  ## install all pip requirements needed for testing and the package as editable
	${PYTHON} -m pip install -r requirements/requirements-test.lock.txt ${ARGS}
	${PYTHON} -m pip install -e .

.PHONY: upgrade-requirements-lockfiles
upgrade-requirements-lockfiles:  ## upgrade pip requirements lock files
	${PIP_COMPILE} ${PIP_COMPILE_OPTS} setup.py requirements/requirements-base.in  --output-file=requirements/requirements-base.lock.txt
	${PIP_COMPILE} ${PIP_COMPILE_OPTS} requirements/requirements-base.lock.txt requirements/requirements-test.in --output-file=requirements/requirements-test.lock.txt
	${PIP_COMPILE} ${PIP_COMPILE_OPTS} requirements/requirements-test.lock.txt requirements/requirements-ci.in --output-file=requirements/requirements-ci.lock.txt
	${PIP_COMPILE} ${PIP_COMPILE_OPTS} requirements/requirements-ci.lock.txt requirements/requirements-dev.in --output-file=requirements/requirements-dev.lock.txt

.PHONY: upgrade-dev
upgrade-dev: upgrade-requirements-lockfiles install-dev  ## upgrade all pip requirements and reinstall package as editable

.PHONY: upgrade-ci
upgrade-test: upgrade-requirements-lockfiles install-ci  ## upgrade all pip requirements needed for CI and reinstall package as editable

.PHONY: upgrade-test
upgrade-test: upgrade-requirements-lockfiles install-test  ## upgrade all pip requirements needed for testing and reinstall package as editable

.PHONY: test
test:  ## run tests
	${PYTEST} ${PYTEST_OPTS} ${ARGS}

.PHONY: check
check: flake8 mypy pylint check-docs  ## run checks: flake8, mypy, pylint, check-docs

.PHONY: flake8
flake8:  ## run flake8
	${FLAKE8} ${FLAKE8_OPTS} ${ARGS}

.PHONY: mypy
mypy:  ## run mypy
	${MYPY} ${MYPY_OPTS} ${PACKAGE_DIR} ${ARGS}

.PHONY: pylint
pylint:  ## run pylint
# run pylint for production code and test code separately
	${PYLINT} ${PYLINT_OPTS} ${PACKAGE_DIR} ${DOCS_DIR} ./*.py ${ARGS}
	${PYLINT} ${PYLINT_OPTS} --disable=duplicate-code --disable=redefined-outer-name --disable=too-many-arguments ${TESTS_DIR} ${ARGS}

.PHONY: upload-package
upload-package: build-package check-package  ## upload the package to PyPI
	${TWINE} upload --repository ${TWINE_REPOSITORY} ${DIST_DIR}/*

.PHONY: check-package
check-package: build-package  ## check that the built package is well-formed
	${TWINE} check ${DIST_DIR}/*

.PHONY: build
build: build-package  ## alias for build-package

.PHONY: build-package
build-package:  ## build package (source + wheel)
	-${RM} -r ${DIST_DIR}
	${PYTHON} -m build

.PHONY: bump-version-patch
bump-version-patch: bump-version-check  ## bump package version by the patch part
	git add CHANGELOG.md
	bump2version patch --allow-dirty

.PHONY: bump-version-minor
bump-version-minor: bump-version-check  ## bump package version by the minor part
	git add CHANGELOG.md
	bump2version minor --allow-dirty

.PHONY: bump-version-check
bump-version-check:
	git diff --name-status
	git diff-files --name-only | grep -q CHANGELOG.md

.PHONY: build-docs
build-docs:  ## build documentation
	${SPHINXBUILD} ${SPHINXBUILD_OPTS} ${DOCS_SRC_DIR} ${DOCS_BUILD_DIR}/html ${ARGS}

.PHONY: check-docs
check-docs:  ## check that the docs do not contain any warnings / errors
	${SPHINXBUILD} ${SPHINXBUILD_OPTS} ${DOCS_SRC_DIR} ${DOCS_BUILD_DIR}/html -w ${SPHINXBUILD_WARNING_LOG} ${ARGS}
	${CAT} ${SPHINXBUILD_WARNING_LOG}
	@${SHELL} -c '[ ! -s ${SPHINXBUILD_WARNING_LOG} ]'

.PHONY: watch-docs
watch-docs:  ## build documentation in watch mode (will start additonal http server)
	${SPHINXAUTOBUILD} ${SPHINXAUTOBUILD_OPTS} ${DOCS_SRC_DIR} ${DOCS_BUILD_DIR}/html ${ARGS}

.PHONY: clean
clean:  ## remove generated files
	-${RM} -r .tox
	-${RM} -r .pytest_cache
	-${RM} -r .mypy_cache

	${FIND} "." -iname '__pycache__' -type d -print0 | ${XARGS} -0 ${RM} -r

	-${RM} TEST-*.xml

	-${RM} .coverage
	-${RM} coverage.xml
	-${RM} -r coverage_html_report

	-${RM} -r ${DIST_DIR}
	-${RM} -r ${BUILD_DIR}
	-${RM} -r ${DOCS_BUILD_DIR}