Commit graph

14245 commits

Author SHA1 Message Date
Klaus Zimmermann
1acb718ea2
gh-133143: Add sys.abi_info (GH-137476)
This makes information about the interpreter ABI more accessible.

Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-09-08 14:35:44 +00:00
Adorilson Bezerra
921f61bd82
Doc: Apply keyword role around finally (in sys module doc) (GH-138544) 2025-09-08 14:02:36 +02:00
Bénédikt Tran
4ef51fa75c
gh-138633: fix Sphinx references in ssl documentation (#138648) 2025-09-08 11:31:40 +00:00
Bénédikt Tran
3255c0c870
gh-138633: synchronize documented signatures of SSL objects with runtime ones (#138639) 2025-09-08 09:28:10 +00:00
Ron Frederick
6401823db3
gh-138252: Add support in SSL module for getting and setting TLS signature algorithms (#138269)
The signature algorithms allowed for certificate-based client authentication or
for the server to complete the TLS handshake can be defined on a SSL context via
`ctx.set_client_sigalgs()` and `ctx.set_server_sigalgs()`.

With OpenSSL 3.4 or later, the list of available TLS algorithms can be retrieved
by `ssl.get_sigalgs()`.

With OpenSSL 3.5 or later, the selected signature algorithms can be retrieved from
SSL sockets via `socket.client_sigalg()` and `socket.server_sigalg()`.

This commit also partially amends 377b787618
by using `PyUnicode_DecodeFSDefault` instead of `PyUnicode_DecodeASCII` in
`_ssl._SSLContext.get_groups`, so that functions consistently decode strings
obtained from OpenSSL.

---------

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2025-09-08 08:36:12 +00:00
Gilles Peiffer
c117b03385
Docs: Fix typo in random_derangement recipe (GH-138599) 2025-09-06 16:53:49 -04:00
AN Long
c919d02ede
gh-138205: Remove the resize method on mmap object on platforms don't support it (#138276)
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
2025-09-06 14:10:04 +05:30
W. H. Wang
8368895049
gh-137985: Correct description of Formatter's datefmt param in logging documentation (GH-138530) 2025-09-05 22:07:04 +01:00
Adam Turner
8ed1d53e62
GH-138465: Improve documentation for common sequence methods (#138474)
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2025-09-05 20:55:02 +01:00
Jelle Zijlstra
9158bcf86b
annotationlib: add note on security to docs (#138508) 2025-09-05 08:26:58 -07:00
Brian Schubert
fc0305a2d8
docs: add module-level versionadded for annotationlib (#138511) 2025-09-04 13:45:21 -07:00
Zackery Spytz
9d6b94afe7
gh-87595: Fix the docs for mmap.size() (#138494)
Correct some parts of the docs added in 32032ee376 that weren't
written by me.
2025-09-04 17:52:24 +02:00
Raymond Hettinger
f9a40c386d
Add random_derangement recipe gh-138377 2025-09-04 10:50:29 -05:00
William Andrea
849a80ec41
Docs: Fix typo in os.fwalk() example (GH-138486) 2025-09-04 08:33:51 -04:00
Zachary Ware
f8d9cb1407
Fix Windows path in venv docs (GH-138476) 2025-09-03 20:15:47 +00:00
Adam Turner
8bbbac8a0d
GH-101100: Resolve reference warnings in whatsnew/3.5.rst (#138412)
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-09-03 15:38:05 +00:00
Marc Mueller
8ce4f28363
Docs: Fix typo in test.support.linked_to_musl function name (#138406) 2025-09-03 14:52:13 +02:00
Adam Turner
984d928a22
GH-101100: Resolve reference warnings in whatsnew/2.7.rst (#138415)
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-09-03 11:33:13 +00:00
Adorilson Bezerra
88665de120
gh-138307: Update the Ellipsis documentation (#138306)
* Doc: Change Ellipsis doc at library/constants

* Doc: Change Ellipsis doc at library/stdtypes

* Doc: Add NumPy reference into Ellipsis doc at library/stdtypes

* Doc: Add Ellipsis reference into the pass statement section at tutorial

* Doc: Update Ellipsis doc concerns assignments at library/constants

* Update Doc/library/stdtypes.rst

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>

* Doc: Fix grammar on Ellipsis docs (library/constants.rst)

Co-authored-by: Éric <merwok@netwok.org>

* Doc: Fix grammar on Ellipsis docs (library/stdtypes.rst)

Co-authored-by: Éric <merwok@netwok.org>

* Doc: Fix grammar on Ellipsis docs (library/stdtypes.rst)

Co-authored-by: Éric <merwok@netwok.org>

* Doc: Remove pretty printers reference from Ellipsis doc at library/stdtypes

* Doc: Update index concerns Ellipsis object and pass statement

* Doc: Improve Ellipsis doc at library/constants

* Doc: Improve Ellipsis doc at library/stdtypes

* Doc: Change the "..." glossary entry to mention the Ellipsis object

* Doc: Some improvements concern ellipsis into typing doc

* Minor update Doc/tutorial/controlflow.rst

Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>

* Update Doc/library/constants.rst

Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>

* Update Doc/library/stdtypes.rst

Co-authored-by: Ned Batchelder <ned@nedbatchelder.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-03 07:27:22 -04:00
Adam Turner
8c1ae6de11
GH-101100: Resolve reference warnings in whatsnew/3.8.rst (#138409)
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-09-03 11:24:42 +00:00
Adam Turner
14e25177c6
GH-101100: Resolve reference warnings in whatsnew/3.3.rst (#138414) 2025-09-03 11:20:43 +00:00
Serhiy Storchaka
7274d07607
gh-78502: Add a trackfd parameter to mmap.mmap() on Windows (GH-138238)
If trackfd is False, the file handle corresponding to fileno
will not be duplicated.
2025-09-03 11:31:34 +03:00
Adam Turner
dd86fb4ba5
GH-101100: Resolve reference warnings in whatsnew/3.7.rst (#138410)
Resolve reference warnings in whatsnew/3.7.rst
2025-09-03 09:20:16 +03:00
Weilin Du
c22cc8fccd
gh-101100: Resolve reference warnings in library/xml.sax.handler.rst (#136612) 2025-09-03 01:35:21 +01:00
Zackery Spytz
32032ee376
gh-87595: Support mmap.size() for anonymous mapping on Unix (GH-24781)
Previously, the size would be returned on Windows and an OSError would
be raised on Unix.

Also, raise ValueError instead of OSError for trackfd=False.

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2025-09-02 23:24:06 +03:00
AN Long
b3e785c76c
gh-138314: Add winreg.DeleteTree (GH-138388) 2025-09-02 17:04:57 +00:00
Adam Turner
cc7ef69c86
gh-138122: Use `profiling.sampling` in the documentation (PEP 799) (#138389) 2025-09-02 17:45:00 +01:00
Gregory P. Smith
a2ba0a7552
gh-61206: Support zstandard compression in the zipimport module (GH-138254)
* gh-61206: support zstd in zipimport

* NEWS entry

* versionchanged doc
2025-09-01 17:14:23 -07:00
Stan Ulbrych
0d383f86ee
gh-54874: Expand unicodedata module documentation (#138301)
Closes #54874

Co-authored-by: Alexander Belopolsky <abalkin@users.noreply.github.com>
2025-09-01 17:50:31 +02:00
R Chintan Meher
c7a097c02e
gh-133829: Remove some specifics from the `zipimport` example (#133835)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: sobolevn <mail@sobolevn.me>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-08-31 01:50:56 +01:00
Ron Frederick
bacb7771fb
gh-137197: Add SSLContext.set_ciphersuites to set TLSv1.3 ciphers (#137198)
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2025-08-30 09:32:11 +00:00
Wulian233
5c6937ad20
gh-133656: Remove deprecated zipimport.zipimporter.load_module (GH-133662)
Remove deprecated `zipimport.zipimporter.load_module`.
2025-08-30 01:28:18 +00:00
Hang
5f7906715a
gh-123858: Improve Doc: SyntaxWarning is emitted during bytecode generation (gh-122844)
---------

Co-authored-by: Alyssa Coghlan <ncoghlan@gmail.com>
2025-08-29 23:29:59 +10:00
Andreas Pelme
f733e428f8
Docs: Fix typo in shutil.make_archive example (GH-138188) 2025-08-27 11:57:37 -04:00
Blaise Pabon
14a5ad1db1
gh-106318: Add example for str.find() (#134529)
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-08-27 09:42:00 +03:00
Serhiy Storchaka
65fb4d11a0
gh-137609: Update signatures of builtins in the documentation (GH-137610)
Show signatures that match the actual signatures or future multisignatures
for all functions, classes and methods in the "builtins" module.
2025-08-25 15:28:27 +03:00
Serhiy Storchaka
aa1dbd4dde
gh-137986: Fix and improve the csv functions docstrings (GH-137987)
The csv.register_dialect() docstring no longer imply that it returns a
dialect.
All functions have now signatures.

Co-authored-by: maurycy <5383+maurycy@users.noreply.github.com>
2025-08-24 11:13:31 +03:00
Kentaro Jay Takahashi
282e88506b
gh-133125: Clarify ZipInfo.date_time attribute documentation (#136082)
Specifically, clarify that ZipInfo.date_time pulls the datetime information from the central directory, and that times are interpreted as local time.

Co-authored-by: Emma Smith <emma@emmatyping.dev>
2025-08-22 16:52:30 -07:00
Krishna Chaitanya
f278afcabf
gh-91116: Add hyperlink from sys.settrace to frame objects (GH-138062) 2025-08-22 12:28:33 -04:00
Bénédikt Tran
4519b8acb5
gh-136134: imaplib: fix CRAM-MD5 on FIPS-only environments (#136615) 2025-08-22 12:08:55 +02:00
vict-Yang
ce70a57bc0
gh-137920: Fix semantically relevant typo in curses.window.attron (#137940) 2025-08-22 10:27:02 +02:00
Yüce Tekol
7dc42b67a7
gh-137884: Added threading.get_native_id() on Illumos/Solaris (GH-137927) 2025-08-20 17:10:44 +00:00
Tangyuan
7685b8ada8
gh-137900: Improve dataclasses frozen parameter documentation (#137937) 2025-08-20 09:08:45 -04:00
Serhiy Storchaka
23adbf53c5
gh-137044: To weaken the statement regarding the RLIM_INFINITY value (GH-137954) 2025-08-20 15:05:38 +03:00
Maximilian Linhoff
9b5235b62e
Fix typo in logging docs (GH-137981) 2025-08-20 07:07:32 -04:00
Serhiy Storchaka
e39255e76d
Update the availability info in the resource docs (GH-137922) 2025-08-19 18:11:03 +03:00
Serhiy Storchaka
8700404f86
Update the dbm documentation (GH-137919)
Unify documentation for all backends, enumerate all not implemented mapping
methods, document particularities of implemented mapping methods.
2025-08-19 18:05:24 +03:00
PrinceNaroliya
379161dd51
[docs] minor, fix grammar in ssl.SSLContect.sslsocket_class docstring (GH-137935)
Fix grammar in ssl.SSLContect.sslsocket_class docstring

---------

Co-authored-by: Gregory P. Smith <68491+gpshead@users.noreply.github.com>
2025-08-19 12:00:39 +00:00
Serhiy Storchaka
6e2b9a2130
gh-137512: Add new constants in the resource module (GH-137513)
* RLIMIT_NTHR
* RLIMIT_THREADS
* RLIMIT_UMTXP
* RLIM_SAVED_CUR
* RLIM_SAVED_MAX

* Document RLIMIT_PIPEBUF. Other doc fixes.
2025-08-19 08:52:45 +02:00
Serhiy Storchaka
0324c726de
gh-137044: Make resource.RLIM_INFINITY always positive (GH-137511)
It is now a positive integer larger larger than any limited resource value.
This simplifies comparison of the resource values.
Previously, it could be negative, such as -1 or -3, depending on platform.

Deprecation warning is emitted if the old negative value is passed.
2025-08-18 19:28:56 +03:00