4b99803b86
doc: Clarify os.urandom return type ( #30282 )
...
Other descriptions in the same file also use 'bytestring' to refer to bytes objects
2022-01-19 13:22:15 -08:00
d45cd2d207
Update documentation in datetime module strftime-and-strptime-behavior fix typo in '%W' format code description (GH-30232)
...
A small change to the documentation of datetime module , in the format codes section of stftime and strptime. Changed the description of format code '%W' from 'as a decimal number' to 'a zero padded decimal number' so it's in line with the example having leading zeros. Similar to the format code '%U' above.
Automerge-Triggered-By: GH:pganssle
2022-01-19 09:39:57 -08:00
1faf7c4eff
bpo-45680: Minor formatting fix in stdtypes.rst (GH-30690)
...
Makes quotation consistent with rest of docs in commit 0eae9a2a2d
2022-01-19 23:37:05 +08:00
0eae9a2a2d
bpo-45680: Clarify documentation on ``GenericAlias`` objects (GH-29335)
...
The documentation on ``GenericAlias`` objects implies at multiple points that
only container classes can define ``__class_getitem__``. This is misleading.
This PR proposes a rewrite of the documentation to clarify that non-container
classes can define ``__class_getitem__``, and to clarify what it means when a
non-container class is parameterized.
See also: initial discussion of issues with this piece of documentation in
GH-29308, and previous BPO issue [42280](https://bugs.python.org/issue42280 ).
Also improved references in glossary and typing docs. Fixed some links.
Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
2022-01-19 22:53:41 +08:00
3bf6315c4c
bpo-22039: [doc] clarify that there are no plans to disable deleting an attribute via PyObject_SetAttr (GH-30639)
2022-01-19 12:03:51 +00:00
a847785b40
bpo-43869: Time Epoch is the same on all platforms (GH-30664)
2022-01-19 11:27:11 +01:00
3852269b91
bpo-45554: Document multiprocessing.Process.exitcode values (GH-30142)
...
This addresses [bpo-45554]() by expanding the `exitcode` documentation to also describe what `exitcode` will be in cases of normal termination, `sys.exit()` called, and on uncaught exceptions.
Automerge-Triggered-By: GH:pitrou
2022-01-18 13:31:27 -08:00
65940fa5c1
bpo-20823: Clarify copyreg.pickle() documentation (GH-30230)
2022-01-18 21:53:43 +02:00
ff7703c4b6
bpo-43869: Improve epoch docs (GH-25777)
2022-01-18 16:55:16 +01:00
bdf2ab1887
bpo-46402: Promote SQLite URI tricks in `sqlite3` docs (GH-30660)
...
Provide some examples of URI parameters in sqlite connect().
Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
2022-01-18 07:37:02 -05:00
c47c9e6589
bpo-44934: Add optional feature AppendPath to Windows MSI installer (GH-27889)
...
The option must be enabled from the command line
2022-01-18 00:18:44 +00:00
62a6594e66
bpo-40066: [Enum] fix tests (GH-30643)
...
- skip doctest that changes depending on target system
- skip doctest that only fails on CI
- substitute in values that change depending on target system
2022-01-17 08:52:42 -08:00
83d544b929
bpo-40066: [Enum] skip failing doc test (GH-30637)
2022-01-17 07:18:13 -08:00
42a64c03ec
Revert "bpo-40066: [Enum] update str() and format() output (GH-30582)" (GH-30632)
...
This reverts commit acf7403f9b
2022-01-17 13:58:40 +01:00
acf7403f9b
bpo-40066: [Enum] update str() and format() output (GH-30582)
...
Undo rejected PEP-663 changes:
- restore `repr()` to its 3.10 status
- restore `str()` to its 3.10 status
New changes:
- `IntEnum` and `IntFlag` now leave `__str__` as the original `int.__str__` so that str() and format() return the same result
- zero-valued flags without a name have a slightly changed repr(), e.g. `repr(Color(0)) == '<Color: 0>'`
- update `dir()` for mixed-in types to return all the methods and attributes of the mixed-in type
- added `_numeric_repr_` to `Flag` to control display of unnamed values
- enums without doc strings have a more comprehensive doc string added
- `ReprEnum` added -- inheriting from this makes it so only `__repr__` is replaced, not `__str__` nor `__format__`; `IntEnum`, `IntFlag`, and `StrEnum` all inherit from `ReprEnum`
2022-01-15 22:41:43 -08:00
305588c67c
bpo-20281, bpo-29964: update datetime docs to refer %z and %Z to a pre-existing footnote (GH-30354)
2022-01-14 14:49:12 -08:00
025cbe7a9b
bpo-45569: Change PYLONG_BITS_IN_DIGIT default to 30 (GH-30497)
2022-01-14 18:54:56 +00:00
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
Florian Bruhin
Evan
Ken Jin
Alex Waygood
Irit Katriel
Victor Stinner
John Marshall
Kumar Aditya
Miguel Brito
Erlend Egeberg Aasland
bneuburg
Ethan Furman
Hugo van Kemenade
Mark Dickinson
Christian Heimes
Jelle Zijlstra
Ben Kehoe
Julien Palard
Julian Gilbey
Michael Oliver
Nikita Sobolev
Raymond Hettinger
Inada Naoki
Zsolt Dollenstein
Jacob Walls
Vinay Sajip
Mark Shannon
penguin_wwy
Brandt Bucher
Philipp Claßen
Pablo Galindo Salgado
David Gilbertson
David CARLIER
Jade Lovelace
Benjamin Peterson
Sebastian Pipping
Jason R. Coombs
Joe
Rafael Fontenelle
David Hewitt
Matti Picus
Matthias Bussonnier
andrei kulakov
Vivek Vashist
Gareth Rees
Paul Bryan