~ubuntu-branches/ubuntu/karmic/cedar-backup2/karmic

<h2 class="class">Class Pipe</h2>

<a href="popen2.Popen3-class.html"><code>Popen3</code></a> --+    

    <a href="popen2.Popen4-class.html"><code>Popen4</code></a> --+

way of interacting with a pipe that isn't satisfied by the standard 

<code>Popen3</code> and <code>Popen4</code> classes in 

<code>popen2</code>. First, <code>executeCommand</code> only reads from 

the pipe, and never writes to it. Second, <code>executeCommand</code> 

needs a way to discard all output written to <code>stderr</code>, as a 

means of simulating the shell <code>2&gt;/dev/null</code> construct.</p>

<p>This class inherits from <code>Popen4</code>. If the 

<code>ignoreStderr</code> flag is passed in as <code>False</code>, then 

the standard <code>Popen4</code> constructor will be called and 

<code>stdout</code> and <code>stderr</code> will be intermingled in the 

output.</p>

<p>Otherwise, we'll call a custom version of the constructor which was 

basically stolen from the real constructor in 

<code>python2.3/Lib/popen2.py</code>. This custom constructor will 

redirect the <code>stderr</code> file descriptor to 

<code>/dev/null</code>. I've done this based on a suggestion from Donn 

Cave on comp.lang.python.</p>

<p>In either case, the <code>tochild</code> file object is always closed 

before returning from the constructor, since it is never needed by 

<code>executeCommand</code>.</p>

<p>I really wish there were a prettier way to do this. Unfortunately, I 

need access to the guts of the constructor implementation because of the 

way the pipe process is forked, etc. It doesn't work to just call the 

superclass constructor and then modify a few things afterwards. Even 

worse, I have to access private <code>popen2</code> module members 

<code>_cleanup</code> and <code>_active</code> in order to duplicate the 

implementation.</p>

Hopefully this whole thing will continue to work properly. At least we 

can use the other <code>subprocess.Popen</code>-based implementation when 

that class is available.

<p><b>Copyright:</b> Some of this code, prior to customization, was originally part of the 

Python 2.3 codebase. Python code is copyright (c) 2001, 2002 Python 

Software Foundation; All Rights Reserved.

</p>

 

  <th colspan="2">&nbsp;&nbsp;&nbsp;&nbsp;Inherited from Popen3</th></tr>

<tr><td align="right" valign="top" width="15%"><font size="-1">&nbsp;</font></td>

  <td><code><span class="summary-sig"><a href="popen2.Popen3-class.html#poll" class="summary-sig-name"><code>poll</code></a>(<span class=summary-sig-arg>self</span>)</span></code>

<br />

Return the exit status of the child process if it has finished, or -1 

if it hasn't finished yet.</td></tr>

<tr><td align="right" valign="top" width="15%"><font size="-1">&nbsp;</font></td>

  <td><code><span class="summary-sig"><a href="popen2.Popen3-class.html#wait" class="summary-sig-name"><code>wait</code></a>(<span class=summary-sig-arg>self</span>)</span></code>

<br />

Wait for and return the exit status of the child process.</td></tr>

</table><br />

 

 

<!-- =========== START OF CLASS VARIABLE SUMMARY =========== -->

<table class="summary" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white">

<tr bgcolor="#70b0f0" class="summary">

  <th colspan="2">Class Variable Summary</th></tr>

<tr bgcolor="#e8f0f8" class="group">

  <th colspan="2">&nbsp;&nbsp;&nbsp;&nbsp;Inherited from Popen4</th></tr>

<tr><td align="right" valign="top" width="15%"><font size="-1"><code>NoneType</code></font></td>

<td><b><a href="popen2.Popen4-class.html#childerr"><code>childerr</code></a></b> = <span title="None">None&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span></td></tr>

<tr bgcolor="#e8f0f8" class="group">

  <th colspan="2">&nbsp;&nbsp;&nbsp;&nbsp;Inherited from Popen3</th></tr>

<tr><td align="right" valign="top" width="15%"><font size="-1"><code>int</code></font></td>

<td><b><a href="popen2.Popen3-class.html#sts"><code>sts</code></a></b> = <span title="-1">-1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span></td></tr>

    <td align="left"><font size="-2">Generated by Epydoc 2.1 on Mon Sep  4 13:49:34 2006</font></td>