classification
Title: subprocess documentation not explicit about fileno()
Type: enhancement Stage: needs patch
Components: Documentation Versions: Python 3.8, Python 3.7
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: Mariatta Nosy List: Mariatta, Thayne.McCombs, cheryl.sabella, docs@python
Priority: normal Keywords:

Created on 2013-12-16 01:52 by Thayne.McCombs, last changed 2019-04-08 22:45 by cheryl.sabella.

Messages (2)
msg206272 - (view) Author: Thayne McCombs (Thayne.McCombs) Date: 2013-12-16 01:52
The subprocess documentation for stdout/stderr/stdin states: 
"Valid values are PIPE, an existing file descriptor (a positive integer), an existing file object, and None. PIPE indicates that a new pipe to the child should be created."

However, file-like objects such as StringIO are not valid if they do not implement fileno(). The documentation should be more explicit that the file object should be backed by an actual file descriptor (and therefore has a fileno() function).
msg339679 - (view) Author: Cheryl Sabella (cheryl.sabella) * (Python committer) Date: 2019-04-08 22:45
Assigning to @Mariatta for the sprints.
History
Date User Action Args
2019-04-08 22:45:54cheryl.sabellasetversions: + Python 3.7, Python 3.8, - Python 2.7, Python 3.5, Python 3.6
nosy: + Mariatta, cheryl.sabella

messages: + msg339679

assignee: docs@python -> Mariatta
type: enhancement
2017-04-08 00:09:57martin.panterlinkissue29989 superseder
2016-05-13 11:42:31martin.pantersetstage: needs patch
versions: + Python 2.7, Python 3.5, Python 3.6
2013-12-16 01:52:40Thayne.McCombscreate