78ba4cb758
gh-118030: Group definitions for `ParamSpecArgs` and `ParamSpecKwargs` in `typing.rst` ( #118154 )
2024-04-22 14:57:46 +00:00
ceb6038b05
gh-115986 Improve pprint documentation accuracy ( #117403 )
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2024-04-22 12:28:21 +02:00
1446024124
Docs: replace Harry Potter reference with Monty Python ( #118130 )
2024-04-21 19:03:46 +01:00
51ef89cd9a
gh-115961: Add name and mode attributes for compressed file-like objects (GH-116036)
...
* Add name and mode attributes for compressed and archived file-like objects
in modules bz2, lzma, tarfile and zipfile.
* Change the value of the mode attribute of GzipFile from integer (1 or 2)
to string ('rb' or 'wb').
* Change the value of the mode attribute of ZipExtFile from 'r' to 'rb'.
2024-04-21 11:46:39 +03:00
df987331d8
gh-114099: Formalize Tier 3 status of iOS (GH-118020)
2024-04-20 23:04:08 -04:00
1558d99316
Clarifying nonlocal doc: SyntaxError is raised if nearest enclosing scope is global ( #114009 )
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2024-04-20 18:42:51 -07:00
2aa11cca11
gh-118100: Improve links in `ast.rst` ( #118101 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-04-19 21:25:54 +03:00
1e3e7ce11e
gh-114053: Fix bad interaction of PEP-695, PEP-563 and ``get_type_hints`` ( #118009 )
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2024-04-19 13:03:44 +00:00
15b3555e4a
gh-116931: Add fileobj parameter check for Tarfile.addfile (GH-117988)
...
Tarfile.addfile now throws an ValueError when the user passes
in a non-zero size tarinfo but does not provide a fileobj,
instead of writing an incomplete entry.
2024-04-19 11:41:51 +00:00
8a01fd7b9b
gh-115775: Add whatsnew entry about __static_attributes__ (GH-117909)
...
Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2024-04-19 12:57:31 +02:00
5d54436574
gh-116935: Document that heap types need to support garbage collection (GH-118021)
2024-04-19 09:29:23 +00:00
4605a197bd
gh-117518: Clarify PyTuple_GetItem() borrowed reference in the doc (GH-117920)
2024-04-19 10:41:37 +02:00
fefd5d9711
gh-64588: Clarify the difference between mu and xbar in statistics docs ( #117333 )
...
Thanks Davin Potts for the clarification idea.
2024-04-18 22:36:24 -07:00
60787b8a4e
Docs: Fix CVE link ( #118077 )
2024-04-18 21:31:53 -07:00
398abdd6fa
Use "Contributed by" in a couple of occurrences of 3.12 whatsnew ( #118070 )
2024-04-19 03:28:12 +00:00
81a926bd20
gh-87969: Align docs and docstrings with implementation for ctypes' [w]string_at() ( #25384 )
...
The implementation uses 'ptr' for the name of the first parameter of
ctypes.string_at() and ctypes.wstring_at(). Align docs and docstrings
with the naming used in the implementation.
Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
2024-04-18 14:57:37 +00:00
340a02b590
gh-117987: Restore several functions removed in Python 3.13 alpha 1 (GH-117993)
...
Restore these functions removed in Python 3.13 alpha 1:
* Py_SetPythonHome()
* Py_SetProgramName()
* PySys_SetArgvEx()
* PySys_SetArgv()
2024-04-18 15:20:38 +02:00
f70395786f
gh-90815: Document bundled mimalloc in What’s New In Python 3.13 (GH-117811)
2024-04-18 11:04:20 +02:00
468b9aeb92
gh-116932: Add note on how to report python documentation theme bugs (GH-117989)
2024-04-18 10:45:25 +02:00
a4b44d39cd
gh-114539: Clarify implicit launching of shells by subprocess (GH-117996)
2024-04-17 19:32:47 +01:00
ae8dfd2761
Doc: Render version/language selector on Read the Docs ( #116966 )
2024-04-17 18:40:56 +03:00
fccedbda93
gh-117977: Amend version changed annotation for os.chmod, os.chown, and os.listdir ( #117978 )
2024-04-17 14:59:02 +00:00
75eed5b373
gh-117929: Restore removed PyEval_InitThreads() function ( #117931 )
2024-04-17 15:01:28 +02:00
438b7c3071
gh-73231: Update documentation for PyErr_SetFromWindowsErr() (GH-117226)
2024-04-17 13:03:26 +03:00
a23fa3368e
gh-117945: Fix `os.path.ismount()` documentation ( #117947 )
2024-04-16 15:55:53 -07:00
3284b84c43
Docs: Add classes to C API return value annotations ( #117926 )
...
Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
2024-04-16 15:56:15 +00:00
1316692e8c
gh-102402: Fix floating point math issue by using `time.time_ns()` in `logging.LogRecord` (GH-102412)
2024-04-16 10:44:57 +01:00
6dc661bc9f
gh-77102: site: try utf-8 and fallback to locale encoding when reading .pth file ( #117802 )
2024-04-16 12:56:16 +09:00
757891ee8a
gh-117804: Document how to suppress PGO unprofiled source warnings ( #117859 )
2024-04-15 23:17:28 +02:00
3375282bb8
Docs: add link roles with Sphinx extlinks ( #117850 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-04-15 21:22:00 +03:00
78da154067
gh-109975: Copyedit "What's New in Python 3.13" ( #117902 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-04-15 17:20:40 +00:00
106e9ddc43
Docs: make the `whatsnew-typing-py312` anchor point to things that were new in the typing module ( #117904 )
2024-04-15 16:48:13 +00:00
0823f43618
gh-115532: Minor tweaks to kde() (gh-117897)
2024-04-15 10:08:21 -05:00
10f1a2687a
gh-115664: Reorganize versionadded directives for -X options (GH-116304)
...
Add the versionadded directives just under the description of the
corresponding option.
2024-04-15 18:01:17 +03:00
7d0be7aea5
Add 'The Python 2.3 Method Resolution Order' ( #116435 )
2024-04-15 13:01:15 +03:00
74b0658e6a
docs: typo in 3.13 release notes ( #117866 )
2024-04-14 14:04:59 -07:00
e01831760e
Doc: mark up classes, attributes, parameters, and methods in dataclasses.rst ( #117820 )
2024-04-14 16:29:01 +00:00
c99d374fc7
dataclasses docs: add some link anchors ( #117601 )
2024-04-14 01:03:16 -07:00
f303651b45
Simpler example of shallow dict export of a dataclass ( #117812 )
2024-04-13 17:14:43 -07:00
e7cce2a9c6
Tweak wording for dataclasses.replace (gh-117758)
2024-04-13 20:03:09 -04:00
a74f117dab
GH-115060: Speed up `pathlib.Path.glob()` by omitting initial `stat()` ( #117831 )
...
Since 6258844c
2024-04-14 00:08:03 +01:00
56ed979d04
gh-68583: webbrowser: replace `getopt` with `argparse`, add long options ( #117047 )
2024-04-13 08:56:56 -06:00
022ba6d161
gh-102247: http: support rfc9110 status codes (GH-117611)
...
rfc9110 obsoletes the earlier rfc 7231. This document also includes some
status codes that were previously only used for WebDAV and assigns more
generic names to these status codes.
ref: https://www.rfc-editor.org/rfc/rfc9110.html#name-changes-from-rfc-7231
- http.HTTPStatus.CONTENT_TOO_LARGE (413, previously
REQUEST_ENTITY_TOO_LARGE)
- http.HTTPStatus.URI_TOO_LONG (414, previously REQUEST_URI_TOO_LONG)
- http.HTTPStatus.RANGE_NOT_SATISFYABLE (416, previously
REQUEST_RANGE_NOT_SATISFYABLE)
- http.HTTPStatus.UNPROCESSABLE_CONTENT (422, previously
UNPROCESSABLE_ENTITY)
The new constants are added to http.HTTPStatus and the old constant names are
preserved for backwards compatibility.
References in documentation to the obsoleted rfc 7231 are updated
2024-04-13 07:33:20 -07:00
dd724239dd
gh-117840: Fix indent to fix shlex syntax highlighting ( #117843 )
2024-04-13 05:31:01 -06:00
37a4cbd872
gh-114466: explicitly define heap invariant ( #117778 )
...
I think the choice of wording in these docs is great and doesn't
need to change. However, it could be useful to explicitly define
this term / the cost of doing so seems relatively low.
2024-04-13 00:05:27 -07:00
a97650912e
gh-117739: Update definition of global interpreter lock for 3.13 ( #117740 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-04-12 14:19:41 -04:00
94e9c35cd0
Fix version directive indents ( #117719 )
2024-04-12 13:30:42 +03:00
c06be6bbb8
gh-104269: Document `glob.glob` duplicates when using multiple `**` patterns ( #105406 )
2024-04-11 15:16:39 +00:00
01a51f9494
gh-117722: Fix Stream.readuntil with non-bytes buffer objects ( #117723 )
...
gh-16429 introduced support for an iterable of separators in
Stream.readuntil. Since bytes-like types are themselves iterable, this
can introduce ambiguities in deciding whether the argument is an
iterator of separators or a singleton separator. In gh-16429, only 'bytes'
was considered a singleton, but this will break code that passes other
buffer object types.
Fix it by only supporting tuples rather than arbitrary iterables.
Closes gh-117722.
2024-04-11 07:41:55 -07:00
898f6de63f
gh-101549: fix documentation of xml.etree.ElementInclude ( #101550 )
...
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2024-04-11 14:23:52 +00:00
be82058064
Fix markup of `win32_ver` in `platform.rst` ( #116492 )
2024-04-11 17:13:53 +03:00
630df37116
GH-117546: Fix symlink resolution in `os.path.realpath('loop/../link')` ( #117568 )
...
Continue resolving symlink targets after encountering a symlink loop, which
matches coreutils `realpath` behaviour.
2024-04-10 18:17:18 +01:00
6bc0b33a91
gh-117531: Unblock getters after non-immediate queue shutdown ( #117532 )
...
(This is a small tweak of the original gh-104750 which added shutdown.)
2024-04-10 08:01:42 -07:00
73906d5c90
gh-117360: Clearer wording in os.path.lexists() docs ( #117679 )
...
Co-authored-by: Zachary Ware <zach@python.org>
2024-04-09 23:00:41 +02:00
a05068db0c
gh-117597: Clarify exception handling in the tutorial ( #117681 )
2024-04-09 20:59:45 +00:00
a25c02eaf0
Revert "gh-106023: Update What's New in 3.13: _PyObject_FastCall() ( #117633 )" ( #117676 )
...
This reverts commit 9a12f5d1c1
2024-04-09 18:26:35 +02:00
fa58e75a86
gh-116720: Fix corner cases of taskgroups ( #117407 )
...
This prevents external cancellations of a task group's parent task to
be dropped when an internal cancellation happens at the same time.
Also strengthen the semantics of uncancel() to clear self._must_cancel
when the cancellation count reaches zero.
Co-Authored-By: Tin Tvrtković <tinchester@gmail.com>
Co-Authored-By: Arthur Tacca
2024-04-09 08:17:28 -07:00
f2132fcd2a
gh-117516: Implement typing.TypeIs ( #117517 )
...
See PEP 742.
Co-authored-by: Carl Meyer <carl@oddbird.net>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2024-04-09 10:50:37 +00:00
775912a51d
gh-81322: support multiple separators in StreamReader.readuntil ( #16429 )
2024-04-08 09:58:02 -07:00
24a2bd0481
gh-117642: Fix PEP 737 implementation (GH-117643)
...
* Fix implementation of %#T and %#N (they were implemented as %T# and
%N#).
* Restore tests removed in gh-116417.
2024-04-08 16:27:25 +00:00
e16062dd34
gh-96471: Correct documentation for asyncio queue shutdown ( #117621 )
2024-04-08 14:50:54 +00:00
9a12f5d1c1
gh-106023: Update What's New in 3.13: _PyObject_FastCall() ( #117633 )
...
The function _PyObject_FastCall() was restored.
2024-04-08 12:19:43 +00:00
a7702663e3
gh-111726: Explicitly close database connections in sqlite3 doctests ( #111730 )
...
Co-authored-by: Erlend E. Aasland <erlend@python.org>
2024-04-08 09:29:47 +00:00
e338e1a4ec
gh-111726: Remove some doctests from sqlite3 docs ( #117623 )
...
* remove load extension doctest since we cannot skip it conditionally
* remove sys.unraisablehook example; using unraisable hooks is not "an
improved debug experience"
2024-04-08 08:11:08 +00:00
a453f5ef9d
gh-111726: Cleanup test files after running sqlite3 doctest ( #117604 )
...
Remove all temporary databases in a dedicated 'testcleanup' step
at the end of the file.
2024-04-08 08:35:48 +02:00
fd3679025d
Fix reference in code.rst ( #117615 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-04-07 22:58:57 +00:00
df4d84c3cd
gh-96471: Add asyncio queue shutdown ( #104228 )
...
Co-authored-by: Duprat <yduprat@gmail.com>
2024-04-06 07:27:13 -07:00
6150bb2412
GH-77609: Add recurse_symlinks argument to `pathlib.Path.glob()` ( #117311 )
...
Replace tri-state `follow_symlinks` with boolean `recurse_symlinks` argument. The new argument controls whether symlinks are followed when expanding recursive `**` wildcards. The possible argument values correspond as follows:
follow_symlinks recurse_symlinks
=============== ================
False N/A
None False
True True
We therefore drop support for not following symlinks when expanding non-recursive pattern parts; it wasn't requested in the original issue, and it's a feature not found in any shells.
This makes the API a easier to grok by eliminating `None` as an option.
No news blurb as `follow_symlinks` was new in 3.13.
2024-04-05 18:51:54 +00:00
687616877b
gh-111140: PyLong_From/AsNativeBytes: Take *flags* rather than just *endianness* (GH-116053)
2024-04-05 16:21:16 +02:00
9ceaee74db
gh-116608: importlib.resources: Un-deprecate functional API & add subdirectory support (GH-116609)
2024-04-05 13:55:59 +02:00
42205143f8
gh-117478: Add `@support.requires_gil_enabled` decorator ( #117479 )
...
Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru>
2024-04-04 14:10:46 -04:00
df912c913a
[doc] Update logging documentation to improve grammar and elucidate an example. (GH-117541)
2024-04-04 13:14:44 +01:00
fc5f68e58e
gh-59215: unittest: restore _top_level_dir at end of discovery (GH-15242)
2024-04-03 16:17:13 +02:00
33ee5cb3e9
GH-70647: Deprecate strptime day of month parsing without a year present to avoid leap-year bugs (GH-117107)
2024-04-03 14:19:49 +02:00
e569f9132b
gh-117074: Update Traversable.joinpath docs to the 3.11+ protocol (GH-117113)
2024-04-02 16:08:16 +02:00
9dae05ee59
Docs: specify XML document name in xml.etree.elementtree example ( #24223 )
2024-04-01 19:53:00 +00:00
fc2071687b
Docs: add more links to PIPE in subprocess docs ( #25416 )
2024-04-01 21:49:14 +02:00
fc8007ee36
GH-117337: Deprecate `glob.glob0()` and `glob.glob1()`. ( #117371 )
...
These undocumented functions are no longer used by `msilib`, so there's no
reason to keep them around.
2024-04-01 19:37:41 +00:00
c741ad3537
gh-77714: Provide an async iterator version of as_completed (GH-22491)
...
* as_completed returns object that is both iterator and async iterator
* Existing tests adjusted to test both the old and new style
* New test to ensure iterator can be resumed
* New test to ensure async iterator yields any passed-in Futures as-is
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Guido van Rossum <gvanrossum@gmail.com>
2024-04-01 20:07:29 +03:00
56e99307c4
Doc: printf-style library/stdtype improvements ( #16741 )
2024-03-31 22:34:54 +00:00
262445358e
Link to the Python type system specification ( #117400 )
2024-03-31 12:02:48 -07:00
752e18389e
GH-114575: Rename `PurePath.pathmod` to `PurePath.parser` ( #116513 )
...
And rename the private base class from `PathModuleBase` to `ParserBase`.
2024-03-31 19:14:48 +01:00
54f7e14500
gh-66449: configparser: Add support for unnamed sections ( #117273 )
...
Co-authored-by: Jason R. Coombs <jaraco@jaraco.com>
2024-03-29 15:05:00 +00:00
a17f313e39
gh-117339: Use NULL instead of None for LOAD_SUPER_ATTR in dis docs (GH-117343)
2024-03-29 06:26:56 +08:00
29829b58a8
gh-117294: Report DocTestCase as skipped if all examples in the doctest are skipped (GH-117297)
2024-03-28 21:59:12 +02:00
9a388b9a64
bpo-43848: explain optional argument mtime in gzip.py. (GH-25410)
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2024-03-28 13:43:07 +00:00
0f27672c50
gh-114099: Add documentation for iOS platform (GH-117057)
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Jacob Coffee <jacob@z7x.org>
Co-authored-by: Malcolm Smith <smith@chaquo.com>
Co-authored-by: Ned Deily <nad@python.org>
2024-03-28 04:13:13 -04:00
f006338017
gh-114099: Additions to standard library to support iOS (GH-117052)
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Malcolm Smith <smith@chaquo.com>
Co-authored-by: Ned Deily <nad@python.org>
2024-03-28 03:59:33 -04:00
b44898299a
gh-89739: gh-77140: Support zip64 in zipimport (GH-94146)
...
* Reads zip64 files as produced by the zipfile module
* Include tests (somewhat slow, however, because of the need to create "large" zips)
* About the same amount of strictness reading invalid zip files as zipfile has
* Still works on files with prepended data (like pex)
There are a lot more test cases at https://github.com/thatch/zipimport64/ that give me confidence that this works for real-world files.
Fixes #89739 and #77140 .
---------
Co-authored-by: Itamar Ostricher <itamarost@gmail.com>
Reviewed-by: Gregory P. Smith <greg@krypto.org>
2024-03-28 06:54:51 +00:00
74c8568d07
gh-71042: Add `platform.android_ver` ( #116674 )
2024-03-27 17:53:27 +01:00
ce00de4c8c
gh-117225: doctest: only print "and X failed" when non-zero, don't pluralise "1 items" ( #117228 )
2024-03-27 16:46:35 +02:00
92397d5ead
Add statistics recipe for sampling from an estimated probability density distribution ( #117221 )
2024-03-27 09:04:32 -05:00
48c0b05cf0
Change links on the index page ( #117230 )
2024-03-26 13:08:08 -06:00
7ebad77ad6
Sync main docs and docstring for median_grouped(). (gh-117214)
2024-03-25 23:49:44 +00:00
0821923aa9
gh-117114: Make os.path.isdevdrive available on all platforms (GH-117115)
2024-03-25 22:55:11 +00:00
c2276176d5
Add information about negative indexes to sequence datamodel doc ( #110903 )
...
Co-authored by Terry Jan Reedy
2024-03-25 18:34:20 -04:00
507896d97d
gh-116936: Add PyType_GetModuleByDef() to the limited C API ( #116937 )
2024-03-25 16:32:20 +00:00
0c1a42cf9c
gh-87193: Support bytes objects with refcount > 1 in _PyBytes_Resize() (GH-117160)
...
Create a new bytes object and destroy the old one if it has refcount > 1.
2024-03-25 16:32:11 +01:00
9db2a8f914
Minor markup and grammar fixes in the statistics docs (gh-117216)
2024-03-25 09:26:42 -05:00
78a651fd7f
gh-117194: Properly format 'base64' header in What's New ( #117198 )
...
It needs 6, not 3, '-'s.
2024-03-24 11:38:34 -04:00
Nice Zombies
Kerim Kabirov
Clément Robert
Serhiy Storchaka
Russell Keith-Magee
Quazi Irfan
Nikita Sobolev
Alex Waygood
lyc8503
Irit Katriel
Savannah Ostrowski
Victor Stinner
Mariusz Felisiak
Jelle Zijlstra
Rafael Fontenelle
Shreyan Avigyan
Miro Hrončok
Steve Dower
Manuel Kaufmann
Hugo van Kemenade
Douglas Thor
Inada Naoki
Erlend E. Aasland
Raymond Hettinger
Galen Rice
Gouvernathor
Barney Gale
Michiel W. Beijen
Shantanu
Tomas R
Bruce Merry
Mikhail B
Laurie O
Guido van Rossum
Anita Hammer
Petr Viktorin
Sam Gross
Vinay Sajip
Zackery Spytz
Gregory P. Smith
Moshe Kaplan
Matthew Davis
Justin Turner Arthur
Adorilson Bezerra
Pedro Lacerda
Christopher Chianelli
Malcolm Smith
Joachim Wuttke
Tim Hatch
Terry Jan Reedy