145 строки
3.5 KiB
Makefile
145 строки
3.5 KiB
Makefile
PROJ=celery
|
|
PYTHON=python
|
|
GIT=git
|
|
TOX=tox
|
|
NOSETESTS=nosetests
|
|
ICONV=iconv
|
|
FLAKE8=flake8
|
|
FLAKEPLUS=flakeplus
|
|
SPHINX2RST=sphinx2rst
|
|
|
|
SPHINX_DIR=docs/
|
|
SPHINX_BUILDDIR="${SPHINX_DIR}/_build"
|
|
README=README.rst
|
|
README_SRC="docs/templates/readme.txt"
|
|
CONTRIBUTING=CONTRIBUTING.rst
|
|
CONTRIBUTING_SRC="docs/contributing.rst"
|
|
SPHINX_HTMLDIR="${SPHINX_BUILDDIR}/html"
|
|
DOCUMENTATION=Documentation
|
|
FLAKEPLUSTARGET=2.7
|
|
|
|
WORKER_GRAPH="docs/images/worker_graph_full.png"
|
|
|
|
all: help
|
|
|
|
help:
|
|
@echo "docs - Build documentation."
|
|
@echo "test-all - Run tests for all supported python versions."
|
|
@echo "distcheck ---------- - Check distribution for problems."
|
|
@echo " test - Run unittests using current python."
|
|
@echo " lint ------------ - Check codebase for problems."
|
|
@echo " apicheck - Check API reference coverage."
|
|
@echo " configcheck - Check configuration reference coverage."
|
|
@echo " readmecheck - Check README.rst encoding."
|
|
@echo " contribcheck - Check CONTRIBUTING.rst encoding"
|
|
@echo " flakes -------- - Check code for syntax and style errors."
|
|
@echo " flakecheck - Run flake8 on the source code."
|
|
@echo " flakepluscheck - Run flakeplus on the source code."
|
|
@echo "readme - Regenerate README.rst file."
|
|
@echo "contrib - Regenerate CONTRIBUTING.rst file"
|
|
@echo "clean-dist --------- - Clean all distribution build artifacts."
|
|
@echo " clean-git-force - Remove all uncomitted files."
|
|
@echo " clean ------------ - Non-destructive clean"
|
|
@echo " clean-pyc - Remove .pyc/__pycache__ files"
|
|
@echo " clean-docs - Remove documentation build artifacts."
|
|
@echo " clean-build - Remove setup artifacts."
|
|
|
|
clean: clean-docs clean-pyc clean-build
|
|
|
|
clean-dist: clean clean-git-force
|
|
|
|
Documentation:
|
|
(cd "$(SPHINX_DIR)"; $(MAKE) html)
|
|
mv "$(SPHINX_HTMLDIR)" $(DOCUMENTATION)
|
|
|
|
docs: Documentation
|
|
|
|
clean-docs:
|
|
-rm -rf "$(SPHINX_BUILDDIR)"
|
|
|
|
lint: flakecheck apicheck configcheck readmecheck
|
|
|
|
apicheck:
|
|
(cd "$(SPHINX_DIR)"; $(MAKE) apicheck)
|
|
|
|
configcheck:
|
|
(cd "$(SPHINX_DIR)"; $(MAKE) configcheck)
|
|
|
|
flakecheck:
|
|
# the only way to enable all-1 errors is to ignore one of them.
|
|
$(FLAKE8) --ignore=W503 "$(PROJ)"
|
|
|
|
flakediag:
|
|
-$(MAKE) flakecheck
|
|
|
|
flakepluscheck:
|
|
$(FLAKEPLUS) --$(FLAKEPLUSTARGET) "$(PROJ)"
|
|
|
|
flakeplusdiag:
|
|
-$(MAKE) flakepluscheck
|
|
|
|
flakes: flakediag flakeplusdiag
|
|
|
|
clean-readme:
|
|
-rm -f $(README)
|
|
|
|
readmecheck:
|
|
$(ICONV) -f ascii -t ascii $(README) >/dev/null
|
|
|
|
$(README):
|
|
$(SPHINX2RST) "$(README_SRC)" --ascii > $@
|
|
|
|
readme: clean-readme $(README) readmecheck
|
|
|
|
clean-contrib:
|
|
-rm -f "$(CONTRIBUTING)"
|
|
|
|
$(CONTRIBUTING):
|
|
$(SPHINX2RST) "$(CONTRIBUTING_SRC)" > $@
|
|
|
|
contrib: clean-contrib $(CONTRIBUTING)
|
|
|
|
clean-pyc:
|
|
-find . -type f -a \( -name "*.pyc" -o -name "*$$py.class" \) | xargs rm
|
|
-find . -type d -name "__pycache__" | xargs rm -r
|
|
|
|
removepyc: clean-pyc
|
|
|
|
clean-build:
|
|
rm -rf build/ dist/ .eggs/ *.egg-info/ .tox/ .coverage cover/
|
|
|
|
clean-git:
|
|
$(GIT) clean -xdn
|
|
|
|
clean-git-force:
|
|
$(GIT) clean -xdf
|
|
|
|
test-all: clean-pyc
|
|
$(TOX)
|
|
|
|
test:
|
|
$(PYTHON) setup.py test
|
|
|
|
cov:
|
|
$(NOSETESTS) -xv --with-coverage --cover-html --cover-branch
|
|
|
|
build:
|
|
$(PYTHON) setup.py sdist bdist_wheel
|
|
|
|
distcheck: lint test clean
|
|
|
|
dist: readme contrib clean-dist build
|
|
|
|
|
|
$(WORKER_GRAPH):
|
|
$(PYTHON) -m celery graph bootsteps | dot -Tpng -o $@
|
|
|
|
clean-graph:
|
|
-rm -f $(WORKER_GRAPH)
|
|
|
|
graph: clean-graph $(WORKER_GRAPH)
|
|
|
|
authorcheck:
|
|
git shortlog -se | cut -f2 | extra/release/attribution.py
|
|
|