9c7657f099
gh-113878: Add `doc` parameter to `dataclasses.field` (gh-114051)
...
If using `slots=True`, the `doc` parameter ends up in the `__slots__` dict. The `doc` parameter is also in the corresponding `Field` object.
2024-09-27 12:20:49 -04:00
b79a21ea42
GH-95079: document error behaviour for some unicode C APIs ( #95080 )
2024-09-27 12:35:55 +02:00
5329d1b74a
Docs: for for/else clarify that return or raise also skip the else ( #124591 )
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2024-09-27 06:17:25 -04:00
23e812b84a
Docs: Update and proofread `library/venv.rst` ( #124121 )
...
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-09-27 02:57:38 +03:00
b65f2cdfa7
gh-84559: Change the multiprocessing start method default to `forkserver` (GH-101556)
...
Change the default multiprocessing start method away from fork to forkserver or spawn on the remaining platforms where it was fork. See the issue for context. This makes the default far more thread safe (other than for people spawning threads at import time... - don't do that!).
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-09-26 16:57:19 -07:00
2c10832887
gh-119180: Rename SOURCE format to STRING ( #124620 )
2024-09-26 13:49:48 -07:00
7d3497f617
gh-115528: Update language reference for PEP 646 ( #121181 )
...
To recap: the objective is to make starred expressions valid in `subscription`,
which is used for generics: `Generic[...]`, `list[...]`, etc.
What _is_ gramatically valid in such contexts? Seemingly any of the following.
(At least, none of the following throw `SyntaxError` in a 3.12.3 REPL.)
Generic[x]
Generic[*x]
Generic[*x, y]
Generic[y, *x]
Generic[x := 1]
Generic[x := 1, y := 2]
So introducting
flexible_expression: expression | assignment_expression | starred_item
end then switching `subscription` to use `flexible_expression` sorts that.
But then we need to field `yield` - for which any of the following are
apparently valid:
yield x
yield x,
yield x, y
yield *x,
yield *x, *y
Introducing a separate `yield_list` is the simplest way I've been figure out to
do this - separating out the special case of `starred_item ,`.
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2024-09-26 12:35:17 -07:00
43979fad90
Programming FAQ: Mention object.__setattr__ as a technique for delegation ( #124617 )
...
This is used for example by threading.local in the stdlib.
2024-09-26 11:50:31 -07:00
2c472d36b7
Doc: Use the short version for daily downloads ( #124602 )
2024-09-26 16:44:25 +01:00
cf2418076d
gh-119127: functools: Improve docs for partial and Placeholder ( #124575 )
2024-09-26 07:12:56 -07:00
09aebb1fbc
gh-118181: Fix parameter markup in AST docs ( #124473 )
2024-09-26 06:38:25 -07:00
274d9ab619
gh-123560: Correct docs for "empty" format type for floats ( #123561 )
2024-09-26 14:40:18 +02:00
19fed6cf6e
gh-124234: Improve docs for `Mock.reset_mock` ( #124237 )
2024-09-26 15:06:52 +03:00
08a467b537
gh-101100: Make __subclasses__ doctest stable ( #124577 )
...
Using a standard library class makes this test difficult to maintain
as other tests and other parts of the stdlib may create subclasses,
which may still be alive when this test runs depending on GC timing.
2024-09-26 06:26:03 +00:00
1229cb8c14
gh-120284: Enhance `asyncio.run` to accept awaitable objects ( #120566 )
...
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2024-09-26 11:45:08 +05:30
d9296529eb
gh-119127: functools.partial placeholders (gh-119827)
2024-09-26 01:04:38 +00:00
4e829c0e6f
gh-124412: Add helpers for converting annotations to source format ( #124551 )
2024-09-26 00:01:09 +00:00
ffdc80e93d
For-else deserves its own section in the tutorial ( #123946 )
...
* For-else deserves its own section in the tutorial
* remove mention of unrolling the loop
* Update Doc/tutorial/controlflow.rst
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
---------
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2024-09-25 19:18:18 -04:00
99b23c64de
gh-123242: Note that type.__annotations__ may not exist ( #124557 )
...
Closes #123242 . The real criterion is that the attribute does not
exist on heap types, but I don't think we should discuss heap vs.
static types in the language reference.
2024-09-25 16:08:14 -07:00
4e2fb7bdf5
GH-58058: Add quick reference for `ArgumentParser` to argparse docs (gh-124227)
2024-09-25 15:22:17 -07:00
9968caa0cc
gh-41431: Add `datetime.time.strptime()` and `datetime.date.strptime()` ( #120752 )
...
* Python implementation
* C implementation
* Test `date.strptime`
* Test `time.strptime`
* 📜 🤖 Added by blurb_it.
* Update whatsnew
* Update documentation
* Add leap year note
* Update 2024-06-19-19-53-42.gh-issue-41431.gnkUc5.rst
* Apply suggestions from code review
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
* Remove parentheses
* Use helper function
* Remove bad return
* Link to github issue
* Fix directive
* Apply suggestions from code review
Co-authored-by: Paul Ganssle <1377457+pganssle@users.noreply.github.com>
* Fix test cases
---------
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Paul Ganssle <1377457+pganssle@users.noreply.github.com>
2024-09-25 14:43:58 -07:00
68e384c217
gh-124370: Add "howto" for free-threaded Python ( #124371 )
...
* gh-124370: Add "howto" for free-threaded Python
This is a guide aimed at people writing Python code, as oppposed to the
existing guide for C API extension authors.
* Add missing new line
* Update Doc/howto/free-threading-python.rst
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* interned -> immortalized
* Apply suggestions from code review
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
* Update Doc/howto/free-threading-python.rst
Co-authored-by: mpage <mpage@cs.stanford.edu>
* Update docs
* Apply suggestions from code review
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
* A few more updates
* Additional comment on immortal objects
* Mention specializing adaptive interpreter
* Remove trailing whitespace
* Remove mention of C macro
---------
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: mpage <mpage@cs.stanford.edu>
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
2024-09-25 17:31:53 -04:00
7d24ea9db3
gh-121277: Allow `.. versionadded:: next` in docs (GH-121278)
...
Make `versionchanged:: next`` expand to current (unreleased) version.
When a new CPython release is cut, the release manager will replace
all such occurences of "next" with the just-released version.
(See the issue for release-tools and devguide PRs.)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-09-25 23:30:40 +02:00
909c6f7189
gh-123884 Tee of tee was not producing n independent iterators (gh-124490)
2024-09-25 13:38:05 -07:00
0d9d56c4e4
gh-101100: Add a table of class attributes to the "Custom classes" section of the data model docs ( #124480 )
2024-09-25 19:29:58 +00:00
6318ffcba2
Doc: Use ``major.minor`` for documentation distribution archive filenames ( #124489 )
2024-09-25 20:06:54 +01:00
28efeefab7
gh-123756: Disable restart command if pdb is in inline mode ( #123757 )
2024-09-25 11:18:01 -07:00
162d152146
import: permit __name__ for use in __name__ = "__main__": ( #124381 )
...
permit __name__ for use in __name__ = "__main__":
2024-09-25 10:39:14 -07:00
828583a785
gh-123223: Adding hyperlink of argument in warnings.catch_warnings: ( #123231 )
...
* Adding hyperlink of argument
* Modify as reviewer suggested
2024-09-25 10:30:34 -07:00
f8651a2988
gh-123968: fix -f/--float command line option description ( #124517 )
...
* fix -f/--float command line option description
See gh-123968 gh-124009
* Update Doc/library/random.rst
---------
Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
2024-09-25 09:47:45 -07:00
78aeb38f7d
gh-124285: Fix bug where bool() is called multiple times for the same part of a boolean expression ( #124394 )
2024-09-25 15:51:25 +01:00
c58c572a65
gh-123014: Disable pidfd API on older Android versions ( #124458 )
2024-09-25 16:23:30 +02:00
8447c933da
gh-123445: calendar: Improve descriptions for day and month attributes ( #123483 )
...
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
Co-authored-by: Eric V. Smith <ericvsmith@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-09-25 10:24:47 +01:00
0d38409f42
Doc: Improve documentation for the ``path`` argument in ``shutil.which()`` ( #124494 )
2024-09-25 08:54:13 +01:00
5c6e3b7150
gh-90562: Support zero argument super with dataclasses when slots=True (gh-124455)
...
Co-authored-by: @wookie184
Co-authored-by: Carl Meyer <carl@oddbird.net>
2024-09-24 21:26:26 -04:00
af8403a58d
gh-120254: Add a `commands` argument to `pdb.set_trace` ( #120255 )
2024-09-24 12:52:15 -07:00
20ccda000b
GH-87358: Add clarification about nargs and default argparse behaviour ( #124094 )
2024-09-24 19:30:01 +03:00
e69ff34e81
gh-65169: Clarify prog default in argparse (GH-31602)
2024-09-24 10:57:37 +00:00
faef3fa653
gh-124120: Document `Annotated.__origin__` ( #124125 )
...
Co-authored-by: Brian Schubert <brianm.schubert@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-09-24 09:53:04 +03:00
9d344fafc4
gh-124127: Make Py_REFCNT() opaque in limited C API 3.14 ( #124128 )
2024-09-24 08:42:58 +02:00
d56faf28e6
gh-119180: Add discussion of annotations to the 3.14 What's New ( #124393 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-09-23 22:50:13 -07:00
d87482bc4e
gh-119333: Add C api to have contextvar enter/exit callbacks ( #119335 )
...
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
2024-09-23 20:40:17 -07:00
ad7c778546
gh-123990: Good bye WITH_FREELISTS macro (gh-124358)
2024-09-24 01:28:59 +00:00
be76e3f26e
gh-100980: ctypes: Test, document, and fix finalizing _fields_ (GH-124292)
...
- If setting `_fields_` fails, e.g. with AttributeError, don't set the attribute in `__dict__`
- Document the “finalization” behaviour
- Beef up tests: add `getattr`, test Union as well as Structure
- Put common functionality in a common function
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
2024-09-24 02:40:53 +02:00
38a887dc3e
gh-119004: fix a crash in equality testing between `OrderedDict` ( #121329 )
2024-09-23 18:44:36 -05:00
e80dd3035f
gh-116622: Complete Android documentation ( #124259 )
...
Co-authored-by: Russell Keith-Magee <russell@keith-magee.com>
Co-authored-by: T. Wouters <thomas@python.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-09-23 23:09:53 +00:00
8a2baedc4b
Bump Ruff to 0.6.7 ( #124384 )
2024-09-23 22:19:35 +00:00
0060486862
Doc: Add ``make dist-no-html`` ( #124383 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-09-23 23:11:34 +01:00
67201ad53f
GH-65961: Document the deprecation of `__package__` and `__cached__` (GH-124377)
...
The code changes for warning related to `__package__` landed in Python 3.12. `__cached__` doesn't have any changes as it isn't used but only set by the import system.
2024-09-23 14:14:33 -07:00
9e55a02fab
GH-109975: Copyedit 3.13 What's New: Trivia ( #124348 )
2024-09-23 19:32:23 +00:00
e7d465a607
GH-109975: Copyedit 3.13 What's New: Copyedit C API deprecations pending removal ( #124336 )
2024-09-23 19:40:20 +01:00
f3b2c36deb
GH-109975: Copyedit 3.13 What's New: Build Changes ( #124343 )
...
Co-authored-by: Malcolm Smith <smith@chaquo.com>
2024-09-23 11:30:45 -07:00
2f6d4109b8
GH-109975: Copyedit 3.13 What's New: Porting to Python 3.13 ( #124341 )
...
Copyedit Porting to Python 3.13
2024-09-23 11:14:37 -07:00
6203ef35dd
Replace the term `Immutable` with a `Hashable` in the `sequence` entry of the Glossary ( #124350 )
...
The term `Immutable` in the `sequence` entry of the glossary is used incorrectly, in fact dicts accepts hashable keys, which is not the same as immutable.
2024-09-23 16:34:08 +00:00
9d0a75269c
GH-109975: Copyedit 3.13 What's New: C API ( #124313 )
2024-09-23 14:28:17 +01:00
5f5c0b9c23
GH-79714: Add mention of stderr for clarity to ArgumentParser.exit() (GH-123932)
2024-09-23 12:08:03 +03:00
d3e79d75d1
gh-124130: Notes on empty string corner case of category `\B` ( #124133 )
...
Signed-off-by: y5c4l3 <y5c4l3@proton.me>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2024-09-23 08:58:14 +02:00
622368d99c
Fix typo in XMLParser doc ( #124129 )
2024-09-20 12:42:44 +02:00
5f01111594
Docs: Update two FAQs for Python 3 ( #124247 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-09-19 21:50:05 +03:00
8f82d9aa21
bpo-41843: Reenable use of sendfile in shutil module on Solaris (GH-23893)
2024-09-19 14:47:05 +00:00
9a6e2336e4
Fix `make htmllive` target (GH-124219)
...
Allow `make -C Doc htmllive` to work without manual venv activation
Set PATH to ensure that `sphinx-autobuild` can find `sphinx-build`.
2024-09-18 21:02:20 +00:00
21d2a9ab2f
gh-116022: Improve `repr()` of AST nodes ( #117046 )
...
Co-authored-by: AN Long <aisk@users.noreply.github.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2024-09-18 10:28:22 -07:00
32119fc377
gh-118915: Add/fix docs entries for some new 3.13 C API (GH-124134)
2024-09-18 14:15:43 +02:00
8a284e1896
gh-119771: Set errno on overflows in _Py_c_pow() ( #120256 )
...
Before we did this in complex_pow() and behavior of the public C API
function _Py_c_pow() was different from the pure-python pow().
2024-09-18 10:39:11 +02:00
646f16bdee
gh-124153: Implement `PyType_GetBaseByToken()` and `Py_tp_token` slot (GH-124163)
2024-09-18 09:18:19 +02:00
d8c0fe1944
gh-124194: Fix wrong issue number in What's New in Python 3.8 ( #124195 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-09-18 01:51:15 +01:00
ab80c6b402
GH-103484: Fix broken links reported by linkcheck ( #124169 )
2024-09-17 17:05:15 +02:00
33eeccf6d4
Use pep role instead of url ( #121611 )
2024-09-17 16:02:14 +03:00
0a32c6959c
GH-103484: Fix permanently redirects reported by linkcheck (GH-124144)
...
Fix redirects reported by linkcheck, update docs conf.py checks.
2024-09-17 02:53:38 +00:00
05235e3c16
GH-109975: Copyedit 3.13 What's New: New Deprecations ( #123845 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2024-09-16 17:03:46 +00:00
38809171b8
gh-121607: Edited source file import recipe to make it more clear ( #121519 )
...
Co-authored-by: Brett Cannon <brett@python.org>
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
2024-09-13 16:36:40 -07:00
cd06f5e323
Minor edits to the descriptor guide (GH-123928)
2024-09-13 17:02:37 -05:00
4f25e282ad
gh-100554: Fix formatting of type.rst modifications ( #124066 )
2024-09-13 18:35:08 +00:00
74330d992b
gh-100554: Add ``Py_tp_vectorcall`` slot to set ``PyTypeObject.tp_vectorcall`` using the ``PyType_FromSpec`` function family. ( #123332 )
2024-09-13 17:40:25 +02:00
bbb36c0934
Normalize cdecl formatting as found elsewhere on ctypes.rst ( #121379 )
2024-09-13 18:26:16 +03:00
39612103dd
Update to 3.13 the output of exceptions raised ( #123888 )
2024-09-13 15:17:30 +00:00
e6bb1a2b28
gh-119802: Update memory management docs for free-threaded build (gh-124006)
...
* gh-119802: Update memory management docs for free-threaded build
* nit
* nit
* Address code review
* nit
* Update Doc/c-api/memory.rst
Co-authored-by: Sam Gross <colesbury@gmail.com>
---------
Co-authored-by: Sam Gross <colesbury@gmail.com>
2024-09-13 15:15:44 +00:00
bb904e063d
closes gh-124016: update Unicode to 16.0.0 ( #124017 )
2024-09-13 07:47:04 -07:00
432bf31327
gh-123909: PyType_From*: Disallow metaclasses with custom tp_new (GH-123947)
2024-09-13 13:18:49 +02:00
e5b0185e43
GH-101599: Update docs to remove redundant option in argparse tutorial ( #124025 )
2024-09-13 09:14:52 +03:00
584cdf8d41
gh-123614: Add save function to turtle.py ( #123617 )
2024-09-12 21:36:17 -07:00
a47cd21890
gh-123976: Refresh docs around custom providers. ( #123977 )
...
* gh-123976: Refresh docs around custom providers.
* Remove excess whitespace.
2024-09-13 02:29:08 +00:00
8e99495701
gh-118577: Clarify that inspect.BoundArguments prefers to put values in args (GH-119936)
2024-09-12 14:03:32 +02:00
f5597dbd0e
Docs: Drop letter PDF ( #123912 )
2024-09-12 13:49:19 +03:00
77c68b40d5
gh-111997: update what's new in 3.13 re C API for monitoring events ( #123822 )
2024-09-12 11:32:57 +01:00
3bd942f106
Fix "The Matrix" movie release year in `typing.rst` ( #123965 )
2024-09-11 21:25:23 +03:00
eb169f4027
Update Sphinx Lint and fix unnecessary parentheses in `:func:`s ( #123960 )
2024-09-11 21:05:15 +03:00
e07154fd1e
gh-123958: apply docstring removal optimization in ast_opt instead of codegen ( #123959 )
2024-09-11 17:02:28 +00:00
ef05801ba0
gh-108951: Document how to terminate an asyncio.TaskGroup ( #123837 )
...
We don't want to add another API, since the recipe is straightforward and rarely needed.
The advantage is that we could backport this to the earliest Python version that has taskgroups (3.11, alas in security mode already, so we'll just do 3.12 and 3.13).
2024-09-11 08:43:24 -07:00
5436d8b9c3
gh-119180: Documentation for PEP 649 and 749 ( #122235 )
...
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
2024-09-11 07:49:59 -07:00
3597642ed5
gh-122239: Add actual count in unbalanced unpacking error message when possible ( #122244 )
2024-09-10 16:07:30 +01:00
07f0bf5aa4
gh-123165: update docs signature for `dis.disassemble` ( #123808 )
2024-09-10 15:25:27 +01:00
1b29f4144c
gh-123905: Update TOML description to include version number (GH-123906)
...
Update TOML description to include version number
There is some movement, currently blocked, that would update the TOML spec to 1.1.0; this would include breaking changes to what characters are allowed. Thus, it is worthwhile for the library page to be clear which version is implemented here.
Co-authored-by: Paul Hoffman <phoffman@proper.com>
2024-09-10 14:16:32 +00:00
962304a54c
gh-123609: Clarify usage of standalone `PyBUF_FORMAT` (GH-123778)
2024-09-10 15:05:28 +02:00
2afba5ca6d
Small improvements to the itertools docs (GH-123885)
2024-09-09 20:57:49 -05:00
d359a7683e
gh-66449: remove duplicate configparser section in 3.13 whatsnew ( #123874 )
2024-09-09 16:40:18 -04:00
c0c2aa7644
gh-122213: Add notes for pickle serialization errors (GH-122214)
...
This allows to identify the source of the error.
2024-09-09 21:28:55 +03:00
b950831c94
Mention `curl` in `contextvars` docs ( #123838 )
2024-09-09 16:58:49 +03:00
32bc2d6141
gh-123834: Add `symtable` to the list of modules with a CLI ( #123835 )
2024-09-09 13:45:43 +02:00
aa3f11f80a
gh-108219: Add credits to the free-threading entry in What's New ( #123802 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Itamar Oren <itamarost@gmail.com>
2024-09-08 21:20:15 +01:00
beee91cdcc
gh-123789: `secrets.randbits` returns only non-negative int ( #123801 )
2024-09-07 21:17:59 -07:00
93050e4614
Remove excessive backticks in logging doc ( #123813 )
2024-09-07 18:09:02 +00:00
5a4fb7ea1c
gh-109975: Add links to py-free-threading.github.io ( #123776 )
...
Co-authored-by: Victor Stinner <vstinner@python.org>
2024-09-06 20:12:12 +03:00
56e4a417ce
gh-123523: Rework typing documentation for generators and coroutines, and link to it from `collections.abc` docs ( #123544 )
2024-09-06 17:41:06 +01:00
d343f977ba
gh-121645: Fix typo in PyBytes_Join() doc ( #123783 )
2024-09-06 16:08:17 +02:00
67957ea77d
gh-103066: Add links and `help` in site.py constants ( #103777 )
...
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-09-06 10:29:28 +03:00
84ad264ce6
gh-123275: Support `-Xgil=1` and `PYTHON_GIL=1` on non-free-threaded builds (gh-123276)
2024-09-06 08:53:47 +09:00
b5aa271f86
gh-123476: Add support for TCP_QUICKACK socket setting to Windows ( #123478 )
...
Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Steve Dower <steve.dower@microsoft.com>
2024-09-05 22:59:48 +02:00
6e43928831
Swap the and from in sentence in init_config.rst ( #120086 )
2024-09-05 23:04:15 +03:00
9aea9c100f
gh-85453: Improve instance attributes mark up on datetime.rst ( #123655 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-09-05 20:56:52 +03:00
327463aef1
gh-123207: Clarify the documentation for the mro lookup for super() (GH-123417)
2024-09-05 15:52:04 +02:00
16be8db6be
gh-123465: Allow Py_RELATIVE_OFFSET for __*offset__ members (GH-123474)
2024-09-05 14:14:05 +02:00
c530ce1e9d
gh-118710: Make IPv*Address.version & max_prefixlen available on the class (GH-120698)
2024-09-04 15:51:12 +02:00
0d6b6e34a2
gh-107954, PEP 741: Add PyInitConfig_AddModule() function ( #123668 )
2024-09-04 11:41:57 +00:00
7d2c2f24da
gh-123463: Include logging_flow diagram in non-HTML docs (GH-123464)
2024-09-04 13:14:36 +02:00
c08ede2714
gh-123392: Clarify wording regarding parameters that are functions to be called (GH-123394)
2024-09-04 11:05:46 +00:00
cfbc841ef3
gh-123621: Fix `datamodel.rst` with proper `dict` notation ( #123648 )
2024-09-03 22:52:00 +03:00
68fe5758bf
gh-123579: Document exclamation token ( #123612 )
2024-09-03 16:49:38 +02:00
ef9d54703f
gh-107954, PEP 741: Add PyInitConfig C API ( #123502 )
...
Add Doc/c-api/config.rst documentation.
2024-09-03 12:33:49 +00:00
9e079c220b
gh-123580: Fix `signed_number` token in documentation (GH-123582)
...
Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
2024-09-03 10:01:26 +02:00
9684f40b9f
gh-123430: Add dark mode support to pages generated by http.server ( #123475 )
...
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
2024-09-03 09:32:11 +03:00
33b790978d
gh-107954, PEP 741: Add PyConfig_Get()/Set() functions ( #123472 )
...
Add PyConfig_Get(), PyConfig_GetInt(), PyConfig_Set() and
PyConfig_Names() functions to get and set the current runtime Python
configuration.
Add visibility and "sys spec" to config and preconfig specifications.
_PyConfig_AsDict() now converts PyConfig.xoptions as a dictionary.
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2024-09-02 23:25:08 +02:00
22fdb8cf89
gh-118508: Clarify which characters are matched by `\s` ( #119155 )
...
Clarify re syntax
2024-09-02 07:48:15 -04:00
c3ed775899
gh-123570: Add link to `weakref.ref` from `weakref_slot` docs in `dataclasses` ( #123571 )
2024-09-02 09:58:38 +03:00
9a32a2588e
gh-109975: Remove dangling angle bracket from 3.13.rst ( #123589 )
...
Remove dangling angle bracket from 3.13.rst
2024-09-02 07:57:56 +03:00
e3f76e5cfb
Remove irrelevant detail from example code. (gh-123587)
2024-09-01 20:04:33 -05:00
cb6d25011e
Simplify Property() recipe to focus on the essentials (gh-123585)
2024-09-01 17:49:38 -05:00
75e72822a3
gh-91126: Docs and tests for slotted dataclasses with `__init_subclass__` ( #123342 )
2024-09-01 13:25:34 +03:00
bac0e115b8
gh-123550: Fix code snippet of `BUILD_TUPLE` in `dis` docs ( #123551 )
2024-09-01 07:11:40 +01:00
0ff59d707c
GH-109975: Copyedit 3.13 What's New: Removals ( #123529 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-09-01 05:41:17 +00:00
0b6acfee04
gh-123494: Improve documentation for ``webbrowser`` return types ( #123495 )
...
Document the return value for ``webbrowser.open*()``.
2024-09-01 06:17:03 +01:00
cf472577e2
gh-123517: Remove unnecessary ``:meth:`` parentheses ( #123518 )
2024-09-01 05:59:42 +01:00
5332d989af
gh-123407: Enable translating literal and code blocks ( #123408 )
2024-08-31 07:31:36 +01:00
d8e69b2c1b
gh-122854: Add Py_HashBuffer() function ( #122855 )
2024-08-30 15:42:27 +00:00
3d60dfbe17
gh-121645: Add PyBytes_Join() function ( #121646 )
...
* Replace _PyBytes_Join() with PyBytes_Join().
* Keep _PyBytes_Join() as an alias to PyBytes_Join().
2024-08-30 12:57:33 +00:00
103a0470e3
gh-123492: Remove unnecessary `:func:` parentheses ( #123493 )
2024-08-30 14:34:09 +03:00
40fff90ae3
gh-101860: document `property.__name__` (GH-123399)
2024-08-28 16:10:13 +02:00
9e108b8719
Fix typos in docs, error messages and comments ( #123336 )
...
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2024-08-28 14:41:04 +03:00
4c6dca8292
gh-120389: Add PyLong_FromInt64() and PyLong_AsInt64() ( #120390 )
...
Add new functions to convert C <stdint.h> numbers from/to Python int:
* PyLong_FromInt32()
* PyLong_FromUInt32()
* PyLong_FromInt64()
* PyLong_FromUInt64()
* PyLong_AsInt32()
* PyLong_AsUInt32()
* PyLong_AsInt64()
* PyLong_AsUInt64()
2024-08-28 10:16:13 +00:00
6f563e364d
gh-123254: Improve `tuple` C API docs with more info about errors ( #123255 )
...
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
2024-08-28 10:30:21 +03:00
08c0166ce4
gh-109975: Fix a typo in What's New in Python 3.13 ( #123393 )
2024-08-27 15:53:45 +01:00
f49a91648a
GH-117759: Document incremental GC (GH-123266)
...
* Update what's new
* Update gc module docs and fix inconsistency in gc.get_objects
2024-08-27 15:23:39 +01:00
6754566a51
gh-120426: Reword the glossary term "immortal" (GH-123191)
...
Reword the glossary term "immortal", mark it as an implementation detail
2024-08-27 13:37:56 +02:00
7bd6ebf696
GH-73991: Prune `pathlib.Path.copy()` and `copy_into()` arguments ( #123337 )
...
Remove *ignore* and *on_error* arguments from `pathlib.Path.copy[_into]()`,
because these arguments are under-designed. Specifically:
- *ignore* is appropriated from `shutil.copytree()`, but it's not clear
how it should apply when the user copies a non-directory. We've changed
the callback signature from the `shutil` version, but I'm not confident
the new signature is as good as it can be.
- *on_error* is a generalisation of `shutil.copytree()`'s error handling,
which is to accumulate exceptions and raise a single `shutil.Error` at
the end. It's not obvious which solution is better.
Additionally, this arguments may be challenging to implement in future user
subclasses of `PathBase`, which might utilise a native recursive copying
method.
2024-08-26 17:05:34 +01:00
033d537cd4
GH-73991: Make `pathlib.Path.delete()` private. ( #123315 )
...
Per feedback from Paul Moore on GH-123158, it's better to defer making
`Path.delete()` public than ship it with under-designed error handling
capabilities.
We leave a remnant `_delete()` method, which is used by `move()`. Any
functionality not needed by `move()` is deleted.
2024-08-26 16:26:34 +01:00
c68a93c582
GH-73991: Add `pathlib.Path.copy_into()` and `move_into()` ( #123314 )
...
These two methods accept an *existing* directory path, onto which we join
the source path's base name to form the final target path.
A possible alternative implementation is to check for directories in
`copy()` and `move()` and adjust the target path, which is done in several
`shutil` functions. This behaviour is helpful in a shell context, but
less so in a stored program that explicitly specifies destinations. For
example, a user that calls `Path('foo.py').copy('bar.py')` might not
imagine that `bar.py/foo.py` would be created, but under the alternative
implementation this will happen if `bar.py` is an existing directory.
2024-08-26 14:14:23 +01:00
70bfef52b5
gh-82378: Document the difference between sys.tracebacklimit and the limit arguments ( #123286 )
2024-08-25 23:50:43 +01:00
249b083ed8
gh-122982: Extend the deprecation period for bool inversion by two years ( #123306 )
2024-08-25 12:24:44 -07:00
625d0705b9
GH-73991: Add `pathlib.Path.move()` ( #122073 )
...
Add a `Path.move()` method that moves a file or directory tree, and returns a new `Path` instance pointing to the target.
This method is similar to `shutil.move()`, except that it doesn't accept a *copy_function* argument, and it doesn't check whether the destination is an existing directory.
2024-08-25 16:51:51 +01:00
74ff496dce
GH-109975: Copyedit 3.13 What's New: Optimizations ( #123301 )
2024-08-25 16:17:46 +03:00
9b3749849e
GH-123299: Move ctypes What's New entry to 3.14 ( #123300 )
2024-08-25 01:41:44 +01:00
127660bcdb
GH-109975: Copyedit 3.13 What's New: Improved Modules ( #123132 )
...
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2024-08-24 14:32:35 +01:00
b178beef26
Docs: Fix Makefile syntax ( #123287 )
2024-08-24 12:57:38 +00:00
90b6d0e0f8
gh-123213: Fixed xml.etree.ElementTree.Element.extend and assignment to no longer hide exceptions (GH-123214)
2024-08-23 12:12:58 +03:00
b1d3bd2e09
gh-123165: make `dis` functions render positions on demand ( #123168 )
2024-08-21 14:46:24 +01:00
9dbd123755
gh-123084: Turn `shutil.ExecError` into a deprecated alias of `RuntimeError` ( #123125 )
2024-08-21 00:39:24 +00:00
0480052ea1
gh-109975: Copyedit What's New in Python 3.13 ( #123150 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-19 23:51:37 +00:00
be257c5815
gh-123049: configparser: Allow to create the unnamed section from scratch. ( #123077 )
...
---------
Co-authored-by: Jason R. Coombs <jaraco@jaraco.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2024-08-18 15:52:25 -04:00
b0f462d4c8
gh-123110: correct note about _Bool in the struct module docs (GH-123111)
2024-08-18 16:58:58 +03:00
79c542b5cc
Docs: Run ``latexmk`` in parallel when creating PDFs ( #123113 )
2024-08-17 20:58:06 +00:00
d60b97a833
GH-109975: Copyedit 3.13 What's New: Other Language Changes ( #123086 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-08-17 12:09:42 +00:00
ce4b9c8464
gh-121477: mention new PyLong_*Bytes() functions in PyLong_FromString() ( #121478 )
...
* gh-121477: mention new PyLong_*Bytes() functions in PyLong_FromString()
* Update Doc/c-api/long.rst
---------
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2024-08-17 09:13:31 +00:00
e9287ea426
fix typo in dis.rst ( #121612 )
2024-08-17 14:20:58 +05:30
26de1b245e
Remove unneeded verb in the phrase in sys.rst ( #122718 )
2024-08-17 14:18:31 +05:30
8a59deca59
gh-122519: Adding socket module shutdown() constants description ( #122543 )
2024-08-17 13:59:23 +05:30
a07cf4ce25
mention pypy somewhat more prominently in the pyrepl section of whatsnew ( #123063 )
2024-08-16 11:38:44 +00:00
3203a74129
gh-113190: Reenable non-debug interned string cleanup (GH-113601)
2024-08-15 11:55:09 +00:00
b106cf8d97
GH-109975: Copyedit 3.13 What's New: New Features ( #122990 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Brandt Bucher <brandtbucher@gmail.com>
2024-08-15 10:08:15 +01:00
1054a755a3
GH-103484: Tell linkcheck to ignore debian manpage redirects ( #123019 )
2024-08-14 22:35:23 +01:00
8e2dc7f380
gh-123005: Add version added in enum.Flag.__len__ (GH-123007)
2024-08-14 13:30:33 -07:00
315a933a5b
Fix doctrees directory for the gettext builder ( #122997 )
2024-08-14 11:38:29 +01:00
906b796af8
gh-122873: Allow "python -m json" to work ( #122884 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Alyssa Coghlan <ncoghlan@gmail.com>
2024-08-13 17:09:38 +01:00
db6f5e1933
GH-109975: Copyedit 3.13 What's New: Release Highlights ( #122958 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-08-13 15:30:59 +01:00
be90648fb2
gh-122944: Fix incorrect prompt strings in the Python Tutorial ( #122949 )
...
In the REPL, top level comments are followed by a primary, not secondary prompt.
Fix the places in the in the tutorial that use the latter.
2024-08-12 14:30:08 -04:00
a6644d4464
GH-73991: Rework `pathlib.Path.copytree()` into `copy()` ( #122369 )
...
Rename `pathlib.Path.copy()` to `_copy_file()` (i.e. make it private.)
Rename `pathlib.Path.copytree()` to `copy()`, and add support for copying
non-directories. This simplifies the interface for users, and nicely
complements the upcoming `move()` and `delete()` methods (which will also
accept any type of file.)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-11 22:43:18 +01:00
ea70439bd2
gh-122701: Fix wording of raw strings/bytes in `lexical_analysis.rst` ( #122702 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-11 21:02:50 +00:00
db8b83c2b0
Docs: Standardise versionchanged text in weakref.rst ( #122898 )
2024-08-11 21:40:11 +01:00
bc9d92c679
gh-122858: Deprecate `asyncio.iscoroutinefunction` ( #122875 )
...
Deprecate `asyncio.iscoroutinefunction` in favor of `inspect.iscoroutinefunction`.
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2024-08-11 16:35:51 +00:00
363374cf69
GH-120794: Use example paths with multiple parts in pathlib docs ( #122887 )
...
In the documentation of `PosixPath` and `WindowsPath`, and their `Pure*`
equivalents, use example paths with multiple non-anchor parts.
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-10 21:21:17 +00:00
0959142e4d
gh-122868: Add more lower bounds for sphinxcontrib dependencies ( #122891 )
2024-08-10 20:50:43 +00:00
5580f31c56
gh-115808: Add ``is_none`` and ``is_not_none`` to ``operator`` ( #115814 )
...
Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru>
2024-08-10 20:16:34 +01:00
0fd97e46c7
gh-122868: Add lower bounds for sphinxcontrib dependencies ( #122870 )
...
* Docs: Add lower bounds for sphinxcontrib dependencies
* oops
2024-08-10 01:18:46 +03:00
d3239976a8
gh-105376: Restore deprecated logging warn() method ( #122775 )
...
This reverts commit dcc028d9246c54e5d721
2024-08-09 15:13:24 +02:00
aab18f4d92
gh-112301: Update documentation for configure options (``--disable-safety`` and ``--enable-slower-safety``) ( #122758 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-08 20:35:00 +01:00
e006c7371d
gh-105201: Add PyIter_NextItem() ( #122331 )
...
Return -1 and set an exception on error; return 0 if the iterator is
exhausted, and return 1 if the next item was fetched successfully.
Prefer this API to PyIter_Next(), which requires the caller to use
PyErr_Occurred() to differentiate between iterator exhaustion and errors.
Co-authered-by: Irit Katriel <iritkatriel@yahoo.com>
2024-08-08 00:47:15 +02:00
967a4f1d18
Docs: Change `remove` to `removes` for consistency ( #121072 )
2024-08-07 16:30:00 +01:00
c25898d51e
Doc: cmdline.rst: Include -P and -R in usage ( #122590 )
...
* ``-P``: safe path (https://docs.python.org/3/using/cmdline.html#cmdoption-P )
* ``-R``: hash randomization (https://docs.python.org/3/using/cmdline.html#cmdoption-R )
2024-08-07 16:01:44 +01:00
76bdeebef6
gh-122511: Improve documentation for object identity of mutable/immutable types ( #122512 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-07 13:40:19 +00:00
98dba73010
GH-73991: Rework `pathlib.Path.rmtree()` into `delete()` ( #122368 )
...
Rename `pathlib.Path.rmtree()` to `delete()`, and add support for deleting
non-directories. This simplifies the interface for users, and nicely
complements the upcoming `move()` and `copy()` methods (which will also
accept any type of file.)
2024-08-07 01:34:44 +01:00
1429651a06
gh-121103: Update site module docs for free-threaded installs ( #122737 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-08-06 14:34:34 -04:00
8ce70d6c69
gh-122058: `Lib/inspect`: Update docstrings for `isfunction`, `isgenerator`, `isframe`, `iscode`. ( #122059 )
...
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
2024-08-06 14:47:31 +02:00
1422500d02
gh-121367: [doc] BUILD_TUPLE arg can be 0 ( #122663 )
2024-08-05 10:17:55 +01:00
f5c39b3e9c
gh-122661: Remove GNU make-specific directive from Doc/Makefile ( #122662 )
2024-08-04 17:02:29 +03:00
151934a324
gh-122623: Improve `c-api/bytearray.rst` with error handling info ( #122624 )
2024-08-04 00:55:47 +03:00
95f5c89b54
GH-121970: Fix ``gettext`` for audit events ( #122651 )
2024-08-03 17:41:26 +01:00
06eb9701a1
Doc: Grammar fix in ``library/ssl.rst``, 'Verifying certificates' ( #122646 )
2024-08-03 14:24:29 +01:00
d91ac525ef
gh-122613: Document PyLong_GetInfo() (part of Limited API) (GH-#122280)
2024-08-03 13:20:10 +02:00
7a5c4103b0
Doc: Improve wording of ``os.path.commonpath()`` ( #122627 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-03 11:18:59 +00:00
498376d7a7
gh-122445: populate only modified fields in __static_attributes__ ( #122446 )
2024-08-02 15:40:42 +01:00
fb864c76cd
gh-121723: Relax constraints on queue objects for `logging.handlers.QueueHandler`. (GH-122154)
2024-08-02 12:16:32 +01:00
sobolevn
Max Bachmann
Ned Batchelder
Hugo van Kemenade
Gregory P. Smith
Jelle Zijlstra
Matthew Rahtz
Adam Turner
Tomas R
Sergey B Kirpichev
Ron Frederick
dgpb
Savannah Ostrowski
Nice Zombies
Sam Gross
Petr Viktorin
Raymond Hettinger
Alex Waygood
Tian Gao
Thomas Grainger
Damien
Robert Wolff
Irit Katriel
Malcolm Smith
Mat S
Tom Most
Eric V. Smith
Stanley
Victor Stinner
Jason Fried
Donghee Na
Bénédikt Tran
Brett Cannon
decorator-factory
Y5
Jacob Walls
Jakub Kulík
Zachary Ware
neonene
Bradley Reynolds
Rafael Fontenelle
Chris Barker
Oleg Iarygin
Wenzel Jakob
utkonos
Benjamin Peterson
Yngve Mardal Moe
Jason R. Coombs
Tushar Sadhwani
Peter Bierma
Anthony Sottile
Serhiy Storchaka
Wulian
Wei-Hsiang (Matt) Wang
Nathan Goldbaum
Stanislav Terliakov
David Caron
nkinnan
edson duarte
Pieter Eendebak
Alexander Bessman
ryan-duve
Lipták Attila (Flash)
Shaygan Hooshyari
CBerJun
Yorik Hansen
jlallas384
Aarni Koskela
Maciej Olko
Daniel Hollas
Mark Shannon
Barney Gale
CF Bolz-Tereick
Kirill Podoprigora
Bar Harel
Pedro Lacerda
mathysEthical
Eddie Elizondo
Trey Hunner
Nico Mexis
Nate Ohlson
Erlend E. Aasland
smij720
Wim Jeantine-Glenn
Libor Martínek
scottwoodall
Matth-M