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.
   6
   7 This means that we only need to ever build source releases. This is done by
   8 running:
   9
  10 1.  Make sure the unit tests run! "./run_tests"
  11 2.  Edit roundup/__init__.py and doc/announcement.txt to reflect the new
  12     version and appropriate announcements. Add truncated announcement to
  13     setup.py description field.
  14 3.  python setup.py clean --all
  15 4.  Edit setup.py to ensure that all information therein (version, contact
  16     information etc) is correct.
  17 5.  python setup.py sdist --manifest-only
  18 6.  Check the MANIFEST to make sure that any new files are included. If
  19     they are not, edit MANIFEST.in to include them. "Documentation" for
  20     MANIFEST.in may be found in disutils.filelist._parse_template_line.
  21 7.  python setup.py sdist
  22     (if you find sdist a little verbose, add "--quiet" to the end of the
  23      command)
  24 8.  unpack the new dist file in /tmp and a) run_test, and b) demo.py
  25 9.  Generate gpg signature with "gpg -a --detach-sign" and upload to
  26     mechanicalcat.net
  27 10. PyPI registration
  28 11. tag the CVS for the release, eg. "cvs tag -R release-0-6-3"
  29
  30 So, those commands in a nice, cut'n'pasteable form::
  31
  32  python setup.py clean --all
  33  python setup.py sdist --manifest-only
  34  python setup.py sdist --quiet
  35  python2.3 setup.py register
  36
  37
  38 Distributing Releases
  39 =====================
  40
  41 Once a release is built, follow these steps:
  42
  43 1. FTP the tar.gz from the dist directory to to the "incoming" directory on
  44    "upload.sourceforge.net".
  45 2. Make a quick release at:
  46     http://sourceforge.net/project/admin/qrs.php?package_id=&group_id=31577
  47 3. Add a news item at:
  48     https://sourceforge.net/news/submit.php?group_id=31577
  49    using the top of doc/announcement.txt
  50 4. Send doc/announcement.txt to python-announce@python.org
  51 5. Notify any other news services as appropriate...
  52
  53
  54 Author
  55 ======
  56
  57 richard@users.sourceforge.net
  58