languages/cpython
languages/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython synced 2024-07-20 17:55:24 +00:00
Code Issues Actions 8 Packages Projects Releases Wiki Activity

gh-85299: Add note warning about entry point guard for asyncio example (#93457)

Browse source
This commit is contained in:
Stanley 2022-10-16 10:04:43 -07:00 committed by GitHub
parent 35fa5d5e7f
commit 79fd6ccdbe
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 9 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
Doc/library/asyncio-eventloop.rst
View file

@ -1253,7 +1253,13 @@ Executing code in thread or process pools
pool, cpu_bound)
print('custom process pool', result)
asyncio.run(main())
if __name__ == '__main__':
asyncio.run(main())
Note that the entry point guard (``if __name__ == '__main__'``)
is required for option 3 due to the peculiarities of :mod:`multiprocessing`,
which is used by :class:`~concurrent.futures.ProcessPoolExecutor`.
See :ref:`Safe importing of main module <multiprocessing-safe-main-import>`.
This method returns a :class:`asyncio.Future` object.

2
Doc/library/multiprocessing.rst
View file

@ -2954,6 +2954,8 @@ Global variables
However, global variables which are just module level constants cause no
problems.
.. _multiprocessing-safe-main-import:
Safe importing of main module
Make sure that the main module can be safely imported by a new Python