1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
|
# Makefile for Sphinx documentation
#
# You can set these variables from the command line.
SPHINXOPTS =
SPHINXBUILD = python -msphinx
SPHINXPROJ = cclib
SOURCEDIR = .
BUILDDIR = _build
# Put it first so that "make" without argument is like "make help".
.PHONY: help Makefile
help:
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) && exit 2
.PHONY: default
default: cclib update attributes coverage html
clean:
-rm -rf $(BUILDDIR)/*
-rm -rf cclib*
-rm -rf attributes*.rst
-rm -rf coverage*.rst
PRODUCTION_VERSION = v1.6.2
CCLIB_PROD = $(BUILDDIR)/cclib_prod
CCLIB_DEV = $(BUILDDIR)/cclib_dev
SRC_PROD = $(CCLIB_PROD)/cclib
SRC_DEV = $(CCLIB_DEV)/cclib
# Have the production and master in two separate directories so that
# dependencies are triggered correctly. If we had one, it would not
# work correctly, since git updates timestamps on each checkout, which
# would trigger some targets unnecessarily.
.PHONY: cclib
cclib: $(CCLIB_PROD) $(CCLIB_DEV)
$(CCLIB_PROD):
@echo "Checking out prod..."
git clone https://github.com/cclib/cclib.git $@
cd $(CCLIB_PROD); git checkout $(PRODUCTION_VERSION)
$(CCLIB_DEV):
@echo "Checking out dev..."
git clone -b master https://github.com/cclib/cclib.git $@
.PHONY: update update_prod update_dev
update: update_prod update_dev
update_prod:
@echo "Updating prod..."
cd $(CCLIB_PROD); git checkout $(PRODUCTION_VERSION); git fetch --all --tags
cd $(CCLIB_PROD); find . -name "*.pyc" -delete
update_dev:
@echo "Updating dev..."
cd $(CCLIB_DEV); git pull origin; git fetch --all --tags
cd $(CCLIB_DEV); find . -name "*.pyc" -delete
# Since we have two separate directories, 'checking out' a branch actually
# means making a symlink to the appropriate directory, because scripts should be
# impervious to this Makefile and will import from always the same name (cclib).
.PHONY: checkout_prod checkout_dev
checkout_prod:
-rm -rf cclib
ln -s $(SRC_PROD) cclib
checkout_dev:
-rm -rf cclib
ln -s $(SRC_DEV) cclib
# We need three layers of targets in order to always get the checkout
# to execute, but the actual file-generating target to run only if the
# appropriate files have been updated (resolved via the right symlink).
.PHONY: attributes
attributes: attributes.rst attributes_dev.rst
attributes.rst: attributes.py $(SRC_PROD)/parser/data.py
@echo "Generating prod attributes..."
@$(MAKE) --no-print-directory checkout_prod
python attributes.py > $@
attributes_dev.rst: attributes.py $(SRC_DEV)/parser/data.py
@echo "Generating dev attributes..."
@$(MAKE) --no-print-directory checkout_dev
python attributes.py > $@
# Same as above, we need three layers of targets, since this script
# especially takes some time as it performs all the tests.
.PHONY: coverage
coverage: coverage.rst coverage_dev.rst
coverage.rst: coverage.py $(wildcard $(SRC_PROD)/parser/*parser.py) $(wildcard $(CCLIB_PROD)/test/*.py)
@echo "Generating prod coverage..."
@$(MAKE) --no-print-directory checkout_prod
python coverage.py $(CCLIB_PROD) > $@
coverage_dev.rst: coverage.py $(wildcard $(SRC_DEV)/parser/*parser.py) $(wildcard $(CCLIB_DEV)/test/*.py)
@echo "Generating dev coverage..."
@$(MAKE) --no-print-directory checkout_dev
python coverage.py $(CCLIB_DEV) > $@
# Catch-all target: route all unknown targets to Sphinx using the new
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
# %: Makefile
# @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
# We can't use the default catch-all target, because it traps our
# custom targets that don't use Sphinx, like `attributes`, but it's
# still needed for our specific Sphinx build type.
.PHONY: html
html: Makefile
@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
|
