Commit graph

14204 commits

Author SHA1 Message Date
Miss Islington (bot)
cde02ae782
[3.14] gh-139283: correctly handle size limit in cursor.fetchmany() (GH-139296) (GH-139441)
Passing a negative or zero size to `cursor.fetchmany()` made it fetch all rows
instead of none.

While this could be considered a security vulnerability, it was decided to treat
this issue as a regular bug as passing a non-sanitized *size* value in the first
place is not recommended.
(cherry picked from commit bc172ee830)

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
2025-10-07 21:23:08 +02:00
Miss Islington (bot)
a868c6a70d
[3.14] gh-136520: Clarify docs for _pack_ & _align_ (GH-137036) (#137381)
gh-136520: Clarify docs for _pack_ & _align_ (GH-137036)

Move docs to the reference section & reduce the “tutorial” part to a quick intro & link.

Clarify what values are accepted.

Add macro/attribute equivalents.

Discourage _align_ values that aren't powers of two.
(cherry picked from commit 8943bb722f)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
2025-10-07 20:39:57 +02:00
Erlend E. Aasland
ebbfd8f51a
[3.14] gh-138736: Fix sqlite3.Connection.blobopen 'row' parameter type and naming (#138738) (GH-139062)
(cherry picked from commit 8eb106240f)

Co-authored-by: chiri <chirizxc@proton.me>
2025-10-07 20:38:26 +02:00
Miss Islington (bot)
e2c901782d
[3.14] gh-138952: Document platform.machine() output casing inconsistency across platforms (GH-138962) (#139045)
gh-138952:  Document platform.machine() output casing inconsistency across platforms (GH-138962)
(cherry picked from commit dd15a2e11e)

Co-authored-by: Aniket <148300120+Aniketsy@users.noreply.github.com>
Co-authored-by: AN Long <aisk@users.noreply.github.com>
2025-10-07 19:30:21 +01:00
Serhiy Storchaka
700d425564
[3.14] Update the dbm documentation (GH-137919) (#137962)
Unify documentation for all backends, enumerate all not implemented mapping
methods, document particularities of implemented mapping methods.
(cherry picked from commit 8700404f86)
2025-10-07 19:26:00 +01:00
Serhiy Storchaka
b4d8faa221
[3.14] Update the availability info in the resource docs (#137939)
Update the availability info in the resource docs
2025-10-07 19:25:34 +01:00
Miss Islington (bot)
99c1d09016
[3.14] gh-130102: drop "require numeric arguments" from pow() docs (GH-137456) (#137536)
gh-130102: drop "require numeric arguments" from pow() docs (GH-137456)
(cherry picked from commit 37b5a0d671)

Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
Co-authored-by: Senthil Kumaran <senthil@python.org>
2025-10-07 19:25:25 +01:00
Miss Islington (bot)
898be571a2
[3.14] Doc/library/zoneinfo.rst: Fix typo (GH-139190) (#139229)
(cherry picked from commit 4fb338d844)
2025-10-07 19:23:39 +01:00
Miss Islington (bot)
3a880241c6
[3.14] Replace ambiguous word "pound" by "hash" in difflib docs (GH-139601) (GH-139616)
(cherry picked from commit dadbb2662a)

Co-authored-by: George Ogden <38294960+George-Ogden@users.noreply.github.com>
2025-10-07 20:19:50 +02:00
Sergey B Kirpichev
058c2770a2
[3.14] gh-122450: Expand documentation for `Rational and Fraction` (GH-136800) (#137363)
(cherry picked from commit b266fbc9ec)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2025-10-07 19:15:22 +01:00
Miss Islington (bot)
94f57ac206
[3.14] gh-131885: Use positional-only markers for `max() and min()` (GH-131868) (#137656)
gh-131885: Use positional-only markers for ``max()`` and ``min()`` (GH-131868)
(cherry picked from commit dd079db4b9)

Co-authored-by: Evan Kohilas <ekohilas@users.noreply.github.com>
2025-10-07 19:14:40 +01:00
Adam Turner
b1fa3414b3
[3.14] gh-105812: Use the `:deco:` role in place of manual decorator markup (GH-139619) (#139627)
(cherry picked from commit 3195da0b1a)
2025-10-07 19:13:35 +01:00
Miss Islington (bot)
7b203aa2ff
[3.14] gh-136516: Mention installation artifacts as de-facto resources (GH-136419) (#137038)
gh-136516: Mention installation artifacts as de-facto resources (GH-136419)

Files like NUL on windows are, from `importlib.resources` point of
view, an artifact caused by installing to a filesystem directory.
Mention these.
(cherry picked from commit fac4964fdb)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
2025-10-07 23:20:13 +05:30
Miss Islington (bot)
98ca0b3e2b
[3.14] Fix docs for Queue.shutdown (gh-137028) (#137080)
Fix docs for Queue.shutdown (gh-137028)
(cherry picked from commit 245671555b)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
Co-authored-by: Zachary Ware <zach@python.org>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2025-10-07 19:41:03 +02:00
Miss Islington (bot)
08d8dadfc2
[3.14] gh-136278: Document codecs.escape_encode() and codecs.escape_decode() (GH-136314) (#137149)
gh-136278: Document codecs.escape_encode() and codecs.escape_decode() (GH-136314)

Closes GH-136278
(cherry picked from commit 6784ef7da7)

Co-authored-by: Toshaksha <147024929+Toshaksha@users.noreply.github.com>
2025-10-07 19:40:30 +02:00
Miss Islington (bot)
2f96a40ec0
[3.14] gh-138558: Improve description of `Interpolation.expression` (GH-139187) (#139579)
gh-138558: Improve description of ``Interpolation.expression`` (GH-139187)
(cherry picked from commit 880c9526f9)

Co-authored-by: Dave Peck <davepeck@gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-10-05 07:41:43 +03:00
Miss Islington (bot)
8566ee2507
[3.14] gh-138703: clarify data buffer requirement of asyncio.StreamWriter.write (GH-139564) (#139570)
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2025-10-04 16:40:21 +00:00
Miss Islington (bot)
6f2635787b
[3.14] Synced docs and docstring for sysconfig.get_platform (GH-135530) (#138976)
Synced docs and docstring  for `sysconfig.get_platform` (GH-135530)
(cherry picked from commit 01cc53295c)

Co-authored-by: ivan <ivandietert@gmail.com>
Co-authored-by: Mikhail Efimov <efimov.mikhail@gmail.com>
Co-authored-by: Ned Deily <nad@python.org>
Co-authored-by: Filipe Laíns 🇵🇸 <lains@riseup.net>
2025-10-04 17:55:25 +03:00
Miss Islington (bot)
ec97866567
[3.14] GH-123299: Copyedit 3.14 What's New: New and Improved Modules (GH-139530) (#139555)
GH-123299: Copyedit 3.14 What's New: New and Improved Modules (GH-139530)
(cherry picked from commit c33dc154b4)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-10-04 16:45:35 +03:00
Miss Islington (bot)
22c63945c1
[3.14] gh-139495: Fix hashlib.file_digest() versionchanged description of BlockingIOError (GH-139496) (#139522)
Co-authored-by: Alex Willmer <alex@moreati.org.uk>
2025-10-03 00:11:58 +03:00
Miss Islington (bot)
a312dd0f1e
[3.14] gh-139487: add missing imports for standalone doctest Enum examples (GH-139488) (#139493)
gh-139487: add missing imports for standalone doctest `Enum` examples (GH-139488)
(cherry picked from commit f3d7faeafa)

Co-authored-by: Peter <35064951+ttw225@users.noreply.github.com>
2025-10-02 17:37:19 +03:00
Miss Islington (bot)
af694375ea
[3.14] GH-123299: Copyedit 3.14 What's New: CPython bytecode changes (GH-139402) (#139420)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-09-29 18:55:26 +03:00
Miss Islington (bot)
c82079e0b4
[3.14] gh-135447: Document the `NOT_TAKEN & POP_ITER` bytecode instructions (GH-135803) (#139399)
Co-authored-by: Yongzi Li <204532581+Yzi-Li@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Ken Jin <kenjin4096@gmail.com>
2025-09-28 22:02:33 +03:00
Shantanu
73a575ffea
[3.14] Link to 3.14 GC design docs (#139387) 2025-09-28 14:47:05 +01:00
Bénédikt Tran
4608a300d5
[3.14] gh-138633: synchronize documented signatures of SSL objects with runtime ones (GH-138639, GH-138648) (#138646)
(cherry picked from commit 3255c0c870)
(cherry picked from commit 4ef51fa75c)
2025-09-27 08:12:11 +02:00
Miss Islington (bot)
f2b82b3b3b
[3.14] gh-127502: Fix typo in XML security notes (GH-139335) (#139346)
gh-127502: Fix typo in XML security notes (GH-139335)
(cherry picked from commit 6fa1e552e0)

Co-authored-by: Sebastian Pipping <sebastian@pipping.org>
2025-09-26 13:43:00 +01:00
Karolina Surma
c76fd771b5
[3.14] Fix the reference to unicode specification (#139138) (#139286)
Fix the reference to unicode specification (#139138)

(cherry picked from commit b36dee855d)
2025-09-24 18:11:20 +01:00
Miss Islington (bot)
cf4573b51e
[3.14] gh-138092: Correct the documented signature of `mmap.flush` (GH-138671) (#139202)
gh-138092: Correct the documented signature of ``mmap.flush`` (GH-138671)
(cherry picked from commit e101f907dc)

Co-authored-by: AN Long <aisk@users.noreply.github.com>
2025-09-21 21:24:10 +01:00
Miss Islington (bot)
ccdc0c9992
[3.14] Doc/library/os.rst: Remove spurious parenthesis (GH-139205) (#139217)
`Doc/library/os.rst`: Remove spurious parenthesis (GH-139205)
(cherry picked from commit 9c3d09b984)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-09-21 20:56:06 +01:00
Miss Islington (bot)
665a3495bf
[3.14] gh-118803: Improve documentation around ByteString deprecation (GH-139115) (#139136)
gh-118803: Improve documentation around `ByteString` deprecation (GH-139115)
(cherry picked from commit 4305cc3ef3)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2025-09-18 17:54:43 +00:00
Hugo van Kemenade
1c5b28405a Python 3.14.0rc3 2025-09-18 09:45:38 +01:00
Miss Islington (bot)
a20395b899
[3.14] GH-139067: Add example for argparse's append action (GH-131389) (#139068)
GH-139067: Add example for `argparse`'s `append` action (GH-131389)
(cherry picked from commit 101fd33065)

Co-authored-by: Moshe Kaplan <mosheekaplan@gmail.com>
2025-09-17 23:27:53 +01:00
Miss Islington (bot)
7a2854eb12
[3.14] gh-132558: Improve argparse docs on combining type and choices (GH-133827) (#139057)
gh-132558: Improve `argparse` docs on combining `type` and `choices` (GH-133827)
(cherry picked from commit dd0840bf67)

Co-authored-by: Hans Then <hans.then@gmail.com>
Co-authored-by: Savannah Bailey <savannahostrowski@gmail.com>
2025-09-17 17:19:33 +01:00
Miss Islington (bot)
9d0ca237af
[3.14] gh-137988: Fix const description in argparse.add_argument() docs (GH-138315) (#139051)
Co-authored-by: PrinceNaroliya <naroliyaprince@gmail.com>
Co-authored-by: Savannah Bailey <savannahostrowski@gmail.com>
2025-09-17 18:51:30 +03:00
Miss Islington (bot)
37f8a63e39
[3.14] gh-138514: getpass: restrict echo_char to a single ASCII character (GH-138591) (#138988)
Co-authored-by: Benjamin Johnson <benjohnson2040@gmail.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Brian Schubert <brianm.schubert@gmail.com>
2025-09-17 17:20:45 +03:00
Miss Islington (bot)
ce48f4c845
[3.14] gh-139006: Doc: Clarify html.escape function description (GH-139016) (#139036)
gh-139006: Doc: Clarify html.escape function description (GH-139016)
(cherry picked from commit 81c975bcfc)


Doc: Clarify html.escape function description (GH-139006)

Co-authored-by: PrinceNaroliya <naroliyaprince@gmail.com>
2025-09-17 21:58:17 +08:00
Miss Islington (bot)
82fce8271c
[3.14] gh-138966: Add description for gi_suspended attribute (GH-139008) (#139020)
Co-authored-by: Donghoon Nam <54799053+codenamenam@users.noreply.github.com>
2025-09-17 12:09:15 +03:00
Miss Islington (bot)
7bba99c611
[3.14] Revert "gh-118803: Remove ByteString from typing and collections.abc (GH-118804)" (GH-138990) (#138995)
Revert "gh-118803: Remove `ByteString` from `typing` and `collections.abc` (GH-118804)" (GH-138990)
(cherry picked from commit 530ddd3e06)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2025-09-17 09:08:15 +01:00
Miss Islington (bot)
62294eb4fc
[3.14] gh-54874: Expand unicodedata module documentation (GH-138301) (#138346)
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Alexander Belopolsky <abalkin@users.noreply.github.com>
2025-09-16 16:55:59 +03:00
Miss Islington (bot)
35ce9a2867
[3.14] gh-137985: Correct description of Formatter's datefmt param in logging documentation (GH-138530) (#138565)
Co-authored-by: W. H. Wang <mattwang44@gmail.com>
2025-09-16 16:55:29 +03:00
Miss Islington (bot)
5210e307ae
[3.14] gh-138005: Document that CSV skipinitialspace=True and delimiter=' ' require quotation for empty fields (GH-138006) (#138798)
Co-authored-by: Maurycy Pawłowski-Wieroński <5383+maurycy@users.noreply.github.com>
2025-09-11 15:18:25 +00:00
Miss Islington (bot)
dd930baf45
[3.14] gh-138307: Update the Ellipsis documentation (GH-138306) (#138440)
Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Éric <merwok@netwok.org>
Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
2025-09-11 12:22:37 +03:00
Miss Islington (bot)
4ce4b82d35
[3.14] Docs: Fix typo in shutil.make_archive example (GH-138188) (#138195)
Co-authored-by: Andreas Pelme <andreas@pelme.se>
2025-09-11 12:20:28 +03:00
Miss Islington (bot)
7e0232895a
[3.14] gh-133125: Clarify ZipInfo.date_time attribute documentation (GH-136082) (#138077)
Co-authored-by: Kentaro Jay Takahashi <64148935+KentaroJay@users.noreply.github.com>
Co-authored-by: Emma Smith <emma@emmatyping.dev>
2025-09-11 12:19:35 +03:00
Miss Islington (bot)
34afba4747
[3.14] Fix typo in logging docs (GH-137981) (#137983)
Co-authored-by: Maximilian Linhoff <maximilian.linhoff@cta-observatory.org>
2025-09-11 12:19:05 +03:00
Miss Islington (bot)
30588d5f91
[3.14] [docs] minor, fix grammar in ssl.SSLContect.sslsocket_class docstring (GH-137935) (#137950)
Co-authored-by: PrinceNaroliya <naroliyaprince@gmail.com>
Co-authored-by: Gregory P. Smith <68491+gpshead@users.noreply.github.com>
2025-09-11 12:18:43 +03:00
Miss Islington (bot)
39e024df8e
[3.14] gh-131885: Use positional-only markers for the `decimal` module (GH-131990) (#137902)
Co-authored-by: Semyon Moroz <donbarbos@proton.me>
2025-09-11 12:18:17 +03:00
Miss Islington (bot)
dcadc539fd
[3.14] Mention the "context manager" keyword in concurrent.futures documentation (GH-130976) (#137810)
Co-authored-by: Jakub Stasiak <jakub@stasiak.at>
2025-09-11 12:17:25 +03:00
Miss Islington (bot)
374b242efa
[3.14] gh-87281: Improve documentation for locale.setlocale() and locale.getlocale() (GH-137313) (#137722)
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2025-09-11 12:16:18 +03:00
Miss Islington (bot)
4b093e1796
[3.14] gh-136672: Docs: Move Enum functions and add examples (GH-136791) (#137688)
Co-authored-by: RafaelWO <38643099+RafaelWO@users.noreply.github.com>
Co-authored-by: Ethan Furman <ethan@stoneleaf.us>
2025-09-11 12:15:55 +03:00