Gregory P. Smith
5927013e47
gh-101144: Allow open and read_text encoding to be positional. ( #101145 )
...
The zipfile.Path open() and read_text() encoding parameter can be supplied as a positional argument without causing a TypeError again. 3.10.0b1 included a regression that made it keyword only.
Documentation update included as users writing code to be compatible with a wide range of versions will need to consider this for some time.
2023-01-19 23:04:30 -08:00
Nikita Sobolev
9e025d305f
gh-101100: [Enum] Fix sphinx warnings in docs (GH-101122)
...
* gh-101100: [Enum] Fix sphinx warnings in
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2023-01-19 18:16:21 -08:00
Tushar Sadhwani
d65f485070
fix typo in 3.12 What's New ( #101105 )
2023-01-18 21:54:56 +05:30
Erlend E. Aasland
b84be8d9c0
Docs: improve sqlite3 placeholders example ( #101092 )
2023-01-18 10:36:17 +01:00
Viicos
c5660ae96f
Fix typo in `ReprEnum` documentation ( #101079 )
2023-01-17 16:21:56 +05:30
Steve Dower
30753c37c6
gh-100247: Improve documentation for custom shebang commands in py.exe launcher (GH-101083)
2023-01-16 17:01:04 +00:00
Mark Shannon
7b14c2ef19
GH-100982: Add `COMPARE_AND_BRANCH` instruction (GH-100983)
2023-01-16 12:35:21 +00:00
scrazzz
b82049993f
Docs: Remove duplicate `TraversableResources` reference ( #101068 )
2023-01-16 16:14:50 +05:30
Oleg Iarygin
8e9d08b062
gh-101041: Fix a misspelled name of `utctimetuple` in a doc warning (GH-101042)
2023-01-15 12:36:31 -08:00
Cristián Maureira-Fredes
5e9df888dd
Fix `ctypes` typo in `set_exception` ( #101040 )
2023-01-15 20:42:37 +05:30
Erlend E. Aasland
206f05a46b
gh-100668: Clarify how sqlite3 maps parameters onto placeholders ( #100960 )
...
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2023-01-14 23:58:06 +01:00
Bob Kline
49cae39ef0
gh-101021: Document binary parameters as bytes ( #101024 )
2023-01-14 11:01:27 -08:00
JustAnotherArchivist
ef633e5000
Sync-up parameter name in equivalent code snippet of `enumerate` (GH-101029)
2023-01-13 23:55:35 -06:00
Raymond Hettinger
6bde3d2fd3
Add recipes to showcase tee(), zip*, batched, starmap, and product. (GH-101023)
2023-01-13 19:01:22 -06:00
Raymond Hettinger
010576c6ea
Fix typo in docs (GH-101025)
2023-01-13 18:53:06 -06:00
Serhiy Storchaka
e5bd5ad70d
gh-100160: Restore and deprecate implicit creation of an event loop (GH-100410)
...
Partially revert changes made in GH-93453.
asyncio.DefaultEventLoopPolicy.get_event_loop() now emits a
DeprecationWarning and creates and sets a new event loop instead of
raising a RuntimeError if there is no current event loop set.
Co-authored-by: Guido van Rossum <gvanrossum@gmail.com>
2023-01-13 14:40:29 +02:00
Steve Dower
468c3bf798
gh-100247: Fix py.exe launcher not using entire shebang command for finding custom commands (GH-100944)
2023-01-13 11:49:01 +00:00
Steve Dower
b5d4347950
gh-86682: Adds sys._getframemodulename as an alternative to using _getframe (GH-99520)
...
Also updates calls in collections, doctest, enum, and typing modules to use _getframemodulename first when available.
2023-01-13 11:31:06 +00:00
Matthieu Dartiailh
eecd422d1b
gh-96461: Improve docs for bytecode instructions (GH-96462)
...
* Clarify the meaning of the oparg for CACHE and COPY opcode in dis doc
* Use STACK to describe stack operation in analogy with a Python list
* Remove (delta) from BEFORE_WITH since BEFORE_WITH does not take an argument
* Fix the description of the stack impact of multiple opcodes
2023-01-12 18:23:50 +00:00
Noam Cohen
2161bbf243
Fix typo in `enum` module documentation ( #100992 )
2023-01-12 21:10:29 +05:30
ram vikram singh
d9dff4c8b5
GH-100894: Updated the doc for `sys.winver` to clarify its usual contents (GH-100913)
2023-01-12 00:11:12 +00:00
Mariusz Felisiak
847d7708ba
gh-98763: Prefer "python" over "python3" for command line examples in docs. ( #98761 )
2023-01-11 15:35:41 +05:30
Yao-Ching Huang
b2f7b2ef0b
gh-100916: Convert argument to appropriate type (GH-100917)
2023-01-10 10:17:57 +00:00
Semen Zhydenko
35650f2538
Fix typos in Doc folder ( #100880 )
2023-01-10 11:04:06 +02:00
Ryan Ozawa
e098137cd3
bpo-28356: Document os.rename() behavior on Windows for differing volumes (GH-27376)
2023-01-09 21:43:09 +00:00
dsentinel
7a50d6b5b0
GH-100813: Add `socket.IP_PKTINFO` constant ( #10294 )
2023-01-09 14:30:40 +05:30
Nikita Sobolev
bc0a686f82
gh-87447: Fix walrus comprehension rebind checking ( #100581 )
...
Co-authored-by: Pablo Galindo Salgado <Pablogsal@gmail.com>
Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
2023-01-08 15:51:29 -07:00
Raymond Hettinger
b139bcd892
GH-100485: Tweaks to sumprod() (GH-100857)
2023-01-08 13:38:24 -06:00
Benjamin Peterson
11f99323c2
Update copyright years to 2023. (gh-100848)
2023-01-08 09:13:25 -06:00
Shantanu
53455a319f
gh-100783: fix os.path.join documentation ( #100811 )
...
- Use "drive", not "drive letter", because of UNC paths
- Previous components are not thrown away from relative drive letters
- Use "segment" instead of "component" for consistency with pathlib
- Other miscellaneous improvements
2023-01-08 00:51:30 -08:00
busywhitespace
6d3bc4a795
gh-100824: Fix typo in the documentation of unittest.TestLoader.testNamePatterns ( #100825 )
2023-01-08 13:37:16 +05:30
Raymond Hettinger
47b9f83a83
GH-100485: Add math.sumprod() (GH-100677)
2023-01-07 12:46:35 -06:00
FrozenBob
deaf090699
gh-100673: Removed erroneous note in the get_type_hints docs ( #100701 )
...
Removed erroneous note in the get_type_hints docs
typing.get_type_hints still includes base class type hints.
2023-01-07 17:31:47 +00:00
Mark Shannon
78068126a1
GH-99005: More intrinsics (GH-100774)
...
* Remove UNARY_POSITIVE, LIST_TO_TUPLE and ASYNC_GEN_WRAP, replacing them with intrinsics.
2023-01-06 14:47:57 +00:00
Akshit Tyagi
659c2607f5
gh-99026 update dataclasses docs for when annotations are inspected (gh-100798)
...
update dataclasses docs for when annotations are inspected
2023-01-06 09:26:44 -05:00
Shantanu
2f2fa03ff3
gh-87691: clarify use of anchor in pathlib docs ( #100782 )
...
This is feedback from https://github.com/python/cpython/pull/100737#discussion_r1062968696
This matches the wording from the `os.path.join` docs better:
https://docs.python.org/3/library/os.path.html#os.path.join
In particular, the previous use of "anchor" was incorrect given the
pathlib definition of "anchor".
Co-authored-by: Barney Gale <barney.gale@gmail.com>
2023-01-05 17:49:33 -08:00
Shantanu
1ae619c911
gh-87691: add an absolute path pathlib example in / operator docs (GH-100737)
...
The behaviour is fully explained a couple paragraphs above, but it may be useful to have a brief example to cover the behaviour.
Automerge-Triggered-By: GH:hauntsaninja
2023-01-05 14:55:35 -08:00
Mark Shannon
28187141cc
GH-99005: Add `CALL_INTRINSIC_1` instruction (GH-100771)
...
* Remove PRINT_EXPR instruction
* Remove STOPITERATION_ERROR instruction
* Remove IMPORT_STAR instruction
2023-01-05 16:05:51 +00:00
Tzu-ping Chung
105e37395d
GH-100766: Note that locale.LC_MESSAGES is not universal (GH-100702)
2023-01-05 03:34:30 +00:00
David Lechner
5fb1c08e15
docs: fix `ssizeobjargproc` parameters ( #100736 )
2023-01-04 13:47:42 +05:30
Ethan Furman
a286caa937
gh-91219: http - use subclassing to override index_pages attribute (GH-100731)
...
Remove previously added parameter to `__init__`, and recommend subclassing to modify the `index_pages` attribute instead.
2023-01-03 15:20:08 -08:00
Christophe Nanteuil
64ed609c53
[Enum] docs: replace 'last value' by 'highest value' for Flag auto (GH-100709)
2023-01-03 14:08:50 -08:00
Zachary Ware
e196d8c10a
gh-100700: Remove Date and Release fields in past whatsnews (GH-100728)
2023-01-03 16:00:26 -06:00
4l4k4z4m
8b1f125121
gh-81611: Improve `range` paragraph in 8.3 of language reference ( #98353 )
...
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2023-01-03 13:46:51 +05:30
Kumar Aditya
7feb6d2f85
fix `grammer` -> `grammar` typo in expressions.rst (GH-100683)
...
Automerge-Triggered-By: GH:AlexWaygood
2023-01-02 03:49:06 -08:00
Alexander Shadchin
254ab42240
Fix deprecation doc for `PyEval_InitThreads` ( #100667 )
2023-01-02 16:43:55 +05:30
Shantanu
edfbf56f4c
gh-100428: Make int documentation more accurate ( #100436 )
...
- Remove first link to lexical definition of integer literal, since it
doesn't apply (differs in handling of leading zeros, base needs to be
explicitly specified, unicode digits are allowed)
- Better describe handling of leading zeros, unicode digits, underscores
- Base 0 does not work exactly as like a code literal, since it allows
Unicode digits. Link code literal to lexical definition of integer
literal.
2023-01-01 19:14:18 -08:00
Erlend E. Aasland
b7a68ab824
gh-99953: Purge mention of numeric param style from sqlite3 docs ( #100630 )
...
The PEP-249 numeric style has never been supported by sqlite3.
2023-01-01 23:26:23 +01:00
Jason R. Coombs
447d061bc7
gh-97930: Apply changes from importlib_resources 5.10. (GH-100598)
2023-01-01 11:07:32 -05:00
ram vikram singh
1aab269d4a
gh-100201: Document behavior with a bare `yield` statement ( #100416 )
...
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2023-01-01 21:06:13 +05:30
Mehrdad Moradizadeh
1d1480fefc
gh-96773 Fix documentation of socket backlog ( #96778 )
2023-01-01 20:36:17 +05:30
Shantanu
e83f88a455
gh-100488: Add is_integer method to fractions.Fraction ( #100489 )
2023-01-01 01:44:48 -07:00
Shantanu
71159a8e07
gh-100546: Remove incorrect positional-only marker from eval ( #100547 )
...
All the arguments are positional-only.
The current status after #99476 seems to be to not use positional-only
markers in documentation, hence I've simply removed it.
2022-12-31 17:59:31 -07:00
Sandeep Subramanian
ac7a0a9f9e
GH-87002: fix caching documentation in `struct` module ( #24164 )
2022-12-31 22:27:58 +05:30
Owain Davies
98308dbeb1
gh-100633 Tutorial: Fix dataclasses import ( #100638 )
...
import dataclass not dataclasses from dataclasses
2022-12-31 10:23:18 +00:00
Paolo Lammens
f59c7f8edd
GH-85979: Clarify specification of `object.__await__` ( #22320 )
...
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
2022-12-31 11:54:04 +05:30
Raymond Hettinger
4ebaae8aed
Improve comments in itertools uniquification recipes (GH-100631)
2022-12-30 20:36:38 -06:00
mathieui
f4fcfdf8c5
gh-100616: Document 'attr' parameter for window.vline() in curses module ( #24961 )
...
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
2022-12-30 08:35:04 -08:00
ram vikram singh
7223d50b97
gh-100583: Improve the `pydoc` documentation ( #100590 )
2022-12-29 20:47:20 +05:30
JustAnotherArchivist
cf1c098180
GH-100101: Clarify documentation of zip's strict option (GH-100103)
2022-12-28 13:24:50 -08:00
Raymond Hettinger
c4c5790120
Restore early-out to factor(). Strengthen tests. (GH-100591)
2022-12-28 12:29:27 -08:00
Hugo van Kemenade
9eca7235af
gh-94172: Update docs for params removed in 3.12 ( #100431 )
...
Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
2022-12-28 14:43:19 -05:00
Zachary Ware
25590eb5de
gh-100540: Remove obsolete '--with-system-ffi' configure option (GH-100544)
...
It has had no effect on non-macOS platforms for a long time, and has had
the non-obvious effect of invoking `pkg_config` and not setting
`-DUSING_APPLE_OS_LIBFFI` on macOS since GH-22855.
2022-12-28 13:36:03 -06:00
Raymond Hettinger
2d52406835
Improve factor() recipe and fix its tests (GH-100576)
2022-12-28 03:13:58 -08:00
Stanley
b95b1b3b25
gh-55688: Add note about ending backslashes for raw strings ( #94768 )
...
Co-authored-by: hauntsaninja <hauntsaninja@gmail.com>
2022-12-28 00:30:42 -05:00
Guy Yagev
ad3c99e521
gh-92446: Improve argparse choices docs; revert bad change to lzma docs ( #94627 )
...
Based on the definition of the collections.abc classes, it is more accurate to use "sequence" instead of "container" when describing argparse choices.
A previous attempt at fixing this in #92450 was mistaken; this PR reverts that change.
Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
2022-12-26 00:22:53 -06:00
Ilya Kulakov
dbc1e696eb
gh-99308: Clarify re docs for byte pattern group names ( #99311 )
2022-12-25 12:25:27 +05:30
Shantanu
046cbc2080
gh-100472: Fix docs claim that compileall parameters could be bytes ( #100473 )
2022-12-24 14:22:49 -06:00
Bart Broere
efccd04b9e
[Minor PR] Quotes in documentation changed into code blocks ( #99536 )
...
Minor formatting fix in documentation
Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
2022-12-24 12:17:39 -08:00
Shantanu
2e1a9ce989
gh-100428: Make float documentation more accurate ( #100437 )
...
Previously, the grammar did not accept `float("10")`.
Also implement mdickinson's suggestion of removing the indirection.
2022-12-24 14:09:31 -06:00
MonadChains
f5b7b19bf1
gh-99535: Add test for inheritance of annotations and update documentation ( #99990 )
2022-12-24 12:07:14 -08:00
JosephSBoyle
00afa5066b
gh-99908: Tutorial: Modernize the 'data-record class' example ( #100499 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2022-12-24 15:23:24 +00:00
Raymond Hettinger
0769f95751
Misc Itertools recipe tweaks (GH-100493)
2022-12-24 00:21:30 -08:00
Stanley
0f6420640c
gh-77771: Add enterabs example in sched ( #92716 )
...
Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
2022-12-23 23:21:52 -06:00
Shantanu
3e46f9fe05
gh-100268: Add is_integer method to int ( #100439 )
...
This improves the lives of type annotation users of `float` - which type checkers implicitly treat as `int|float` because that is what most code actually wants. Before this change a `.is_integer()` method could not be assumed to exist on things annotated as `: float` due to the method not existing on both types.
2022-12-23 18:30:27 -08:00
Raymond Hettinger
f89de679ff
Add "strict" to dotproduct(). Add docstring. Factor-out common code. (GH-100480)
2022-12-23 15:52:16 -08:00
Raymond Hettinger
5d84966cce
GH-100425: Improve accuracy of builtin sum() for float inputs (GH-100426)
2022-12-23 14:35:58 -08:00
Nikita Sobolev
745545b5bb
gh-99482: remove `jython` compatibility parts from stdlib and tests ( #99484 )
2022-12-23 14:17:24 -06:00
Petr Viktorin
49f6ff719c
gh-98712: Clarify "readonly bytes-like object" semantics in C arg-parsing docs ( #98710 )
2022-12-23 07:00:21 -08:00
Shantanu
73c08eeaff
Fix typo in 3.12 What's New ( #100449 )
2022-12-23 00:22:31 -06:00
Stanley
f3db68e6e6
gh-48496: Added example and link to faq for UnboundLocalError in reference ( #93068 )
2022-12-22 17:23:25 -06:00
Itamar Ostricher
4cc63e0d4e
gh-100344: Add C implementation for `asyncio.current_task` ( #100345 )
...
Co-authored-by: pranavtbhat
2022-12-22 19:08:12 +05:30
Stanley
c615286e85
gh-91081: Add note on WeakKeyDictionary behavior when deleting a replaced entry ( #91499 )
...
Co-authored-by: Pieter Eendebak <P.T.eendebak@tudelft.nl>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-12-20 19:27:02 -08:00
Bisola Olasehinde
a2bb3b7f9d
gh-99991: improve docs on str.encode and bytes.decode ( #100198 )
...
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-12-20 18:02:14 -08:00
Pablo Galindo Salgado
cb60b6131b
Clarify that every thread has its own default context in contextvars ( #99246 )
2022-12-20 11:35:48 +00:00
Brad Wolfe
39dfbb2d5d
gh-88211: Change lower-case and upper-case to match recommendations in imaplib docs ( #99625 )
2022-12-20 15:40:31 +05:30
Thomas Grainger
79ccc03b62
gh-89051: Add ssl.OP_LEGACY_SERVER_CONNECT ( #93927 )
...
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Christian Heimes <christian@python.org>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
Fixes https://github.com/python/cpython/issues/89051
2022-12-20 09:10:30 +02:00
Stanley
36a0b1d0dd
gh-69929: re docs: Add more specific definition of \w ( #92015 )
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-12-19 19:07:31 -08:00
Carlton Gibson
532aa4e4e0
gh-94912: Added marker for non-standard coroutine function detection ( #99247 )
...
This introduces a new decorator `@inspect.markcoroutinefunction`,
which, applied to a sync function, makes it appear async to
`inspect.iscoroutinefunction()`.
2022-12-18 11:13:24 -08:00
Jeremy Paige
1cf3d78c92
Correct CVE-2020-10735 documentation ( #100306 )
2022-12-18 12:41:21 +05:30
Hugo van Kemenade
0264f634f7
Docs: Use `PY_VERSION_HEX` for version comparison ( #100179 )
2022-12-17 13:12:18 +05:30
ram vikram singh
8edcb30c3f
gh-97909: Fix markup for `PyMethodDef` members ( #100089 )
2022-12-17 12:42:39 +05:30
Barney Gale
5a991da329
gh-78707: deprecate passing >1 argument to `PurePath.[is_]relative_to()` (GH-94469)
...
This brings `relative_to()` and `is_relative_to()` more in line with other pathlib methods like `rename()` and `symlink_to()`.
Resolves #78707 .
2022-12-16 16:14:27 -08:00
Ben Darnell
5234e1cbea
gh-99830: asyncio: Document returns of remove_{reader,writer} ( #100302 )
2022-12-16 11:04:55 -08:00
Frank Dana
f23236a92d
"Compound statement" docs: Fix with-statement step indexing ( #100286 )
...
Back in commit 226e6e7d43
an item was added to the list, renumbering all the rest of the
items, but the forward-reference wasn't updated to match.
2022-12-16 18:43:43 +00:00
JustAnotherArchivist
5ee7eb9deb
Document that zipfile's pwd parameter is a `bytes` object ( #100209 )
2022-12-16 16:10:10 +05:30
Carl Meyer
e00266f398
gh-99767: mark `PyTypeObject.tp_watched` as internal use only in table ( #100271 )
2022-12-16 16:02:09 +05:30
Mikhail Berkov
2cd5146f27
Fix typo in introduction.rst ( #100266 )
2022-12-16 15:56:30 +05:30
Raymond Hettinger
b430399d41
GH-100234: Set a default value for random.expovariate() (GH-100235)
2022-12-15 12:40:45 -06:00
Raymond Hettinger
8356c14b4f
Remove uninformative itertools recipe (GH-100253)
2022-12-15 12:39:01 -06:00
Carl Meyer
b7e4f1d97c
GH-99767: update PyTypeObject docs for type watchers (GH-99928)
2022-12-15 11:26:08 +00:00
busywhitespace
9663853800
gh-100248: Add missing `ssl_shutdown_timeout` parameter in `asyncio` docs ( #100249 )
2022-12-14 22:27:02 +05:30
Hugo van Kemenade
3192c00a3c
gh-100176: venv: Remove redundant compat code for Python <= 3.2 ( #100177 )
...
gh-100176: Remove redundant compat code for Python 3.2 and older
Python 3.2 has been EOL since 2016-02-20 and 2.7 since 2020-01-01, so we
can remove this old compatibility check and unindent the old else-block.
Also, in the unindented block, replace a .format() call with an f-string.
Plus similar changes in the documentation.
2022-12-14 11:37:11 +00:00
Filipe Laíns
d3ea82aaf9
GH-100206: use versionadded for the addition of sysconfig.get_default_scheme ( #100207 )
2022-12-13 12:54:07 +02:00
jarrodcolburn
8711b59f7a
Fix: typo (Indention) (GH-99904)
...
Example needed to be indented. Was trying to call a context manger `pr` (from ` with cProfile.Profile() as pr:`) wot perform ` pr.print_stats()` once it had already exited.
Automerge-Triggered-By: GH:AlexWaygood
2022-12-12 04:25:22 -08:00
Ned Batchelder
935ef59321
clarify the 4300-digit limit on int-str conversion ( #100175 )
2022-12-12 13:39:54 +02:00
Shantanu
70be5e42f6
gh-70393: Clarify mention of "middle" scope ( #98839 )
2022-12-11 20:15:55 -08:00
Beweeted
868bab0fdc
gh-100174: [Enum] Correct PowersOfThree example. (GH-100178)
...
Changed from multiples of 3 to powers of 3 to match the class name.
2022-12-11 15:20:59 -08:00
Brad Wolfe
d5f8a2b6ad
gh-99728: correct typo in `datetime` format codes documentation ( #99750 )
2022-12-10 15:50:18 +05:30
busywhitespace
e477348f36
gh-99970 Adding missing `optionflags` parameter in the documentation of `doctest` ( #99971 )
2022-12-10 15:42:40 +05:30
ram vikram singh
7c0fb71fbf
gh-100049: fix `repr` for `mappingproxy` in dictionary view example doc ( #100052 )
2022-12-10 14:46:00 +05:30
Stanley
286e3c76a9
gh-99087: Add missing newline for prompts in docs (GH-98993)
...
Add newline for prompts so copying to REPL does not cause errors.
2022-12-08 19:31:19 -08:00
Raymond Hettinger
35cc0ea736
GH-98363: Have batched() return tuples (GH-100118)
2022-12-08 15:08:16 -06:00
Jia Junjie
41d4ac9da3
gh-96250: Improve sqlite3 injection attack example ( #99270 )
...
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
2022-12-08 21:37:08 +01:00
Matthieu Baerts
cce8362960
gh-98030: socket: add missing TCP socket options ( #98031 )
...
A few TCP socket options have been added to the Linux kernel these last
few years.
This commit adds all the ones available in Linux 6.0:
https://elixir.bootlin.com/linux/v6.0/source/include/uapi/linux/tcp.h#L91
While at it, the TCP_FASTOPEN option has been moved lower in the list
just to keep the same order as in tcp.h to ease future synchronisations.
Signed-off-by: Matthieu Baerts <matthieu.baerts@tessares.net>
2022-12-07 20:59:37 -08:00
Victor Stinner
b11a384dc7
gh-98724: Fix Py_CLEAR() macro side effects ( #99100 ) ( #100070 )
...
The Py_CLEAR(), Py_SETREF() and Py_XSETREF() macros now only evaluate
their arguments once. If an argument has side effects, these side
effects are no longer duplicated.
Use temporary variables to avoid duplicating side effects of macro
arguments. If available, use _Py_TYPEOF() to avoid type punning.
Otherwise, use memcpy() for the assignment to prevent a
miscompilation with strict aliasing caused by type punning.
Add _Py_TYPEOF() macro: __typeof__() on GCC and clang.
Add test_py_clear() and test_py_setref() unit tests to _testcapi.
2022-12-07 15:22:38 +01:00
Ethan Furman
679efbb080
gh-94943: [Enum] improve repr() when inheriting from a dataclass (GH-99740)
...
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-12-06 13:43:41 -08:00
Serhiy Storchaka
fd38a2f0ec
gh-93453: No longer create an event loop in get_event_loop() ( #98440 )
...
asyncio.get_event_loop() now always return either running event loop or
the result of get_event_loop_policy().get_event_loop() call. The latter
should now raise an RuntimeError if no current event loop was set
instead of creating and setting a new event loop.
It affects also a number of asyncio functions and constructors which
call get_event_loop() implicitly: ensure_future(), shield(), gather(),
etc.
DeprecationWarning is no longer emitted if there is no running event loop but
the current event loop was set.
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2022-12-06 18:42:12 +01:00
Ashwin Ramaswami
85d5a7e8ef
bpo-37860: re-add netlify.toml to set up deploy previews for docs ( #92852 )
...
* Revert "bpo-46184: remove `netlify.toml` (#30272 )"
This reverts commit fbaf2e604c
.
* Delete runtime.txt
* Create runtime.txt
* Delete runtime.txt
* Update netlify.toml
* Update netlify.toml
* Add netlify badge
* Update Doc/tools/templates/layout.html
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* Update layout.html
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2022-12-06 08:37:41 -05:00
Victor Stinner
5837e5f347
gh-100008: VS 2017 is required since Python 3.11 ( #100045 )
2022-12-06 14:35:32 +01:00
Erik De Bonte
5c19050546
gh-99957: Add `frozen_default` parameter on `dataclass_transform` ( #99958 )
2022-12-05 19:35:43 -08:00
Gregory P. Smith
bed15f87ea
gh-100001: Remove doc typo, add versionadded ( #100042 )
...
gh-100001: Remove new doc typo, add versionadded.
2022-12-05 15:15:13 -08:00
Hugo van Kemenade
f49c735e52
Use sphinxext-opengraph to generate OpenGraph metadata ( #99931 )
...
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-12-05 23:26:28 +02:00
Gregory P. Smith
d8ab0a4dfa
gh-100001: Omit control characters in http.server stderr logs. ( #100002 )
...
Replace control characters in http.server.BaseHTTPRequestHandler.log_message with an escaped \xHH sequence to avoid causing problems for the terminal the output is printed to.
2022-12-05 12:55:45 -08:00
Ram Rachum
51ee0a29e9
dataclasses.rst: Prevent horizontal scrolling (gh-100025)
2022-12-05 13:56:13 -05:00
Victor Stinner
5ea052bb0c
gh-100008: Document Python build requirements ( #100009 )
...
Document also configure --without-freelists option added to Python
3.11.
2022-12-05 15:41:44 +01:00
Ethan Furman
e3a3863cb9
gh-93464: [Enum] Add versionchanged tag ( #99997 )
...
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-12-05 12:35:31 +02:00
Géry Ogam
2ae894b6d1
[Enum] Fix typos in the documentation (GH-99960)
2022-12-04 11:49:31 -08:00
Brian Skinn
bf26bdf6ac
gh-85747: "Preface" section of asyncio-eventloop.rst: Switch to active voice and suggest other edits ( #99784 )
2022-12-03 16:48:41 -08:00
Serhiy Storchaka
a87c46eab3
bpo-15999: Accept arbitrary values for boolean parameters. ( #15609 )
...
builtins and extension module functions and methods that expect boolean values for parameters now accept any Python object rather than just a bool or int type. This is more consistent with how native Python code itself behaves.
2022-12-03 11:52:21 -08:00
Itamar Ostricher
3c137dc613
GH-91054: Add code object watchers API (GH-99859)
...
* Add API to allow extensions to set callback function on creation and destruction of PyCodeObject
Co-authored-by: Ye11ow-Flash <janshah@cs.stonybrook.edu>
2022-12-02 17:28:27 +00:00
C.A.M. Gerlach
d460c8ec52
Doc: Add summary line to isolation_level & autocommit sqlite3.connect params ( #99917 )
...
Add summary lines to isolation_level and autocommit connect() params
Co-authored-by: Géry Ogam <gery.ogam@gmail.com>
2022-12-01 08:19:41 +01:00
ram vikram singh
e0f91deb59
GH-98906 ```re``` module: ```search() vs. match()``` section should mention ```fullmatch()``` (GH-98916)
...
Mention fullmatch along with search and match.
2022-11-30 17:52:21 -05:00
Géry Ogam
9628136fac
bpo-47220: Document the optional callback parameter of weakref.WeakMethod (GH-25491)
2022-11-30 13:44:10 -06:00
Géry Ogam
19c38801ba
gh-99824: Document that sqlite3.connect implicitly open a transaction if autocommit=False ( #99825 )
...
Authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-11-30 12:33:50 +01:00
Dong-hee Na
8bb2303fd7
gh-99127: Allow some features of syslog to the main interpreter only (gh-99128)
2022-11-30 07:58:20 +09:00
Géry Ogam
052bc128ac
Docs: improve accuracy of socketserver reference ( #24767 )
2022-11-29 21:34:52 +01:00
Yilei "Dolee" Yang
d74a58872c
whatsnew-3.10: Mention PEP 647 in the Release highlights section. ( #99853 )
...
Mention PEP 647 in the Release highlights section.
Also re-ordered the list so it matches the order in the details sections below.
2022-11-29 20:30:58 +00:00
Sam Ezeh
05dfc539c2
gh-90717: Update the documentation for the altchars paremeter in base64 library (GH-94187)
2022-11-29 16:21:01 +00:00
Matthew Hughes
ca3e611b1f
`fnmatch` docs: link to `fnmatch.filter()`, not `builtins.filter()` ( #99819 )
2022-11-28 18:08:08 +00:00
David Miguel Susano Pinto
65417988a5
Grammatical improvements for ctypes 'winmode' documentation (GH-19167)
2022-11-28 16:05:21 +00:00
Georg Brandl
492dc02b01
bpo-41825: restructure docs for the os.wait*() family (GH-22356)
2022-11-28 09:41:24 +00:00
Petr Viktorin
219696abb2
gh-99249: Clarify "read-only" slots tp_bases & tp_mro (GH-99342)
...
These slots are marked "should be treated as read-only" in the
table at the start of the document. That doesn't say anything about
setting them in the static struct.
`tp_bases` docs did say that it should be ``NULL`` (TIL!). If you
ignore that, seemingly nothing bad happens. However, some slots
may not be inherited, depending on which sub-slot structs are present.
(FWIW, NumPy sets tp_bases and is affected by the quirk -- though to
be fair, its DUAL_INHERIT code probably predates tp_bases docs, and
also the result happens to be benign.)
This patch makes things explicit.
It also makes the summary table legend easier to scan.
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
2022-11-28 09:22:08 +01:00
Erlend E. Aasland
276643e207
Docs: both sqlite3 "point examples" now adapt to str ( #99823 )
2022-11-27 22:08:30 +01:00
Sam Ezeh
dfc2732a57
gh-91340: Document multiprocessing.set_start_method force parameter (GH-32339)
...
#91340
https://bugs.python.org/issue47184
Automerge-Triggered-By: GH:kumaraditya303
2022-11-27 09:58:39 -08:00
Hugo van Kemenade
969620d59a
Docs: Move .PHONY to each section to avoid copy/paste omissions ( #99396 )
2022-11-27 19:48:29 +02:00
Brad Wolfe
65629399bc
gh-85988: Change documentation for sys.float_info.rounds (GH-99675)
...
* Change documentation for sys.float_info.rounds
Change the documentation for sys.float_info.rounds to remove
references to C99 section 5.2.4.2.2 and instead place the
available values inline.
* Correction to previous documentation change
Newlines were not preserved in generated HTML on previous
commit. I have changes the list to a comma-separated list
of values and their meanings.
* Clarify source for value of FLT_ROUNDS
Clarify the source of the FLT_ROUNDS value and
change 'floating-point addition' to 'floating-point
arithmetic' to indicate that the rounding mode
applies to all arithmetic operations.
2022-11-27 10:25:12 +00:00
George Zhang
22860dbbc8
doc: Remove backslashes in doctest grammar docs ( #29346 )
2022-11-27 12:08:39 +05:30
Zackery Spytz
62a5dc13e9
bpo-43327: Fix the docs for PyImport_ImportFrozenModuleObject() ( #24659 )
...
The docs stated that PyImport_ImportFrozenModuleObject() returns a
new reference, but it actually returns an int.
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
2022-11-27 11:57:41 +05:30
Jason R. Coombs
7f005749b2
gh-88330: Add more detail about what is a resource. ( #99801 )
2022-11-26 16:57:20 -05:00