BUILD.txt

   1 Building Releases
   2 =================
   3
   4 Roundup is currently a source-only release - it has no binary components. I
   5 want it to stay that way, too. This document describes how to build a
   6 source release. Users of Roundup should read the doc/installation.txt file
   7 to find out how to install this software.
   8
   9 Building and distributing a release of Roundup is done by running:
  10
  11 1.  Make sure the unit tests run! "./run_tests.py"
  12 2.  Edit roundup/__init__.py and doc/announcement.txt to reflect the new
  13     version and appropriate announcements.
  14 3.  Note the SVN revision in the CHANGES.txt file.
  15 4.  Clean out all *.orig, *.rej, .#* files from the source.
  16 5.  python setup.py clean --all
  17 6.  Edit setup.py to ensure that all information therein (version, contact
  18     information etc) is correct.
  19 7.  python setup.py sdist --manifest-only
  20 8.  Check the MANIFEST to make sure that any new files are included. If
  21     they are not, edit MANIFEST.in to include them. "Documentation" for
  22     MANIFEST.in may be found in disutils.filelist._parse_template_line.
  23 9.  python setup.py sdist
  24     (if you find sdist a little verbose, add "--quiet" to the end of the
  25      command)
  26 10. Unpack the new dist file in /tmp then a) run_test.py and b) demo.py
  27     with all available Python versions.
  28 11. Assuming all is well tag the release in SVN::
  29
  30       svn cp https://roundup.svn.sourceforge.net/svnroot/roundup/roundup/trunk \
  31       https://roundup.svn.sourceforge.net/svnroot/roundup/roundup/tags/release-1.4.12
  32
  33 11. python setup.py bdist_rpm
  34 12. python setup.py bdist_wininst
  35 13. Send doc/announcement.txt to python-announce@python.org and
  36     roundup-users@lists.sourceforge.net and
  37     roundup-devel@lists.sourceforge.net
  38
  39 So, those commands in a nice, cut'n'pasteable form::
  40
  41  find . -name '*.orig' -exec rm {} \;
  42  find . -name '*.rej' -exec rm {} \;
  43  find . -name '.#*' -exec rm {} \;
  44  python setup.py clean --all
  45  python setup.py sdist --manifest-only
  46  python setup.py sdist --quiet
  47  python setup.py bdist_rpm
  48  python setup.py bdist_wininst
  49  python setup.py register
  50  python setup.py sdist upload --sign
  51  python setup.py bdist_wininst upload --sign
  52
  53 (if the last two fail make sure you're using python2.5+)