Commit graph

11610 commits

Author SHA1 Message Date
Miss Islington (bot)
c521c5cdc3
gh-91838: Resolve HTTP links which redirect to HTTPS (GH-95642)
It updates links which redirect to HTTPS with different authority or
path.
(cherry picked from commit d0d0154443)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2022-08-04 06:15:11 -07:00
Serhiy Storchaka
d8df7e0207
[3.11] gh-91838: Use HTTPS links in docs for resources which redirect to HTTPS (GH-95527) (GH-95643)
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..
(cherry picked from commit f79547a429)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2022-08-04 11:45:03 +03:00
Miss Islington (bot)
450ee4f791
gh-90817: Use .. deprecated-removed:: when removal version known (GH-94960)
(cherry picked from commit dc2757accd)

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2022-08-03 14:56:16 -07:00
Steve Dower
1016df0a23
gh-95423: Update winreg.DeleteKeyEx documentation and remove dynamic function load (GH-95521)
Co-authored-by: Derek Kim <ddkim1024@gmail.com>
2022-08-03 22:25:47 +01:00
Miss Islington (bot)
8d09626066
gh-95273: Align sqlite3 const doc refs with the devguide recommendations (GH-95525)
(cherry picked from commit 4d02572f8c)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-08-03 13:28:38 -07:00
Miss Islington (bot)
72cad6cfe5
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>
(cherry picked from commit e3b6ff19aa)

Co-authored-by: Christian Heimes <christian@python.org>
2022-08-02 12:13:07 -07:00
Miss Islington (bot)
698b52c879
gh-95233: Correct grp.getgrgid parameter name in documentation (gid -> id) (gh-95232)
(cherry picked from commit df7c8b9537)

Co-authored-by: Adam Dangoor <adamdangoor@gmail.com>
2022-08-02 08:02:14 -07:00
Miss Islington (bot)
eff6778899
[3.11] gh-95516: Add param types and clarify param descriptions of LogRecord (GH-95517) (GH-95566)
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-08-02 10:54:49 +01:00
Christian Heimes
e62a0dfab2
[3.11] gh-95174: Add pthread stubs for WASI (GH-95234) (#95503)
Co-authored-by: Brett Cannon <brett@python.org>.
(cherry picked from commit 0fe645d6fd)

Co-authored-by: Christian Heimes <christian@python.org>
2022-08-01 15:37:45 +01:00
Christian Heimes
9af9ea28e7
[3.11] gh-95415: Make availability directive consistent (GH-95416) (GH-95438)
Co-authored-by: Christian Heimes <christian@python.org>
2022-08-01 14:26:19 +02:00
Miss Islington (bot)
ad2872f5fd
gh-95273: Clarify when sqlite_* attributes are added to sqlite3 exceptions (GH-95523)
(cherry picked from commit 1e6b63542e)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-08-01 02:22:09 -07:00
Miss Islington (bot)
a4cda28f7b
bpo-42037: Corrected request dependencies in CookieJar functions (GH-23112)
(cherry picked from commit d29e279de3)

Co-authored-by: markus-sus <73822103+markus-sus@users.noreply.github.com>
2022-07-31 19:49:47 -07:00
Miss Islington (bot)
147a9a8be7
bpo-45445: Revert "bpo-45445: Fail if an invalid X-option is provided in the command line (GH-28823)" (GH-94745)
(cherry picked from commit aa37ffda29)

Co-authored-by: Pablo Galindo Salgado <Pablogsal@gmail.com>
2022-07-31 08:58:02 -07:00
Erlend Egeberg Aasland
c7ac8b6588
[3.11] gh-94635: Add Reference, How-to, and Explanation headings to sqlite3 docs (GH-94636) (#95482)
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>.
(cherry picked from commit 6c439b978b)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>

* Fix refs
2022-07-31 08:48:13 +02:00
Miss Islington (bot)
1187efeebb
gh-95273: Relocate sqlite3 enable load extension note (GH-95430)
(cherry picked from commit d92b19e1b5)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-29 12:38:12 -07:00
Miss Islington (bot)
30ca6914c7
gh-95432: Fixup sqlite3 tutorial example (GH-95431)
- the insert statement should have five placeholders, not four
- missing ... in the multiline row list
(cherry picked from commit 2fbee85931)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-29 05:41:46 -07:00
Miss Islington (bot)
c26470f0cc
gh-95273: Improve sqlite3 class descriptions (GH-95379)
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
(cherry picked from commit e003b64f40)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
2022-07-29 03:02:16 -07:00
Miss Islington (bot)
f06f3656c5
gh-95273: Move sqlite3 executemany examples from reference to tutorial (GH-95351)
(cherry picked from commit f0bf7956e6)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
2022-07-29 00:51:20 -07:00
Miss Islington (bot)
6eae15abb6
gh-95273: Condense sqlite3 executescript example (GH-95383)
(cherry picked from commit e9c8de669d)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
2022-07-29 00:48:47 -07:00
Miss Islington (bot)
3e9a496b6b
Improve documentation for adding datetime and timedelta (gh-95403) (gh-95408)
(cherry picked from commit 6e44bf9558)

Co-authored-by: BenjaminHelyer <91896754+BenjaminHelyer@users.noreply.github.com>

Co-authored-by: BenjaminHelyer <91896754+BenjaminHelyer@users.noreply.github.com>
2022-07-28 20:14:05 -04:00
Miss Islington (bot)
b50f58ecb4
gh-86128: Add warning to ThreadPoolExecutor docs about atexit behaviour (GH-94008)
(cherry picked from commit 7df2f4d787)

Co-authored-by: [object Object] <lucas.wiman@gmail.com>
2022-07-28 15:46:45 -07:00
Miss Islington (bot)
123079241d
Docs: Fix refs & tweak wording in sqlite3 'Using shortcut methods' (#95357)
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
(cherry picked from commit ea269b9a38)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-28 12:32:56 +02:00
Miss Islington (bot)
e14c4d5a2b
gh-95273: Normalise sqlite3 reference wording (GH-95274)
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
(cherry picked from commit 2361908a9d)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
2022-07-27 06:33:01 -07:00
Miss Islington (bot)
f28118211f
gh-94630: Fixup sqlite3 argument spec docs for connection execute* methods (GH-95319)
(cherry picked from commit 2b37395612)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-27 05:56:07 -07:00
Miss Islington (bot)
0d812a58a7
gh-94635: Add sqlite3 'Introduction' and 'Tutorial' doc headings (GH-95269) (GH-95304)
(cherry picked from commit 2e35a13e46)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-27 10:05:50 +02:00
Miss Islington (bot)
5a9920fcf5
gh-95235: Add explicit parameter list to some sqlite3 methods (GH-95240) (GH-95263)
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
(cherry picked from commit 5012bedc7c)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-26 12:17:59 +02:00
Miss Islington (bot)
19d953682e
gh-95051: ensure that timeouts scheduled with asyncio.Timeout that have already expired are deliverered promptly (GH-95109) (GH-95216)
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
(cherry picked from commit 0c6f898005)

Co-authored-by: Thomas Grainger <tagrain@gmail.com>
2022-07-26 12:16:12 +02:00
Miss Islington (bot)
4c10dbab4e
gh-95235: Document undocumented parameters in sqlite3 functions and methods (GH-95236)
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
(cherry picked from commit ac6a94c669)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-25 09:55:01 -07:00
Miss Islington (bot)
92170517d7
gh-93610: Improve docs for importlib.resources (GH-93611) (GH-95247)
(cherry picked from commit ccd7c7a0bd)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2022-07-25 18:26:46 +02:00
Miss Islington (bot)
791c3fd2c9
Fix incorrect directive in multiprocessing module documentation (GH-93517)
(cherry picked from commit 346aabf916)

Co-authored-by: oda-gitso <105083118+oda-gitso@users.noreply.github.com>
2022-07-22 09:57:07 -07:00
Miss Islington (bot)
6a3b6c2cee
Closes gh-95133: docs, fix indentation level in TestCase.assertLogs example (GH-95134)
(cherry picked from commit 2a9c227ac1)

Co-authored-by: Alexandru Mărășteanu <alexei@users.noreply.github.com>
2022-07-22 09:45:20 -07:00
Miss Islington (bot)
12b56e4b78
gh-81040: Improve sqlite3.Cursor.rowcount docs (GH-94940)
(cherry picked from commit f9b3706df6)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-22 00:43:12 -07:00
Miss Islington (bot)
d2be44230e
Remove out of date reference to YIELD_FROM from docs. (GH-94966) (GH-94975)
(cherry picked from commit c41d4d0917)

Co-authored-by: Mark Shannon <mark@hotpy.org>

Co-authored-by: Mark Shannon <mark@hotpy.org>
2022-07-19 12:58:44 +01:00
Miss Islington (bot)
a5c8cecf29
Fix incorrect double indent in ast doc (GH-94976)
Warning directive indent was 4 rather than 3 spaces.
(cherry picked from commit a25a803c4c)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2022-07-18 10:34:09 -07:00
Miss Islington (bot)
37ec0bdf16
In ast doc, update 'below' to 'above' (GH-94967)
The included asdl file was moved from 'below' to 'above' in 3.9.
(cherry picked from commit 7b617be4ab)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2022-07-18 09:46:26 -07:00
Miss Islington (bot)
1c63734217
gh-91348: Restore frame argument to sys._getframe audit event (GH-94928)
(cherry picked from commit 044a593cbb)

Co-authored-by: Steve Dower <steve.dower@python.org>
2022-07-17 08:49:57 -07:00
Miss Islington (bot)
ccbf85382c
gh-91181: drop support for bytes on sys.path (GH-31934)
Support for bytes broke sometime between Python 3.2 and 3.6 and has been broken ever since. Trying to bring back supports is surprisingly difficult in the face of -b and checking for keys in sys.path_importer_cache. Since the support was broken for so long, trying to overcome the difficulty of bringing back the support has been deemed not worth it.

Co-authored-by: Eryk Sun <eryksun@gmail.com>
Co-authored-by: Brett Cannon <brett@python.org>
(cherry picked from commit 6da988a46c)

Co-authored-by: Thomas Grainger <tagrain@gmail.com>
2022-07-16 18:31:25 -07:00
Miss Islington (bot)
734c8b7e55
Add additional pointers to pathlib's mapping to os.path functions (GH-94828)
* Add additional pointers to pathlib's mapping to os.path functions

os.path.splitext has a somewhat quirky signature since it mixes the path and filename components but I wanted the documentation to mention `PurePath.stem` as the natural counterpart to `PurePath.suffix` for the common use of `os.path.splitext` to turn "file.py" into "file" and "py".

Technically this could have some discussion of how to handle the parent directory hierarchy but that seems a bit out of keeping with the spirit of this table so I omitted mentioning `PurePath.parents` here.

* Update Doc/library/pathlib.rst

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
(cherry picked from commit 3789c63577)

Co-authored-by: Chris Adams <chris@improbable.org>
2022-07-15 15:21:34 -07:00
Miss Islington (bot)
a6c4ca9b7c
[3.11] [doc] Update cookbook example and add information about queue types. (GH-94854) (GH-94871)
(cherry picked from commit dc54193095)
2022-07-15 08:19:02 +01:00
Miss Islington (bot)
3b6cb56dc9
GH-46771: docs for asyncio.timeout and task cancellation (GH-94794)
(cherry picked from commit 08f68975ab)

Co-authored-by: Tin Tvrtković <tinchester@gmail.com>
2022-07-14 19:48:03 -07:00
Miss Islington (bot)
016fd7b57f
Docs: fix typo in sqlite3.rst (GH-94798)
Colum -> Column
(cherry picked from commit 9ea72e9d8d)

Co-authored-by: Ikko Ashimine <eltociear@gmail.com>
2022-07-14 14:56:30 -07:00
Miss Islington (bot)
7c185017a9
docs: typing.Self, fix typo (GH-94771)
* fix typo - double spelled word 'use'

* change methods names to the infinitive form
(cherry picked from commit 90a6e56e56)

Co-authored-by: Max Zhenzhera <59729293+maxzhenzhera@users.noreply.github.com>
2022-07-12 11:17:06 -07:00
John Belmonte
45896f2a02
[3.11] gh-93883: elide traceback indicators when possible (GH-93994) (GH-94740)
Elide traceback column indicators when the entire line of the
frame is implicated.  This reduces traceback length and draws
more attention to the remaining (very relevant) indicators.

Example:
```
Traceback (most recent call last):
  File "query.py", line 99, in <module>
    bar()
  File "query.py", line 66, in bar
    foo()
  File "query.py", line 37, in foo
    magic_arithmetic('foo')
  File "query.py", line 18, in magic_arithmetic
    return add_counts(x) / 25
           ^^^^^^^^^^^^^
  File "query.py", line 24, in add_counts
    return 25 + query_user(user1) + query_user(user2)
                ^^^^^^^^^^^^^^^^^
  File "query.py", line 32, in query_user
    return 1 + query_count(db, response['a']['b']['c']['user'], retry=True)
                               ~~~~~~~~~~~~~~~~~~^^^^^
TypeError: 'NoneType' object is not subscriptable
```

Automerge-Triggered-By: GH:pablogsal
2022-07-11 04:27:29 -07:00
Miss Islington (bot)
f3212b1ec7
GH-77265: Document NaN handling in statistics functions that sort or count (GH-94676) (#94726) 2022-07-10 12:35:33 -05:00
Miss Islington (bot)
cb4359ccfc
Use mdash-es consistently in the library docs index (GH-92762)
(cherry picked from commit efb20a97c4)

Co-authored-by: Oleg Iarygin <oleg@arhadthedev.net>
2022-07-08 07:52:02 -07:00
Erlend Egeberg Aasland
73a1800b55
[3.11] gh-94622: Add more references to the sqlite3 types anchor (GH-94623) (#94678)
(cherry picked from commit e5b841a403)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-08 02:50:01 +02:00
Miss Islington (bot)
c72001e5bd
gh-94321: Document sqlite3.PrepareProtocol (GH-94620)
(cherry picked from commit fb6dccae34)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-07 16:09:05 -07:00
Erlend Egeberg Aasland
3517c138a8
[3.11] gh-94628: Add explicit parameter list to sqlite3.connect docs (GH-94629) (#94645)
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
(cherry picked from commit 3eb2b9634f)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-07 10:46:14 +02:00
Miss Islington (bot)
fa44a760d5
gh-94630: Update sqlite3 docs with positional-only and keyword-only symbols (GH-94631)
(cherry picked from commit 94988603f3)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-06 16:22:10 -07:00
Miss Islington (bot)
37a47b139c
gh-94017: Improve clarity of sqlite3 transaction handling docs (GH-94320)
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
(cherry picked from commit 760b8cf0c8)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
2022-07-06 14:08:13 -07:00