.DEFAULT_GOAL := help

today := $(shell date +%F)

nextversion := void

versiontype := void

define LEAD_AUTHORS

Lead developers:

David R. Smith

Kevin Tritz

Howard Yuh

export LEAD_AUTHORS

define FDF_SHORTLOG

Commits from obsolete FDF repository:

261 David R. Smith

41 Kevin Tritz

17 ktritz

10 Howard Yuh

7 John Schmitt

4 hyyuh

2 jcschmitt

export FDF_SHORTLOG

define PRINT_HELP_PYSCRIPT

import re, sys

for line in sys.stdin:

match = re.match(r'^([a-zA-Z_-]+):.*?## (.*)$$', line)

if match:

target, help = match.groups()

print("%-20s %s" % (target, help))

export PRINT_HELP_PYSCRIPT

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])))

export BROWSER_PYSCRIPT

BROWSER := python -c "$$BROWSER_PYSCRIPT"

.PHONY: help

help: ## show this help message

@python -c "$$PRINT_HELP_PYSCRIPT" < $(MAKEFILE_LIST)

.PHONY: docs

docs: docs-pdf docs-html ## build HTML and PDF documents

.PHONY: docs-html

docs-html: ## build HTML documents

$(MAKE) -C docs/ html

#@$(BROWSER) docs/build/html/index.html

.PHONY: docs-pdf

docs-pdf: ## build PDF documents

$(MAKE) -C docs/ latexpdf

.PHONY: outdated

outdated: # list outdated conda and pip packages

@echo "outdated conda packages"

@conda update --dry-run --all

@echo "outdated pip packages (may be managed by conda)"

@pip list --outdated

.PHONY: test

test: ## run pytest in current Python environment

pytest test/

.PHONY: coverage

coverage: ## check test coverage and show report in terminal

@rm -f .coverage

coverage run --module pytest

coverage report

.PHONY: coverage-html

coverage-html: coverage ## check test coverage and show report in browser

@rm -fr htmlcov/

@coverage html

@$(BROWSER) htmlcov/index.html

.PHONY: lint

lint: ## run flake8 for code quality review

@rm -f flake8.output.txt

flake8 --exit-zero fdp/

.PHONY: autopep

autopep: ## run autopep8 to fix minor pep8 violations

autopep8 --in-place -r fdp/

autopep8 --in-place -r test/

.PHONY: authors

authors: ## update AUTHORS.txt

@rm -f AUTHORS.txt

@printf "%s\n" \

"$$LEAD_AUTHORS" \

"" \

"Commits from authors:" > AUTHORS.txt

@git shortlog -s -n >> AUTHORS.txt

@printf "%s\n" \

"" \

"$$FDF_SHORTLOG" >> AUTHORS.txt

.PHONY: changelog

changelog: ## internal use only

$(eval nextversion := $(shell bumpversion \

--no-commit --no-tag --dry-run --list --allow-dirty $(versiontype) | \

grep "^new_version=.*$$" | \

grep -o "[0-9]*\.[0-9]*\.[0-9]*$$"))

@cp -f CHANGELOG.rst tmp.rst

@rm -f CHANGELOG.rst

@printf '%s\n' \

"Release v$(nextversion) -- $(today)" \

"=========================================" \

"" \

"::" \

"" > CHANGELOG.rst

@git log --format=" %h %s" \

`git describe --tags --abbrev=0`..HEAD \

>> CHANGELOG.rst

@printf '%s\n' "" >> CHANGELOG.rst

@cat tmp.rst >> CHANGELOG.rst

@rm -f tmp.rst

.PHONY: bumpversion

bumpversion: authors changelog ## internal use only

@git add CHANGELOG.rst AUTHORS.txt

@git commit -m "updated CHANGELOG.rst and AUTHORS.txt"

@bumpversion $(versiontype) # runs 'git commit'

.PHONY: bump-major

bump-major: versiontype = major

bump-major: bumpversion ## update AUTHORS and CHANGELOG; bump major version and commit

.PHONY: bump-minor

bump-minor: versiontype = minor

bump-minor: bumpversion ## update AUTHORS and CHANGELOG; bump minor version and commit

.PHONY: bump-patch

bump-patch: versiontype = patch

bump-patch: bumpversion ## update AUTHORS and CHANGELOG; bump patch version and commit

.PHONY: clean

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

.PHONY: clean-docs

clean-docs: ## remove docs/build

rm -rf docs/build

.PHONY: clean-pyc

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 {} +