2 # this Makefile requires GNU make
7 PATHSEP=$(shell python -c 'import os ; print os.pathsep')
8 OSSEP=$(shell python -c 'import os ; print os.sep')
12 ifneq ($(INCLUDE_DIRS),)
13 INCLUDE_DIRS_ARG = -I$(INCLUDE_DIRS)
15 ifneq ($(LIBRARY_DIRS),)
16 LIBRARY_DIRS_ARG = -L$(LIBRARY_DIRS)
19 PLAT = $(strip $(shell python -c "import sys ; print sys.platform"))
21 # The platform is Windows with cygwin build tools and the native Python interpreter.
22 SUPPORT = $(shell cygpath -w $(shell pwd))\support
23 SUPPORTLIB := $(SUPPORT)\Lib\site-packages
24 SRCPATH := $(shell cygpath -w $(shell pwd)/src)
25 CHECK_PYWIN32_DEP := check-pywin32-dep
26 INNOSETUP := $(shell cygpath -au "$(PROGRAMFILES)/Inno Setup 5/Compil32.exe")
28 PYVER=$(shell $(PYTHON) misc/pyver.py)
29 SUPPORT = $(shell pwd)/support
30 SUPPORTLIB = $(SUPPORT)/lib/$(PYVER)/site-packages
31 SRCPATH := $(shell pwd)/src
35 TRIALCMD = $(shell PYTHONPATH="$(PYTHONPATH)$(PATHSEP)$(SRCPATH)" $(PYTHON) misc/find_trial.py)
42 REACTOROPT := --reactor=$(REACTOR)
47 TRIAL=PYTHONUNBUFFERED=1 $(TRIALCMD) --rterrors $(REACTOROPT)
49 build-auto-deps: check-deps
50 mkdir -p "$(SUPPORTLIB)"
51 @echo PYTHONPATH="$(PYTHONPATH)$(PATHSEP)$(SUPPORTLIB)$(PATHSEP)" \
52 $(PYTHON) misc/dependencies/setup.py install --prefix="$(SUPPORT)"
53 @PYTHONPATH="$(PYTHONPATH)$(PATHSEP)$(SUPPORTLIB)$(PATHSEP)" \
54 $(PYTHON) misc/dependencies/setup.py install --prefix="$(SUPPORT)" || \
55 ( echo "Build of Tahoe's bundled, automatically built dependent libraries failed -- please see docs/install.html for instructions." && false )
57 # The following target is here because I don't know how to tell the buildmaster
58 # to start instructing his slaves to "build-auto-deps" instead of instructing
59 # them to "build-deps". --Z
60 build-deps: build-auto-deps
62 EGGSPATH = $(shell $(PYTHON) misc/find-dep-eggs.py)
66 ifneq ($(PYTHONPATH),)
67 PYTHONPATH := $(PYTHONPATH)$(PATHSEP)
69 PP=PYTHONPATH="$(SRCPATH)$(PATHSEP)$(PYTHONPATH)$(PATHSEP)$(EGGSPATH)"
71 .PHONY: make-version build
73 # The 'darcsver' setup.py command comes in the 'darcsver' package:
74 # http://pypi.python.org/pypi/darcsver It is necessary only if you want to
75 # automatically produce a new _version.py file from the current darcs history.
77 $(PYTHON) ./setup.py darcsver
79 # We want src/allmydata/_version.py to be up-to-date, but it's a fairly
80 # expensive operation (about 6 seconds on a just-before-0.7.0 tree, probably
81 # because of the 332 patches since the last tag), and we've removed the need
82 # for an explicit 'build' step by removing the C code from src/allmydata and
83 # by running everything in place. It would be neat to do:
85 #src/allmydata/_version.py: _darcs/patches
86 # $(MAKE) make-version
88 # since that would update the embedded version string each time new darcs
89 # patches were pulled, but 1) this would break non-darcs trees (i.e. building
90 # from an exported tarball), and 2) without an obligatory 'build' step this
91 # rule wouldn't be run frequently enought anyways.
93 # So instead, I'll just make sure that we update the version at least once
94 # when we first start using the tree, and again whenever an explicit
95 # 'make-version' is run, since then at least the developer has some means to
96 # update things. It would be nice if 'make clean' deleted any
97 # automatically-generated _version.py too, so that 'make clean; make all'
98 # could be useable as a "what the heck is going on, get me back to a clean
99 # state', but we need 'make clean' to work on non-darcs trees without
100 # destroying useful information.
106 simple-build: build-auto-deps build
108 src/allmydata/_version.py:
111 build: src/allmydata/_version.py
112 @echo $(PYTHON) ./setup.py build_ext -i $(INCLUDE_DIRS_ARG) $(LIBRARY_DIRS_ARG) && chmod +x bin/tahoe
113 @( $(PYTHON) ./setup.py build_ext -i $(INCLUDE_DIRS_ARG) $(LIBRARY_DIRS_ARG) && chmod +x bin/tahoe ) || \
114 ( echo "Build of Allmydata-Tahoe failed -- please see docs/install.html for instructions." && false )
116 # 'make install' will do the following:
117 # build+install tahoe (probably to /usr/lib/pythonN.N/site-packages)
118 # 'make install PREFIX=/usr/local/stow/tahoe-N.N' will do the same, but to
119 # a different location
121 install: src/allmydata/_version.py
124 $(PP) $(PYTHON) ./setup.py install \
125 --single-version-externally-managed \
126 --prefix=$(PREFIX) --record=./tahoe.files
128 $(PP) $(PYTHON) ./setup.py install \
129 --single-version-externally-managed
135 .PHONY: check-all-deps check-twisted-dep $(CHECK_PYWIN32_DEP) signal-error-deps, signal-error-twisted-dep, signal-error-pywin32-dep, test test-figleaf figleaf-output
141 @echo "ERROR: Not all of Tahoe's dependencies are in place. Please \
142 see the README for help on installing dependencies."
147 signal-error-twisted-dep:
150 @echo "ERROR: Before running \"make build-auto-deps\" you have to ensure that \
151 Twisted is installed (including its zope.interface dependency). Twisted and \
152 zope.interface are required for the automatic installation of certain other \
153 libraries that Tahoe requires). Please see the README for details."
158 signal-error-pywin32-dep:
161 @echo "ERROR: the pywin32 dependency is not in place. Please see the README \
162 for help on installing dependencies."
167 signal-error-pyopenssl-dep:
170 @echo "ERROR: the pyOpenSSL dependency is not in place (note that pyOpenSSL required \
171 OpenSSL). Please see the README for help on installing dependencies."
176 check-all-deps: check-deps
178 $(PYTHON) -c 'import allmydata, zfec, foolscap, simplejson, nevow, pycryptopp' || $(MAKE) signal-error-deps
181 $(PYTHON) -c 'import twisted, zope.interface' || $(MAKE) signal-error-twisted-dep
184 $(PYTHON) -c 'import win32process' || $(MAKE) signal-error-pywin32-dep
187 $(PYTHON) -c 'import OpenSSL' || $(MAKE) signal-error-pyopenssl-dep
189 check-deps: check-twisted-dep $(CHECK_PYWIN32_DEP) check-pyopenssl-dep
192 $(MAKE) check-all-deps
195 # you can use 'make test TEST=allmydata.test.test_introducer' to run just
196 # test_introducer. TEST=allmydata.test.test_client.Basic.test_permute works
200 # use 'make test TRIALARGS=--reporter=bwverbose' from buildbot, to
201 # suppress the ansi color sequences
203 test: .built .checked-deps
205 $(TRIAL) $(TRIALARGS) $(TEST)
207 test-figleaf: .built .checked-deps
210 $(TRIAL) --reporter=bwverbose-figleaf $(TEST)
214 $(PYTHON) misc/figleaf2html -d coverage-html -r src -x misc/figleaf.excludes
215 @echo "now point your browser at coverage-html/index.html"
217 # after doing test-figleaf and figleaf-output, point your browser at
218 # coverage-html/index.html
220 .PHONY: upload-figleaf .figleaf.el pyflakes count-lines
221 .PHONY: check-memory check-memory-once clean
223 # 'upload-figleaf' is meant to be run with an UPLOAD_TARGET=host:/dir setting
227 $(error UPLOAD_HOST must be set when using UPLOAD_TARGET)
230 $(error COVERAGEDIR must be set when using UPLOAD_TARGET)
234 rsync -a coverage-html/ $(UPLOAD_TARGET)
235 ssh $(UPLOAD_HOST) make update-tahoe-figleaf COVERAGEDIR=$(COVERAGEDIR)
238 echo "this target is meant to be run with UPLOAD_TARGET=host:/path/"
242 .figleaf.el: .figleaf
244 $(PYTHON) misc/figleaf2el.py .figleaf src
247 $(PYTHON) -OOu `which pyflakes` src/allmydata |sort |uniq
251 @find src -name '*.py' |grep -v /build/ |wc --lines
253 @cat `find src -name '*.py' |grep -v /build/` |wc --lines
255 @grep TODO `find src -name '*.py' |grep -v /build/` | wc --lines
260 $(PYTHON) src/allmydata/test/check_memory.py upload
262 $(PYTHON) src/allmydata/test/check_memory.py upload-self
264 $(PYTHON) src/allmydata/test/check_memory.py upload-POST
266 $(PYTHON) src/allmydata/test/check_memory.py download
268 $(PYTHON) src/allmydata/test/check_memory.py download-GET
270 $(PYTHON) src/allmydata/test/check_memory.py download-GET-slow
272 $(PYTHON) src/allmydata/test/check_memory.py receive
274 check-memory-once: .built
277 $(PYTHON) src/allmydata/test/check_memory.py $(MODE)
279 # this target uses a pre-established client node to run a canned set of
280 # performance tests against a test network that is also pre-established
281 # (probably on a remote machine). Provide it with the path to a local
282 # directory where this client node has been created (and populated with the
283 # necessary FURLs of the test network). This target will start that client
284 # with the current code and then run the tests. Afterwards it will stop the
287 # The 'sleep 5' is in there to give the new client a chance to connect to its
288 # storageservers, since check_speed.py has no good way of doing that itself.
291 if [ -z '$(TESTCLIENTDIR)' ]; then exit 1; fi
292 @echo "stopping any leftover client code"
293 -$(PYTHON) bin/tahoe stop $(TESTCLIENTDIR)
294 $(PYTHON) bin/tahoe start $(TESTCLIENTDIR)
296 $(PYTHON) src/allmydata/test/check_speed.py $(TESTCLIENTDIR)
297 $(PYTHON) bin/tahoe stop $(TESTCLIENTDIR)
299 # 'make repl' is a simple-to-type command to get a Python interpreter loop
300 # from which you can type 'import allmydata'
304 test-darcs-boringfile:
306 $(PYTHON) misc/test-darcs-boringfile.py
309 find . |grep -v allfiles.tmp |grep -v src/allmydata/_version.py |sort >allfiles.tmp.old
312 find . |grep -v allfiles.tmp |grep -v src/allmydata/_version.py |sort >allfiles.tmp.new
313 diff allfiles.tmp.old allfiles.tmp.new
316 rm -rf build _trial_temp _test_memory .checked-deps .built
318 rm -f `find src/allmydata -name '*.so' -or -name '*.pyc'`
319 rm -rf tahoe_deps.egg-info allmydata_tahoe.egg-info
321 rm -rf setuptools*.egg *.pyc darcsver*.egg
322 rm -rf misc/dependencies/build misc/dependencies/temp
323 rm -rf misc/dependencies/tahoe_deps.egg-info
325 find-trailing-spaces:
326 $(PYTHON) misc/find-trailing-spaces.py -r src
331 VER=$(shell $(PYTHON) misc/get-version.py)
332 DEBCOMMENTS="'make deb' build"
337 .PHONY: setup-deb deb-ARCH is-known-debian-arch
338 .PHONY: deb-sid deb-feisty deb-edgy deb-etch
341 $(MAKE) deb-ARCH ARCH=sid
343 $(MAKE) deb-ARCH ARCH=feisty
344 # edgy uses the feisty control files for now
346 $(MAKE) deb-ARCH ARCH=edgy TAHOE_ARCH=feisty
347 # etch uses the feisty control files for now
349 $(MAKE) deb-ARCH ARCH=etch TAHOE_ARCH=feisty
350 # same with gutsy, the process has been nicely stable for a while now
352 $(MAKE) deb-ARCH ARCH=gutsy TAHOE_ARCH=feisty
354 # we know how to handle the following debian architectures
355 KNOWN_DEBIAN_ARCHES := sid feisty edgy etch gutsy
357 ifeq ($(findstring x-$(ARCH)-x,$(foreach arch,$(KNOWN_DEBIAN_ARCHES),"x-$(arch)-x")),)
358 is-known-debian-arch:
359 @echo "ARCH must be set when using setup-deb or deb-ARCH"
360 @echo "I know how to handle:" $(KNOWN_DEBIAN_ARCHES)
363 is-known-debian-arch:
371 setup-deb: is-known-debian-arch
373 ln -s misc/$(TAHOE_ARCH)/debian debian
374 chmod +x debian/rules
376 # etch (current debian stable) has python-simplejson-1.3, which doesn't
378 # sid (debian unstable) currently has python-simplejson 1.7.1
379 # edgy has 1.3, which doesn't support indent=
380 # feisty has 1.4, which supports indent= but emits a deprecation warning
383 # we need 1.4 or newer
385 deb-ARCH: is-known-debian-arch setup-deb
386 fakeroot debian/rules binary
388 @echo "The newly built .deb packages are in the parent directory from here."
390 .PHONY: increment-deb-version
391 .PHONY: deb-sid-head deb-edgy-head deb-feisty-head
392 .PHONY: deb-etch-head
394 # The buildbot runs the following targets after each change, to produce
395 # up-to-date tahoe .debs. These steps do not create .debs for anything else.
397 increment-deb-version: make-version
398 debchange --newversion $(VER) $(DEBCOMMENTS)
400 $(MAKE) setup-deb ARCH=sid
401 $(MAKE) increment-deb-version
402 fakeroot debian/rules binary
404 $(MAKE) setup-deb ARCH=edgy TAHOE_ARCH=feisty
405 $(MAKE) increment-deb-version
406 fakeroot debian/rules binary
408 $(MAKE) setup-deb ARCH=feisty
409 $(MAKE) increment-deb-version
410 fakeroot debian/rules binary
412 $(MAKE) setup-deb ARCH=etch TAHOE_ARCH=feisty
413 $(MAKE) increment-deb-version
414 fakeroot debian/rules binary
416 $(MAKE) setup-deb ARCH=gutsy TAHOE_ARCH=feisty
417 $(MAKE) increment-deb-version
418 fakeroot debian/rules binary
420 # These targets provide for windows native builds
421 .PHONY: hatch-eggs windows-exe windows-installer windows-installer-upload
424 $(PP) $(PYTHON) misc/hatch-eggs.py
426 windows-exe: hatch-eggs
427 cd windows && $(PP) $(PYTHON) setup.py py2exe
429 windows-installer: windows-exe
430 $(PP) $(PYTHON) misc/sub-ver.py windows/installer.tmpl >windows/installer.iss
431 cd windows && "$(INNOSETUP)" /cc installer.iss
433 windows-installer-upload:
434 chmod -R o+rx windows/dist/installer
435 rsync -av -e /usr/bin/ssh windows/dist/installer/ amduser@dev:/home/amduser/public_html/dist/tahoe/windows/