Python scripting utilities

Merge lp:~al-maisan/py-script/doc-500616 into lp:py-script

doc-500616
Merge into trunk

Proposed by Muharem Hrnjadovic on 2009-12-26

Status:

Merged

Approved by:

Muharem Hrnjadovic on 2009-12-26

Approved revision:

not available

Merged at revision:

not available

Proposed branch:

lp:~al-maisan/py-script/doc-500616

Merge into:

lp:py-script

Diff against target:

5792 lines (+1135/-2589)

21 files modified

doc/html/api-objects.txt (+0/-6)
doc/html/class-tree.html (+0/-132)
doc/html/epydoc.css (+0/-312)
doc/html/epydoc.js (+0/-280)
doc/html/frames.html (+0/-17)
doc/html/help.html (+0/-278)
doc/html/identifier-index.html (+0/-181)
doc/html/index.html (+0/-17)
doc/html/module-tree.html (+0/-115)
doc/html/redirect.html (+0/-38)
doc/html/scriptutil-module.html (+0/-509)
doc/html/scriptutil-pysrc.html (+0/-388)
doc/html/scriptutil.ScriptError-class.html (+0/-197)
doc/html/scriptutil.find-module.html (+494/-0)
doc/html/scriptutil.find-pysrc.html (+390/-0)
doc/html/scriptutil.find.ScriptError-class.html (+202/-0)
doc/html/toc-everything.html (+0/-37)
doc/html/toc-scriptutil-module.html (+0/-37)
doc/html/toc-scriptutil.find-module.html (+38/-0)
doc/html/toc.html (+0/-34)
src/scriptutil/find.py (+11/-11)

To merge this branch:

bzr merge lp:~al-maisan/py-script/doc-500616

Medium

Fix Committed

Link a bug report

Reviewer	Review Type	Date Requested	Status
Muharem Hrnjadovic			Approve on 2009-12-26
Review via email: mp+16602@code.launchpad.net

Commit message

HTML doc re-generated.

Revision history for this message

Muharem Hrnjadovic (al-maisan) wrote on 2009-12-26:

HTML doc re-generated.

Revision history for this message

Muharem Hrnjadovic (al-maisan) wrote on 2009-12-26:

Looks good!

review: Approve

Preview Diff

[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk

The diff has been truncated for viewing.

Subscribers

People subscribed via source and target branches

to all changes:

Muharem Hrnjadovic

 === added directory 'doc/html'
 === removed directory 'doc/html'
 === added file 'doc/html/api-objects.txt'
 --- doc/html/api-objects.txt	1970-01-01 00:00:00 +0000
 +++ doc/html/api-objects.txt	2009-12-26 22:06:14 +0000
@@ -0,0 +1,9 @@
++scriptutil	scriptutil-module.html
++scriptutil.__package__	scriptutil-module.html#__package__
++scriptutil.find	scriptutil.find-module.html
++scriptutil.find.grep	scriptutil.find-module.html#grep
++scriptutil.find.pprint	scriptutil.find-module.html#pprint
++scriptutil.find.__package__	scriptutil.find-module.html#__package__
++scriptutil.find.replace	scriptutil.find-module.html#replace
++scriptutil.find.find	scriptutil.find-module.html#find
++scriptutil.find.ScriptError	scriptutil.find.ScriptError-class.html
 === removed file 'doc/html/api-objects.txt'
 --- doc/html/api-objects.txt	2009-12-26 20:49:38 +0000
 +++ doc/html/api-objects.txt	1970-01-01 00:00:00 +0000
@@ -1,6 +0,0 @@
--scriptutil	scriptutil-module.html
--scriptutil.printr	scriptutil-module.html#printr
--scriptutil.freplace	scriptutil-module.html#freplace
--scriptutil.ffind	scriptutil-module.html#ffind
--scriptutil.ffindgrep	scriptutil-module.html#ffindgrep
--scriptutil.ScriptError	scriptutil.ScriptError-class.html
 === added file 'doc/html/class-tree.html'
 --- doc/html/class-tree.html	1970-01-01 00:00:00 +0000
 +++ doc/html/class-tree.html	2009-12-26 22:06:14 +0000
@@ -0,0 +1,132 @@
++<?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>Class Hierarchy</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">
++  <!-- Home link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Tree link -->
++      <th bgcolor="#70b0f0" class="navbar-select"
++          >&nbsp;&nbsp;&nbsp;Trees&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Index link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Help link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Project homepage -->
++      <th class="navbar" align="right" width="100%">
++        <table border="0" cellpadding="0" cellspacing="0">
++          <tr><th class="navbar" align="center"
++            ><a class="navbar" target="_top" href="https://launchpad.net/py-script">Project Homepage</a></th>
++          </tr></table></th>
++  </tr>
++</table>
++<table width="100%" cellpadding="0" cellspacing="0">
++  <tr valign="top">
++    <td width="100%">&nbsp;</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&nbsp;private</a>]</span></td></tr>
++        <tr><td align="right"><span class="options"
++            >[<a href="frames.html" target="_top">frames</a
++            >]&nbsp;|&nbsp;<a href="class-tree.html"
++            target="_top">no&nbsp;frames</a>]</span></td></tr>
++      </table>
++    </td>
++  </tr>
++</table>
++<center><b>
++ [ <a href="module-tree.html">Module Hierarchy</a>
++ | <a href="class-tree.html">Class Hierarchy</a> ]
++</b></center><br />
++<h1 class="epydoc">Class Hierarchy</h1>
++<ul class="nomargin-top">
++    <li> <strong class="uidlink">object</strong>:
++      <em class="summary">The most base type</em>
++    <ul>
++    <li> <strong class="uidlink">exceptions.BaseException</strong>:
++      <em class="summary">Common base class for all exceptions</em>
++    <ul>
++    <li> <strong class="uidlink">exceptions.Exception</strong>:
++      <em class="summary">Common base class for all non-exit exceptions.</em>
++    <ul>
++    <li> <strong class="uidlink"><a href="scriptutil.find.ScriptError-class.html">scriptutil.find.ScriptError</a></strong>:
++      <em class="summary">The exception raised in case of failures.</em>
++    </li>
++    </ul>
++    </li>
++    </ul>
++    </li>
++    </ul>
++    </li>
++</ul>
++<!-- ==================== NAVIGATION BAR ==================== -->
++<table class="navbar" border="0" width="100%" cellpadding="0"
++       bgcolor="#a0c0ff" cellspacing="0">
++  <tr valign="middle">
++  <!-- Home link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Tree link -->
++      <th bgcolor="#70b0f0" class="navbar-select"
++          >&nbsp;&nbsp;&nbsp;Trees&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Index link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Help link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Project homepage -->
++      <th class="navbar" align="right" width="100%">
++        <table border="0" cellpadding="0" cellspacing="0">
++          <tr><th class="navbar" align="center"
++            ><a class="navbar" target="_top" href="https://launchpad.net/py-script">Project Homepage</a></th>
++          </tr></table></th>
++  </tr>
++</table>
++<table border="0" cellpadding="0" cellspacing="0" width="100%%">
++  <tr>
++    <td align="left" class="footer">
++    Generated by Epydoc 3.0.1 on Sat Dec 26 23:01:34 2009
++    </td>
++    <td align="right" class="footer">
++      <a target="mainFrame" 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>
 === removed file 'doc/html/class-tree.html'
 --- doc/html/class-tree.html	2009-12-26 20:49:38 +0000
 +++ doc/html/class-tree.html	1970-01-01 00:00:00 +0000
@@ -1,132 +0,0 @@
--<?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>Class Hierarchy</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">
--  <!-- Home link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Tree link -->
--      <th bgcolor="#70b0f0" class="navbar-select"
--          >&nbsp;&nbsp;&nbsp;Trees&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Index link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Help link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Project homepage -->
--      <th class="navbar" align="right" width="100%">
--        <table border="0" cellpadding="0" cellspacing="0">
--          <tr><th class="navbar" align="center"
--            ><a class="navbar" target="_top" href="http://hrnjad.net/src/scriptutil">Module scriptutil</a></th>
--          </tr></table></th>
--  </tr>
--</table>
--<table width="100%" cellpadding="0" cellspacing="0">
--  <tr valign="top">
--    <td width="100%">&nbsp;</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&nbsp;private</a>]</span></td></tr>
--        <tr><td align="right"><span class="options"
--            >[<a href="frames.html" target="_top">frames</a
--            >]&nbsp;|&nbsp;<a href="class-tree.html"
--            target="_top">no&nbsp;frames</a>]</span></td></tr>
--      </table>
--    </td>
--  </tr>
--</table>
--<center><b>
-- [ <a href="module-tree.html">Module Hierarchy</a>
-- | <a href="class-tree.html">Class Hierarchy</a> ]
--</b></center><br />
--<h1 class="epydoc">Class Hierarchy</h1>
--<ul class="nomargin-top">
--    <li> <strong class="uidlink">object</strong>:
--      <em class="summary">The most base type</em>
--    <ul>
--    <li> <strong class="uidlink">exceptions.BaseException</strong>:
--      <em class="summary">Common base class for all exceptions</em>
--    <ul>
--    <li> <strong class="uidlink">exceptions.Exception</strong>:
--      <em class="summary">Common base class for all non-exit exceptions.</em>
--    <ul>
--    <li> <strong class="uidlink"><a href="scriptutil.ScriptError-class.html">scriptutil.ScriptError</a></strong>:
--      <em class="summary">The exception raised in case of failures.</em>
--    </li>
--    </ul>
--    </li>
--    </ul>
--    </li>
--    </ul>
--    </li>
--</ul>
--<!-- ==================== NAVIGATION BAR ==================== -->
--<table class="navbar" border="0" width="100%" cellpadding="0"
--       bgcolor="#a0c0ff" cellspacing="0">
--  <tr valign="middle">
--  <!-- Home link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Tree link -->
--      <th bgcolor="#70b0f0" class="navbar-select"
--          >&nbsp;&nbsp;&nbsp;Trees&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Index link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Help link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Project homepage -->
--      <th class="navbar" align="right" width="100%">
--        <table border="0" cellpadding="0" cellspacing="0">
--          <tr><th class="navbar" align="center"
--            ><a class="navbar" target="_top" href="http://hrnjad.net/src/scriptutil">Module scriptutil</a></th>
--          </tr></table></th>
--  </tr>
--</table>
--<table border="0" cellpadding="0" cellspacing="0" width="100%%">
--  <tr>
--    <td align="left" class="footer">
--    Generated by Epydoc 3.0beta1 on Thu May 22 18:10:51 2008
--    </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>
 === added file 'doc/html/crarr.png'
 Binary files doc/html/crarr.png	1970-01-01 00:00:00 +0000 and doc/html/crarr.png	2009-12-26 22:06:14 +0000 differ
 === removed file 'doc/html/crarr.png'
 Binary files doc/html/crarr.png	2009-12-26 20:49:38 +0000 and doc/html/crarr.png	1970-01-01 00:00:00 +0000 differ
 === added file 'doc/html/epydoc.css'
 --- doc/html/epydoc.css	1970-01-01 00:00:00 +0000
 +++ doc/html/epydoc.css	2009-12-26 22:06:14 +0000
@@ -0,0 +1,322 @@
++
++
++/* Epydoc CSS Stylesheet
++ *
++ * This stylesheet can be used to customize the appearance of epydoc's
++ * HTML output.
++ *
++ */
++
++/* Default Colors & Styles
++ *   - Set the default foreground & background color with 'body'; and
++ *     link colors with 'a:link' and 'a:visited'.
++ *   - Use bold for decision list terms.
++ *   - The heading styles defined here are used for headings *within*
++ *     docstring descriptions.  All headings used by epydoc itself use
++ *     either class='epydoc' or class='toc' (CSS styles for both
++ *     defined below).
++ */
++body                        { background: #ffffff; color: #000000; }
++p                           { margin-top: 0.5em; margin-bottom: 0.5em; }
++a:link                      { color: #0000ff; }
++a:visited                   { color: #204080; }
++dt                          { font-weight: bold; }
++h1                          { font-size: +140%; font-style: italic;
++                              font-weight: bold; }
++h2                          { font-size: +125%; font-style: italic;
++                              font-weight: bold; }
++h3                          { font-size: +110%; font-style: italic;
++                              font-weight: normal; }
++code                        { font-size: 100%; }
++/* N.B.: class, not pseudoclass */
++a.link                      { font-family: monospace; }
++
++/* Page Header & Footer
++ *   - The standard page header consists of a navigation bar (with
++ *     pointers to standard pages such as 'home' and 'trees'); a
++ *     breadcrumbs list, which can be used to navigate to containing
++ *     classes or modules; options links, to show/hide private
++ *     variables and to show/hide frames; and a page title (using
++ *     <h1>).  The page title may be followed by a link to the
++ *     corresponding source code (using 'span.codelink').
++ *   - The footer consists of a navigation bar, a timestamp, and a
++ *     pointer to epydoc's homepage.
++ */
++h1.epydoc                   { margin: 0; font-size: +140%; font-weight: bold; }
++h2.epydoc                   { font-size: +130%; font-weight: bold; }
++h3.epydoc                   { font-size: +115%; font-weight: bold;
++                              margin-top: 0.2em; }
++td h3.epydoc                { font-size: +115%; font-weight: bold;
++                              margin-bottom: 0; }
++table.navbar                { background: #a0c0ff; color: #000000;
++                              border: 2px groove #c0d0d0; }
++table.navbar table          { color: #000000; }
++th.navbar-select            { background: #70b0ff;
++                              color: #000000; }
++table.navbar a              { text-decoration: none; }
++table.navbar a:link         { color: #0000ff; }
++table.navbar a:visited      { color: #204080; }
++span.breadcrumbs            { font-size: 85%; font-weight: bold; }
++span.options                { font-size: 70%; }
++span.codelink               { font-size: 85%; }
++td.footer                   { font-size: 85%; }
++
++/* Table Headers
++ *   - Each summary table and details section begins with a 'header'
++ *     row.  This row contains a section title (marked by
++ *     'span.table-header') as well as a show/hide private link
++ *     (marked by 'span.options', defined above).
++ *   - Summary tables that contain user-defined groups mark those
++ *     groups using 'group header' rows.
++ */
++td.table-header             { background: #70b0ff; color: #000000;
++                              border: 1px solid #608090; }
++td.table-header table       { color: #000000; }
++td.table-header table a:link      { color: #0000ff; }
++td.table-header table a:visited   { color: #204080; }
++span.table-header           { font-size: 120%; font-weight: bold; }
++th.group-header             { background: #c0e0f8; color: #000000;
++                              text-align: left; font-style: italic;
++                              font-size: 115%;
++                              border: 1px solid #608090; }
++
++/* Summary Tables (functions, variables, etc)
++ *   - Each object is described by a single row of the table with
++ *     two cells.  The left cell gives the object's type, and is
++ *     marked with 'code.summary-type'.  The right cell gives the
++ *     object's name and a summary description.
++ *   - CSS styles for the table's header and group headers are
++ *     defined above, under 'Table Headers'
++ */
++table.summary               { border-collapse: collapse;
++                              background: #e8f0f8; color: #000000;
++                              border: 1px solid #608090;
++                              margin-bottom: 0.5em; }
++td.summary                  { border: 1px solid #608090; }
++code.summary-type           { font-size: 85%; }
++table.summary a:link        { color: #0000ff; }
++table.summary a:visited     { color: #204080; }
++
++
++/* Details Tables (functions, variables, etc)
++ *   - Each object is described in its own div.
++ *   - A single-row summary table w/ table-header is used as
++ *     a header for each details section (CSS style for table-header
++ *     is defined above, under 'Table Headers').
++ */
++table.details               { border-collapse: collapse;
++                              background: #e8f0f8; color: #000000;
++                              border: 1px solid #608090;
++                              margin: .2em 0 0 0; }
++table.details table         { color: #000000; }
++table.details a:link        { color: #0000ff; }
++table.details a:visited     { color: #204080; }
++
++/* Fields */
++dl.fields                   { margin-left: 2em; margin-top: 1em;
++                              margin-bottom: 1em; }
++dl.fields dd ul             { margin-left: 0em; padding-left: 0em; }
++dl.fields dd ul li ul       { margin-left: 2em; padding-left: 0em; }
++div.fields                  { margin-left: 2em; }
++div.fields p                { margin-bottom: 0.5em; }
++
++/* Index tables (identifier index, term index, etc)
++ *   - link-index is used for indices containing lists of links
++ *     (namely, the identifier index & term index).
++ *   - index-where is used in link indices for the text indicating
++ *     the container/source for each link.
++ *   - metadata-index is used for indices containing metadata
++ *     extracted from fields (namely, the bug index & todo index).
++ */
++table.link-index            { border-collapse: collapse;
++                              background: #e8f0f8; color: #000000;
++                              border: 1px solid #608090; }
++td.link-index               { border-width: 0px; }
++table.link-index a:link     { color: #0000ff; }
++table.link-index a:visited  { color: #204080; }
++span.index-where            { font-size: 70%; }
++table.metadata-index        { border-collapse: collapse;
++                              background: #e8f0f8; color: #000000;
++                              border: 1px solid #608090;
++                              margin: .2em 0 0 0; }
++td.metadata-index           { border-width: 1px; border-style: solid; }
++table.metadata-index a:link { color: #0000ff; }
++table.metadata-index a:visited  { color: #204080; }
++
++/* Function signatures
++ *   - sig* is used for the signature in the details section.
++ *   - .summary-sig* is used for the signature in the summary
++ *     table, and when listing property accessor functions.
++ * */
++.sig-name                   { color: #006080; }
++.sig-arg                    { color: #008060; }
++.sig-default                { color: #602000; }
++.summary-sig                { font-family: monospace; }
++.summary-sig-name           { color: #006080; font-weight: bold; }
++table.summary a.summary-sig-name:link
++                            { color: #006080; font-weight: bold; }
++table.summary a.summary-sig-name:visited
++                            { color: #006080; font-weight: bold; }
++.summary-sig-arg            { color: #006040; }
++.summary-sig-default        { color: #501800; }
++
++/* Subclass list
++ */
++ul.subclass-list { display: inline; }
++ul.subclass-list li { display: inline; }
++
++/* To render variables, classes etc. like functions */
++table.summary .summary-name { color: #006080; font-weight: bold;
++                              font-family: monospace; }
++table.summary
++     a.summary-name:link    { color: #006080; font-weight: bold;
++                              font-family: monospace; }
++table.summary
++    a.summary-name:visited  { color: #006080; font-weight: bold;
++                              font-family: monospace; }
++
++/* Variable values
++ *   - In the 'variable details' sections, each varaible's value is
++ *     listed in a 'pre.variable' box.  The width of this box is
++ *     restricted to 80 chars; if the value's repr is longer than
++ *     this it will be wrapped, using a backslash marked with
++ *     class 'variable-linewrap'.  If the value's repr is longer
++ *     than 3 lines, the rest will be ellided; and an ellipsis
++ *     marker ('...' marked with 'variable-ellipsis') will be used.
++ *   - If the value is a string, its quote marks will be marked
++ *     with 'variable-quote'.
++ *   - If the variable is a regexp, it is syntax-highlighted using
++ *     the re* CSS classes.
++ */
++pre.variable                { padding: .5em; margin: 0;
++                              background: #dce4ec; color: #000000;
++                              border: 1px solid #708890; }
++.variable-linewrap          { color: #604000; font-weight: bold; }
++.variable-ellipsis          { color: #604000; font-weight: bold; }
++.variable-quote             { color: #604000; font-weight: bold; }
++.variable-group             { color: #008000; font-weight: bold; }
++.variable-op                { color: #604000; font-weight: bold; }
++.variable-string            { color: #006030; }
++.variable-unknown           { color: #a00000; font-weight: bold; }
++.re                         { color: #000000; }
++.re-char                    { color: #006030; }
++.re-op                      { color: #600000; }
++.re-group                   { color: #003060; }
++.re-ref                     { color: #404040; }
++
++/* Base tree
++ *   - Used by class pages to display the base class hierarchy.
++ */
++pre.base-tree               { font-size: 80%; margin: 0; }
++
++/* Frames-based table of contents headers
++ *   - Consists of two frames: one for selecting modules; and
++ *     the other listing the contents of the selected module.
++ *   - h1.toc is used for each frame's heading
++ *   - h2.toc is used for subheadings within each frame.
++ */
++h1.toc                      { text-align: center; font-size: 105%;
++                              margin: 0; font-weight: bold;
++                              padding: 0; }
++h2.toc                      { font-size: 100%; font-weight: bold;
++                              margin: 0.5em 0 0 -0.3em; }
++
++/* Syntax Highlighting for Source Code
++ *   - doctest examples are displayed in a 'pre.py-doctest' block.
++ *     If the example is in a details table entry, then it will use
++ *     the colors specified by the 'table pre.py-doctest' line.
++ *   - Source code listings are displayed in a 'pre.py-src' block.
++ *     Each line is marked with 'span.py-line' (used to draw a line
++ *     down the left margin, separating the code from the line
++ *     numbers).  Line numbers are displayed with 'span.py-lineno'.
++ *     The expand/collapse block toggle button is displayed with
++ *     'a.py-toggle' (Note: the CSS style for 'a.py-toggle' should not
++ *     modify the font size of the text.)
++ *   - If a source code page is opened with an anchor, then the
++ *     corresponding code block will be highlighted.  The code
++ *     block's header is highlighted with 'py-highlight-hdr'; and
++ *     the code block's body is highlighted with 'py-highlight'.
++ *   - The remaining py-* classes are used to perform syntax
++ *     highlighting (py-string for string literals, py-name for names,
++ *     etc.)
++ */
++pre.py-doctest              { padding: .5em; margin: 1em;
++                              background: #e8f0f8; color: #000000;
++                              border: 1px solid #708890; }
++table pre.py-doctest        { background: #dce4ec;
++                              color: #000000; }
++pre.py-src                  { border: 2px solid #000000;
++                              background: #f0f0f0; color: #000000; }
++.py-line                    { border-left: 2px solid #000000;
++                              margin-left: .2em; padding-left: .4em; }
++.py-lineno                  { font-style: italic; font-size: 90%;
++                              padding-left: .5em; }
++a.py-toggle                 { text-decoration: none; }
++div.py-highlight-hdr        { border-top: 2px solid #000000;
++                              border-bottom: 2px solid #000000;
++                              background: #d8e8e8; }
++div.py-highlight            { border-bottom: 2px solid #000000;
++                              background: #d0e0e0; }
++.py-prompt                  { color: #005050; font-weight: bold;}
++.py-more                    { color: #005050; font-weight: bold;}
++.py-string                  { color: #006030; }
++.py-comment                 { color: #003060; }
++.py-keyword                 { color: #600000; }
++.py-output                  { color: #404040; }
++.py-name                    { color: #000050; }
++.py-name:link               { color: #000050 !important; }
++.py-name:visited            { color: #000050 !important; }
++.py-number                  { color: #005000; }
++.py-defname                 { color: #000060; font-weight: bold; }
++.py-def-name                { color: #000060; font-weight: bold; }
++.py-base-class              { color: #000060; }
++.py-param                   { color: #000060; }
++.py-docstring               { color: #006030; }
++.py-decorator               { color: #804020; }
++/* Use this if you don't want links to names underlined: */
++/*a.py-name                   { text-decoration: none; }*/
++
++/* Graphs & Diagrams
++ *   - These CSS styles are used for graphs & diagrams generated using
++ *     Graphviz dot.  'img.graph-without-title' is used for bare
++ *     diagrams (to remove the border created by making the image
++ *     clickable).
++ */
++img.graph-without-title     { border: none; }
++img.graph-with-title        { border: 1px solid #000000; }
++span.graph-title            { font-weight: bold; }
++span.graph-caption          { }
++
++/* General-purpose classes
++ *   - 'p.indent-wrapped-lines' defines a paragraph whose first line
++ *     is not indented, but whose subsequent lines are.
++ *   - The 'nomargin-top' class is used to remove the top margin (e.g.
++ *     from lists).  The 'nomargin' class is used to remove both the
++ *     top and bottom margin (but not the left or right margin --
++ *     for lists, that would cause the bullets to disappear.)
++ */
++p.indent-wrapped-lines      { padding: 0 0 0 7em; text-indent: -7em;
++                              margin: 0; }
++.nomargin-top               { margin-top: 0; }
++.nomargin                   { margin-top: 0; margin-bottom: 0; }
++
++/* HTML Log */
++div.log-block               { padding: 0; margin: .5em 0 .5em 0;
++                              background: #e8f0f8; color: #000000;
++                              border: 1px solid #000000; }
++div.log-error               { padding: .1em .3em .1em .3em; margin: 4px;
++                              background: #ffb0b0; color: #000000;
++                              border: 1px solid #000000; }
++div.log-warning             { padding: .1em .3em .1em .3em; margin: 4px;
++                              background: #ffffb0; color: #000000;
++                              border: 1px solid #000000; }
++div.log-info               { padding: .1em .3em .1em .3em; margin: 4px;
++                              background: #b0ffb0; color: #000000;
++                              border: 1px solid #000000; }
++h2.log-hdr                  { background: #70b0ff; color: #000000;
++                              margin: 0; padding: 0em 0.5em 0em 0.5em;
++                              border-bottom: 1px solid #000000; font-size: 110%; }
++p.log                       { font-weight: bold; margin: .5em 0 .5em 0; }
++tr.opt-changed              { color: #000000; font-weight: bold; }
++tr.opt-default              { color: #606060; }
++pre.log                     { margin: 0; padding: 0; padding-left: 1em; }
 === removed file 'doc/html/epydoc.css'
 --- doc/html/epydoc.css	2009-12-26 20:49:38 +0000
 +++ doc/html/epydoc.css	1970-01-01 00:00:00 +0000
@@ -1,312 +0,0 @@
--
--
--/* Epydoc CSS Stylesheet
-- *
-- * This stylesheet can be used to customize the appearance of epydoc's
-- * HTML output.
-- *
-- */
--
--/* Default Colors & Styles
-- *   - Set the default foreground & background color with 'body'; and
-- *     link colors with 'a:link' and 'a:visited'.
-- *   - Use bold for decision list terms.
-- *   - The heading styles defined here are used for headings *within*
-- *     docstring descriptions.  All headings used by epydoc itself use
-- *     either class='epydoc' or class='toc' (CSS styles for both
-- *     defined below).
-- */
--body                        { background: #ffffff; color: #000000; }
--a:link                      { color: #0000ff; }
--a:visited                   { color: #204080; }
--dt                          { font-weight: bold; }
--h1                          { font-size: +140%; font-style: italic;
--                              font-weight: bold; }
--h2                          { font-size: +125%; font-style: italic;
--                              font-weight: bold; }
--h3                          { font-size: +110%; font-style: italic;
--                              font-weight: normal; }
--code                        { font-size: 100%; }
--
--/* Page Header & Footer
-- *   - The standard page header consists of a navigation bar (with
-- *     pointers to standard pages such as 'home' and 'trees'); a
-- *     breadcrumbs list, which can be used to navigate to containing
-- *     classes or modules; options links, to show/hide private
-- *     variables and to show/hide frames; and a page title (using
-- *     <h1>).  The page title may be followed by a link to the
-- *     corresponding source code (using 'span.codelink').
-- *   - The footer consists of a navigation bar, a timestamp, and a
-- *     pointer to epydoc's homepage.
-- */
--h1.epydoc                   { margin: 0; font-size: +140%; font-weight: bold; }
--h2.epydoc                   { font-size: +130%; font-weight: bold; }
--h3.epydoc                   { font-size: +115%; font-weight: bold; }
--td h3.epydoc                { font-size: +115%; font-weight: bold;
--                              margin-bottom: 0; }
--table.navbar                { background: #a0c0ff; color: #000000;
--                              border: 2px groove #c0d0d0; }
--table.navbar table          { color: #000000; }
--th.navbar-select            { background: #70b0ff;
--                              color: #000000; }
--table.navbar a              { text-decoration: none; }
--table.navbar a:link         { color: #0000ff; }
--table.navbar a:visited      { color: #204080; }
--span.breadcrumbs            { font-size: 85%; font-weight: bold; }
--span.options                { font-size: 70%; }
--span.codelink               { font-size: 85%; }
--td.footer                   { font-size: 85%; }
--
--/* Table Headers
-- *   - Each summary table and details section begins with a 'header'
-- *     row.  This row contains a section title (marked by
-- *     'span.table-header') as well as a show/hide private link
-- *     (marked by 'span.options', defined above).
-- *   - Summary tables that contain user-defined groups mark those
-- *     groups using 'group header' rows.
-- */
--td.table-header             { background: #70b0ff; color: #000000;
--                              border: 1px solid #608090; }
--td.table-header table       { color: #000000; }
--td.table-header table a:link      { color: #0000ff; }
--td.table-header table a:visited   { color: #204080; }
--span.table-header           { font-size: 120%; font-weight: bold; }
--th.group-header             { background: #c0e0f8; color: #000000;
--                              text-align: left; font-style: italic;
--                              font-size: 115%;
--                              border: 1px solid #608090; }
--
--/* Summary Tables (functions, variables, etc)
-- *   - Each object is described by a single row of the table with
-- *     two cells.  The left cell gives the object's type, and is
-- *     marked with 'code.summary-type'.  The right cell gives the
-- *     object's name and a summary description.
-- *   - CSS styles for the table's header and group headers are
-- *     defined above, under 'Table Headers'
-- */
--table.summary               { border-collapse: collapse;
--                              background: #e8f0f8; color: #000000;
--                              border: 1px solid #608090;
--                              margin-bottom: 0.5em; }
--td.summary                  { border: 1px solid #608090; }
--code.summary-type           { font-size: 85%; }
--table.summary a:link        { color: #0000ff; }
--table.summary a:visited     { color: #204080; }
--
--
--/* Details Tables (functions, variables, etc)
-- *   - Each object is described in its own div.
-- *   - A single-row summary table w/ table-header is used as
-- *     a header for each details section (CSS style for table-header
-- *     is defined above, under 'Table Headers').
-- */
--table.details               { border-collapse: collapse;
--                              background: #e8f0f8; color: #000000;
--                              border: 1px solid #608090;
--                              margin: .2em 0 0 0; }
--table.details table         { color: #000000; }
--table.details a:link        { color: #0000ff; }
--table.details a:visited     { color: #204080; }
--
--/* Fields */
--dl.fields                   { margin-left: 2em; margin-top: 1em;
--                              margin-bottom: 1em; }
--dl.fields dd ul             { margin-left: 0em; padding-left: 0em; }
--div.fields                  { margin-left: 2em; }
--div.fields p                { margin-bottom: 0.5em; }
--
--/* Index tables (identifier index, term index, etc)
-- *   - link-index is used for indices containing lists of links
-- *     (namely, the identifier index & term index).
-- *   - index-where is used in link indices for the text indicating
-- *     the container/source for each link.
-- *   - metadata-index is used for indices containing metadata
-- *     extracted from fields (namely, the bug index & todo index).
-- */
--table.link-index            { border-collapse: collapse;
--                              background: #e8f0f8; color: #000000;
--                              border: 1px solid #608090; }
--td.link-index               { border-width: 0px; }
--table.link-index a:link     { color: #0000ff; }
--table.link-index a:visited  { color: #204080; }
--span.index-where            { font-size: 70%; }
--table.metadata-index        { border-collapse: collapse;
--                              background: #e8f0f8; color: #000000;
--                              border: 1px solid #608090;
--                              margin: .2em 0 0 0; }
--td.metadata-index           { border-width: 1px; border-style: solid; }
--table.metadata-index a:link { color: #0000ff; }
--table.metadata-index a:visited  { color: #204080; }
--
--/* Function signatures
-- *   - sig* is used for the signature in the details section.
-- *   - .summary-sig* is used for the signature in the summary
-- *     table, and when listing property accessor functions.
-- * */
--.sig-name                   { color: #006080; }
--.sig-arg                    { color: #008060; }
--.sig-default                { color: #602000; }
--.summary-sig                { font-family: monospace; }
--.summary-sig-name           { color: #006080; font-weight: bold; }
--table.summary a.summary-sig-name:link
--                            { color: #006080; font-weight: bold; }
--table.summary a.summary-sig-name:visited
--                            { color: #006080; font-weight: bold; }
--.summary-sig-arg            { color: #006040; }
--.summary-sig-default        { color: #501800; }
--
--/* To render variables, classes etc. like functions */
--table.summary .summary-name { color: #006080; font-weight: bold;
--                              font-family: monospace; }
--table.summary
--     a.summary-name:link    { color: #006080; font-weight: bold;
--                              font-family: monospace; }
--table.summary
--    a.summary-name:visited  { color: #006080; font-weight: bold;
--                              font-family: monospace; }
--
--/* Variable values
-- *   - In the 'variable details' sections, each varaible's value is
-- *     listed in a 'pre.variable' box.  The width of this box is
-- *     restricted to 80 chars; if the value's repr is longer than
-- *     this it will be wrapped, using a backslash marked with
-- *     class 'variable-linewrap'.  If the value's repr is longer
-- *     than 3 lines, the rest will be ellided; and an ellipsis
-- *     marker ('...' marked with 'variable-ellipsis') will be used.
-- *   - If the value is a string, its quote marks will be marked
-- *     with 'variable-quote'.
-- *   - If the variable is a regexp, it is syntax-highlighted using
-- *     the re* CSS classes.
-- */
--pre.variable                { padding: .5em; margin: 0;
--                              background: #dce4ec; color: #000000;
--                              border: 1px solid #708890; }
--.variable-linewrap          { color: #604000; font-weight: bold; }
--.variable-ellipsis          { color: #604000; font-weight: bold; }
--.variable-quote             { color: #604000; font-weight: bold; }
--.variable-group             { color: #008000; font-weight: bold; }
--.variable-op                { color: #604000; font-weight: bold; }
--.variable-string            { color: #006030; }
--.variable-unknown           { color: #a00000; font-weight: bold; }
--.re                         { color: #000000; }
--.re-char                    { color: #006030; }
--.re-op                      { color: #600000; }
--.re-group                   { color: #003060; }
--.re-ref                     { color: #404040; }
--
--/* Base tree
-- *   - Used by class pages to display the base class hierarchy.
-- */
--pre.base-tree               { font-size: 80%; margin: 0; }
--
--/* Frames-based table of contents headers
-- *   - Consists of two frames: one for selecting modules; and
-- *     the other listing the contents of the selected module.
-- *   - h1.toc is used for each frame's heading
-- *   - h2.toc is used for subheadings within each frame.
-- */
--h1.toc                      { text-align: center; font-size: 105%;
--                              margin: 0; font-weight: bold;
--                              padding: 0; }
--h2.toc                      { font-size: 100%; font-weight: bold;
--                              margin: 0.5em 0 0 -0.3em; }
--
--/* Syntax Highlighting for Source Code
-- *   - doctest examples are displayed in a 'pre.py-doctest' block.
-- *     If the example is in a details table entry, then it will use
-- *     the colors specified by the 'table pre.py-doctest' line.
-- *   - Source code listings are displayed in a 'pre.py-src' block.
-- *     Each line is marked with 'span.py-line' (used to draw a line
-- *     down the left margin, separating the code from the line
-- *     numbers).  Line numbers are displayed with 'span.py-lineno'.
-- *     The expand/collapse block toggle button is displayed with
-- *     'a.py-toggle' (Note: the CSS style for 'a.py-toggle' should not
-- *     modify the font size of the text.)
-- *   - If a source code page is opened with an anchor, then the
-- *     corresponding code block will be highlighted.  The code
-- *     block's header is highlighted with 'py-highlight-hdr'; and
-- *     the code block's body is highlighted with 'py-highlight'.
-- *   - The remaining py-* classes are used to perform syntax
-- *     highlighting (py-string for string literals, py-name for names,
-- *     etc.)
-- */
--pre.py-doctest              { padding: .5em; margin: 1em;
--                              background: #e8f0f8; color: #000000;
--                              border: 1px solid #708890; }
--table pre.py-doctest        { background: #dce4ec;
--                              color: #000000; }
--pre.py-src                  { border: 2px solid #000000;
--                              background: #f0f0f0; color: #000000; }
--.py-line                    { border-left: 2px solid #000000;
--                              margin-left: .2em; padding-left: .4em; }
--.py-lineno                  { font-style: italic; font-size: 90%;
--                              padding-left: .5em; }
--a.py-toggle                 { text-decoration: none; }
--div.py-highlight-hdr        { border-top: 2px solid #000000;
--                              border-bottom: 2px solid #000000;
--                              background: #d8e8e8; }
--div.py-highlight            { border-bottom: 2px solid #000000;
--                              background: #d0e0e0; }
--.py-prompt                  { color: #005050; font-weight: bold;}
--.py-more                    { color: #005050; font-weight: bold;}
--.py-string                  { color: #006030; }
--.py-comment                 { color: #003060; }
--.py-keyword                 { color: #600000; }
--.py-output                  { color: #404040; }
--.py-name                    { color: #000050; }
--.py-name:link               { color: #000050 !important; }
--.py-name:visited            { color: #000050 !important; }
--.py-number                  { color: #005000; }
--.py-defname                 { color: #000060; font-weight: bold; }
--.py-def-name                { color: #000060; font-weight: bold; }
--.py-base-class              { color: #000060; }
--.py-param                   { color: #000060; }
--.py-docstring               { color: #006030; }
--.py-decorator               { color: #804020; }
--/* Use this if you don't want links to names underlined: */
--/*a.py-name                   { text-decoration: none; }*/
--
--/* Graphs & Diagrams
-- *   - These CSS styles are used for graphs & diagrams generated using
-- *     Graphviz dot.  'img.graph-without-title' is used for bare
-- *     diagrams (to remove the border created by making the image
-- *     clickable).
-- */
--img.graph-without-title     { border: none; }
--img.graph-with-title        { border: 1px solid #000000; }
--span.graph-title            { font-weight: bold; }
--span.graph-caption          { }
--
--/* General-purpose classes
-- *   - 'p.indent-wrapped-lines' defines a paragraph whose first line
-- *     is not indented, but whose subsequent lines are.
-- *   - The 'nomargin-top' class is used to remove the top margin (e.g.
-- *     from lists).  The 'nomargin' class is used to remove both the
-- *     top and bottom margin (but not the left or right margin --
-- *     for lists, that would cause the bullets to disappear.)
-- */
--p.indent-wrapped-lines      { padding: 0 0 0 7em; text-indent: -7em;
--                              margin: 0; }
--.nomargin-top               { margin-top: 0; }
--.nomargin                   { margin-top: 0; margin-bottom: 0; }
--
--/* HTML Log */
--div.log-block               { padding: 0; margin: .5em 0 .5em 0;
--                              background: #e8f0f8; color: #000000;
--                              border: 1px solid #000000; }
--div.log-error               { padding: .1em .3em .1em .3em; margin: 4px;
--                              background: #ffb0b0; color: #000000;
--                              border: 1px solid #000000; }
--div.log-warning             { padding: .1em .3em .1em .3em; margin: 4px;
--                              background: #ffffb0; color: #000000;
--                              border: 1px solid #000000; }
--div.log-info               { padding: .1em .3em .1em .3em; margin: 4px;
--                              background: #b0ffb0; color: #000000;
--                              border: 1px solid #000000; }
--h2.log-hdr                  { background: #70b0ff; color: #000000;
--                              margin: 0; padding: 0em 0.5em 0em 0.5em;
--                              border-bottom: 1px solid #000000; font-size: 110%; }
--p.log                       { font-weight: bold; margin: .5em 0 .5em 0; }
--tr.opt-changed              { color: #000000; font-weight: bold; }
--tr.opt-default              { color: #606060; }
--pre.log                     { margin: 0; padding: 0; padding-left: 1em; }
 === added file 'doc/html/epydoc.js'
 --- doc/html/epydoc.js	1970-01-01 00:00:00 +0000
 +++ doc/html/epydoc.js	2009-12-26 22:06:14 +0000
@@ -0,0 +1,293 @@
++function toggle_private() {
++        // Search for any private/public links on this page.  Store
++        // their old text in "cmd," so we will know what action to
++        // take; and change their text to the opposite action.
++        var cmd = "?";
++        var elts = document.getElementsByTagName("a");
++        for(var i=0; i<elts.length; i++) {
++          if (elts[i].className == "privatelink") {
++            cmd = elts[i].innerHTML;
++            elts[i].innerHTML = ((cmd && cmd.substr(0,4)=="show")?
++                                    "hide&nbsp;private":"show&nbsp;private");
++          }
++        }
++        // Update all DIVs containing private objects.
++        var elts = document.getElementsByTagName("div");
++        for(var i=0; i<elts.length; i++) {
++          if (elts[i].className == "private") {
++            elts[i].style.display = ((cmd && cmd.substr(0,4)=="hide")?"none":"block");
++          }
++          else if (elts[i].className == "public") {
++            elts[i].style.display = ((cmd && cmd.substr(0,4)=="hide")?"block":"none");
++          }
++        }
++        // Update all table rows containing private objects.  Note, we
++        // use "" instead of "block" becaue IE & firefox disagree on what
++        // this should be (block vs table-row), and "" just gives the
++        // default for both browsers.
++        var elts = document.getElementsByTagName("tr");
++        for(var i=0; i<elts.length; i++) {
++          if (elts[i].className == "private") {
++            elts[i].style.display = ((cmd && cmd.substr(0,4)=="hide")?"none":"");
++          }
++        }
++        // Update all list items containing private objects.
++        var elts = document.getElementsByTagName("li");
++        for(var i=0; i<elts.length; i++) {
++          if (elts[i].className == "private") {
++            elts[i].style.display = ((cmd && cmd.substr(0,4)=="hide")?
++                                        "none":"");
++          }
++        }
++        // Update all list items containing private objects.
++        var elts = document.getElementsByTagName("ul");
++        for(var i=0; i<elts.length; i++) {
++          if (elts[i].className == "private") {
++            elts[i].style.display = ((cmd && cmd.substr(0,4)=="hide")?"none":"block");
++          }
++        }
++        // Set a cookie to remember the current option.
++        document.cookie = "EpydocPrivate="+cmd;
++      }
++function show_private() {
++        var elts = document.getElementsByTagName("a");
++        for(var i=0; i<elts.length; i++) {
++          if (elts[i].className == "privatelink") {
++            cmd = elts[i].innerHTML;
++            if (cmd && cmd.substr(0,4)=="show")
++                toggle_private();
++          }
++        }
++      }
++function getCookie(name) {
++        var dc = document.cookie;
++        var prefix = name + "=";
++        var begin = dc.indexOf("; " + prefix);
++        if (begin == -1) {
++          begin = dc.indexOf(prefix);
++          if (begin != 0) return null;
++        } else
++        { begin += 2; }
++        var end = document.cookie.indexOf(";", begin);
++        if (end == -1)
++        { end = dc.length; }
++        return unescape(dc.substring(begin + prefix.length, end));
++      }
++function setFrame(url1, url2) {
++          parent.frames[1].location.href = url1;
++          parent.frames[2].location.href = url2;
++      }
++function checkCookie() {
++        var cmd=getCookie("EpydocPrivate");
++        if (cmd && cmd.substr(0,4)!="show" && location.href.indexOf("#_") < 0)
++            toggle_private();
++      }
++function toggleCallGraph(id) {
++        var elt = document.getElementById(id);
++        if (elt.style.display == "none")
++            elt.style.display = "block";
++        else
++            elt.style.display = "none";
++      }
++function expand(id) {
++  var elt = document.getElementById(id+"-expanded");
++  if (elt) elt.style.display = "block";
++  var elt = document.getElementById(id+"-expanded-linenums");
++  if (elt) elt.style.display = "block";
++  var elt = document.getElementById(id+"-collapsed");
++  if (elt) { elt.innerHTML = ""; elt.style.display = "none"; }
++  var elt = document.getElementById(id+"-collapsed-linenums");
++  if (elt) { elt.innerHTML = ""; elt.style.display = "none"; }
++  var elt = document.getElementById(id+"-toggle");
++  if (elt) { elt.innerHTML = "-"; }
++}
++
++function collapse(id) {
++  var elt = document.getElementById(id+"-expanded");
++  if (elt) elt.style.display = "none";
++  var elt = document.getElementById(id+"-expanded-linenums");
++  if (elt) elt.style.display = "none";
++  var elt = document.getElementById(id+"-collapsed-linenums");
++  if (elt) { elt.innerHTML = "<br />"; elt.style.display="block"; }
++  var elt = document.getElementById(id+"-toggle");
++  if (elt) { elt.innerHTML = "+"; }
++  var elt = document.getElementById(id+"-collapsed");
++  if (elt) {
++    elt.style.display = "block";
++
++    var indent = elt.getAttribute("indent");
++    var pad = elt.getAttribute("pad");
++    var s = "<tt class='py-lineno'>";
++    for (var i=0; i<pad.length; i++) { s += "&nbsp;" }
++    s += "</tt>";
++    s += "&nbsp;&nbsp;<tt class='py-line'>";
++    for (var i=0; i<indent.length; i++) { s += "&nbsp;" }
++    s += "<a href='#' onclick='expand(\"" + id;
++    s += "\");return false'>...</a></tt><br />";
++    elt.innerHTML = s;
++  }
++}
++
++function toggle(id) {
++  elt = document.getElementById(id+"-toggle");
++  if (elt.innerHTML == "-")
++      collapse(id);
++  else
++      expand(id);
++  return false;
++}
++
++function highlight(id) {
++  var elt = document.getElementById(id+"-def");
++  if (elt) elt.className = "py-highlight-hdr";
++  var elt = document.getElementById(id+"-expanded");
++  if (elt) elt.className = "py-highlight";
++  var elt = document.getElementById(id+"-collapsed");
++  if (elt) elt.className = "py-highlight";
++}
++
++function num_lines(s) {
++  var n = 1;
++  var pos = s.indexOf("\n");
++  while ( pos > 0) {
++    n += 1;
++    pos = s.indexOf("\n", pos+1);
++  }
++  return n;
++}
++
++// Collapse all blocks that mave more than `min_lines` lines.
++function collapse_all(min_lines) {
++  var elts = document.getElementsByTagName("div");
++  for (var i=0; i<elts.length; i++) {
++    var elt = elts[i];
++    var split = elt.id.indexOf("-");
++    if (split > 0)
++      if (elt.id.substring(split, elt.id.length) == "-expanded")
++        if (num_lines(elt.innerHTML) > min_lines)
++          collapse(elt.id.substring(0, split));
++  }
++}
++
++function expandto(href) {
++  var start = href.indexOf("#")+1;
++  if (start != 0 && start != href.length) {
++    if (href.substring(start, href.length) != "-") {
++      collapse_all(4);
++      pos = href.indexOf(".", start);
++      while (pos != -1) {
++        var id = href.substring(start, pos);
++        expand(id);
++        pos = href.indexOf(".", pos+1);
++      }
++      var id = href.substring(start, href.length);
++      expand(id);
++      highlight(id);
++    }
++  }
++}
++
++function kill_doclink(id) {
++  var parent = document.getElementById(id);
++  parent.removeChild(parent.childNodes.item(0));
++}
++function auto_kill_doclink(ev) {
++  if (!ev) var ev = window.event;
++  if (!this.contains(ev.toElement)) {
++    var parent = document.getElementById(this.parentID);
++    parent.removeChild(parent.childNodes.item(0));
++  }
++}
++
++function doclink(id, name, targets_id) {
++  var elt = document.getElementById(id);
++
++  // If we already opened the box, then destroy it.
++  // (This case should never occur, but leave it in just in case.)
++  if (elt.childNodes.length > 1) {
++    elt.removeChild(elt.childNodes.item(0));
++  }
++  else {
++    // The outer box: relative + inline positioning.
++    var box1 = document.createElement("div");
++    box1.style.position = "relative";
++    box1.style.display = "inline";
++    box1.style.top = 0;
++    box1.style.left = 0;
++
++    // A shadow for fun
++    var shadow = document.createElement("div");
++    shadow.style.position = "absolute";
++    shadow.style.left = "-1.3em";
++    shadow.style.top = "-1.3em";
++    shadow.style.background = "#404040";
++
++    // The inner box: absolute positioning.
++    var box2 = document.createElement("div");
++    box2.style.position = "relative";
++    box2.style.border = "1px solid #a0a0a0";
++    box2.style.left = "-.2em";
++    box2.style.top = "-.2em";
++    box2.style.background = "white";
++    box2.style.padding = ".3em .4em .3em .4em";
++    box2.style.fontStyle = "normal";
++    box2.onmouseout=auto_kill_doclink;
++    box2.parentID = id;
++
++    // Get the targets
++    var targets_elt = document.getElementById(targets_id);
++    var targets = targets_elt.getAttribute("targets");
++    var links = "";
++    target_list = targets.split(",");
++    for (var i=0; i<target_list.length; i++) {
++        var target = target_list[i].split("=");
++        links += "<li><a href='" + target[1] +
++               "' style='text-decoration:none'>" +
++               target[0] + "</a></li>";
++    }
++
++    // Put it all together.
++    elt.insertBefore(box1, elt.childNodes.item(0));
++    //box1.appendChild(box2);
++    box1.appendChild(shadow);
++    shadow.appendChild(box2);
++    box2.innerHTML =
++        "Which <b>"+name+"</b> do you want to see documentation for?" +
++        "<ul style='margin-bottom: 0;'>" +
++        links +
++        "<li><a href='#' style='text-decoration:none' " +
++        "onclick='kill_doclink(\""+id+"\");return false;'>"+
++        "<i>None of the above</i></a></li></ul>";
++  }
++  return false;
++}
++
++function get_anchor() {
++          var href = location.href;
++          var start = href.indexOf("#")+1;
++          if ((start != 0) && (start != href.length))
++              return href.substring(start, href.length);
++      }
++function redirect_url(dottedName) {
++          // Scan through each element of the "pages" list, and check
++          // if "name" matches with any of them.
++          for (var i=0; i<pages.length; i++) {
++
++              // Each page has the form "<pagename>-m" or "<pagename>-c";
++              // extract the <pagename> portion & compare it to dottedName.
++              var pagename = pages[i].substring(0, pages[i].length-2);
++              if (pagename == dottedName.substring(0,pagename.length)) {
++
++                  // We've found a page that matches `dottedName`;
++                  // construct its URL, using leftover `dottedName`
++                  // content to form an anchor.
++                  var pagetype = pages[i].charAt(pages[i].length-1);
++                  var url = pagename + ((pagetype=="m")?"-module.html":
++                                                        "-class.html");
++                  if (dottedName.length > pagename.length)
++                      url += "#" + dottedName.substring(pagename.length+1,
++                                                        dottedName.length);
++                  return url;
++              }
++          }
++      }
 === removed file 'doc/html/epydoc.js'
 --- doc/html/epydoc.js	2009-12-26 20:49:38 +0000
 +++ doc/html/epydoc.js	1970-01-01 00:00:00 +0000
@@ -1,280 +0,0 @@
--function toggle_private() {
--        // Search for any private/public links on this page.  Store
--        // their old text in "cmd," so we will know what action to
--        // take; and change their text to the opposite action.
--        var cmd = "?";
--        var elts = document.getElementsByTagName("a");
--        for(var i=0; i<elts.length; i++) {
--          if (elts[i].className == "privatelink") {
--            cmd = elts[i].innerHTML;
--            elts[i].innerHTML = ((cmd && cmd.substr(0,4)=="show")?
--                                    "hide&nbsp;private":"show&nbsp;private");
--          }
--        }
--        // Update all DIVs containing private objects.
--        var elts = document.getElementsByTagName("div");
--        for(var i=0; i<elts.length; i++) {
--          if (elts[i].className == "private") {
--            elts[i].style.display = ((cmd && cmd.substr(0,4)=="hide")?"none":"block");
--          }
--        }
--        // Update all table rowss containing private objects.  Note, we
--        // use "" instead of "block" becaue IE & firefox disagree on what
--        // this should be (block vs table-row), and "" just gives the
--        // default for both browsers.
--        var elts = document.getElementsByTagName("tr");
--        for(var i=0; i<elts.length; i++) {
--          if (elts[i].className == "private") {
--            elts[i].style.display = ((cmd && cmd.substr(0,4)=="hide")?"none":"");
--          }
--        }
--        // Update all list items containing private objects.
--        var elts = document.getElementsByTagName("li");
--        for(var i=0; i<elts.length; i++) {
--          if (elts[i].className == "private") {
--            elts[i].style.display = ((cmd && cmd.substr(0,4)=="hide")?
--                                        "none":"list-item");
--          }
--        }
--        // Update all list items containing private objects.
--        var elts = document.getElementsByTagName("ul");
--        for(var i=0; i<elts.length; i++) {
--          if (elts[i].className == "private") {
--            elts[i].style.display = ((cmd && cmd.substr(0,4)=="hide")?"none":"block");
--          }
--        }
--        // Set a cookie to remember the current option.
--        document.cookie = "EpydocPrivate="+cmd;
--      }
--function getCookie(name) {
--        var dc = document.cookie;
--        var prefix = name + "=";
--        var begin = dc.indexOf("; " + prefix);
--        if (begin == -1) {
--          begin = dc.indexOf(prefix);
--          if (begin != 0) return null;
--        } else
--        { begin += 2; }
--        var end = document.cookie.indexOf(";", begin);
--        if (end == -1)
--        { end = dc.length; }
--        return unescape(dc.substring(begin + prefix.length, end));
--      }
--function setFrame(url1, url2) {
--          parent.frames[1].location.href = url1;
--          parent.frames[2].location.href = url2;
--      }
--function checkCookie() {
--        var cmd=getCookie("EpydocPrivate");
--        if (cmd && cmd.substr(0,4)!="show" && location.href.indexOf("#_") < 0)
--            toggle_private();
--      }
--function toggleCallGraph(id) {
--        var elt = document.getElementById(id);
--        if (elt.style.display == "none")
--            elt.style.display = "block";
--        else
--            elt.style.display = "none";
--      }
--function expand(id) {
--  var elt = document.getElementById(id+"-expanded");
--  if (elt) elt.style.display = "block";
--  var elt = document.getElementById(id+"-expanded-linenums");
--  if (elt) elt.style.display = "block";
--  var elt = document.getElementById(id+"-collapsed");
--  if (elt) { elt.innerHTML = ""; elt.style.display = "none"; }
--  var elt = document.getElementById(id+"-collapsed-linenums");
--  if (elt) { elt.innerHTML = ""; elt.style.display = "none"; }
--  var elt = document.getElementById(id+"-toggle");
--  if (elt) { elt.innerHTML = "-"; }
--}
--
--function collapse(id) {
--  var elt = document.getElementById(id+"-expanded");
--  if (elt) elt.style.display = "none";
--  var elt = document.getElementById(id+"-expanded-linenums");
--  if (elt) elt.style.display = "none";
--  var elt = document.getElementById(id+"-collapsed-linenums");
--  if (elt) { elt.innerHTML = "<br/>"; elt.style.display="block"; }
--  var elt = document.getElementById(id+"-toggle");
--  if (elt) { elt.innerHTML = "+"; }
--  var elt = document.getElementById(id+"-collapsed");
--  if (elt) {
--    elt.style.display = "block";
--
--    var indent = elt.getAttribute("indent");
--    var pad = elt.getAttribute("pad");
--    var s = "<tt class='py-lineno'>";
--    for (var i=0; i<pad.length; i++) { s += "&nbsp;" }
--    s += "</tt>";
--    s += "&nbsp;&nbsp;<tt class='py-line'>";
--    for (var i=0; i<indent.length; i++) { s += "&nbsp;" }
--    s += "<a href='#' onclick='expand(\"" + id;
--    s += "\");return false'>...</a></tt><br />";
--    elt.innerHTML = s;
--  }
--}
--
--function toggle(id) {
--  elt = document.getElementById(id+"-toggle");
--  if (elt.innerHTML == "-")
--      collapse(id);
--  else
--      expand(id);
--  return false;
--}
--
--function highlight(id) {
--  var elt = document.getElementById(id+"-def");
--  if (elt) elt.className = "py-highlight-hdr";
--  var elt = document.getElementById(id+"-expanded");
--  if (elt) elt.className = "py-highlight";
--  var elt = document.getElementById(id+"-collapsed");
--  if (elt) elt.className = "py-highlight";
--}
--
--function num_lines(s) {
--  var n = 1;
--  var pos = s.indexOf("\n");
--  while ( pos > 0) {
--    n += 1;
--    pos = s.indexOf("\n", pos+1);
--  }
--  return n;
--}
--
--// Collapse all blocks that mave more than `min_lines` lines.
--function collapse_all(min_lines) {
--  var elts = document.getElementsByTagName("div");
--  for (var i=0; i<elts.length; i++) {
--    var elt = elts[i];
--    var split = elt.id.indexOf("-");
--    if (split > 0)
--      if (elt.id.substring(split, elt.id.length) == "-expanded")
--        if (num_lines(elt.innerHTML) > min_lines)
--          collapse(elt.id.substring(0, split));
--  }
--}
--
--function expandto(href) {
--  var start = href.indexOf("#")+1;
--  if (start != 0 && start != href.length) {
--    if (href.substring(start, href.length) != "-") {
--      collapse_all(4);
--      pos = href.indexOf(".", start);
--      while (pos != -1) {
--        var id = href.substring(start, pos);
--        expand(id);
--        pos = href.indexOf(".", pos+1);
--      }
--      var id = href.substring(start, href.length);
--      expand(id);
--      highlight(id);
--    }
--  }
--}
--
--function kill_doclink(id) {
--  var parent = document.getElementById(id);
--  parent.removeChild(parent.childNodes.item(0));
--}
--function auto_kill_doclink(ev) {
--  if (!ev) var ev = window.event;
--  if (!this.contains(ev.toElement)) {
--    var parent = document.getElementById(this.parentID);
--    parent.removeChild(parent.childNodes.item(0));
--  }
--}
--
--function doclink(id, name, targets_id) {
--  var elt = document.getElementById(id);
--
--  // If we already opened the box, then destroy it.
--  // (This case should never occur, but leave it in just in case.)
--  if (elt.childNodes.length > 1) {
--    elt.removeChild(elt.childNodes.item(0));
--  }
--  else {
--    // The outer box: relative + inline positioning.
--    var box1 = document.createElement("div");
--    box1.style.position = "relative";
--    box1.style.display = "inline";
--    box1.style.top = 0;
--    box1.style.left = 0;
--
--    // A shadow for fun
--    var shadow = document.createElement("div");
--    shadow.style.position = "absolute";
--    shadow.style.left = "-1.3em";
--    shadow.style.top = "-1.3em";
--    shadow.style.background = "#404040";
--
--    // The inner box: absolute positioning.
--    var box2 = document.createElement("div");
--    box2.style.position = "relative";
--    box2.style.border = "1px solid #a0a0a0";
--    box2.style.left = "-.2em";
--    box2.style.top = "-.2em";
--    box2.style.background = "white";
--    box2.style.padding = ".3em .4em .3em .4em";
--    box2.style.fontStyle = "normal";
--    box2.onmouseout=auto_kill_doclink;
--    box2.parentID = id;
--
--    // Get the targets
--    var targets_elt = document.getElementById(targets_id);
--    var targets = targets_elt.getAttribute("targets");
--    var links = "";
--    target_list = targets.split(",");
--    for (var i=0; i<target_list.length; i++) {
--        var target = target_list[i].split("=");
--        links += "<li><a href='" + target[1] +
--               "' style='text-decoration:none'>" +
--               target[0] + "</a></li>";
--    }
--
--    // Put it all together.
--    elt.insertBefore(box1, elt.childNodes.item(0));
--    //box1.appendChild(box2);
--    box1.appendChild(shadow);
--    shadow.appendChild(box2);
--    box2.innerHTML =
--        "Which <b>"+name+"</b> do you want to see documentation for?" +
--        "<ul style='margin-bottom: 0;'>" +
--        links +
--        "<li><a href='#' style='text-decoration:none' " +
--        "onclick='kill_doclink(\""+id+"\");return false;'>"+
--        "<i>None of the above</i></a></li></ul>";
--  }
--  return false;
--}
--
--function get_anchor() {
--          var href = location.href;
--          var start = href.indexOf("#")+1;
--          if ((start != 0) && (start != href.length))
--              return href.substring(start, href.length);
--      }
--function redirect_url(dottedName) {
--          // Scan through each element of the "pages" list, and check
--          // if "name" matches with any of them.
--          for (var i=0; i<pages.length; i++) {
--
--              // Each page has the form "<pagename>-m" or "<pagename>-c";
--              // extract the <pagename> portion & compare it to dottedName.
--              var pagename = pages[i].substring(0, pages[i].length-2);
--              if (pagename == dottedName.substring(0,pagename.length)) {
--
--                  // We've found a page that matches `dottedName`;
--                  // construct its URL, using leftover `dottedName`
--                  // content to form an anchor.
--                  var pagetype = pages[i].charAt(pages[i].length-1);
--                  var url = pagename + ((pagetype=="m")?"-module.html":
--                                                        "-class.html");
--                  if (dottedName.length > pagename.length)
--                      url += "#" + dottedName.substring(pagename.length+1,
--                                                        dottedName.length);
--                  return url;
--              }
--          }
--      }
 === added file 'doc/html/frames.html'
 --- doc/html/frames.html	1970-01-01 00:00:00 +0000
 +++ doc/html/frames.html	2009-12-26 22:06:14 +0000
@@ -0,0 +1,17 @@
++<?xml version="1.0" encoding="iso-8859-1"?>
++<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN"
++          "DTD/xhtml1-frameset.dtd">
++<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
++<head>
++  <title> API Documentation </title>
++</head>
++<frameset cols="20%,80%">
++  <frameset rows="30%,70%">
++    <frame src="toc.html" name="moduleListFrame"
++           id="moduleListFrame" />
++    <frame src="toc-everything.html" name="moduleFrame"
++           id="moduleFrame" />
++  </frameset>
++  <frame src="scriptutil-module.html" name="mainFrame" id="mainFrame" />
++</frameset>
++</html>
 === removed file 'doc/html/frames.html'
 --- doc/html/frames.html	2009-12-26 20:49:38 +0000
 +++ doc/html/frames.html	1970-01-01 00:00:00 +0000
@@ -1,17 +0,0 @@
--<?xml version="1.0" encoding="iso-8859-1"?>
--<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN"
--          "DTD/xhtml1-frameset.dtd">
--<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
--<head>
--  <title> Module scriptutil </title>
--</head>
--<frameset cols="20%,80%">
--  <frameset rows="30%,70%">
--    <frame src="toc.html" name="moduleListFrame"
--           id="moduleListFrame" />
--    <frame src="toc-everything.html" name="moduleFrame"
--           id="moduleFrame" />
--  </frameset>
--  <frame src="scriptutil-module.html" name="mainFrame" id="mainFrame" />
--</frameset>
--</html>
 === added file 'doc/html/help.html'
 --- doc/html/help.html	1970-01-01 00:00:00 +0000
 +++ doc/html/help.html	2009-12-26 22:06:14 +0000
@@ -0,0 +1,278 @@
++<?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>Help</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">
++  <!-- Home link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Tree link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Index link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Help link -->
++      <th bgcolor="#70b0f0" class="navbar-select"
++          >&nbsp;&nbsp;&nbsp;Help&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Project homepage -->
++      <th class="navbar" align="right" width="100%">
++        <table border="0" cellpadding="0" cellspacing="0">
++          <tr><th class="navbar" align="center"
++            ><a class="navbar" target="_top" href="https://launchpad.net/py-script">Project Homepage</a></th>
++          </tr></table></th>
++  </tr>
++</table>
++<table width="100%" cellpadding="0" cellspacing="0">
++  <tr valign="top">
++    <td width="100%">&nbsp;</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&nbsp;private</a>]</span></td></tr>
++        <tr><td align="right"><span class="options"
++            >[<a href="frames.html" target="_top">frames</a
++            >]&nbsp;|&nbsp;<a href="help.html"
++            target="_top">no&nbsp;frames</a>]</span></td></tr>
++      </table>
++    </td>
++  </tr>
++</table>
++
++<h1 class="epydoc"> API Documentation </h1>
++
++<p> This document contains the API (Application Programming Interface)
++documentation for this project.  Documentation for the Python
++objects defined by the project is divided into separate pages for each
++package, module, and class.  The API documentation also includes two
++pages containing information about the project as a whole: a trees
++page, and an index page.  </p>
++
++<h2> Object Documentation </h2>
++
++  <p>Each <strong>Package Documentation</strong> page contains: </p>
++  <ul>
++    <li> A description of the package. </li>
++    <li> A list of the modules and sub-packages contained by the
++    package.  </li>
++    <li> A summary of the classes defined by the package. </li>
++    <li> A summary of the functions defined by the package. </li>
++    <li> A summary of the variables defined by the package. </li>
++    <li> A detailed description of each function defined by the
++    package. </li>
++    <li> A detailed description of each variable defined by the
++    package. </li>
++  </ul>
++
++  <p>Each <strong>Module Documentation</strong> page contains:</p>
++  <ul>
++    <li> A description of the module. </li>
++    <li> A summary of the classes defined by the module. </li>
++    <li> A summary of the functions defined by the module. </li>
++    <li> A summary of the variables defined by the module. </li>
++    <li> A detailed description of each function defined by the
++    module. </li>
++    <li> A detailed description of each variable defined by the
++    module. </li>
++  </ul>
++
++  <p>Each <strong>Class Documentation</strong> page contains: </p>
++  <ul>
++    <li> A class inheritance diagram. </li>
++    <li> A list of known subclasses. </li>
++    <li> A description of the class. </li>
++    <li> A summary of the methods defined by the class. </li>
++    <li> A summary of the instance variables defined by the class. </li>
++    <li> A summary of the class (static) variables defined by the
++    class. </li>
++    <li> A detailed description of each method defined by the
++    class. </li>
++    <li> A detailed description of each instance variable defined by the
++    class. </li>
++    <li> A detailed description of each class (static) variable defined
++    by the class. </li>
++  </ul>
++
++<h2> Project Documentation </h2>
++
++  <p> The <strong>Trees</strong> page contains the module and class hierarchies: </p>
++  <ul>
++    <li> The <em>module hierarchy</em> lists every package and module, with
++    modules grouped into packages.  At the top level, and within each
++    package, modules and sub-packages are listed alphabetically. </li>
++    <li> The <em>class hierarchy</em> lists every class, grouped by base
++    class.  If a class has more than one base class, then it will be
++    listed under each base class.  At the top level, and under each base
++    class, classes are listed alphabetically. </li>
++  </ul>
++
++  <p> The <strong>Index</strong> page contains indices of terms and
++  identifiers: </p>
++  <ul>
++    <li> The <em>term index</em> lists every term indexed by any object's
++    documentation.  For each term, the index provides links to each
++    place where the term is indexed. </li>
++    <li> The <em>identifier index</em> lists the (short) name of every package,
++    module, class, method, function, variable, and parameter.  For each
++    identifier, the index provides a short description, and a link to
++    its documentation. </li>
++  </ul>
++
++<h2> The Table of Contents </h2>
++
++<p> The table of contents occupies the two frames on the left side of
++the window.  The upper-left frame displays the <em>project
++contents</em>, and the lower-left frame displays the <em>module
++contents</em>: </p>
++
++<table class="help summary" border="1" cellspacing="0" cellpadding="3">
++  <tr style="height: 30%">
++    <td align="center" style="font-size: small">
++       Project<br />Contents<hr />...</td>
++    <td align="center" style="font-size: small" rowspan="2" width="70%">
++      API<br />Documentation<br />Frame<br /><br /><br />
++    </td>
++  </tr>
++  <tr>
++    <td align="center" style="font-size: small">
++      Module<br />Contents<hr />&nbsp;<br />...<br />&nbsp;
++    </td>
++  </tr>
++</table><br />
++
++<p> The <strong>project contents frame</strong> contains a list of all packages
++and modules that are defined by the project.  Clicking on an entry
++will display its contents in the module contents frame.  Clicking on a
++special entry, labeled "Everything," will display the contents of
++the entire project. </p>
++
++<p> The <strong>module contents frame</strong> contains a list of every
++submodule, class, type, exception, function, and variable defined by a
++module or package.  Clicking on an entry will display its
++documentation in the API documentation frame.  Clicking on the name of
++the module, at the top of the frame, will display the documentation
++for the module itself. </p>
++
++<p> The "<strong>frames</strong>" and "<strong>no frames</strong>" buttons below the top
++navigation bar can be used to control whether the table of contents is
++displayed or not. </p>
++
++<h2> The Navigation Bar </h2>
++
++<p> A navigation bar is located at the top and bottom of every page.
++It indicates what type of page you are currently viewing, and allows
++you to go to related pages.  The following table describes the labels
++on the navigation bar.  Note that not some labels (such as
++[Parent]) are not displayed on all pages. </p>
++
++<table class="summary" border="1" cellspacing="0" cellpadding="3" width="100%">
++<tr class="summary">
++  <th>Label</th>
++  <th>Highlighted when...</th>
++  <th>Links to...</th>
++</tr>
++  <tr><td valign="top"><strong>[Parent]</strong></td>
++      <td valign="top"><em>(never highlighted)</em></td>
++      <td valign="top"> the parent of the current package </td></tr>
++  <tr><td valign="top"><strong>[Package]</strong></td>
++      <td valign="top">viewing a package</td>
++      <td valign="top">the package containing the current object
++      </td></tr>
++  <tr><td valign="top"><strong>[Module]</strong></td>
++      <td valign="top">viewing a module</td>
++      <td valign="top">the module containing the current object
++      </td></tr>
++  <tr><td valign="top"><strong>[Class]</strong></td>
++      <td valign="top">viewing a class </td>
++      <td valign="top">the class containing the current object</td></tr>
++  <tr><td valign="top"><strong>[Trees]</strong></td>
++      <td valign="top">viewing the trees page</td>
++      <td valign="top"> the trees page </td></tr>
++  <tr><td valign="top"><strong>[Index]</strong></td>
++      <td valign="top">viewing the index page</td>
++      <td valign="top"> the index page </td></tr>
++  <tr><td valign="top"><strong>[Help]</strong></td>
++      <td valign="top">viewing the help page</td>
++      <td valign="top"> the help page </td></tr>
++</table>
++
++<p> The "<strong>show private</strong>" and "<strong>hide private</strong>" buttons below
++the top navigation bar can be used to control whether documentation
++for private objects is displayed.  Private objects are usually defined
++as objects whose (short) names begin with a single underscore, but do
++not end with an underscore.  For example, "<code>_x</code>",
++"<code>__pprint</code>", and "<code>epydoc.epytext._tokenize</code>"
++are private objects; but "<code>re.sub</code>",
++"<code>__init__</code>", and "<code>type_</code>" are not.  However,
++if a module defines the "<code>__all__</code>" variable, then its
++contents are used to decide which objects are private. </p>
++
++<p> A timestamp below the bottom navigation bar indicates when each
++page was last updated. </p>
++<!-- ==================== NAVIGATION BAR ==================== -->
++<table class="navbar" border="0" width="100%" cellpadding="0"
++       bgcolor="#a0c0ff" cellspacing="0">
++  <tr valign="middle">
++  <!-- Home link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Tree link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Index link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Help link -->
++      <th bgcolor="#70b0f0" class="navbar-select"
++          >&nbsp;&nbsp;&nbsp;Help&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Project homepage -->
++      <th class="navbar" align="right" width="100%">
++        <table border="0" cellpadding="0" cellspacing="0">
++          <tr><th class="navbar" align="center"
++            ><a class="navbar" target="_top" href="https://launchpad.net/py-script">Project Homepage</a></th>
++          </tr></table></th>
++  </tr>
++</table>
++<table border="0" cellpadding="0" cellspacing="0" width="100%%">
++  <tr>
++    <td align="left" class="footer">
++    Generated by Epydoc 3.0.1 on Sat Dec 26 23:01:34 2009
++    </td>
++    <td align="right" class="footer">
++      <a target="mainFrame" 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>
 === removed file 'doc/html/help.html'
 --- doc/html/help.html	2009-12-26 20:49:38 +0000
 +++ doc/html/help.html	1970-01-01 00:00:00 +0000
@@ -1,278 +0,0 @@
--<?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>Help</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">
--  <!-- Home link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Tree link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Index link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Help link -->
--      <th bgcolor="#70b0f0" class="navbar-select"
--          >&nbsp;&nbsp;&nbsp;Help&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Project homepage -->
--      <th class="navbar" align="right" width="100%">
--        <table border="0" cellpadding="0" cellspacing="0">
--          <tr><th class="navbar" align="center"
--            ><a class="navbar" target="_top" href="http://hrnjad.net/src/scriptutil">Module scriptutil</a></th>
--          </tr></table></th>
--  </tr>
--</table>
--<table width="100%" cellpadding="0" cellspacing="0">
--  <tr valign="top">
--    <td width="100%">&nbsp;</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&nbsp;private</a>]</span></td></tr>
--        <tr><td align="right"><span class="options"
--            >[<a href="frames.html" target="_top">frames</a
--            >]&nbsp;|&nbsp;<a href="help.html"
--            target="_top">no&nbsp;frames</a>]</span></td></tr>
--      </table>
--    </td>
--  </tr>
--</table>
--
--<h1 class="epydoc"> API Documentation </h1>
--
--<p> This document contains the API (Application Programming Interface)
--documentation for Module scriptutil.  Documentation for the Python
--objects defined by the project is divided into separate pages for each
--package, module, and class.  The API documentation also includes two
--pages containing information about the project as a whole: a trees
--page, and an index page.  </p>
--
--<h2> Object Documentation </h2>
--
--  <p>Each <strong>Package Documentation</strong> page contains: </p>
--  <ul>
--    <li> A description of the package. </li>
--    <li> A list of the modules and sub-packages contained by the
--    package.  </li>
--    <li> A summary of the classes defined by the package. </li>
--    <li> A summary of the functions defined by the package. </li>
--    <li> A summary of the variables defined by the package. </li>
--    <li> A detailed description of each function defined by the
--    package. </li>
--    <li> A detailed description of each variable defined by the
--    package. </li>
--  </ul>
--
--  <p>Each <strong>Module Documentation</strong> page contains:</p>
--  <ul>
--    <li> A description of the module. </li>
--    <li> A summary of the classes defined by the module. </li>
--    <li> A summary of the functions defined by the module. </li>
--    <li> A summary of the variables defined by the module. </li>
--    <li> A detailed description of each function defined by the
--    module. </li>
--    <li> A detailed description of each variable defined by the
--    module. </li>
--  </ul>
--
--  <p>Each <strong>Class Documentation</strong> page contains: </p>
--  <ul>
--    <li> A class inheritance diagram. </li>
--    <li> A list of known subclasses. </li>
--    <li> A description of the class. </li>
--    <li> A summary of the methods defined by the class. </li>
--    <li> A summary of the instance variables defined by the class. </li>
--    <li> A summary of the class (static) variables defined by the
--    class. </li>
--    <li> A detailed description of each method defined by the
--    class. </li>
--    <li> A detailed description of each instance variable defined by the
--    class. </li>
--    <li> A detailed description of each class (static) variable defined
--    by the class. </li>
--  </ul>
--
--<h2> Project Documentation </h2>
--
--  <p> The <strong>Trees</strong> page contains the module and class hierarchies: </p>
--  <ul>
--    <li> The <em>module hierarchy</em> lists every package and module, with
--    modules grouped into packages.  At the top level, and within each
--    package, modules and sub-packages are listed alphabetically. </li>
--    <li> The <em>class hierarchy</em> lists every class, grouped by base
--    class.  If a class has more than one base class, then it will be
--    listed under each base class.  At the top level, and under each base
--    class, classes are listed alphabetically. </li>
--  </ul>
--
--  <p> The <strong>Index</strong> page contains indices of terms and
--  identifiers: </p>
--  <ul>
--    <li> The <em>term index</em> lists every term indexed by any object's
--    documentation.  For each term, the index provides links to each
--    place where the term is indexed. </li>
--    <li> The <em>identifier index</em> lists the (short) name of every package,
--    module, class, method, function, variable, and parameter.  For each
--    identifier, the index provides a short description, and a link to
--    its documentation. </li>
--  </ul>
--
--<h2> The Table of Contents </h2>
--
--<p> The table of contents occupies the two frames on the left side of
--the window.  The upper-left frame displays the <em>project
--contents</em>, and the lower-left frame displays the <em>module
--contents</em>: </p>
--
--<table class="help summary" border="1" cellspacing="0" cellpadding="3">
--  <tr style="height: 30%">
--    <td align="center" style="font-size: small">
--       Project<br />Contents<hr />...</td>
--    <td align="center" style="font-size: small" rowspan="2" width="70%">
--      API<br />Documentation<br />Frame<br /><br /><br />
--    </td>
--  </tr>
--  <tr>
--    <td align="center" style="font-size: small">
--      Module<br />Contents<hr />&nbsp;<br />...<br />&nbsp;
--    </td>
--  </tr>
--</table><br />
--
--<p> The <strong>project contents frame</strong> contains a list of all packages
--and modules that are defined by the project.  Clicking on an entry
--will display its contents in the module contents frame.  Clicking on a
--special entry, labeled "Everything," will display the contents of
--the entire project. </p>
--
--<p> The <strong>module contents frame</strong> contains a list of every
--submodule, class, type, exception, function, and variable defined by a
--module or package.  Clicking on an entry will display its
--documentation in the API documentation frame.  Clicking on the name of
--the module, at the top of the frame, will display the documentation
--for the module itself. </p>
--
--<p> The "<strong>frames</strong>" and "<strong>no frames</strong>" buttons below the top
--navigation bar can be used to control whether the table of contents is
--displayed or not. </p>
--
--<h2> The Navigation Bar </h2>
--
--<p> A navigation bar is located at the top and bottom of every page.
--It indicates what type of page you are currently viewing, and allows
--you to go to related pages.  The following table describes the labels
--on the navigation bar.  Note that not some labels (such as
--[Parent]) are not displayed on all pages. </p>
--
--<table class="summary" border="1" cellspacing="0" cellpadding="3" width="100%">
--<tr class="summary">
--  <th>Label</th>
--  <th>Highlighted when...</th>
--  <th>Links to...</th>
--</tr>
--  <tr><td valign="top"><strong>[Parent]</strong></td>
--      <td valign="top"><em>(never highlighted)</em></td>
--      <td valign="top"> the parent of the current package </td></tr>
--  <tr><td valign="top"><strong>[Package]</strong></td>
--      <td valign="top">viewing a package</td>
--      <td valign="top">the package containing the current object
--      </td></tr>
--  <tr><td valign="top"><strong>[Module]</strong></td>
--      <td valign="top">viewing a module</td>
--      <td valign="top">the module containing the current object
--      </td></tr>
--  <tr><td valign="top"><strong>[Class]</strong></td>
--      <td valign="top">viewing a class </td>
--      <td valign="top">the class containing the current object</td></tr>
--  <tr><td valign="top"><strong>[Trees]</strong></td>
--      <td valign="top">viewing the trees page</td>
--      <td valign="top"> the trees page </td></tr>
--  <tr><td valign="top"><strong>[Index]</strong></td>
--      <td valign="top">viewing the index page</td>
--      <td valign="top"> the index page </td></tr>
--  <tr><td valign="top"><strong>[Help]</strong></td>
--      <td valign="top">viewing the help page</td>
--      <td valign="top"> the help page </td></tr>
--</table>
--
--<p> The "<strong>show private</strong>" and "<strong>hide private</strong>" buttons below
--the top navigation bar can be used to control whether documentation
--for private objects is displayed.  Private objects are usually defined
--as objects whose (short) names begin with a single underscore, but do
--not end with an underscore.  For example, "<code>_x</code>",
--"<code>__pprint</code>", and "<code>epydoc.epytext._tokenize</code>"
--are private objects; but "<code>re.sub</code>",
--"<code>__init__</code>", and "<code>type_</code>" are not.  However,
--if a module defines the "<code>__all__</code>" variable, then its
--contents are used to decide which objects are private. </p>
--
--<p> A timestamp below the bottom navigation bar indicates when each
--page was last updated. </p>
--<!-- ==================== NAVIGATION BAR ==================== -->
--<table class="navbar" border="0" width="100%" cellpadding="0"
--       bgcolor="#a0c0ff" cellspacing="0">
--  <tr valign="middle">
--  <!-- Home link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Tree link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Index link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Help link -->
--      <th bgcolor="#70b0f0" class="navbar-select"
--          >&nbsp;&nbsp;&nbsp;Help&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Project homepage -->
--      <th class="navbar" align="right" width="100%">
--        <table border="0" cellpadding="0" cellspacing="0">
--          <tr><th class="navbar" align="center"
--            ><a class="navbar" target="_top" href="http://hrnjad.net/src/scriptutil">Module scriptutil</a></th>
--          </tr></table></th>
--  </tr>
--</table>
--<table border="0" cellpadding="0" cellspacing="0" width="100%%">
--  <tr>
--    <td align="left" class="footer">
--    Generated by Epydoc 3.0beta1 on Thu May 22 18:10:51 2008
--    </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>
 === added file 'doc/html/identifier-index.html'
 --- doc/html/identifier-index.html	1970-01-01 00:00:00 +0000
 +++ doc/html/identifier-index.html	2009-12-26 22:06:14 +0000
@@ -0,0 +1,217 @@
++<?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>Identifier Index</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">
++  <!-- Home link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Tree link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Index link -->
++      <th bgcolor="#70b0f0" class="navbar-select"
++          >&nbsp;&nbsp;&nbsp;Indices&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Help link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Project homepage -->
++      <th class="navbar" align="right" width="100%">
++        <table border="0" cellpadding="0" cellspacing="0">
++          <tr><th class="navbar" align="center"
++            ><a class="navbar" target="_top" href="https://launchpad.net/py-script">Project Homepage</a></th>
++          </tr></table></th>
++  </tr>
++</table>
++<table width="100%" cellpadding="0" cellspacing="0">
++  <tr valign="top">
++    <td width="100%">&nbsp;</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&nbsp;private</a>]</span></td></tr>
++        <tr><td align="right"><span class="options"
++            >[<a href="frames.html" target="_top">frames</a
++            >]&nbsp;|&nbsp;<a href="identifier-index.html"
++            target="_top">no&nbsp;frames</a>]</span></td></tr>
++      </table>
++    </td>
++  </tr>
++</table>
++<table border="0" width="100%">
++<tr valign="bottom"><td>
++<h1 class="epydoc">Identifier Index</h1>
++</td><td>
++[
++  A
++  B
++  C
++  D
++  E
++ <a href="#F">F</a>
++ <a href="#G">G</a>
++  H
++  I
++  J
++  K
++  L
++  M
++  N
++  O
++ <a href="#P">P</a>
++  Q
++ <a href="#R">R</a>
++ <a href="#S">S</a>
++  T
++  U
++  V
++  W
++  X
++  Y
++  Z
++ <a href="#_">_</a>
++]
++</td></table>
++<table border="0" width="100%">
++<tr valign="top"><td valign="top" width="1%"><h2 class="epydoc"><a name="F">F</a></h2></td>
++<td valign="top">
++<table class="link-index" width="100%" border="1">
++<tr>
++<td width="33%" class="link-index"><a href="scriptutil.find-module.html">find</a><br />
++<span class="index-where">(in&nbsp;<a href="scriptutil-module.html">scriptutil</a>)</span></td>
++<td width="33%" class="link-index"><a href="scriptutil.find-module.html#find">find()</a><br />
++<span class="index-where">(in&nbsp;<a href="scriptutil.find-module.html">scriptutil.find</a>)</span></td>
++<td width="33%" class="link-index">&nbsp;</td>
++</tr>
++<tr><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td></tr>
++</table>
++</td></tr>
++<tr valign="top"><td valign="top" width="1%"><h2 class="epydoc"><a name="G">G</a></h2></td>
++<td valign="top">
++<table class="link-index" width="100%" border="1">
++<tr>
++<td width="33%" class="link-index"><a href="scriptutil.find-module.html#grep">grep()</a><br />
++<span class="index-where">(in&nbsp;<a href="scriptutil.find-module.html">scriptutil.find</a>)</span></td>
++<td width="33%" class="link-index">&nbsp;</td>
++<td width="33%" class="link-index">&nbsp;</td>
++</tr>
++<tr><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td></tr>
++</table>
++</td></tr>
++<tr valign="top"><td valign="top" width="1%"><h2 class="epydoc"><a name="P">P</a></h2></td>
++<td valign="top">
++<table class="link-index" width="100%" border="1">
++<tr>
++<td width="33%" class="link-index"><a href="scriptutil.find-module.html#pprint">pprint()</a><br />
++<span class="index-where">(in&nbsp;<a href="scriptutil.find-module.html">scriptutil.find</a>)</span></td>
++<td width="33%" class="link-index">&nbsp;</td>
++<td width="33%" class="link-index">&nbsp;</td>
++</tr>
++<tr><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td></tr>
++</table>
++</td></tr>
++<tr valign="top"><td valign="top" width="1%"><h2 class="epydoc"><a name="R">R</a></h2></td>
++<td valign="top">
++<table class="link-index" width="100%" border="1">
++<tr>
++<td width="33%" class="link-index"><a href="scriptutil.find-module.html#replace">replace()</a><br />
++<span class="index-where">(in&nbsp;<a href="scriptutil.find-module.html">scriptutil.find</a>)</span></td>
++<td width="33%" class="link-index">&nbsp;</td>
++<td width="33%" class="link-index">&nbsp;</td>
++</tr>
++<tr><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td></tr>
++</table>
++</td></tr>
++<tr valign="top"><td valign="top" width="1%"><h2 class="epydoc"><a name="S">S</a></h2></td>
++<td valign="top">
++<table class="link-index" width="100%" border="1">
++<tr>
++<td width="33%" class="link-index"><a href="scriptutil.find.ScriptError-class.html">ScriptError</a><br />
++<span class="index-where">(in&nbsp;<a href="scriptutil.find-module.html">scriptutil.find</a>)</span></td>
++<td width="33%" class="link-index"><a href="scriptutil-module.html">scriptutil</a></td>
++<td width="33%" class="link-index">&nbsp;</td>
++</tr>
++<tr><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td></tr>
++</table>
++</td></tr>
++<tr valign="top"><td valign="top" width="1%"><h2 class="epydoc"><a name="_">_</a></h2></td>
++<td valign="top">
++<table class="link-index" width="100%" border="1">
++<tr>
++<td width="33%" class="link-index"><a href="scriptutil-module.html#__package__">__package__</a><br />
++<span class="index-where">(in&nbsp;<a href="scriptutil-module.html">scriptutil</a>)</span></td>
++<td width="33%" class="link-index"><a href="scriptutil.find-module.html#__package__">__package__</a><br />
++<span class="index-where">(in&nbsp;<a href="scriptutil.find-module.html">scriptutil.find</a>)</span></td>
++<td width="33%" class="link-index">&nbsp;</td>
++</tr>
++<tr><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td></tr>
++</table>
++</td></tr>
++</table>
++<br /><br /><!-- ==================== NAVIGATION BAR ==================== -->
++<table class="navbar" border="0" width="100%" cellpadding="0"
++       bgcolor="#a0c0ff" cellspacing="0">
++  <tr valign="middle">
++  <!-- Home link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Tree link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Index link -->
++      <th bgcolor="#70b0f0" class="navbar-select"
++          >&nbsp;&nbsp;&nbsp;Indices&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Help link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Project homepage -->
++      <th class="navbar" align="right" width="100%">
++        <table border="0" cellpadding="0" cellspacing="0">
++          <tr><th class="navbar" align="center"
++            ><a class="navbar" target="_top" href="https://launchpad.net/py-script">Project Homepage</a></th>
++          </tr></table></th>
++  </tr>
++</table>
++<table border="0" cellpadding="0" cellspacing="0" width="100%%">
++  <tr>
++    <td align="left" class="footer">
++    Generated by Epydoc 3.0.1 on Sat Dec 26 23:01:34 2009
++    </td>
++    <td align="right" class="footer">
++      <a target="mainFrame" 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>
 === removed file 'doc/html/identifier-index.html'
 --- doc/html/identifier-index.html	2009-12-26 20:49:38 +0000
 +++ doc/html/identifier-index.html	1970-01-01 00:00:00 +0000
@@ -1,181 +0,0 @@
--<?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>Identifier Index</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">
--  <!-- Home link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Tree link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Index link -->
--      <th bgcolor="#70b0f0" class="navbar-select"
--          >&nbsp;&nbsp;&nbsp;Indices&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Help link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Project homepage -->
--      <th class="navbar" align="right" width="100%">
--        <table border="0" cellpadding="0" cellspacing="0">
--          <tr><th class="navbar" align="center"
--            ><a class="navbar" target="_top" href="http://hrnjad.net/src/scriptutil">Module scriptutil</a></th>
--          </tr></table></th>
--  </tr>
--</table>
--<table width="100%" cellpadding="0" cellspacing="0">
--  <tr valign="top">
--    <td width="100%">&nbsp;</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&nbsp;private</a>]</span></td></tr>
--        <tr><td align="right"><span class="options"
--            >[<a href="frames.html" target="_top">frames</a
--            >]&nbsp;|&nbsp;<a href="identifier-index.html"
--            target="_top">no&nbsp;frames</a>]</span></td></tr>
--      </table>
--    </td>
--  </tr>
--</table>
--<table border="0" width="100%">
--<tr valign="bottom"><td>
--<h1 class="epydoc">Identifier Index</h1>
--</td><td>
--[
--  A
--  B
--  C
--  D
--  E
-- <a href="#F">F</a>
--  G
--  H
--  I
--  J
--  K
--  L
--  M
--  N
--  O
-- <a href="#P">P</a>
--  Q
--  R
-- <a href="#S">S</a>
--  T
--  U
--  V
--  W
--  X
--  Y
--  Z
--  _
--]
--</td></table>
--<table border="0" width="100%"><tr valign="top">
--<td valign="top" width="1%"><a name="F"><h2 class="epydoc">F</h2></a></td>
--<td valign="top">
--<table class="link-index" width="100%" border="1">
--<tr>
--<td width="33%" class="link-index"><a href="scriptutil-module.html#ffind">ffind()</a><br />
--<span class="index-where">(in&nbsp;<a href="scriptutil-module.html">scriptutil</a>)</font></td>
--<td width="33%" class="link-index"><a href="scriptutil-module.html#ffindgrep">ffindgrep()</a><br />
--<span class="index-where">(in&nbsp;<a href="scriptutil-module.html">scriptutil</a>)</font></td>
--<td width="33%" class="link-index"><a href="scriptutil-module.html#freplace">freplace()</a><br />
--<span class="index-where">(in&nbsp;<a href="scriptutil-module.html">scriptutil</a>)</font></td>
--</tr>
--<tr><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td></tr>
--</table>
--</td></tr>
--<td valign="top" width="1%"><a name="P"><h2 class="epydoc">P</h2></a></td>
--<td valign="top">
--<table class="link-index" width="100%" border="1">
--<tr>
--<td width="33%" class="link-index"><a href="scriptutil-module.html#printr">printr()</a><br />
--<span class="index-where">(in&nbsp;<a href="scriptutil-module.html">scriptutil</a>)</font></td>
--<td width="33%" class="link-index">&nbsp;</td>
--<td width="33%" class="link-index">&nbsp;</td>
--</tr>
--<tr><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td></tr>
--</table>
--</td></tr>
--<td valign="top" width="1%"><a name="S"><h2 class="epydoc">S</h2></a></td>
--<td valign="top">
--<table class="link-index" width="100%" border="1">
--<tr>
--<td width="33%" class="link-index"><a href="scriptutil.ScriptError-class.html">ScriptError</a><br />
--<span class="index-where">(in&nbsp;<a href="scriptutil-module.html">scriptutil</a>)</font></td>
--<td width="33%" class="link-index"><a href="scriptutil-module.html">scriptutil</a></td>
--<td width="33%" class="link-index">&nbsp;</td>
--</tr>
--<tr><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td></tr>
--</table>
--</td></tr>
--</table>
--</br /><br /><!-- ==================== NAVIGATION BAR ==================== -->
--<table class="navbar" border="0" width="100%" cellpadding="0"
--       bgcolor="#a0c0ff" cellspacing="0">
--  <tr valign="middle">
--  <!-- Home link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Tree link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Index link -->
--      <th bgcolor="#70b0f0" class="navbar-select"
--          >&nbsp;&nbsp;&nbsp;Indices&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Help link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Project homepage -->
--      <th class="navbar" align="right" width="100%">
--        <table border="0" cellpadding="0" cellspacing="0">
--          <tr><th class="navbar" align="center"
--            ><a class="navbar" target="_top" href="http://hrnjad.net/src/scriptutil">Module scriptutil</a></th>
--          </tr></table></th>
--  </tr>
--</table>
--<table border="0" cellpadding="0" cellspacing="0" width="100%%">
--  <tr>
--    <td align="left" class="footer">
--    Generated by Epydoc 3.0beta1 on Thu May 22 18:10:51 2008
--    </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>
 === added file 'doc/html/index.html'
 --- doc/html/index.html	1970-01-01 00:00:00 +0000
 +++ doc/html/index.html	2009-12-26 22:06:14 +0000
@@ -0,0 +1,17 @@
++<?xml version="1.0" encoding="iso-8859-1"?>
++<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN"
++          "DTD/xhtml1-frameset.dtd">
++<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
++<head>
++  <title> API Documentation </title>
++</head>
++<frameset cols="20%,80%">
++  <frameset rows="30%,70%">
++    <frame src="toc.html" name="moduleListFrame"
++           id="moduleListFrame" />
++    <frame src="toc-everything.html" name="moduleFrame"
++           id="moduleFrame" />
++  </frameset>
++  <frame src="scriptutil-module.html" name="mainFrame" id="mainFrame" />
++</frameset>
++</html>
 === removed file 'doc/html/index.html'
 --- doc/html/index.html	2009-12-26 20:49:38 +0000
 +++ doc/html/index.html	1970-01-01 00:00:00 +0000
@@ -1,17 +0,0 @@
--<?xml version="1.0" encoding="iso-8859-1"?>
--<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN"
--          "DTD/xhtml1-frameset.dtd">
--<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
--<head>
--  <title> Module scriptutil </title>
--</head>
--<frameset cols="20%,80%">
--  <frameset rows="30%,70%">
--    <frame src="toc.html" name="moduleListFrame"
--           id="moduleListFrame" />
--    <frame src="toc-everything.html" name="moduleFrame"
--           id="moduleFrame" />
--  </frameset>
--  <frame src="scriptutil-module.html" name="mainFrame" id="mainFrame" />
--</frameset>
--</html>
 === added file 'doc/html/module-tree.html'
 --- doc/html/module-tree.html	1970-01-01 00:00:00 +0000
 +++ doc/html/module-tree.html	2009-12-26 22:06:14 +0000
@@ -0,0 +1,119 @@
++<?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>Module Hierarchy</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">
++  <!-- Home link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Tree link -->
++      <th bgcolor="#70b0f0" class="navbar-select"
++          >&nbsp;&nbsp;&nbsp;Trees&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Index link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Help link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Project homepage -->
++      <th class="navbar" align="right" width="100%">
++        <table border="0" cellpadding="0" cellspacing="0">
++          <tr><th class="navbar" align="center"
++            ><a class="navbar" target="_top" href="https://launchpad.net/py-script">Project Homepage</a></th>
++          </tr></table></th>
++  </tr>
++</table>
++<table width="100%" cellpadding="0" cellspacing="0">
++  <tr valign="top">
++    <td width="100%">&nbsp;</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&nbsp;private</a>]</span></td></tr>
++        <tr><td align="right"><span class="options"
++            >[<a href="frames.html" target="_top">frames</a
++            >]&nbsp;|&nbsp;<a href="module-tree.html"
++            target="_top">no&nbsp;frames</a>]</span></td></tr>
++      </table>
++    </td>
++  </tr>
++</table>
++<center><b>
++ [ <a href="module-tree.html">Module Hierarchy</a>
++ | <a href="class-tree.html">Class Hierarchy</a> ]
++</b></center><br />
++<h1 class="epydoc">Module Hierarchy</h1>
++<ul class="nomargin-top">
++    <li> <strong class="uidlink"><a href="scriptutil-module.html">scriptutil</a></strong>
++    <ul>
++    <li> <strong class="uidlink"><a href="scriptutil.find-module.html">scriptutil.find</a></strong>: <em class="summary">Functions commonly used in shell scripting:</em>    </li>
++    </ul>
++    </li>
++</ul>
++<!-- ==================== NAVIGATION BAR ==================== -->
++<table class="navbar" border="0" width="100%" cellpadding="0"
++       bgcolor="#a0c0ff" cellspacing="0">
++  <tr valign="middle">
++  <!-- Home link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Tree link -->
++      <th bgcolor="#70b0f0" class="navbar-select"
++          >&nbsp;&nbsp;&nbsp;Trees&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Index link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Help link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Project homepage -->
++      <th class="navbar" align="right" width="100%">
++        <table border="0" cellpadding="0" cellspacing="0">
++          <tr><th class="navbar" align="center"
++            ><a class="navbar" target="_top" href="https://launchpad.net/py-script">Project Homepage</a></th>
++          </tr></table></th>
++  </tr>
++</table>
++<table border="0" cellpadding="0" cellspacing="0" width="100%%">
++  <tr>
++    <td align="left" class="footer">
++    Generated by Epydoc 3.0.1 on Sat Dec 26 23:01:34 2009
++    </td>
++    <td align="right" class="footer">
++      <a target="mainFrame" 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>
 === removed file 'doc/html/module-tree.html'
 --- doc/html/module-tree.html	2009-12-26 20:49:38 +0000
 +++ doc/html/module-tree.html	1970-01-01 00:00:00 +0000
@@ -1,115 +0,0 @@
--<?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>Module Hierarchy</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">
--  <!-- Home link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Tree link -->
--      <th bgcolor="#70b0f0" class="navbar-select"
--          >&nbsp;&nbsp;&nbsp;Trees&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Index link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Help link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Project homepage -->
--      <th class="navbar" align="right" width="100%">
--        <table border="0" cellpadding="0" cellspacing="0">
--          <tr><th class="navbar" align="center"
--            ><a class="navbar" target="_top" href="http://hrnjad.net/src/scriptutil">Module scriptutil</a></th>
--          </tr></table></th>
--  </tr>
--</table>
--<table width="100%" cellpadding="0" cellspacing="0">
--  <tr valign="top">
--    <td width="100%">&nbsp;</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&nbsp;private</a>]</span></td></tr>
--        <tr><td align="right"><span class="options"
--            >[<a href="frames.html" target="_top">frames</a
--            >]&nbsp;|&nbsp;<a href="module-tree.html"
--            target="_top">no&nbsp;frames</a>]</span></td></tr>
--      </table>
--    </td>
--  </tr>
--</table>
--<center><b>
-- [ <a href="module-tree.html">Module Hierarchy</a>
-- | <a href="class-tree.html">Class Hierarchy</a> ]
--</b></center><br />
--<h1 class="epydoc">Module Hierarchy</h1>
--<ul class="nomargin-top">
--    <li> <strong class="uidlink"><a href="scriptutil-module.html">scriptutil</a></strong>: <em class="summary">Copyright (c) 2008, Muharem Hrnjadovic</em>    </li>
--</ul>
--<!-- ==================== NAVIGATION BAR ==================== -->
--<table class="navbar" border="0" width="100%" cellpadding="0"
--       bgcolor="#a0c0ff" cellspacing="0">
--  <tr valign="middle">
--  <!-- Home link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Tree link -->
--      <th bgcolor="#70b0f0" class="navbar-select"
--          >&nbsp;&nbsp;&nbsp;Trees&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Index link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Help link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Project homepage -->
--      <th class="navbar" align="right" width="100%">
--        <table border="0" cellpadding="0" cellspacing="0">
--          <tr><th class="navbar" align="center"
--            ><a class="navbar" target="_top" href="http://hrnjad.net/src/scriptutil">Module scriptutil</a></th>
--          </tr></table></th>
--  </tr>
--</table>
--<table border="0" cellpadding="0" cellspacing="0" width="100%%">
--  <tr>
--    <td align="left" class="footer">
--    Generated by Epydoc 3.0beta1 on Thu May 22 18:10:51 2008
--    </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>
 === added file 'doc/html/redirect.html'
 --- doc/html/redirect.html	1970-01-01 00:00:00 +0000
 +++ doc/html/redirect.html	2009-12-26 22:06:14 +0000
@@ -0,0 +1,38 @@
++<html><head><title>Epydoc Redirect Page</title>
++<meta http-equiv="cache-control" content="no-cache" />
++<meta http-equiv="expires" content="0" />
++<meta http-equiv="pragma" content="no-cache" />
++  <script type="text/javascript" src="epydoc.js"></script>
++</head>
++<body>
++<script type="text/javascript">
++<!--
++var pages = ["scriptutil.find.ScriptError-c", "scriptutil.find-m", "scriptutil-m"];
++var dottedName = get_anchor();
++if (dottedName) {
++    var target = redirect_url(dottedName);
++    if (target) window.location.replace(target);
++}
++// -->
++</script>
++
++<h3>Epydoc Auto-redirect page</h3>
++
++<p>When javascript is enabled, this page will redirect URLs of
++the form <tt>redirect.html#<i>dotted.name</i></tt> to the
++documentation for the object with the given fully-qualified
++dotted name.</p>
++<p><a id="message"> &nbsp; </a></p>
++
++<script type="text/javascript">
++<!--
++if (dottedName) {
++    var msg = document.getElementById("message");
++    msg.innerHTML = "No documentation found for <tt>"+
++                    dottedName+"</tt>";
++}
++// -->
++</script>
++
++</body>
++</html>
 === removed file 'doc/html/redirect.html'
 --- doc/html/redirect.html	2009-12-26 20:49:38 +0000
 +++ doc/html/redirect.html	1970-01-01 00:00:00 +0000
@@ -1,38 +0,0 @@
--<html><head><title>Epydoc Redirect Page</title>
--<meta http-equiv="cache-control" content="no-cache" />
--<meta http-equiv="expires" content="0" />
--<meta http-equiv="pragma" content="no-cache" />
--  <script type="text/javascript" src="epydoc.js"></script>
--</head>
--<body>
--<script type="text/javascript">
--<!--
--var pages = ["scriptutil.ScriptError-c", "scriptutil-m"];
--var dottedName = get_anchor();
--if (dottedName) {
--    var target = redirect_url(dottedName);
--    if (target) window.location.replace(target);
--}
--// -->
--</script>
--
--<h3>Epydoc Auto-redirect page</h3>
--
--<p>When javascript is enabled, this page will redirect URLs of
--the form <tt>redirect.html#<i>dotted.name</i></tt> to the
--documentation for the object with the given fully-qualified
--dotted name.</p>
--<p><a id="message"> &nbsp; </a></p>
--
--<script type="text/javascript">
--<!--
--if (dottedName) {
--    var msg = document.getElementById("message");
--    msg.innerHTML = "No documentation found for <tt>"+
--                    dottedName+"</tt>";
--}
--// -->
--</script>
--
--</body>
--</html>
 === added file 'doc/html/scriptutil-module.html'
 --- doc/html/scriptutil-module.html	1970-01-01 00:00:00 +0000
 +++ doc/html/scriptutil-module.html	2009-12-26 22:06:14 +0000
@@ -0,0 +1,162 @@
++<?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>scriptutil</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">
++  <!-- Home link -->
++      <th bgcolor="#70b0f0" class="navbar-select"
++          >&nbsp;&nbsp;&nbsp;Home&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Tree link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Index link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Help link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Project homepage -->
++      <th class="navbar" align="right" width="100%">
++        <table border="0" cellpadding="0" cellspacing="0">
++          <tr><th class="navbar" align="center"
++            ><a class="navbar" target="_top" href="https://launchpad.net/py-script">Project Homepage</a></th>
++          </tr></table></th>
++  </tr>
++</table>
++<table width="100%" cellpadding="0" cellspacing="0">
++  <tr valign="top">
++    <td width="100%">
++      <span class="breadcrumbs">
++        Package&nbsp;scriptutil
++      </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&nbsp;private</a>]</span></td></tr>
++        <tr><td align="right"><span class="options"
++            >[<a href="frames.html" target="_top">frames</a
++            >]&nbsp;|&nbsp;<a href="scriptutil-module.html"
++            target="_top">no&nbsp;frames</a>]</span></td></tr>
++      </table>
++    </td>
++  </tr>
++</table>
++<!-- ==================== PACKAGE DESCRIPTION ==================== -->
++<h1 class="epydoc">Package scriptutil</h1><p class="nomargin-top"><span class="codelink"><a href="scriptutil-pysrc.html">source&nbsp;code</a></span></p>
++<!-- ==================== SUBMODULES ==================== -->
++<a name="section-Submodules"></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">Submodules</span></td>
++        <td align="right" valign="top"
++         ><span class="options">[<a href="#section-Submodules"
++         class="privatelink" onclick="toggle_private();"
++         >hide private</a>]</span></td>
++      </tr>
++    </table>
++  </td>
++</tr>
++  <tr><td class="summary">
++  <ul class="nomargin">
++    <li> <strong class="uidlink"><a href="scriptutil.find-module.html">scriptutil.find</a></strong>: <em class="summary">Functions commonly used in shell scripting:</em>    </li>
++  </ul></td></tr>
++</table>
++
++<br />
++<!-- ==================== VARIABLES ==================== -->
++<a name="section-Variables"></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">Variables</span></td>
++        <td align="right" valign="top"
++         ><span class="options">[<a href="#section-Variables"
++         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">&nbsp;</span>
++    </td><td class="summary">
++        <a name="__package__"></a><span class="summary-name">__package__</span> = <code title="None">None</code>
++    </td>
++  </tr>
++</table>
++<!-- ==================== NAVIGATION BAR ==================== -->
++<table class="navbar" border="0" width="100%" cellpadding="0"
++       bgcolor="#a0c0ff" cellspacing="0">
++  <tr valign="middle">
++  <!-- Home link -->
++      <th bgcolor="#70b0f0" class="navbar-select"
++          >&nbsp;&nbsp;&nbsp;Home&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Tree link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Index link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Help link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Project homepage -->
++      <th class="navbar" align="right" width="100%">
++        <table border="0" cellpadding="0" cellspacing="0">
++          <tr><th class="navbar" align="center"
++            ><a class="navbar" target="_top" href="https://launchpad.net/py-script">Project Homepage</a></th>
++          </tr></table></th>
++  </tr>
++</table>
++<table border="0" cellpadding="0" cellspacing="0" width="100%%">
++  <tr>
++    <td align="left" class="footer">
++    Generated by Epydoc 3.0.1 on Sat Dec 26 23:01:34 2009
++    </td>
++    <td align="right" class="footer">
++      <a target="mainFrame" 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>
 === removed file 'doc/html/scriptutil-module.html'
 --- doc/html/scriptutil-module.html	2009-12-26 20:49:38 +0000
 +++ doc/html/scriptutil-module.html	1970-01-01 00:00:00 +0000
@@ -1,509 +0,0 @@
--<?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>scriptutil</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">
--  <!-- Home link -->
--      <th bgcolor="#70b0f0" class="navbar-select"
--          >&nbsp;&nbsp;&nbsp;Home&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Tree link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Index link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Help link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Project homepage -->
--      <th class="navbar" align="right" width="100%">
--        <table border="0" cellpadding="0" cellspacing="0">
--          <tr><th class="navbar" align="center"
--            ><a class="navbar" target="_top" href="http://hrnjad.net/src/scriptutil">Module scriptutil</a></th>
--          </tr></table></th>
--  </tr>
--</table>
--<table width="100%" cellpadding="0" cellspacing="0">
--  <tr valign="top">
--    <td width="100%">
--      <span class="breadcrumbs">
--        Script&nbsp;scriptutil
--      </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&nbsp;private</a>]</span></td></tr>
--        <tr><td align="right"><span class="options"
--            >[<a href="frames.html" target="_top">frames</a
--            >]&nbsp;|&nbsp;<a href="scriptutil-module.html"
--            target="_top">no&nbsp;frames</a>]</span></td></tr>
--      </table>
--    </td>
--  </tr>
--</table>
--<!-- ==================== MODULE DESCRIPTION ==================== -->
--<h1 class="epydoc">Module scriptutil</h1><span class="codelink"><a href="scriptutil-pysrc.html">source&nbsp;code</a></span><br /><br />
--<p>Copyright (c) 2008, Muharem Hrnjadovic</p>
--  <p>All rights reserved.</p>
--  Redistribution and use in source and binary forms, with or without
--  modification, are permitted provided that the following conditions are
--  met:
--  <ul>
--    <li>
--      Redistributions of source code must retain the above copyright
--      notice, this list of conditions and the following disclaimer.
--    </li>
--    <li>
--      Redistributions in binary form must reproduce the above copyright
--      notice, this list of conditions and the following disclaimer in the
--      documentation and/or other materials provided with the
--      distribution.
--    </li>
--    <li>
--      Neither the name of Muharem Hrnjadovic nor the names of other
--      contributors may be used to endorse or promote products derived from
--      this software without specific prior written permission.
--    </li>
--  </ul>
--  <p>THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
--  &quot;AS IS&quot; AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT
--  NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
--  A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
--  OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
--  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
--  TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
--  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
--  LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
--  NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
--  SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</p>
--
--  <p>---------------------------------------------------------------------------</p>
--  Module providing functions commonly used in shell scripting:
--  <ul>
--    <li>
--      ffind()    : finds files in a directory tree
--    </li>
--    <li>
--      ffindgrep(): finds files in a directory tree and matches their
--      content to regular expressions
--    </li>
--    <li>
--      freplace() : in-place search/replace of files in a directory tree
--      with regular expressions
--    </li>
--    <li>
--      printr()   : prints the results of the ffind()/ffindgrep()
--      functions
--    </li>
--  </ul>
--  Please see the <a
--  href="http://muharem.wordpress.com/2007/05/20/python-find-files-using-unix-shell-style-wildcards/"
--  target="_top">tutorial</a> as well as the documentation strings of the
--  particular functions for detailed information.<br /><br />
--
--<hr />
--<div class="fields">      <p><strong>Version:</strong>
--        1.1
--      </p>
--</div><!-- ==================== CLASSES ==================== -->
--<a name="section-Classes"></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">Classes</span></td>
--        <td align="right" valign="top"
--         ><span class="options">[<a href="#section-Classes"
--         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">&nbsp;</span>
--    </td><td class="summary">
--        <a href="scriptutil.ScriptError-class.html" class="summary-name">ScriptError</a><br />
--      The exception raised in case of failures.
--    </td>
--  </tr>
--</table>
--<!-- ==================== FUNCTIONS ==================== -->
--<a name="section-Functions"></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">Functions</span></td>
--        <td align="right" valign="top"
--         ><span class="options">[<a href="#section-Functions"
--         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">sequence</span>
--    </td><td class="summary">
--      <table width="100%" cellpadding="0" cellspacing="0" border="0">
--        <tr>
--          <td><span class="summary-sig"><a href="scriptutil-module.html#ffind" class="summary-sig-name">ffind</a>(<span class="summary-sig-arg">path</span>,
--        <span class="summary-sig-arg">shellglobs</span>=<span class="summary-sig-default">None</span>,
--        <span class="summary-sig-arg">namefs</span>=<span class="summary-sig-default">None</span>,
--        <span class="summary-sig-arg">relative</span>=<span class="summary-sig-default">True</span>)</span><br />
--      Find files in the directory tree starting at 'path' (filtered by
--      Unix shell-style wildcards ('shellglobs') and/or the functions in the
--      'namefs' sequence).</td>
--          <td align="right" valign="top">
--            <span class="codelink"><a href="scriptutil-pysrc.html#ffind">source&nbsp;code</a></span>
--
--          </td>
--        </tr>
--      </table>
--
--    </td>
--  </tr>
--<tr>
--    <td width="15%" align="right" valign="top" class="summary">
--      <span class="summary-type">dict</span>
--    </td><td class="summary">
--      <table width="100%" cellpadding="0" cellspacing="0" border="0">
--        <tr>
--          <td><span class="summary-sig"><a href="scriptutil-module.html#ffindgrep" class="summary-sig-name">ffindgrep</a>(<span class="summary-sig-arg">path</span>,
--        <span class="summary-sig-arg">regexl</span>,
--        <span class="summary-sig-arg">shellglobs</span>=<span class="summary-sig-default">None</span>,
--        <span class="summary-sig-arg">namefs</span>=<span class="summary-sig-default">None</span>,
--        <span class="summary-sig-arg">relative</span>=<span class="summary-sig-default">True</span>,
--        <span class="summary-sig-arg">linenums</span>=<span class="summary-sig-default">False</span>)</span><br />
--      Find files in the directory tree starting at 'path' (filtered by
--      Unix shell-style wildcards ('shellglobs') and/or the functions in the
--      'namefs' sequence) and search inside these.</td>
--          <td align="right" valign="top">
--            <span class="codelink"><a href="scriptutil-pysrc.html#ffindgrep">source&nbsp;code</a></span>
--
--          </td>
--        </tr>
--      </table>
--
--    </td>
--  </tr>
--<tr>
--    <td width="15%" align="right" valign="top" class="summary">
--      <span class="summary-type">number</span>
--    </td><td class="summary">
--      <table width="100%" cellpadding="0" cellspacing="0" border="0">
--        <tr>
--          <td><span class="summary-sig"><a href="scriptutil-module.html#freplace" class="summary-sig-name">freplace</a>(<span class="summary-sig-arg">path</span>,
--        <span class="summary-sig-arg">regexl</span>,
--        <span class="summary-sig-arg">shellglobs</span>=<span class="summary-sig-default">None</span>,
--        <span class="summary-sig-arg">namefs</span>=<span class="summary-sig-default">None</span>,
--        <span class="summary-sig-arg">bext</span>=<span class="summary-sig-default"><code class="variable-quote">'</code><code class="variable-string">.bak</code><code class="variable-quote">'</code></span>)</span><br />
--      Find files in the directory tree starting at 'path' (filtered by
--      Unix shell-style wildcards ('shellglobs') and/or the functions in the
--      'namefs' sequence) and perform an in-place search/replace operation
--      on these.</td>
--          <td align="right" valign="top">
--            <span class="codelink"><a href="scriptutil-pysrc.html#freplace">source&nbsp;code</a></span>
--
--          </td>
--        </tr>
--      </table>
--
--    </td>
--  </tr>
--<tr>
--    <td width="15%" align="right" valign="top" class="summary">
--      <span class="summary-type">&nbsp;</span>
--    </td><td class="summary">
--      <table width="100%" cellpadding="0" cellspacing="0" border="0">
--        <tr>
--          <td><span class="summary-sig"><a href="scriptutil-module.html#printr" class="summary-sig-name">printr</a>(<span class="summary-sig-arg">results</span>)</span><br />
--      Print the results of the ffind()/ffindgrep() functions.</td>
--          <td align="right" valign="top">
--            <span class="codelink"><a href="scriptutil-pysrc.html#printr">source&nbsp;code</a></span>
--
--          </td>
--        </tr>
--      </table>
--
--    </td>
--  </tr>
--</table>
--<!-- ==================== FUNCTION DETAILS ==================== -->
--<a name="section-FunctionDetails"></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">Function Details</span></td>
--        <td align="right" valign="top"
--         ><span class="options">[<a href="#section-FunctionDetails"
--         class="privatelink" onclick="toggle_private();"
--         >hide private</a>]</span></td>
--      </tr>
--    </table>
--  </td>
--</tr>
--</table>
--<a name="ffind"></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">ffind</span>(<span class="sig-arg">path</span>,
--        <span class="sig-arg">shellglobs</span>=<span class="sig-default">None</span>,
--        <span class="sig-arg">namefs</span>=<span class="sig-default">None</span>,
--        <span class="sig-arg">relative</span>=<span class="sig-default">True</span>)</span>
--  </h3>
--  </td><td align="right" valign="top"
--    ><span class="codelink"><a href="scriptutil-pysrc.html#ffind">source&nbsp;code</a></span>&nbsp;
--    </td>
--  </table>
--
--  <p>Find files in the directory tree starting at 'path' (filtered by Unix
--  shell-style wildcards ('shellglobs') and/or the functions in the 'namefs'
--  sequence).</p>
--  <p>Please not that the shell wildcards work in a cumulative fashion i.e.
--  each of them is applied to the full set of file *names* found.</p>
--  Conversely, all the functions in 'namefs'
--  <ul>
--    <li>
--      only get to see the output of their respective predecessor
--      function in the sequence (with the obvious exception of the first
--      function)
--    </li>
--    <li>
--      are applied to the full file *path* (whereas the shell-style
--      wildcards are only applied to the file *names*)
--    </li>
--  </ul>
--  <dl class="fields">
--    <dt>Parameters:</dt>
--    <dd><ul class="nomargin-top">
--        <li><strong class="pname"><code>path</code></strong> (string) - starting path of the directory tree to be searched</li>
--        <li><strong class="pname"><code>shellglobs</code></strong> (sequence) - an optional sequence of Unix shell-style wildcards that are to
--          be applied to the file *names* found</li>
--        <li><strong class="pname"><code>namefs</code></strong> (sequence) - an optional sequence of functions to be applied to the file
--          *paths* found</li>
--        <li><strong class="pname"><code>relative</code></strong> (bool) - a boolean flag that determines whether absolute or relative
--          paths should be returned</li>
--    </ul></dd>
--    <dt>Returns: sequence</dt>
--        <dd>paths for files found</dd>
--  </dl>
--</td></tr></table>
--</div>
--<a name="ffindgrep"></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">ffindgrep</span>(<span class="sig-arg">path</span>,
--        <span class="sig-arg">regexl</span>,
--        <span class="sig-arg">shellglobs</span>=<span class="sig-default">None</span>,
--        <span class="sig-arg">namefs</span>=<span class="sig-default">None</span>,
--        <span class="sig-arg">relative</span>=<span class="sig-default">True</span>,
--        <span class="sig-arg">linenums</span>=<span class="sig-default">False</span>)</span>
--  </h3>
--  </td><td align="right" valign="top"
--    ><span class="codelink"><a href="scriptutil-pysrc.html#ffindgrep">source&nbsp;code</a></span>&nbsp;
--    </td>
--  </table>
--
--  <p>Find files in the directory tree starting at 'path' (filtered by Unix
--  shell-style wildcards ('shellglobs') and/or the functions in the 'namefs'
--  sequence) and search inside these.</p>
--  Additionaly, the file content will be filtered by the regular
--  expressions in the 'regexl' sequence. Each entry in the latter is a
--  <ul>
--    <li>
--      either a string (with the regex definition)
--    </li>
--    <li>
--      or a tuple with arguments accepted by re.compile() (the re.M and
--      re.S flags will have no effect though)
--    </li>
--  </ul>
--  For all the files that pass the file name/content tests the function
--  returns a dictionary where the
--  <ul>
--    <li>
--      key is the file name and the
--    </li>
--    <li>
--      value is a string with lines filtered by 'regexl'
--    </li>
--  </ul>
--  <dl class="fields">
--    <dt>Parameters:</dt>
--    <dd><ul class="nomargin-top">
--        <li><strong class="pname"><code>path</code></strong> (string) - starting path of the directory tree to be searched</li>
--        <li><strong class="pname"><code>shellglobs</code></strong> (sequence) - an optional sequence of Unix shell-style wildcards that are to
--          be applied to the file *names* found</li>
--        <li><strong class="pname"><code>namefs</code></strong> (sequence) - an optional sequence of functions to be applied to the file
--          *paths* found</li>
--        <li><strong class="pname"><code>relative</code></strong> (bool) - a boolean flag that determines whether absolute or relative
--          paths should be returned</li>
--        <li><strong class="pname"><code>linenums</code></strong> (bool) - turns on line numbers for found files (like grep -n)</li>
--    </ul></dd>
--    <dt>Returns: dict</dt>
--        <dd>file name (key) and lines filtered by 'regexl' (value)</dd>
--  </dl>
--</td></tr></table>
--</div>
--<a name="freplace"></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">freplace</span>(<span class="sig-arg">path</span>,
--        <span class="sig-arg">regexl</span>,
--        <span class="sig-arg">shellglobs</span>=<span class="sig-default">None</span>,
--        <span class="sig-arg">namefs</span>=<span class="sig-default">None</span>,
--        <span class="sig-arg">bext</span>=<span class="sig-default"><code class="variable-quote">'</code><code class="variable-string">.bak</code><code class="variable-quote">'</code></span>)</span>
--  </h3>
--  </td><td align="right" valign="top"
--    ><span class="codelink"><a href="scriptutil-pysrc.html#freplace">source&nbsp;code</a></span>&nbsp;
--    </td>
--  </table>
--
--  <p>Find files in the directory tree starting at 'path' (filtered by Unix
--  shell-style wildcards ('shellglobs') and/or the functions in the 'namefs'
--  sequence) and perform an in-place search/replace operation on these.</p>
--  <p>Additionally, an in-place search/replace operation is performed on the
--  content of all the files (whose names passed the tests) using the regular
--  expressions in 'regexl'.</p>
--  Please note: 'regexl' is a sequence of 3-tuples, each having the
--  following elements:
--  <ul>
--    <li>
--      search string (Python regex syntax)
--    </li>
--    <li>
--      replace string (Python regex syntax)
--    </li>
--    <li>
--      regex flags or 'None' (re.compile syntax)
--    </li>
--  </ul>
--  Copies of the modified files are saved in backup files using the
--  extension specified in 'bext'.
--  <dl class="fields">
--    <dt>Parameters:</dt>
--    <dd><ul class="nomargin-top">
--        <li><strong class="pname"><code>path</code></strong> (string) - starting path of the directory tree to be searched</li>
--        <li><strong class="pname"><code>shellglobs</code></strong> (sequence) - an optional sequence of Unix shell-style wildcards that are to
--          be applied to the file *names* found</li>
--        <li><strong class="pname"><code>namefs</code></strong> (sequence) - an optional sequence of functions to be applied to the file
--          *paths* found</li>
--    </ul></dd>
--    <dt>Returns: number</dt>
--        <dd>total number of files modified</dd>
--  </dl>
--</td></tr></table>
--</div>
--<a name="printr"></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">printr</span>(<span class="sig-arg">results</span>)</span>
--  </h3>
--  </td><td align="right" valign="top"
--    ><span class="codelink"><a href="scriptutil-pysrc.html#printr">source&nbsp;code</a></span>&nbsp;
--    </td>
--  </table>
--
--  <p>Print the results of the ffind()/ffindgrep() functions.</p>
--  The output format is similar to the one used by the UNIX find
--  utility.
--  <dl class="fields">
--  </dl>
--</td></tr></table>
--</div>
--<br />
--<!-- ==================== NAVIGATION BAR ==================== -->
--<table class="navbar" border="0" width="100%" cellpadding="0"
--       bgcolor="#a0c0ff" cellspacing="0">
--  <tr valign="middle">
--  <!-- Home link -->
--      <th bgcolor="#70b0f0" class="navbar-select"
--          >&nbsp;&nbsp;&nbsp;Home&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Tree link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Index link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Help link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Project homepage -->
--      <th class="navbar" align="right" width="100%">
--        <table border="0" cellpadding="0" cellspacing="0">
--          <tr><th class="navbar" align="center"
--            ><a class="navbar" target="_top" href="http://hrnjad.net/src/scriptutil">Module scriptutil</a></th>
--          </tr></table></th>
--  </tr>
--</table>
--<table border="0" cellpadding="0" cellspacing="0" width="100%%">
--  <tr>
--    <td align="left" class="footer">
--    Generated by Epydoc 3.0beta1 on Thu May 22 18:10:51 2008
--    </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>
 === added file 'doc/html/scriptutil-pysrc.html'
 --- doc/html/scriptutil-pysrc.html	1970-01-01 00:00:00 +0000
 +++ doc/html/scriptutil-pysrc.html	2009-12-26 22:06:14 +0000
@@ -0,0 +1,121 @@
++<?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>scriptutil</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">
++  <!-- Home link -->
++      <th bgcolor="#70b0f0" class="navbar-select"
++          >&nbsp;&nbsp;&nbsp;Home&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Tree link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Index link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Help link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Project homepage -->
++      <th class="navbar" align="right" width="100%">
++        <table border="0" cellpadding="0" cellspacing="0">
++          <tr><th class="navbar" align="center"
++            ><a class="navbar" target="_top" href="https://launchpad.net/py-script">Project Homepage</a></th>
++          </tr></table></th>
++  </tr>
++</table>
++<table width="100%" cellpadding="0" cellspacing="0">
++  <tr valign="top">
++    <td width="100%">
++      <span class="breadcrumbs">
++        Package&nbsp;scriptutil
++      </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&nbsp;private</a>]</span></td></tr>
++        <tr><td align="right"><span class="options"
++            >[<a href="frames.html" target="_top">frames</a
++            >]&nbsp;|&nbsp;<a href="scriptutil-pysrc.html"
++            target="_top">no&nbsp;frames</a>]</span></td></tr>
++      </table>
++    </td>
++  </tr>
++</table>
++<h1 class="epydoc">Source Code for <a href="scriptutil-module.html">Package scriptutil</a></h1>
++<pre class="py-src">
++<a name="L1"></a><tt class="py-lineno">1</tt>  <tt class="py-line"> </tt>
++<a name="L2"></a><tt class="py-lineno">2</tt>  <tt class="py-line"> </tt><script type="text/javascript">
++<!--
++expandto(location.href);
++// -->
++</script>
++</pre>
++<br />
++<!-- ==================== NAVIGATION BAR ==================== -->
++<table class="navbar" border="0" width="100%" cellpadding="0"
++       bgcolor="#a0c0ff" cellspacing="0">
++  <tr valign="middle">
++  <!-- Home link -->
++      <th bgcolor="#70b0f0" class="navbar-select"
++          >&nbsp;&nbsp;&nbsp;Home&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Tree link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Index link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Help link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Project homepage -->
++      <th class="navbar" align="right" width="100%">
++        <table border="0" cellpadding="0" cellspacing="0">
++          <tr><th class="navbar" align="center"
++            ><a class="navbar" target="_top" href="https://launchpad.net/py-script">Project Homepage</a></th>
++          </tr></table></th>
++  </tr>
++</table>
++<table border="0" cellpadding="0" cellspacing="0" width="100%%">
++  <tr>
++    <td align="left" class="footer">
++    Generated by Epydoc 3.0.1 on Sat Dec 26 23:01:34 2009
++    </td>
++    <td align="right" class="footer">
++      <a target="mainFrame" 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>
 === removed file 'doc/html/scriptutil-pysrc.html'
 --- doc/html/scriptutil-pysrc.html	2009-12-26 20:49:38 +0000
 +++ doc/html/scriptutil-pysrc.html	1970-01-01 00:00:00 +0000
@@ -1,388 +0,0 @@
--<?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>scriptutil</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">
--  <!-- Home link -->
--      <th bgcolor="#70b0f0" class="navbar-select"
--          >&nbsp;&nbsp;&nbsp;Home&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Tree link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Index link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Help link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Project homepage -->
--      <th class="navbar" align="right" width="100%">
--        <table border="0" cellpadding="0" cellspacing="0">
--          <tr><th class="navbar" align="center"
--            ><a class="navbar" target="_top" href="http://hrnjad.net/src/scriptutil">Module scriptutil</a></th>
--          </tr></table></th>
--  </tr>
--</table>
--<table width="100%" cellpadding="0" cellspacing="0">
--  <tr valign="top">
--    <td width="100%">
--      <span class="breadcrumbs">
--        Script&nbsp;scriptutil
--      </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&nbsp;private</a>]</span></td></tr>
--        <tr><td align="right"><span class="options"
--            >[<a href="frames.html" target="_top">frames</a
--            >]&nbsp;|&nbsp;<a href="scriptutil-pysrc.html"
--            target="_top">no&nbsp;frames</a>]</span></td></tr>
--      </table>
--    </td>
--  </tr>
--</table>
--<h1 class="epydoc">Source Code for <a href="scriptutil-module.html">Script scriptutil</a></h1>
--<pre class="py-src">
--<a name="L1"></a><tt class="py-lineno">  1</tt>  <tt class="py-line"><tt class="py-comment">#!/usr/bin/env python</tt> </tt>
--<a name="L2"></a><tt class="py-lineno">  2</tt>  <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># encoding: utf-8</tt> </tt>
--<a name="L3"></a><tt class="py-lineno">  3</tt>  <tt class="py-line"><tt class="py-comment"></tt> </tt>
--<a name="L4"></a><tt class="py-lineno">  4</tt>  <tt class="py-line"><tt class="py-docstring">"""</tt> </tt>
--<a name="L5"></a><tt class="py-lineno">  5</tt>  <tt class="py-line"><tt class="py-docstring">Copyright (c) 2008, Muharem Hrnjadovic</tt> </tt>
--<a name="L6"></a><tt class="py-lineno">  6</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
--<a name="L7"></a><tt class="py-lineno">  7</tt>  <tt class="py-line"><tt class="py-docstring">All rights reserved.</tt> </tt>
--<a name="L8"></a><tt class="py-lineno">  8</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
--<a name="L9"></a><tt class="py-lineno">  9</tt>  <tt class="py-line"><tt class="py-docstring">Redistribution and use in source and binary forms, with or without </tt> </tt>
--<a name="L10"></a><tt class="py-lineno"> 10</tt>  <tt class="py-line"><tt class="py-docstring">modification, are permitted provided that the following conditions</tt> </tt>
--<a name="L11"></a><tt class="py-lineno"> 11</tt>  <tt class="py-line"><tt class="py-docstring">are met:</tt> </tt>
--<a name="L12"></a><tt class="py-lineno"> 12</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
--<a name="L13"></a><tt class="py-lineno"> 13</tt>  <tt class="py-line"><tt class="py-docstring">    - Redistributions of source code must retain the above copyright notice,</tt> </tt>
--<a name="L14"></a><tt class="py-lineno"> 14</tt>  <tt class="py-line"><tt class="py-docstring">      this list of conditions and the following disclaimer.</tt> </tt>
--<a name="L15"></a><tt class="py-lineno"> 15</tt>  <tt class="py-line"><tt class="py-docstring">    - Redistributions in binary form must reproduce the above copyright</tt> </tt>
--<a name="L16"></a><tt class="py-lineno"> 16</tt>  <tt class="py-line"><tt class="py-docstring">      notice, this list of conditions and the following disclaimer in the</tt> </tt>
--<a name="L17"></a><tt class="py-lineno"> 17</tt>  <tt class="py-line"><tt class="py-docstring">      documentation and/or other materials provided with the distribution.</tt> </tt>
--<a name="L18"></a><tt class="py-lineno"> 18</tt>  <tt class="py-line"><tt class="py-docstring">    - Neither the name of Muharem Hrnjadovic nor the names of other</tt> </tt>
--<a name="L19"></a><tt class="py-lineno"> 19</tt>  <tt class="py-line"><tt class="py-docstring">      contributors may be used to endorse or promote products derived from</tt> </tt>
--<a name="L20"></a><tt class="py-lineno"> 20</tt>  <tt class="py-line"><tt class="py-docstring">      this software without specific prior written permission.</tt> </tt>
--<a name="L21"></a><tt class="py-lineno"> 21</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
--<a name="L22"></a><tt class="py-lineno"> 22</tt>  <tt class="py-line"><tt class="py-docstring">THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS</tt> </tt>
--<a name="L23"></a><tt class="py-lineno"> 23</tt>  <tt class="py-line"><tt class="py-docstring">"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT</tt> </tt>
--<a name="L24"></a><tt class="py-lineno"> 24</tt>  <tt class="py-line"><tt class="py-docstring">LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR</tt> </tt>
--<a name="L25"></a><tt class="py-lineno"> 25</tt>  <tt class="py-line"><tt class="py-docstring">A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR</tt> </tt>
--<a name="L26"></a><tt class="py-lineno"> 26</tt>  <tt class="py-line"><tt class="py-docstring">CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,</tt> </tt>
--<a name="L27"></a><tt class="py-lineno"> 27</tt>  <tt class="py-line"><tt class="py-docstring">EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,</tt> </tt>
--<a name="L28"></a><tt class="py-lineno"> 28</tt>  <tt class="py-line"><tt class="py-docstring">PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR</tt> </tt>
--<a name="L29"></a><tt class="py-lineno"> 29</tt>  <tt class="py-line"><tt class="py-docstring">PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF</tt> </tt>
--<a name="L30"></a><tt class="py-lineno"> 30</tt>  <tt class="py-line"><tt class="py-docstring">LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING</tt> </tt>
--<a name="L31"></a><tt class="py-lineno"> 31</tt>  <tt class="py-line"><tt class="py-docstring">NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS</tt> </tt>
--<a name="L32"></a><tt class="py-lineno"> 32</tt>  <tt class="py-line"><tt class="py-docstring">SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</tt> </tt>
--<a name="L33"></a><tt class="py-lineno"> 33</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
--<a name="L34"></a><tt class="py-lineno"> 34</tt>  <tt class="py-line"><tt class="py-docstring">---------------------------------------------------------------------------</tt> </tt>
--<a name="L35"></a><tt class="py-lineno"> 35</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
--<a name="L36"></a><tt class="py-lineno"> 36</tt>  <tt class="py-line"><tt class="py-docstring">Module providing functions commonly used in shell scripting:</tt> </tt>
--<a name="L37"></a><tt class="py-lineno"> 37</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
--<a name="L38"></a><tt class="py-lineno"> 38</tt>  <tt class="py-line"><tt class="py-docstring">  - ffind()    : finds files in a directory tree</tt> </tt>
--<a name="L39"></a><tt class="py-lineno"> 39</tt>  <tt class="py-line"><tt class="py-docstring">  - ffindgrep(): finds files in a directory tree and matches their</tt> </tt>
--<a name="L40"></a><tt class="py-lineno"> 40</tt>  <tt class="py-line"><tt class="py-docstring">                 content to regular expressions</tt> </tt>
--<a name="L41"></a><tt class="py-lineno"> 41</tt>  <tt class="py-line"><tt class="py-docstring">  - freplace() : in-place search/replace of files in a directory tree</tt> </tt>
--<a name="L42"></a><tt class="py-lineno"> 42</tt>  <tt class="py-line"><tt class="py-docstring">                 with regular expressions</tt> </tt>
--<a name="L43"></a><tt class="py-lineno"> 43</tt>  <tt class="py-line"><tt class="py-docstring">  - printr()   : prints the results of the ffind()/ffindgrep() functions</tt> </tt>
--<a name="L44"></a><tt class="py-lineno"> 44</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
--<a name="L45"></a><tt class="py-lineno"> 45</tt>  <tt class="py-line"><tt class="py-docstring">Please see the U{tutorial &lt;http://muharem.wordpress.com/2007/05/20/python-find-files-using-unix-shell-style-wildcards/&gt;} as well as the documentation strings of the particular functions for detailed information.</tt> </tt>
--<a name="L46"></a><tt class="py-lineno"> 46</tt>  <tt class="py-line"><tt class="py-docstring">"""</tt> </tt>
--<a name="L47"></a><tt class="py-lineno"> 47</tt>  <tt class="py-line"> </tt>
--<a name="L48"></a><tt class="py-lineno"> 48</tt>  <tt class="py-line"><tt class="py-name">__version__</tt> <tt class="py-op">=</tt> <tt class="py-string">"1.1"</tt> </tt>
--<a name="L49"></a><tt class="py-lineno"> 49</tt>  <tt class="py-line"> </tt>
--<a name="L50"></a><tt class="py-lineno"> 50</tt>  <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">fnmatch</tt><tt class="py-op">,</tt> <tt class="py-name">itertools</tt><tt class="py-op">,</tt> <tt class="py-name">os</tt><tt class="py-op">,</tt> <tt class="py-name">sys</tt><tt class="py-op">,</tt> <tt class="py-name">re</tt><tt class="py-op">,</tt> <tt class="py-name">types</tt> </tt>
--<a name="L51"></a><tt class="py-lineno"> 51</tt>  <tt class="py-line"> </tt>
--<a name="ScriptError"></a><div id="ScriptError-def"><a name="L52"></a><tt class="py-lineno"> 52</tt> <a class="py-toggle" href="#" id="ScriptError-toggle" onclick="return toggle('ScriptError');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="scriptutil.ScriptError-class.html">ScriptError</a><tt class="py-op">(</tt><tt class="py-base-class">Exception</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
--</div><div id="ScriptError-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="ScriptError-expanded"><a name="L53"></a><tt class="py-lineno"> 53</tt>  <tt class="py-line">    <tt class="py-docstring">"""The exception raised in case of failures."""</tt> </tt>
--</div><a name="L54"></a><tt class="py-lineno"> 54</tt>  <tt class="py-line"> </tt>
--<a name="ffind"></a><div id="ffind-def"><a name="L55"></a><tt class="py-lineno"> 55</tt> <a class="py-toggle" href="#" id="ffind-toggle" onclick="return toggle('ffind');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="scriptutil-module.html#ffind">ffind</a><tt class="py-op">(</tt><tt class="py-param">path</tt><tt class="py-op">,</tt> <tt class="py-param">shellglobs</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">namefs</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">relative</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
--</div><div id="ffind-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="ffind-expanded"><a name="L56"></a><tt class="py-lineno"> 56</tt>  <tt class="py-line">    <tt class="py-docstring">"""</tt> </tt>
--<a name="L57"></a><tt class="py-lineno"> 57</tt>  <tt class="py-line"><tt class="py-docstring">    Find files in the directory tree starting at 'path' (filtered by</tt> </tt>
--<a name="L58"></a><tt class="py-lineno"> 58</tt>  <tt class="py-line"><tt class="py-docstring">    Unix shell-style wildcards ('shellglobs') and/or the functions in</tt> </tt>
--<a name="L59"></a><tt class="py-lineno"> 59</tt>  <tt class="py-line"><tt class="py-docstring">    the 'namefs' sequence).</tt> </tt>
--<a name="L60"></a><tt class="py-lineno"> 60</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
--<a name="L61"></a><tt class="py-lineno"> 61</tt>  <tt class="py-line"><tt class="py-docstring">    Please not that the shell wildcards work in a cumulative fashion</tt> </tt>
--<a name="L62"></a><tt class="py-lineno"> 62</tt>  <tt class="py-line"><tt class="py-docstring">    i.e. each of them is applied to the full set of file *names* found.</tt> </tt>
--<a name="L63"></a><tt class="py-lineno"> 63</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
--<a name="L64"></a><tt class="py-lineno"> 64</tt>  <tt class="py-line"><tt class="py-docstring">    Conversely, all the functions in 'namefs'</tt> </tt>
--<a name="L65"></a><tt class="py-lineno"> 65</tt>  <tt class="py-line"><tt class="py-docstring">        - only get to see the output of their respective predecessor</tt> </tt>
--<a name="L66"></a><tt class="py-lineno"> 66</tt>  <tt class="py-line"><tt class="py-docstring">          function in the sequence (with the obvious exception of the</tt> </tt>
--<a name="L67"></a><tt class="py-lineno"> 67</tt>  <tt class="py-line"><tt class="py-docstring">          first function)</tt> </tt>
--<a name="L68"></a><tt class="py-lineno"> 68</tt>  <tt class="py-line"><tt class="py-docstring">        - are applied to the full file *path* (whereas the shell-style</tt> </tt>
--<a name="L69"></a><tt class="py-lineno"> 69</tt>  <tt class="py-line"><tt class="py-docstring">          wildcards are only applied to the file *names*)</tt> </tt>
--<a name="L70"></a><tt class="py-lineno"> 70</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
--<a name="L71"></a><tt class="py-lineno"> 71</tt>  <tt class="py-line"><tt class="py-docstring">    @type path: string</tt> </tt>
--<a name="L72"></a><tt class="py-lineno"> 72</tt>  <tt class="py-line"><tt class="py-docstring">    @param path: starting path of the directory tree to be searched</tt> </tt>
--<a name="L73"></a><tt class="py-lineno"> 73</tt>  <tt class="py-line"><tt class="py-docstring">    @type shellglobs: sequence</tt> </tt>
--<a name="L74"></a><tt class="py-lineno"> 74</tt>  <tt class="py-line"><tt class="py-docstring">    @param shellglobs: an optional sequence of Unix shell-style wildcards</tt> </tt>
--<a name="L75"></a><tt class="py-lineno"> 75</tt>  <tt class="py-line"><tt class="py-docstring">        that are to be applied to the file *names* found</tt> </tt>
--<a name="L76"></a><tt class="py-lineno"> 76</tt>  <tt class="py-line"><tt class="py-docstring">    @type namefs: sequence</tt> </tt>
--<a name="L77"></a><tt class="py-lineno"> 77</tt>  <tt class="py-line"><tt class="py-docstring">    @param namefs: an optional sequence of functions to be applied to the</tt> </tt>
--<a name="L78"></a><tt class="py-lineno"> 78</tt>  <tt class="py-line"><tt class="py-docstring">        file *paths* found</tt> </tt>
--<a name="L79"></a><tt class="py-lineno"> 79</tt>  <tt class="py-line"><tt class="py-docstring">    @type relative: bool</tt> </tt>
--<a name="L80"></a><tt class="py-lineno"> 80</tt>  <tt class="py-line"><tt class="py-docstring">    @param relative: a boolean flag that determines whether absolute or</tt> </tt>
--<a name="L81"></a><tt class="py-lineno"> 81</tt>  <tt class="py-line"><tt class="py-docstring">        relative paths should be returned</tt> </tt>
--<a name="L82"></a><tt class="py-lineno"> 82</tt>  <tt class="py-line"><tt class="py-docstring">    @rtype: sequence</tt> </tt>
--<a name="L83"></a><tt class="py-lineno"> 83</tt>  <tt class="py-line"><tt class="py-docstring">    @return: paths for files found</tt> </tt>
--<a name="L84"></a><tt class="py-lineno"> 84</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
--<a name="L85"></a><tt class="py-lineno"> 85</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">access</tt><tt class="py-op">(</tt><tt class="py-name">path</tt><tt class="py-op">,</tt> <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">R_OK</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
--<a name="L86"></a><tt class="py-lineno"> 86</tt>  <tt class="py-line">        <tt class="py-keyword">raise</tt> <tt id="link-0" class="py-name" targets="Class scriptutil.ScriptError=scriptutil.ScriptError-class.html"><a title="scriptutil.ScriptError" class="py-name" href="#" onclick="return doclink('link-0', 'ScriptError', 'link-0');">ScriptError</a></tt><tt class="py-op">(</tt><tt class="py-string">"cannot access path: '%s'"</tt> <tt class="py-op">%</tt> <tt class="py-name">path</tt><tt class="py-op">)</tt> </tt>
--<a name="L87"></a><tt class="py-lineno"> 87</tt>  <tt class="py-line"> </tt>
--<a name="L88"></a><tt class="py-lineno"> 88</tt>  <tt class="py-line">    <tt class="py-name">fileList</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> <tt class="py-comment"># result list</tt> </tt>
--<a name="L89"></a><tt class="py-lineno"> 89</tt>  <tt class="py-line">    <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
--<a name="L90"></a><tt class="py-lineno"> 90</tt>  <tt class="py-line">        <tt class="py-keyword">for</tt> <tt class="py-name">dir</tt><tt class="py-op">,</tt> <tt class="py-name">subdirs</tt><tt class="py-op">,</tt> <tt class="py-name">files</tt> <tt class="py-keyword">in</tt> <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">walk</tt><tt class="py-op">(</tt><tt class="py-name">path</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
--<a name="L91"></a><tt class="py-lineno"> 91</tt>  <tt class="py-line">            <tt class="py-keyword">if</tt> <tt class="py-name">shellglobs</tt><tt class="py-op">:</tt> </tt>
--<a name="L92"></a><tt class="py-lineno"> 92</tt>  <tt class="py-line">                <tt class="py-name">matched</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
--<a name="L93"></a><tt class="py-lineno"> 93</tt>  <tt class="py-line">                <tt class="py-keyword">for</tt> <tt class="py-name">pattern</tt> <tt class="py-keyword">in</tt> <tt class="py-name">shellglobs</tt><tt class="py-op">:</tt> </tt>
--<a name="L94"></a><tt class="py-lineno"> 94</tt>  <tt class="py-line">                    <tt class="py-name">filterf</tt> <tt class="py-op">=</tt> <tt class="py-keyword">lambda</tt> <tt class="py-name">s</tt><tt class="py-op">:</tt> <tt class="py-name">fnmatch</tt><tt class="py-op">.</tt><tt class="py-name">fnmatchcase</tt><tt class="py-op">(</tt><tt class="py-name">s</tt><tt class="py-op">,</tt> <tt class="py-name">pattern</tt><tt class="py-op">)</tt> </tt>
--<a name="L95"></a><tt class="py-lineno"> 95</tt>  <tt class="py-line">                    <tt class="py-name">matched</tt><tt class="py-op">.</tt><tt class="py-name">extend</tt><tt class="py-op">(</tt><tt class="py-name">filter</tt><tt class="py-op">(</tt><tt class="py-name">filterf</tt><tt class="py-op">,</tt> <tt class="py-name">files</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
--<a name="L96"></a><tt class="py-lineno"> 96</tt>  <tt class="py-line">                <tt class="py-name">fileList</tt><tt class="py-op">.</tt><tt class="py-name">extend</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'%s%s%s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">dir</tt><tt class="py-op">,</tt> <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">sep</tt><tt class="py-op">,</tt> <tt class="py-name">f</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">f</tt> <tt class="py-keyword">in</tt> <tt class="py-name">matched</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
--<a name="L97"></a><tt class="py-lineno"> 97</tt>  <tt class="py-line">            <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
--<a name="L98"></a><tt class="py-lineno"> 98</tt>  <tt class="py-line">                <tt class="py-name">fileList</tt><tt class="py-op">.</tt><tt class="py-name">extend</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'%s%s%s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">dir</tt><tt class="py-op">,</tt> <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">sep</tt><tt class="py-op">,</tt> <tt class="py-name">f</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">f</tt> <tt class="py-keyword">in</tt> <tt class="py-name">files</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
--<a name="L99"></a><tt class="py-lineno"> 99</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">relative</tt><tt class="py-op">:</tt> <tt class="py-name">fileList</tt> <tt class="py-op">=</tt> <tt class="py-name">map</tt><tt class="py-op">(</tt><tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">path</tt><tt class="py-op">.</tt><tt class="py-name">abspath</tt><tt class="py-op">,</tt> <tt class="py-name">fileList</tt><tt class="py-op">)</tt> </tt>
--<a name="L100"></a><tt class="py-lineno">100</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">namefs</tt><tt class="py-op">:</tt>  </tt>
--<a name="L101"></a><tt class="py-lineno">101</tt>  <tt class="py-line">            <tt class="py-keyword">for</tt> <tt class="py-name">ff</tt> <tt class="py-keyword">in</tt> <tt class="py-name">namefs</tt><tt class="py-op">:</tt> <tt class="py-name">fileList</tt> <tt class="py-op">=</tt> <tt class="py-name">filter</tt><tt class="py-op">(</tt><tt class="py-name">ff</tt><tt class="py-op">,</tt> <tt class="py-name">fileList</tt><tt class="py-op">)</tt> </tt>
--<a name="L102"></a><tt class="py-lineno">102</tt>  <tt class="py-line">    <tt class="py-keyword">except</tt> <tt class="py-name">Exception</tt><tt class="py-op">,</tt> <tt class="py-name">e</tt><tt class="py-op">:</tt> <tt class="py-keyword">raise</tt> <tt id="link-1" class="py-name"><a title="scriptutil.ScriptError" class="py-name" href="#" onclick="return doclink('link-1', 'ScriptError', 'link-0');">ScriptError</a></tt><tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">e</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
--<a name="L103"></a><tt class="py-lineno">103</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt><tt class="py-op">(</tt><tt class="py-name">fileList</tt><tt class="py-op">)</tt> </tt>
--</div><a name="L104"></a><tt class="py-lineno">104</tt>  <tt class="py-line"> </tt>
--<a name="ffindgrep"></a><div id="ffindgrep-def"><a name="L105"></a><tt class="py-lineno">105</tt> <a class="py-toggle" href="#" id="ffindgrep-toggle" onclick="return toggle('ffindgrep');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="scriptutil-module.html#ffindgrep">ffindgrep</a><tt class="py-op">(</tt><tt class="py-param">path</tt><tt class="py-op">,</tt> <tt class="py-param">regexl</tt><tt class="py-op">,</tt> <tt class="py-param">shellglobs</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">namefs</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt>  </tt>
--<a name="L106"></a><tt class="py-lineno">106</tt>  <tt class="py-line">              <tt class="py-param">relative</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">,</tt> <tt class="py-param">linenums</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
--</div><div id="ffindgrep-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="ffindgrep-expanded"><a name="L107"></a><tt class="py-lineno">107</tt>  <tt class="py-line">    <tt class="py-docstring">"""</tt> </tt>
--<a name="L108"></a><tt class="py-lineno">108</tt>  <tt class="py-line"><tt class="py-docstring">    Find files in the directory tree starting at 'path' (filtered by</tt> </tt>
--<a name="L109"></a><tt class="py-lineno">109</tt>  <tt class="py-line"><tt class="py-docstring">    Unix shell-style wildcards ('shellglobs') and/or the functions in</tt> </tt>
--<a name="L110"></a><tt class="py-lineno">110</tt>  <tt class="py-line"><tt class="py-docstring">    the 'namefs' sequence) and search inside these.</tt> </tt>
--<a name="L111"></a><tt class="py-lineno">111</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
--<a name="L112"></a><tt class="py-lineno">112</tt>  <tt class="py-line"><tt class="py-docstring">    Additionaly, the file content will be filtered by the regular</tt> </tt>
--<a name="L113"></a><tt class="py-lineno">113</tt>  <tt class="py-line"><tt class="py-docstring">    expressions in the 'regexl' sequence. Each entry in the latter</tt> </tt>
--<a name="L114"></a><tt class="py-lineno">114</tt>  <tt class="py-line"><tt class="py-docstring">    is a</tt> </tt>
--<a name="L115"></a><tt class="py-lineno">115</tt>  <tt class="py-line"><tt class="py-docstring">    </tt> </tt>
--<a name="L116"></a><tt class="py-lineno">116</tt>  <tt class="py-line"><tt class="py-docstring">      - either a string (with the regex definition)</tt> </tt>
--<a name="L117"></a><tt class="py-lineno">117</tt>  <tt class="py-line"><tt class="py-docstring">      - or a tuple with arguments accepted by re.compile() (the</tt> </tt>
--<a name="L118"></a><tt class="py-lineno">118</tt>  <tt class="py-line"><tt class="py-docstring">        re.M and re.S flags will have no effect though)</tt> </tt>
--<a name="L119"></a><tt class="py-lineno">119</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
--<a name="L120"></a><tt class="py-lineno">120</tt>  <tt class="py-line"><tt class="py-docstring">    For all the files that pass the file name/content tests the function</tt> </tt>
--<a name="L121"></a><tt class="py-lineno">121</tt>  <tt class="py-line"><tt class="py-docstring">    returns a dictionary where the</tt> </tt>
--<a name="L122"></a><tt class="py-lineno">122</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
--<a name="L123"></a><tt class="py-lineno">123</tt>  <tt class="py-line"><tt class="py-docstring">      - key is the file name and the</tt> </tt>
--<a name="L124"></a><tt class="py-lineno">124</tt>  <tt class="py-line"><tt class="py-docstring">      - value is a string with lines filtered by 'regexl'</tt> </tt>
--<a name="L125"></a><tt class="py-lineno">125</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
--<a name="L126"></a><tt class="py-lineno">126</tt>  <tt class="py-line"><tt class="py-docstring">    @type path: string</tt> </tt>
--<a name="L127"></a><tt class="py-lineno">127</tt>  <tt class="py-line"><tt class="py-docstring">    @param path: starting path of the directory tree to be searched</tt> </tt>
--<a name="L128"></a><tt class="py-lineno">128</tt>  <tt class="py-line"><tt class="py-docstring">    @type shellglobs: sequence</tt> </tt>
--<a name="L129"></a><tt class="py-lineno">129</tt>  <tt class="py-line"><tt class="py-docstring">    @param shellglobs: an optional sequence of Unix shell-style wildcards</tt> </tt>
--<a name="L130"></a><tt class="py-lineno">130</tt>  <tt class="py-line"><tt class="py-docstring">        that are to be applied to the file *names* found</tt> </tt>
--<a name="L131"></a><tt class="py-lineno">131</tt>  <tt class="py-line"><tt class="py-docstring">    @type namefs: sequence</tt> </tt>
--<a name="L132"></a><tt class="py-lineno">132</tt>  <tt class="py-line"><tt class="py-docstring">    @param namefs: an optional sequence of functions to be applied to the</tt> </tt>
--<a name="L133"></a><tt class="py-lineno">133</tt>  <tt class="py-line"><tt class="py-docstring">        file *paths* found</tt> </tt>
--<a name="L134"></a><tt class="py-lineno">134</tt>  <tt class="py-line"><tt class="py-docstring">    @type relative: bool</tt> </tt>
--<a name="L135"></a><tt class="py-lineno">135</tt>  <tt class="py-line"><tt class="py-docstring">    @param relative: a boolean flag that determines whether absolute or</tt> </tt>
--<a name="L136"></a><tt class="py-lineno">136</tt>  <tt class="py-line"><tt class="py-docstring">        relative paths should be returned</tt> </tt>
--<a name="L137"></a><tt class="py-lineno">137</tt>  <tt class="py-line"><tt class="py-docstring">    @type linenums: bool</tt> </tt>
--<a name="L138"></a><tt class="py-lineno">138</tt>  <tt class="py-line"><tt class="py-docstring">    @param linenums: turns on line numbers for found files (like grep -n)</tt> </tt>
--<a name="L139"></a><tt class="py-lineno">139</tt>  <tt class="py-line"><tt class="py-docstring">    @rtype: dict</tt> </tt>
--<a name="L140"></a><tt class="py-lineno">140</tt>  <tt class="py-line"><tt class="py-docstring">    @return: file name (key) and lines filtered by 'regexl' (value)</tt> </tt>
--<a name="L141"></a><tt class="py-lineno">141</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
--<a name="L142"></a><tt class="py-lineno">142</tt>  <tt class="py-line">    <tt class="py-name">fileList</tt> <tt class="py-op">=</tt> <tt id="link-2" class="py-name" targets="Function scriptutil.ffind()=scriptutil-module.html#ffind"><a title="scriptutil.ffind" class="py-name" href="#" onclick="return doclink('link-2', 'ffind', 'link-2');">ffind</a></tt><tt class="py-op">(</tt><tt class="py-name">path</tt><tt class="py-op">,</tt> <tt class="py-name">shellglobs</tt><tt class="py-op">=</tt><tt class="py-name">shellglobs</tt><tt class="py-op">,</tt>  </tt>
--<a name="L143"></a><tt class="py-lineno">143</tt>  <tt class="py-line">                     <tt class="py-name">namefs</tt><tt class="py-op">=</tt><tt class="py-name">namefs</tt><tt class="py-op">,</tt> <tt class="py-name">relative</tt><tt class="py-op">=</tt><tt class="py-name">relative</tt><tt class="py-op">)</tt> </tt>
--<a name="L144"></a><tt class="py-lineno">144</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">fileList</tt><tt class="py-op">:</tt> <tt class="py-keyword">return</tt> <tt class="py-name">dict</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
--<a name="L145"></a><tt class="py-lineno">145</tt>  <tt class="py-line"> </tt>
--<a name="L146"></a><tt class="py-lineno">146</tt>  <tt class="py-line">    <tt class="py-name">result</tt> <tt class="py-op">=</tt> <tt class="py-name">dict</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
--<a name="L147"></a><tt class="py-lineno">147</tt>  <tt class="py-line"> </tt>
--<a name="L148"></a><tt class="py-lineno">148</tt>  <tt class="py-line">    <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
--<a name="L149"></a><tt class="py-lineno">149</tt>  <tt class="py-line">        <tt class="py-comment"># first compile the regular expressions</tt> </tt>
--<a name="L150"></a><tt class="py-lineno">150</tt>  <tt class="py-line"><tt class="py-comment"></tt>        <tt class="py-name">ffuncs</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
--<a name="L151"></a><tt class="py-lineno">151</tt>  <tt class="py-line">        <tt class="py-keyword">for</tt> <tt class="py-name">redata</tt> <tt class="py-keyword">in</tt> <tt class="py-name">regexl</tt><tt class="py-op">:</tt> </tt>
--<a name="L152"></a><tt class="py-lineno">152</tt>  <tt class="py-line">            <tt class="py-keyword">if</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-name">redata</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-name">types</tt><tt class="py-op">.</tt><tt class="py-name">StringType</tt><tt class="py-op">:</tt> </tt>
--<a name="L153"></a><tt class="py-lineno">153</tt>  <tt class="py-line">                <tt class="py-name">ffuncs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt class="py-name">redata</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">search</tt><tt class="py-op">)</tt> </tt>
--<a name="L154"></a><tt class="py-lineno">154</tt>  <tt class="py-line">            <tt class="py-keyword">elif</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-name">redata</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-name">types</tt><tt class="py-op">.</tt><tt class="py-name">TupleType</tt><tt class="py-op">:</tt> </tt>
--<a name="L155"></a><tt class="py-lineno">155</tt>  <tt class="py-line">                <tt class="py-name">ffuncs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt class="py-op">*</tt><tt class="py-name">redata</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">search</tt><tt class="py-op">)</tt> </tt>
--<a name="L156"></a><tt class="py-lineno">156</tt>  <tt class="py-line">        <tt class="py-comment"># now grep in the files found</tt> </tt>
--<a name="L157"></a><tt class="py-lineno">157</tt>  <tt class="py-line"><tt class="py-comment"></tt>        <tt class="py-keyword">for</tt> <tt class="py-name">file</tt> <tt class="py-keyword">in</tt> <tt class="py-name">fileList</tt><tt class="py-op">:</tt> </tt>
--<a name="L158"></a><tt class="py-lineno">158</tt>  <tt class="py-line">            <tt class="py-comment"># read file content</tt> </tt>
--<a name="L159"></a><tt class="py-lineno">159</tt>  <tt class="py-line"><tt class="py-comment"></tt>            <tt class="py-name">fhandle</tt> <tt class="py-op">=</tt> <tt class="py-name">open</tt><tt class="py-op">(</tt><tt class="py-name">file</tt><tt class="py-op">,</tt> <tt class="py-string">'r'</tt><tt class="py-op">)</tt> </tt>
--<a name="L160"></a><tt class="py-lineno">160</tt>  <tt class="py-line">            <tt class="py-name">fcontent</tt> <tt class="py-op">=</tt> <tt class="py-name">fhandle</tt><tt class="py-op">.</tt><tt class="py-name">read</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
--<a name="L161"></a><tt class="py-lineno">161</tt>  <tt class="py-line">            <tt class="py-name">fhandle</tt><tt class="py-op">.</tt><tt class="py-name">close</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
--<a name="L162"></a><tt class="py-lineno">162</tt>  <tt class="py-line">            <tt class="py-comment"># split file content in lines</tt> </tt>
--<a name="L163"></a><tt class="py-lineno">163</tt>  <tt class="py-line"><tt class="py-comment"></tt>            <tt class="py-keyword">if</tt> <tt class="py-name">linenums</tt><tt class="py-op">:</tt> <tt class="py-name">lines</tt> <tt class="py-op">=</tt> <tt class="py-name">zip</tt><tt class="py-op">(</tt><tt class="py-name">itertools</tt><tt class="py-op">.</tt><tt class="py-name">count</tt><tt class="py-op">(</tt><tt class="py-number">1</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">fcontent</tt><tt class="py-op">.</tt><tt class="py-name">splitlines</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
--<a name="L164"></a><tt class="py-lineno">164</tt>  <tt class="py-line">            <tt class="py-keyword">else</tt><tt class="py-op">:</tt> <tt class="py-name">lines</tt> <tt class="py-op">=</tt> <tt class="py-name">fcontent</tt><tt class="py-op">.</tt><tt class="py-name">splitlines</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
--<a name="L165"></a><tt class="py-lineno">165</tt>  <tt class="py-line">            <tt class="py-keyword">for</tt> <tt class="py-name">ff</tt> <tt class="py-keyword">in</tt> <tt class="py-name">ffuncs</tt><tt class="py-op">:</tt> </tt>
--<a name="L166"></a><tt class="py-lineno">166</tt>  <tt class="py-line">                <tt class="py-keyword">if</tt> <tt class="py-name">linenums</tt><tt class="py-op">:</tt> <tt class="py-name">lines</tt> <tt class="py-op">=</tt> <tt class="py-name">filter</tt><tt class="py-op">(</tt><tt class="py-keyword">lambda</tt> <tt class="py-name">t</tt><tt class="py-op">:</tt> <tt class="py-name">ff</tt><tt class="py-op">(</tt><tt class="py-name">t</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">lines</tt><tt class="py-op">)</tt> </tt>
--<a name="L167"></a><tt class="py-lineno">167</tt>  <tt class="py-line">                <tt class="py-keyword">else</tt><tt class="py-op">:</tt> <tt class="py-name">lines</tt> <tt class="py-op">=</tt> <tt class="py-name">filter</tt><tt class="py-op">(</tt><tt class="py-name">ff</tt><tt class="py-op">,</tt> <tt class="py-name">lines</tt><tt class="py-op">)</tt> </tt>
--<a name="L168"></a><tt class="py-lineno">168</tt>  <tt class="py-line">                <tt class="py-comment"># there's no point in applying the remaining regular</tt> </tt>
--<a name="L169"></a><tt class="py-lineno">169</tt>  <tt class="py-line"><tt class="py-comment"></tt>                <tt class="py-comment"># expressions if we don't have any matching lines any more</tt> </tt>
--<a name="L170"></a><tt class="py-lineno">170</tt>  <tt class="py-line"><tt class="py-comment"></tt>                <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">lines</tt><tt class="py-op">:</tt> <tt class="py-keyword">break</tt> </tt>
--<a name="L171"></a><tt class="py-lineno">171</tt>  <tt class="py-line">            <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
--<a name="L172"></a><tt class="py-lineno">172</tt>  <tt class="py-line">                <tt class="py-comment"># the loop terminated normally; add this file to the</tt> </tt>
--<a name="L173"></a><tt class="py-lineno">173</tt>  <tt class="py-line"><tt class="py-comment"></tt>                <tt class="py-comment"># result set if there are any lines that matched</tt> </tt>
--<a name="L174"></a><tt class="py-lineno">174</tt>  <tt class="py-line"><tt class="py-comment"></tt>                <tt class="py-keyword">if</tt> <tt class="py-name">lines</tt><tt class="py-op">:</tt> </tt>
--<a name="L175"></a><tt class="py-lineno">175</tt>  <tt class="py-line">                    <tt class="py-keyword">if</tt> <tt class="py-name">linenums</tt><tt class="py-op">:</tt> </tt>
--<a name="L176"></a><tt class="py-lineno">176</tt>  <tt class="py-line">                        <tt class="py-name">result</tt><tt class="py-op">[</tt><tt class="py-name">file</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-string">'\n'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%d:%s"</tt> <tt class="py-op">%</tt> <tt class="py-name">t</tt> <tt class="py-keyword">for</tt> <tt class="py-name">t</tt> <tt class="py-keyword">in</tt> <tt class="py-name">lines</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
--<a name="L177"></a><tt class="py-lineno">177</tt>  <tt class="py-line">                    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
--<a name="L178"></a><tt class="py-lineno">178</tt>  <tt class="py-line">                        <tt class="py-name">result</tt><tt class="py-op">[</tt><tt class="py-name">file</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-string">'\n'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">map</tt><tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">lines</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
--<a name="L179"></a><tt class="py-lineno">179</tt>  <tt class="py-line">    <tt class="py-keyword">except</tt> <tt class="py-name">Exception</tt><tt class="py-op">,</tt> <tt class="py-name">e</tt><tt class="py-op">:</tt> <tt class="py-keyword">raise</tt> <tt id="link-3" class="py-name"><a title="scriptutil.ScriptError" class="py-name" href="#" onclick="return doclink('link-3', 'ScriptError', 'link-0');">ScriptError</a></tt><tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">e</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
--<a name="L180"></a><tt class="py-lineno">180</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt><tt class="py-op">(</tt><tt class="py-name">result</tt><tt class="py-op">)</tt> </tt>
--</div><a name="L181"></a><tt class="py-lineno">181</tt>  <tt class="py-line"> </tt>
--<a name="freplace"></a><div id="freplace-def"><a name="L182"></a><tt class="py-lineno">182</tt> <a class="py-toggle" href="#" id="freplace-toggle" onclick="return toggle('freplace');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="scriptutil-module.html#freplace">freplace</a><tt class="py-op">(</tt><tt class="py-param">path</tt><tt class="py-op">,</tt> <tt class="py-param">regexl</tt><tt class="py-op">,</tt> <tt class="py-param">shellglobs</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">namefs</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">bext</tt><tt class="py-op">=</tt><tt class="py-string">'.bak'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
--</div><div id="freplace-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="freplace-expanded"><a name="L183"></a><tt class="py-lineno">183</tt>  <tt class="py-line">    <tt class="py-docstring">"""</tt> </tt>
--<a name="L184"></a><tt class="py-lineno">184</tt>  <tt class="py-line"><tt class="py-docstring">    Find files in the directory tree starting at 'path' (filtered by</tt> </tt>
--<a name="L185"></a><tt class="py-lineno">185</tt>  <tt class="py-line"><tt class="py-docstring">    Unix shell-style wildcards ('shellglobs') and/or the functions in</tt> </tt>
--<a name="L186"></a><tt class="py-lineno">186</tt>  <tt class="py-line"><tt class="py-docstring">    the 'namefs' sequence) and perform an in-place search/replace</tt> </tt>
--<a name="L187"></a><tt class="py-lineno">187</tt>  <tt class="py-line"><tt class="py-docstring">    operation on these.</tt> </tt>
--<a name="L188"></a><tt class="py-lineno">188</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
--<a name="L189"></a><tt class="py-lineno">189</tt>  <tt class="py-line"><tt class="py-docstring">    Additionally, an in-place search/replace operation is performed</tt> </tt>
--<a name="L190"></a><tt class="py-lineno">190</tt>  <tt class="py-line"><tt class="py-docstring">    on the content of all the files (whose names passed the tests)</tt> </tt>
--<a name="L191"></a><tt class="py-lineno">191</tt>  <tt class="py-line"><tt class="py-docstring">    using the regular expressions in 'regexl'.</tt> </tt>
--<a name="L192"></a><tt class="py-lineno">192</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
--<a name="L193"></a><tt class="py-lineno">193</tt>  <tt class="py-line"><tt class="py-docstring">    Please note: 'regexl' is a sequence of 3-tuples, each having the</tt> </tt>
--<a name="L194"></a><tt class="py-lineno">194</tt>  <tt class="py-line"><tt class="py-docstring">    following elements:</tt> </tt>
--<a name="L195"></a><tt class="py-lineno">195</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
--<a name="L196"></a><tt class="py-lineno">196</tt>  <tt class="py-line"><tt class="py-docstring">      - search string (Python regex syntax)</tt> </tt>
--<a name="L197"></a><tt class="py-lineno">197</tt>  <tt class="py-line"><tt class="py-docstring">      - replace string (Python regex syntax)</tt> </tt>
--<a name="L198"></a><tt class="py-lineno">198</tt>  <tt class="py-line"><tt class="py-docstring">      - regex flags or 'None' (re.compile syntax)</tt> </tt>
--<a name="L199"></a><tt class="py-lineno">199</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
--<a name="L200"></a><tt class="py-lineno">200</tt>  <tt class="py-line"><tt class="py-docstring">    Copies of the modified files are saved in backup files using the</tt> </tt>
--<a name="L201"></a><tt class="py-lineno">201</tt>  <tt class="py-line"><tt class="py-docstring">    extension specified in 'bext'.</tt> </tt>
--<a name="L202"></a><tt class="py-lineno">202</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
--<a name="L203"></a><tt class="py-lineno">203</tt>  <tt class="py-line"><tt class="py-docstring">    @type path: string</tt> </tt>
--<a name="L204"></a><tt class="py-lineno">204</tt>  <tt class="py-line"><tt class="py-docstring">    @param path: starting path of the directory tree to be searched</tt> </tt>
--<a name="L205"></a><tt class="py-lineno">205</tt>  <tt class="py-line"><tt class="py-docstring">    @type shellglobs: sequence</tt> </tt>
--<a name="L206"></a><tt class="py-lineno">206</tt>  <tt class="py-line"><tt class="py-docstring">    @param shellglobs: an optional sequence of Unix shell-style wildcards</tt> </tt>
--<a name="L207"></a><tt class="py-lineno">207</tt>  <tt class="py-line"><tt class="py-docstring">        that are to be applied to the file *names* found</tt> </tt>
--<a name="L208"></a><tt class="py-lineno">208</tt>  <tt class="py-line"><tt class="py-docstring">    @type namefs: sequence</tt> </tt>
--<a name="L209"></a><tt class="py-lineno">209</tt>  <tt class="py-line"><tt class="py-docstring">    @param namefs: an optional sequence of functions to be applied to the</tt> </tt>
--<a name="L210"></a><tt class="py-lineno">210</tt>  <tt class="py-line"><tt class="py-docstring">        file *paths* found</tt> </tt>
--<a name="L211"></a><tt class="py-lineno">211</tt>  <tt class="py-line"><tt class="py-docstring">    @rtype: number</tt> </tt>
--<a name="L212"></a><tt class="py-lineno">212</tt>  <tt class="py-line"><tt class="py-docstring">    @return: total number of files modified</tt> </tt>
--<a name="L213"></a><tt class="py-lineno">213</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
--<a name="L214"></a><tt class="py-lineno">214</tt>  <tt class="py-line">    <tt class="py-name">fileList</tt> <tt class="py-op">=</tt> <tt id="link-4" class="py-name"><a title="scriptutil.ffind" class="py-name" href="#" onclick="return doclink('link-4', 'ffind', 'link-2');">ffind</a></tt><tt class="py-op">(</tt><tt class="py-name">path</tt><tt class="py-op">,</tt> <tt class="py-name">shellglobs</tt><tt class="py-op">=</tt><tt class="py-name">shellglobs</tt><tt class="py-op">,</tt> <tt class="py-name">namefs</tt><tt class="py-op">=</tt><tt class="py-name">namefs</tt><tt class="py-op">)</tt> </tt>
--<a name="L215"></a><tt class="py-lineno">215</tt>  <tt class="py-line"> </tt>
--<a name="L216"></a><tt class="py-lineno">216</tt>  <tt class="py-line">    <tt class="py-comment"># return if no files found</tt> </tt>
--<a name="L217"></a><tt class="py-lineno">217</tt>  <tt class="py-line"><tt class="py-comment"></tt>    <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">fileList</tt><tt class="py-op">:</tt> <tt class="py-keyword">return</tt> <tt class="py-number">0</tt> </tt>
--<a name="L218"></a><tt class="py-lineno">218</tt>  <tt class="py-line"> </tt>
--<a name="L219"></a><tt class="py-lineno">219</tt>  <tt class="py-line">    <tt class="py-name">filesChanged</tt> <tt class="py-op">=</tt> <tt class="py-number">0</tt> </tt>
--<a name="L220"></a><tt class="py-lineno">220</tt>  <tt class="py-line"> </tt>
--<a name="L221"></a><tt class="py-lineno">221</tt>  <tt class="py-line">    <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
--<a name="L222"></a><tt class="py-lineno">222</tt>  <tt class="py-line">        <tt class="py-name">cffl</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
--<a name="L223"></a><tt class="py-lineno">223</tt>  <tt class="py-line">        <tt class="py-keyword">for</tt> <tt class="py-name">searchs</tt><tt class="py-op">,</tt> <tt class="py-name">replaces</tt><tt class="py-op">,</tt> <tt class="py-name">reflags</tt> <tt class="py-keyword">in</tt> <tt class="py-name">regexl</tt><tt class="py-op">:</tt> </tt>
--<a name="L224"></a><tt class="py-lineno">224</tt>  <tt class="py-line">            <tt class="py-comment"># prepare the required regex objects, check whether we need</tt> </tt>
--<a name="L225"></a><tt class="py-lineno">225</tt>  <tt class="py-line"><tt class="py-comment"></tt>            <tt class="py-comment"># to pass any regex compilation flags</tt> </tt>
--<a name="L226"></a><tt class="py-lineno">226</tt>  <tt class="py-line"><tt class="py-comment"></tt>            <tt class="py-keyword">if</tt> <tt class="py-name">reflags</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> <tt class="py-name">regex</tt> <tt class="py-op">=</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt class="py-name">searchs</tt><tt class="py-op">,</tt> <tt class="py-name">reflags</tt><tt class="py-op">)</tt> </tt>
--<a name="L227"></a><tt class="py-lineno">227</tt>  <tt class="py-line">            <tt class="py-keyword">else</tt><tt class="py-op">:</tt> <tt class="py-name">regex</tt> <tt class="py-op">=</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt class="py-name">searchs</tt><tt class="py-op">)</tt> </tt>
--<a name="L228"></a><tt class="py-lineno">228</tt>  <tt class="py-line">            <tt class="py-name">cffl</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">regex</tt><tt class="py-op">.</tt><tt class="py-name">subn</tt><tt class="py-op">,</tt> <tt class="py-name">replaces</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
--<a name="L229"></a><tt class="py-lineno">229</tt>  <tt class="py-line">        <tt class="py-keyword">for</tt> <tt class="py-name">file</tt> <tt class="py-keyword">in</tt> <tt class="py-name">fileList</tt><tt class="py-op">:</tt> </tt>
--<a name="L230"></a><tt class="py-lineno">230</tt>  <tt class="py-line">            <tt class="py-comment"># read file content</tt> </tt>
--<a name="L231"></a><tt class="py-lineno">231</tt>  <tt class="py-line"><tt class="py-comment"></tt>            <tt class="py-name">fhandle</tt> <tt class="py-op">=</tt> <tt class="py-name">open</tt><tt class="py-op">(</tt><tt class="py-name">file</tt><tt class="py-op">,</tt> <tt class="py-string">'r'</tt><tt class="py-op">)</tt> </tt>
--<a name="L232"></a><tt class="py-lineno">232</tt>  <tt class="py-line">            <tt class="py-name">text</tt> <tt class="py-op">=</tt> <tt class="py-name">fhandle</tt><tt class="py-op">.</tt><tt class="py-name">read</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
--<a name="L233"></a><tt class="py-lineno">233</tt>  <tt class="py-line">            <tt class="py-name">fhandle</tt><tt class="py-op">.</tt><tt class="py-name">close</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
--<a name="L234"></a><tt class="py-lineno">234</tt>  <tt class="py-line">            <tt class="py-name">substitutions</tt> <tt class="py-op">=</tt> <tt class="py-number">0</tt> </tt>
--<a name="L235"></a><tt class="py-lineno">235</tt>  <tt class="py-line">            <tt class="py-comment"># unpack the subn() function and the replace string</tt> </tt>
--<a name="L236"></a><tt class="py-lineno">236</tt>  <tt class="py-line"><tt class="py-comment"></tt>            <tt class="py-keyword">for</tt> <tt class="py-name">subnfunc</tt><tt class="py-op">,</tt> <tt class="py-name">replaces</tt> <tt class="py-keyword">in</tt> <tt class="py-name">cffl</tt><tt class="py-op">:</tt> </tt>
--<a name="L237"></a><tt class="py-lineno">237</tt>  <tt class="py-line">                <tt class="py-name">text</tt><tt class="py-op">,</tt> <tt class="py-name">numOfChanges</tt> <tt class="py-op">=</tt> <tt class="py-name">subnfunc</tt><tt class="py-op">(</tt><tt class="py-name">replaces</tt><tt class="py-op">,</tt> <tt class="py-name">text</tt><tt class="py-op">)</tt> </tt>
--<a name="L238"></a><tt class="py-lineno">238</tt>  <tt class="py-line">                <tt class="py-name">substitutions</tt> <tt class="py-op">+=</tt> <tt class="py-name">numOfChanges</tt> </tt>
--<a name="L239"></a><tt class="py-lineno">239</tt>  <tt class="py-line">            <tt class="py-keyword">if</tt> <tt class="py-name">substitutions</tt><tt class="py-op">:</tt> </tt>
--<a name="L240"></a><tt class="py-lineno">240</tt>  <tt class="py-line">                <tt class="py-comment"># first move away the original file</tt> </tt>
--<a name="L241"></a><tt class="py-lineno">241</tt>  <tt class="py-line"><tt class="py-comment"></tt>                <tt class="py-name">bakFileName</tt> <tt class="py-op">=</tt> <tt class="py-string">'%s%s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">file</tt><tt class="py-op">,</tt> <tt class="py-name">bext</tt><tt class="py-op">)</tt> </tt>
--<a name="L242"></a><tt class="py-lineno">242</tt>  <tt class="py-line">                <tt class="py-keyword">if</tt> <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">path</tt><tt class="py-op">.</tt><tt class="py-name">exists</tt><tt class="py-op">(</tt><tt class="py-name">bakFileName</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">unlink</tt><tt class="py-op">(</tt><tt class="py-name">bakFileName</tt><tt class="py-op">)</tt> </tt>
--<a name="L243"></a><tt class="py-lineno">243</tt>  <tt class="py-line">                <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">rename</tt><tt class="py-op">(</tt><tt class="py-name">file</tt><tt class="py-op">,</tt> <tt class="py-name">bakFileName</tt><tt class="py-op">)</tt> </tt>
--<a name="L244"></a><tt class="py-lineno">244</tt>  <tt class="py-line">                <tt class="py-comment"># now write the new file content</tt> </tt>
--<a name="L245"></a><tt class="py-lineno">245</tt>  <tt class="py-line"><tt class="py-comment"></tt>                <tt class="py-name">fhandle</tt> <tt class="py-op">=</tt> <tt class="py-name">open</tt><tt class="py-op">(</tt><tt class="py-name">file</tt><tt class="py-op">,</tt> <tt class="py-string">'w'</tt><tt class="py-op">)</tt> </tt>
--<a name="L246"></a><tt class="py-lineno">246</tt>  <tt class="py-line">                <tt class="py-name">fhandle</tt><tt class="py-op">.</tt><tt class="py-name">write</tt><tt class="py-op">(</tt><tt class="py-name">text</tt><tt class="py-op">)</tt> </tt>
--<a name="L247"></a><tt class="py-lineno">247</tt>  <tt class="py-line">                <tt class="py-name">fhandle</tt><tt class="py-op">.</tt><tt class="py-name">close</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
--<a name="L248"></a><tt class="py-lineno">248</tt>  <tt class="py-line">                <tt class="py-name">filesChanged</tt> <tt class="py-op">+=</tt> <tt class="py-number">1</tt> </tt>
--<a name="L249"></a><tt class="py-lineno">249</tt>  <tt class="py-line">    <tt class="py-keyword">except</tt> <tt class="py-name">Exception</tt><tt class="py-op">,</tt> <tt class="py-name">e</tt><tt class="py-op">:</tt> <tt class="py-keyword">raise</tt> <tt id="link-5" class="py-name"><a title="scriptutil.ScriptError" class="py-name" href="#" onclick="return doclink('link-5', 'ScriptError', 'link-0');">ScriptError</a></tt><tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">e</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
--<a name="L250"></a><tt class="py-lineno">250</tt>  <tt class="py-line"> </tt>
--<a name="L251"></a><tt class="py-lineno">251</tt>  <tt class="py-line">    <tt class="py-comment"># Returns the number of files that had some of their content changed</tt> </tt>
--<a name="L252"></a><tt class="py-lineno">252</tt>  <tt class="py-line"><tt class="py-comment"></tt>    <tt class="py-keyword">return</tt><tt class="py-op">(</tt><tt class="py-name">filesChanged</tt><tt class="py-op">)</tt> </tt>
--</div><a name="L253"></a><tt class="py-lineno">253</tt>  <tt class="py-line"> </tt>
--<a name="printr"></a><div id="printr-def"><a name="L254"></a><tt class="py-lineno">254</tt> <a class="py-toggle" href="#" id="printr-toggle" onclick="return toggle('printr');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="scriptutil-module.html#printr">printr</a><tt class="py-op">(</tt><tt class="py-param">results</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
--</div><div id="printr-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="printr-expanded"><a name="L255"></a><tt class="py-lineno">255</tt>  <tt class="py-line">    <tt class="py-docstring">"""</tt> </tt>
--<a name="L256"></a><tt class="py-lineno">256</tt>  <tt class="py-line"><tt class="py-docstring">    Print the results of the ffind()/ffindgrep() functions.</tt> </tt>
--<a name="L257"></a><tt class="py-lineno">257</tt>  <tt class="py-line"><tt class="py-docstring">    </tt> </tt>
--<a name="L258"></a><tt class="py-lineno">258</tt>  <tt class="py-line"><tt class="py-docstring">    The output format is similar to the one used by the UNIX find utility.</tt> </tt>
--<a name="L259"></a><tt class="py-lineno">259</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
--<a name="L260"></a><tt class="py-lineno">260</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-name">results</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-name">types</tt><tt class="py-op">.</tt><tt class="py-name">DictType</tt><tt class="py-op">:</tt> </tt>
--<a name="L261"></a><tt class="py-lineno">261</tt>  <tt class="py-line">        <tt class="py-keyword">for</tt> <tt class="py-name">f</tt> <tt class="py-keyword">in</tt> <tt class="py-name">sorted</tt><tt class="py-op">(</tt><tt class="py-name">results</tt><tt class="py-op">.</tt><tt class="py-name">keys</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
--<a name="L262"></a><tt class="py-lineno">262</tt>  <tt class="py-line">            <tt class="py-name">sys</tt><tt class="py-op">.</tt><tt class="py-name">stdout</tt><tt class="py-op">.</tt><tt class="py-name">write</tt><tt class="py-op">(</tt><tt class="py-string">"%s\n%s\n"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">results</tt><tt class="py-op">[</tt><tt class="py-name">f</tt><tt class="py-op">]</tt><tt class="py-op">,</tt><tt class="py-name">f</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
--<a name="L263"></a><tt class="py-lineno">263</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
--<a name="L264"></a><tt class="py-lineno">264</tt>  <tt class="py-line">        <tt class="py-keyword">for</tt> <tt class="py-name">f</tt> <tt class="py-keyword">in</tt> <tt class="py-name">sorted</tt><tt class="py-op">(</tt><tt class="py-name">results</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
--<a name="L265"></a><tt class="py-lineno">265</tt>  <tt class="py-line">            <tt class="py-name">sys</tt><tt class="py-op">.</tt><tt class="py-name">stdout</tt><tt class="py-op">.</tt><tt class="py-name">write</tt><tt class="py-op">(</tt><tt class="py-string">"%s\n"</tt> <tt class="py-op">%</tt> <tt class="py-name">f</tt><tt class="py-op">)</tt> </tt>
--</div><a name="L266"></a><tt class="py-lineno">266</tt>  <tt class="py-line"> </tt>
--<a name="L267"></a><tt class="py-lineno">267</tt>  <tt class="py-line"><tt class="py-keyword">if</tt> <tt class="py-name">__name__</tt> <tt class="py-op">==</tt> <tt class="py-string">'__main__'</tt><tt class="py-op">:</tt> </tt>
--<a name="L268"></a><tt class="py-lineno">268</tt>  <tt class="py-line">    <tt class="py-keyword">pass</tt> </tt>
--<a name="L269"></a><tt class="py-lineno">269</tt>  <tt class="py-line"> </tt><script type="text/javascript">
--<!--
--expandto(location.href);
--// -->
--</script>
--</pre>
--<br />
--<!-- ==================== NAVIGATION BAR ==================== -->
--<table class="navbar" border="0" width="100%" cellpadding="0"
--       bgcolor="#a0c0ff" cellspacing="0">
--  <tr valign="middle">
--  <!-- Home link -->
--      <th bgcolor="#70b0f0" class="navbar-select"
--          >&nbsp;&nbsp;&nbsp;Home&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Tree link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Index link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Help link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Project homepage -->
--      <th class="navbar" align="right" width="100%">
--        <table border="0" cellpadding="0" cellspacing="0">
--          <tr><th class="navbar" align="center"
--            ><a class="navbar" target="_top" href="http://hrnjad.net/src/scriptutil">Module scriptutil</a></th>
--          </tr></table></th>
--  </tr>
--</table>
--<table border="0" cellpadding="0" cellspacing="0" width="100%%">
--  <tr>
--    <td align="left" class="footer">
--    Generated by Epydoc 3.0beta1 on Thu May 22 18:10:51 2008
--    </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>
 === removed file 'doc/html/scriptutil.ScriptError-class.html'
 --- doc/html/scriptutil.ScriptError-class.html	2009-12-26 20:49:38 +0000
 +++ doc/html/scriptutil.ScriptError-class.html	1970-01-01 00:00:00 +0000
@@ -1,197 +0,0 @@
--<?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>scriptutil.ScriptError</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">
--  <!-- Home link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Tree link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Index link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Help link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Project homepage -->
--      <th class="navbar" align="right" width="100%">
--        <table border="0" cellpadding="0" cellspacing="0">
--          <tr><th class="navbar" align="center"
--            ><a class="navbar" target="_top" href="http://hrnjad.net/src/scriptutil">Module scriptutil</a></th>
--          </tr></table></th>
--  </tr>
--</table>
--<table width="100%" cellpadding="0" cellspacing="0">
--  <tr valign="top">
--    <td width="100%">
--      <span class="breadcrumbs">
--        <a href="scriptutil-module.html">Script&nbsp;scriptutil</a> ::
--        Class&nbsp;ScriptError
--      </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&nbsp;private</a>]</span></td></tr>
--        <tr><td align="right"><span class="options"
--            >[<a href="frames.html" target="_top">frames</a
--            >]&nbsp;|&nbsp;<a href="scriptutil.ScriptError-class.html"
--            target="_top">no&nbsp;frames</a>]</span></td></tr>
--      </table>
--    </td>
--  </tr>
--</table>
--<!-- ==================== CLASS DESCRIPTION ==================== -->
--<h1 class="epydoc">Class ScriptError</h1><span class="codelink"><a href="scriptutil-pysrc.html#ScriptError">source&nbsp;code</a></span><br /><br />
--<pre class="base-tree">
--              object --+
--                       |
--exceptions.BaseException --+
--                           |
--        exceptions.Exception --+
--                               |
--                              <strong class="uidshort">ScriptError</strong>
--</pre>
--
--<hr />
--The exception raised in case of failures.<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 colspan="2" class="summary">
--    <p class="indent-wrapped-lines"><b>Inherited from <code>exceptions.Exception</code></b>:
--      <code>__init__</code>,
--      <code>__new__</code>
--      </p>
--    <p class="indent-wrapped-lines"><b>Inherited from <code>exceptions.BaseException</code></b>:
--      <code>__delattr__</code>,
--      <code>__getattribute__</code>,
--      <code>__getitem__</code>,
--      <code>__getslice__</code>,
--      <code>__reduce__</code>,
--      <code>__repr__</code>,
--      <code>__setattr__</code>,
--      <code>__setstate__</code>,
--      <code>__str__</code>
--      </p>
--    <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
--      <code>__hash__</code>,
--      <code>__reduce_ex__</code>
--      </p>
--    </td>
--  </tr>
--</table>
--<!-- ==================== PROPERTIES ==================== -->
--<a name="section-Properties"></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">Properties</span></td>
--        <td align="right" valign="top"
--         ><span class="options">[<a href="#section-Properties"
--         class="privatelink" onclick="toggle_private();"
--         >hide private</a>]</span></td>
--      </tr>
--    </table>
--  </td>
--</tr>
--  <tr>
--    <td colspan="2" class="summary">
--    <p class="indent-wrapped-lines"><b>Inherited from <code>exceptions.BaseException</code></b>:
--      <code>args</code>,
--      <code>message</code>
--      </p>
--    <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
--      <code>__class__</code>
--      </p>
--    </td>
--  </tr>
--</table>
--<!-- ==================== NAVIGATION BAR ==================== -->
--<table class="navbar" border="0" width="100%" cellpadding="0"
--       bgcolor="#a0c0ff" cellspacing="0">
--  <tr valign="middle">
--  <!-- Home link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Tree link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Index link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Help link -->
--      <th>&nbsp;&nbsp;&nbsp;<a
--        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
--
--  <!-- Project homepage -->
--      <th class="navbar" align="right" width="100%">
--        <table border="0" cellpadding="0" cellspacing="0">
--          <tr><th class="navbar" align="center"
--            ><a class="navbar" target="_top" href="http://hrnjad.net/src/scriptutil">Module scriptutil</a></th>
--          </tr></table></th>
--  </tr>
--</table>
--<table border="0" cellpadding="0" cellspacing="0" width="100%%">
--  <tr>
--    <td align="left" class="footer">
--    Generated by Epydoc 3.0beta1 on Thu May 22 18:10:51 2008
--    </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>
 === added file 'doc/html/scriptutil.find-module.html'
 --- doc/html/scriptutil.find-module.html	1970-01-01 00:00:00 +0000
 +++ doc/html/scriptutil.find-module.html	2009-12-26 22:06:14 +0000
@@ -0,0 +1,494 @@
++<?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>scriptutil.find</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">
++  <!-- Home link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Tree link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Index link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Help link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Project homepage -->
++      <th class="navbar" align="right" width="100%">
++        <table border="0" cellpadding="0" cellspacing="0">
++          <tr><th class="navbar" align="center"
++            ><a class="navbar" target="_top" href="https://launchpad.net/py-script">Project Homepage</a></th>
++          </tr></table></th>
++  </tr>
++</table>
++<table width="100%" cellpadding="0" cellspacing="0">
++  <tr valign="top">
++    <td width="100%">
++      <span class="breadcrumbs">
++        <a href="scriptutil-module.html">Package&nbsp;scriptutil</a> ::
++        Script&nbsp;find
++      </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&nbsp;private</a>]</span></td></tr>
++        <tr><td align="right"><span class="options"
++            >[<a href="frames.html" target="_top">frames</a
++            >]&nbsp;|&nbsp;<a href="scriptutil.find-module.html"
++            target="_top">no&nbsp;frames</a>]</span></td></tr>
++      </table>
++    </td>
++  </tr>
++</table>
++<!-- ==================== MODULE DESCRIPTION ==================== -->
++<h1 class="epydoc">Module find</h1><p class="nomargin-top"><span class="codelink"><a href="scriptutil.find-pysrc.html">source&nbsp;code</a></span></p>
++<p>Functions commonly used in shell scripting:</p>
++  <ul>
++    <li>
++      find()    : finds files in a directory tree
++    </li>
++    <li>
++      grep(): finds files in a directory tree and matches their content to
++      regular expressions
++    </li>
++    <li>
++      replace() : in-place search/replace of files in a directory tree with
++      regular expressions
++    </li>
++    <li>
++      pprint()   : prints the results of the find()/grep() functions
++    </li>
++  </ul>
++  <p>Please see the <a
++  href="http://muharem.wordpress.com/2007/05/20/python-find-files-using-unix-shell-style-wildcards/"
++  target="_top">tutorial</a> as well as the documentation strings of the
++  particular functions for detailed information.</p>
++
++<!-- ==================== CLASSES ==================== -->
++<a name="section-Classes"></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">Classes</span></td>
++        <td align="right" valign="top"
++         ><span class="options">[<a href="#section-Classes"
++         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">&nbsp;</span>
++    </td><td class="summary">
++        <a href="scriptutil.find.ScriptError-class.html" class="summary-name">ScriptError</a><br />
++      The exception raised in case of failures.
++    </td>
++  </tr>
++</table>
++<!-- ==================== FUNCTIONS ==================== -->
++<a name="section-Functions"></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">Functions</span></td>
++        <td align="right" valign="top"
++         ><span class="options">[<a href="#section-Functions"
++         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">sequence</span>
++    </td><td class="summary">
++      <table width="100%" cellpadding="0" cellspacing="0" border="0">
++        <tr>
++          <td><span class="summary-sig"><a href="scriptutil.find-module.html#find" class="summary-sig-name">find</a>(<span class="summary-sig-arg">path</span>,
++        <span class="summary-sig-arg">shellglobs</span>=<span class="summary-sig-default">None</span>,
++        <span class="summary-sig-arg">namefs</span>=<span class="summary-sig-default">None</span>,
++        <span class="summary-sig-arg">relative</span>=<span class="summary-sig-default">True</span>)</span><br />
++      Find files in the directory tree starting at 'path' (filtered by Unix
++      shell-style wildcards ('shellglobs') and/or the functions in the
++      'namefs' sequence).</td>
++          <td align="right" valign="top">
++            <span class="codelink"><a href="scriptutil.find-pysrc.html#find">source&nbsp;code</a></span>
++
++          </td>
++        </tr>
++      </table>
++
++    </td>
++  </tr>
++<tr>
++    <td width="15%" align="right" valign="top" class="summary">
++      <span class="summary-type">dict</span>
++    </td><td class="summary">
++      <table width="100%" cellpadding="0" cellspacing="0" border="0">
++        <tr>
++          <td><span class="summary-sig"><a href="scriptutil.find-module.html#grep" class="summary-sig-name">grep</a>(<span class="summary-sig-arg">path</span>,
++        <span class="summary-sig-arg">regexl</span>,
++        <span class="summary-sig-arg">shellglobs</span>=<span class="summary-sig-default">None</span>,
++        <span class="summary-sig-arg">namefs</span>=<span class="summary-sig-default">None</span>,
++        <span class="summary-sig-arg">relative</span>=<span class="summary-sig-default">True</span>,
++        <span class="summary-sig-arg">linenums</span>=<span class="summary-sig-default">False</span>)</span><br />
++      Find files in the directory tree starting at 'path' (filtered by Unix
++      shell-style wildcards ('shellglobs') and/or the functions in the
++      'namefs' sequence) and search inside these.</td>
++          <td align="right" valign="top">
++            <span class="codelink"><a href="scriptutil.find-pysrc.html#grep">source&nbsp;code</a></span>
++
++          </td>
++        </tr>
++      </table>
++
++    </td>
++  </tr>
++<tr>
++    <td width="15%" align="right" valign="top" class="summary">
++      <span class="summary-type">number</span>
++    </td><td class="summary">
++      <table width="100%" cellpadding="0" cellspacing="0" border="0">
++        <tr>
++          <td><span class="summary-sig"><a href="scriptutil.find-module.html#replace" class="summary-sig-name">replace</a>(<span class="summary-sig-arg">path</span>,
++        <span class="summary-sig-arg">regexl</span>,
++        <span class="summary-sig-arg">shellglobs</span>=<span class="summary-sig-default">None</span>,
++        <span class="summary-sig-arg">namefs</span>=<span class="summary-sig-default">None</span>,
++        <span class="summary-sig-arg">bext</span>=<span class="summary-sig-default"><code class="variable-quote">'</code><code class="variable-string">.bak</code><code class="variable-quote">'</code></span>)</span><br />
++      Find files in the directory tree starting at 'path' (filtered by Unix
++      shell-style wildcards ('shellglobs') and/or the functions in the
++      'namefs' sequence) and perform an in-place search/replace operation
++      on these.</td>
++          <td align="right" valign="top">
++            <span class="codelink"><a href="scriptutil.find-pysrc.html#replace">source&nbsp;code</a></span>
++
++          </td>
++        </tr>
++      </table>
++
++    </td>
++  </tr>
++<tr>
++    <td width="15%" align="right" valign="top" class="summary">
++      <span class="summary-type">&nbsp;</span>
++    </td><td class="summary">
++      <table width="100%" cellpadding="0" cellspacing="0" border="0">
++        <tr>
++          <td><span class="summary-sig"><a href="scriptutil.find-module.html#pprint" class="summary-sig-name">pprint</a>(<span class="summary-sig-arg">results</span>)</span><br />
++      Print the results of the find()/grep() functions.</td>
++          <td align="right" valign="top">
++            <span class="codelink"><a href="scriptutil.find-pysrc.html#pprint">source&nbsp;code</a></span>
++
++          </td>
++        </tr>
++      </table>
++
++    </td>
++  </tr>
++</table>
++<!-- ==================== VARIABLES ==================== -->
++<a name="section-Variables"></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">Variables</span></td>
++        <td align="right" valign="top"
++         ><span class="options">[<a href="#section-Variables"
++         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">&nbsp;</span>
++    </td><td class="summary">
++        <a name="__package__"></a><span class="summary-name">__package__</span> = <code title="'scriptutil'"><code class="variable-quote">'</code><code class="variable-string">scriptutil</code><code class="variable-quote">'</code></code>
++    </td>
++  </tr>
++</table>
++<!-- ==================== FUNCTION DETAILS ==================== -->
++<a name="section-FunctionDetails"></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">Function Details</span></td>
++        <td align="right" valign="top"
++         ><span class="options">[<a href="#section-FunctionDetails"
++         class="privatelink" onclick="toggle_private();"
++         >hide private</a>]</span></td>
++      </tr>
++    </table>
++  </td>
++</tr>
++</table>
++<a name="find"></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">find</span>(<span class="sig-arg">path</span>,
++        <span class="sig-arg">shellglobs</span>=<span class="sig-default">None</span>,
++        <span class="sig-arg">namefs</span>=<span class="sig-default">None</span>,
++        <span class="sig-arg">relative</span>=<span class="sig-default">True</span>)</span>
++  </h3>
++  </td><td align="right" valign="top"
++    ><span class="codelink"><a href="scriptutil.find-pysrc.html#find">source&nbsp;code</a></span>&nbsp;
++    </td>
++  </tr></table>
++
++  <p>Find files in the directory tree starting at 'path' (filtered by Unix
++  shell-style wildcards ('shellglobs') and/or the functions in the 'namefs'
++  sequence).</p>
++  <p>Please not that the shell wildcards work in a cumulative fashion i.e.
++  each of them is applied to the full set of file *names* found.</p>
++  <p>Conversely, all the functions in 'namefs'</p>
++  <ul>
++    <li>
++      only get to see the output of their respective predecessor function
++      in the sequence (with the obvious exception of the first function)
++    </li>
++    <li>
++      are applied to the full file *path* (whereas the shell-style
++      wildcards are only applied to the file *names*)
++    </li>
++  </ul>
++  <dl class="fields">
++    <dt>Parameters:</dt>
++    <dd><ul class="nomargin-top">
++        <li><strong class="pname"><code>path</code></strong> (string) - starting path of the directory tree to be searched</li>
++        <li><strong class="pname"><code>shellglobs</code></strong> (sequence) - an optional sequence of Unix shell-style wildcards that are to be
++          applied to the file *names* found</li>
++        <li><strong class="pname"><code>namefs</code></strong> (sequence) - an optional sequence of functions to be applied to the file
++          *paths* found</li>
++        <li><strong class="pname"><code>relative</code></strong> (bool) - a boolean flag that determines whether absolute or relative paths
++          should be returned</li>
++    </ul></dd>
++    <dt>Returns: sequence</dt>
++        <dd>paths for files found</dd>
++  </dl>
++</td></tr></table>
++</div>
++<a name="grep"></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">grep</span>(<span class="sig-arg">path</span>,
++        <span class="sig-arg">regexl</span>,
++        <span class="sig-arg">shellglobs</span>=<span class="sig-default">None</span>,
++        <span class="sig-arg">namefs</span>=<span class="sig-default">None</span>,
++        <span class="sig-arg">relative</span>=<span class="sig-default">True</span>,
++        <span class="sig-arg">linenums</span>=<span class="sig-default">False</span>)</span>
++  </h3>
++  </td><td align="right" valign="top"
++    ><span class="codelink"><a href="scriptutil.find-pysrc.html#grep">source&nbsp;code</a></span>&nbsp;
++    </td>
++  </tr></table>
++
++  <p>Find files in the directory tree starting at 'path' (filtered by Unix
++  shell-style wildcards ('shellglobs') and/or the functions in the 'namefs'
++  sequence) and search inside these.</p>
++  <p>Additionaly, the file content will be filtered by the regular
++  expressions in the 'regexl' sequence. Each entry in the latter is a</p>
++  <ul>
++    <li>
++      either a string (with the regex definition)
++    </li>
++    <li>
++      or a tuple with arguments accepted by re.compile() (the re.M and re.S
++      flags will have no effect though)
++    </li>
++  </ul>
++  <p>For all the files that pass the file name/content tests the function
++  returns a dictionary where the</p>
++  <ul>
++    <li>
++      key is the file name and the
++    </li>
++    <li>
++      value is a string with lines filtered by 'regexl'
++    </li>
++  </ul>
++  <dl class="fields">
++    <dt>Parameters:</dt>
++    <dd><ul class="nomargin-top">
++        <li><strong class="pname"><code>path</code></strong> (string) - starting path of the directory tree to be searched</li>
++        <li><strong class="pname"><code>shellglobs</code></strong> (sequence) - an optional sequence of Unix shell-style wildcards that are to be
++          applied to the file *names* found</li>
++        <li><strong class="pname"><code>namefs</code></strong> (sequence) - an optional sequence of functions to be applied to the file
++          *paths* found</li>
++        <li><strong class="pname"><code>relative</code></strong> (bool) - a boolean flag that determines whether absolute or relative paths
++          should be returned</li>
++        <li><strong class="pname"><code>linenums</code></strong> (bool) - turns on line numbers for found files (like grep -n)</li>
++    </ul></dd>
++    <dt>Returns: dict</dt>
++        <dd>file name (key) and lines filtered by 'regexl' (value)</dd>
++  </dl>
++</td></tr></table>
++</div>
++<a name="replace"></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">replace</span>(<span class="sig-arg">path</span>,
++        <span class="sig-arg">regexl</span>,
++        <span class="sig-arg">shellglobs</span>=<span class="sig-default">None</span>,
++        <span class="sig-arg">namefs</span>=<span class="sig-default">None</span>,
++        <span class="sig-arg">bext</span>=<span class="sig-default"><code class="variable-quote">'</code><code class="variable-string">.bak</code><code class="variable-quote">'</code></span>)</span>
++  </h3>
++  </td><td align="right" valign="top"
++    ><span class="codelink"><a href="scriptutil.find-pysrc.html#replace">source&nbsp;code</a></span>&nbsp;
++    </td>
++  </tr></table>
++
++  <p>Find files in the directory tree starting at 'path' (filtered by Unix
++  shell-style wildcards ('shellglobs') and/or the functions in the 'namefs'
++  sequence) and perform an in-place search/replace operation on these.</p>
++  <p>Additionally, an in-place search/replace operation is performed on the
++  content of all the files (whose names passed the tests) using the regular
++  expressions in 'regexl'.</p>
++  <p>Please note: 'regexl' is a sequence of 3-tuples, each having the
++  following elements:</p>
++  <ul>
++    <li>
++      search string (Python regex syntax)
++    </li>
++    <li>
++      replace string (Python regex syntax)
++    </li>
++    <li>
++      regex flags or 'None' (re.compile syntax)
++    </li>
++  </ul>
++  <p>Copies of the modified files are saved in backup files using the
++  extension specified in 'bext'.</p>
++  <dl class="fields">
++    <dt>Parameters:</dt>
++    <dd><ul class="nomargin-top">
++        <li><strong class="pname"><code>path</code></strong> (string) - starting path of the directory tree to be searched</li>
++        <li><strong class="pname"><code>shellglobs</code></strong> (sequence) - an optional sequence of Unix shell-style wildcards that are to be
++          applied to the file *names* found</li>
++        <li><strong class="pname"><code>namefs</code></strong> (sequence) - an optional sequence of functions to be applied to the file
++          *paths* found</li>
++    </ul></dd>
++    <dt>Returns: number</dt>
++        <dd>total number of files modified</dd>
++  </dl>
++</td></tr></table>
++</div>
++<a name="pprint"></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">pprint</span>(<span class="sig-arg">results</span>)</span>
++  </h3>
++  </td><td align="right" valign="top"
++    ><span class="codelink"><a href="scriptutil.find-pysrc.html#pprint">source&nbsp;code</a></span>&nbsp;
++    </td>
++  </tr></table>
++
++  <p>Print the results of the find()/grep() functions.</p>
++  <p>The output format is similar to the one used by the UNIX find
++  utility.</p>
++  <dl class="fields">
++  </dl>
++</td></tr></table>
++</div>
++<br />
++<!-- ==================== NAVIGATION BAR ==================== -->
++<table class="navbar" border="0" width="100%" cellpadding="0"
++       bgcolor="#a0c0ff" cellspacing="0">
++  <tr valign="middle">
++  <!-- Home link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Tree link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Index link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Help link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Project homepage -->
++      <th class="navbar" align="right" width="100%">
++        <table border="0" cellpadding="0" cellspacing="0">
++          <tr><th class="navbar" align="center"
++            ><a class="navbar" target="_top" href="https://launchpad.net/py-script">Project Homepage</a></th>
++          </tr></table></th>
++  </tr>
++</table>
++<table border="0" cellpadding="0" cellspacing="0" width="100%%">
++  <tr>
++    <td align="left" class="footer">
++    Generated by Epydoc 3.0.1 on Sat Dec 26 23:01:34 2009
++    </td>
++    <td align="right" class="footer">
++      <a target="mainFrame" 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>
 === added file 'doc/html/scriptutil.find-pysrc.html'
 --- doc/html/scriptutil.find-pysrc.html	1970-01-01 00:00:00 +0000
 +++ doc/html/scriptutil.find-pysrc.html	2009-12-26 22:06:14 +0000
@@ -0,0 +1,390 @@
++<?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>scriptutil.find</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">
++  <!-- Home link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="scriptutil-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Tree link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Index link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Help link -->
++      <th>&nbsp;&nbsp;&nbsp;<a
++        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
++
++  <!-- Project homepage -->
++      <th class="navbar" align="right" width="100%">
++        <table border="0" cellpadding="0" cellspacing="0">
++          <tr><th class="navbar" align="center"
++            ><a class="navbar" target="_top" href="https://launchpad.net/py-script">Project Homepage</a></th>
++          </tr></table></th>
++  </tr>
++</table>
++<table width="100%" cellpadding="0" cellspacing="0">
++  <tr valign="top">
++    <td width="100%">
++      <span class="breadcrumbs">
++        <a href="scriptutil-module.html">Package&nbsp;scriptutil</a> ::
++        Script&nbsp;find
++      </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&nbsp;private</a>]</span></td></tr>
++        <tr><td align="right"><span class="options"
++            >[<a href="frames.html" target="_top">frames</a
++            >]&nbsp;|&nbsp;<a href="scriptutil.find-pysrc.html"
++            target="_top">no&nbsp;frames</a>]</span></td></tr>
++      </table>
++    </td>
++  </tr>
++</table>
++<h1 class="epydoc">Source Code for <a href="scriptutil.find-module.html">Script scriptutil.find</a></h1>
++<pre class="py-src">
++<a name="L1"></a><tt class="py-lineno">  1</tt>  <tt class="py-line"><tt class="py-comment">#!/usr/bin/env python</tt> </tt>
++<a name="L2"></a><tt class="py-lineno">  2</tt>  <tt class="py-line"><tt class="py-comment"># encoding: utf-8</tt> </tt>
++<a name="L3"></a><tt class="py-lineno">  3</tt>  <tt class="py-line"> </tt>
++<a name="L4"></a><tt class="py-lineno">  4</tt>  <tt class="py-line"> </tt>
++<a name="L5"></a><tt class="py-lineno">  5</tt>  <tt class="py-line"><tt class="py-comment">#    This file is part of py-script (https://launchpad.net/py-script)</tt> </tt>
++<a name="L6"></a><tt class="py-lineno">  6</tt>  <tt class="py-line"><tt class="py-comment">#</tt> </tt>
++<a name="L7"></a><tt class="py-lineno">  7</tt>  <tt class="py-line"><tt class="py-comment">#    Copyright (C) 2009 Muharem Hrnjadovic &lt;muharem@linux.com&gt;</tt> </tt>
++<a name="L8"></a><tt class="py-lineno">  8</tt>  <tt class="py-line"><tt class="py-comment">#</tt> </tt>
++<a name="L9"></a><tt class="py-lineno">  9</tt>  <tt class="py-line"><tt class="py-comment">#    This program is free software; you can redistribute it and/or modify</tt> </tt>
++<a name="L10"></a><tt class="py-lineno"> 10</tt>  <tt class="py-line"><tt class="py-comment">#    it under the terms of the GNU General Public License as published by</tt> </tt>
++<a name="L11"></a><tt class="py-lineno"> 11</tt>  <tt class="py-line"><tt class="py-comment">#    the Free Software Foundation; either version 2 of the License, or</tt> </tt>
++<a name="L12"></a><tt class="py-lineno"> 12</tt>  <tt class="py-line"><tt class="py-comment">#    (at your option) any later version.</tt> </tt>
++<a name="L13"></a><tt class="py-lineno"> 13</tt>  <tt class="py-line"><tt class="py-comment">#</tt> </tt>
++<a name="L14"></a><tt class="py-lineno"> 14</tt>  <tt class="py-line"><tt class="py-comment">#    This program is distributed in the hope that it will be useful,</tt> </tt>
++<a name="L15"></a><tt class="py-lineno"> 15</tt>  <tt class="py-line"><tt class="py-comment">#    but WITHOUT ANY WARRANTY; without even the implied warranty of</tt> </tt>
++<a name="L16"></a><tt class="py-lineno"> 16</tt>  <tt class="py-line"><tt class="py-comment">#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the</tt> </tt>
++<a name="L17"></a><tt class="py-lineno"> 17</tt>  <tt class="py-line"><tt class="py-comment">#    GNU General Public License for more details.</tt> </tt>
++<a name="L18"></a><tt class="py-lineno"> 18</tt>  <tt class="py-line"><tt class="py-comment">#</tt> </tt>
++<a name="L19"></a><tt class="py-lineno"> 19</tt>  <tt class="py-line"><tt class="py-comment">#    You should have received a copy of the GNU General Public License along</tt> </tt>
++<a name="L20"></a><tt class="py-lineno"> 20</tt>  <tt class="py-line"><tt class="py-comment">#    with this program; if not, write to the Free Software Foundation, Inc.,</tt> </tt>
++<a name="L21"></a><tt class="py-lineno"> 21</tt>  <tt class="py-line"><tt class="py-comment">#    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.</tt> </tt>
++<a name="L22"></a><tt class="py-lineno"> 22</tt>  <tt class="py-line"> </tt>
++<a name="L23"></a><tt class="py-lineno"> 23</tt>  <tt class="py-line"> </tt>
++<a name="L24"></a><tt class="py-lineno"> 24</tt>  <tt class="py-line"><tt class="py-docstring">"""</tt> </tt>
++<a name="L25"></a><tt class="py-lineno"> 25</tt>  <tt class="py-line"><tt class="py-docstring">Functions commonly used in shell scripting:</tt> </tt>
++<a name="L26"></a><tt class="py-lineno"> 26</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
++<a name="L27"></a><tt class="py-lineno"> 27</tt>  <tt class="py-line"><tt class="py-docstring">  - find()    : finds files in a directory tree</tt> </tt>
++<a name="L28"></a><tt class="py-lineno"> 28</tt>  <tt class="py-line"><tt class="py-docstring">  - grep(): finds files in a directory tree and matches their</tt> </tt>
++<a name="L29"></a><tt class="py-lineno"> 29</tt>  <tt class="py-line"><tt class="py-docstring">                 content to regular expressions</tt> </tt>
++<a name="L30"></a><tt class="py-lineno"> 30</tt>  <tt class="py-line"><tt class="py-docstring">  - replace() : in-place search/replace of files in a directory tree</tt> </tt>
++<a name="L31"></a><tt class="py-lineno"> 31</tt>  <tt class="py-line"><tt class="py-docstring">                 with regular expressions</tt> </tt>
++<a name="L32"></a><tt class="py-lineno"> 32</tt>  <tt class="py-line"><tt class="py-docstring">  - pprint()   : prints the results of the find()/grep() functions</tt> </tt>
++<a name="L33"></a><tt class="py-lineno"> 33</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
++<a name="L34"></a><tt class="py-lineno"> 34</tt>  <tt class="py-line"><tt class="py-docstring">Please see the U{tutorial &lt;http://muharem.wordpress.com/2007/05/20/python-find-files-using-unix-shell-style-wildcards/&gt;} as well as the documentation strings of the particular functions for detailed information.</tt> </tt>
++<a name="L35"></a><tt class="py-lineno"> 35</tt>  <tt class="py-line"><tt class="py-docstring">"""</tt> </tt>
++<a name="L36"></a><tt class="py-lineno"> 36</tt>  <tt class="py-line"> </tt>
++<a name="L37"></a><tt class="py-lineno"> 37</tt>  <tt class="py-line"> </tt>
++<a name="L38"></a><tt class="py-lineno"> 38</tt>  <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">fnmatch</tt> </tt>
++<a name="L39"></a><tt class="py-lineno"> 39</tt>  <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">itertools</tt> </tt>
++<a name="L40"></a><tt class="py-lineno"> 40</tt>  <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">os</tt> </tt>
++<a name="L41"></a><tt class="py-lineno"> 41</tt>  <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">sys</tt> </tt>
++<a name="L42"></a><tt class="py-lineno"> 42</tt>  <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">re</tt> </tt>
++<a name="L43"></a><tt class="py-lineno"> 43</tt>  <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">types</tt> </tt>
++<a name="L44"></a><tt class="py-lineno"> 44</tt>  <tt class="py-line"> </tt>
++<a name="L45"></a><tt class="py-lineno"> 45</tt>  <tt class="py-line"> </tt>
++<a name="ScriptError"></a><div id="ScriptError-def"><a name="L46"></a><tt class="py-lineno"> 46</tt> <a class="py-toggle" href="#" id="ScriptError-toggle" onclick="return toggle('ScriptError');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="scriptutil.find.ScriptError-class.html">ScriptError</a><tt class="py-op">(</tt><tt class="py-base-class">Exception</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
++</div><div id="ScriptError-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="ScriptError-expanded"><a name="L47"></a><tt class="py-lineno"> 47</tt>  <tt class="py-line">    <tt class="py-docstring">"""The exception raised in case of failures."""</tt> </tt>
++</div><a name="L48"></a><tt class="py-lineno"> 48</tt>  <tt class="py-line"> </tt>
++<a name="L49"></a><tt class="py-lineno"> 49</tt>  <tt class="py-line"> </tt>
++<a name="find"></a><div id="find-def"><a name="L50"></a><tt class="py-lineno"> 50</tt> <a class="py-toggle" href="#" id="find-toggle" onclick="return toggle('find');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="scriptutil.find-module.html#find">find</a><tt class="py-op">(</tt><tt class="py-param">path</tt><tt class="py-op">,</tt> <tt class="py-param">shellglobs</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">namefs</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">relative</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
++</div><div id="find-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="find-expanded"><a name="L51"></a><tt class="py-lineno"> 51</tt>  <tt class="py-line">    <tt class="py-docstring">"""</tt> </tt>
++<a name="L52"></a><tt class="py-lineno"> 52</tt>  <tt class="py-line"><tt class="py-docstring">    Find files in the directory tree starting at 'path' (filtered by</tt> </tt>
++<a name="L53"></a><tt class="py-lineno"> 53</tt>  <tt class="py-line"><tt class="py-docstring">    Unix shell-style wildcards ('shellglobs') and/or the functions in</tt> </tt>
++<a name="L54"></a><tt class="py-lineno"> 54</tt>  <tt class="py-line"><tt class="py-docstring">    the 'namefs' sequence).</tt> </tt>
++<a name="L55"></a><tt class="py-lineno"> 55</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
++<a name="L56"></a><tt class="py-lineno"> 56</tt>  <tt class="py-line"><tt class="py-docstring">    Please not that the shell wildcards work in a cumulative fashion</tt> </tt>
++<a name="L57"></a><tt class="py-lineno"> 57</tt>  <tt class="py-line"><tt class="py-docstring">    i.e. each of them is applied to the full set of file *names* found.</tt> </tt>
++<a name="L58"></a><tt class="py-lineno"> 58</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
++<a name="L59"></a><tt class="py-lineno"> 59</tt>  <tt class="py-line"><tt class="py-docstring">    Conversely, all the functions in 'namefs'</tt> </tt>
++<a name="L60"></a><tt class="py-lineno"> 60</tt>  <tt class="py-line"><tt class="py-docstring">        - only get to see the output of their respective predecessor</tt> </tt>
++<a name="L61"></a><tt class="py-lineno"> 61</tt>  <tt class="py-line"><tt class="py-docstring">          function in the sequence (with the obvious exception of the</tt> </tt>
++<a name="L62"></a><tt class="py-lineno"> 62</tt>  <tt class="py-line"><tt class="py-docstring">          first function)</tt> </tt>
++<a name="L63"></a><tt class="py-lineno"> 63</tt>  <tt class="py-line"><tt class="py-docstring">        - are applied to the full file *path* (whereas the shell-style</tt> </tt>
++<a name="L64"></a><tt class="py-lineno"> 64</tt>  <tt class="py-line"><tt class="py-docstring">          wildcards are only applied to the file *names*)</tt> </tt>
++<a name="L65"></a><tt class="py-lineno"> 65</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
++<a name="L66"></a><tt class="py-lineno"> 66</tt>  <tt class="py-line"><tt class="py-docstring">    @type path: string</tt> </tt>
++<a name="L67"></a><tt class="py-lineno"> 67</tt>  <tt class="py-line"><tt class="py-docstring">    @param path: starting path of the directory tree to be searched</tt> </tt>
++<a name="L68"></a><tt class="py-lineno"> 68</tt>  <tt class="py-line"><tt class="py-docstring">    @type shellglobs: sequence</tt> </tt>
++<a name="L69"></a><tt class="py-lineno"> 69</tt>  <tt class="py-line"><tt class="py-docstring">    @param shellglobs: an optional sequence of Unix shell-style wildcards</tt> </tt>
++<a name="L70"></a><tt class="py-lineno"> 70</tt>  <tt class="py-line"><tt class="py-docstring">        that are to be applied to the file *names* found</tt> </tt>
++<a name="L71"></a><tt class="py-lineno"> 71</tt>  <tt class="py-line"><tt class="py-docstring">    @type namefs: sequence</tt> </tt>
++<a name="L72"></a><tt class="py-lineno"> 72</tt>  <tt class="py-line"><tt class="py-docstring">    @param namefs: an optional sequence of functions to be applied to the</tt> </tt>
++<a name="L73"></a><tt class="py-lineno"> 73</tt>  <tt class="py-line"><tt class="py-docstring">        file *paths* found</tt> </tt>
++<a name="L74"></a><tt class="py-lineno"> 74</tt>  <tt class="py-line"><tt class="py-docstring">    @type relative: bool</tt> </tt>
++<a name="L75"></a><tt class="py-lineno"> 75</tt>  <tt class="py-line"><tt class="py-docstring">    @param relative: a boolean flag that determines whether absolute or</tt> </tt>
++<a name="L76"></a><tt class="py-lineno"> 76</tt>  <tt class="py-line"><tt class="py-docstring">        relative paths should be returned</tt> </tt>
++<a name="L77"></a><tt class="py-lineno"> 77</tt>  <tt class="py-line"><tt class="py-docstring">    @rtype: sequence</tt> </tt>
++<a name="L78"></a><tt class="py-lineno"> 78</tt>  <tt class="py-line"><tt class="py-docstring">    @return: paths for files found</tt> </tt>
++<a name="L79"></a><tt class="py-lineno"> 79</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
++<a name="L80"></a><tt class="py-lineno"> 80</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">access</tt><tt class="py-op">(</tt><tt class="py-name">path</tt><tt class="py-op">,</tt> <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">R_OK</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
++<a name="L81"></a><tt class="py-lineno"> 81</tt>  <tt class="py-line">        <tt class="py-keyword">raise</tt> <tt id="link-0" class="py-name" targets="Class scriptutil.find.ScriptError=scriptutil.find.ScriptError-class.html"><a title="scriptutil.find.ScriptError" class="py-name" href="#" onclick="return doclink('link-0', 'ScriptError', 'link-0');">ScriptError</a></tt><tt class="py-op">(</tt><tt class="py-string">"cannot access path: '%s'"</tt> <tt class="py-op">%</tt> <tt class="py-name">path</tt><tt class="py-op">)</tt> </tt>
++<a name="L82"></a><tt class="py-lineno"> 82</tt>  <tt class="py-line"> </tt>
++<a name="L83"></a><tt class="py-lineno"> 83</tt>  <tt class="py-line">    <tt class="py-name">fileList</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> <tt class="py-comment"># result list</tt> </tt>
++<a name="L84"></a><tt class="py-lineno"> 84</tt>  <tt class="py-line">    <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
++<a name="L85"></a><tt class="py-lineno"> 85</tt>  <tt class="py-line">        <tt class="py-keyword">for</tt> <tt class="py-name">dir</tt><tt class="py-op">,</tt> <tt class="py-name">subdirs</tt><tt class="py-op">,</tt> <tt class="py-name">files</tt> <tt class="py-keyword">in</tt> <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">walk</tt><tt class="py-op">(</tt><tt class="py-name">path</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
++<a name="L86"></a><tt class="py-lineno"> 86</tt>  <tt class="py-line">            <tt class="py-keyword">if</tt> <tt class="py-name">shellglobs</tt><tt class="py-op">:</tt> </tt>
++<a name="L87"></a><tt class="py-lineno"> 87</tt>  <tt class="py-line">                <tt class="py-name">matched</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
++<a name="L88"></a><tt class="py-lineno"> 88</tt>  <tt class="py-line">                <tt class="py-keyword">for</tt> <tt class="py-name">pattern</tt> <tt class="py-keyword">in</tt> <tt class="py-name">shellglobs</tt><tt class="py-op">:</tt> </tt>
++<a name="L89"></a><tt class="py-lineno"> 89</tt>  <tt class="py-line">                    <tt class="py-name">filterf</tt> <tt class="py-op">=</tt> <tt class="py-keyword">lambda</tt> <tt class="py-name">s</tt><tt class="py-op">:</tt> <tt class="py-name">fnmatch</tt><tt class="py-op">.</tt><tt class="py-name">fnmatchcase</tt><tt class="py-op">(</tt><tt class="py-name">s</tt><tt class="py-op">,</tt> <tt class="py-name">pattern</tt><tt class="py-op">)</tt> </tt>
++<a name="L90"></a><tt class="py-lineno"> 90</tt>  <tt class="py-line">                    <tt class="py-name">matched</tt><tt class="py-op">.</tt><tt class="py-name">extend</tt><tt class="py-op">(</tt><tt class="py-name">filter</tt><tt class="py-op">(</tt><tt class="py-name">filterf</tt><tt class="py-op">,</tt> <tt class="py-name">files</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
++<a name="L91"></a><tt class="py-lineno"> 91</tt>  <tt class="py-line">                <tt class="py-name">fileList</tt><tt class="py-op">.</tt><tt class="py-name">extend</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'%s%s%s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">dir</tt><tt class="py-op">,</tt> <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">sep</tt><tt class="py-op">,</tt> <tt class="py-name">f</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">f</tt> <tt class="py-keyword">in</tt> <tt class="py-name">matched</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
++<a name="L92"></a><tt class="py-lineno"> 92</tt>  <tt class="py-line">            <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
++<a name="L93"></a><tt class="py-lineno"> 93</tt>  <tt class="py-line">                <tt class="py-name">fileList</tt><tt class="py-op">.</tt><tt class="py-name">extend</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'%s%s%s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">dir</tt><tt class="py-op">,</tt> <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">sep</tt><tt class="py-op">,</tt> <tt class="py-name">f</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">f</tt> <tt class="py-keyword">in</tt> <tt class="py-name">files</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
++<a name="L94"></a><tt class="py-lineno"> 94</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">relative</tt><tt class="py-op">:</tt> <tt class="py-name">fileList</tt> <tt class="py-op">=</tt> <tt class="py-name">map</tt><tt class="py-op">(</tt><tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">path</tt><tt class="py-op">.</tt><tt class="py-name">abspath</tt><tt class="py-op">,</tt> <tt class="py-name">fileList</tt><tt class="py-op">)</tt> </tt>
++<a name="L95"></a><tt class="py-lineno"> 95</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">namefs</tt><tt class="py-op">:</tt>  </tt>
++<a name="L96"></a><tt class="py-lineno"> 96</tt>  <tt class="py-line">            <tt class="py-keyword">for</tt> <tt class="py-name">ff</tt> <tt class="py-keyword">in</tt> <tt class="py-name">namefs</tt><tt class="py-op">:</tt> <tt class="py-name">fileList</tt> <tt class="py-op">=</tt> <tt class="py-name">filter</tt><tt class="py-op">(</tt><tt class="py-name">ff</tt><tt class="py-op">,</tt> <tt class="py-name">fileList</tt><tt class="py-op">)</tt> </tt>
++<a name="L97"></a><tt class="py-lineno"> 97</tt>  <tt class="py-line">    <tt class="py-keyword">except</tt> <tt class="py-name">Exception</tt><tt class="py-op">,</tt> <tt class="py-name">e</tt><tt class="py-op">:</tt> <tt class="py-keyword">raise</tt> <tt id="link-1" class="py-name"><a title="scriptutil.find.ScriptError" class="py-name" href="#" onclick="return doclink('link-1', 'ScriptError', 'link-0');">ScriptError</a></tt><tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">e</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
++<a name="L98"></a><tt class="py-lineno"> 98</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt><tt class="py-op">(</tt><tt class="py-name">fileList</tt><tt class="py-op">)</tt> </tt>
++</div><a name="L99"></a><tt class="py-lineno"> 99</tt>  <tt class="py-line"> </tt>
++<a name="L100"></a><tt class="py-lineno">100</tt>  <tt class="py-line"> </tt>
++<a name="grep"></a><div id="grep-def"><a name="L101"></a><tt class="py-lineno">101</tt> <a class="py-toggle" href="#" id="grep-toggle" onclick="return toggle('grep');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="scriptutil.find-module.html#grep">grep</a><tt class="py-op">(</tt><tt class="py-param">path</tt><tt class="py-op">,</tt> <tt class="py-param">regexl</tt><tt class="py-op">,</tt> <tt class="py-param">shellglobs</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">namefs</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt>  </tt>
++<a name="L102"></a><tt class="py-lineno">102</tt>  <tt class="py-line">              <tt class="py-param">relative</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">,</tt> <tt class="py-param">linenums</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
++</div><div id="grep-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="grep-expanded"><a name="L103"></a><tt class="py-lineno">103</tt>  <tt class="py-line">    <tt class="py-docstring">"""</tt> </tt>
++<a name="L104"></a><tt class="py-lineno">104</tt>  <tt class="py-line"><tt class="py-docstring">    Find files in the directory tree starting at 'path' (filtered by</tt> </tt>
++<a name="L105"></a><tt class="py-lineno">105</tt>  <tt class="py-line"><tt class="py-docstring">    Unix shell-style wildcards ('shellglobs') and/or the functions in</tt> </tt>
++<a name="L106"></a><tt class="py-lineno">106</tt>  <tt class="py-line"><tt class="py-docstring">    the 'namefs' sequence) and search inside these.</tt> </tt>
++<a name="L107"></a><tt class="py-lineno">107</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
++<a name="L108"></a><tt class="py-lineno">108</tt>  <tt class="py-line"><tt class="py-docstring">    Additionaly, the file content will be filtered by the regular</tt> </tt>

Python scripting utilities

Merge lp:~al-maisan/py-script/doc-500616 into lp:py-script

Commit message

Description of the change

Preview Diff

Subscribers