summaryrefslogtreecommitdiffstats
path: root/Doc/library
Commit message (Collapse)AuthorAgeFilesLines
* gh-127949: add docs for asyncio policy deprecation (#128269)Kumar Aditya2024-12-261-0/+8
|
* gh-128035: Add ssl.HAS_PHA to detect libssl PHA support (GH-128036)Will Childs-Klein2024-12-241-0/+6
| | | | | | * Add ssl.HAS_PHA to detect libssl Post-Handshake-Auth support Co-authored-by: Tomas R. <tomas.roun8@gmail.com> Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
* gh-127949: deprecate `asyncio.set_event_loop` (#128218)Kumar Aditya2024-12-241-0/+4
| | | Deprecate `asyncio.set_event_loop` to be removed in Python 3.16.
* gh-127949: deprecate asyncio policy classes (#128216)Kumar Aditya2024-12-241-0/+16
|
* gh-126180: Remove getopt and optparse deprecation notices (GH-126227)Alyssa Coghlan2024-12-238-39/+211
| | | | | | | | | | | | | * Remove getopt and optparse deprecation notices * Add new docs sections for command line app helper libraries * Add guidance on choosing a CLI parsing library to the optparse docs * Link to the new guidance from the argparse and getopt docs * Reword intro in docs section for superseded stdlib modules * Reframe the optparse->argparse guide as a migration guide rather than as an upgrade guide --------- Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* gh-112328: Make EnumDict usable on its own and document it (GH-123669)Petr Viktorin2024-12-201-8/+18
| | | | | Co-authored-by: Rafi <rafi.promit@gmail.com> Co-authored-by: Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua> Co-authored-by: Ethan Furman <ethan@stoneleaf.us>
* gh-112328: Document EnumDict in docs and release notes (GH-121720)Md Rokibul Islam2024-12-191-1/+16
| | | | Co-authored-by: Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua> Co-authored-by: Ethan Furman <ethan@stoneleaf.us>
* gh-127274: Defer nested methods (#128012)mpage2024-12-191-0/+7
| | | | | | | Methods (functions defined in class scope) are likely to be cleaned up by the GC anyway. Add a new code flag, `CO_METHOD`, that is set for functions defined in a class scope. Use that when deciding to defer functions.
* GH-122548: Implement branch taken and not taken events for sys.monitoring ↵Mark Shannon2024-12-191-6/+23
| | | | (GH-122564)
* gh-127688: Add `SCHED_DEADLINE` and `SCHED_NORMAL` constants to `os` module ↵RUANG (James Roy)2024-12-191-0/+12
| | | | (GH-127689)
* gh-122706: fix docs for asyncio ssl sockets (#128092)Kumar Aditya2024-12-191-2/+2
|
* gh-127949: deprecate `asyncio.get_event_loop_policy` (#128053)Kumar Aditya2024-12-181-0/+4
| | | This deprecates `asyncio.get_event_loop_policy` and will be removed in Python 3.16.
* gh-127949: deprecate `asyncio.set_event_loop_policy` (#128024)Kumar Aditya2024-12-181-0/+4
| | | | First step towards deprecating the asyncio policy system. This deprecates `asyncio.set_event_loop_policy` and will be removed in Python 3.16.
* Python 3.14.0a3v3.14.0a3Hugo van Kemenade2024-12-174-6/+6
|
* Fix typo in itertools docs (gh-127995)Gugubo2024-12-161-1/+1
|
* Clarify ast docs to use a less confusing example for `ast.ParamSpec` (#127955)Steve C2024-12-151-2/+2
| | | Fix typo in ast docs: ParamSpec defaults
* gh-127852: add remark about ',' separator (#127854)Sergey B Kirpichev2024-12-141-1/+3
| | | | | | | | | Specify that it is valid for floats and ints with 'd' presentation and an error otherwise. Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu> --------- Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* Minor readability improvements for the itertools recipes (gh-127928)Raymond Hettinger2024-12-131-39/+35
|
* link to the correct output method in documentation (#127857)Viktor Kálmán2024-12-131-1/+1
|
* Fix typo in traceback docs (#127884)Daniel Haag2024-12-121-1/+1
|
* Simplify and speed-up an itertools recipe (gh-127848)Raymond Hettinger2024-12-121-6/+6
|
* Docs: Fix indents in `xmlrpc.client.rst` (#127782)Yuki Kobayashi2024-12-101-4/+4
|
* gh-59705: Set OS thread name when Thread.name is changed (#127702)Victor Stinner2024-12-101-0/+12
| | | Co-authored-by: Petr Viktorin <encukou@gmail.com>
* gh-101100: Fix sphinx warnings in `whatsnew/3.0.rst` (#127662)Yuki Kobayashi2024-12-101-0/+3
|
* gh-125420: implement `Sequence.count` API on `memoryview` objects (#125443)Bénédikt Tran2024-12-101-1/+7
|
* gh-127718: Add colour to `test.regrtest` output (#127719)Hugo van Kemenade2024-12-101-0/+4
|
* gh-125420: implement `Sequence.index` API on `memoryview` objects (#125446)Bénédikt Tran2024-12-101-0/+9
|
* GH-125413: Revert addition of `pathlib.Path.scandir()` method (#127377)Barney Gale2024-12-051-29/+0
| | | | | | | | | | Remove documentation for `pathlib.Path.scandir()`, and rename the method to `_scandir()`. In the private pathlib ABCs, make `iterdir()` abstract and call it from `_scandir()`. It's not worthwhile to add this method at the moment - see discussion: https://discuss.python.org/t/ergonomics-of-new-pathlib-path-scandir/71721 Co-authored-by: Steve Dower <steve.dower@microsoft.com>
* gh-127221: Add colour to unittest output (#127223)Hugo van Kemenade2024-12-053-1/+11
| | | Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru>
* gh-127413: allow to show specialized bytecode via `dis` CLI (#127414)Bénédikt Tran2024-12-051-1/+7
|
* gh-127481: Add `EPOLLWAKEUP` to the `select` module (GH-127482)RUANG (James Roy)2024-12-041-0/+6
|
* gh-123378: Ensure results of `PyUnicode*Error_Get{Start,End}` are clamped ↵Bénédikt Tran2024-12-041-0/+6
| | | | | | (GH-123380) Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
* Itertool recipe additions (gh-127483)Raymond Hettinger2024-12-041-0/+37
|
* gh-127347: Document `traceback.print_list` (#127348)Tomas R.2024-12-031-0/+7
| | | Previously, `traceback.print_list` didn't have a documentation entry and was not exposed in `traceback.__all__`. Now it has a documentation entry and is exposed in `__all__`.
* gh-127255: Make `CopyComPointer` public and add to `ctypes` doc. (GH-127275)Jun Komoda2024-12-031-0/+18
|
* gh-126585: Add EHWPOISON error code (#126586)RUANG (James Roy)2024-12-031-0/+7
|
* gh-101100: Fix Sphinx warnings about list methods (#127054)Yuki Kobayashi2024-12-021-2/+2
|
* gh-109523: Raise a BlockingIOError if reading text from a non-blocking ↵Giovanni Siragusa2024-12-021-0/+20
| | | | stream cannot immediately return bytes. (GH-122933)
* Link to correct class methods in asyncio primitives docs (#127270)Ollanta Cuba Gyllensten2024-11-291-4/+4
|
* gh-127303: Add docs for token.EXACT_TOKEN_TYPES (#127304)Илья Любавский2024-11-291-0/+7
| | | | | | | --------- Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu> Co-authored-by: Tomas R. <tomas.roun8@gmail.com> Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
* Touch up docs for ctypes.FormatError & WinError (GH-127210)Jun Komoda2024-11-281-6/+5
| | | | Reformat paragraphs, add backquotes, and directives.
* Fix indentation for contextlib.asynccontextmanager docs (#127333)Jelle Zijlstra2024-11-271-3/+3
|
* gh-69639: Add mixed-mode rules for complex arithmetic (C-like) (GH-124829)Sergey B Kirpichev2024-11-262-11/+17
| | | | | | | | | | | | | | | "Generally, mixed-mode arithmetic combining real and complex variables should be performed directly, not by first coercing the real to complex, lest the sign of zero be rendered uninformative; the same goes for combinations of pure imaginary quantities with complex variables." (c) Kahan, W: Branch cuts for complex elementary functions. This patch implements mixed-mode arithmetic rules, combining real and complex variables as specified by C standards since C99 (in particular, there is no special version for the true division with real lhs operand). Most C compilers implementing C99+ Annex G have only these special rules (without support for imaginary type, which is going to be deprecated in C2y).
* gh-119180: Add VALUE_WITH_FAKE_GLOBALS format to annotationlib (#124415)Jelle Zijlstra2024-11-261-0/+11
|
* GH-126985: move pyvenv.cfg detection from site to getpath (#126987)Filipe Laíns 🇵🇸2024-11-264-41/+99
|
* Doc: Typo fix: nrace -> race (#127288)Richard Hansen2024-11-261-1/+1
|
* GH-127236: `pathname2url()`: generate RFC 1738 URL for absolute POSIX path ↵Barney Gale2024-11-251-4/+6
| | | | | | | | | | | | | | | (#127194) When handed an absolute Windows path such as `C:\foo` or `//server/share`, the `urllib.request.pathname2url()` function returns a URL with an authority section, such as `///C:/foo` or `//server/share` (or before GH-126205, `////server/share`). Only the `file:` prefix is omitted. But when handed an absolute POSIX path such as `/etc/hosts`, or a Windows path of the same form (rooted but lacking a drive), the function returns a URL without an authority section, such as `/etc/hosts`. This patch corrects the discrepancy by adding a `//` prefix before drive-less, rooted paths when generating URLs.
* Replace `:platform:` with `.. availability::` in `socket.ioctl` doc. (GH-127122)Jun Komoda2024-11-251-2/+3
| | | In `socket.ioctl`, `:platform:` -> `.. availability::`
* Improve `pathname2url()` and `url2pathname()` docs (#127125)Barney Gale2024-11-241-7/+19
| | | | | | | | | | | | | | | | | | | | | | | | | | These functions have long sown confusion among Python developers. The existing documentation says they deal with URL path components, but that doesn't fit the evidence on Windows: >>> pathname2url(r'C:\foo') '///C:/foo' >>> pathname2url(r'\\server\share') '////server/share' # or '//server/share' as of quite recently If these were URL path components, they would imply complete URLs like `file://///C:/foo` and `file://////server/share`. Clearly this isn't right. Yet the implementation in `nturl2path` is deliberate, and the `url2pathname()` function correctly inverts it. On non-Windows platforms, the behaviour until quite recently is to simply quote/unquote the path without adding or removing any leading slashes. This behaviour is compatible with *both* interpretations -- 1) the value is a URL path component (existing docs), and 2) the value is everything following `file:` (this commit) The conclusion I draw is that these functions operate on everything after the `file:` prefix, which may include an authority section. This is the only explanation that fits both the Windows and non-Windows behaviour. It's also a better match for the function names.
* GH-127133: Remove ability to nest argument groups & mutually exclusive ↵Savannah Ostrowski2024-11-241-10/+9
| | | | groups (#127186)