After months of use in production and about two months of public testing for 1.0, Paver 1.0 has been released. The changes between Paver 0.8.1, the most recent stable release, and 1.0 are quite significant. Paver 1.0 is easier, cleaner, less magical and just better all around. The backwards compatibility breaks should be easy enough to work around, are described in DeprecationWarnings and were introduced in 1.0a1 back in January.<div>
<br></div><div>Paver&#39;s home page: <a href="http://www.blueskyonmars.com/projects/paver/">http://www.blueskyonmars.com/projects/paver/</a><br><div><br></div><div>What is Paver?</div><div>===========</div><div><br></div>
<div><div>Paver is a Python-based software project scripting tool along the</div><div>lines of Make or Rake. It is not designed to handle the dependency</div><div>tracking requirements of, for example, a C program. It *is* designed</div>
<div>to help out with all of your other repetitive tasks (run documentation</div><div>generators, moving files about, downloading things), all with the</div><div>convenience of Python&#39;s syntax and massive library of code.</div>
<div><br></div><div>If you&#39;re developing applications in Python, you get even more...</div><div>Most public Python projects use distutils or setuptools to create source</div><div>tarballs for distribution. (Private projects can take advantage of</div>
<div>this, too!) Have you ever wanted to generate the docs before building the</div><div>source distribution? With Paver, you can, trivially. Here&#39;s a complete</div><div>pavement.py::</div><div><br></div><div>    from paver.easy import *</div>
<div>    from paver.setuputils import setup</div><div>    </div><div>    setup(</div><div>        name=&quot;MyCoolProject&quot;,</div><div>        packages=[&#39;mycool&#39;],</div><div>        version=&quot;1.0&quot;,</div>
<div>        url=&quot;<a href="http://www.blueskyonmars.com/">http://www.blueskyonmars.com/</a>&quot;,</div><div>        author=&quot;Kevin Dangoor&quot;,</div><div>        author_email=&quot;<a href="mailto:dangoor@gmail.com">dangoor@gmail.com</a>&quot;</div>
<div>    )</div><div>    </div><div>    @task</div><div>    @needs([&#39;html&#39;, &quot;distutils.command.sdist&quot;])</div><div>    def sdist():</div><div>        &quot;&quot;&quot;Generate docs and source distribution.&quot;&quot;&quot;</div>
<div>        pass</div><div>        </div><div>With that pavement file, you can just run ``paver sdist``, and your docs</div><div>will be rebuilt automatically before creating the source distribution.</div><div>It&#39;s also easy to move the generated docs into some other directory</div>
<div>(and, of course, you can tell Paver where your docs are stored,</div><div>if they&#39;re not in the default location.)</div><div><br></div><div>Installation</div><div>------------</div><div><br></div><div>The easiest way to get Paver is if you have setuptools_ installed.</div>
<div><br></div><div>``easy_install Paver``</div><div><br></div><div>Without setuptools, it&#39;s still pretty easy. Download the Paver .tgz file from </div><div>`Paver&#39;s Cheeseshop page`_, untar it and run:</div><div>
<br></div><div>``python setup.py install``</div><div><br></div><div>.. _Paver&#39;s Cheeseshop page: <a href="http://pypi.python.org/pypi/Paver/">http://pypi.python.org/pypi/Paver/</a></div><div>.. _setuptools: <a href="http://peak.telecommunity.com/DevCenter/EasyInstall">http://peak.telecommunity.com/DevCenter/EasyInstall</a></div>
<div><br></div><div>Help and Development</div><div>--------------------</div><div><br></div><div>You can get help from the `mailing list`_.</div><div><br></div><div>If you&#39;d like to help out with Paver, you can check the code out from Googlecode:</div>
<div><br></div><div>``svn checkout <a href="http://paver.googlecode.com/svn/trunk/">http://paver.googlecode.com/svn/trunk/</a> paver-read-only``</div><div><br></div><div>You can also take a look at `Paver&#39;s project page on Googlecode &lt;<a href="http://code.google.com/p/paver/">http://code.google.com/p/paver/</a>&gt;`_.</div>
<div><br></div><div>.. _mailing list: <a href="http://groups.google.com/group/paver">http://groups.google.com/group/paver</a></div><div><br></div><div><br></div>-- <br>Kevin Dangoor<br><br>work: <a href="http://labs.mozilla.com/">http://labs.mozilla.com/</a><br>
email: <a href="mailto:kid@blazingthings.com">kid@blazingthings.com</a><br>blog: <a href="http://www.BlueSkyOnMars.com">http://www.BlueSkyOnMars.com</a><br>
</div></div>