Makefile: always generate coverage.info
[aubio.git] / Makefile
1 #!/usr/bin/make -f
2 # -*- makefile -*-
3 #
4 # This makefile contains simple rules to prepare, compile, test, and install
5 # aubio. Try one of the following rules:
6 #
7 # $ make configure
8 # $ make build
9 # $ make install
10 # $ make test_python
11
12 WAFCMD=python waf
13
14 #WAFOPTS:=
15 # turn on verbose mode
16 WAFOPTS += --verbose
17 # build wafopts
18 WAFOPTS += --destdir $(DESTDIR)
19 # multiple jobs
20 WAFOPTS += --jobs 4
21 # if HAVE_AUBIO_DOUBLE is defined, pass --enable-double to waf
22 # python/lib/moresetuptools.py also checks for HAVE_AUBIO_DOUBLE
23 WAFOPTS += $(shell [ -z $(HAVE_AUBIO_DOUBLE) ] || echo --enable-double )
24
25 PIPOPTS += --verbose
26
27 DESTDIR:=$(PWD)/build/dist
28 PYDESTDIR:=$(PWD)/build/pydist
29
30 # default install locations
31 PREFIX?=/usr/local
32 EXEC_PREFIX?=$(PREFIX)
33 LIBDIR?=$(PREFIX)/lib
34 INCLUDEDIR?=$(PREFIX)/include
35 DATAROOTDIR?=$(PREFIX)/share
36 MANDIR?=$(DATAROOTDIR)/man
37
38 # default nose2 command
39 NOSE2?=nose2 -N 4 --verbose
40
41 SOX=sox
42
43 TESTSOUNDS := python/tests/sounds
44
45 all: build
46
47 checkwaf:
48         @[ -f waf ] || make getwaf
49
50 getwaf:
51         ./scripts/get_waf.sh
52
53 expandwaf: getwaf
54         [ -d wafilb ] || rm -fr waflib
55         $(WAFCMD) --help > /dev/null
56         mv .waf*/waflib . && rm -fr .waf*
57         sed '/^#==>$$/,$$d' waf > waf2 && mv waf2 waf
58         chmod +x waf && chmod -R go-w waflib
59
60 cleanwaf:
61         rm -rf waf waflib .waf*
62
63 configure: checkwaf
64         $(WAFCMD) configure $(WAFOPTS)
65
66 build: configure
67         $(WAFCMD) build $(WAFOPTS)
68
69 install:
70         # install
71         $(WAFCMD) install $(WAFOPTS)
72
73 list_installed:
74         find $(DESTDIR) -ls | sed 's|$(DESTDIR)|/Ā«destdirĀ»|'
75
76 list_installed_python:
77         pip show -f aubio
78
79 list_all_installed: list_installed list_installed_python
80
81 uninstall:
82         # uninstall
83         $(WAFCMD) uninstall $(WAFOPTS)
84
85 delete_install:
86         rm -rf $(PWD)/dist/test
87
88 build_python:
89         # build python-aubio, using locally built libaubio if found
90         python ./setup.py build
91
92 build_python_extlib:
93         # build python-aubio using (locally) installed libaubio
94         [ -f $(DESTDIR)/$(INCLUDEDIR)/aubio/aubio.h ]
95         [ -d $(DESTDIR)/$(LIBDIR) ]
96         [ -f $(DESTDIR)/$(LIBDIR)/pkgconfig/aubio.pc ]
97         PKG_CONFIG_PATH=$(DESTDIR)/$(LIBDIR)/pkgconfig \
98         CFLAGS="-I$(DESTDIR)/$(INCLUDEDIR)" \
99         LDFLAGS="-L$(DESTDIR)/$(LIBDIR)" \
100                 make build_python
101
102 deps_python:
103         # install or upgrade python requirements
104         pip install $(PIPOPTS) --requirement requirements.txt
105
106 # use pip or distutils?
107 install_python: install_python_with_pip
108 uninstall_python: uninstall_python_with_pip
109 #install_python: install_python_with_distutils
110 #uninstall_python: uninstall_python_with_distutils
111
112 install_python_with_pip:
113         # install package
114         pip install $(PIPOPTS) .
115
116 uninstall_python_with_pip:
117         # uninstall package
118         ( pip show aubio | grep -l aubio > /dev/null ) && \
119         pip uninstall -y -v aubio || echo "info: aubio package is not installed"
120
121 install_python_with_distutils:
122         ./setup.py install $(PIPOPTS) $(DISTUTILSOPTS)
123
124 uninstall_python_with_distutils:
125         #./setup.py uninstall
126         [ -d $(PYDESTDIR)/$(LIBDIR) ] && echo Warning: did not clean $(PYDESTDIR)/$(LIBDIR) || true
127
128 force_uninstall_python:
129         # ignore failure if not installed
130         -make uninstall_python
131
132 local_dylib:
133         # DYLD_LIBRARY_PATH is no more on mac os
134         # create links from ~/lib/lib* to build/src/lib*
135         [ -f $(PWD)/build/src/libaubio.[0-9].dylib ] && ( mkdir -p ~/lib && cp -prv build/src/libaubio.[0-9].dylib ~/lib ) || true
136
137 test_python: export LD_LIBRARY_PATH=$(DESTDIR)/$(LIBDIR)
138 test_python: export PYTHONPATH=$(PYDESTDIR)/$(LIBDIR)
139 test_python: local_dylib
140         # run test with installed package
141         # ./python/tests/run_all_tests --verbose
142         # run with nose2, multiple processes
143         $(NOSE2)
144
145 clean_python:
146         ./setup.py clean
147
148 check_clean_python:
149         # check cleaning a second time works
150         make clean_python
151         make clean_python
152
153 clean: checkwaf
154         # optionnaly clean before build
155         -$(WAFCMD) clean
156         # remove possible left overs
157         -rm -rf doc/_build
158
159 check_clean:
160         # check cleaning after build works
161         $(WAFCMD) clean
162         # check cleaning a second time works
163         $(WAFCMD) clean
164
165 distclean:
166         $(WAFCMD) distclean
167         -rm -rf doc/_build/
168         -rm -rf doc/web/
169
170 check_distclean:
171         make distclean
172
173 distcheck: checkwaf
174         $(WAFCMD) distcheck $(WAFOPTS)
175
176 help:
177         $(WAFCMD) --help
178
179 create_test_sounds:
180         -[ -z `which $(SOX)` ] && ( echo $(SOX) could not be found) || true
181         -mkdir -p $(TESTSOUNDS)
182         -$(SOX) -r 44100 -b 16 -n "$(TESTSOUNDS)/44100Hz_1f_silence.wav"      trim 0 1s
183         -$(SOX) -r 22050 -b 16 -n "$(TESTSOUNDS)/22050Hz_5s_brownnoise.wav"   synth 5    brownnoise      vol 0.9
184         -$(SOX) -r 32000 -b 16 -n "$(TESTSOUNDS)/32000Hz_127f_sine440.wav"    synth 127s sine 440        vol 0.9
185         -$(SOX) -r  8000 -b 16 -n "$(TESTSOUNDS)/8000Hz_30s_silence.wav"      trim 0 30
186         -$(SOX) -r 48000 -b 32 -n "$(TESTSOUNDS)/48000Hz_60s_sweep.wav"       synth 60   sine 100-20000  vol 0.9
187         -$(SOX) -r 44100 -b 16 -n "$(TESTSOUNDS)/44100Hz_44100f_sine441.wav"  synth 44100s   sine 441   vol 0.9
188         -$(SOX) -r 44100 -b 16 -n "$(TESTSOUNDS)/44100Hz_100f_sine441.wav"    synth 100s sine 441       vol 0.9
189
190 # build only libaubio, no python-aubio
191 test_lib_only: clean distclean configure build install list_installed
192 # additionally, clean after a fresh build
193 test_lib_only_clean: test_lib_only uninstall check_clean check_distclean
194
195 # build libaubio, build and test python-aubio against it
196 test_lib_python: force_uninstall_python deps_python \
197         clean_python clean distclean \
198         configure build build_python \
199         install install_python \
200         test_python \
201         list_all_installed
202
203 test_lib_python_clean: test_lib_python \
204         uninstall_python uninstall \
205         check_clean_python \
206         check_clean \
207         check_distclean
208
209 # build libaubio, install it, build python-aubio against it
210 test_lib_install_python: force_uninstall_python deps_python \
211         clean_python distclean \
212         configure build \
213         install \
214         build_python_extlib \
215         install_python \
216         test_python \
217         list_all_installed
218
219 test_lib_install_python_clean: test_lib_install_python \
220         uninstall_python \
221         delete_install \
222         check_clean_python \
223         check_distclean
224
225 # build a python-aubio that includes libaubio
226 test_python_only: force_uninstall_python deps_python \
227         clean_python clean distclean \
228         build_python \
229         install_python \
230         test_python \
231         list_installed_python
232
233 test_python_only_clean: test_python_only \
234         uninstall_python \
235         check_clean_python
236
237 coverage: export CFLAGS=--coverage
238 coverage: export LDFLAGS=--coverage
239 coverage: export PYTHONPATH=$(PWD)/python/lib
240 coverage: force_uninstall_python deps_python \
241         clean_python clean distclean
242         pip install -v -e .
243         coverage run `which nose2`
244         lcov --capture --no-external --directory . --output-file build/coverage.info
245
246 coverage_report: coverage
247         genhtml build/coverage.info --output-directory lcov_html
248         mkdir -p gcovr_html/
249         gcovr -r . --html --html-details \
250                 --output gcovr_html/index.html \
251                 --exclude ".*tests/.*" --exclude ".*examples/.*"
252         coverage report
253         coverage html
254
255 sphinx: configure
256         $(WAFCMD) sphinx $(WAFOPTS)
257
258 doxygen: configure
259         $(WAFCMD) doxygen $(WAFOPTS)
260
261 manpages: configure
262         $(WAFCMD) manpages $(WAFOPTS)
263
264 html: doxygen sphinx
265
266 docs: html manpages
267
268 dist: distclean expandwaf
269         $(WAFCMD) dist