Commit graph

30700 commits

Author SHA1 Message Date
Petr Viktorin
1114d7f7f8
gh-108907: ctypes: Document _type_ codes (GH-145837)
Add `_SimpleCData._type_` docs.

Add type codes to the summary table.

Cross-link `struct`, `array`, and `ctypes`; throw in `numpy` too.
(Anyone wanting to add a code should be aware of those.)

Add `py_object`, and `VARIANT_BOOL` for completeness.
2026-03-23 13:41:38 +01:00
Petr Viktorin
91cd2e5806
gh-146175: Soft-deprecate outdated macros; convert internal usage (GH-146178)
Co-authored-by: Victor Stinner <vstinner@python.org>
2026-03-23 12:42:09 +01:00
Stan Ulbrych
fb8d8d9c9f
Add a warning about untrusted input to configparser docs (#146276) 2026-03-22 19:58:31 -04:00
kangtastic
b4e5bc2164
gh-146192: Add base32 support to binascii (GH-146193)
Add base32 encoder and decoder functions implemented in
C to the binascii module and use them to greatly improve the
performance and reduce the memory usage of the existing
base32 codec functions in the base64 module.
2026-03-22 23:10:28 +02:00
Serhiy Storchaka
3776aba204
Update docs for gh-146056 (GH-146213) 2026-03-22 09:29:04 +02:00
Hugo van Kemenade
83360b5869
Docs: replace all datetime imports with import datetime as dt (#145640) 2026-03-21 18:02:06 +02:00
andreuu-tsai
8a531f89df
gh-138234: clarify returncode behavior for subprocesses created with shell=True (#138536)
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2026-03-21 12:32:28 +00:00
Sergey Miryanov
897fa231a7
GH-100108: Add async generators best practices section (#141885)
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Guido van Rossum <gvanrossum@gmail.com>
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2026-03-21 11:59:15 +00:00
Wulian233
5ad738f8fb
gh-91279: Note SOURCE_DATE_EPOCH support in ZipFile.writestr() doc (#139396)
Co-authored-by: Victor Stinner <vstinner@python.org>
2026-03-20 16:14:25 +00:00
Petr Viktorin
b38127f3d6
gh-145916: Soft-deprecate ctypes.util.find_library (GH-145919)
* Put the "Loading shared libraries" section first
  * Adjust formatting at the end of the section
* In "Finding shared libraries", add more text about what's going on
* Move the stub function doc for find_library into "Finding shared libraries"
  * Also move the sister function, find_msvcrt. That's on the chopping block,
    but not removed now.
2026-03-20 15:00:10 +01:00
Serhiy Storchaka
4507d496b4
gh-145980: Add support for alternative alphabets in the binascii module (GH-145981)
* Add the alphabet parameter in functions b2a_base64(), a2b_base64(),
  b2a_base85(), and a2b_base85().
* And a number of "*_ALPHABET" constants.
* Remove b2a_z85() and a2b_z85().
2026-03-20 13:07:00 +02:00
Sacul
d5b26816d0
gh-145866 : Update JIT contributor list (GH-146170) 2026-03-19 21:40:09 +08:00
Sergey B Kirpichev
52c01864c4
gh-145633: Refine notes on non-IEEE platforms (#145845)
* We don't specify what happens on non-IEEE platforms.
* Use rather PY_LITTLE_ENDIAN to get native endianness.
* Mention that unpack functions don't fail in CPython.
* Mention that PyFloat_Pack8 doesn't fail in CPython.

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
2026-03-19 11:42:25 +00:00
Carlos Sousa
004ce8d97b
gh-137696: Rename 'fort' parameter to 'order' in PyBuffer_* functions (#137866) 2026-03-19 16:54:27 +05:30
Lysandros Nikolaou
580043dfae
gh-145254: Fix formatting of thread safety annotations (#146111)
- Add leading space so that the spacing between the previous annotation
  and the thread safety annotation looks correct.
- Remove trailing period from the link to the thread safety level.
2026-03-19 12:01:24 +01:00
Serhiy Storchaka
becd7a967f
gh-146143: Fix the PyUnicodeWriter_WriteUCS4() signature (GH-146144)
It now accepts a pointer to constant buffer of Py_UCS4.
2026-03-19 08:23:01 +00:00
Serhiy Storchaka
0f2246b155
gh-146056: Fix list.__repr__() for lists containing NULLs (GH-146129)
Co-authored-by: Victor Stinner <vstinner@python.org>
2026-03-19 09:59:48 +02:00
Victor Stinner
656abe3c9a
gh-141510: Document isinstance change for frozendict in What's New (#146107) 2026-03-18 23:09:18 +01:00
Bartosz Grabowski
2c6afb935a
docs: fix f-string in ExceptionGroup example (#146108) 2026-03-18 16:49:15 +00:00
Lysandros Nikolaou
5b25eaec37
gh-142518: Annotate PyList_* C APIs for thread safety (#146109) 2026-03-18 17:42:20 +01:00
Lysandros Nikolaou
847f83ef1c
gh-142518: Add thread safety notes for the buffer protocol (#145911) 2026-03-18 14:18:28 +01:00
Michiel W. Beijen
d42a04c045
GH-60729: Add IEEE format wave audio support (GH-145931)
(this re-applies reverted commit 61f2a1a599,
with a test fix)

Co-authored-by: Lionel Koenig <lionelk@google.com>
2026-03-18 12:46:26 +00:00
Ned Batchelder
4f5e79805e
Docs: a brief note in the sets tutorial about order (#145984)
Docs: a brief note in the sets tut about order
2026-03-17 05:03:11 -04:00
trag1c
4e96282ee4
Docs: remove unmatched parenthesis for asyncio.TaskGroup note (#146035) 2026-03-16 20:55:29 +01:00
Ken Jin
e2e62033aa
gh-139038: Link to Savannah's webpage for JIT results (#146013) 2026-03-16 11:10:34 +01:00
RayXu
70397fd103
Docs: fix a form error and a grammatical error in float.rst (#140989) 2026-03-16 13:51:49 +05:30
Shahar Naveh
f7cb789dc5
gh-145998: Remove duplicated "What's New in 3.15" entry (#145994) 2026-03-15 22:54:19 +01:00
Lysandros Nikolaou
2f4e4ec2e7
gh-142518: Document thread-safety guarantees of bytearray objects (#145226) 2026-03-15 15:57:05 +01:00
Peter Bierma
1dfe99ae3b
gh-141004: Document PyDTrace* (GH-141856) 2026-03-14 22:58:35 -04:00
Connor Gibson
51e8acf8de
Docs: fix missing period in Doc/library/stdtypes.rst (#145935) 2026-03-14 10:19:00 +01:00
Victor Stinner
3c38feb2a2
gh-129813: Document that PyBytesWriter_GetData() cannot fail (#145900)
Document that PyBytesWriter_GetData() and PyBytesWriter_GetSize()
getter functions cannot fail
2026-03-13 19:44:51 +01:00
Petr Viktorin
747ef70faa
GH-60729: Revert "Add IEEE format wave audio support (GH-145384)" (GH-145928)
Revert "GH-60729: Add IEEE format wave audio support (GH-145384)"

This reverts commit 61f2a1a599 for now;
as tests fail on big-endian machines.
2026-03-13 17:51:23 +00:00
Lysandros Nikolaou
79b91e7c50
gh-142518: Document thread-safety guarantees of set objects (#145225) 2026-03-13 14:53:01 +01:00
Michiel W. Beijen
61f2a1a599
GH-60729: Add IEEE format wave audio support (GH-145384)
Co-authored-by: Lionel Koenig <lionelk@google.com>
2026-03-13 14:10:48 +01:00
Jason Yalim, PhD
f884dc6f70
gh-140715: Add %t and %n format codes support to strptime() (GH-144896)
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2026-03-13 14:00:39 +01:00
Furkan Onder
9162238511
gh-99631: Add shelve custom serialization to What's New in 3.15 (#145253) 2026-03-13 14:38:06 +02:00
Maurizio Sambati
6d1e9ceed3
Docs: except with multiple exceptions parentheses not required (#145848)
As of PEP 758 the except statement doesn't require parentheses anymore for exception tuples.

See: https://peps.python.org/pep-0758/
2026-03-13 05:40:20 -04:00
Charlie Lin
7a65900764
gh-145717: Add a few Microsoft-specific MIME types, and synchronize between mimetypes module and tests (#145718)
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
2026-03-12 18:56:07 +02:00
Victor Stinner
d4cc553294
gh-141510: Update PyDict C API doc for frozendict (#145533)
Mention frozendict support.
2026-03-12 15:04:36 +01:00
Serhiy Storchaka
72456309e9
gh-143715: Deprecate incomplete initialization of struct.Struct() (GH-145580)
* Struct.__new__() will require a mandatory argument (format)
* Calls of __init__() method with a different format argument on initialized
  Struct are deprecated

Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
2026-03-12 09:44:11 +02:00
Lysandros Nikolaou
0dce4c6eab
gh-145254: Add thread safety annotation in docs (#145255) 2026-03-12 12:18:43 +05:30
Lysandros Nikolaou
7a1da4575b
gh-142518: Improve mimalloc allocator docs (#145224) 2026-03-11 15:14:47 +01:00
Sergey B Kirpichev
ce1abaf9b8
gh-99875: Document rounding mode for old-style formatting (#126382) 2026-03-11 14:25:24 +01:00
Stan Ulbrych
eb9ae65e5b
Warn that overriding __builtins__ for eval is not a security mechanism (GH-145773)
Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
2026-03-11 13:29:43 +01:00
Sergey B Kirpichev
dae85c4d93
gh-145633: Remove support for ancient ARM platforms with mixed-endian doubles (#145634)
* Drop DOUBLE_IS_ARM_MIXED_ENDIAN_IEEE754 macro.
* Use DOUBLE_IS_BIG/LITTLE_ENDIAN_IEEE754 to detect endianness of
  float/doubles.
* Drop "unknown_format" code path in PyFloat_Pack/Unpack*().

Co-authored-by: Victor Stinner <vstinner@python.org>
2026-03-11 12:39:24 +01:00
Cody Maloney
cf7c67b7c6
gh-101100: Fix sphinx reference warnings around I/O (#139592)
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
2026-03-11 10:02:23 +02:00
Farhan Saif
bf4017b161
gh-125053: Document that ob_mutex must only be used via critical section API (#144599)
Add a warning in the free-threading extensions howto explaining that
PyObject.ob_mutex is reserved for the critical section API and must not
be locked directly with PyMutex_Lock, as this can cause deadlocks.
Extension authors who need their own lock should add a separate PyMutex
field to their object struct.

Also add an ob_mutex member entry under PyObject in the C API reference
(Doc/c-api/structures.rst) with a cross-reference to the howto.

Co-authored-by: Victor Stinner <vstinner@python.org>
2026-03-10 17:23:39 +01:00
Ali Towaiji
2114da976c
gh-145591: Move slicing note to __getitem__ (GH-145606) 2026-03-10 16:48:41 +01:00
Charlie Lin
467507a651
gh-145697: Add .sql and .sqlite3 recognition in mimetypes (GH-145698)
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Benedikt Johannes <benedikt.johannes.hofer@gmail.com>
2026-03-10 16:21:33 +01:00
Peter Bierma
7990313afa
Docs: Improve the C API documentation involving threads (GH-145520)
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2026-03-10 10:57:13 -04:00