https://github.com/python/cpython/commit/3e2c55749326809a2fc76b9f2cb87a6f89037ebe
commit: 3e2c55749326809a2fc76b9f2cb87a6f89037ebe
branch: main
author: Gregory P. Smith <[email protected]>
committer: gpshead <[email protected]>
date: 2025-11-30T18:50:05-08:00
summary:
gh-141473: Document not calling Popen.wait after Popen.communicate times out.
(GH-142101)
Document not calling Popen.wait after Popen.communicate times out.
Closes #141473
files:
M Doc/library/subprocess.rst
diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
index 43da804b62beb1..b8dfcc310771fe 100644
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -846,6 +846,11 @@ Instances of the :class:`Popen` class have the following
methods:
proc.kill()
outs, errs = proc.communicate()
+ After a call to :meth:`~Popen.communicate` raises :exc:`TimeoutExpired`, do
+ not call :meth:`~Popen.wait`. Use an additional :meth:`~Popen.communicate`
+ call to finish handling pipes and populate the :attr:`~Popen.returncode`
+ attribute.
+
.. note::
The data read is buffered in memory, so do not use this method if the
data
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
