makefilet/include/python.mk

# The following python-related tools and processes are supported:
#   * black
#   * coverage         (requires ".coveragerc")
#   * flake8
#   * pypi upload      (requires "~/.pypirc")
#   * tox / unittests  (requires "tox.ini")
#

PYTHON_BIN ?= python3

DIR_PYTHON_BUILD = $(DIR_BUILD)/python-lib
PYTHON_BDIST_ARGS = --dist-dir $(DIR_BUILD)/python-packages
PYTHON_BUILD_ARGS = --build-base "$(DIR_PYTHON_BUILD)"
PYTHON_INSTALL_ARGS = --root "$(abspath $(DESTDIR))"
DISABLE_PYTHON_TESTS ?= 0
PYPI_UPLOAD_TARGET = https://pypi.python.org/pypi
DIR_PYTHON_COVERAGE_HTML = $(DIR_BUILD)/coverage-html
# detect if flake8 is available as an executable (e.g. Arch) or as a python module (e.g. Debian)
FLAKE8_BIN ?= $(shell hash flake8 2>/dev/null && echo "flake8" || echo "$(PYTHON_BIN) -m flake8")
FLAKE8_FILES ?= $(DIR_PYTHON_SETUP)
RUN_PYTHON = $(PYTHON_BIN)
BLACK_BIN ?= black
# projects may want to override this with something like "--target-version=py39"
BLACK_ARGS ?=
BLACK_FILES ?= $(DIR_PYTHON_SETUP)


.PHONY: help
help: help-python

.PHONY: help-python
help-python:
	@echo "Python-specific packaging targets:"
	@echo "    clean-python"
	@echo "    dist-python"
	@echo "    lint-python"
	@echo "    report-python"
	@echo "    style-python"
	@echo "    test-python"
	@echo "    upload-python"
	@echo

.PHONY: dist
dist: dist-python

.PHONY: install
install: install-python

.PHONY: lint
lint: lint-python

.PHONY: style
style: style-python

ifneq ($(DISABLE_PYTHON_TESTS),1)
.PHONY: test
test: test-python
endif

.PHONY: install-python
install-python:
	cd "$(DIR_PYTHON_SETUP)" && $(RUN_PYTHON) setup.py install $(PYTHON_INSTALL_ARGS)

.PHONY: dist-python
dist-python: clean-python
	cd "$(DIR_PYTHON_SETUP)" \
		&& $(RUN_PYTHON) setup.py build $(PYTHON_BUILD_ARGS) bdist $(PYTHON_BDIST_ARGS)

.PHONY: check-pypi-config
check-pypi-config:
	@# verify that the section for our internal target is not missing
	@if grep -q "^\[$(PYPI_UPLOAD_TARGET)\]$$" ~/.pypirc; then true; else \
		echo "ERROR: missing '$(PYPI_UPLOAD_TARGET)' section in ~/.pypirc: "\
		"take a look at pypirc.sample" >&2; \
		exit 1; \
	fi

.PHONY: upload
upload: upload-python

.PHONY: upload-python
upload-python: check-pypi-config
	cd "$(DIR_PYTHON_SETUP)" && $(RUN_PYTHON) setup.py sdist upload -r "$(PYPI_UPLOAD_TARGET)"

.PHONY: lint-python
ifneq ($(DISABLE_PYTHON_BLACK),1)
lint-python: lint-python-black
endif
ifneq ($(DISABLE_PYTHON_FLAKE8),1)
lint-python: lint-python-flake8
endif

.PHONY: lint-python-black
lint-python-black:
	$(BLACK_BIN) --check $(BLACK_ARGS) $(BLACK_FILES)

.PHONY: lint-python-flake8
lint-python-flake8:
	$(FLAKE8_BIN) $(FLAKE8_FILES)

.PHONY: style-python
style-python:
	$(BLACK_BIN) $(BLACK_ARGS) $(BLACK_FILES)

.PHONY: test-python
test-python:
	if [ -e tox.ini ]; then tox; fi
	$(RUN_PYTHON) $(PYTHON_TEST_ARGS)

.PHONY: report
report: report-python

.PHONY: report-python
report-python:
	if [ -e .coveragerc ]; then $(MAKE) report-python-coverage; fi

.PHONY: report-python-coverage
report-python-coverage:
	@# run tests for coverage analysis
	$(RUN_PYTHON) -m coverage run $(PYTHON_TEST_ARGS)
	@# provide textual report
	$(RUN_PYTHON) -m coverage report
	$(RUN_PYTHON) -m coverage html --directory "$(DIR_PYTHON_COVERAGE_HTML)"
	@printf "Browse the coverage report:\n\tfile://%s/index.html\n" \
		"$(abspath $(DIR_PYTHON_COVERAGE_HTML))"
	@# run a visual browser if the DISPLAY variable is set
	@if [ -n "$$DISPLAY" ] && [ -n "$(COVERAGE_BROWSER_BIN)" ]; then \
		"$(COVERAGE_BROWSER_BIN)" "$(DIR_PYTHON_COVERAGE_HTML)/index.html"; fi

.PHONY: clean-python
clean-python:
	cd "$(DIR_PYTHON_SETUP)" && python3 setup.py clean || true
	@# datafile for python3-coverage
	$(RM) .coverage
	@# workaround for https://github.com/pypa/setuptools/issues/436
	$(RM) "$(DIR_PYTHON_SETUP)"/*.egg-info/SOURCES.txt

clean: clean-python