[Checkins] SVN: zope.release/trunk/ - Improved the setup somewhat.

[Stephan Richter]

Log message for revision 80751:
  - Improved the setup somewhat.
  
  - Created a README.txt file that explains the workflow a bit.
  
  

Changed:
  _U  zope.release/trunk/
  A   zope.release/trunk/README.txt
  U   zope.release/trunk/buildout.cfg
  A   zope.release/trunk/test/

-=-

Property changes on: zope.release/trunk
___________________________________________________________________
Name: svn:ignore
   - .installed.cfg
bin
develop-eggs
parts

latest-versions.cfg
test-buildout.cfg

   + .installed.cfg
bin
develop-eggs
parts


Added: zope.release/trunk/README.txt
===================================================================
--- zope.release/trunk/README.txt	                        (rev 0)
+++ zope.release/trunk/README.txt	2007-10-09 16:48:01 UTC (rev 80751)
@@ -0,0 +1,81 @@
+===============================
+Zope 3 Controlled Package Index
+===============================
+
+This package has been developed to support the maintenance of a stable set of
+Zope project distributions. It manages the controlled packages configuration
+file and supports the generation of buildout configuration files that can be
+used by developers.
+
+Another use of this package is to use it for testing new distributions against
+the index. Here is the workflow for testing a new package against stable set:
+
+1. Install the correct version of this package.
+
+   (a) Download the version of this package that manages the stable set that
+       you are interested in. Currently only the trunk exists, which manages
+       the Zope 3.4 release::
+
+         $ svn co svn://svn.zope.org/repos/main/zope.release/trunk zope3.4
+         $ cd zope3.4
+
+   (b) Bootstrap the checkout::
+
+         $ python ./bootstrap.py
+
+   (c) Run buildout to create the scripts::
+
+         $ ./bin/buildout
+
+   (d) Run the ``buildout.cfg`` generation script to build a configuration
+       file that can be used for testing:
+
+         $ ./bin/generate-buildout
+
+2. From the generated configuration file, you can now build a testing
+   environment.
+
+   (a) Enter the test directory and create a buildout:
+
+         $ cd test
+         $ python ../bootstrap.py
+         $ ./bin/buildout
+
+   (b) Run all the tests to verify that all tests are initially passing:
+
+         $ ./bin/test -vpc1
+
+3. Modify the ``buildout.cfg`` to look for your the new distribution to be
+   tested:
+
+   (a) Comment out the "index" option. This needs to be done, so that the new
+       package is going to be picked up.
+
+   (b) Change the version number of the package of interest in the "versions"
+       section.
+
+   Alternative:
+
+   (a) Check out the new distribution from SVN.
+
+   (b) Add a "develop path/to/my/package" line in the "buildout" section of
+       ``buildout.cfg``.
+
+4. Run the tests, making sure that they all pass.
+
+5. Modify ``controlled-packages.cfg`` by adding the new version of the package
+   to the package's version list.
+
+6. Generate all files again and upload them:
+
+     $ cd ..
+     $ ./bin/generate-buildout
+     $ ./bin/generate-versions
+     $ ./bin//upload
+
+TODO: Setup a cron job that listens for changes in ``controlled-packages.cfg``
+      and updates the index, if necessary.
+
+Note: I think the process is still a tiny bit too long. I probably write a
+script that makes testing a new version of a package easier, but let's see
+whether this process is workable first.


Property changes on: zope.release/trunk/README.txt
___________________________________________________________________
Name: svn:eol-style
   + native

Modified: zope.release/trunk/buildout.cfg
===================================================================
--- zope.release/trunk/buildout.cfg	2007-10-09 16:06:59 UTC (rev 80750)
+++ zope.release/trunk/buildout.cfg	2007-10-09 16:48:01 UTC (rev 80751)
@@ -8,20 +8,20 @@
 scripts = generate-buildout
 arguments = ('controlled-packages.cfg',
              'http://download.zope.org/zope3.4',
-             './test-buildout.cfg')
+             './test/buildout.cfg')
 
 [generate-versions]
 recipe = zc.recipe.egg:scripts
 eggs = zope.release
 scripts = generate-versions
 arguments = ('controlled-packages.cfg',
-             './latest-versions.cfg')
+             './test/versions.cfg')
 
 [upload]
 recipe = zc.recipe.egg:scripts
 eggs = zope.release
 scripts = upload
-arguments = ('./test-buildout.cfg=buildout.cfg',
-             './latest-versions.cfg=versions.cfg',
+arguments = ('./test/buildout.cfg',
+             './test/versions.cfg',
              './controlled-packages.cfg',
              'download.zope.org:/var/www/download.zope.org/zope3.4',)


Property changes on: zope.release/trunk/test
___________________________________________________________________
Name: svn:ignore
   + .installed.cfg
bin
develop-eggs
parts

buildout.cfg
versions.cfg