Makefile: chmod go-w waflib, clean cleaner
[aubio.git] / Makefile
index 3e3c7da..8334c42 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -1,9 +1,43 @@
+#!/usr/bin/make -f
+# -*- makefile -*-
+#
+# This makefile contains simple rules to prepare, compile, test, and install
+# aubio. Try one of the following rules:
+#
+# $ make configure
+# $ make build
+# $ make install
+# $ make test_python
+
 WAFCMD=python waf
-WAFURL=https://waf.io/waf-1.9.1
+WAFURL=https://waf.io/waf-1.9.6
+
+#WAFOPTS:=
+# turn on verbose mode
+WAFOPTS += --verbose
+# build wafopts
+WAFOPTS += --destdir $(DESTDIR)
+# multiple jobs
+WAFOPTS += --jobs 4
+# if HAVE_AUBIO_DOUBLE is defined, pass --enable-double to waf
+# python/lib/moresetuptools.py also checks for HAVE_AUBIO_DOUBLE
+WAFOPTS += $(shell [ -z $(HAVE_AUBIO_DOUBLE) ] || echo --enable-double )
+
+PIPOPTS += --verbose
+
+DESTDIR:=$(PWD)/build/dist
+PYDESTDIR:=$(PWD)/build/pydist
+
+# default install locations
+PREFIX?=/usr/local
+EXEC_PREFIX?=$(PREFIX)
+LIBDIR?=$(PREFIX)/lib
+INCLUDEDIR?=$(PREFIX)/include
+DATAROOTDIR?=$(PREFIX)/share
+MANDIR?=$(DATAROOTDIR)/man
 
 SOX=sox
 
-ENABLE_DOUBLE := $(shell [ -z $(HAVE_DOUBLE) ] || echo --enable-double )
 TESTSOUNDS := python/tests/sounds
 
 all: build
@@ -12,77 +46,130 @@ checkwaf:
        @[ -f waf ] || make getwaf
 
 getwaf:
-       @( which wget > /dev/null && wget -qO waf $(WAFURL) ) || ( which curl > /dev/null && curl $(WAFURL) > waf )
-       @chmod +x waf
+       ./scripts/get_waf.sh
+
+expandwaf: getwaf
+       [ -d wafilb ] || rm -fr waflib
+       $(WAFCMD) --help > /dev/null
+       mv .waf*/waflib . && rm -fr .waf*
+       sed '/^#==>$$/,$$d' waf > waf2 && mv waf2 waf
+       chmod +x waf && chmod go-w -R waflib
 
-expandwaf:
-       @[ -d wafilb ] || rm -fr waflib
-       @$(WAFCMD) --help > /dev/null
-       @mv .waf*/waflib . && rm -fr .waf*
-       @sed '/^#==>$$/,$$d' waf > waf2 && mv waf2 waf
-       @chmod +x waf
+cleanwaf:
+       rm -rf waf waflib .waf*
 
 configure: checkwaf
-       $(WAFCMD) configure $(WAFOPTS) $(ENABLE_DOUBLE)
+       $(WAFCMD) configure $(WAFOPTS)
 
 build: configure
        $(WAFCMD) build $(WAFOPTS)
 
-build_python:
-       python ./setup.py generate $(ENABLE_DOUBLE) build
+install:
+       # install
+       $(WAFCMD) install $(WAFOPTS)
+
+list_installed:
+       find $(DESTDIR) -ls | sed 's|$(DESTDIR)|/«destdir»|'
 
-test_python: export LD_LIBRARY_PATH=$(PWD)/build/src
-test_python:
-       pip install -v -r requirements.txt
-       pip install -v .
-       nose2 --verbose
-       pip uninstall -y -v aubio
+list_installed_python:
+       pip show -f aubio
 
-test_python_osx:
+list_all_installed: list_installed list_installed_python
+
+uninstall:
+       # uninstall
+       $(WAFCMD) uninstall $(WAFOPTS)
+
+delete_install:
+       rm -rf $(PWD)/dist/test
+
+build_python:
+       # build python-aubio, using locally built libaubio if found
+       python ./setup.py build
+
+build_python_extlib:
+       # build python-aubio using (locally) installed libaubio
+       [ -f $(DESTDIR)/$(INCLUDEDIR)/aubio/aubio.h ]
+       [ -d $(DESTDIR)/$(LIBDIR) ]
+       [ -f $(DESTDIR)/$(LIBDIR)/pkgconfig/aubio.pc ]
+       PKG_CONFIG_PATH=$(DESTDIR)/$(LIBDIR)/pkgconfig \
+       CFLAGS="-I$(DESTDIR)/$(INCLUDEDIR)" \
+       LDFLAGS="-L$(DESTDIR)/$(LIBDIR)" \
+               make build_python
+
+deps_python:
+       # install or upgrade python requirements
+       pip install $(PIPOPTS) --requirement requirements.txt
+
+# use pip or distutils?
+install_python: install_python_with_pip
+uninstall_python: uninstall_python_with_pip
+#install_python: install_python_with_distutils
+#uninstall_python: uninstall_python_with_distutils
+
+install_python_with_pip:
+       # install package
+       pip install $(PIPOPTS) .
+
+uninstall_python_with_pip:
+       # uninstall package
+       ( pip show aubio | grep -l aubio > /dev/null ) && \
+       pip uninstall -y -v aubio || echo "info: aubio package is not installed"
+
+install_python_with_distutils:
+       ./setup.py install $(PIPOPTS) $(DISTUTILSOPTS)
+
+uninstall_python_with_distutils:
+       #./setup.py uninstall
+       [ -d $(PYDESTDIR)/$(LIBDIR) ] && echo Warning: did not clean $(PYDESTDIR)/$(LIBDIR) || true
+
+force_uninstall_python:
+       # ignore failure if not installed
+       -make uninstall_python
+
+local_dylib:
+       # DYLD_LIBRARY_PATH is no more on mac os
        # create links from ~/lib/lib* to build/src/lib*
-       [ -f build/src/libaubio.[0-9].dylib ] && ( mkdir -p ~/lib && cp -prv build/src/libaubio.4.dylib ~/lib ) || true
-       # then run the tests
-       pip install --user -v -r requirements.txt
-       pip install --user -v .
-       nose2 --verbose
-       pip uninstall -y -v aubio
+       [ -f $(PWD)/build/src/libaubio.[0-9].dylib ] && ( mkdir -p ~/lib && cp -prv build/src/libaubio.[0-9].dylib ~/lib ) || true
+
+test_python: export LD_LIBRARY_PATH=$(DESTDIR)/$(LIBDIR)
+test_python: export PYTHONPATH=$(PYDESTDIR)/$(LIBDIR)
+test_python: local_dylib
+       # run test with installed package
+       ./python/tests/run_all_tests --verbose
+       # also run with nose, multiple processes
+       nose2 -N 4
 
 clean_python:
        ./setup.py clean
 
-test_pure_python:
-       -pip uninstall -v -y aubio
-       -rm -rf build/ python/gen/
-       -rm -f dist/*.egg
-       -pip install -v -r requirements.txt
-       CFLAGS=-Os python setup.py bdist_egg
-       [ "$(TRAVIS_OS_NAME)" == "osx" ] && easy_install --user dist/*.egg || \
-               easy_install dist/*.egg
-       nose2 -N 4
-       pip uninstall -v -y aubio
-
-test_pure_python_wheel:
-       -pip uninstall -v -y aubio
-       -rm -rf build/ python/gen/
-       -rm -f dist/*.whl
-       -pip install -v -r requirements.txt
-       -pip install -v wheel
-       CFLAGS=-Os python setup.py bdist_wheel --universal
-       wheel install dist/*.whl
-       nose2 -N 4
-       pip uninstall -v -y aubio
-
-build_python3:
-       python3 ./setup.py generate $(ENABLE_DOUBLE) build
+check_clean_python:
+       # check cleaning a second time works
+       make clean_python
+       make clean_python
 
-clean_python3:
-       python3 ./setup.py clean
+clean: checkwaf
+       # optionnaly clean before build
+       -$(WAFCMD) clean
+       # remove possible left overs
+       -rm -rf doc/_build
 
-clean:
+check_clean:
+       # check cleaning after build works
        $(WAFCMD) clean
+       # check cleaning a second time works
+       $(WAFCMD) clean
+
+distclean:
+       $(WAFCMD) distclean
+       -rm -rf doc/_build/
+       -rm -rf doc/web/
+
+check_distclean:
+       make distclean
 
 distcheck: checkwaf
-       $(WAFCMD) distcheck $(WAFOPTS) $(ENABLE_DOUBLE)
+       $(WAFCMD) distcheck $(WAFOPTS)
 
 help:
        $(WAFCMD) --help
@@ -90,8 +177,73 @@ help:
 create_test_sounds:
        -[ -z `which $(SOX)` ] && ( echo $(SOX) could not be found) || true
        -mkdir -p $(TESTSOUNDS)
-       -$(SOX) -r 44100 -b 16 -n "$(TESTSOUNDS)/44100Hz_1f_silence.wav"      synth 1s   silence 0
+       -$(SOX) -r 44100 -b 16 -n "$(TESTSOUNDS)/44100Hz_1f_silence.wav"      trim 0 1s
        -$(SOX) -r 22050 -b 16 -n "$(TESTSOUNDS)/22050Hz_5s_brownnoise.wav"   synth 5    brownnoise      vol 0.9
        -$(SOX) -r 32000 -b 16 -n "$(TESTSOUNDS)/32000Hz_127f_sine440.wav"    synth 127s sine 440        vol 0.9
-       -$(SOX) -r  8000 -b 16 -n "$(TESTSOUNDS)/8000Hz_30s_silence.wav"      synth 30   silence 0       vol 0.9
+       -$(SOX) -r  8000 -b 16 -n "$(TESTSOUNDS)/8000Hz_30s_silence.wav"      trim 0 30
        -$(SOX) -r 48000 -b 32 -n "$(TESTSOUNDS)/48000Hz_60s_sweep.wav"       synth 60   sine 100-20000  vol 0.9
+       -$(SOX) -r 44100 -b 16 -n "$(TESTSOUNDS)/44100Hz_44100f_sine441.wav"  synth 44100s   sine 441   vol 0.9
+       -$(SOX) -r 44100 -b 16 -n "$(TESTSOUNDS)/44100Hz_100f_sine441.wav"    synth 100s sine 441       vol 0.9
+
+# build only libaubio, no python-aubio
+test_lib_only: clean distclean configure build install list_installed
+# additionally, clean after a fresh build
+test_lib_only_clean: test_lib_only uninstall check_clean check_distclean
+
+# build libaubio, build and test python-aubio against it
+test_lib_python: force_uninstall_python deps_python \
+       clean_python clean distclean \
+       configure build build_python \
+       install install_python \
+       test_python \
+       list_all_installed
+
+test_lib_python_clean: test_lib_python \
+       uninstall_python uninstall \
+       check_clean_python \
+       check_clean \
+       check_distclean
+
+# build libaubio, install it, build python-aubio against it
+test_lib_install_python: force_uninstall_python deps_python \
+       clean_python distclean \
+       configure build \
+       install \
+       build_python_extlib \
+       install_python \
+       test_python \
+       list_all_installed
+
+test_lib_install_python_clean: test_lib_install_python \
+       uninstall_python \
+       delete_install \
+       check_clean_python \
+       check_distclean
+
+# build a python-aubio that includes libaubio
+test_python_only: force_uninstall_python deps_python \
+       clean_python clean distclean \
+       build_python \
+       install_python \
+       test_python \
+       list_installed_python
+
+test_python_only_clean: test_python_only \
+       uninstall_python \
+       check_clean_python
+
+sphinx: configure
+       $(WAFCMD) sphinx $(WAFOPTS)
+
+doxygen: configure
+       $(WAFCMD) doxygen $(WAFOPTS)
+
+manpages: configure
+       $(WAFCMD) manpages $(WAFOPTS)
+
+html: doxygen sphinx
+
+docs: html manpages
+
+dist: distclean expandwaf
+       $(WAFCMD) dist