Repository navigation
Edit What's New for Python 3.11 #95913
Description
Activity
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- module: zipfile
CC: @tiran @iritkatriel @asvetlov @ambv as you were involved in some of the changes (and the dev in residence for awareness).
Reacted by Christian Heimes@jaraco should pdb.ScriptTarget pdb.ModuleTarget be documented? I think they were intended to be 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, 2022 - added a commit that references this issue
on Aug 18, 2022 130 remaining items
Is there anything left for this issue? I think it can be closed.
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.
- added a commit that references this issue
on Sep 22, 2023 - added a commit that references this issue
on Sep 23, 2023 @CAM-Gerlach, can we close this?
I think it's time, 3.11 is now security-only.
Reacted by Gregory P. Smith
Metadata
Metadata
Assignees
Projects
- Status
As 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
!in C domain ref target syntax #97740Edit Sections
Enum.__str__change could be improved in What's New #98250Add new APIs
Adapted and updated from @pablogsal 's post
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_eventsadded: ['BaseProactorEventLoop.sock_recvfrom_into', 'BaseProactorEventLoop.sock_recvfrom', 'BaseProactorEventLoop.sock_sendto']
(Already added; will be improved in editing phase)
added: ['Runner']
GH-95913: Update what's new in 3.11 for asyncio #97806
module: asyncio.selector_eventsadded: ['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.sslprotoadded: ['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)
added: ['Task.cancelling', 'Task.uncancel']
GH-95913: Update what's new in 3.11 for asyncio #97806
module: asyncio.windows_eventsadded: ['IocpProactor.recvfrom_into']
(Appears to be undocumented implementation detail of the added socket methods)
added: ['chdir']
bpo-25625: Document contextlib.chdir in the 3.11 what's new #95962
added: ['global_enum_repr', 'global_str', 'show_flag_values', 'global_flag_repr']
(Not documented yet, and
ReprEnumandglobal_enummentioned 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
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
added: ['FrameInfo']
Already discussed, just not explicitly referenced
gh-95913: Copyedit & xref FrameInfo in Whatsnew inspect section #98304
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: pdbadded: ['ScriptTarget', 'ModuleTarget']
(Made private)
gh-95913: make the new internal classes pdb.ModuleTarget/ScriptTarget private #96053
added: ['Template.is_valid', 'Template.get_identifiers']
gh-95913 Add string section to Whatsnew with new Template methods #98311
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
added: ['TracebackException.print', 'StackSummary.format_frame_summary']
gh-95913: Add traceback module additions to what's new in 3.11 #95980
added: ['Path.suffix', 'Path.stem', 'Path.suffixes', 'ZipFile.mkdir']
gh-95913: Edit zipfile Whatsnew section & add new APIs #98314
Related
Linked PRs