summaryrefslogtreecommitdiffstats
path: root/Doc/library
Commit message (Collapse)AuthorAgeFilesLines
* Python 3.13.4v3.13.4Thomas Wouters2025-06-035-7/+7
|
* [3.13] gh-135034: Normalize link targets in tarfile, add ↵T. Wouters2025-06-032-3/+49
| | | | | | | | | | | | | | `os.path.realpath(strict='allow_missing')` (GH-135037) (GH-135064) Addresses CVEs 2024-12718, 2025-4138, 2025-4330, and 2025-4517. (cherry picked from commit 3612d8f51741b11f36f8fb0494d79086bac9390a) Co-authored-by: Łukasz Langa <lukasz@langa.pl> Signed-off-by: Łukasz Langa <lukasz@langa.pl> Co-authored-by: Petr Viktorin <encukou@gmail.com> Co-authored-by: Seth Michael Larson <seth@python.org> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* [3.13] gh-74232: Add a note about roundtrip of non-float numerics in CSV ↵Miss Islington (bot)2025-06-021-2/+8
| | | | | | | (GH-134963) (GH-135049) (cherry picked from commit e814f43f2c655b931af8ee9e1c128bd1027549fb) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* [3.13] gh-122153: indicate that Windows does not support ↵Bénédikt Tran2025-06-021-3/+3
| | | | | | | | `socket.{send,recv}_fds` (GH-134960) (#135017) This amends commit e3b6ff19aaa318a813130ba9ad2ab0a332f27feb. (cherry picked from commit 128195e12eb6d5b9542558453df7045dd7aa1e15) Co-authored-by: GalaxySnail <me@glxys.nl>
* [3.13] gh-133503: clarify `compileall -s/-p` docs (GH-134756) (#134996)Miss Islington (bot)2025-06-011-3/+10
| | | | | | | gh-133503: clarify `compileall -s/-p` docs (GH-134756) (cherry picked from commit fe6f8a3619242b287a793a5b5d8645f402482c71) Co-authored-by: Rihaan Meher <meherrihaan@gmail.com> Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
* [3.13] gh-134918: Fix and improve doctest's documentation (GH-134919) ↵Miss Islington (bot)2025-05-311-48/+47
| | | | | | | (GH-134967) (cherry picked from commit 3c66e5976669a599adfb260514c03815b1a9e4e9) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* [3.13] GH-106235: Clarify `parse_known_args` documentation by removing ↵Miss Islington (bot)2025-05-301-6/+9
| | | | | | | | "remaining" (GH-126921) (#134914) GH-106235: Clarify `parse_known_args` documentation by removing "remaining" (GH-126921) (cherry picked from commit a4251411a97304ab001721c6231d86ddf4eac3f0) Co-authored-by: Savannah Bailey <savannahostrowski@gmail.com>
* [3.13] gh-134733: Fix documentation for the show_empty option of ast.dump() ↵Miss Islington (bot)2025-05-301-2/+3
| | | | | | | | (GH-134925) (GH-134941) Optional None values are always omitted. (cherry picked from commit 1a89991d2362867a9127e151376135615bc92a4c) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* [3.13] ast docs: Fix description of ast.Constant (GH-134741) (#134912)Miss Islington (bot)2025-05-301-3/+3
| | | | | | | | | | | Contrary to the current docs, ast.Constant will never hold containers such as frozenset or tuple; the Python parser only emits it for simple literals. For precision, add the exact list of types that may be contained in an ast.Constant. (cherry picked from commit 381020d41fb1f8b33421f01c609ba0d0edb99764) Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* [3.13] gh-69011: : clarify & deduplicate `ctypes.create_*_buffer` docs ↵Miss Islington (bot)2025-05-291-16/+36
| | | | | | | | | (GH-132858) (GH-134882) This adds a warning about the possibly-missing NUL terminator, but in a way that doesn't make it sound like a bug/wart. (cherry picked from commit b783e1791b2076ef560104f8207156d75859c0a6) Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
* [3.13] gh-134817: Document [Timed]RotatingFileHandler shouldRollover method ↵Miss Islington (bot)2025-05-281-1/+9
| | | | | (GH-134818) (GH-134824) (cherry picked from commit 7be5916f6dc3db95744b5fec945327d82cce0183)
* [3.13] Update outdated statement from `math` about C standard (GH-134621) ↵Miss Islington (bot)2025-05-281-2/+2
| | | | | | | | | (#134826) Update outdated statement from `math` about C standard (GH-134621) (cherry picked from commit 21672b694bd1786bad6eb71a9eff89291a91554b) Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
* [3.13] gh-134789: Document del s[i] operation for mutable sequences ↵Miss Islington (bot)2025-05-271-0/+2
| | | | | | | | | | | | | | (GH-134804) (#134809) gh-134789: Document del s[i] operation for mutable sequences (GH-134804) [main] Update stdtypes.rst - Added explicit mention of `del s[i]` (item deletion by index) to the Mutable Sequence Types section. - Clarified that this operation removes the item at the specified index from the sequence. - Addresses issue GH-134789. (cherry picked from commit 967f361993c9c97eb3ff3076a409b78ea32938df) Co-authored-by: Rishabh Singh <67859818+rishabh11336@users.noreply.github.com>
* [3.13] gh-134664: document `cleanup_socket` parameter in ↵Miss Islington (bot)2025-05-271-1/+8
| | | | | | | | `asyncio.start_unix_server` (GH-134750) (#134780) gh-134664: document `cleanup_socket` parameter in `asyncio.start_unix_server` (GH-134750) (cherry picked from commit 92ea1eb38ff97ac046a0031d505c30a51f58a43f) Co-authored-by: Shamil <ashm.tech@proton.me>
* [3.13] gh-134559: Add versionadded for ``object.__replace__()`` (GH-134672) ↵Miss Islington (bot)2025-05-261-0/+2
| | | | | | | | (#134700) gh-134559: Add versionadded for ``object.__replace__()`` (GH-134672) (cherry picked from commit 71290a6fbe79cef3773a3af6fcf08d8bf15c8460) Co-authored-by: tmlnv <108088921+tmlnv@users.noreply.github.com>
* [3.13] gh-80334: fix multiprocessing.freeze_support for other spawn ↵Miss Islington (bot)2025-05-241-5/+5
| | | | | | | | | | | | | | platforms (GH-134462) (#134620) gh-80334: fix multiprocessing.freeze_support for other spawn platforms (GH-134462) Doc/library/multiprocessing.rst: freeze_support: Change to specify spawn method instead of platform Have multiprocessing.freeze_support() enable on spawn, not just win32. --------- (cherry picked from commit 80284b5c5eebd0e603c38322f94a97a2853ceeba) Co-authored-by: Eddy Mulyono <eddymul@gmail.com> Co-authored-by: Gregory P. Smith <greg@krypto.org>
* [3.13] gh-106318: Add example for `str.count()` (GH-134519) (#134573)Miss Islington (bot)2025-05-231-2/+12
| | | | Co-authored-by: Blaise Pabon <blaise@gmail.com>
* [3.13] gh-106318: Add example for `str.center()` (GH-134518) (#134572)Miss Islington (bot)2025-05-231-2/+8
| | | | Co-authored-by: Blaise Pabon <blaise@gmail.com>
* [3.13] Avoid `__file__` in `hashlib` example (GH-134540) (#134550)Miss Islington (bot)2025-05-221-1/+1
| | | | | | Avoid `__file__` in `hashlib` example (GH-134540) (cherry picked from commit 9b292ff0223dab0f999d5c1e13355552fd7cd528) Co-authored-by: Josh Cannon <joshdcannon@gmail.com>
* [3.13] gh-80050: Update BufferedReader.read docs around non-blocking ↵Gregory P. Smith2025-05-211-34/+41
| | | | | | | (GH-130653) (#134445) (cherry picked from commit e1f891414b2329414a6160ed246f5f869a218bfd) Co-authored-by: Cody Maloney <cmaloney@users.noreply.github.com>
* [3.13] gh-110631: Fix some incorrect indents in the documentation ↵Miss Islington (bot)2025-05-214-69/+69
| | | | | | (GH-129312) (#134420) Co-authored-by: Yuki Kobayashi <drsuaimqjgar@gmail.com>
* [3.13] gh-85045: clarified that the underlying buffer of a TextIOBase can be ↵Miss Islington (bot)2025-05-201-3/+4
| | | | | | | | | | a RawIOBase (GH-134372) (#134375) gh-85045: clarified that the underlying buffer of a TextIOBase can be a RawIOBase (GH-134372) Added a clarification that the underlying binary buffer of a TextIOBase can be a BufferedIOBase OR a RawIOBase (cherry picked from commit 36eb711d2f26849214774a017fe8c8a5be3eec30) Co-authored-by: Alex Kautz <alex@takemobi.com>
* [3.13] gh-101100: Fix Sphinx warnings in `library/decimal.rst` (GH-134303) ↵Hugo van Kemenade2025-05-201-30/+42
| | | | | | (#134339) Co-authored-by: Yuki Kobayashi <drsuaimqjgar@gmail.com>
* [3.13] gh-53189: Document peculiarities of InteractiveConsole in relation to ↵Miss Islington (bot)2025-05-201-0/+6
| | | | | | | | | | pickle (GH-123069) (GH-134329) gh-53189: Document peculiarities of InteractiveConsole in relation to pickle (GH-123069) (cherry picked from commit a31bbc951a9d74cd7b9092555c101e51a2b9482b) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com> Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* [3.13] gh-134201: Expand explanation of Base85 encodings in base64 docs ↵Miss Islington (bot)2025-05-201-11/+37
| | | | | | | | | | | | | (GH-134288) (#134297) gh-134201: Expand explanation of Base85 encodings in base64 docs (GH-134288) Explain history of de-facto standard and how to pick between the two Base-85 encoding functions in the base-64 module. --------- (cherry picked from commit 66aaad61037785639aec393be7618cb54b1372dc) Co-authored-by: Alek Binion <aleksander.binion@gmail.com> Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
* [3.13] gh-122055: Clarify documentation for empty matches in RE (GH-133169) ↵Miss Islington (bot)2025-05-191-7/+9
| | | | | | | (GH-134218) (cherry picked from commit 44b73d3cd4466e148460883acf4494124eae8c91) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* [3.13] gh-133745: Fix asyncio task factory name/context kwarg breaks (#133948)Thomas Grainger2025-05-181-1/+20
| | | | | | | | | In 3.13.3 we accidentally broke the interface for custom task factory. Factory authors added workarounds. This PR (for 3.13.4) unbreaks task factories that haven't made a workaround yet while also supporting those that have. NOTE: The custom task factory API will change to what we accidentally released in 3.13.3. Co-authored-by: Kumar Aditya <kumaraditya@python.org> Co-authored-by: Guido van Rossum <gvanrossum@gmail.com>
* [3.13] gh-134150: Clarify distinction between JSON and Python objects ↵Miss Islington (bot)2025-05-181-5/+10
| | | | | | | | | | | | | | (GH-134154) (#134167) gh-134150: Clarify distinction between JSON and Python objects (GH-134154) * gh-134150: Clarify distinction between JSON objects and Python objects in json module docs * Revert change to JSON introduction * Clarify occurrences of "object literal" as JSON (cherry picked from commit fa4e088668d4a41f9be5babe7edd5409290ee92a) Co-authored-by: Micha Albert <micha@2231puppy.tech>
* [3.13] Docs: fix spelling of "test case" in `unittest` documentation ↵Miss Islington (bot)2025-05-171-1/+1
| | | | | | | | (GH-134137) (#134139) Docs: fix spelling of "test case" in `unittest` documentation (GH-134137) (cherry picked from commit b41d79c776af4bfa5d28fc2036c9137978294b6a) Co-authored-by: Clifford Gama <53076065+cliff688@users.noreply.github.com>
* [3.13] gh-117026: Remove outdated sentence in SimpleHTTPRequestHandler docs ↵Miss Islington (bot)2025-05-161-2/+1
| | | | | | | | (GH-117027) (GH-134108) The code was changed in 0f7cddc308b297e6a1c2dd61503acea38401656f (bpo-839496/gh-39531). (cherry picked from commit ea2d707bd59963bd4f53407108026930ff12ae56) Co-authored-by: Saleh Dehqanpour <salehdeh76@gmail.com>
* [3.13] gh-133286: add explanation about `seq` for pathlib Pattern Language ↵Miss Islington (bot)2025-05-161-2/+5
| | | | | | | | (GH-133340) (#134106) gh-133286: add explanation about `seq` for pathlib Pattern Language (GH-133340) (cherry picked from commit ac8df4b5892d2e4bd99731e7d87223a35c238f81) Co-authored-by: alexey semenyuk <alexsemenyuk88@gmail.com>
* [3.13] gh-133515: fix docs for unawaited coroutines in debug mode ↵Miss Islington (bot)2025-05-161-4/+0
| | | | | | | | (GH-134081) (#134094) gh-133515: fix docs for unawaited coroutines in debug mode (GH-134081) (cherry picked from commit d94b1e9cac82143048031530e6c51e59f597bccd) Co-authored-by: Kumar Aditya <kumaraditya@python.org>
* [3.13] gh-124210: Add introduction to `threading` docs (GH-127046) (#134091)Miss Islington (bot)2025-05-161-25/+89
| | | | | Co-authored-by: Semyon Moroz <donbarbos@proton.me> Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
* [3.13] gh-133986: Document string split algorithm when sep is None and ↵Miss Islington (bot)2025-05-151-0/+12
| | | | | | | | | | | maxsplit is 0 (GH-133987) (#133992) gh-133986: Document string split algorithm when sep is None and maxsplit is 0 (GH-133987) --------- (cherry picked from commit 3e23047363f384b7254b7af51afe4e353be94167) Co-authored-by: Joey Smith <joeysmith@gmail.com> Co-authored-by: Ned Batchelder <ned@nedbatchelder.com> Co-authored-by: Semyon Moroz <donbarbos@proton.me>
* [3.13] gh-133413: Fix references to removed Request.has_data (GH-133414) ↵Miss Islington (bot)2025-05-122-4/+4
| | | | | | | | | (GH-133946) The has_data() method of http.request.Request was removed in version 3.4. (cherry picked from commit 86c1d439e0ccbe6baeda69322f1f8c0e6a80464c) Co-authored-by: ppaez <pp@pp.com.mx>
* [3.13] gh-133904: Fix `math.factorial` documentation (GH-133907) (#133922)mkaraev2025-05-121-2/+1
| | | | | | | * [3.13] gh-133904: Fix `math.factorial` documentation (GH-133907) (cherry picked from commit 27ed64575d34f04029ba1d353810f3db4f4f045b) Co-authored-by: mkaraev <maruf.karaev97@gmail.com> Co-authored-by: sobolevn <mail@sobolevn.me>
* [3.13] gh-132642: document how to render human-readable `timedelta` objects ↵Miss Islington (bot)2025-05-101-0/+16
| | | | | | | | (GH-133825) (#133836) gh-132642: document how to render human-readable `timedelta` objects (GH-133825) (cherry picked from commit efcc42ba70fb09333a2be16401da731662e2984b) Co-authored-by: Kentaro Jay Takahashi <64148935+KentaroJay@users.noreply.github.com>
* [3.13] gh-132971: Update shutil.which() docs (GH-133067) (#133804)Miss Islington (bot)2025-05-101-0/+4
| | | | | | gh-132971: Update shutil.which() docs (GH-133067) (cherry picked from commit d13d5fdf610a294a6c3dc125e0856fb7fdd41e49) Co-authored-by: Kokona <125976684+985025074@users.noreply.github.com>
* [3.13] Docs: use boolean constants for returning boolean value (GH-133325) ↵Miss Islington (bot)2025-05-092-2/+2
| | | | | | | (GH-133761) (cherry picked from commit 076004ae5461cf3a7fe248a38e28afff33acdd14) Co-authored-by: Yongzi Li <1538321957@qq.com>
* [3.13] gh-133361: move the explanation of dict equal before its use ↵Miss Islington (bot)2025-05-071-27/+28
| | | | | | | | | | | | (GH-133424) (#133621) gh-133361: move the explanation of dict equal before its use (GH-133424) Also move up the explanation of insertion order preservation. Both paragraphs seemed out of place down where they were. --------- (cherry picked from commit 61ac88c06e0286cfc6465a47552d41b7dd7e083e) Co-authored-by: Yongzi Li <1538321957@qq.com> Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* [3.13] gh-131535: Fix stale example in html.parser docs, make examples ↵Miss Islington (bot)2025-05-071-14/+37
| | | | | | | doctests (GH-131551) (GH-133587) (cherry picked from commit ee76e36d76a0e6916c0afc41228b043ab5174685) Co-authored-by: Brian Schubert <brianm.schubert@gmail.com>
* [3.13] gh-130117: Document why nested `Union`, `Literal`, and `Annotated` ↵Miss Islington (bot)2025-05-061-0/+40
| | | | | | | | | | types referenced through a type alias are not flattened (GH-130119) (#133488) gh-130117: Document why nested `Union`, `Literal`, and `Annotated` types referenced through a type alias are not flattened (GH-130119) (cherry picked from commit b936ccdb6f6bd11250b4e638b6fa2c239907ca58) Co-authored-by: Valentin Berlier <berlier.v@gmail.com> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* [3.13] gh-107006: Move `threading.local` docstring to docs (GH-131840) (#133432)Miss Islington (bot)2025-05-051-9/+118
| | | | | Co-authored-by: Lysandros Nikolaou <lisandrosnik@gmail.com> Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
* [3.13] gh-133089: Use original timeout value for `TimeoutExpired` when the ↵Miss Islington (bot)2025-05-051-0/+18
| | | | | | | | | | func `subprocess.run` is called with a timeout (GH-133103) (#133418) gh-133089: Use original timeout value for `TimeoutExpired` when the func `subprocess.run` is called with a timeout (GH-133103) (cherry picked from commit 2bbcaedb75942389dacb51866948f40de5951c9c) Signed-off-by: Manjusaka <me@manjusaka.me> Co-authored-by: Nadeshiko Manju <me@manjusaka.me> Co-authored-by: Gregory P. Smith <greg@krypto.org>
* [3.13] gh-130160: use `.. program::` directive for documenting `platform` ↵Hugo van Kemenade2025-05-032-9/+38
| | | | | | CLI (GH-133335) (#133341) Co-authored-by: Semyon Moroz <donbarbos@proton.me>
* gh-91156: Document how TextIOWrapper interacts with UTF-8 mode (GH-132885)Miss Islington (bot)2025-05-031-1/+2
| | | | | | Document how TextIOWrapper interacts with UTF-8 mode (cherry picked from commit 245cd6c53278006fa34fd7799d32f0884eb7e75d) Co-authored-by: Malcolm Smith <smith@chaquo.com>
* [3.13] Docs: delete title links in `turtle.rst` and `typing.rst` (GH-133283) ↵Miss Islington (bot)2025-05-022-6/+6
| | | | | | | (#133293) Co-authored-by: Yongzi Li <1538321957@qq.com> Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.13] Apply 'mod' role to typing module (GH-133201) (#133217)Miss Islington (bot)2025-04-301-5/+5
| | | | | | | Apply 'mod' role to typing module (GH-133201) (cherry picked from commit 2b67db7ce3d73c9ad905125f9a602657afe9be9f) Co-authored-by: Rafael Fontenelle <rffontenelle@users.noreply.github.com> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.13] gh-132726: Change the heading of `sysconfig` CLI section (GH-133035) ↵Miss Islington (bot)2025-04-281-2/+3
| | | | | | (#133088) Co-authored-by: Semyon Moroz <donbarbos@proton.me>
* [3.13] gh-133033: Add docs for `TypeIgnore` (GH-133034) (#133078)Miss Islington (bot)2025-04-281-0/+37
| | | | | | | gh-133033: Add docs for `TypeIgnore` (GH-133034) (cherry picked from commit 4e04511cb9c176c32d6f3694f426750d710121cd) Co-authored-by: Yuki Kobayashi <drsuaimqjgar@gmail.com> Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>