Bug 1661: Improve build speed with better caching strategy
Changed the way that the cache is located, so the same code can run on any build machine without any configuration.
Made work around for Bug 419 the only option, as we're not using the alternative anyway, and I don't want to commit completely untested code!
Changed caching algorithm, to improve build times.
<?xml version="1.0" encoding="ascii"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<title>buildtools.AntWriter</title>
<link rel="stylesheet" href="epydoc.css" type="text/css" />
<script type="text/javascript" src="epydoc.js"></script>
</head>
<body bgcolor="white" text="black" link="blue" vlink="#204080"
alink="#204080">
<!-- ==================== NAVIGATION BAR ==================== -->
<table class="navbar" border="0" width="100%" cellpadding="0"
bgcolor="#a0c0ff" cellspacing="0">
<tr valign="middle">
<!-- Tree link -->
<th> <a
href="module-tree.html">Trees</a> </th>
<!-- Index link -->
<th> <a
href="identifier-index.html">Indices</a> </th>
<!-- Help link -->
<th> <a
href="help.html">Help</a> </th>
<th class="navbar" width="100%"></th>
</tr>
</table>
<table width="100%" cellpadding="0" cellspacing="0">
<tr valign="top">
<td width="100%">
<span class="breadcrumbs">
<a href="buildtools-module.html">Module buildtools</a> ::
Class AntWriter
</span>
</td>
<td>
<table cellpadding="0" cellspacing="0">
<!-- hide/show private -->
<tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink"
onclick="toggle_private();">hide private</a>]</span></td></tr>
<tr><td align="right"><span class="options"
>[<a href="frames.html" target="_top">frames</a
>] | <a href="buildtools.AntWriter-class.html"
target="_top">no frames</a>]</span></td></tr>
</table>
</td>
</tr>
</table>
<!-- ==================== CLASS DESCRIPTION ==================== -->
<h1 class="epydoc">Class AntWriter</h1><span class="codelink"><a href="buildtools-pysrc.html#AntWriter">source code</a></span><br /><br />
<pre class="base-tree">
<a href="buildtools.AbstractOutputWriter-class.html">AbstractOutputWriter</a> --+
|
<strong class="uidshort">AntWriter</strong>
</pre>
<hr />
Implements Ant XML output format.<br /><br />
<!-- ==================== INSTANCE METHODS ==================== -->
<a name="section-InstanceMethods"></a>
<table class="summary" border="1" cellpadding="3"
cellspacing="0" width="100%" bgcolor="white">
<tr bgcolor="#70b0f0" class="table-header">
<td colspan="2" class="table-header">
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr valign="top">
<td align="left"><span class="table-header">Instance Methods</span></td>
<td align="right" valign="top"
><span class="options">[<a href="#section-InstanceMethods"
class="privatelink" onclick="toggle_private();"
>hide private</a>]</span></td>
</tr>
</table>
</td>
</tr>
<tr>
<td width="15%" align="right" valign="top" class="summary">
<span class="summary-type"> </span>
</td><td class="summary">
<table width="100%" cellpadding="0" cellspacing="0" border="0">
<tr>
<td><span class="summary-sig"><a href="buildtools.AntWriter-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>,
<span class="summary-sig-arg">fileOut</span>)</span></td>
<td align="right" valign="top">
<span class="codelink"><a href="buildtools-pysrc.html#AntWriter.__init__">source code</a></span>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td width="15%" align="right" valign="top" class="summary">
<span class="summary-type"> </span>
</td><td class="summary">
<table width="100%" cellpadding="0" cellspacing="0" border="0">
<tr>
<td><span class="summary-sig"><a href="buildtools.AntWriter-class.html#writeTopLevel" class="summary-sig-name">writeTopLevel</a>(<span class="summary-sig-arg">self</span>,
<span class="summary-sig-arg">config_list</span>,
<span class="summary-sig-arg">spec_name</span>,
<span class="summary-sig-arg">output_path</span>,
<span class="summary-sig-arg">xml_file</span>)</span><br />
Method to override to implement top level commands.</td>
<td align="right" valign="top">
<span class="codelink"><a href="buildtools-pysrc.html#AntWriter.writeTopLevel">source code</a></span>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td width="15%" align="right" valign="top" class="summary">
<span class="summary-type"> </span>
</td><td class="summary">
<table width="100%" cellpadding="0" cellspacing="0" border="0">
<tr>
<td><span class="summary-sig"><a href="buildtools.AntWriter-class.html#write" class="summary-sig-name">write</a>(<span class="summary-sig-arg">self</span>,
<span class="summary-sig-arg">cmdList</span>)</span><br />
Writes the command list to Ant format.</td>
<td align="right" valign="top">
<span class="codelink"><a href="buildtools-pysrc.html#AntWriter.write">source code</a></span>
</td>
</tr>
</table>
</td>
</tr>
<tr class="private">
<td width="15%" align="right" valign="top" class="summary">
<span class="summary-type"> </span>
</td><td class="summary">
<table width="100%" cellpadding="0" cellspacing="0" border="0">
<tr>
<td><span class="summary-sig"><a name="__stageToTarget"></a><span class="summary-sig-name">__stageToTarget</span>(<span class="summary-sig-arg">self</span>,
<span class="summary-sig-arg">doc</span>,
<span class="summary-sig-arg">stage</span>,
<span class="summary-sig-arg">cmds</span>)</span><br />
Convert a stage into an Ant target.</td>
<td align="right" valign="top">
<span class="codelink"><a href="buildtools-pysrc.html#AntWriter.__stageToTarget">source code</a></span>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td colspan="2" class="summary">
<p class="indent-wrapped-lines"><b>Inherited from <code><a href="buildtools.AbstractOutputWriter-class.html">AbstractOutputWriter</a></code></b>:
<code><a href="buildtools.AbstractOutputWriter-class.html#__call__">__call__</a></code>,
<code><a href="buildtools.AbstractOutputWriter-class.html#close">close</a></code>
</p>
</td>
</tr>
</table>
<!-- ==================== STATIC METHODS ==================== -->
<a name="section-StaticMethods"></a>
<table class="summary" border="1" cellpadding="3"
cellspacing="0" width="100%" bgcolor="white">
<tr bgcolor="#70b0f0" class="table-header">
<td colspan="2" class="table-header">
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr valign="top">
<td align="left"><span class="table-header">Static Methods</span></td>
<td align="right" valign="top"
><span class="options">[<a href="#section-StaticMethods"
class="privatelink" onclick="toggle_private();"
>hide private</a>]</span></td>
</tr>
</table>
</td>
</tr>
<tr class="private">
<td width="15%" align="right" valign="top" class="summary">
<span class="summary-type"> </span>
</td><td class="summary">
<table width="100%" cellpadding="0" cellspacing="0" border="0">
<tr>
<td><span class="summary-sig"><a name="__commandToAnt"></a><span class="summary-sig-name">__commandToAnt</span>(<span class="summary-sig-arg">doc</span>,
<span class="summary-sig-arg">cmd</span>)</span><br />
Convert a command into an Ant task.</td>
<td align="right" valign="top">
<span class="codelink"><a href="buildtools-pysrc.html#AntWriter.__commandToAnt">source code</a></span>
</td>
</tr>
</table>
</td>
</tr>
<tr class="private">
<td width="15%" align="right" valign="top" class="summary">
<span class="summary-type"> </span>
</td><td class="summary">
<table width="100%" cellpadding="0" cellspacing="0" border="0">
<tr>
<td><span class="summary-sig"><a name="__getCommandByStage"></a><span class="summary-sig-name">__getCommandByStage</span>(<span class="summary-sig-arg">cmdList</span>)</span><br />
Reorder a CommandList into a list of stages.</td>
<td align="right" valign="top">
<span class="codelink"><a href="buildtools-pysrc.html#AntWriter.__getCommandByStage">source code</a></span>
</td>
</tr>
</table>
</td>
</tr>
</table>
<!-- ==================== METHOD DETAILS ==================== -->
<a name="section-MethodDetails"></a>
<table class="details" border="1" cellpadding="3"
cellspacing="0" width="100%" bgcolor="white">
<tr bgcolor="#70b0f0" class="table-header">
<td colspan="2" class="table-header">
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr valign="top">
<td align="left"><span class="table-header">Method Details</span></td>
<td align="right" valign="top"
><span class="options">[<a href="#section-MethodDetails"
class="privatelink" onclick="toggle_private();"
>hide private</a>]</span></td>
</tr>
</table>
</td>
</tr>
</table>
<a name="__init__"></a>
<div>
<table class="details" border="1" cellpadding="3"
cellspacing="0" width="100%" bgcolor="white">
<tr><td>
<table width="100%" cellpadding="0" cellspacing="0" border="0">
<tr valign="top"><td>
<h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>,
<span class="sig-arg">fileOut</span>)</span>
<br /><em class="fname">(Constructor)</em>
</h3>
</td><td align="right" valign="top"
><span class="codelink"><a href="buildtools-pysrc.html#AntWriter.__init__">source code</a></span>
</td>
</table>
<dl class="fields">
<dt>Overrides:
<a href="buildtools.AbstractOutputWriter-class.html#__init__">AbstractOutputWriter.__init__</a>
</dt>
</dl>
</td></tr></table>
</div>
<a name="writeTopLevel"></a>
<div>
<table class="details" border="1" cellpadding="3"
cellspacing="0" width="100%" bgcolor="white">
<tr><td>
<table width="100%" cellpadding="0" cellspacing="0" border="0">
<tr valign="top"><td>
<h3 class="epydoc"><span class="sig"><span class="sig-name">writeTopLevel</span>(<span class="sig-arg">self</span>,
<span class="sig-arg">config_list</span>,
<span class="sig-arg">spec_name</span>,
<span class="sig-arg">output_path</span>,
<span class="sig-arg">xml_file</span>)</span>
</h3>
</td><td align="right" valign="top"
><span class="codelink"><a href="buildtools-pysrc.html#AntWriter.writeTopLevel">source code</a></span>
</td>
</table>
Method to override to implement top level commands.
<dl class="fields">
<dt>Overrides:
<a href="buildtools.AbstractOutputWriter-class.html#writeTopLevel">AbstractOutputWriter.writeTopLevel</a>
<dd><em class="note">(inherited documentation)</em></dd>
</dt>
</dl>
</td></tr></table>
</div>
<a name="write"></a>
<div>
<table class="details" border="1" cellpadding="3"
cellspacing="0" width="100%" bgcolor="white">
<tr><td>
<table width="100%" cellpadding="0" cellspacing="0" border="0">
<tr valign="top"><td>
<h3 class="epydoc"><span class="sig"><span class="sig-name">write</span>(<span class="sig-arg">self</span>,
<span class="sig-arg">cmdList</span>)</span>
</h3>
</td><td align="right" valign="top"
><span class="codelink"><a href="buildtools-pysrc.html#AntWriter.write">source code</a></span>
</td>
</table>
Writes the command list to Ant format.
<dl class="fields">
<dt>Overrides:
<a href="buildtools.AbstractOutputWriter-class.html#write">AbstractOutputWriter.write</a>
</dt>
</dl>
</td></tr></table>
</div>
<br />
<!-- ==================== NAVIGATION BAR ==================== -->
<table class="navbar" border="0" width="100%" cellpadding="0"
bgcolor="#a0c0ff" cellspacing="0">
<tr valign="middle">
<!-- Tree link -->
<th> <a
href="module-tree.html">Trees</a> </th>
<!-- Index link -->
<th> <a
href="identifier-index.html">Indices</a> </th>
<!-- Help link -->
<th> <a
href="help.html">Help</a> </th>
<th class="navbar" width="100%"></th>
</tr>
</table>
<table border="0" cellpadding="0" cellspacing="0" width="100%%">
<tr>
<td align="left" class="footer">
Generated by Epydoc 3.0beta1 on Wed Sep 09 13:44:17 2009
</td>
<td align="right" class="footer">
<a href="http://epydoc.sourceforge.net">http://epydoc.sourceforge.net</a>
</td>
</tr>
</table>
<script type="text/javascript">
<!--
// Private objects are initially displayed (because if
// javascript is turned off then we want them to be
// visible); but by default, we want to hide them. So hide
// them unless we have a cookie that says to show them.
checkCookie()
// -->
</script>
</body>
</html>