3203a74129
gh-113190: Reenable non-debug interned string cleanup (GH-113601)
2024-08-15 11:55:09 +00:00
b106cf8d97
GH-109975: Copyedit 3.13 What's New: New Features ( #122990 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Brandt Bucher <brandtbucher@gmail.com>
2024-08-15 10:08:15 +01:00
1054a755a3
GH-103484: Tell linkcheck to ignore debian manpage redirects ( #123019 )
2024-08-14 22:35:23 +01:00
8e2dc7f380
gh-123005: Add version added in enum.Flag.__len__ (GH-123007)
2024-08-14 13:30:33 -07:00
315a933a5b
Fix doctrees directory for the gettext builder ( #122997 )
2024-08-14 11:38:29 +01:00
906b796af8
gh-122873: Allow "python -m json" to work ( #122884 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Alyssa Coghlan <ncoghlan@gmail.com>
2024-08-13 17:09:38 +01:00
db6f5e1933
GH-109975: Copyedit 3.13 What's New: Release Highlights ( #122958 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-08-13 15:30:59 +01:00
be90648fb2
gh-122944: Fix incorrect prompt strings in the Python Tutorial ( #122949 )
...
In the REPL, top level comments are followed by a primary, not secondary prompt.
Fix the places in the in the tutorial that use the latter.
2024-08-12 14:30:08 -04:00
a6644d4464
GH-73991: Rework `pathlib.Path.copytree()` into `copy()` ( #122369 )
...
Rename `pathlib.Path.copy()` to `_copy_file()` (i.e. make it private.)
Rename `pathlib.Path.copytree()` to `copy()`, and add support for copying
non-directories. This simplifies the interface for users, and nicely
complements the upcoming `move()` and `delete()` methods (which will also
accept any type of file.)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-11 22:43:18 +01:00
ea70439bd2
gh-122701: Fix wording of raw strings/bytes in `lexical_analysis.rst` ( #122702 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-11 21:02:50 +00:00
db8b83c2b0
Docs: Standardise versionchanged text in weakref.rst ( #122898 )
2024-08-11 21:40:11 +01:00
bc9d92c679
gh-122858: Deprecate `asyncio.iscoroutinefunction` ( #122875 )
...
Deprecate `asyncio.iscoroutinefunction` in favor of `inspect.iscoroutinefunction`.
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2024-08-11 16:35:51 +00:00
363374cf69
GH-120794: Use example paths with multiple parts in pathlib docs ( #122887 )
...
In the documentation of `PosixPath` and `WindowsPath`, and their `Pure*`
equivalents, use example paths with multiple non-anchor parts.
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-10 21:21:17 +00:00
0959142e4d
gh-122868: Add more lower bounds for sphinxcontrib dependencies ( #122891 )
2024-08-10 20:50:43 +00:00
5580f31c56
gh-115808: Add ``is_none`` and ``is_not_none`` to ``operator`` ( #115814 )
...
Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru>
2024-08-10 20:16:34 +01:00
0fd97e46c7
gh-122868: Add lower bounds for sphinxcontrib dependencies ( #122870 )
...
* Docs: Add lower bounds for sphinxcontrib dependencies
* oops
2024-08-10 01:18:46 +03:00
d3239976a8
gh-105376: Restore deprecated logging warn() method ( #122775 )
...
This reverts commit dcc028d9246c54e5d721
2024-08-09 15:13:24 +02:00
aab18f4d92
gh-112301: Update documentation for configure options (``--disable-safety`` and ``--enable-slower-safety``) ( #122758 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-08 20:35:00 +01:00
e006c7371d
gh-105201: Add PyIter_NextItem() ( #122331 )
...
Return -1 and set an exception on error; return 0 if the iterator is
exhausted, and return 1 if the next item was fetched successfully.
Prefer this API to PyIter_Next(), which requires the caller to use
PyErr_Occurred() to differentiate between iterator exhaustion and errors.
Co-authered-by: Irit Katriel <iritkatriel@yahoo.com>
2024-08-08 00:47:15 +02:00
967a4f1d18
Docs: Change `remove` to `removes` for consistency ( #121072 )
2024-08-07 16:30:00 +01:00
c25898d51e
Doc: cmdline.rst: Include -P and -R in usage ( #122590 )
...
* ``-P``: safe path (https://docs.python.org/3/using/cmdline.html#cmdoption-P )
* ``-R``: hash randomization (https://docs.python.org/3/using/cmdline.html#cmdoption-R )
2024-08-07 16:01:44 +01:00
76bdeebef6
gh-122511: Improve documentation for object identity of mutable/immutable types ( #122512 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-07 13:40:19 +00:00
98dba73010
GH-73991: Rework `pathlib.Path.rmtree()` into `delete()` ( #122368 )
...
Rename `pathlib.Path.rmtree()` to `delete()`, and add support for deleting
non-directories. This simplifies the interface for users, and nicely
complements the upcoming `move()` and `copy()` methods (which will also
accept any type of file.)
2024-08-07 01:34:44 +01:00
1429651a06
gh-121103: Update site module docs for free-threaded installs ( #122737 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-08-06 14:34:34 -04:00
8ce70d6c69
gh-122058: `Lib/inspect`: Update docstrings for `isfunction`, `isgenerator`, `isframe`, `iscode`. ( #122059 )
...
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
2024-08-06 14:47:31 +02:00
1422500d02
gh-121367: [doc] BUILD_TUPLE arg can be 0 ( #122663 )
2024-08-05 10:17:55 +01:00
f5c39b3e9c
gh-122661: Remove GNU make-specific directive from Doc/Makefile ( #122662 )
2024-08-04 17:02:29 +03:00
151934a324
gh-122623: Improve `c-api/bytearray.rst` with error handling info ( #122624 )
2024-08-04 00:55:47 +03:00
95f5c89b54
GH-121970: Fix ``gettext`` for audit events ( #122651 )
2024-08-03 17:41:26 +01:00
06eb9701a1
Doc: Grammar fix in ``library/ssl.rst``, 'Verifying certificates' ( #122646 )
2024-08-03 14:24:29 +01:00
d91ac525ef
gh-122613: Document PyLong_GetInfo() (part of Limited API) (GH-#122280)
2024-08-03 13:20:10 +02:00
7a5c4103b0
Doc: Improve wording of ``os.path.commonpath()`` ( #122627 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-03 11:18:59 +00:00
498376d7a7
gh-122445: populate only modified fields in __static_attributes__ ( #122446 )
2024-08-02 15:40:42 +01:00
fb864c76cd
gh-121723: Relax constraints on queue objects for `logging.handlers.QueueHandler`. (GH-122154)
2024-08-02 12:16:32 +01:00
addbb73927
Update PyObject_Del() documentation ( #122597 )
...
Replace PyMem_Del() with PyMem_Free().
2024-08-02 12:13:33 +02:00
fda6bd842a
Replace PyObject_Del with PyObject_Free ( #122453 )
...
PyObject_Del() is just a alias to PyObject_Free() kept for backward
compatibility. Use directly PyObject_Free() instead.
2024-08-01 14:12:33 +02:00
88030861e2
gh-122555: Remove removed functions from `Doc/data/refcounts.dat` ( #122556 )
2024-08-01 12:26:09 +02:00
58ffc4cf4a
gh-122384: Mark strings from Download page for translation ( #122385 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-08-01 12:25:16 +03:00
46f5a4f9e1
Fix typos in docs, error messages and comments ( #122502 )
...
Signed-off-by: jianghuyiyuan <shuangcui@live.com>
2024-08-01 00:26:09 +00:00
d01fd24051
Docs: bump Sphinx to 8.0 and update constraints ( #122496 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-07-31 07:02:08 +00:00
a9344cdffa
gh-121381 Remove subprocess._USE_VFORK escape hatch ( #121383 )
...
This flag was added as an escape hatch in gh-91401 and backported to
Python 3.10. The flag broke at some point between its addition and now.
As there is currently no publicly known environments that require this,
remove it rather than work on fixing it.
This leaves the flag in the subprocess module to not break code which
may have used / checked the flag itself.
discussion: https://discuss.python.org/t/subprocess-use-vfork-escape-hatch-broken-fix-or-remove/56915/2
2024-07-30 18:39:54 -07:00
0976339818
gh-121650: Encode newlines in headers, and verify headers are sound (GH-122233)
...
## Encode header parts that contain newlines
Per RFC 2047:
> [...] these encoding schemes allow the
> encoding of arbitrary octet values, mail readers that implement this
> decoding should also ensure that display of the decoded data on the
> recipient's terminal will not cause unwanted side-effects
It seems that the "quoted-word" scheme is a valid way to include
a newline character in a header value, just like we already allow
undecodable bytes or control characters.
They do need to be properly quoted when serialized to text, though.
## Verify that email headers are well-formed
This should fail for custom fold() implementations that aren't careful
about newlines.
Co-authored-by: Bas Bloemsaat <bas@bloemsaat.org>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2024-07-31 00:19:48 +02:00
c68cb8e0c9
Remove outdated note about instance methods from datamodel.rst ( #122471 )
2024-07-30 12:42:25 -07:00
3833d27f98
gh-105733: Soft-deprecate ctypes.ARRAY, rather than hard-deprecating it. (GH-122281)
...
Soft-deprecate ctypes.ARRAY, rather than hard-deprecating it.
Partially reverts 2211454fe2
2024-07-30 09:37:58 +02:00
11ad731f4f
GH-121970: Extract ``audit_events`` into a new extension ( #122325 )
2024-07-30 03:49:00 +00:00
76bdfa4cd0
GH-122085: Use include files for C API deprecations ( #109843 )
2024-07-29 22:20:40 +01:00
aa449cf063
gh-122085: Create dedicated page for deprecations ( #122352 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-07-28 10:53:21 +03:00
cbac8a3888
GH-121462: pathlib docs: improve table of corresponding os/os.path functions ( #121465 )
...
Re-order table of corresponding functions with the following priorities:
1. Pure functionality is at the top
2. `os.path` functions are shown before `os` functions
3. Similar functionality is kept together
4. Functionality follows docs order where possible
Add a few missed correspondences:
- `os.path.isjunction` and `Path.is_junction`
- `os.path.ismount` and `Path.is_mount`
- `os.lstat()` and `Path.lstat()`
- `os.lchmod()` and `Path.lchmod()`
Also add footnotes describing a few differences.
2024-07-27 18:03:18 +01:00
4e75509349
gh-122085: Use include files for `whatsnew/3.14.rst` deprecations ( #122242 )
2024-07-27 14:17:54 +03:00
762e771cc0
Fix underline for 'pty' in What's New in Python 3.14 ( #122337 )
2024-07-27 01:00:56 +00:00
d52726ccd4
Document ``mimetypes.MimeTypes.add_type()`` ( #122301 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-07-26 22:03:08 +00:00
33586d64ca
Remove reference to docs mailing list for bug reports ( #122323 )
2024-07-26 13:56:39 -07:00
db2d8b6db1
gh-122300: Preserve AST nodes for format specifiers with single elements ( #122308 )
2024-07-26 16:29:41 +00:00
dcafb362f7
gh-121999: Change default tarfile filter to 'data' (GH-122002)
...
Co-authored-by: Tomas R <tomas.roun8@gmail.com>
Co-authored-by: Scott Odle <scott@sjodle.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
2024-07-26 16:34:13 +02:00
bc94cf7e25
gh-122245: move checks for writes and shadowing of __debug__ to symtable ( #122246 )
2024-07-26 14:39:56 +01:00
2c42e13e80
GH-116090: Fix test and clarify behavior for exception events when exhausting a generator. (GH-120697)
2024-07-26 14:37:35 +01:00
2e14a52cce
GH-122160: Remove BUILD_CONST_KEY_MAP opcode. (GH-122164)
2024-07-25 16:24:29 +01:00
b3b7b7d46a
gh-122085: Use include files for `whatsnew/3.12.rst` deprecations ( #122093 )
2024-07-24 02:29:35 -06:00
7b7b90d1ce
gh-119180: Add `annotationlib` module to support PEP 649 ( #119891 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-07-23 21:16:50 +00:00
e6b25e9a09
gh-122163: Add notes for JSON serialization errors (GH-122165)
...
This allows to identify the source of the error.
2024-07-23 20:02:54 +03:00
498cb6dff1
Docs: Use cross-reference to `os.uname` in `sysconfig.get_platform` ( #122083 )
2024-07-23 14:08:39 +01:00
53e9e7de63
GH-121970: Remove ``escape4chm`` ( #122065 )
2024-07-23 13:30:06 +01:00
a9bb3c7b3b
gh-121996: Introduce --disable-safety and --enable-slower-safety options ( #122054 )
...
* gh-121996: Introduce --disable-safty and --enable-slower-safty
* Update GA
* fix
* Address code review
* Update CI
2024-07-23 09:22:04 +09:00
2762c6cc5e
gh-121637: Syntax error for optimized-away incorrect await ( #121656 )
...
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2024-07-22 14:12:43 -07:00
c09d4c4a26
gh-119698: deprecate ``symtable.Class.get_methods`` ( #121902 )
2024-07-22 07:04:17 -07:00
dc93d1125f
gh-121957: Emit audit events for `python -i` and `python -m asyncio` (GH-121958)
...
Relatedly, emit the `cpython.run_startup` event from the Python version of
`PYTHONSTARTUP` handling.
2024-07-22 13:04:08 +02:00
bc264eac3a
Docs: spelling and grammar fixes ( #122084 )
...
Corrected some grammar and spelling issues in documentation.
Co-authored-by: Russell Keith-Magee <russell@keith-magee.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2024-07-22 09:14:25 +08:00
728432c804
gh-120522: Apply App Store compliance patch during installation ( #121947 )
...
Adds a --with-app-store-compliance configuration option that patches out code known to be an issue with App Store review processes. This option is applied automatically on iOS, and optionally on macOS.
2024-07-22 07:36:08 +08:00
0dcbc83853
Delete stale note about mp.Lock.acquire/SIGINT ( #120929 )
2024-07-21 06:17:57 +00:00
ebc18abbf3
gh-121977: Add tips for handling unhashable data ( #122075 )
2024-07-21 05:53:26 +00:00
c4c7097e64
GH-73991: Support preserving metadata in `pathlib.Path.copytree()` ( #121438 )
...
Add *preserve_metadata* keyword-only argument to `pathlib.Path.copytree()`,
defaulting to false. When set to true, we copy timestamps, permissions,
extended attributes and flags where available, like `shutil.copystat()`.
2024-07-20 23:32:52 +01:00
094375b9b7
GH-73991: Add `pathlib.Path.rmtree()` ( #119060 )
...
Add a `Path.rmtree()` method that removes an entire directory tree, like
`shutil.rmtree()`. The signature of the optional *on_error* argument
matches the `Path.walk()` argument of the same name, but differs from the
*onexc* and *onerror* arguments to `shutil.rmtree()`. Consistency within
pathlib is probably more important.
In the private pathlib ABCs, we add an implementation based on `walk()`.
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2024-07-20 20:14:13 +00:00
8db5f48007
Docs: Fix duplicate object description warnings ( #122068 )
2024-07-20 19:46:41 +00:00
b7ad711fcb
GH-121970: Modernise the patchlevel extension ( #121995 )
2024-07-20 13:44:43 +00:00
3de092b82f
Docs: Fix a typo in What's New in Python 3.13 ( #122051 )
2024-07-20 04:46:57 +01:00
d66b06107b
gh-118830: Bump pickle.DEFAULT_PROTOCOL to 5 (GH-119340)
2024-07-19 16:47:10 +02:00
a1df1b4439
Docs: move deprecations into include files ( #121241 )
2024-07-19 07:57:14 -06:00
709db44255
gh-121160: Note that readline libraries using different history formats. (GH-121327)
...
This is not something we can do too much about, without help from the
underlying libraries.
2024-07-19 15:52:00 +02:00
22c9d9c1fc
GH-121970: Rewrite the C-API annotations extension ( #121985 )
...
Co-authored-by: Petr Viktorin <encukou@gmail.com>
2024-07-19 12:21:56 +00:00
40855f3ab8
GH-121970: Use Ruff to check and format the docs tools ( #122018 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@gmail.com>
2024-07-19 11:48:53 +00:00
898e90c3be
GH-121970: Make ``DeprecatedRemoved`` a subclass of ``VersionChange`` ( #121971 )
2024-07-19 11:39:51 +01:00
adf0b94d1c
GH-121970: Improve the glossary preview in HTML search ( #121991 )
2024-07-19 10:16:59 +01:00
1a0c7b9ba4
gh-121905: Consistently use "floating-point" instead of "floating point" (GH-121907)
2024-07-19 08:06:02 +00:00
420d943128
Docs: Upgrade Sphinx to 7.4 ( #121987 )
2024-07-19 08:58:19 +01:00
ac39151a09
GH-121970: Use ``SphinxDirective`` instead of ``Directive`` ( #121972 )
2024-07-19 08:33:51 +01:00
98e5bdef0e
Docs: Fix typo in description of ``INTRINSIC_ASYNC_GEN_WRAP`` ( #122004 )
2024-07-19 08:30:01 +01:00
c8d2630995
gh-82017: Support as_integer_ratio() in the Fraction constructor (GH-120271)
...
Any objects that have the as_integer_ratio() method (e.g. numpy.float128)
can now be converted to a fraction.
2024-07-19 08:06:53 +03:00
7dd52b63ce
GH-117928: Bump the minimum Sphinx version to 6.2.1 ( #121986 )
2024-07-18 21:05:38 +00:00
7431c3799e
GH-121970: Combine custom Pygments lexers into a package ( #121976 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-07-18 18:38:29 +00:00
94e6644584
gh-65453: Docs - clarify AttributeError behaviour on PropertyMock (GH-121666)
...
Fixed at EuroPython 24 sprints.
2024-07-18 15:57:21 +02:00
24cf867bed
gh-121874: Define audit-event open parameters consistently (GH-121883)
...
Use same names for parameters to avoid triggering a race-condition in Sphinx
that causes non-deterministic output.
2024-07-18 13:05:39 +03:00
5d98a4d266
Remove duplicate "it" in whatsnew 3.13 ( #121580 )
2024-07-17 00:31:21 -07:00
72dccd6073
gh-121834: Improve `complex` C-API docs ( #121835 )
...
Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
2024-07-17 10:01:28 +03:00
37611171af
gh-121453: Update the `Doc/templates/download.html` download files size estimates and support download `.texi` format. ( #121454 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-07-17 00:20:55 -06:00
941b3b7f44
gh-121871: Allow overriding docs build date with SOURCE_DATE_EPOCH ( #121872 )
2024-07-16 23:34:00 -06:00
4e35dd607b
gh-83648: Use versionadded in 'deprecated' description (GH-121877)
2024-07-16 21:26:17 +00:00
c46d64e0ef
gh-121130: Fix f-string format specifiers with debug expressions ( #121150 )
2024-07-16 19:57:22 +01:00
8f2532168b
gh-59022: Added tests for `pkgutil.extend_path` ( #59022 ) (GH-121673)
...
This adds tests for the documented behaviour of `pkgutil.extend_path`
regarding different argument types as well as for `*.pkg` files.
2024-07-16 17:14:26 +02:00
b4aedb23ae
gh-113993: Don't immortalize in PyUnicode_InternInPlace; keep immortalizing in other API ( #121364 )
...
* Switch PyUnicode_InternInPlace to _PyUnicode_InternMortal, clarify docs
* Document immortality in some functions that take `const char *`
This is PyUnicode_InternFromString;
PyDict_SetItemString, PyObject_SetAttrString;
PyObject_DelAttrString; PyUnicode_InternFromString;
and the PyModule_Add convenience functions.
Always point out a non-immortalizing alternative.
* Don't immortalize user-provided attr names in _ctypes
2024-07-16 15:36:21 +02:00
d7a099d7ae
GH-105879: Note exec/eval keyword change in What's New (GH-121831)
2024-07-16 13:24:45 +00:00
Eddie Elizondo
Adam Turner
Rafael Fontenelle
Damien
Trey Hunner
Barney Gale
sobolevn
Wulian
Nico Mexis
Victor Stinner
Nate Ohlson
Erlend E. Aasland
smij720
Wim Jeantine-Glenn
Bénédikt Tran
Sam Gross
Kirill Podoprigora
Irit Katriel
Libor Martínek
scottwoodall
Sergey B Kirpichev
Matth-M
jianghuyiyuan
Hugo van Kemenade
Cody Maloney
Petr Viktorin
Thomas Grainger
Subrahmanya Gaonkar
Carol Willing
Pablo Galindo Salgado
WilliamRoyNelson
Mark Shannon
Jelle Zijlstra
Serhiy Storchaka
Ville Skyttä
Donghee Na
Łukasz Langa
Russell Keith-Magee
Andrey Mishchenko
Raymond Hettinger
Rodrigo Oliveira
Vlastimil Zíma
Bernhard M. Wiedemann
Zachary Ware
Andreas Stocker
Alyssa Coghlan