29521 Commits

Author SHA1 Message Date
Serhiy Storchaka 561d1b95b9 [3.13] gh-138907: Support RFC 9309 in robotparser (GH-138908) (GH-149376)
* empty lines are always ignored instead of separating groups
* the "user-agent" line after a rule starts a new group
* groups matching the same user agent are now merged
* the rule with the longest match wins instead of the first matching rule
* in case of equal matches, the “Allow” rule wins over “Disallow”
* special characters “$” and “*” are now supported in rules
* prefer full match for user agent

(cherry picked from commit bc285e5832)
2026-05-04 18:43:03 +00:00
Miss Islington (bot) 3868444600 [3.13] gh-137337: Clarify import statement namespace binding (GH-144607) (GH-149370)
It is not always in the local namespace.
(cherry picked from commit b8ebd078f9)

Co-authored-by: Kit Dallege <xaum.io@gmail.com>
2026-05-04 14:52:02 +00:00
Miss Islington (bot) 76e250189f [3.13] gh-87245: Improve IPv6Address.ipv4_mapped documentation (GH-92572) (#149361)
gh-87245: Improve IPv6Address.ipv4_mapped documentation (GH-92572)

Avoid the phrasing ‘starting with ::FFFF/96’, which is confusing since
it seems to mix a prefix and a range. Instead, make it clear what the
actual range is, and refer to the relevant RFC.

Closes GH-87245.
(cherry picked from commit 7aedd0a6c6)

Co-authored-by: wouter bolsterlee <wouter@bolsterl.ee>
2026-05-04 13:10:17 +00:00
Miss Islington (bot) 6a2f12b031 [3.13] gh-148663: Document that calendar.IllegalMonthError inherits from both ValueError and IndexError (GH-148664) (#148918)
(cherry picked from commit 435be06dd2)

Co-authored-by: Eoin Shaughnessy <45000144+EoinTrial@users.noreply.github.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Stan Ulbrych <stan@python.org>
2026-05-03 17:42:39 +01:00
Miss Islington (bot) e961c00255 [3.13] gh-149267: Document ast.Constant.kind attribute (GH-149268) (#149294)
gh-149267: Document ast.Constant.kind attribute (GH-149268)

The kind attribute of ast.Constant was not mentioned in the
documentation. It is set to 'u' for u-prefixed string literals
and None for all other constants.

---------
(cherry picked from commit 3a1df787e1)

Co-authored-by: Anuj Nitin Bharambe <119653366+anujbharambe@users.noreply.github.com>
Co-authored-by: Anuj Bharambe <anujnitinb@gmail.com>
2026-05-02 20:05:24 +03:00
Miss Islington (bot) b274204657 [3.13] gh-111264: Add a note about untrusted input to tomllib docs (#149226)
(cherry picked from commit 9d41e2a534)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Stan Ulbrych <stan@python.org>
2026-05-02 12:13:57 +01:00
Miss Islington (bot) bed659fa1d [3.13] Fix source link in Doc/howto/descriptor.rst (GH-149215) (#149251)
Co-authored-by: sobolevn <mail@sobolevn.me>
2026-05-01 22:47:58 +03:00
Miss Islington (bot) c38c463c14 [3.13] gh-135944: Add a "Runtime Components" Section to the Execution Model Docs (gh-135945) (#139510)
* gh-135944: Add a "Runtime Components" Section to the Execution Model Docs (gh-135945)

The section provides a brief overview of the Python runtime's execution environment.  It is meant to be implementation agnostic,
(cherry picked from commit 46a1f0a9ff)

Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>

* concurrent.interpreters was added to Python 3.14

---------

Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>
Co-authored-by: T. Wouters <thomas@python.org>
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
Co-authored-by: Victor Stinner <vstinner@python.org>
2026-04-30 10:42:34 +00:00
Miss Islington (bot) 2a64c966af [3.13] gh-149035: Modernize legacy Python patterns in Doc/tutorial/stdlib2.rst (GH-149036) (#149090)
Co-authored-by: ByteFlow <fakeshadow1337@gmail.com>
Co-authored-by: Copilot <copilot@github.com>
2026-04-28 05:16:36 +00:00
Serhiy Storchaka 0fd4fd4496 [3.13] gh-148529: Minor improvements of the struct module documentation (GH-148565) (GH-149072)
* Document that 's' and 'p' accept bytes and bytearray.
* Fix some footnotes.
* Clarify that "string" is a byte string.
* Fix the module docstring.
(cherry picked from commit 3e5a3cb2bd)
2026-04-27 20:22:47 +00:00
Miss Islington (bot) a724c9f6fb [3.13] gh-82665 Mention that HTMLParser.handle_starttag value can be None (GH-134312) (#149038)
gh-82665 Mention that HTMLParser.handle_starttag value can be None (GH-134312)

* Specify boolean attribute behavior in parser

* Tweak wording and example




* Fix backticks

---------
(cherry picked from commit 804c213c89)

Co-authored-by: Micah Najacht <micah.najacht@gmail.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2026-04-27 22:31:35 +08:00
Miss Islington (bot) 9e68f174c2 [3.13] Document that multiprocessing treats local same-user processes as trusted (GH-149001) (#149034)
Document that multiprocessing treats local same-user processes as trusted (GH-149001)

Clarify in the Authentication keys section that the authkey handshake
covers Listener/Client (addressable endpoints) only, not the anonymous
pipes behind Pipe() and Queue, and that isolation between same-user
processes must be arranged at the OS level.
(cherry picked from commit f27e91e372)

Co-authored-by: Gregory P. Smith <68491+gpshead@users.noreply.github.com>
2026-04-27 01:48:39 +00:00
Miss Islington (bot) 7dd784e701 [3.13] gh-142965: Fix Concatenate documentation to reflect valid use cases (GH-143316) (#148900)
The documentation previously stated that Concatenate is only valid
when used as the first argument to Callable, but according to PEP 612,
it can also be used when instantiating user-defined generic classes
with ParamSpec parameters.
(cherry picked from commit 75ff1afcb6)

Co-authored-by: John Seong <39040639+sandole@users.noreply.github.com>
2026-04-22 19:57:40 -07:00
Miss Islington (bot) a52c8cbbf5 [3.13] gh-145194: Fix typing in re tokenizer example (GH-145198) (#148898)
(cherry picked from commit bd7352d807)

Co-authored-by: Vikash Kumar <163628932+Vikash-Kumar-23@users.noreply.github.com>
2026-04-23 02:46:31 +00:00
Miss Islington (bot) df47919a9b [3.13] Docs: Fix some typos in calendar.rst (GH-148756) (GH-148796)
Docs: Fix some typos in `calendar.rst` (GH-148756)
(cherry picked from commit 983c7462d6)

Co-authored-by: Manoj K M <manojkmdev24@gmail.com>
2026-04-20 14:43:55 +00:00
Miss Islington (bot) bef4d84e7f [3.13] gh-148763: Fix paramter name in multiprocessing.connection.send_bytes/recv_bytes_into docs (GH-126603) (#148787)
gh-148763: Fix paramter name in `multiprocessing.connection.send_bytes/recv_bytes_into` docs (GH-126603)
(cherry picked from commit e50acef0b2)


Doc: Fix buf argument name in multiprocessing connection send_bytes

Co-authored-by: Matthew Davis <7035647+mdavis-xyz@users.noreply.github.com>
2026-04-20 00:12:30 +00:00
Miss Islington (bot) 01f7218983 [3.13] gh-148779: Update Briefcase link in android.rst documentation (GH-148777) (#148781)
Use canonical beeware.org URL for link to Briefcase.
(cherry picked from commit 82767780f8)

Co-authored-by: partev <petrosyan@gmail.com>
2026-04-19 21:50:45 +00:00
Miss Islington (bot) 9c2db8144e [3.13] gh-100305: Deemphasize that ast.literal_eval is safe in eval documentation (GH-100326) (#148421)
(cherry picked from commit b3b0cef0c2)

Co-authored-by: Ram Vikram Singh <ramvikrams243@gmail.com>
Co-authored-by: Éric <merwok@netwok.org>
2026-04-15 17:15:31 +01:00
Hugo van Kemenade 1797dcda4e [3.13] Docs: Use bash lexer for http.server CLI commands, not Python (GH-148612) (#148621) 2026-04-15 19:01:04 +03:00
Miss Islington (bot) e76aa128fe [3.13] tiny edit, fix a couple of minor typos in enum and sqlite3 docs (GH-148580) (#148582)
tiny edit, fix a couple of minor typos in enum and sqlite3 docs (GH-148580)

pair of minor doc typo fixes
(cherry picked from commit 236aa0a4e2)

Co-authored-by: Gregory P. Smith <68491+gpshead@users.noreply.github.com>
2026-04-14 17:06:49 -07:00
Miss Islington (bot) cb4b94c74d [3.13] gh-148186: Improve assertCountEqual description in docs. (GH-148463) (#148586)
gh-148186: Improve `assertCountEqual` description in docs. (GH-148463)
(cherry picked from commit 94d42bf5c2)

Co-authored-by: Kliment Lamonov <klimentlamonov@yandex.ru>
2026-04-14 23:45:32 +00:00
Savannah Ostrowski ee34f95dbc [3.13] gh-72406: Document argument ordering in argparse help output (GH-148534) (#148567)
gh-72406: Document argument ordering in argparse help output (#148534)

(cherry picked from commit 4286227308)

Co-authored-by: Santi Hernandez <santi@santihdzs.com>
2026-04-14 17:53:11 +00:00
Miss Islington (bot) f35859bca6 [3.13] Fix "encodings" typo in argparse.FileType documentation (GH-148502) (#148514)
Fix "encodings" typo in argparse.FileType documentation (GH-148502)
(cherry picked from commit 8ecb6b8b0c)

Co-authored-by: Gleb Popov <gvpopov.dev@gmail.com>
2026-04-13 11:34:05 -07:00
Miss Islington (bot) 4830d291e7 [3.13] gh-147965: Add shutdown() to multiprocessing.Queue excluded methods (GH-147970) (#148417)
gh-147965: Add shutdown() to multiprocessing.Queue excluded methods (GH-147970)

The multiprocessing.Queue documentation states it implements all
methods of queue.Queue except task_done() and join(). Since
queue.Queue.shutdown() was added in Python 3.13,
multiprocessing.Queue also does not implement it. Update the docs
to include shutdown() in the list of excluded methods.
(cherry picked from commit 22290ed011)

Co-authored-by: WYSIATI <chester.lee.cold@gmail.com>
2026-04-12 00:52:32 +00:00
Miss Islington (bot) 2f30fcf674 [3.13] gh-148337: Document importlib.resources security model (GH-148340) (#148355)
gh-148337: Document `importlib.resources` security model (GH-148340)
(cherry picked from commit 70b86e7829)

Co-authored-by: Stan Ulbrych <stan@python.org>
2026-04-11 17:10:53 -07:00
Miss Islington (bot) 83cca73a0d [3.13] gh-148091: clarify asyncio.Future.cancel(msg) behaviour (GH-148248) (#148300)
gh-148091: clarify asyncio.Future.cancel(msg) behaviour (GH-148248)
(cherry picked from commit 2acb8d9257)

Co-authored-by: Manoj K M <136242596+manoj-k-m@users.noreply.github.com>
2026-04-09 20:22:59 +05:30
Miss Islington (bot) 88b4c2305e [3.13] gh-148067: Fix typo in asyncio event loop docs: 'signals' -> 'signal' (GH-148073) (#148245)
Co-authored-by: TT <70463940+Herrtian@users.noreply.github.com>
2026-04-09 14:07:54 +00:00
Miss Islington (bot) 8337805ad1 [3.13] gh-106318: Add example for str.swapcase() method (GH-144575) (#148297)
Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
2026-04-09 13:40:28 +00:00
Miss Islington (bot) 0438467b2d [3.13] gh-146646: Document that glob functions suppress OSError (GH-147996) (#148289)
gh-146646: Document that glob functions suppress OSError (GH-147996)
(cherry picked from commit 8000a9de3c)

Co-authored-by: WYSIATI <chester.lee.cold@gmail.com>
2026-04-09 10:51:12 +00:00
Miss Islington (bot) 4002c3a461 [3.13] Minor edit: Four space indent in example (gh-148264) (gh-148266) 2026-04-08 17:56:10 +00:00
Miss Islington (bot) 5af6ce3e7b [3.13] gh-146121: Clarify security model of pkgutil.getdata; revert checks (GH-148197) (#148205)
gh-146121: Clarify security model of pkgutil.getdata; revert checks (GH-148197)

This reverts commit bcdf231946,
and clarifies get_data's security model.

(cherry picked from commit cf59bf7647)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Stan Ulbrych <stan@python.org>
2026-04-07 12:26:51 +02:00
Miss Islington (bot) 9b576f14bf [3.13] Docs: Update "Installing Python modules" (GH-146249) (#148160)
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2026-04-06 11:28:40 +00:00
Miss Islington (bot) b21aa5a6aa [3.13] gh-94632: document the subprocess need for extra_groups=() with user= (GH-148129) (#148131)
gh-94632: document the subprocess need for extra_groups=() with user= (GH-148129)
(cherry picked from commit a1cf4430ed)

Co-authored-by: Gregory P. Smith <68491+gpshead@users.noreply.github.com>
2026-04-05 18:14:03 +00:00
Stan Ulbrych abea3e2861 [3.13] Docs: Standardize documentation authors (GH-148102) (#148106)
(cherry picked from commit 75be902a13)

Co-authored-by: Stan Ulbrych <stan@python.org>
2026-04-04 18:14:37 +00:00
Miss Islington (bot) f5776fdb73 [3.13] Regex HOWTO: invalid string literals result in SyntaxWarning (GH-148092) (#148098)
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2026-04-04 16:19:58 +00:00
Miss Islington (bot) 9ff584503e [3.13] gh-126676: Expand argparse docs for type=bool with warning and alternatives (GH-146435) (#148049)
gh-126676: Expand argparse docs for type=bool with warning and alternatives (GH-146435)
(cherry picked from commit 80d0a85d96)

Co-authored-by: Joshua Swanson <22283299+joshuaswanson@users.noreply.github.com>
Co-authored-by: joshuaswanson <joshuaswanson@users.noreply.github.com>
Co-authored-by: Savannah Ostrowski <savannah@python.org>
2026-04-03 12:10:09 -07:00
Miss Islington (bot) 1a188aa082 [3.13] gh-125895: Fix static asset location for sphinx-notfound-page (GH-147984) (#148041)
(cherry picked from commit 80ab6d958a)

Co-authored-by: Stan Ulbrych <stan@python.org>
2026-04-03 16:40:32 +01:00
Miss Islington (bot) 1e60efd299 [3.13] gh-146907: Clarify ABI compatibility between debug and release builds (GH-146925) (GH-147972)
(cherry picked from commit 03f3b9ade9)

Co-authored-by: konsti <konstin@mailbox.org>
2026-04-03 10:03:09 +02:00
Miss Islington (bot) e43fae7a75 [3.13] gh-142533: Document CRLF injection vulnerabilities in http.server doc (GH-143395) (#148021)
gh-142533: Document CRLF injection vulnerabilities in http.server doc (GH-143395)
(cherry picked from commit 617f4cc1c2)

Co-authored-by: Tadej Magajna <tmagajna@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
2026-04-02 21:33:00 +00:00
Miss Islington (bot) 7aeb66ca9e [3.13] Docs: don't rely on implicit 'above' directions in socket docs (GH-146426) (#146561)
Docs: don't rely on implicit 'above' directions in socket docs (GH-146426)
(cherry picked from commit 3ff582238f)

Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
2026-03-28 05:53:21 -04:00
Miss Islington (bot) b0fab92039 [3.13] Mention _Float16 (type from Annex H of the C23) in the struct docs (GH-146243) (#146530)
Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
2026-03-27 17:44:29 +00:00
Miss Islington (bot) 2bb1ac2162 [3.13] gh-144837: Improve documentation for more collection methods (GH-144841) (GH-146484)
Use uniform standard signature syntax in the tutorial and in
the array and collections modules documentation.
(cherry picked from commit 17070f41d4)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2026-03-26 19:52:07 +00:00
Miss Islington (bot) 7d565d6ae8 [3.13] gh-146318: Document that signal.SIGSTOP is Unix-only (GH-146319) (#146469)
gh-146318: Document that signal.SIGSTOP is Unix-only (GH-146319)
(cherry picked from commit e44993a665)

Co-authored-by: Jonathan Dung <jonathandung@yahoo.com>
2026-03-26 16:49:46 +01:00
Miss Islington (bot) f17ed5e9bf [3.13] gh-74955: Document that __all__ must contain strings in normalization form NFKC (GH-144504) (GH-144520)
(cherry picked from commit c81e1843d4)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2026-03-24 02:01:06 +00:00
Miss Islington (bot) dbe2500e0e [3.13] gh-145305: Update ocert.org URLs in docs from http to https (GH-145304) (GH-145323)
(cherry picked from commit 11eec7a492)

Co-authored-by: indoor47 <indoor47@gmail.com>
Co-authored-by: Adam (indoor47) <adamai@agentmail.to>
2026-03-24 02:51:43 +01:00
Łukasz Langa 14b8655cc3 [3.13] gh-140196: Add constructor behavior changes in ast.rst for python 3.13 (GH-140243) (GH-146354)
(cherry picked from commit fae5761a76)

Co-authored-by: Parman Mohammadalizadeh <prmma23@gmail.com>
2026-03-24 02:49:45 +01:00
T. Wouters 684e7af8cd [3.13] gh-142183: Cache one datachunk per tstate to prevent alloc/dealloc thrashing (GH-145789) (#146123)
* gh-142183: Cache one datachunk per tstate to prevent alloc/dealloc thrashing (GH-145789) (#145828)

Cache one datachunk per tstate to prevent alloc/dealloc thrashing when repeatedly hitting the same call depth at exactly the wrong boundary.

Move new _ts member to the end to not mess up remote debuggers' ideas of the
struct's layout. (The struct is only created by the runtime, and the new
field only used by the runtime, so it should be safe.)

(cherry picked from commit 706fd4ec08)
(cherry picked from commit 19cbcc0f85)
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
2026-03-24 02:27:57 +01:00
Miss Islington (bot) daa4106426 [3.13] docs: fix f-string in ExceptionGroup example (GH-146108) (GH-146127)
(cherry picked from commit 2c6afb935a)

Co-authored-by: Bartosz Grabowski <58475557+bartosz-grabowski@users.noreply.github.com>
2026-03-24 00:08:07 +01:00
Miss Islington (bot) ec8e33b99a [3.13] gh-136672: Docs: Move parts of Enum HOWTO to API Docs (GH-139176) (GH-144803)
To avoid duplicate content in the Enum HOWTO and
API documentation which is not automatically synced,
the section about supported __dunder__ and _sunder
names is moved from HOWTO to API docs.

See also https://github.com/python/cpython/pull/136791
(cherry picked from commit 629a363ddd)

Co-authored-by: Rafael Weingartner-Ortner <38643099+RafaelWO@users.noreply.github.com>
2026-03-23 21:26:01 +01:00
Serhiy Storchaka fab82679d3 [3.13] gh-146056: Fix repr() for lists containing NULLs (GH-146129) (GH-146155) (GH-146271)
(cherry picked from commit 0f2246b155)
(cherry picked from commit 796513306f)

Co-authored-by: Victor Stinner <vstinner@python.org>
2026-03-22 08:06:17 +00:00