Skip to content

Commit

Permalink
gh-87597: Document TimeoutExpired.stdout & .stderr types (GH-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.
(cherry picked from commit b05dd79)

Co-authored-by: Gregory P. Smith <greg@krypto.org>
  • Loading branch information
miss-islington and gpshead committed Sep 30, 2022
1 parent ab2f1a6 commit cdc01ea
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 cdc01ea

Please sign in to comment.