Skip to content

Commit

Permalink
gh-87597: Document TimeoutExpired.stdout & .stderr types (#97685)
Browse files Browse the repository at this point in the history
This documents the behavior that has always been the case since timeout
support was introduced in Python 3.3.
  • Loading branch information
gpshead authored Sep 30, 2022
1 parent 1cc308d commit b05dd79
Showing 1 changed file with 7 additions and 2 deletions.
9 changes: 7 additions & 2 deletions Doc/library/subprocess.rst
Original file line number Diff line number Diff line change
Expand Up @@ -193,7 +193,10 @@ underlying :class:`Popen` interface can be used directly.
.. attribute:: output

Output of the child process if it was captured by :func:`run` or
:func:`check_output`. Otherwise, ``None``.
:func:`check_output`. Otherwise, ``None``. This is always
:class:`bytes` when any output was captured regardless of the
``text=True`` setting. It may remain ``None`` instead of ``b''``
when no output was observed.

.. attribute:: stdout

Expand All @@ -202,7 +205,9 @@ underlying :class:`Popen` interface can be used directly.
.. attribute:: stderr

Stderr output of the child process if it was captured by :func:`run`.
Otherwise, ``None``.
Otherwise, ``None``. This is always :class:`bytes` when stderr output
was captured regardless of the ``text=True`` setting. It may remain
``None`` instead of ``b''`` when no stderr output was observed.

.. versionadded:: 3.3

Expand Down

0 comments on commit b05dd79

Please sign in to comment.