X-Git-Url: http://gitweb.michael.orlitzky.com/?p=dunshire.git;a=blobdiff_plain;f=makefile;h=13b18cbc52cf09b3bf86b2b7fa8e38b373144b1d;hp=b8a02711b3b0a9f63c0deacb8bc8ad7700e80e6f;hb=HEAD;hpb=3ce82fade1d2d43c1c95c4282dc42e7510cd6865 diff --git a/makefile b/makefile index b8a0271..13b18cb 100644 --- a/makefile +++ b/makefile @@ -1,19 +1,55 @@ PN := dunshire -SRCDIR := src/$(PN) -SRCS := $(SRCDIR)/*.py +SRCS := $(PN)/*.py test/*.py -doc: $(SRCS) doc/source/conf.py doc/makefile - sphinx-apidoc -f -o doc/source $(SRCDIR) +# Sphinx tries to keep track of which docs need to be built on its +# own. We could do better, but we would have to duplicate all of the +# information that we already gave Sphinx to make it work. Thus the +# "doc" target will unconditionally invoke sphinx. +.PHONY: doc +doc: cd doc && $(MAKE) html +# Run the doctests contained in the sphinx documentation, which aren't +# run as part of the normal test suite (because nobody wants to wait +# for sphinx to run). +.PHONY: doctest +doctest: + cd doc && $(MAKE) doctest + +# Run the test suite once. .PHONY: check check: - python test/suite.py + PYTHONPATH="." test/__main__.py + +# Run the test suite once, loudly. This is used in Gentoo, for example +# where we want users to see the output from the test suite on the off +# chance that it fails and they have to report it. +.PHONY: check-verbose +check-verbose: + PYTHONPATH="." test/__main__.py --verbose +# Run the test suite forever, but only the parts of it that are +# randomized. +.PHONY: check-loop +check-loop: + PYTHONPATH="." test/__main__.py --no-doctests --loop + +# Run pylint to obtain some unconstructive criticism on my coding style. .PHONY: lint lint: pylint --rcfile=./.pylintrc $(SRCS) +# Create a source distribution tarball. First we clean up, to make +# sure no junk gets added to the distribution. Then we build the docs +# so that users will get some usable HTML documentation and not just +# the source files. +.PHONY: dist +dist: clean doc + python setup.py sdist + +# Delete urrythang. .PHONY: clean clean: - rm -rf $(SRCDIR)/__pycache__ doc/build + rm -rf $(PN)/__pycache__ test/__pycache__ doc/build + rm -rf $(PN).egg-info + rm -rf dist