summaryrefslogtreecommitdiffstats
path: root/Doc/library
Commit message (Collapse)AuthorAgeFilesLines
* bpo-47061: document module deprecations due to PEP 594 (GH-31984)Brett Cannon2022-03-2126-22/+92
| | | Also removed asynchat, asyncore, and smtpd from their respective toctree entries so they are only in the superceded subtree.
* bpo-433030: Add support of atomic grouping in regular expressions (GH-31982)Serhiy Storchaka2022-03-211-0/+54
| | | | | | | | * Atomic grouping: (?>...). * Possessive quantifiers: x++, x*+, x?+, x{m,n}+. Equivalent to (?>x+), (?>x*), (?>x?), (?>x{m,n}). Co-authored-by: Jeffrey C. Jacobs <timehorse@users.sourceforge.net>
* bpo-47040: improve document of checksum functions (gh-31955)Ma Lin2022-03-192-12/+9
| | | | | | | Clarifies a versionchanged note on crc32 & adler32 docs that the workaround is only needed for Python 2 and earlier. Also cleans up an unnecessary intermediate variable in the implementation. Authored-By: Ma Lin / animalize Co-authored-by: Gregory P. Smith <greg@krypto.org>
* bpo-46382 dataclass(slots=True) now takes inherited slots into account ↵Arie Bovenberg2022-03-191-0/+10
| | | | | (GH-31980) Do not include any members in __slots__ that are already in a base class's __slots__.
* bpo-47066: Convert a warning about flags not at the start of the regular ↵Serhiy Storchaka2022-03-191-0/+3
| | | | expression into error (GH-31994)
* bpo-44544: add textwrap placeholder arg (GH-27671)andrei kulakov2022-03-191-2/+3
|
* bpo-47022: Document asynchat, asyncore and smtpd removals in 3.12 (GH-31891)Hugo van Kemenade2022-03-184-1/+10
| | | Document the deprecation of asyncore, asynchat, and smtpd with a slated removal in Python 3.12 thanks to PEP 594.
* bpo-45413: Define "posix_venv", "nt_venv" and "venv" sysconfig installation ↵Miro Hrončok2022-03-182-1/+19
| | | | | | | | | | | | | | | | | | | schemes (GH-31034) Define *posix_venv* and *nt_venv* sysconfig installation schemes to be used for bootstrapping new virtual environments. Add *venv* sysconfig installation scheme to get the appropriate one of the above. The schemes are identical to the pre-existing *posix_prefix* and *nt* install schemes. The venv module now uses the *venv* scheme to create new virtual environments instead of hardcoding the paths depending only on the platform. Downstream Python distributors customizing the *posix_prefix* or *nt* install scheme in a way that is not compatible with the install scheme used in virtual environments are encouraged not to customize the *venv* schemes. When Python itself runs in a virtual environment, sysconfig.get_default_scheme and sysconfig.get_preferred_scheme with `key="prefix"` returns *venv*.
* bpo-34790: Remove passing coroutine objects to asyncio.wait() (GH-31964)Andrew Svetlov2022-03-171-43/+3
| | | Co-authored-by: Yury Selivanov <yury@edgedb.com>
* bpo-46030: socket module add couple of FreeBSD constants. (GH-30018)David CARLIER2022-03-171-0/+15
| | | Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>
* Use low bit of LOAD_GLOBAL's oparg to indicate whether it should push an ↵Mark Shannon2022-03-171-2/+5
| | | | additional NULL. (GH-31933)
* bpo-46996: Remove support of Tcl/Tk < 8.5.12 (GH-31839)Serhiy Storchaka2022-03-171-3/+1
|
* bpo-46480: add typing.assert_type (GH-30843)Jelle Zijlstra2022-03-171-0/+25
| | | | Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com> Co-authored-by: David Foster <david@dafoster.net>
* bpo-46769: Improve documentation for `typing.TypeVar` (GH-31712)Alex Waygood2022-03-161-21/+55
| | | Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* bpo-30677: [doc] mention that os.mkdir() can raise FileNotFoundError (GH-31548)slateny2022-03-141-1/+2
|
* bpo-46994: Accept explicit contextvars.Context in asyncio create_task() API ↵Andrew Svetlov2022-03-142-3/+17
| | | | (GH-31837)
* bpo-47004: Sync with importlib_metadata 4.11.3. (#31854)Jason R. Coombs2022-03-131-0/+1
|
* bpo-46805: Add low level UDP socket functions to asyncio (GH-31455)Alex Grönholm2022-03-132-0/+44
|
* bpo-43215: Document Happy Eyeballs args of asyncio.open_connection (GH-24525)Illia Volochii2022-03-121-1/+5
| | | Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>
* bpo-46968: Add os.sysconf_names['SC_MINSIGSTKSZ'] (GH-31824)Victor Stinner2022-03-111-0/+3
|
* bpo-31327: Update time documentation to reflect possible errors (GH-31460)slateny2022-03-111-0/+6
| | | | | | | | | | | | | | | As per the comments, this mirrors the [datetime documentation](https://docs.python.org/3/library/datetime.html#datetime.datetime.fromtimestamp). ``` >>> import time >>> time.localtime(999999999999999999999) Traceback (most recent call last): File "<stdin>", line 1, in <module> OverflowError: timestamp out of range for platform time_t >>> time.localtime(-3600) Traceback (most recent call last): File "<stdin>", line 1, in <module> OSError: [Errno 22] Invalid argument ```
* sqlite3: normalise pre-acronym determiners (GH-31772)Erlend Egeberg Aasland2022-03-111-5/+5
| | | For consistency, replace "a SQL" with "an SQL".
* Remove print race from task_done example. (GH-31795)Raymond Hettinger2022-03-101-4/+3
|
* bpo-46917: math.nan is now always available (GH-31793)Victor Stinner2022-03-101-0/+3
|
* bpo-46677: Add examples of inheritance and attributes to `TypedDict` docs ↵Charlie Zhao2022-03-101-3/+88
| | | | | (GH-31349) Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* bpo-45138: Revert GH-28240: Expand traced SQL statements (GH-31788)Erlend Egeberg Aasland2022-03-091-6/+0
| | | | | This reverts commit d1777515f9f53b452a4231d68196a7c0e5deb879. Automerge-Triggered-By: GH:JelleZijlstra
* bpo-46245: Add optional parameter dir_fd in shutil.rmtree() (GH-30365)Serhiy Storchaka2022-03-091-2/+8
|
* bpo-45138: Expand traced SQL statements in `sqlite3` trace callback (GH-28240)Erlend Egeberg Aasland2022-03-091-0/+6
|
* Docstring: replace pysqlite with sqlite3 (GH-31758)Erlend Egeberg Aasland2022-03-091-2/+2
| | | | Replace two instances of "pysqlite" with "sqlite3" in sqlite3 docstrings. Also reword "is a no-op" to "does nothing" for clarity.
* bpo-40059: Add tomllib (PEP-680) (GH-31498)Taneli Hukkinen2022-03-082-0/+118
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This adds a new standard library module, `tomllib`, for parsing TOML. The implementation is based on Tomli (https://github.com/hukkin/tomli). ## Steps taken (converting `tomli` to `tomllib`) - Move everything in `tomli:src/tomli` to `Lib/tomllib`. Exclude `py.typed`. - Remove `__version__ = ...` line from `Lib/tomllib/__init__.py` - Move everything in `tomli:tests` to `Lib/test/test_tomllib`. Exclude the following test data dirs recursively: - `tomli:tests/data/invalid/_external/` - `tomli:tests/data/valid/_external/` - Create `Lib/test/test_tomllib/__main__.py`: ```python import unittest from . import load_tests unittest.main() ``` - Add the following to `Lib/test/test_tomllib/__init__.py`: ```python import os from test.support import load_package_tests def load_tests(*args): return load_package_tests(os.path.dirname(__file__), *args) ``` Also change `import tomli as tomllib` to `import tomllib`. - In `cpython/Lib/tomllib/_parser.py` replace `__fp` with `fp` and `__s` with `s`. Add the `/` to `load` and `loads` function signatures. - Run `make regen-stdlib-module-names` - Create `Doc/library/tomllib.rst` and reference it in `Doc/library/fileformats.rst`
* bpo-46494: Mention the typing_extensions pkg in typing docs (GH-31260)Meer Suri2022-03-081-0/+4
|
* importlib.metadata: Remove empty footnote section (GH-30451)Ned Batchelder2022-03-081-3/+0
|
* bpo-38738: Fix formatting of True and False in the threading documentation ↵Géry Ogam2022-03-041-8/+8
| | | | | | (GH-31678) * Fix formatting of True and False in the threading documentation * Update threading.rst
* bpo-25415: Remove confusing sentence from IOBase docstrings (PR-31631)slateny2022-03-041-7/+4
|
* bpo-46841: Fix error message hacks in `GET_AWAITABLE` (GH-31664)Brandt Bucher2022-03-041-1/+10
|
* bpo-6634: [doc] clarify that sys.exit() does not always exit the interpreter ↵vidhya2022-03-031-5/+3
| | | | (GH-31639)
* bpo-21910: Clarify docs for codecs writelines method (GH-31245)slateny2022-03-031-2/+3
| | | Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* bpo-45492: Corrected documentation for co_names in inspect library doc ↵slateny2022-03-021-2/+3
| | | | (GH-31456)
* bpo-46195: Do not add `Optional` in `get_type_hints` (GH-30304)Nikita Sobolev2022-03-021-3/+6
| | | | Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* bpo-44011: Document ssl_shutdown_timeout added by revisited asyncio SSL ↵Kumar Aditya2022-02-261-5/+55
| | | | implementation (GH-31597)
* bpo-45735: Promise the long-time truth that `args=list` works (GH-30982)Charlie Zhao2022-02-262-2/+30
| | | | | | For threads, and for multiprocessing, it's always been the case that ``args=list`` works fine when passed to ``Process()`` or ``Thread()``, and such code is common in the wild. But, according to the docs, only a tuple can be used. This brings the docs into synch with reality. Doc changes by Charlie Zhao. Co-authored-by: Tim Peters <tim.peters@gmail.com>
* bpo-46852: Remove the float.__set_format__() method (GH-31585)Victor Stinner2022-02-251-1/+1
| | | | | | Remove the undocumented private float.__set_format__() method, previously known as float.__set_format__() in Python 3.7. Its docstring said: "You probably don't want to use this function. It exists mainly to be used in Python's test suite."
* bpo-26897: Clarify Popen stdin, stdout, stderr file object docs (GH-30231)Kumar Aditya2022-02-251-14/+16
|
* Update dict/OrderedDict differences with code equivalents. (GH-31563)Raymond Hettinger2022-02-251-6/+23
|
* bpo-46841: Use *inline* caching for `BINARY_OP` (GH-31543)Brandt Bucher2022-02-251-7/+28
|
* bpo-34429: Noted TemporaryFile behavior on non-Posix/non-Cygwin systems ↵slateny2022-02-251-0/+3
| | | | (GH-31547)
* bpo-46659: Enhance LocaleTextCalendar for C locale (GH-31214)Victor Stinner2022-02-241-3/+4
| | | If the LC_TIME locale is "C", use the user preferred locale.
* bpo-46659: Deprecate locale.getdefaultlocale() (GH-31206)Victor Stinner2022-02-221-0/+2
| | | | | | The locale.getdefaultlocale() function is deprecated and will be removed in Python 3.13. Use locale.setlocale(), locale.getpreferredencoding(False) and locale.getlocale() functions instead.
* bpo-20923 : [doc] Explain ConfigParser 'valid section name' and .SECTCRE ↵vidhya2022-02-221-0/+3
| | | | (GH-31413)
* bpo-45390: Propagate CancelledError's message from cancelled task to its ↵Andrew Svetlov2022-02-211-0/+3
| | | | | | awaiter (GH-31383) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>