GeezerVison is showing github.com — Edit What's New for Python 3.11 · Issue #95913 · python/cpython
Edit What's New for Python 3.11 #95913DescriptionAs discussed with @pablogsal , this is a meta-issue for coordinating an editing pass on the What's New in Python 3.11 document.
The focus with this issue and its accompanying PRs will be on textual and reST/Sphinx fixes and improvements to the existing content, rather than adding any missing NEWS entries, or touching the organization of the document itself. Another issue, #95914 , will cover adding the PEPs not currently listed to the Summary - Release highlights section, as well as a few PEPs that are not documented at all in What's New, but probably should be somewhere (PEP-624, PEP-654 and PEP-670).
It seems best to split this into separate PRs, one for each top-level section. I've listed them here for reference, with PRs linked as they are submitted:
Prerequisites/General Changes
Edit Sections
- Summary
- New Features
- New Features related to Type Hints
- Other Language Changes
- Other CPython Implementation Changes
- New Modules
- Improved Modules
- Optimizations
- Faster CPython
- CPython bytecode changes
- Deprecated
- Pending Removal in Python 3.12
- Removed
- Porting to Python 3.11
- Build Changes
- C API Changes
Add new APIs
Adapted and updated from @pablogsal 's post
- module: asyncio.exceptions
added: ['BrokenBarrierError']
(Already implicitly referred to by Barrier mention, but will be linked directly in editing pass)
GH-95913: Update what's new in 3.11 for asyncio #97806
-
module: asyncio.proactor_events
added: ['BaseProactorEventLoop.sock_recvfrom_into', 'BaseProactorEventLoop.sock_recvfrom', 'BaseProactorEventLoop.sock_sendto']
(Already added; will be improved in editing phase)
- module: asyncio.runners
added: ['Runner']
GH-95913: Update what's new in 3.11 for asyncio #97806
-
module: asyncio.selector_events
added: ['BaseSelectorEventLoop.sock_recvfrom_into', 'BaseSelectorEventLoop.sock_recvfrom', 'BaseSelectorEventLoop.sock_sendto']
(Already added; will be improved in editing phase)
GH-95913: Update what's new in 3.11 for asyncio #97806
-
module: asyncio.sslproto
added: ['SSLProtocolState', 'AppProtocolState', 'add_flowcontrol_defaults', 'SSLProtocol.get_buffer', 'SSLProtocol.buffer_updated']
(Considered implementation details, so @kumaraditya303 says no need to be documented (indeed, I don't see it documented anywhere else but the changelog)
- module: asyncio.tasks
added: ['Task.cancelling', 'Task.uncancel']
GH-95913: Update what's new in 3.11 for asyncio #97806
-
module: asyncio.windows_events
added: ['IocpProactor.recvfrom_into']
(Appears to be undocumented implementation detail of the added socket methods)
- module: contextlib
added: ['chdir']
bpo-25625: Document contextlib.chdir in the 3.11 what's new #95962
- module: enum
added: ['global_enum_repr', 'global_str', 'show_flag_values', 'global_flag_repr']
(Not documented yet, andReprEnum and global_enum mentioned in What's New aren't either)
Document new 3.11 enum APIs (ReprEnum, global_* and/or show_flag_values) #98298
gh-98298: [Enum] document ReprEnum, global_enum, and show_flag_values #98455
- module: hashlib
added: ['file_digest']
gh-89313: Add hashlib.file_digest to whatsnew 3.11 #95965
gh-95913: Add traceback module additions to what's new in 3.11 #95980
- module: inspect
added: ['FrameInfo']
Already discussed, just not explicitly referenced
gh-95913: Copyedit & xref FrameInfo in Whatsnew inspect section #98304
- module: logging.handlers
added: ['SysLogHandler.createSocket']
(Not documented yet; seems like it should be?)
Logging: SysLogHandler.createSocket added in 3.11 but not documented #98307
gh-98307: Add docstring and documentation for SysLogHandler.createSocket (GH-98319) #98319
gh-95913: Add WhatsNew section for new logging APIs #98320
-
module: pdb
added: ['ScriptTarget', 'ModuleTarget']
(Made private)
gh-95913: make the new internal classes pdb.ModuleTarget/ScriptTarget private #96053
- module: string
added: ['Template.is_valid', 'Template.get_identifiers']
gh-95913 Add string section to Whatsnew with new Template methods #98311
- module: tempfile
added: ['SpooledTemporaryFile.detach', 'SpooledTemporaryFile.read1', 'SpooledTemporaryFile.writable', 'SpooledTemporaryFile.readinto1', 'SpooledTemporaryFile.seekable', 'SpooledTemporaryFile.readable', 'SpooledTemporaryFile.readinto']
gh-95913: Add io support for SpooledTemporaryFile in Whatsnew #98312
gh-95913: Fix grammar for SpooledTemporaryFile 3.11 whatsnew entry #98604
- module: traceback
added: ['TracebackException.print', 'StackSummary.format_frame_summary']
gh-95913: Add traceback module additions to what's new in 3.11 #95980
- module: zipfile
added: ['Path.suffix', 'Path.stem', 'Path.suffixes', 'ZipFile.mkdir']
gh-95913: Edit zipfile Whatsnew section & add new APIs #98314
Related
Linked PRs
Activitypablogsal commented on Aug 13, 2022 The following functions has been added in 3.11 and must be (maybe) documented as well:
- module: zipfile
added: ['Path.suffix', 'Path.stem', 'Path.suffixes', 'ZipFile.mkdir']
- module: tempfile
added: ['SpooledTemporaryFile.detach', 'SpooledTemporaryFile.read1', 'SpooledTemporaryFile.writable', 'SpooledTemporaryFile.readinto1', 'SpooledTemporaryFile.seekable', 'SpooledTemporaryFile.readable', 'SpooledTemporaryFile.readinto']
- module: hashlib
added: ['file_digest']
- module: traceback
added: ['TracebackException.print', 'StackSummary.format_frame_summary']
- module: pdb
added: ['ScriptTarget', 'ModuleTarget']
- module: inspect
added: ['FrameInfo']
- module: contextlib
added: ['chdir']
- module: string
added: ['Template.is_valid', 'Template.get_identifiers']
- module: enum
added: ['global_enum_repr', 'global_str', 'show_flag_values', 'global_flag_repr']
- module: asyncio.tasks
added: ['Task.cancelling', 'Task.uncancel']
- module: asyncio.selector_events
added: ['BaseSelectorEventLoop.sock_recvfrom_into', 'BaseSelectorEventLoop.sock_recvfrom', 'BaseSelectorEventLoop.sock_sendto']
- module: asyncio.proactor_events
added: ['BaseProactorEventLoop.sock_recvfrom_into', 'BaseProactorEventLoop.sock_recvfrom', 'BaseProactorEventLoop.sock_sendto']
- module: asyncio.sslproto
added: ['SSLProtocolState', 'AppProtocolState', 'add_flowcontrol_defaults', 'SSLProtocol.get_buffer', 'SSLProtocol.buffer_updated']
- module: asyncio.runners
added: ['Runner']
- module: asyncio.exceptions
added: ['BrokenBarrierError']
- module: asyncio.windows_events
added: ['IocpProactor.recvfrom_into']
- module: logging.handlers
added: ['SysLogHandler.createSocket']
Reacted by C.A.M. Gerlach pablogsal commented on Aug 13, 2022 Reacted by Christian Heimes tiran commented on Aug 13, 2022 hashlib.file_digest is covered by gh-95965.
iritkatriel commented on Aug 14, 2022 @jaraco should pdb.ScriptTarget pdb.ModuleTarget be documented? I think they were intended to be implementation details. jaraco commented on Aug 14, 2022
@jaraco should pdb.ScriptTarget pdb.ModuleTarget be documented? I think they were intended to be implementation details.
Correct. Those are implementation details. changed the title [-]Copyedit/Proofread What's New for Python 3.11[/-] [+]Edit What's New for Python 3.11[/+] on Aug 17, 2022added a commit that references this issue on Aug 18, 2022gh-95913: make the new internal classes pdb.ModuleTarget/ScriptTarget… Fidget-Spinner commented on Apr 30, 2023 Is there anything left for this issue? I think it can be closed. CAM-Gerlach commented on May 15, 2023 Yeah, a couple last things; see my comment above. I hope to get back to it soon-ish especially as I get ready to spin up on 3.12 as well as deploying new automated and semi-automated tooling to keep the What's News and Changelog in sync across branches. erlend-aasland commented on Jan 12, 2024 hugovk commented on Jun 19, 2024 I think it's time, 3.11 is now security-only. Reacted by Gregory P. Smith
MetadataMetadataStatusShow more project fields
DevelopmentNo branches or pull requestsIssue actions
|