# .env::
# Called to add environment variables to be set when executing a shell
# Use @$(env) <var> <value> to add a variable settings. <var> may be
-# PATH Add <value> to PATH
-# PYTHONPATH Add <value> to PYTHONPATH
-# <other> Set variable to <value>
+# PATH Add <value> to PATH
+# PYTHONPATH Add <value> to PYTHONPATH
+# <other> Set variable to <value>
#
# clean::
-# Called to clean up all generated files
+# Called to clean up all unimportant generated files. This includes all files
+# which may be recreated by calling 'init'
+#
+# shorthelp::
+# Called to provide an overview of important target (this is the default target)
+#
+# fullhelp::
+# Called to create the list of supplementary targets.
+#
+# varhelp::
+# Called to create the list of Makefile variables.
#
###########################################################################
DLCACHE ?= dlcache
-default: update-nonet
+default: shorthelp
.PHONY: default
# Usage:
#
# If the file exists in $(DLCACHE), it is retrieved from there instead.
define httpget
- _httpget() { \
- name="$${1##*/}"; \
- target="$$2"; \
- [ -n "$$target" ] || target="$$name"; \
- cache="$(DLCACHE)/$$name"; \
- if [ -r "$$cache" ]; then \
- echo "Fetching '$$name' from cache."; \
- else \
- [ -z "$(NONET)" ] || ( echo "Missing '$$1'."; exit 2 ); \
- echo "Downloading '$$1'."; \
- wget -O "$$cache" "$$1"; \
- fi; \
- cp "$$cache" "$$target"; \
- }; \
+ _httpget() { \
+ name="$${1##*/}"; \
+ target="$$2"; \
+ [ -n "$$target" ] || target="$$name"; \
+ cache="$(BASEDIR)/$(DLCACHE)/$$name"; \
+ if [ -r "$$cache" ]; then \
+ echo "Fetching '$$name' from cache."; \
+ else \
+ [ -z "$(HTTPGET_NONET)" ] || ( echo "Missing '$$1'."; exit 2 ); \
+ echo "Downloading '$$1'."; \
+ wget -O "$$cache" "$$1"; \
+ fi; \
+ cp "$$cache" "$$target"; \
+ }; \
_httpget
endef
-# Usage:
-# @$(dlegg) <package>
-#
-# Downloads egg to '$(DLCACHE)/<package>-*.egg' unless a file with that name
-# already exists.
-#
-# THIS DOES NOT WORK WITH ALL PACKAGES !!! USE WITH CARE
-define _dlegg
- _dlegg() { \
- if [ -r $(DLCACHE)/$$1-*.egg ]; then \
- name="`cd $(DLCACHE); echo $$1-*.egg`"; \
- echo "Fetching '$$name' from cache."; \
- else \
- [ -z "$(NONET)" ] || ( echo "Missing '$$1'."; exit 2 ); \
- $(EASY_INSTALL) -zmaxd $(DLCACHE) $$1; \
- name="`cd $(DLCACHE); echo $$1-*.egg`"; \
- if [ -d $(DLCACHE)/$$name ]; then \
- cd $(DLCACHE)/$$name; \
- zip -r ../$$name.zip .; \
- cd ..; \
- rm -r $$name; \
- mv $$name.zip $$name; \
- fi; \
- fi; \
- }
-endef
-define dlegg
- $(_dlegg); _dlegg
-endef
-
-# Usage:
-# @$(install) <package>
-#
-# Downloads egg to '$(DLCACHE)/<package>-*.egg' and installs it unless a file
-# with that name already exists.
-define install
- _install() { \
- echo $(PIP_CACHE_FILES); \
- echo "$(PIP) install --download-cache="$(DLCACHE)/pip" $(PIP_OPTS) $$1"; \
- $(PIP) install --download-cache="$(DLCACHE)/pip" $(PIP_OPTS) "$$1"; \
- }; \
- _install
-endef
-
###########################################################################
# Customization targets
+shorthelp::
+ @echo
+ @echo "SUMMARY"
+ @echo
+ @echo " Makefile for bootstraping and maintaining a buildout. Most important"
+ @echo " targets are:"
+ @echo
+ @echo " init"
+ @echo " update-nonet"
+ @echo
+ @echo
+ @echo "MAIN TARGETS"
+ @echo
+ @echo " shorthelp (default target)"
+ @echo " help"
+ @echo " Summary of important targets / complete help."
+ @echo
+ @echo " debdepends"
+ @echo " Install debian packages via 'aptitude' needed to satisy build"
+ @echo " dependencies. MUST BE CALLED AS ROOT (e.g. with sudo)."
+ @echo
+ @echo " init"
+ @echo " init-nonet"
+ @echo " Initialize buildout. Call this to either bootstrap a new project"
+ @echo " or to initialize a new working copy. Missing packages will be"
+ @echo " downloaded from the internet (init target) or from an up-to-date"
+ @echo " download cache (init-nonet). The download cache normaly resides in"
+ @echo " './dlcache'"
+ @echo
+ @echo " update"
+ @echo " update-nonet"
+ @echo " Update the buildout. Calls './bin/buildout' (update target) or "
+ @echo " './bin/buildout -No (update-nonet target)."
+ @echo
+ @echo " shell"
+ @echo " Spawn an interactive subshell with the environment set up correctly"
+ @echo " for the local buildout."
+ @echo
+ @echo " clean"
+ @echo " Remove all unimportant (!) generated files (the remaining files are"
+ @echo " those which may be changed and should be managed as part of the"
+ @echo " project source-code). calling 'make init' or 'make init-nonet' will"
+ @echo " rebuild the development environment."
+ @echo
+.PHONY: shorthelp
+
+fullhelp::
+ @echo
+ @echo "SUPPLEMENTARY TARGETS"
+ @echo
+ @echo " cleancache"
+ @echo " purge the download cache"
+ @echo
+ @echo " upgrade"
+ @echo " Reinitializes the buildout. This is like calling"
+ @echo " 'make clean cleancache init'. Use this target to upgrade to a new"
+ @echo " python or extension (e.g. PIL) version (after changing the version"
+ @echo " in the project Makefile) or to upgrade the component eggs. This"
+ @echo " target purges the download cache to ensure, no obsolete files are"
+ @echo " left."
+ @echo
+.PHONY: fullhelp
+
+varhelp::
+ @echo
+ @echo "MAKEFILE VARIABLES"
+ @echo
+ @echo " DLCACHE ($(DLCACHE))"
+ @echo " Name of the download-cache subdirectory. This directory may be"
+ @echo " persisted e.g. by checking into version control (together with"
+ @echo " the source code or into as a separate repository or by saving into"
+ @echo " an archive. A persistent cache allows the setup to be completely"
+ @echo " reproducible and network independent."
+ @echo
+.PHONY: varhelp
+
debdepends::
.PHONY: debdepends
.PHONY: update-hook
bootstrap::
- sed -i -e '1s/^#!.*\/python/#!$(subst /,\/,$(PYTHON))/' $(PYTHON_DIR)/bin/*
- $(PYTHON) -c 'from zc.buildout.buildout import main; main(["bootstrap"])'
+.PHONY: bootstrap
update:: update-hook
- bin/buildout $(BUILDOUT_OPTS)
+.PHONY: update
define gitignore
- _gitignore () { \
+ _gitignore () { \
[ -r .gitignore ] || touch .gitignore; \
- grep -qxF "$$1" .gitignore || echo "$$1" >>.gitignore; \
+ grep -qxF "$$1" .gitignore || echo "$$1" >>.gitignore; \
}; \
_gitignore
endef
.gitignore::
@echo "Updating .gitignore."
- @$(gitignore) "*.pyc"
- @$(gitignore) "*.egg-info/"
@$(gitignore) "/.env"
- @$(gitignore) "/$(DLCACHE)/"
define env
_env () { \
PATH|PYTHONPATH) line="export $$1=\"$$2:\$$$$1\"" ;; \
*) line="export $$1=\"$$2\"" ;; \
esac; \
- grep -qxF "$$line" .env || echo "$$line" >>.env; \
+ grep -qxF "$$line" .env || echo "$$line" >>.env; \
}; \
_env
endef
@echo "Updating .env."
clean::
- rm -f .gitignore .env
+ rm -f .env
.PHONY: clean
###########################################################################
-# internal targets
-
-prepare-pipcache:
- @( \
- cd $(DLCACHE)/pip; \
- for file in *.tar.gz; do \
- name="$${file##*%2F}"; \
- if [ "$$name" != "$$file" -a ! -r "$$name" ]; then \
- ln -s $$file $$name || exit 1; \
- fi; \
- done \
- )
-
-PIP_CACHE_FILES := $(shell cd $(DLCACHE)/pip; ls *.tar.gz | grep -vF '%2F')
-
-do-init-nonet: PIP_OPTS = --no-index $(patsubst %,--find-link=file://$(BASEDIR)/$(DLCACHE)/pip/%,$(PIP_CACHE_FILES))
-do-init-nonet: BUILDOUT_OPTS = -N
-do-init-nonet: NONET=1
-do-init-nonet: init
-
-###########################################################################
# user targets
init: setup eggs buildout init-hook update-hook bootstrap update .gitignore .env
+.PHONY: init
-init-nonet: prepare-pipcache
- @$(MAKE) do-init-nonet
-
-versions:
- @echo "# Add the following lines to [versions] in buildout.cfg to pin all packages"
- @bin/buildout -vvvvv | sed -ne 's/^Picked: //p' | sort | uniq
+init-nonet: HTTPGET_NONET=1
+init-nonet: init
+.PHONY: init-nonet
shell:
@eval "`cat .env`"; $$SHELL
+.PHONY: shell
-update-nonet: BUILDOUT_OPTS=-No
update-nonet: update
+.PHONY: update-nonet
+
+cleancache:
+ rm -rf $(DLCACHE)/*
+.PHONY: cleancache
+
+upgrade: clean cleancache init
+.PHONY: upgrade
+
+help:
+ @[ -n `which less` ] && $(MAKE) -s shorthelp fullhelp varhelp | less \
+ || $(MAKE) -s shorthelp fullhelp varhelp
+.PHONY: help
\ No newline at end of file