GH-109190: Copyedit 3.12 What's New: Deprecations (`os` fix) (#109927)

Merge the two ``os`` entries
This commit is contained in:
Adam Turner 2023-09-27 05:59:42 +01:00 committed by GitHub
parent e721f7a951
commit 0e28d0f7a1
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -1114,12 +1114,6 @@ Deprecated
volume and maintenance burden. volume and maintenance burden.
(Contributed by Raymond Hettinger in :gh:`101588`.) (Contributed by Raymond Hettinger in :gh:`101588`.)
* :mod:`os`: The ``st_ctime`` fields return by :func:`os.stat` and :func:`os.lstat` on
Windows are deprecated. In a future release, they will contain the last
metadata change time, consistent with other platforms. For now, they still
contain the creation time, which is also available in the new ``st_birthtime``
field. (Contributed by Steve Dower in :gh:`99726`.)
* :mod:`multiprocessing`: In Python 3.14, the default :mod:`multiprocessing` * :mod:`multiprocessing`: In Python 3.14, the default :mod:`multiprocessing`
start method will change to a safer one on Linux, BSDs, start method will change to a safer one on Linux, BSDs,
and other non-macOS POSIX platforms where ``'fork'`` is currently and other non-macOS POSIX platforms where ``'fork'`` is currently
@ -1140,15 +1134,23 @@ Deprecated
proper :exc:`DeprecationWarning` in 3.12. Remove them in 3.14. proper :exc:`DeprecationWarning` in 3.12. Remove them in 3.14.
(Contributed by Soumendra Ganguly and Gregory P. Smith in :gh:`85984`.) (Contributed by Soumendra Ganguly and Gregory P. Smith in :gh:`85984`.)
* :mod:`os`: On POSIX platforms, :func:`os.fork` can now raise a * :mod:`os`:
:exc:`DeprecationWarning` when it can detect being called from a
multithreaded process. There has always been a fundamental incompatibility * The ``st_ctime`` fields return by :func:`os.stat` and :func:`os.lstat` on
with the POSIX platform when doing so. Even if such code *appeared* to work. Windows are deprecated. In a future release, they will contain the last
We added the warning to to raise awareness as issues encounted by code doing metadata change time, consistent with other platforms. For now, they still
this are becoming more frequent. See the :func:`os.fork` documentation for contain the creation time, which is also available in the new ``st_birthtime``
more details along with `this discussion on fork being incompatible with threads field. (Contributed by Steve Dower in :gh:`99726`.)
<https://discuss.python.org/t/33555>`_ for *why* we're now surfacing this
longstanding platform compatibility problem to developers. * On POSIX platforms, :func:`os.fork` can now raise a
:exc:`DeprecationWarning` when it can detect being called from a
multithreaded process. There has always been a fundamental incompatibility
with the POSIX platform when doing so. Even if such code *appeared* to work.
We added the warning to to raise awareness as issues encounted by code doing
this are becoming more frequent. See the :func:`os.fork` documentation for
more details along with `this discussion on fork being incompatible with threads
<https://discuss.python.org/t/33555>`_ for *why* we're now surfacing this
longstanding platform compatibility problem to developers.
When this warning appears due to usage of :mod:`multiprocessing` or When this warning appears due to usage of :mod:`multiprocessing` or
:mod:`concurrent.futures` the fix is to use a different :mod:`concurrent.futures` the fix is to use a different