PYTESTS = $(wildcard test/test_*.py) .PHONY: all all: @$(MAKE) usage | less # Display usage for all make targets .PHONY: usage usage: @echo @echo 'make TARGET [option=value, ...]' @echo @echo 'TESTING' @echo @echo ' make test [testargs=ARGS]' @echo ' - Run all tests. "testargs" can specify a single string of arguments' @echo ' for py.test.' @echo @echo ' make .py [testargs=ARGS]' @echo ' - Run tests from a specific test file. "testargs" can specify a' @echo ' single string of arguments for py.test.' @echo @echo ' make testhost [version=VERSION]' @echo ' - Create an ephemeral container for doing adhoc yadm testing. The' @echo ' HEAD revision of yadm will be used unless "version" is' @echo ' specified. "version" can be set to any commit, branch, tag, etc.' @echo ' The targeted "version" will be retrieved from the repo, and' @echo ' linked into the container as a local volume.' @echo @echo ' make scripthost [version=VERSION]' @echo ' - Create an ephemeral container for demonstrating a bug. After' @echo ' exiting the shell, a log of the commands used to illustrate the' @echo ' problem will be written to the file "script.txt". This file can' @echo ' be useful to developers to make a repeatable test for the' @echo ' problem.' @echo @echo 'LINTING' @echo @echo ' make testenv' @echo ' - Create a python virtual environment with the same dependencies' @echo " used by yadm's testbed environment. Creating and activating" @echo ' this environment might be useful if your editor does real time' @echo ' linting of python files. After creating the virtual environment,' @echo ' you can activate it by typing:' @echo @echo ' source testenv/bin/activate' @echo @echo 'MANPAGES' @echo @echo ' make man' @echo ' - View yadm.1 as a standard man page.' @echo @echo ' make man-wide' @echo ' - View yadm.1 as a man page, using all columns of your display.' @echo @echo ' make man-ps' @echo ' - Create a postscript version of the man page.' @echo @echo 'FILE GENERATION' @echo @echo ' make yadm.md' @echo ' - Generate the markdown version of the man page (for viewing on' @echo ' the web).' @echo @echo ' make contrib' @echo ' - Generate the CONTRIBUTORS file, from the repo history.' @echo @echo 'INSTALLATION' @echo @echo ' make install PREFIX=' @echo ' - Install yadm, manpage, etc. to ' @echo @echo 'UTILITIES' @echo @echo ' make sync-clock' @echo ' - Reset the hardware clock for the docker hypervisor host. This' @echo ' can be useful for docker engine hosts which are not' @echo ' Linux-based.' @echo # Make it possible to run make specifying a py.test test file .PHONY: $(PYTESTS) $(PYTESTS): @$(MAKE) test testargs="-k $@ $(testargs)" %.py: @$(MAKE) test testargs="-k $@ $(testargs)" # Run all tests with additional testargs .PHONY: test test: @if [ -f /.yadmtestbed ]; then \ cd /yadm && \ py.test -v $(testargs); \ else \ if command -v "docker-compose" &> /dev/null; then \ docker-compose run --rm testbed make test testargs="$(testargs)"; \ else \ echo "Sorry, this make test requires docker-compose to be installed."; \ false; \ fi \ fi .PHONY: testhost testhost: require-docker @version=HEAD @rm -rf /tmp/testhost @git show $(version):yadm > /tmp/testhost @chmod a+x /tmp/testhost @echo Starting testhost version=\"$$version\" @docker run \ -w /root \ --hostname testhost \ --rm -it \ -v "/tmp/testhost:/bin/yadm:ro" \ yadm/testbed:2020-01-20 \ bash -l .PHONY: scripthost scripthost: require-docker @version=HEAD @rm -rf /tmp/testhost @git show $(version):yadm > /tmp/testhost @chmod a+x /tmp/testhost @echo Starting scripthost version=\"$$version\" \(recording script\) @printf '' > script.gz @docker run \ -w /root \ --hostname scripthost \ --rm -it \ -v "$$PWD/script.gz:/script.gz:rw" \ -v "/tmp/testhost:/bin/yadm:ro" \ yadm/testbed:2020-01-20 \ bash -c "script /tmp/script -q -c 'bash -l'; gzip < /tmp/script > /script.gz" @echo @echo "Script saved to $$PWD/script.gz" .PHONY: testenv testenv: @echo 'Creating a local virtual environment in "testenv/"' @echo python3 -m venv --clear testenv testenv/bin/pip3 install --upgrade pip setuptools testenv/bin/pip3 install --upgrade \ flake8==3.7.8 \ pylint==2.4.1 \ pytest==5.1.3 \ yamllint==1.17.0 \ ; @echo @echo 'To activate this test environment type:' @echo ' source testenv/bin/activate' .PHONY: man man: @groff -man -Tascii ./yadm.1 | less .PHONY: man-wide man-wide: @man ./yadm.1 .PHONY: man-ps man-ps: @groff -man -Tps ./yadm.1 > yadm.ps yadm.md: yadm.1 @groff -man -Tascii ./yadm.1 | col -bx | sed 's/^[A-Z]/## &/g' | sed '/yadm(1)/d' > yadm.md .PHONY: contrib contrib: @echo "CONTRIBUTORS\n" > CONTRIBUTORS @git shortlog -ns master gh-pages develop dev-pages | cut -f2 >> CONTRIBUTORS .PHONY: install install: @[ -n "$(PREFIX)" ] || { echo "PREFIX is not set"; exit 1; } @{\ set -e ;\ bin="$(PREFIX)/bin" ;\ doc="$(PREFIX)/share/doc/yadm" ;\ man="$(PREFIX)/share/man/man1" ;\ install -d "$$bin" "$$doc" "$$man" ;\ install -m 0755 yadm "$$bin" ;\ install -m 0644 yadm.1 "$$man" ;\ install -m 0644 CHANGES CONTRIBUTORS LICENSE "$$doc" ;\ cp -r contrib "$$doc" ;\ } .PHONY: sync-clock sync-clock: docker run --rm --privileged alpine hwclock -s .PHONY: require-docker require-docker: @if ! command -v "docker" &> /dev/null; then \ echo "Sorry, this make target requires docker to be installed."; \ false; \ fi