73140de97c
bpo-23183: Document the timeit output (GH-30359)
...
Co-authored-by: Robert Collins <robertc@robertcollins.net>
2022-01-14 17:25:36 +00:00
0885999a8e
bpo-46355: Document PyFrameObject and PyThreadState changes (GH-30558)
...
Document PyFrameObject and PyThreadState changes in What's New in
Python 3.11 and explain how to port code.
2022-01-13 19:21:50 +01:00
c590b581bb
bpo-46328: Add sys.exception() (GH-30514)
2022-01-13 12:35:58 +00:00
443b308fee
bpo-40479: Fix hashlib's usedforsecurity for OpenSSL 3.0.0 (GH-30455)
2022-01-13 09:46:38 +01:00
0bbf30e2b9
bpo-46342: make @typing.final introspectable (GH-30530)
...
Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
2022-01-12 11:38:25 -08:00
dce642f244
bpo-46307: Add string.Template.get_identifiers() method (GH-30493)
...
Add `string.Template.get_identifiers()` method that returns the identifiers within the template. By default, raises an error if it encounters an invalid identifier (like `substitute()`). The keyword-only argument `raise_on_invalid` can be set to `False` to ignore invalid identifiers (like `safe_substitute()`).
Automerge-Triggered-By: GH:warsaw
2022-01-11 11:15:42 -08:00
6f05e1ec19
[doc] Add license_url for python-docs-theme 2022.1. (GH-30527)
2022-01-11 17:32:42 +01:00
43c5c1369c
closes bpo-46253: Change Py_UNICODE to Py_UCS4 in the C API docs to match the current source code (GH-30387)
2022-01-11 08:33:06 -06:00
73decdf021
Remove unused `Any` from `Concatenate` example in typing docs (GH-30516)
2022-01-11 21:59:26 +08:00
6223cbf86a
bpo-45331: [Enum] add rule to docs that mixin type must be subclassable (GH-30521)
2022-01-10 15:42:45 -08:00
d24cd49acb
bpo-46270: Describe the `in` and `not in` operators as membership tests. (GH-30504)
2022-01-09 18:02:06 -08:00
0b2b9d2513
bpo-23882: unittest: Drop PEP 420 support from discovery. (GH-29745)
2022-01-10 10:38:33 +09:00
b6aa38f1ca
bpo-46261: Update `sqlite3.Cursor.lastrowid` docs (GH-30407)
2022-01-08 21:17:09 +02:00
ef5376e69e
bpo-46290: Fix parameter names in dataclasses docs (GH-30450)
2022-01-08 12:56:35 +02:00
6d07a9fb7c
bpo-28546: [doc] Clarify setting pdb breakpoints (GH-30360)
...
Co-authored-by: Ian Kelling <ian@iankelling.org>
2022-01-07 19:41:23 +00:00
273cb8e757
bpo-24650: Use full term "generator function" in yield expressions docs (GH-24663)
2022-01-07 18:39:40 +00:00
9b7aa6a9d6
bpo-46216: remove spurious link to os.system() from os.time() documentation (GH-30326)
...
Automerge-Triggered-By: GH:iritkatriel
2022-01-07 10:28:08 -08:00
46c7a6566b
bpo-46251: Add 'Security Considerations' section to logging configura… (GH-30411)
2022-01-06 22:35:08 +00:00
9925e70e48
bpo-45292: [PEP-654] exception groups and except* documentation (GH-30158)
2022-01-06 19:05:34 +00:00
e028ae99ec
bpo-45923: Handle call events in bytecode (GH-30364)
...
* Add a RESUME instruction to handle "call" events.
2022-01-06 13:09:25 +00:00
3db762db72
bpo-46031: add POP_JUMP_IF_NOT_NONE and POP_JUMP_IF_NONE (GH-30019)
2022-01-06 11:38:35 +00:00
e5894ca8fd
bpo-46266: Add calendar day of week constants to __all__ (GH-30412)
2022-01-05 14:21:04 -06:00
31e43cbe5f
bpo-46009: Remove GEN_START (GH-30367)
2022-01-04 11:38:32 -08:00
f404e26d74
Fix missing "," in the documentation of Executor Objects (GH-30404)
2022-01-04 10:48:04 -08:00
7d7817cf0f
bpo-20369: concurrent.futures.wait() now deduplicates futures given a… (GH-30168)
...
* bpo-20369: concurrent.futures.wait() now deduplicates futures given as arg.
* 📜 🤖 Added by blurb_it.
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
2022-01-04 13:36:13 +00:00
b949845b36
bpo-33252: Document that ResourceWarning is ignored by default (GH-30358)
...
`ResourceWarning` is ignored by default.
Document this behaviour, for consistency with others in this table such as `DeprecationWarning`.
Documentation PR can skip NEWS file.
Automerge-Triggered-By: GH:iritkatriel
2022-01-04 03:34:31 -08:00
e09d94a140
bpo-46231: Remove invalid_* rules preceded by more tokens from the grammar docs (GH-30341)
2022-01-04 10:42:15 +00:00
a94461d718
bpo-46202: Remove opcode POP_EXCEPT_AND_RERAISE (GH-30302)
...
* bpo-46202: remove opcode POP_EXCEPT_AND_RERAISE
* do not assume that an exception group is truthy
2022-01-04 10:37:12 +00:00
a09062c267
bpo-44092: Move What's New entry to where it belongs (GH-30381)
2022-01-04 09:36:30 +00:00
bef48837e7
Update old-style strings to f-strings (GH-30384)
...
Let me know if this sort of change is unwanted...
2022-01-04 01:25:56 -08:00
2db5613063
bpo-34538: Remove Exception subclassing from tutorial (GH-30361)
...
Remove the bit about subclassing exceptions.
Documentation PR can skip the NEWS label.
Automerge-Triggered-By: GH:iritkatriel
2022-01-03 14:52:09 -08:00
770f43d47e
Add doctest and improve readability for move_to_end() example. ( #30370 )
2022-01-03 14:26:08 -08:00
51700bf08b
bpo-34931: [doc] clarify behavior of os.path.splitext() on paths with multiple leading periods (GH-30347)
2022-01-03 20:10:07 +00:00
9d6a239a34
bpo-44092: Don't reset statements/cursors before rollback (GH-26026)
...
In SQLite versions pre 3.7.11, pending statements would block a rollback. This is no longer the case, so remove the workaround.
2022-01-03 19:02:39 +00:00
c960b191b8
bpo-46222: posixmodule sendfile FreeBSD's constants updates. (GH-30327)
...
* posixodule sendfile FreeBSD's constants updates.
* 📜 🤖 Added by blurb_it.
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
2022-01-03 15:01:04 +02:00
65e7c1f90e
bpo-46219, 46221: simplify except* implementation following exc_info changes. Move helpers to exceptions.c. Do not assume that exception groups are truthy. (GH-30289)
2022-01-02 23:22:42 +00:00
8e75c6b49b
argparse docs: prog default is the basename of argv[0] (GH-30298)
2022-01-02 12:16:25 -08:00
ba00f0d93a
Update copyright year to 2022. (GH-30335)
...
Automerge-Triggered-By: GH:benjaminp
2022-01-02 12:08:48 -08:00
ce4d25f3cd
bpo-46196: document method cmd.Cmd.columnize ( #30303 )
...
The method is already written and tested, now it's officially public.
2022-01-02 13:33:20 -05:00
7a8796dc67
bpo-45903: Fix typo in What's New: Signature.from_builtin is removed (GH-29813)
2022-01-02 08:51:56 -08:00
a09bc3a404
bpo-46095: Improve SeqIter documentation. (GH-30316)
2022-01-01 10:37:26 -08:00
ac4eea2172
bpo-46079: Replace external link that is down for maintenance. (GH-30315)
2022-01-01 09:49:55 -08:00
e18d81569f
bpo-45321: Add missing error codes to module `xml.parsers.expat.errors` (GH-30188)
...
The idea is to ensure that module `xml.parsers.expat.errors`
contains all known error codes and messages,
even when CPython is compiled or run with an outdated version of libexpat.
https://bugs.python.org/issue45321
2021-12-31 10:57:00 +01:00
99945c6b5c
bpo-46109: Separate out files relating to importlib.resources (GH-30160)
...
* Separate out files relating to importlib.resources
* Update Introduction to direct readers to the submodule documentation.
* Create separate file for abcs relating to resources.
* Move abc docs back to where they were.
2021-12-30 21:17:05 -05:00
2cf7d02b99
bpo-46178: Remove/rename redundant Travis CI code ( #30309 )
2021-12-30 16:16:27 -08:00
fbaf2e604c
bpo-46184: remove `netlify.toml` ( #30272 )
...
* bpo-46184: remove `netlify.toml`
* Delete runtime.txt
* Delete requirements.txt
* Revert "Delete requirements.txt"
This reverts commit 9aa4f0631f
2021-12-30 13:18:37 -08:00
d12bec6993
bpo-43424: Deprecate `webbrowser.MacOSXOSAScript._name` attribute (GH-30241)
2021-12-30 10:30:13 +09:00
66c47b63a0
bpo-46176: mmap module adding MAP_STACK constant. (GH-30252)
2021-12-29 22:52:29 +09:00
f9a4352056
Fix typo in io.rst (GH-30218)
2021-12-26 13:11:08 +02:00
10bf0a9ac3
doc: fix a typo in unittest.mock.rst (GH-30227)
2021-12-26 13:09:17 +02:00
c1d7a6bed9
docs: Fix typos and use anchor for internal link (GH-30236)
2021-12-26 12:43:06 +02:00
1b30660c3b
bpo-46120: State that `|` is preferred over `Union` (GH-30222)
...
Co-authored-by: Éric <merwok@netwok.org>
Co-authored-by: Guido van Rossum <gvanrossum@gmail.com>
2021-12-24 13:36:09 -08:00
cf15419a99
typos ( #30239 )
2021-12-23 12:25:12 +02:00
71ef0b4c2b
bpo-46157: fix typo in docs (GH-30237)
2021-12-23 11:17:31 +02:00
31ff96712e
bpo-46140: take more Py_buffer arguments as const * (GH-30217)
2021-12-22 15:07:46 +02:00
e9a01e231a
Update potentially confusing note for mean. (GH-30174)
2021-12-21 09:00:53 +00:00
7c5c3f7254
bpo-46104: Fix example broken by GH-30148 (GH-30203)
...
See discussion in GH-30179.
2021-12-20 12:48:35 +08:00
29ea68bd1d
Revert "bpo-46131: add fastpath for PyFloat_Check() (GH-30200)" (GH-30208)
...
This reverts commit 2ef06d4125
2021-12-19 15:05:46 -06:00
2ef06d4125
bpo-46131: add fastpath for PyFloat_Check() ( #30200 )
2021-12-19 14:24:30 -06:00
aeb9ef4c72
bpo-46076: Improve documentation for per-attribute docstrings with `__slots__` (GH-30109)
2021-12-19 14:20:07 -06:00
3d3615f41f
bpo-46130: [docs] Add anchor for whatsnew/3.10 type hint section (GH-30199)
...
This allows the title to be translated to other languages without linking problems.
2021-12-19 22:06:35 +08:00
da4b214304
bpo-42413: Replace `concurrent.futures.TimeoutError` and `asyncio.TimeoutError` with builtin `TimeoutError` (GH-30197)
...
Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>
2021-12-19 13:22:40 +02:00
fe68486197
bpo-46044: Fix doc typo introduced in GH-30043 (GH-30171)
...
See https://github.com/python/cpython/pull/30043/files#r770944718
My bad I likely messed up by using a repeat command in my editor
Automerge-Triggered-By: GH:merwok
2021-12-18 13:19:07 -08:00
ae36cd1e79
bpo-37578: glob.glob -- added include_hidden parameter (GH-30153)
...
Automerge-Triggered-By: GH:asvetlov
2021-12-18 06:23:34 -08:00
6f2df42951
bpo-46113: Minor fixes in stdtypes documentation (GH-30167)
...
* Fix#1 - isidentifier() function output
* Fix#2 Update the str.splitlines() function parameter
* Fix#3 Removed unwanted full stop for str and bytes types double quotes examples.
* Fix#4 Updated class dict from **kwarg to **kwargs
2021-12-18 21:52:51 +08:00
6ada013df1
bpo-46104: Reduce use of pre-PEP 526 syntax in typing docs (GH-30148)
...
Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>
2021-12-18 18:23:51 +08:00
396b58345f
bpo-45711: Remove type and traceback from exc_info (GH-30122)
...
* Do not PUSH/POP traceback or type to the stack as part of exc_info
* Remove exc_traceback and exc_type from _PyErr_StackItem
* Add to what's new, because this change breaks things like Cython
2021-12-17 14:46:22 +00:00
62a0a2a25d
Doc: some rst linting. (GH-30149)
2021-12-17 13:55:03 +01:00
ecdc0ccede
bpo-46044: Annotate deprecated sdists formats (GH-30043)
...
While this page have deprecated informations it is still heavily index
by Google.
Discussed on twitter: https://twitter.com/brettsky/status/1469465729082662916
2021-12-16 11:57:39 -08:00
30322c497e
bpo-22047: [argparse] deprecate nested argument groups and mutually exclusive groups (GH-30098)
2021-12-16 15:31:08 +00:00
4506bbede1
bpo-46072: Document --enable-stats option. (GH-30139)
2021-12-16 13:40:54 +00:00
c5d18a5014
Fix the output of built-in iter() function example in Iterators (Section 9.8) of The Python Tutorial (GH-30110)
...
Updated the output for it=iter(s) from <iterator object at 0x00A1DB50> to <str_iterator object at 0x10c90e650>
2021-12-16 18:40:12 +08:00
a951c95a13
bpo-28816: [doc] clarify that zipimport invokes importers only for python files (GH-30060)
2021-12-16 09:12:24 +00:00
f025ae63dc
Add Positional only arguments forward slash (/) to sorted() function in Built-in Functions document (GH-30113)
...
sorted() function is missing forward slash (/) in Built-in Functions documentation page.
Automerge-Triggered-By: GH:asvetlov
2021-12-15 03:24:38 -08:00
f54fee7f37
Document new call opcodes for 3.11 (GH-30107)
2021-12-14 23:40:44 +00:00
9f8f45144b
bpo-44525: Split calls into PRECALL and CALL (GH-30011)
...
* Add 3 new opcodes for calls: PRECALL_METHOD, CALL_NO_KW, CALL_KW.
* Update specialization to handle new CALL opcodes.
* Specialize call to method descriptors.
* Remove old CALL opcodes: CALL_FUNCTION, CALL_METHOD, CALL_METHOD_KW, CALL_FUNCTION_KW.
2021-12-14 18:22:44 +00:00
d60457a667
bpo-45292: [PEP-654] add except* (GH-29581)
2021-12-14 16:48:15 +00:00
1cbb88736c
bpo-46059: Clarify pattern-matching example in "control flow" docs (GH-30079)
...
The "Color" example in the pattern-matching section of the "control flow" documentation is not immediately runnable, leading to confusion.
Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
2021-12-14 23:04:29 +08:00
cb589d1b6b
bpo-46063: Improve algorithm for computing which rolled-over log file… (GH-30093)
2021-12-14 00:53:37 +00:00
eb483c46d6
bpo-45949: Pure Python freeze module for cross builds (GH-29899)
2021-12-13 20:48:46 +01:00
a62be77266
bpo-45643: Add signal.SIGSTKFLT on platforms where this is defined (GH-29266)
2021-12-13 18:22:43 +01:00
e09705f58f
Clarify new_event_loop return value. (GH-30078)
2021-12-13 14:39:22 +02:00
481f3ffdbe
bpo-37602: Clarify that the lib2to3 nonzero fixer changes only definitions (GH-30075)
2021-12-13 10:04:34 +00:00
d0669c5e69
Remove erroneous padding in dataclasses (GH-30076)
...
Automerge-Triggered-By: GH:ericvsmith
2021-12-12 10:05:48 -08:00
f4095e53ab
bpo-45855: document that `no_block` has no use anymore in PyCapsule_Import ( #29665 )
2021-12-12 10:49:50 +01:00
e029c53e1a
bpo-44674: Use unhashability as a proxy for mutability for default dataclass __init__ arguments. (GH-29867)
...
`@dataclass` in 3.10 prohibits using list, dict, or set as default values. It does this to avoid the mutable default problem. This test is both too strict, and not strict enough. Too strict, because some immutable subclasses should be safe, and not strict enough, because other mutable types should be prohibited. With this change applied, `@dataclass` now uses unhashability as a proxy for mutability: if objects aren't hashable, they're assumed to be mutable.
2021-12-11 16:12:17 -05:00
4fe5585240
bpo-19737: Improved the documentation for globals (GH-29823)
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-12-11 01:04:21 +01:00
c1051e08b3
bpo-42114: ctypes documentation: fix winmode parameter default value (GH-29976)
...
Signed-off-by: Louis Sautier <sautier.louis@gmail.com>
2021-12-11 00:00:02 +01:00
8c74713d0e
bpo-42182: stdtypes doc - update and fix links to several dunder methods (GH-27384)
2021-12-10 11:40:06 +02:00
50669083fe
bpo-43931: Export Python version as API data (GH-25577)
...
When Python is embedded in other applications, it is not easy to determine which version of Python is being used. This change exposes the Python version as part of the API data. Tools like Austin (https://github.com/P403n1x87/austin ) can benefit from this data when targeting applications like uWSGI, as the Python version can then be inferred systematically by looking at the exported symbols rather than relying on unreliable pattern matching or other hacks (like remote code execution etc...).
Automerge-Triggered-By: GH:pablogsal
2021-12-09 17:52:05 -08:00
b123ad8030
bpo-46016: Fix rest syntax of GH-29993 (GH-30006)
2021-12-09 15:24:32 +01:00
e2cfc89e09
bpo-45391: mark UnionType as a class in documentation (GH-28757)
...
Signed-off-by: Bernát Gábor <bgabor8@bloomberg.net>
2021-12-09 20:56:14 +08:00
73325bbe77
bpo-46007: Exclude PyUnicode_CHECK_INTERNED() from limited C API (GH-29987)
...
Exclude the PyUnicode_CHECK_INTERNED() macro from the limited C API,
because it uses the PyASCIIObject structure which is excluded from
the limited C API.
Automerge-Triggered-By: GH:encukou
2021-12-09 00:58:09 -08:00
9fe0de28bc
Merge remote-tracking branch 'upstream/main'
2021-12-08 23:41:16 +00:00
267539bff7
bpo-46016: fcntl module add FreeBSD's F_DUP2FD_CLOEXEC flag support (GH-29993)
2021-12-08 23:28:51 +01:00
3ea574f35b
Fix some false positives of documentation syntax problems
2021-12-08 22:22:55 +00:00
69806b9516
bpo-46009: Do not exhaust generator when send() method raises (GH-29986)
2021-12-08 12:09:26 +00:00
3e0f13b9e4
doc: Add link issue 44010 (GH-29454)
2021-12-08 12:55:39 +02:00
7989e9dff6
bpo-40222: update doc entry with respect to the change in WITH_EXCEPT_START (GH-29975)
2021-12-08 09:41:28 +00:00
4ccccb1cfc
bpo-20751: Match variable name to the example. (GH-29980)
2021-12-07 21:38:21 -06:00
c7e7a4b969
bpo-35821: Fix restructuredtext code formatting in logging.rst (GH-29963)
2021-12-07 23:25:13 +08:00
cf7eaa4617
Revert "bpo-28533: Remove asyncore, asynchat, smtpd modules (GH-29521)" (GH-29951)
...
This reverts commit 9bf2cbc4c4
2021-12-07 12:31:04 +01:00
2bf551757e
bpo-35821: Add an example to Logger.propagate documentation. (GH-29841)
2021-12-07 11:15:44 +00:00
8db06528ca
bpo-46001: Change OverflowError to RecursionError in JSON library docstrings (GH-29943)
2021-12-07 11:58:40 +02:00
8518ee348c
removal of duplicated text paragraph ( #29666 )
2021-12-07 01:12:29 +02:00
c0521fe49f
bpo-45840: Improve cross-references in the data model documentation (GH-29633)
2021-12-05 22:49:36 +02:00
60c320c38e
bpo-37295: Optimize math.comb() and math.perm() (GH-29090)
...
For very large numbers use divide-and-conquer algorithm for getting
benefit of Karatsuba multiplication of large numbers.
Do calculations completely in C unsigned long long instead of Python
integers if possible.
2021-12-05 22:26:10 +02:00
64be8d369b
bpo-45847: Update whatsnew and add place holder entries for missing extensions (GH-29914)
2021-12-04 15:14:48 +01:00
135ecc3492
bpo-20751: Replace method example with attribute example, matching the descriptor howto (GH-29909)
2021-12-03 20:37:08 -06:00
5bb7ef2768
bpo-45607: Make it possible to enrich exception displays via setting their __note__ field (GH-29880)
2021-12-03 22:01:15 +00:00
99fcf15052
bpo-45582: Port getpath[p].c to Python (GH-29041)
...
The getpath.py file is frozen at build time and executed as code over a namespace. It is never imported, nor is it meant to be importable or reusable. However, it should be easier to read, modify, and patch than the previous code.
This commit attempts to preserve every previously tested quirk, but these may be changed in the future to better align platforms.
2021-12-03 00:08:42 +00:00
9f2f7e4226
bpo-45916: Use HTTPS link for The Perils of Floating Point (GH-29896)
2021-12-02 14:24:25 -06:00
a31173c5ce
bpo-40280: Update what's new (GH-29893)
2021-12-02 18:42:56 +01:00
b2afdc95cc
bpo-45535: Improve output of Enum ``dir()`` (GH-29316)
...
Modify the ``EnumType.__dir__()`` and ``Enum.__dir__()`` to ensure
that user-defined methods and methods inherited from mixin classes always
show up in the output of `help()`. This change also makes it easier for
IDEs to provide auto-completion.
2021-12-02 08:49:52 -08:00
a6c3b0faa1
bpo-45954: Rename PyConfig.no_debug_ranges to code_debug_ranges (GH-29886)
...
Rename PyConfig.no_debug_ranges to PyConfig.code_debug_ranges and
invert the value.
Document -X no_debug_ranges and PYTHONNODEBUGRANGES env var in
PyConfig.code_debug_ranges documentation.
2021-12-02 11:43:37 +01:00
226d22ff2d
docs: Improve example for urlparse() (GH-29816)
2021-12-02 10:52:32 +02:00
c2bb29ce9a
bpo-30533: Add docs for `inspect.getmembers_static` ( #29874 )
...
* Add docs for `inspect.getmembers_static`
* update
2021-12-01 11:23:46 -08:00
f27bef3043
bpo-45896: Fix docs default asyncio event loop on Windows (GH-29857)
2021-12-01 14:24:46 +02:00
8a45ca542a
bpo-45711: Change exc_info related APIs to derive type and traceback from the exception instance (GH-29780)
2021-11-30 22:37:04 +00:00
f97ec09baf
bpo-33381: [doc] strftime's %f option may pad zeros on the left or the right (GH-29801)
2021-11-30 11:01:44 +00:00
6266e4af87
bpo-45917: Add math.exp2() method - return 2 raised to the power of x (GH-29829)
...
Co-authored-by: Mark Dickinson <dickinsm@gmail.com>
2021-11-29 18:55:43 +00:00
c1f93f0d37
bpo-43905: Expand dataclasses.astuple() and asdict() docs (GH-26154)
...
Expanded ``astuple()`` docs, warning about deepcopy being applied
and providing a workaround.
Automerge-Triggered-By: GH:ericvsmith
2021-11-29 10:10:32 -08:00
992565f7f7
bpo-45881: configure --with-freeze-module --with-build-python (GH-29835)
...
Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
Co-authored-by: Ethan Smith <ethan@ethanhs.me>
2021-11-29 17:23:29 +01:00
c4a69a4ad0
bpo-45828: Use unraisable exceptions within sqlite3 callbacks (FH-29591)
2021-11-29 15:22:32 +00:00
6ac3c8a314
bpo-40280: Emscripten systems use .wasm suffix by default (GH-29842)
2021-11-29 16:01:55 +01:00
39b60ceae8
[Doc] Add info to logging cookbook about running logging socket listeners i… (GH-29838)
2021-11-29 13:06:52 +00:00
94daf39b2f
Fix markup buglet in Doc/howto/annotations.rst ( #29802 )
2021-11-26 14:10:01 -08:00
cd876c8493
bpo-45619: documentation of execution model: clarify and update binding summary ( #29232 )
...
This does two changes that are quite related.
0. it add that variable binding can occur in pattern matching, an update of 3.10
which seems to have been omitted from the list of bindings
1. Given how long the sentence already was, with even subcases in the middle of
the sentence, the commit breaks the sentence into an actual list.
2021-11-25 21:19:06 -08:00
e0f8a3e9b9
Add missing 'await writer.drain()' call to example (GH-29162)
...
Automerge-Triggered-By: GH:asvetlov
2021-11-25 09:15:24 -08:00
4dd82194f4
bpo-45568: Actually use @asynccontextmanager in usage example (GH-29151)
...
Automerge-Triggered-By: GH:asvetlov
2021-11-25 04:30:48 -08:00
d71c7bc733
bpo-45693: Document `port` parameter to `loop.create_server` (GH-29760)
...
Document the `port` parameter to `loop.create_server` in `asyncio`. In
particular, note that if `host` resolves to multiple network interfaces,
passing in `port=0` will result in a different random unused port being
used for each interface.
Automerge-Triggered-By: GH:ericvsmith
2021-11-24 11:43:57 -08:00
d5cd2effa6
bpo-45514: Deprecate importlib resources legacy functions. (GH-29036)
...
* bpo-45514: Apply changes from importlib_resources@a3ef4128c6
* Mark legacy functions as deprecated in the docs and link to the migration docs in importlib_resources docs.
* Apply changes from importlib_resources@329ae9d5f2c.
* Indicate importlib.resources as a module.
Co-authored-by: Filipe Laíns <lains@riseup.net>
2021-11-24 02:51:37 -05:00
ae1965ccb4
bpo-45703: Invalidate _NamespacePath cache on importlib.invalidate_ca… (GH-29384)
...
Consider the following directory structure:
.
└── PATH1
└── namespace
└── sub1
└── __init__.py
And both PATH1 and PATH2 in sys path:
$ PYTHONPATH=PATH1:PATH2 python3.11
>>> import namespace
>>> import namespace.sub1
>>> namespace.__path__
_NamespacePath(['.../PATH1/namespace'])
>>> ...
While this interpreter still runs, PATH2/namespace/sub2 is created:
.
├── PATH1
│ └── namespace
│ └── sub1
│ └── __init__.py
└── PATH2
└── namespace
└── sub2
└── __init__.py
The newly created module cannot be imported:
>>> ...
>>> namespace.__path__
_NamespacePath(['.../PATH1/namespace'])
>>> import namespace.sub2
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
ModuleNotFoundError: No module named 'namespace.sub2'
Calling importlib.invalidate_caches() now newly allows to import it:
>>> import importlib
>>> importlib.invalidate_caches()
>>> namespace.__path__
_NamespacePath(['.../PATH1/namespace'])
>>> import namespace.sub2
>>> namespace.__path__
_NamespacePath(['.../PATH1/namespace', '.../PATH2/namespace'])
This was not previously possible.
2021-11-23 07:38:02 -08:00
2c047f604e
Clarify that discutils.(plat)include is for CPython's headers (GH-29578)
...
Change the docs to note that "include" and "platinclude" are
for CPython's headers, and not necessarily for headers of
third-party libraries.
See discussion in: https://discuss.python.org/t/clarification-on-a-wheels-header-data/9305/19
2021-11-23 11:28:14 +01:00
135cabd328
bpo-44525: Copy free variables in bytecode to allow calls to inner functions to be specialized (GH-29595)
...
* Make internal APIs that take PyFrameConstructor take a PyFunctionObject instead.
* Add reference to function to frame, borrow references to builtins and globals.
* Add COPY_FREE_VARS instruction to allow specialization of calls to inner functions.
2021-11-23 09:53:24 +00:00
024209401e
bpo-42238: [doc] Announce the future removal of make suspicous. (GH-29652)
...
* bpo-42238: [doc] Announce the future removal of make suspicous.
* Add a news entry.
2021-11-22 15:17:54 -08:00
d2b55b07d2
bpo-45766: Add direct proportion option to linear_regression(). ( #29490 )
...
* bpo-45766: Add direct proportion option to linear_regression().
* Update 2021-11-09-09-18-06.bpo-45766.dvbcMf.rst
* Use ellipsis to avoid round-off issues.
* Update Misc/NEWS.d/next/Library/2021-11-09-09-18-06.bpo-45766.dvbcMf.rst
Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
* Update signature in main docs
* Fix missing comma
Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
2021-11-21 08:39:26 -06:00
fdc0e09c33
bpo-44733: Add max_tasks_per_child to ProcessPoolExecutor (GH-27373)
...
Co-authored-by: Antoine Pitrou <antoine@python.org>
2021-11-20 21:19:41 +01:00
123a3527dd
bpo-45845: Change link for pyserial (GH-29675)
2021-11-20 14:56:42 -05:00
9852339145
bpo-44844: Remove unresponsive web link (GH-29651)
...
Threading notes by Aahz from OSCON 2001.
2021-11-20 13:21:14 -05:00
ee49484c0f
[doc] Clarify MRO precedence in descriptor super binding section (GH-29539)
...
A similar sentence is present in the 'Invocation from super' section of
the descriptor HOWTO, where it is already correct.
2021-11-20 17:55:35 +01:00
bc2bc0dbdb
bpo-45846: Fix capitalisation of Van Rossum at the start of sentence (GH-29641)
2021-11-20 11:35:39 +02:00
be36e06340
bpo-45250: fix docs regarding `__iter__` and iterators being inconsistently required by CPython (GH-29170)
...
It is now considered a historical accident that e.g. `for` loops and the `iter()` built-in function do not require the iterators they work with to define `__iter__`, only `__next__`.
2021-11-19 16:40:34 -08:00
e34809e1c2
bpo-19072: Classmethod can wrap other classmethod like descriptors (GH-29634)
...
staticmethod() also became callable in Python 3.10.
See: b83861f02
2021-11-19 19:43:49 +01:00
d32316a2aa
bpo-42238: [doc]: Hide false positive in make suspicious. (GH-29636)
2021-11-19 19:11:24 +01:00
4575c01b75
bpo-45788: Link sys.prefix doc to 'Installation paths' ( #29606 )
...
... To the Installation paths section of the sysconfig doc.
2021-11-18 15:08:24 -05:00
32959108f9
bpo-45640: [docs] Tokens are now clickable (GH-29260)
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-11-18 17:06:38 +01:00
31b3a70edb
[doc] bpo-45680: Disambiguate ``__getitem__`` and ``__class_getitem__`` in the data model (GH-29389)
...
The documentation explaining Python's data model does not adequately explain
the differences between ``__getitem__`` and ``__class_getitem__``, nor does it
explain when each is called. There is an attempt at explaining
``__class_getitem__`` in the documentation for ``GenericAlias`` objects, but
this does not give sufficient clarity into how the method works. Moreover, it
is the wrong place for that information to be found; the explanation of
``__class_getitem__`` should be in the documentation explaining the data model.
This PR has been split off from GH-29335.
2021-11-18 16:54:25 +01:00
c94664c262
bpo-45837: Properly deprecate turtle.RawTurtle.settiltangle (GH-29618)
2021-11-18 16:02:48 +01:00
fc4474e45e
bpo-45429: Merge whatsnew about time.sleep (GH-29589)
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-11-18 01:26:59 +01:00
abc0d754c3
[docs] Add missing word "any" in unittest -k cmdline option description (GH-29571)
2021-11-18 00:25:53 +01:00
15409c720b
bpo-28806: Continue work: improve the netrc library (GH-26330)
...
Continue with the improvement of the library netrc
Original work and report Xiang Zhang <angwerzx@126.com>
* 📜 🤖 Added by blurb_it.
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
2021-11-17 11:07:54 +02:00
d7e210070f
bpo-37800: Clean up importlib documentation for some module attributes (GH-10016)
...
Automerge-Triggered-By: GH:brettcannon
2021-11-16 11:59:45 -08:00
55868f1a33
bpo-45429: Support CREATE_WAITABLE_TIMER_HIGH_RESOLUTION if possible (GH-29203)
2021-11-16 22:41:20 +09:00
9bf2cbc4c4
bpo-28533: Remove asyncore, asynchat, smtpd modules (GH-29521)
...
Remove the asyncore and asynchat modules, deprecated in Python
3.6: use the asyncio module instead.
Remove the smtpd module, deprecated in Python 3.6: the aiosmtpd
module can be used instead, it is based on asyncio.
* Remove asyncore, asynchat and smtpd documentation
* Remove test_asyncore, test_asynchat and test_smtpd
* Rename Lib/asynchat.py to Lib/test/support/_asynchat.py
* Rename Lib/asyncore.py to Lib/test/support/_asyncore.py
* Rename Lib/smtpd.py to Lib/test/support/_smtpd.py
* Remove DeprecationWarning from private _asyncore, _asynchat and
_smtpd modules
* _smtpd: remove deprecated properties
2021-11-16 00:29:17 +01:00
3352834f59
bpo-43225: [DOC] Add missing value returned by methods on cookiejar (GH-24522)
...
* Add missing value returned by methods on cookiejar
Documentation say that return something but don't specific with what
value is return, and that can be confuse. This patch add that information.
* Update Doc/library/http.cookiejar.rst
Co-authored-by: andrei kulakov <andrei.avk@gmail.com>
* Update Doc/library/http.cookiejar.rst
Co-authored-by: andrei kulakov <andrei.avk@gmail.com>
Co-authored-by: andrei kulakov <andrei.avk@gmail.com>
2021-11-15 14:44:32 -08:00
ad43dc0b54
bpo-25381: Update explanation of exceptions in C. (GH-26838)
...
* bpo-25381: Update explanation of exception globals
This paragraph in extending/extending.rst was unchanged (except for
NULL markup) since committed in 2007 Aug 15 for 2.6 alpha.
* Respond to reviews and remove duplication.
* Update Doc/extending/extending.rst
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2021-11-15 14:38:53 -08:00
c750adbe69
Save a reference for ensure_future and create_task (GH-29163)
...
Co-authored-by: Joannah Nanjekye <jnanjekye@python.org>
2021-11-15 14:30:28 -08:00
6c5a312fb6
bpo-45677: Reword first section of `sqlite3` docs ( #29326 )
...
* bpo-45677: Avoid addressing the reader as 'you' in sqlite3 docs
* Adjust wording
* Adjust wording again
* Typo
* Update Doc/library/sqlite3.rst
Co-authored-by: Jacob Walls <jacobtylerwalls@gmail.com>
* Address review: adjust wording
* Update Doc/library/sqlite3.rst
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Update Lib/sqlite3/__init__.py
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Update Doc/library/sqlite3.rst
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Update Doc/library/sqlite3.rst
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Update Lib/sqlite3/__init__.py
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Update Doc/library/sqlite3.rst
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Apply Alex' suggestion, and apply 80 char limit to PR
* Minor adjustment
Co-authored-by: Jacob Walls <jacobtylerwalls@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2021-11-15 14:22:42 -08:00
b7360ae395
bpo-45752: Fix no-support examples in 'copy' docs (GH-29548)
2021-11-14 11:34:37 +02:00
f8da00ef04
bpo-45799: [Doc] improve confusing sentence in __main__.rst (GH-29546)
...
I was reading this bit last night and thought it was a typo. In the light of day, I realized it wasn't *technically* a typo, but definitely confusing wording. This PR fixes the confusing sentence.
Automerge-Triggered-By: GH:ericvsmith
2021-11-13 12:16:05 -08:00
4c792f39e6
bpo-45772: socket.socket should be a class instead of a function (GH-23960)
...
* bpo-45772: socket.socket should be a class instead of a function
Currently `socket.socket` is documented as a function, but it is really
a class (and thus has function-like usage to construct an object). This
correction would ensure that Python projects that are interlinking
Python's documentation can properly locate `socket.socket` as a type.
2021-11-13 08:02:04 +02:00
8f1b71de73
bpo-45711: Re-bump the magic number and update doc (GH-29528)
2021-11-12 13:21:45 +00:00
e501d70b34
bpo-45792: Fix contextvar.Token's intersphinx FQN (GH-29533)
...
Since `.. module:: contextvars` sets the module using `.. class:: contextvars.Token`, intersphinx records it as `contextvars.contextvars.Token`.
2021-11-12 11:47:55 +02:00
9178f533ff
bpo-45636: Merge all numeric operators (GH-29482)
2021-11-10 22:56:22 -08:00
1cbaa505d0
bpo-45696: Deep-freeze selected modules (GH-29118)
...
This gains 10% or more in startup time for `python -c pass` on UNIX-ish systems.
The Makefile.pre.in generating code builds on Eric's work for bpo-45020, but the .c file generator is new.
Windows version TBD.
2021-11-10 18:01:53 -08:00
fc9b622819
bpo-45723: Add --with-pkg-config to configure (GH-29517)
...
Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
2021-11-10 23:02:19 +01:00
0a9f69539b
bpo-45747: Detect gdbm/dbm dependencies in configure (GH-29467)
...
Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
2021-11-10 20:26:55 +01:00
912a4ccc3a
bpo-45701: Improve documentation for *typed* parameter (GH-29498)
2021-11-09 17:01:29 -06:00
5b7c7cb104
bpo-45763: Detect compression build deps in configure (GH-29483)
2021-11-09 16:42:53 +01:00
7484a5c82a
Closes bpo-45712: Add missing word in control flow tutorial (GH-29460)
2021-11-08 10:51:01 -06:00
99c7e9853f
bpo-40170: Update What's New in Python 3.9 (GH-29470)
...
The PyType_HasFeature() change has been reverted: the static inline
function access directly the PyTypeObject.tp_flags member.
2021-11-08 17:41:56 +01:00
19b107e9b5
bpo-45741: docs: fix plural (GH-29461)
...
"entry points provides" -> "entry points provide"
Automerge-Triggered-By: GH:ericvsmith
2021-11-07 22:03:44 -08:00
57457a1e5c
bpo-39452: [doc] Change "must" to "can" on relative import style in `__main__` (GH-29379)
2021-11-06 19:09:23 +01:00
77a2c77c84
[doc] bpo-45680: Improve glossary entry for generic types (GH-29388)
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-11-06 19:00:45 +01:00
6ecead106a
[doc] minor fixes to expressions.rst (GH-29444)
2021-11-06 10:26:43 -07:00
cb755dba7a
bpo-45740: [Enum] add versionadded markers to docs (GH-29443)
...
[Enum] add versionadded markers to docs
2021-11-06 10:16:43 -07:00
71e8a3e76a
bpo-45762: Improve docs for ``@singledispatch``/``@singledispatchmethod`` (GH-29426)
2021-11-05 17:25:08 +01:00
87032cfa3d
Remove reference to ``Tuple`` at top of ``typing`` docs (GH-29401)
...
``typing.Tuple`` has been deprecated since Python 3.9, so it makes no sense to mention it so prominently in the documentation for the ``typing`` module.
2021-11-04 19:48:40 +08:00
e03e50377d
bpo-45680: ``typing`` docs: improve links to docs on ``GenericAlias``/``__class_getitem__`` (GH-29387)
2021-11-04 12:06:34 +08:00
c273986711
bpo-45613: Set `sqlite3.threadsafety` dynamically (GH-29227)
...
Use the compile-time selected default SQLite threaded mode to set the
DB-API 2.0 attribute 'threadsafety'
Mappings:
- SQLITE_THREADSAFE=0 => threadsafety=0
- SQLITE_THREADSAFE=1 => threadsafety=3
- SQLITE_THREADSAFE=2 => threadsafety=1
2021-11-03 21:01:37 +00:00
456e27ac0a
bpo-24139: Add support for SQLite extended result codes (GH-28076)
2021-11-02 23:49:38 +00:00
48824fa1e2
[doc] Link to section File input (GH-28941)
2021-11-02 22:34:00 +01:00
3551bf16ee
bpo-45457: Minor fix to documentation for SSLContext.load_default_certs. (GH-28947)
...
Specify that SSLContext.set_default_verify_paths is called on ALL systems.
The code of SSLContext.load_default_certs was changed in bpo-22449 to do this,
this fix corrects the documentation to match that change.
2021-11-02 22:27:44 +01:00
454cdb99ab
bpo-45633: Fix newtypes doc typo (GH-29318)
2021-11-02 22:47:06 +08:00
b6b38a8226
bpo-45243: Add support for setting/getting `sqlite3` connection limits (GH-28463)
2021-11-01 22:50:53 +00:00
14a4fce457
bpo-45618: Update Sphinx version used to build the documentation to 4.2.0 (GH-29256)
...
Updating version of Sphinx to most recent one, 4.2.0. Documentation builds without warnings.
Sphinx 4.2.0 release notes: https://www.sphinx-doc.org/en/master/changes.html#release-4-2-0-released-sep-12-2021 .
cc @JulienPalard
Automerge-Triggered-By: GH:JulienPalard
2021-10-31 13:51:33 -07:00
ee464322eb
Move field width to the right field (GH-29344)
...
Automerge-Triggered-By: GH:vsajip
2021-10-31 10:44:23 -07:00
bc8fd7c9c2
bpo-45516: fix Traversable.name documentation (GH-29194)
...
Here we go again... Sorrry!
Signed-off-by: Filipe Laíns <lains@riseup.net>
Automerge-Triggered-By: GH:jaraco
2021-10-31 07:57:21 -07:00
aae18a1740
Fix docs source link for importlib.metadata (GH-29025)
...
The link broke for Python 3.10 since importlib.metadata was made from a module into a package
I think this is trivial enough to not need a bpo issue.
Automerge-Triggered-By: GH:jaraco
2021-10-30 08:12:47 -07:00
b17cfd150f
bpo-45600: Enhanced / clarified the docs for os.environ and os.environb (GH-29204)
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-10-29 22:18:45 +02:00
3877fc02f7
bpo-45335: Add note to `sqlite3` docs about "timestamp" converter (GH-29200)
2021-10-29 22:17:22 +02:00
f0150ac94a
bpo-45548: Some test modules must be built as shared libs (GH-29268)
...
Some test cases don't work when test modules are static extensions.
Add dependency on Modules/config.c to trigger a rebuild whenever a
module build type is changed.
``makesetup`` puts shared extensions into ``Modules/`` directory. Create
symlinks from pybuilddir so the extensions can be imported.
Note: It is not possible to use the content of pybuilddir.txt as a build
target. Makefile evaluates target variables in the first pass. The
pybuilddir.txt file does not exist at that point.
2021-10-29 17:49:57 +02:00
d9575218d7
bpo-45655: Add ref to union type expressions at top of typing docs (GH-29309)
2021-10-29 21:56:21 +08:00
074fa57506
bpo-45395: Make custom frozen modules additions instead of replacements. (gh-28778)
...
Currently custom modules (the array set on PyImport_FrozenModules) replace all the frozen stdlib modules. That can be problematic and is unlikely to be what the user wants. This change treats the custom frozen modules as additions instead. They take precedence over all other frozen modules except for those needed to bootstrap the import system. If the "code" field of an entry in the custom array is NULL then that frozen module is treated as disabled, which allows a custom entry to disable a frozen stdlib module.
This change allows us to get rid of is_essential_frozen_module() and simplifies the logic for which frozen modules should be ignored.
https://bugs.python.org/issue45395
2021-10-28 15:04:33 -06:00
03db1bbfd2
bpo-45655: Add "relevant PEPs" section to ``typing`` documentation (GH-29280)
...
The list of PEPs at the top of the documentation for the ``typing`` module has
become too long to be readable. This PR proposes presenting this
information in a more structured and readable way by adding a new "relevant
PEPs" section to the ``typing`` docs.
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-10-28 21:55:50 +02:00
d9c1868c25
bpo-45583: Correct datamodel documentation of int() (GH-29182)
...
It should be noted that this part of the documentation is redundant with
function.rst's documentation of int. This one was correctly updated with Python 3.8.
2021-10-28 21:48:37 +02:00
1fb968c07a
bpo-45604: add `level` argument to `multiprocessing.log_to_stderr` func (GH-29226)
...
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
2021-10-28 21:38:14 +02:00
88d8a1a340
bpo-45608: Document missing `sqlite3` DB-API attributes and methods (GH-29219)
2021-10-28 21:35:51 +02:00
0a68b3603f
Fix typo in Counter documentation (GH-29223)
...
Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
2021-10-28 18:43:09 +08:00
Hugo van Kemenade
Victor Stinner
Irit Katriel
Christian Heimes
Jelle Zijlstra
Ben Kehoe
Julien Palard
Julian Gilbey
Michael Oliver
Nikita Sobolev
Raymond Hettinger
Inada Naoki
Erlend Egeberg Aasland
Zsolt Dollenstein
Jacob Walls
Vinay Sajip
Mark Shannon
penguin_wwy
Brandt Bucher
Philipp Claßen
Kumar Aditya
Pablo Galindo Salgado
David Gilbertson
David CARLIER
Jade Lovelace
Benjamin Peterson
Sebastian Pipping
Jason R. Coombs
Joe
Rafael Fontenelle
David Hewitt
Mark Dickinson
Alex Waygood
Matti Picus
Matthias Bussonnier
andrei kulakov
Vivek Vashist
Gareth Rees
Paul Bryan
Andre Delfino
Georg Brandl
Eric V. Smith
180909
Louis Sautier
Gabriele N. Tornetta
Kumar Aditya
Bernát Gábor
Ken Jin
James Gerity
Taras Sereda
Serhiy Storchaka
Steve Dower
Zachary Ware
Christian Clauss
Weipeng Hong
Rob
Vishal Pandey
Gideon
Guido van Rossum
Arthur Milchior
Sergey Kolesnikov
Zbigniew Siciarz
Jim Crist-Harif
Miro Hrončok
Petr Viktorin
Logan Jones
Terry Jan Reedy
Jouke Witteveen
JMcB
Brett Cannon
Dong-hee Na
ch33zer
Emmanuel Arias
Géry Ogam
Joannah Nanjekye
M. Mostafa Farzan
Jack DeVries
Hong Xu
Hynek Schlawack
Ethan Furman
LincolnPuzey
Dmitry Smirnov
m-aciek
Olaf van der Spek
Filipe Laíns
Philipp A
Ian Fisher
Eric Snow
Justinas Petuchovas