a5716a3091
gh-101100: Fix Sphinx warnings in `library/unittest.mock.rst` ( #124106 )
2024-10-09 17:02:18 +03:00
e0835aff2e
gh-125168: Fix typo in `__future__.rst` ( #125183 )
...
* Update `__future__.rst`
Fixed typo in the sentence :pep:`649`: *Deferred evaluation of annotations using descriptors* - James McCarthy
* Update `__future__.rst`
Fixed sphinx formatting
2024-10-09 16:17:18 +03:00
3024b16d51
gh-101100: Consolidate documentation on `ModuleType` attributes ( #124709 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Barry Warsaw <barry@python.org>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2024-10-09 10:53:57 +00:00
21c04e1a97
gh-124969: Fix locale.nl_langinfo(locale.ALT_DIGITS) (GH-124974)
...
Now it returns a tuple of up to 100 strings (an empty tuple on most locales).
Previously it returned the first item of that tuple or an empty string.
2024-10-09 11:42:08 +03:00
7f93dbf6fe
docs: in venv table use executable name (GH-124315)
...
Co-authored-by: musvaage <musvaage@users.noreply.github.com>
2024-10-09 09:04:35 +01:00
78406382c9
gh-101552: Allow pydoc to display signatures in source format ( #124669 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-10-09 05:03:53 +00:00
37228bd16e
GH-124478: Cleanup argparse documentation ( #124877 )
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Tomas R <tomas.roun8@gmail.com>
2024-10-08 15:07:29 -07:00
b2a7272408
Misc improvements to the itertools docs (gh-125147)
2024-10-08 14:02:58 -05:00
760b1e103a
gh-124832: Add a note to indicate that `datetime.now` may return the same instant ( #124834 )
...
* Update datetime.rst
* Update datetime.rst
replace warning with note
* Update Doc/library/datetime.rst
Co-authored-by: Victor Stinner <vstinner@python.org>
* Update Doc/library/datetime.rst
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
---------
Co-authored-by: Victor Stinner <vstinner@python.org>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2024-10-08 11:17:53 -07:00
5967dd8a4d
gh-112433 add versionadded for `ctypes.Structure._align_` ( #125087 )
...
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2024-10-08 12:41:46 +00:00
e8773e59a8
Doc: Improve description of ``GET_LEN`` opcode ( #114583 )
2024-10-08 17:55:40 +05:30
93b9e6bd7d
gh-69998: Fix decoding error in locale.nl_langinfo() (GH-124963)
...
The function now sets temporarily the LC_CTYPE locale to the locale
of the category that determines the requested value if the locales are
different and the resulting string is non-ASCII.
This temporary change affects other threads.
2024-10-08 11:27:49 +03:00
27390990fa
gh-70870: Clarify dual usage of 'free variable' ( #122545 )
...
The term "free variable" has unfortunately become genuinely
ambiguous over the years (presumably due to the names of
some relevant code object instance attributes).
While we can't eliminate that ambiguity at this late date, we can
at least alert people to the potential ambiguity by describing
both the formal meaning of the term and the common
alternative use as a direct synonym for "closure variable".
---------
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
2024-10-08 07:52:12 +00:00
7ffe94fb24
gh-124653: Relax (again) detection of queue API for logging handlers (GH-124897)
2024-10-07 19:42:19 +01:00
10094a533a
gh-125018: Fix role syntax ( #125050 )
2024-10-07 17:51:53 +01:00
cda3b5a576
gh-125018: Add importlib.metadata semantic link targets ( #125027 )
...
This allows direct intersphinx references to APIs via references
like `` :func:`importlib.metadata.version` ``.
---------
Co-authored-by: Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-10-07 23:44:18 +10:00
7487db4c7a
gh-121249: Support _Complex types in the struct module ( #121613 )
...
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
2024-10-07 13:53:02 +02:00
1e098dc766
gh-125025: `_thread` docs: fix/update the *caveats* list (GH-125026)
2024-10-06 15:57:03 -07:00
7ecaf21946
Simplify partial() rough equivalent code (gh-124941)
2024-10-03 19:54:53 +00:00
04bfea2d26
gh-66436: Improved prog default value for argparse.ArgumentParser (GH-124799)
...
It can now have one of three forms:
* basename(argv0) -- for simple scripts
* python arv0 -- for directories, ZIP files, etc
* python -m module -- for imported modules
Co-authored-by: Alyssa Coghlan <ncoghlan@gmail.com>
2024-10-01 22:51:40 +03:00
d150e4abcf
Highlight `datetime.timedelta.seconds` vs `.total_seconds()` in docs. (GH-124811)
...
Thanks to the reviewers for suggesting the use of a "caution" section instead of "warning" or "note".
2024-10-01 18:10:13 +00:00
5e0abb4788
gh-116750: Add clear_tool_id function to unregister events and callbacks ( #124568 )
2024-10-01 13:32:55 -04:00
3e3a4d2315
gh-118974: Add `decorator` argument to `make_dataclass` (gh-122723)
...
This is to allow the `dataclasses.make_dataclass` infrastructure to be used with another decorator that's compliant with `typing.dataclass_transform`. The new `decorator` argument to `dataclasses.make_dataclass` is `dataclasses.dataclass`, which used to be hard coded.
2024-10-01 09:51:51 -04:00
b5774603a0
gh-124400: Use the normal command path for breakpoint commands ( #124401 )
...
Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
2024-09-29 19:46:16 -04:00
76fbee642e
Docs: improve generic `typing.NamedTuple` example ( #124739 )
2024-09-29 12:07:05 +01:00
f1a2417b9e
gh-61181: Fix support of choices with string value in argparse (GH-124578)
...
Substrings of the specified string no longer considered valid values.
2024-09-29 10:57:21 +03:00
c976d789a9
docs: improve venv docs ( #124540 )
...
- Move "versionchanged" notes that apply to the whole class to the
end of the class docs
- Remove or move notes next to the method list that apply to individual
methods.
- Mark up parameters using the appropriate syntax
- Do not capitalize "boolean"
- Shorten some text
2024-09-28 05:50:09 -07:00
2357d5ba48
gh-90190: Add doc for using `singledispatch` with precise collection type hints ( #116544 )
2024-09-27 21:10:29 +00:00
2e155536ca
Itertool docs: Minor clarifications, wording tweaks, spacing, and active voice. (gh-124690)
...
Minor clarifications, wording tweaks, spacing, and active voice.
2024-09-27 18:43:46 +00:00
6716dd1c33
Fixup indentation for docs on `ModuleSpec` attributes ( #124681 )
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2024-09-27 17:35:09 +00:00
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
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
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
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
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
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
28efeefab7
gh-123756: Disable restart command if pdb is in inline mode ( #123757 )
2024-09-25 11:18:01 -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
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
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
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
8f82d9aa21
bpo-41843: Reenable use of sendfile in shutil module on Solaris (GH-23893)
2024-09-19 14:47:05 +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
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
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
bbb36c0934
Normalize cdecl formatting as found elsewhere on ctypes.rst ( #121379 )
2024-09-13 18:26:16 +03:00
bb904e063d
closes gh-124016: update Unicode to 16.0.0 ( #124017 )
2024-09-13 07:47:04 -07: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
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
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
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
2afba5ca6d
Small improvements to the itertools docs (GH-123885)
2024-09-09 20:57:49 -05: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
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
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
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
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
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
c530ce1e9d
gh-118710: Make IPv*Address.version & max_prefixlen available on the class (GH-120698)
2024-09-04 15:51:12 +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
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
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
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
Hugo van Kemenade
JamesMcCarthy21
Alex Waygood
Serhiy Storchaka
musvaage
Jelle Zijlstra
Savannah Ostrowski
Raymond Hettinger
spacemanspiff2007
monkeyman192
Kirill Podoprigora
Alyssa Coghlan
Bénédikt Tran
Adam Turner
Sergey B Kirpichev
Jan Kaliszewski
Gregory P. Smith
Tian Gao
Victorien
CBerJun
Matt Delengowski
sobolevn
Tomas R
Ron Frederick
dgpb
Nice Zombies
Petr Viktorin
Damien
Robert Wolff
Irit Katriel
Malcolm Smith
Mat S
Tom Most
Eric V. Smith
Stanley
Brett Cannon
Y5
Jacob Walls
Jakub Kulík
Rafael Fontenelle
Chris Barker
utkonos
Benjamin Peterson
Yngve Mardal Moe
Jason R. Coombs
Wulian
Wei-Hsiang (Matt) Wang
Stanislav Terliakov
David Caron
nkinnan
edson duarte
Pieter Eendebak
ryan-duve
jlallas384
Aarni Koskela