e8165d47b8
gh-97607: Fix content parsing in the impl-detail reST directive ( #97652 )
...
* Don't parse content as arg in the impl-detail directive
This does not change the (untranslated) output,
but ensures that the doctree node metadata is correct.
which fixes gh-97607 with the text not being translated.
It also simplifies the code and logic
and makes it consistant with the docutils built-in directives.
* Remove unused branch from impl-detail directive handling no-content case
This is not used anywhere in the docs and lacks a clear use case,
and is more likely a mistake which is now flagged at build time.
This simplifies the logic from two code paths to one,
and makes the behavior consistant with similar built-in directives
(e.g. the various admonition types).
* Further simplify impl-detail reST directive code
2022-10-02 07:20:17 +02:00
dcc82331c8
gh-95975: Move except/*/finally ref labels to more precise locations ( #95976 )
...
* gh-95975: Move except/*/finally ref labels to more precise locations
* Add section headers to fix :keyword: role and aid navigation
* Move see also to the introduction rather than a particular subsection
* Fix other minor Sphinx syntax issues with except
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
* Suppress redundant link to same section for except too
* Don't link try/except/else/finally keywords if in the same section
* Format try/except/finally as keywords in modified sections
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2022-10-02 07:12:56 +02:00
8baef8ae36
gh-95588: Drop the safety claim from `ast.literal_eval` docs. ( #95919 )
...
It was never really safe and this claim conflicts directly with the big warning in the docs about it being able to crash the interpreter.
2022-10-01 17:55:40 -07:00
bd7d0e875e
Fix capitalization of Unix in documentation ( #96913 )
2022-10-01 16:41:06 -07:00
f00645d5db
gh-90908: Document asyncio.Task.cancelling() and asyncio.Task.uncancel() ( #95253 )
...
Co-authored-by: Thomas Grainger <tagrain@gmail.com>
2022-10-01 10:42:36 -07:00
b05dd79649
gh-87597: Document TimeoutExpired.stdout & .stderr types ( #97685 )
...
This documents the behavior that has always been the case since timeout
support was introduced in Python 3.3.
2022-09-30 10:45:47 -07:00
86a3be207d
Use SyntaxError invalid range in tutorial introduction example (GH-93031)
...
Use output from a 3.10+ REPL, showing invalid range, for the
SyntaxError examples in the tutorial introduction page.
Automerge-Triggered-By: GH:iritkatriel
2022-09-30 01:59:46 -07:00
83a3de4e06
gh-96348: Deprecate the 3-arg signature of coroutine.throw and generator.throw (GH-96428)
2022-09-30 09:43:02 +01:00
9a11ed8e50
gh-96397: Document that attributes need not be identifiers ( #96454 )
...
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-09-29 16:02:27 -07:00
0179a82caa
closes gh-97650: correct sphinx executable (gh-97651)
2022-09-29 15:53:41 -07:00
c759944f16
gh-52597: Add position-only markers for os functions ( #94735 )
2022-09-28 18:06:50 -07:00
575a253b5c
GH-82448: Add thread timeout for loop.shutdown_default_executor ( #97561 )
...
Co-authored-by: Kyle Stanley <aeros167@gmail.com>
2022-09-28 10:39:42 -07:00
9a404b173e
fixup policy docs ( #97618 )
2022-09-28 10:34:49 -07:00
5c110d1126
gh-65046: Add note about logging from async code. (GH-97602)
2022-09-28 05:17:42 +01:00
d582edf0be
Fix docs on conditional expression grouping (GH-96447)
2022-09-27 21:57:32 -05:00
cc0f3a10f0
gh-96377: Update asyncio policy doc intro paras to be clear and accurate ( #97603 )
...
Also fix up some cross-references in the asyncio docs.
2022-09-27 16:47:14 -07:00
aab01e3524
gh-96670: Raise SyntaxError when parsing NULL bytes ( #97594 )
2022-09-27 23:23:42 +01:00
dd53b79de0
gh-96959: Update more HTTP links (GH-97536)
...
Use HTTPS for documents which are available by both HTTP and HTTPS
links, but there is no redirection from HTTP to HTTPS or vice versa.
2022-09-27 14:08:11 +03:00
d68c37c0d0
GH-65046: Fix docs about logging in `asyncio` ( #97559 )
...
Explain that logging should not use network I/O.
2022-09-26 15:27:15 -07:00
2b428a1fae
gh-82530: Create blank function instead of invalid import for email example ( #97529 )
...
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2022-09-26 00:06:11 -04:00
db39050396
gh-96959: Update HTTP links which are redirected to HTTPS (GH-96961)
2022-09-24 14:38:53 +03:00
a4ac14faa5
gh-77171: Fixes SubFormat check to compare the entire value. Add docs (GH-97509)
2022-09-23 16:08:21 +01:00
80bc7d7c0a
gh-75608: Add Windows FAQ entry for missing UCRT (GH-92765)
2022-09-23 11:44:01 +01:00
9d432b4a18
gh-96397: Document that keywords in calls need not be identifiers ( #96393 )
...
This represents the official SC stance, see
https://github.com/python/steering-council/issues/142#issuecomment-1252172695
2022-09-22 11:10:15 -07:00
ec403536f1
include OrderedDict import in TimeBoundedLRU example (GH-96962)
2022-09-22 10:58:19 -05:00
b4f5f07d07
Doc: fix link redirect (GH-96606)
...
"Hyperbolic_function" -> "Hyperbolic_functions"
2022-09-21 21:47:46 +02:00
4b81139aac
gh-81039: Add small example of f-string's "=}" to tutorial (gh-92291)
2022-09-21 08:57:03 -04:00
e5ab0b6aa6
gh-71141: Add note on rejecting "leading-dot" syntax for with statements ( #96928 )
...
Co-authored-by: Daniël van Noord <13665637+DanielNoord@users.noreply.github.com>
2022-09-20 21:16:39 -07:00
6ad47b41a6
gh-96727: Document restrictions on Handler.emit() with respect to locking. (GH-96948)
2022-09-20 09:40:06 +01:00
34de67c094
gh-96512: Update int_max_str docs to say 3.11 ( #96942 )
...
It was unknown if it'd be before 3.11.0 when creating the original
changes. It's in 3.11rc2, so 3.11 it is.
2022-09-19 16:43:11 -07:00
5b3a2569f4
gh-96917: link to typing.readthedocs.io from typing.rst ( #96921 )
...
See the discussion at https://github.com/python/cpython/issues/91533
2022-09-19 12:09:41 -07:00
558768ff22
gh-95913: Copyedit, link & format Typing Features section in 3.11 What's New (GH-96097)
...
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2022-09-19 15:44:01 +02:00
8ee27e3318
gh-95913: Fix and copyedit New Features section of 3.11 What's New (GH-95915)
2022-09-19 15:32:51 +02:00
bbc24b2bd5
GH-96851: Add link to FAQ entry for caching method calls. (GH-96902)
2022-09-18 16:36:20 -05:00
2d1a2d902a
fix various typos in random module's documentation (GH-96912)
2022-09-18 14:35:22 -07:00
810ae51787
gh-94787: [doc] Add to argparse doc an example of a mutually-exclusive group nested in an argument group (GH-94807)
2022-09-18 09:05:43 +01:00
670007abb4
Clarify that the expression is regular math notation, not Python. ( #96903 )
2022-09-17 21:09:39 -05:00
78359b1d45
Simplify sieve() recipe. Add edge case tests. (GH-96892)
2022-09-17 11:31:04 -05:00
c00f2b15d8
fixes gh-96841: replace Mercurial with VCS ( #96879 )
2022-09-16 11:26:02 -07:00
e841ffc915
gh-95778: Mention sys.set_int_max_str_digits() in error message ( #96874 )
...
When ValueError is raised if an integer is larger than the limit,
mention sys.set_int_max_str_digits() in the error message.
2022-09-16 20:04:37 +02:00
e47b96c44f
gh-89536: Use ThinLTO policy if possible (gh-96766)
2022-09-16 19:40:05 +09:00
16c33a9676
gh-96810: Clarify for which statements sqlite3 implicitly opens transactions ( #96832 )
2022-09-15 23:11:52 +02:00
a41ed975e8
GH-91049: Introduce set vectorcall field API for PyFunctionObject (GH-92257)
...
Co-authored-by: Andrew Frost <adfrost@fb.com>
Co-authored-by: Itamar Ostricher <itamarost@gmail.com>
2022-09-15 16:42:37 +01:00
9f1814723f
Revert accidental removal from 3.12 doc. (gh-96826)
2022-09-14 07:59:23 -07:00
8dc9b3fbc1
Itertools sieve() recipe ( #96813 )
2022-09-13 21:10:47 -05:00
fd1e477f53
closes gh-96734: Update to Unicode 15.0.0. (GH-96809)
2022-09-13 15:45:12 -07:00
4995f5f9a0
Add dataclass field default change to 3.11 what's new ( #96790 )
...
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2022-09-13 08:56:08 -07:00
bf5fd49252
gh-95778: Fix `sys.set_int_max_str_digits()` parameter name ( #96798 )
...
Discovered in https://github.com/python/typeshed/pull/8733
2022-09-13 08:22:50 -07:00
830a20eb32
gh-93503: Document the new tracing/profiling APIs in the What's new document ( #96681 )
...
Co-authored-by: Victor Stinner <vstinner@python.org>
2022-09-13 13:12:15 +01:00
49cceeb5c9
gh-96702: Order methods before attrs in sqlite3.Connection docs ( #96703 )
2022-09-13 10:28:57 +02:00
53a54b781d
gh-96706: [doc] Don't recomment deprecated use of get_event_loop() in examples ( #96707 )
2022-09-11 12:56:30 -07:00
8d75a13fde
gh-90751: memoryview now supports half-float ( #96738 )
...
Co-authored-by: Antoine Pitrou <antoine@python.org>
2022-09-10 22:44:10 +02:00
c4e57fb6df
Fix typo in 3.12 whatsnew (GH-96740)
2022-09-10 19:14:01 +01:00
6281affee6
gh-94972: document that shield users need to keep a reference to their task ( #96724 )
...
Co-authored-by: Thomas Grainger <tagrain@gmail.com>
Co-authored-by: Guido van Rossum <gvanrossum@gmail.com>
2022-09-10 07:34:14 -07:00
c06c001b30
gh-92734: Add indentation feature to reprlib.Repr (GH-92735)
2022-09-08 13:51:44 -05:00
d5e07862ec
gh-88287: Add BufferingFormatter documentation. (GH-96608)
2022-09-08 08:22:33 +01:00
c4999f261f
[doc] Update example in traceback doc (GH-96600)
...
This Monty Python reference is of-its-time. It could seem inappropriate in the context of today's sensibilities around mental health.
Automerge-Triggered-By: GH:iritkatriel
2022-09-05 14:30:51 -07:00
80a9bd2e94
gh-96559: Fixes Windows launcher handling of defaults using old-style tags, and adds What's New section (GH-96595)
2022-09-05 20:06:30 +01:00
a9d58feccf
gh-84095: Fill documentation gap regarding user-defined objects. (GH-96574)
2022-09-05 07:47:47 +01:00
a0ad63e70e
gh-93973: Add all_errors to asyncio.create_connection ( #93974 )
...
Co-authored-by: Oleg Iarygin <dralife@yandex.ru>
2022-09-04 18:33:50 -07:00
9e55685782
Docs: alphabetically order sqlite3.Cursor attrs ( #96565 )
2022-09-04 23:34:45 +02:00
8464b754c4
gh-68163: Correct conversion of Rational instances to float (GH-25619)
...
* gh-68163: Correct conversion of Rational instances to float
Also document that numerator/denominator properties are instances of Integral.
Co-authored-by: Mark Dickinson <dickinsm@gmail.com>
2022-09-04 13:15:59 +01:00
69bb83c2bf
gh-95778: remove unneeded doc note on float.as_integer_ratio ( #96553 )
...
Per mdickinson@'s comment on the main branch PR.
2022-09-04 00:04:36 -07:00
af6359dd5c
doc typo: spell limitation ( #96542 )
2022-09-03 23:23:32 -07:00
e5823bf9b5
gh-89087: Update logging.QueueHandler documentation to clarify record… (GH-96527)
2022-09-03 13:02:19 +01:00
57b6110361
[Enum] bump version tag on HTTP status category indicators (GH-96508)
2022-09-02 13:11:18 -07:00
ccce9b77e1
bpo-30419: DOC: Update missing information in bdb docs ( #1687 )
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Martin Panter <vadmium@users.noreply.github.com>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2022-09-02 13:22:42 -04:00
2a9e4e4d73
gh-95180: Add `TaskGroup` and `Runner` to AsyncIO API Index ( #95189 )
...
Also rearrange some items in the list.
Co-authored-by: Thomas Grainger <tagrain@gmail.com>
2022-09-02 09:36:45 -07:00
511ca94520
gh-95778: CVE-2020-10735: Prevent DoS by very large int() ( #96499 )
...
Integer to and from text conversions via CPython's bignum `int` type is not safe against denial of service attacks due to malicious input. Very large input strings with hundred thousands of digits can consume several CPU seconds.
This PR comes fresh from a pile of work done in our private PSRT security response team repo.
Signed-off-by: Christian Heimes [Red Hat] <christian@python.org>
Tons-of-polishing-up-by: Gregory P. Smith [Google] <greg@krypto.org>
Reviews via the private PSRT repo via many others (see the NEWS entry in the PR).
<!-- gh-issue-number: gh-95778 -->
* Issue: gh-95778
<!-- /gh-issue-number -->
I wrote up [a one pager for the release managers](https://docs.google.com/document/d/1KjuF_aXlzPUxTK4BMgezGJ2Pn7uevfX7g0_mvgHlL7Y/edit# ). Much of that text wound up in the Issue. Backports PRs already exist. See the issue for links.
2022-09-02 09:35:08 -07:00
656167db81
Allow whitespace around a slash in fraction string inputs (GH-96496)
2022-09-02 11:10:58 -05:00
91f40f3f78
gh-96168: Improve sqlite3 dict_factory example ( #96457 )
...
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2022-09-01 23:47:59 +02:00
4c72517cad
gh-93554: Conditional jump opcodes only jump forward (GH-96318)
2022-09-01 21:36:47 +01:00
615537e62f
gh-96408: Document difference between set-like view and sets. (GH-96439)
2022-08-31 16:23:52 -05:00
29f1b0bb1f
gh-89258: Add a getChildren() method to logging.Logger. (GH-96444)
...
Co-authored-by: Éric <merwok@netwok.org>
2022-08-31 10:50:29 +01:00
f7e7bf161a
gh-96414: Inline code examples in sqlite3 docs ( #96442 )
2022-08-31 07:54:54 +02:00
7b01ce7953
Docs: normalise sqlite3 placeholder how-to heading ( #96413 )
2022-08-30 22:44:14 +02:00
f49dd54b72
gh-96143: Add some comments and minor fixes missed in the original PR ( #96433 )
...
* gh-96132: Add some comments and minor fixes missed in the original PR
* Update Doc/using/cmdline.rst
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
2022-08-30 19:37:22 +01:00
0ed778835d
gh-95149: Enhance `http.HTTPStatus` with properties that indicate the HTTP status category (GH-95453)
2022-08-30 11:11:44 -07:00
6d791a9736
gh-96143: Allow Linux perf profiler to see Python calls (GH-96123)
...
⚠️ ⚠️ Note for reviewers, hackers and fellow systems/low-level/compiler engineers ⚠️ ⚠️
If you have a lot of experience with this kind of shenanigans and want to improve the **first** version, **please make a PR against my branch** or **reach out by email** or **suggest code changes directly on GitHub**.
If you have any **refinements or optimizations** please, wait until the first version is merged before starting hacking or proposing those so we can keep this PR productive.
2022-08-30 10:11:18 -07:00
0f733fffe8
GH-95245: Document use of `MANAGED` flags instead of offsets. (GH-96044)
2022-08-30 16:26:08 +01:00
07f12b5c15
gh-95337: update TypeVarTuple example ( #95338 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2022-08-30 07:57:03 -07:00
b17aae8bbd
gh-95413: Remove references to deprecated CGI library ( #95414 )
2022-08-30 13:14:08 +02:00
860fa35145
Docs: Improve clarity for bytes.hex() ( #95257 )
2022-08-30 13:09:56 +02:00
9625de6fab
Doc: Update Py_TPFLAGS_HAVE_FINALIZE in docs (GH-96273)
...
It is now deprecated and the docs should reflect that.
2022-08-30 17:31:14 +09:00
6d403e264a
Docs: normalize SQL style in sqlite3 docs ( #96403 )
2022-08-30 00:50:42 +02:00
6324b135ac
gh-91305: Add a note about DatagramHandler and DNS latency. (GH-96380)
2022-08-29 22:29:22 +01:00
b2714f05c5
gh-90814: Correct NEWS wording re. optional C11 features (GH-96309)
...
The previous wording of this entry suggests that CPython
won't work if optional compiler features are enabled.
That's not the case. The change is that we require C11 rather
than C89.
Note that PEP 7 does say "Python 3.11 and newer versions use C11
without optional features." It is correct there: that's
not a guide for users who compile Python, but for CPython devs
who must avoid the features.
2022-08-29 13:10:52 +02:00
bf9259776d
gh-95432: Add doctests for the sqlite3 docs ( #96225 )
...
As a consequence of the added test, this commit also includes
fixes for broken examples.
- Add separate namespace for trace tests bco. module level callback
- Move more backup and cursor examples under separate namespaces
2022-08-29 10:52:39 +02:00
3d3a86ed40
GH-96359: Fix docs that claim int(0|1) doesn't match False (GH-96361)
2022-08-28 15:48:51 -07:00
023c51d9d8
gh-69142: add %:z strftime format code (gh-95983)
...
datetime.isoformat generates the tzoffset with colons, but there
was no format code to make strftime output the same format.
for simplicity and consistency the %:z formatting behaves mostly
as %z, with the exception of adding colons. this includes the
dynamic behaviour of adding seconds and microseconds only when
needed (when not 0).
this fixes the still open "generate" part of this issue:
https://github.com/python/cpython/issues/69142
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
2022-08-28 14:27:42 -07:00
35e4da25d4
Docs: Fix count of bullets in asyncio-task.rst ( #96307 )
2022-08-26 20:50:48 -07:00
43a6deadbb
gh-77116: Add SMTP buffering example to logging cookbook. (GH-96324)
2022-08-27 00:24:36 +01:00
b462f143ff
Fix documentation typo for pathlib.Path.walk (GH-96301)
2022-08-26 14:21:40 -07:00
c3d591fd06
gh-95994: Clarify escaped newlines. ( #96066 )
...
* gh-95994: clarify escaped newlines.
* Rephrase ambiguous sentence.
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
* Use `<newline>` in escape sequences table.
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-08-26 21:05:01 +02:00
0319cd6825
gh-96197: Define the behavior of repr if sys.displayhook is lost (gh-96242)
2022-08-26 11:02:57 +09:00
47d406ffc4
gh-96197: Fix expression when :func:`sys.breakpointhook is missing (gh-96293)
2022-08-26 10:43:02 +09:00
caa2a9799a
Clarify API stability of PyTypeObject in relation to static types. (GH-96217)
...
Fixes:
https://github.com/python/cpython/issues/95300
Related:
https://github.com/python/cpython/issues/91271
2022-08-25 15:32:12 +02:00
cd492d43a2
gh-76728: Coerce DictReader and DictWriter fieldnames argument to a list (GH-32225)
2022-08-25 05:13:24 -05:00
8db7693bbf
gh-91070: Add note about SysLogHandler on macOS 12.x (Monterey). (GH-94803)
2022-08-25 08:27:30 +01:00
e34c82abeb
GH-93503: Add thread-specific APIs to set profiling and tracing functions in the C-API ( #93504 )
...
* gh-93503: Add APIs to set profiling and tracing functions in all threads in the C-API
* Use a separate API
* Fix NEWS entry
* Add locks around the loop
* Document ignoring exceptions
* Use the new APIs in the sys module
* Update docs
2022-08-24 23:21:39 +01:00
4317b25a23
GH-96179: Fix misleading example on the bisect documentation (GH-96228)
...
The `movies[bisect(movies, 1960, key=by_year)]` will actually return only movies **after** 1960.
2022-08-24 17:47:13 +02:00
09563a764e
gh-96197: Define the behavior of breakpoint if sys.breakpointhook is lost (gh-96231)
2022-08-24 23:03:36 +09:00
6bda5b85b5
gh-94635: Frame sqlite3 how-to headings as such & move default adapters to reference ( #96136 )
...
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2022-08-24 09:14:14 +02:00
1f0eafa844
GH-96145: Add AttrDict to JSON module for use with object_hook ( #96146 )
2022-08-23 16:22:00 -05:00
d6259c58cb
gh-96096: Add undocumented SQLITE_OK/DENY/IGNORE sqlite3 constants ( #96134 )
...
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2022-08-23 08:51:20 +02:00
04c73e5efb
gh-95432: Add doctest for sqlite3 tutorial ( #96193 )
2022-08-23 08:48:13 +02:00
18b1782192
gh-96121: Merge sqlite3.Row examples into sqlite3.Row class doc ( #96122 )
...
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-08-22 10:03:24 +02:00
d8c7a1174c
small grammatical change (GH-96138)
...
changed a to an under An example that uses most of the list methods
2022-08-21 09:56:52 -05:00
511dea0a3e
GH-95880: Clarify StringIO append/overwrite behavior. (GH-96104)
2022-08-21 09:42:15 -05:00
0e28a3a50f
Add polynomial_from_roots() to the itertools recipes ( #96102 )
2022-08-21 09:41:29 -05:00
bcc4cb0c7d
gh-96098: Clearly link concurrent.futures from threading & multiprocessing docs (GH-96112)
...
Clearly link concurrent.futures from threading & multiprocessing docs
Also link directly to asyncio from the beginning of the threading docs.
2022-08-21 14:09:05 +12:00
6ec57e7c5a
gh-90536: Fix link syntax to LLVM-BOLT repository (gh-96141)
2022-08-21 00:11:35 +09:00
5bfb3c372b
GH-90997: Wrap yield from/await in a virtual try/except StopIteration (GH-96010)
2022-08-19 12:33:44 -07:00
ee9f22d346
Docs: Fix markup of module name in sqlite3 docs ( #96115 )
2022-08-19 10:18:08 +02:00
303ef0913e
Doc: Use consistent markup for example Point class in sqlite3 ( #96095 )
2022-08-19 09:41:16 +02:00
1a140af40b
Docs: group sqlite3.Connection attributes and methods ( #96090 )
2022-08-19 09:30:41 +02:00
ede771cdf9
gh-94635: Remove sqlite3 doc introduction heading ( #96089 )
2022-08-19 09:21:11 +02:00
757c383d24
gh-96039: Corrected wording error in itertools doc (GH-96105)
2022-08-19 01:20:45 -05:00
6740680b57
GH-95822: Need _PyType_Lookup() in descriptor howto code equivalent. (GH-95967)
2022-08-18 23:56:58 -05:00
b6d88b7225
gh-95914: Add Py_UNICODE encode APIs removed in PEP 624 to 3.11 What's New ( #96016 )
...
* 3.11 Whatsnew: Add Py_UNICODE encode functions removed in PEP 624
* Just use :func: instead of :c:func: for non-resolved funcs so ! works
2022-08-19 00:52:59 +01:00
ba4bb7e464
GH-93179: Document the thread safety of functools.lru_cache (GH-95970)
2022-08-18 17:38:49 -05:00
214eb2cce5
gh-90536: Add support for the BOLT post-link binary optimizer (gh-95908)
...
* Add support for the BOLT post-link binary optimizer
Using [bolt](https://github.com/llvm/llvm-project/tree/main/bolt )
provides a fairly large speedup without any code or functionality
changes. It provides roughly a 1% speedup on pyperformance, and a
4% improvement on the Pyston web macrobenchmarks.
It is gated behind an `--enable-bolt` configure arg because not all
toolchains and environments are supported. It has been tested on a
Linux x86_64 toolchain, using llvm-bolt built from the LLVM 14.0.6
sources (their binary distribution of this version did not include bolt).
Compared to [a previous attempt](https://github.com/faster-cpython/ideas/issues/224 ),
this commit uses bolt's preferred "instrumentation" approach, as well as adds some non-PIE
flags which enable much better optimizations from bolt.
The effects of this change are a bit more dependent on CPU microarchitecture
than other changes, since it optimizes i-cache behavior which seems
to be a bit more variable between architectures. The 1%/4% numbers
were collected on an Intel Skylake CPU, and on an AMD Zen 3 CPU I
got a slightly larger speedup (2%/4%), and on a c6i.xlarge EC2 instance
I got a slightly lower speedup (1%/3%).
The low speedup on pyperformance is not entirely unexpected, because
BOLT improves i-cache behavior, and the benchmarks in the pyperformance
suite are small and tend to fit in i-cache.
This change uses the existing pgo profiling task (`python -m test --pgo`),
though I was able to measure about a 1% macrobenchmark improvement by
using the macrobenchmarks as the training task. I personally think that
both the PGO and BOLT tasks should be updated to use macrobenchmarks,
but for the sake of splitting up the work this PR uses the existing pgo task.
* Simplify the build flags
* Add a NEWS entry
* Update Makefile.pre.in
Co-authored-by: Dong-hee Na <donghee.na92@gmail.com>
* Update configure.ac
Co-authored-by: Dong-hee Na <donghee.na92@gmail.com>
* Add myself to ACKS
* Add docs
* Other review comments
* fix tab/space issue
* Make it more clear that --enable-bolt is experimental
* Add link to bolt's github page
Co-authored-by: Dong-hee Na <donghee.na92@gmail.com>
2022-08-19 06:33:54 +09:00
29c8f80760
GH-95861: Add support for Spearman's rank correlation coefficient (GH-95863)
2022-08-18 13:48:27 -05:00
91afe66707
Docs: Escape lone stars in sqlite3 docs ( #96081 )
2022-08-18 20:39:36 +02:00
c87ea10fc9
gh-95271: Rework sqlite3 tutorial ( #95749 )
...
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2022-08-18 20:36:20 +02:00
cfaa79aac0
gh-93103: Doc uses PyConfig rather than deprecated vars ( #96070 )
...
The C API documentation now uses the new PyConfig API, rather than
deprecated global configuration variables.
2022-08-18 16:58:38 +02:00
c5bc67b2a1
gh-95913: Add traceback module additions to what's new in 3.11 (GH-95980)
2022-08-18 11:37:41 +01:00
b73e3b6d4a
GH-95589: Dont crash when subclassing extension classes with multiple inheritance (GH-96028)
...
* Treat tp_weakref and tp_dictoffset like other opaque slots for multiple inheritance.
* Document Py_TPFLAGS_MANAGED_DICT and Py_TPFLAGS_MANAGED_WEAKREF in what's new.
2022-08-17 12:50:53 +01:00
0f2b469ce1
gh-95991: Add some infrastructure for testing Limited API in _testcapi (GH-95992)
...
- Limited API needs to be enabled per source file
- Some builds don't support Limited API, so Limited API tests must be skipped on those builds
(currently this is `Py_TRACE_REFS`, but that may change.)
- `Py_LIMITED_API` must be defined before `<Python.h>` is included.
This puts the hoop-jumping in `testcapi/parts.h`, so individual
test files can be relatively simple. (Currently that's only
`vectorcall_limited.c`, imagine more.)
2022-08-17 13:48:43 +02:00
da0aa518bf
gh-96005: FreeBSD has ENOTCAPABLE, too (GH-96034)
2022-08-17 07:24:53 +02:00
48174fa0b9
gh-96005: Handle WASI ENOTCAPABLE in getpath (GH-96006)
...
- On WASI `ENOTCAPABLE` is now mapped to `PermissionError`.
- The `errno` modules exposes the new error number.
- `getpath.py` now ignores `PermissionError` when it cannot open landmark
files `pybuilddir.txt` and `pyenv.cfg`.
2022-08-16 20:20:15 +02:00
829aab8592
remove repetitive credit from what's new in 3.11 rst (GH-96024)
2022-08-16 13:47:07 +01:00
ab4d72954f
gh-95957: Add instructions for Tcl/Tk and OpenSSL on RHEL/CentOS 7 ( #95964 )
...
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
2022-08-16 13:44:02 +02:00
e8259e047c
Clarify asyncio.Runner docs re: loop_factory ( #95979 )
2022-08-14 08:53:34 -07:00
0b329f4f03
gh-89313: Add hashlib.file_digest to whatsnew 3.11 (GH-95965)
...
Automerge-Triggered-By: GH:pablogsal
2022-08-13 12:00:58 -07:00
7552f237a2
bpo-25625: Document contextlib.chdir in the 3.11 what's new ( #95962 )
2022-08-13 19:27:44 +01:00
1402d2ceca
gh-95914: Add paragraph about PEP 654 in main body of 'What's New in 3.11' (GH-95937)
2022-08-13 12:49:04 +01:00
f235178bec
gh-94439: typing docs: Add minimum version to `__required_keys__` and `__optional_keys__` ( #95373 )
2022-08-12 21:23:33 -07:00
d2373fcb49
gh-90300: [docs] Add whatsnew entry for new --help output (GH-95856) (GH-95928)
...
Co-authored-by: Éric <merwok@netwok.org>
2022-08-12 18:22:25 +02:00
50bf5fafcc
gh-82180: Document support for non-integer arg removed from grp.getgrgid in 3.10 (GH-95346)
2022-08-12 18:22:06 +02:00
6376433ac3
gh-95914: Add missing PEPs to the Summary section of 3.11 What's New (GH-95916)
2022-08-12 17:50:01 +02:00
e6623e7083
gh-95273: Improve sqlite3.complete_statement docs ( #95840 )
...
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-08-12 01:05:12 +02:00
5ed584cb6b
gh-90385: Add pathlib.Path.walk what's new section (GH-95467)
...
Automerge-Triggered-By: GH:brettcannon
2022-08-11 00:31:46 -07:00
b9e956fccf
Docs: replace 'currying' by 'partial function'. ( #91814 )
2022-08-11 01:23:40 -05:00
9af4aed73a
gh-75510: Edit idlelib entry in doc ( #95869 )
...
Make section instead of subsection and revise sentence.
2022-08-10 22:44:17 -04:00
3646f6cd88
gh-84910: Tweak IDLE Glossary entry ( #95866 )
...
Link "IDLE" to its doc and add 'and Learning' to its expansion,
as in the doc.
2022-08-10 22:04:36 -04:00
71c3d649b5
gh-95504: Fix negative numbers in PyUnicode_FromFormat (GH-95848)
...
Co-authored-by: philg314 <110174000+philg314@users.noreply.github.com>
2022-08-10 13:12:40 +02:00
cf28540fd3
[docs] Mention RESUME opcode in whatsnew/3.11.rst ( #95595 )
2022-08-10 12:50:21 +02:00
70fc9641b5
gh-75500: Add idlelib section to IDLE doc ( #95832 )
...
This enables accessing IDLE as 'idlelib' in the Doc Module listing.
2022-08-09 14:34:42 -04:00
141f2517fc
gh-95767: Fix grammatical error in asyncio loop.create_task docs ( #95768 )
2022-08-09 15:59:27 +02:00
8d37c62c2a
GH-92678: Document that you shouldn't be doing your own dictionary offset calculations. (GH-95598)
...
Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
2022-08-09 14:26:37 +01:00
7c8626ab3d
Improvements to the bisect docs (GH-95807)
2022-08-09 01:31:50 -05:00
41c939cb35
gh-95273: Reorganize sqlite3 doc module level funcs and vars ( #95626 )
...
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-08-08 21:25:35 +02:00
62f06508e7
gh-95781: More strict format string checking in PyUnicode_FromFormatV() (GH-95784)
...
An unrecognized format character in PyUnicode_FromFormat() and
PyUnicode_FromFormatV() now sets a SystemError.
In previous versions it caused all the rest of the format string to be
copied as-is to the result string, and any extra arguments discarded.
2022-08-08 19:21:07 +03:00
656dad702d
gh-93274: Expose receiving vectorcall in the Limited API (GH-95717)
2022-08-08 14:12:05 +02:00
cc9160a29b
gh-91838: Resolve more HTTP links which redirect to HTTPS (GH-95650)
2022-08-08 14:00:17 +03:00
f83b0cabeb
Fix documentation typo for functools.cmp_to_key (GH-95766)
2022-08-08 01:49:48 -05:00
56af5a200d
gh-94635: Fixup sqlite3 'Introduction' seealso note ( #95751 )
...
In gh-95269, the seealso note incorrectly ended up in
the 'Tutorial' section.
2022-08-06 23:30:26 +02:00
d25ff1f613
gh-95155: Update "Using Python on a Mac" documentation (GH-95284)
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2022-08-06 18:50:28 +02:00
56d16e8cb4
gh-93243: Make smtpd private before porting its users (GH-93246)
...
gh-93243
This PR is required to reduce diffs of the following porting (no need to either maintain documentation and tests consistent with each porting step, or try to port everything and remove smtpd in a single PR).
Automerge-Triggered-By: GH:warsaw
2022-08-05 17:41:29 -07:00
29650fea96
gh-86943: implement `pathlib.WindowsPath.is_mount()` (GH-31458)
...
Have `pathlib.WindowsPath.is_mount()` call `ntpath.ismount()`. Previously it raised `NotImplementedError` unconditionally.
https://bugs.python.org/issue42777
2022-08-05 15:37:44 -07:00
834064c19a
gh-89362: Doc IDLE menu and search ( #95697 )
...
Update menu item position and capitalization.
Add paragraph about search.
For help.html, include save-as addition.
2022-08-05 12:21:45 -04:00
bacbc35830
Remove draft notice from 3.11 What's new ( #95713 )
2022-08-05 15:40:41 +01:00
398ed84dc4
gh-93744: Remove configure --with-cxx-main option ( #95651 )
...
Remove the "configure --with-cxx-main" build option: it didn't work
for many years. Remove the MAINCC variable from configure and
Makefile.
The MAINCC variable was added by the issue gh-42471: commit
0f48d98b74
2022-08-05 13:26:58 +02:00
a525f2ada4
GH-95685: Fix rendering of the string documentation ( #95686 )
...
There's an extra underlines that messed the rest of the documentation rendering.
Closes #95685
2022-08-05 09:41:02 +02:00
5f3c9fda18
GH-90997: Document CACHEs (GH-95694)
2022-08-04 22:45:05 -07:00
9890f86ae2
gh-65802: IDLE - explain SaveAs and extensions ( #95690 )
...
File name extensions may or may not be shown for the current name
and are added in an OS-dependent manner if not given for the new
name.
2022-08-04 21:51:14 -04:00
87154d8dd8
gh-94673: Add Per-Interpreter tp_subclasses for Static Builtin Types (gh-95301)
2022-08-04 19:26:59 -06:00
e1182bc377
gh-94619: Remove long deprecated methods module_repr() and load_module() ( #94624 )
...
* gh-94619: Remove long deprecated methods module_repr() and load_module()
Closes #94619
* Update Misc/NEWS.d/next/Library/2022-07-06-14-57-33.gh-issue-94619.PRqKVX.rst
Fix typo
Co-authored-by: Brett Cannon <brett@python.org>
Co-authored-by: Brett Cannon <brett@python.org>
2022-08-04 17:24:26 -07:00
44f1f63ad5
Docs: sqlite3 docs fixup ( #95681 )
...
- Disable links to the module itself
- Fix link indent
- Consistent ref markup
2022-08-05 00:06:46 +02:00
b24e8b28a7
gh-95271: Extract placeholders howto from sqlite3 tutorial ( #95522 )
...
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2022-08-04 22:41:18 +02:00
c47d09a4ac
Remove unnecessary text from documentation. (GH-95670)
2022-08-04 21:18:05 +01:00
12d92c733c
gh-95273: Improve documented return values and exceptions raised for sqlite3 class methods ( #95530 )
...
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2022-08-04 21:58:10 +02:00
962acd4468
Docs: fix two typos in the sqlite3 docs ( #95661 )
...
- statment => statement
- transaciton => transaction
2022-08-04 20:25:53 +02:00
7b370b7305
gh-93274: Make vectorcall safe on mutable classes & inherit it by default ( #95437 )
2022-08-04 17:19:29 +02:00
a613fedd6e
gh-95388: Deprecate creating immutable types with mutable bases (GH-95533)
2022-08-04 16:13:45 +02:00
42b102bbf9
gh-94936: C getters: co_varnames, co_cellvars, co_freevars ( #95008 )
2022-08-04 06:53:31 -07:00
0342c93a6b
gh-91323: Revert "Allow overriding a future compliance check in asyncio.Task (GH-32197)" (GH-95442)
...
This reverts commit d4bb38f82b
2022-08-04 15:51:38 +02:00
d0d0154443
gh-91838: Resolve HTTP links which redirect to HTTPS (GH-95642)
...
It updates links which redirect to HTTPS with different authority or
path.
2022-08-04 13:30:05 +03:00
f79547a429
gh-91838: Use HTTPS links in docs for resources which redirect to HTTPS (GH-95527)
...
If an HTTP link is redirected to a same looking HTTPS link, the latter can
be used directly without changes in readability and behavior.
It protects from a men-in-the-middle attack.
This change does not affect Python examples.
2022-08-04 10:13:49 +03:00
bcc74d509a
gh-95191: IDLE Prompts entry for What's New 3.10 ( #95633 )
2022-08-03 22:17:57 -04:00
c569526fac
gh-95191: IDLE Prompts entry for Whatnew 3.11 ( #95632 )
2022-08-03 20:56:05 -04:00
dc2757accd
gh-90817: Use .. deprecated-removed:: when removal version known ( #94960 )
2022-08-03 23:47:20 +02:00
67840edb28
gh-94399: Restore PATH search behaviour of py.exe launcher for '/usr/bin/env' shebang lines (GH-95582)
2022-08-03 22:18:51 +01:00
6bde34000d
[Enum] add whatsnew entries (GH-95455)
2022-08-03 14:11:20 -07:00
ebd660156d
gh-95423: Update winreg.DeleteKeyEx documentation and remove dynamic function load (GH-95521)
2022-08-03 21:55:03 +01:00
4d02572f8c
gh-95273: Align sqlite3 const doc refs with the devguide recommendations ( #95525 )
2022-08-03 22:21:15 +02:00
ac3bf6155f
gh-91207: Fix CSS bug in Windows CHM help file and add deprecation message (GH-95607)
2022-08-03 20:23:20 +01:00
89f5229328
Docs: fix incorrect formatting in sqlite3 CLI docs ( #95581 )
2022-08-03 00:17:09 +02:00
e3b6ff19aa
gh-95451: Update docs for wasm32-emscripten and -wasi platforms (GH-95452)
...
Co-authored-by: Éric <merwok@netwok.org>
Co-authored-by: Michael Droettboom <mdboom@gmail.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-08-02 21:00:41 +02:00
75a6441718
gh-95516: Add param types and clarify param descriptions of LogRecord (GH-95517)
2022-08-02 08:42:35 +01:00
d2c1a9c76c
gh-92219: Clarify that some options to the installer may break the install (GH-95548)
2022-08-02 00:57:46 +01:00
d965d1995e
no-issue: Fix typo of "thrid" instead of "third" in dis docs (gh-95510)
2022-08-02 00:06:43 +09:00
347c783673
gh-95007: Remove the NoneType return converter from Argument Clinic Doc ( #95529 )
...
The converter was removed in 74b5e4ce80
2022-08-01 15:07:35 +02:00
bc7c7cd18a
gh-77617: Add sqlite3 command-line interface ( #95026 )
...
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2022-08-01 12:25:16 +02:00
1e6b63542e
gh-95273: Clarify when sqlite_* attributes are added to sqlite3 exceptions ( #95523 )
2022-08-01 11:15:07 +02:00
d29e279de3
bpo-42037: Corrected request dependencies in CookieJar functions (GH-23112)
2022-08-01 10:42:13 +08:00
aa37ffda29
bpo-45445: Revert "bpo-45445: Fail if an invalid X-option is provided in the command line (GH-28823)" ( #94745 )
2022-07-31 16:33:56 +01:00
6c439b978b
gh-94635: Add Reference, How-to, and Concepts headings to sqlite3 docs ( #94636 )
...
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-07-31 01:24:15 +02:00
82814624bf
Doctest cleanups (GH-95436)
...
* GHA: Don't hide doctest output
* Enable doctests in math.rst
* Squash warnings in nntplib.rst doctests
* Squash warning in turtle.rst doctest
* Squash warnings in whatsnew/3.2.rst doctests
* Treat warnings as errors in Doc/ doctests
2022-07-30 17:21:08 -05:00
C.A.M. Gerlach
Gregory P. Smith
Will Hawkins
Łukasz Langa
Eddie Hebert
Ofey Chan
Jeff Allen
NoSuck
Stanley
Kumar Aditya
Vinay Sajip
Andrew Kay
Pablo Galindo Salgado
Serhiy Storchaka
Steve Dower
Harry
partev
Shantanu
Raymond Hettinger
Scott Main
Benjamin Peterson
Victor Stinner
Dong-hee Na
Erlend E. Aasland
adphrost
Laurie O
Alex Waygood
zhanpon
Maksym Medvied
Hendrik Makait
finefoot
Irit Katriel
Pamela Fox
Sergey B Kirpichev
Mehrdad Moradizadeh
Alexandru Mărășteanu
Cheryl Sabella
siph
Gregory P. Smith
Erlend E. Aasland
Piotr Kaznowski
Mark Shannon
Adrian Garcia Badaracco
Tim Burke
da-woods
Petr Viktorin
Jonathan Oberländer
TW
Ansab Gillani
Ezio Melotti
ov2k
Sam Ezeh
prego
sand8089
Nick Coghlan
Brandt Bucher
MrSuspicious
Kevin Modzelewski
Christian Heimes
Howie Zhao
Hugo van Kemenade
Stanislav Zmiev
Clemens Tolboom
Terry Jan Reedy
esc
Andrzej Bartosiński
Oleg Iarygin
Barney Gale
Mariatta Wijaya
Brandt Bucher
Eric Snow
Barry Warsaw
fluesvamp
ceh
Ken Jin
Ethan Furman
Derek Kim
Alex Hedges
Noam Cohen
markus-sus
Zachary Ware