1.0.14dev: add release related tasks to the Makefile

This is the first half of the Trac release automation enhancements.

`make release` builds the packages relevant for each platform
(`release-exe` builds the .exe installers on Windows and `release-src`
the source packages on Unix).

`make upload version=1.x.y` then copies the packages on lynx, in the
user's `dist` folder over there, which has to exist.

The second half is in the `update-latest.sh` script on lynx, which
expects the packages to be in the `$SUDO_USER`'s `~/dist` folder, and
moves them to the appropriate places for distribution on t.e.o.


git-svn-id: http://trac.edgewall.org/intertrac/log:/branches/1.0-stable@15277 af82e41b-90c4-0310-8c96-b1721e28e2e2

Author: cboos

Makefile

@@ -95,6 +95,18 @@ define HELP
   [epydocopts=...]    variable containing extra options for Epydoc
   [dotpath=/.../dot]  path to Graphviz dot program (not used yet)
 
+ ---------------- Release tasks
+
+  release             release-exe on Windows, release-src otherwise
+  release-src         generates the .tar.gz, .zip and .whl packages
+  release-exe         generates the Windows installers (32- and 64-bits)
+  release-clean       remove the packages
+
+  checksum            MD5 and SHA1 checksums of packages of given version
+  upload              scp the packages of given version to user@lynx:~/dist
+
+  [version=...]       version number, mandatory for checksum and upload
+
  ---------------- Miscellaneous
 
   start-admin         start trac-admin (on `env')
@@ -552,6 +564,91 @@ clean-doc:
 	rm -fr build/doc
 
 
+# ----------------------------------------------------------------------------
+#
+# Release related tasks
+#
+# ----------------------------------------------------------------------------
+
+.PHONY: release release-src wheel dist release-exe wininst
+.PHONY: clean-release checksum upload
+
+ifeq "$(OS)" "Windows_NT"
+release: release-exe
+else # !Windows_NT
+release: release-src
+endif # Windows_NT
+
+clean-release:
+ifeq "$(version)" ""
+	$(error "specify version= on the make command-line")
+else
+	@rm $(sdist+wheel) $(wininst)
+endif
+
+user ?= $(or $(USER),$(LOGNAME),$(USERNAME))
+lynx = $(user)@lynx.edgewall.com:/home/$(user)/dist
+SCP ?= scp
+
+release-src: wheel sdist
+
+wheel:
+	@$(PYTHON) setup.py bdist_wheel
+sdist:
+	@$(PYTHON) setup.py sdist --formats=gztar,zip
+
+sdist+wheel = $(sdist_gztar) $(sdist_zip) $(bdist_wheel)
+
+sdist_gztar = dist/Trac-$(version).tar.gz
+sdist_zip = dist/Trac-$(version).zip
+bdist_wheel = dist/Trac-$(version)-py2-none-any.whl
+
+
+ifeq "$(OS)" "Windows_NT"
+release-exe:
+ifdef python.x86
+	make python=x86 wininst
+else
+	$(error "define python.x86 in Makefile.cfg for building $(wininst.x86)")
+endif
+ifdef python.x64
+	make python=x64 wininst
+else
+	$(error "define python.x64 in Makefile.cfg for building $(wininst.x64)")
+endif
+
+wininst = $(wininst.x86) $(wininst.x64)
+
+wininst.x86 = dist/Trac-$(version).win32.exe
+wininst.x64 = dist/Trac-$(version).win-amd64.exe
+
+wininst:
+	@$(PYTHON) setup.py bdist_wininst
+endif # Windows_NT
+
+packages = $(wildcard $(sdist+wheel) $(wininst))
+
+checksum:
+ifeq "$(version)" ""
+	$(error "specify version= on the make command-line")
+else
+	@echo "Packages for Trac-$(version):"
+	@echo
+	@$(if $(packages), \
+	    md5sum $(packages); \
+	    sha1sum $(packages); \
+	, \
+	    echo "No packages found: $(sdist+wheel) $(wininst)" \
+	)
+endif
+
+upload: checksum
+ifeq "$(user)" ""
+	$(error "define user in Makefile.cfg for uploading to lynx")
+else
+	$(if $(packages),$(SCP) $(packages) $(lynx))
+endif # user
+
 
 # ============================================================================
 #

Makefile.cfg.sample

@@ -15,6 +15,10 @@ python.ap25 = C:/Dev/ActivePython254
 python.26 = C:/Dev/Python261
 python.27 = C:/Dev/Python278
 
+python.x86 = C:/Dev/Python2712x86
+python.x64 = C:/Dev/Python2710x64
+# (mandatory for release-exe)
+
 # And also:
 
 # pythonpath.<key> = <extension to the PYTHONPATH for that installation>
@@ -73,6 +77,13 @@ auth = *,~/tracenvs/htdigest.realm,realm
 
 dotpath = /usr/local/bin/dot
 
+# ----------------------------------------------------------------------------
+# Settings for the release
+
+# e.g. PuTTY's scp in Program Files (x86)
+# SCP = C:/PROGRA~2/PuTTY/pscp.exe
+
+
 # ----------------------------------------------------------------------------
 # Custom rules - let your imagination go wild ;-)