29658 commits

Author	SHA1	Message	Date
Hugo van Kemenade	39ea593cbb	gh-123299: Update 'What's New in Python 3.14' from 3.14 branch (#135616)	2025-06-24 11:08:23 +03:00
Russell Keith-Magee	34393cbdd4	gh-135648: Document that shutil.copyfileobj doesn't flush (#135737) ... Adds a note about flush/close on copyfileobj, and updates the Emscripten build script to follow documented advice.	2025-06-24 08:55:50 +08:00
Vincent Poulailleau	2793b68f75	Fix example according to PEP 750 in "What's new in 3.14" (GH-134727) ... A redundant extra part was written. Added a closing tag, to match the usage in PEP 750.	2025-06-23 19:36:30 -04:00
Yongzi Li	caad163b69	Docs: Use arguments to replace args in argparse.rst (GH-135510)	2025-06-23 18:53:33 -04:00
Petr Viktorin	6aa0826ed7	gh-89488: Add warning about Py_BuildValue("p") needing exact int (GH-135610)	2025-06-23 12:35:59 +02:00
Bénédikt Tran	b57b619e34	gh-135815: skip netrc security checks if os.getuid is missing (#135816)	2025-06-22 19:48:06 +00:00
Rafael Fontenelle	6a16b3c440	Docs: Remove unnecessary trailing backslashes (GH-135781) ... This fixes Sphinx's gettext extraction for translations.	2025-06-21 09:01:14 -04:00
sobolevn	8ca1e4d846	gh-135645: Added supports_isolated_interpreters to sys.implementation (#135667) ... Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>	2025-06-21 10:56:14 +03:00
Marcell Perger	4ddf505d99	gh-135756: Fix nonexistent parameter in tkinter docs (#135770) ... Remove nonexistent color parameter from tkinter.commondialog.Dialog.show() method documentation.	2025-06-20 18:45:36 -04:00
Yuki Kobayashi	59963e866a	Docs: Document PyExceptionClass functions in the C API (GH-135697) ... * Docs: Document `PyExceptionClass_Name` `PyExceptionClass_Name` is an undocumented function in the limited API. * Document `PyExceptionClass_Check`	2025-06-20 09:57:04 -04:00
Weilin Du	b881e3db1e	gh-89083: add links to RFC 9562 sections in UUID docs (#135684) ... We also sync the docs for UUIDv1 and UUIDv6 concerning the node address and clock sequence. --------- Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>	2025-06-20 11:03:41 +00:00
Nadeshiko Manju	1ddfe59320	gh-135543: Emit sys.remote_exec audit event when sys.remote_exec is called (GH-135544)	2025-06-19 21:23:38 +01:00
Rafael Fontenelle	754190287e	Docs: Add missing lines between regex and text (GH-134505)	2025-06-19 11:01:29 -04:00
Andrii Hrimov	7cc8949692	gh-135273: Unify ZoneInfo.from_file signatures (#135274) ... Align `ZoneInfo.from_file` pure-Python signature with Argument Clinic signature.	2025-06-19 16:47:35 +02:00
Rafael Fontenelle	ff639af8ee	Docs: Emphasize parameter name in pkgutil.iter_importers (GH-135597)	2025-06-19 08:56:43 -04:00
Petr Viktorin	140731ff67	Document that PyType_GetModuleByDef returns a borrowed reference (GH-135666)	2025-06-19 09:00:41 +02:00
Eric Snow	725da50520	gh-133485: Use interpreters.Interpreter in InterpreterPoolExecutor (gh-133957) ... Most importantly, this resolves the issues with functions and types defined in __main__. It also expands the number of supported objects and simplifies the implementation.	2025-06-18 17:57:14 -06:00
alexey semenyuk	e9b647dd30	gh-134538: Add link to shutil.rmtree example in function docs (GH-135540)	2025-06-18 22:10:20 +01:00
Yuki Kobayashi	46c60e0d0b	Docs: Fix markups for emphasis (GH-135598) ... The word emphasis character `_` is not supported as sphinx markup, so changed to `*`.	2025-06-18 13:32:43 -04:00
Petr Viktorin	21f3d15534	gh-135676: lexical analysis: Improve section on Numeric literals (GH-134850)	2025-06-18 16:34:18 +02:00
Stan Ulbrych	5f6ab92465	gh-133390: Document SQLITE_KEYWORDS (GH-135659)	2025-06-18 12:56:49 +02:00
Vladyslav Lazoryk	7117002591	gh-135627: Remove documentation for LOAD_CONST_IMMORTAL opcode (GH-135632) ... Remove documentation for LOAD_CONST_IMMORTAL opcode	2025-06-18 10:39:41 +08:00
Hugo van Kemenade	c51f241c97	gh-123299: Add PEP 779 to What's New in Python 3.14 (#135555)	2025-06-17 09:02:35 +03:00
Ned Deily	7c685894cd	gh-119132: Update 'Using Python on macOS' documentation. (#135591) ... Remove `experimental` qualification for free-threading in the document text. Note that images included in the document will be updated later in the release cycle.	2025-06-16 19:35:59 -04:00
Hugo van Kemenade	21bac3aecd	Use replacements to update versions in "Using Python on macOS" (#130400)	2025-06-16 18:07:25 -04:00
Donghee Na	f079979599	gh-119132: Remove "experimental" tag from the CPython free-threading. (gh-135550) ... * gh-119132: Remove "experimental" tag from the CPython free-threading build * Address code review Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> * Add NEWS.d * Regen configure.ac * Update doc * Update * Update * Update * Update Doc/howto/free-threading-python.rst Co-authored-by: Peter Bierma <zintensitydev@gmail.com> * Update ctypes.rst * Update * Update Doc/howto/free-threading-python.rst Co-authored-by: T. Wouters <thomas@python.org> * Apply suggestions from code review Co-authored-by: T. Wouters <thomas@python.org> Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> --------- Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> Co-authored-by: Peter Bierma <zintensitydev@gmail.com> Co-authored-by: T. Wouters <thomas@python.org>	2025-06-16 23:32:52 +09:00
Dan Lenski	60181f4ed0	gh-67022: Document bytes/str inconsistency in email.header.decode_header() and suggest email.headerregistry.HeaderRegistry as a sane alternative (#92900) ... * gh-67022: Document bytes/str inconsistency in email.header.decode_header() This function's possible return types have been surprising and error-prone for the entirety of its Python 3.x history. It can return either: 1. `typing.List[typing.Tuple[bytes, typing.Optional[str]]]` of length >1 2. or `typing.List[typing.Tuple[str, None]]`, of length exactly 1 This means that any user of this function must be prepared to accept either `bytes` or `str` for the first member of the 2-tuples it returns, which is a very surprising behavior in Python 3.x, particularly given that the second member of the tuple is supposed to represent the charset/encoding of the first member. This patch documents the behavior of this function, and adds test cases to demonstrate it. As discussed in bpo-22833, this cannot be changed in a backwards-compatible way, and some users of this function depend precisely on the existing behavior. Add warnings about obsolescence of 'email.header.decode_header' and 'email.header.make_header' functions. Recommend use of `email.headerregistry.HeaderRegistry` instead, as suggested in https://github.com/python/cpython/pull/92900#discussion_r1112472177	2025-06-15 15:29:38 -04:00
Nadeshiko Manju	076f87468a	gh-135361: update documentation for remote_debugger_script audit event (#135362)	2025-06-15 20:49:49 +02:00
Jacob Austin Lincoln	81237fbcf6	gh-65697: Improved error msg for configparser key validation (#135527) ... * Improved error msg for configparser key validation and added note in 3.14 whatsnew * Properly added change to configparser * 📜🤖 Added by blurb_it. --------- Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>	2025-06-15 12:13:19 -04:00
Serhiy Storchaka	8979d3afe3	gh-135171: Update documentation for the generator expression (GH-135351) ... * gh-135171: Update documentation for the generator expression Document that the iterator for the leftmost "for" clause is created immediately. * Update Doc/reference/expressions.rst Co-authored-by: Brian Skinn <brian.skinn@gmail.com> --------- Co-authored-by: Brian Skinn <brian.skinn@gmail.com>	2025-06-14 17:32:44 -07:00
sobolevn	fc413ecb8f	gh-135504: Document LIBZSTD_CFLAGS and LIBZSTD_LIBS config options (#135505)	2025-06-14 16:07:19 +01:00
Pablo Galindo Salgado	028309fb47	gh-135371: Fix asyncio introspection output to include internal coroutine chains (#135436)	2025-06-14 13:48:25 +01:00
Ken Jin	7b15873ed0	gh-135474: Specialize arithmetic only on compact ints (GH-135479) ... Specialize arithmetic only on compact ints. This also makes int operations non-escaping in the JIT and in tier 1.	2025-06-14 17:13:32 +08:00
Blaise Pabon	14c1d093d5	gh-106318: Add example for str.expandtabs() (#134525)	2025-06-13 18:44:21 +03:00
Petr Viktorin	f4bc3a9320	gh-134160: Split extension module init from PyModule docs; emphasize multi-phase init (GH-135126) ... Document behaviour of single-phase init. Call it "legacy". Reorganize PyModule docs. Move PyInit_modulename docs from the tutorial to reference documentation. Move PyMODINIT_FUNC docs from generic macros to the new page. Add doc stubs for `PYTHON_API_VERSION` & `PYTHON_ABI_VERSION` Remove incorrect refcounts.dat entry for `PyModuleDef_Init`. This removes the "Return value: Borrowed reference." note. Instead, note that the function sometimes returns a borrowed reference, sometimes as strong one. (IMO, it's best to not think of `PyModuleDef` as a `PyObject` at all, and act like it can't be reference-counted.) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com> Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>	2025-06-13 16:39:35 +02:00
LamentXU	394d7985da	gh-135244: improve wording of uuid8 docs about CSPRNG (#135433)	2025-06-13 16:06:11 +02:00
Blaise Pabon	eed827ed09	gh-106318: Add example for str.endswith() (#134523) ... Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>	2025-06-13 11:54:16 +00:00
Blaise Pabon	273459562e	gh-106318: Add example for str.encode() (#134520) ... Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>	2025-06-13 11:32:07 +00:00
Sergey B Kirpichev	747d390045	gh-135308: clarify math.issubnormal() description (GH-135324)	2025-06-13 08:30:44 +02:00
Eric Hanchrow	f273fd77d7	doc: Remove what was essentially duplicate wording. (GH-135431)	2025-06-12 18:47:12 +01:00
Petr Viktorin	e7a3c20b92	gh-133390: Support SQL keyword completion for sqlite3 CLI (GH-133393) (GH-135292) ... Co-authored-by: Tan Long <tanloong@foxmail.com>	2025-06-12 16:28:30 +02:00
Victorien	71f5fafdfb	Fix presentation of dataclasses' unsafe_hash default value (#116532) ... Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>	2025-06-11 21:30:33 -04:00
Eric Snow	62143736b6	gh-134939: Add the concurrent.interpreters Module (gh-133958) ... PEP-734 has been accepted (for 3.14). (FTR, I'm opposed to putting this under the concurrent package, but doing so is the SC condition under which the module can land in 3.14.)	2025-06-11 17:35:48 -06:00
Malcolm Smith	b706ff003c	gh-133264: Correct documentation of how Py_Main and Py_RunMain handle SystemExit (#135337)	2025-06-11 17:23:47 +02:00
Erlend E. Aasland	ee7345d507	gh-118928: Amend sqlite3 execute*() deprecation notes (#135163)	2025-06-10 13:24:33 +02:00
Petr Viktorin	28d91d06f1	gh-127833: Reword and expand the Notation section (GH-134443) ... Prepare the docs for using the notation used in the `python.gram` file. If we want to sync the two, the meta-syntax should be the same. Link the Full Grammar docs here; keep only a few extras. Also, remove the distinction between lexical and syntactic rules, except for whitespace handling. With f- and t-strings, the line between the two is blurry. Co-authored-by: Blaise Pabon <blaise@gmail.com> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Lysandros Nikolaou <lisandrosnik@gmail.com> Co-authored-by: Colin Marquardt <cmarqu42@gmail.com>	2025-06-09 15:50:11 +02:00
Wulian233	f90483e13a	gh-135001: Explicitly specify the encoding parameter value of calendar.HTMLCalendar as 'utf-8' (#135002)	2025-06-09 15:40:09 +02:00
Victor Stinner	aaad2e81ce	gh-133968: Update PyUnicodeWriter_WriteASCII() documentation (#135297) ... The function was added to Python 3.14.	2025-06-09 14:47:02 +02:00
Edward Z. Yang	8441b263af	bpo-45210: Document that error indicator may be set in tp_dealloc (#28358) ... Signed-off-by: Edward Z. Yang <ezyang@fb.com> Signed-off-by: Edward Z. Yang <ezyang@meta.com> Co-authored-by: Victor Stinner <vstinner@python.org>	2025-06-09 08:56:32 +00:00
Ezio Melotti	2677dd017a	Use f-strings in csv docs example (#135245)	2025-06-08 15:28:37 -07:00