Message187535
The subprocess documentation currently just says that Popen.stdin et all are "file objects", which is linked to the glossary entry. This isn't very helpful, as it doesn't tell whether the streams are bytes or text streams.
Suggested patch:
diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -677,21 +677,29 @@
.. attribute:: Popen.stdin
- If the *stdin* argument was :data:`PIPE`, this attribute is a :term:`file
- object` that provides input to the child process. Otherwise, it is ``None``.
+ If the *stdin* argument was :data:`PIPE`, this attribute is a
+ :class:`io.BufferedWriter` (if the *universal_newlines* argument
+ was False) or :class:`io.TextIOWrapper` (if the
+ *universal_newlines* argument was True) object that provides input
+ to the child process. Otherwise, it is ``None``.
.. attribute:: Popen.stdout
- If the *stdout* argument was :data:`PIPE`, this attribute is a :term:`file
- object` that provides output from the child process. Otherwise, it is ``None``.
+ If the *stdout* argument was :data:`PIPE`, this attribute is a
+ :class:`io.BufferedReader` (if the *universal_newlines* argument
+ was False) or :class:`io.TextIOWrapper` (if the
+ *universal_newlines* argument was True) object that provides output
+ from the child process. Otherwise, it is ``None``.
.. attribute:: Popen.stderr
- If the *stderr* argument was :data:`PIPE`, this attribute is a :term:`file
- object` that provides error output from the child process. Otherwise, it is
- ``None``.
+ If the *stderr* argument was :data:`PIPE`, this attribute is a
+ :class:`io.BufferedReader` (if the *universal_newlines* argument
+ was False) or :class:`io.TextIOWrapper` (if the
+ *universal_newlines* argument was True) object that provides output
+ from the child process. Otherwise, it is ``None``.
.. attribute:: Popen.pid |
|
Date |
User |
Action |
Args |
2013-04-21 23:14:46 | nikratio | set | recipients:
+ nikratio, docs@python |
2013-04-21 23:14:46 | nikratio | set | messageid: <1366586086.38.0.427506521088.issue17814@psf.upfronthosting.co.za> |
2013-04-21 23:14:46 | nikratio | link | issue17814 messages |
2013-04-21 23:14:46 | nikratio | create | |
|