GH-109190: Copyedit 3.12 What's New: Deprecations #109766

AA-Turner · 2023-09-22T23:04:02Z

Sorry in advance for the large PR.

The main change here is ensuring that every deprecated API is listed under the "Deprecated" section. Previously, some deprecations were only listed under "Deprecated", some were listed under the "Pending Removal in Python 3.14" subheading, and some were listed under both. This was a confusing state of affairs, and unhelpful to readers. From this PR, the "Pending Removal in Python 3.14" section becomes a short list of APIs pending removal, reflecting the layout of the similar "3.13" and "Future Versions" sections.

A

Issue: What's New in Python 3.12 (copyediting) #109190

📚 Documentation preview 📚: https://cpython-previews--109766.org.readthedocs.build/en/109766/whatsnew/3.12.html#deprecated

AA-Turner · 2023-09-22T23:04:31Z

Doc/whatsnew/3.12.rst

-* The child watcher classes :class:`asyncio.MultiLoopChildWatcher`,
-  :class:`asyncio.FastChildWatcher`, :class:`asyncio.AbstractChildWatcher`
-  and :class:`asyncio.SafeChildWatcher` are deprecated and
-  will be removed in Python 3.14. It is recommended to not manually
-  configure a child watcher as the event loop now uses the best available
-  child watcher for each platform (:class:`asyncio.PidfdChildWatcher`
-  if supported and :class:`asyncio.ThreadedChildWatcher` otherwise).
-  (Contributed by Kumar Aditya in :gh:`94597`.)
-
-* :func:`asyncio.set_child_watcher`, :func:`asyncio.get_child_watcher`,
-  :meth:`asyncio.AbstractEventLoopPolicy.set_child_watcher` and
-  :meth:`asyncio.AbstractEventLoopPolicy.get_child_watcher` are deprecated
-  and will be removed in Python 3.14.


asyncio had two deprecations noted in "Improved Modules", these have been moved

AA-Turner · 2023-09-22T23:05:14Z

Doc/whatsnew/3.12.rst

+* :mod:`argparse`: The *type*, *choices*, and *metavar* parameters
+  of :class:`!argparse.BooleanOptionalAction` are deprecated
+  and will be removed in 3.14.
+  (Contributed by Nikita Sobolev in :gh:`92248`.)


Copied from Pending Removal

AA-Turner · 2023-09-22T23:06:25Z

Doc/whatsnew/3.12.rst

+* :mod:`ast`: The following :mod:`ast` features have been deprecated in documentation since
+  Python 3.8, now cause a :exc:`DeprecationWarning` to be emitted at runtime
+  when they are accessed or used, and will be removed in Python 3.14:
+
+  * :class:`!ast.Num`
+  * :class:`!ast.Str`
+  * :class:`!ast.Bytes`
+  * :class:`!ast.NameConstant`
+  * :class:`!ast.Ellipsis`
+
+  Use :class:`ast.Constant` instead.
+  (Contributed by Serhiy Storchaka in :gh:`90953`.)


Copied from Pending Removal

AA-Turner · 2023-09-22T23:08:15Z

Doc/whatsnew/3.12.rst

+* :mod:`asyncio`:
+
+  * The child watcher classes :class:`asyncio.MultiLoopChildWatcher`,
+    :class:`asyncio.FastChildWatcher`, :class:`asyncio.AbstractChildWatcher`
+    and :class:`asyncio.SafeChildWatcher` are deprecated and
+    will be removed in Python 3.14.
+    (Contributed by Kumar Aditya in :gh:`94597`.)
+
+  * :func:`asyncio.set_child_watcher`, :func:`asyncio.get_child_watcher`,
+    :meth:`asyncio.AbstractEventLoopPolicy.set_child_watcher` and
+    :meth:`asyncio.AbstractEventLoopPolicy.get_child_watcher` are deprecated
+    and will be removed in Python 3.14.
+    (Contributed by Kumar Aditya in :gh:`94597`.)
+
+  * The :meth:`~asyncio.get_event_loop` method of the
+    default event loop policy now emits a :exc:`DeprecationWarning` if there
+    is no current event loop set and it decides to create one.
+    (Contributed by Serhiy Storchaka and Guido van Rossum in :gh:`100160`.)


(1) and (2) copied from Improved Modules, (3) copied from Pending Removal. Note that I've deleted the entry for asyncio.Future.cancel & asyncio.Task.cancel as it was reverted in #97999

AA-Turner · 2023-09-22T23:08:45Z

Doc/whatsnew/3.12.rst

+* :mod:`collections.abc`: Deprecated :class:`collections.abc.ByteString`.
+  Prefer :class:`Sequence` or :class:`collections.abc.Buffer`.
+  For use in typing, prefer a union, like ``bytes | bytearray``, or :class:`collections.abc.Buffer`.
+  (Contributed by Shantanu Jain in :gh:`91896`.)
+


Copied from Pending Removal

AA-Turner · 2023-09-22T23:12:32Z

Doc/whatsnew/3.12.rst

+* The 3-arg signatures (type, value, traceback) of :meth:`coroutine throw()
+  <coroutine.throw>`, :meth:`generator throw() <generator.throw>` and
+  :meth:`async generator throw() <agen.athrow>` are deprecated and


Added explicit titles to avoid the text saying throw(), throw(), and athrow()

AA-Turner · 2023-09-22T23:12:50Z

Doc/whatsnew/3.12.rst

+* Setting ``__package__`` or ``__cached__`` on a module is deprecated,
+  and will cease to be set or taken into consideration by the import system in Python 3.14.
+  (Contributed by Brett Cannon in :gh:`65961`.)


Rephrased from Pending Removal

AA-Turner · 2023-09-22T23:13:13Z

Doc/whatsnew/3.12.rst

@@ -1116,9 +1200,14 @@ Deprecated
 * The bitwise inversion operator (``~``) on bool is deprecated. It will throw an
  error in Python 3.14. Use ``not`` for logical negation of bools instead.
  In the rare case that you really need the bitwise inversion of the underlying
-  ``int``, convert to int explicitly with ``~int(x)``. (Contributed by Tim Hoffmann
+  ``int``, convert to int explicitly: ``~int(x)``. (Contributed by Tim Hoffmann


style -- this is both the conversion and inversion, so don't say "with"

AA-Turner · 2023-09-22T23:13:27Z

Doc/whatsnew/3.12.rst

+* Accessing ``co_lnotab`` on code objects was deprecated in Python 3.10 via :pep:`626`,
+  but it only got a proper :exc:`DeprecationWarning` in 3.12,
+  therefore it will be removed in 3.14.
+  (Contributed by Nikita Sobolev in :gh:`101866`.)


Rephrased from Pending Removal

AA-Turner · 2023-09-22T23:13:44Z

Doc/whatsnew/3.12.rst

+The following APIs have been deprecated
+and will be removed in Python 3.14.


Adapted from the Pending Removal in Python 3.13 summary

# Conflicts: # Doc/whatsnew/3.12.rst

hugovk

Thanks, looks good.

It wasn't modified in this PR, but the sqlite3 bullets are overindented (compare typing), shall we fix them here too?

AA-Turner · 2023-09-26T20:56:10Z

shall we fix them here too?

Might as well; pushed a commit.

A

miss-islington · 2023-09-26T21:24:48Z

Thanks @AA-Turner for the PR, and @hugovk for merging it 🌮🎉.. I'm working now to backport this PR to: 3.12.
🐍🍒⛏🤖

) (cherry picked from commit 87ddfa7) Co-authored-by: Adam Turner <[email protected]>

bedevere-app · 2023-09-26T21:24:59Z

GH-109925 is a backport of this pull request to the 3.12 branch.

…109925) * GH-109190: Copyedit 3.12 What's New: Deprecations (GH-109766) (cherry picked from commit 87ddfa7) Co-authored-by: Adam Turner <[email protected]> * GH-109190: Copyedit 3.12 What's New: Deprecations (``os`` fix) (#109927) Merge the two ``os`` entries (cherry picked from commit 0e28d0f) --------- Co-authored-by: Adam Turner <[email protected]>

Deprecations

6eee117

AA-Turner added the needs backport to 3.12 bug and security fixes label Sep 22, 2023

AA-Turner requested review from ambv and hugovk September 22, 2023 23:04

bedevere-app bot added awaiting review docs Documentation in the Doc dir skip news labels Sep 22, 2023

bedevere-app bot mentioned this pull request Sep 22, 2023

What's New in Python 3.12 (copyediting) #109190

Closed

AA-Turner commented Sep 22, 2023

View reviewed changes

AA-Turner mentioned this pull request Sep 23, 2023

gh-100228: Document the os.fork threads DeprecationWarning. #109767

Merged

AA-Turner added 2 commits September 25, 2023 07:43

Merge branch 'main' into docs/whatsnew/deprecations

2118b1c

# Conflicts: # Doc/whatsnew/3.12.rst

Merge branch 'main' into docs/whatsnew/deprecations

d9f209c

# Conflicts: # Doc/whatsnew/3.12.rst

hugovk approved these changes Sep 26, 2023

View reviewed changes

bedevere-app bot added awaiting core review and removed awaiting review labels Sep 26, 2023

Dedent

d8de59a

hugovk merged commit 87ddfa7 into python:main Sep 26, 2023
16 checks passed

bedevere-app bot removed the awaiting core review label Sep 26, 2023

miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Sep 26, 2023

pythonGH-109190: Copyedit 3.12 What's New: Deprecations (pythonGH-109766

fedcbe1

) (cherry picked from commit 87ddfa7) Co-authored-by: Adam Turner <[email protected]>

bedevere-app bot removed the needs backport to 3.12 bug and security fixes label Sep 26, 2023

AA-Turner mentioned this pull request Sep 26, 2023

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

Merged

csm10495 pushed a commit to csm10495/cpython that referenced this pull request Sep 28, 2023

pythonGH-109190: Copyedit 3.12 What's New: Deprecations (python#109766)

5ca9552

AA-Turner deleted the docs/whatsnew/deprecations branch September 29, 2023 08:16

Glyphack pushed a commit to Glyphack/cpython that referenced this pull request Sep 2, 2024

pythonGH-109190: Copyedit 3.12 What's New: Deprecations (python#109766)

1cefb21

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

GH-109190: Copyedit 3.12 What's New: Deprecations #109766

GH-109190: Copyedit 3.12 What's New: Deprecations #109766

AA-Turner commented Sep 22, 2023 •

edited by hugovk

Loading

AA-Turner Sep 22, 2023

AA-Turner Sep 22, 2023

AA-Turner Sep 22, 2023

AA-Turner Sep 22, 2023

AA-Turner Sep 22, 2023

AA-Turner Sep 22, 2023

AA-Turner Sep 22, 2023

AA-Turner Sep 22, 2023

AA-Turner Sep 22, 2023

AA-Turner Sep 22, 2023

hugovk left a comment

AA-Turner commented Sep 26, 2023

miss-islington commented Sep 26, 2023

bedevere-app bot commented Sep 26, 2023

		The following APIs have been deprecated
		and will be removed in Python 3.14.

GH-109190: Copyedit 3.12 What's New: Deprecations #109766

GH-109190: Copyedit 3.12 What's New: Deprecations #109766

Conversation

AA-Turner commented Sep 22, 2023 • edited by hugovk Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

hugovk left a comment

Choose a reason for hiding this comment

AA-Turner commented Sep 26, 2023

miss-islington commented Sep 26, 2023

bedevere-app bot commented Sep 26, 2023

AA-Turner commented Sep 22, 2023 •

edited by hugovk

Loading