Commit graph

111287 commits

Author SHA1 Message Date
Oleg Iarygin
e7e8a9fa4f
[3.10] gh-91118: Fix docstrings that do not honor --without-doc-strings (GH-31769) (#91662)
Co-authored-by: Éric <merwok@netwok.org>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit a573cb2fec)

Co-authored-by: Oleg Iarygin <oleg@arhadthedev.net>
2022-04-19 13:01:09 -07:00
Victor Stinner
a885f10325
gh-91231: multiprocessing BaseManager waits 1.0 second (#91701)
Shutting down a multiprocessing BaseManager now waits for 1 second until
the process completes, rather than 0.1 second, after the process is
terminated.
2022-04-19 17:06:00 +02:00
Miss Islington (bot)
c213cccc9b
Add more tests for group names and refs in RE (GH-91695)
(cherry picked from commit 74070085da)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2022-04-19 07:33:09 -07:00
Miss Islington (bot)
b865a661e3
Doc: Fix link formatting typo (GH-91659)
(cherry picked from commit 6a7a8a740e)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
2022-04-19 02:33:44 -07:00
Gregory P. Smith
61570ae0bc
[3.10] gh-91676 gh-91260 unittest.IsolatedAsyncioTestCase no longer leaks its executor (GH-91680)
For things like test_asyncio.test_thread this was causing frequent
"environment modified by test" errors as the executor threads had not
always stopped running after the test was over.
2022-04-19 10:31:50 +01:00
Miss Islington (bot)
0897a0bf9c
Remove duplicate explanation (GH-91534)
(cherry picked from commit 0e6dca0193)

Co-authored-by: Gouvernathor <44340603+Gouvernathor@users.noreply.github.com>
2022-04-17 21:44:58 -07:00
Miss Islington (bot)
531f66ad62
gh-89885: Improve import example in language reference (GH-91523)
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit d5a69571f5)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
2022-04-17 14:34:41 -07:00
Miss Islington (bot)
e5636f3a0e
gh-91541: Fix error in example in modules tutorial (GH-91634)
(cherry picked from commit efbc668183)

Co-authored-by: 180909 <734461790@qq.com>
2022-04-17 14:30:57 -07:00
Miss Islington (bot)
2bcfe20d92
gh-90923: Improve sqlite3.Connection.execute* docs (GH-91643)
- Drop 'nonstandard'; it does not add any value
- Try to be more concise
- Make return value a little more explicit
(cherry picked from commit 017f07a229)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
2022-04-17 14:29:21 -07:00
Gregory P. Smith
9a458934f7
[3.10] gh-91607: Fix several test_concurrent_futures tests to actually test what they claim (GH-91600) (#91612)
* Fix test_concurrent_futures to actually test what it says.

Many ProcessPoolExecutor based tests were ignoring the mp_context
and using the default instead.  This meant we lacked proper test
coverage of all of them.

Also removes the old _prime_executor() worker delay seeding code
as it appears to have no point and causes 20-30 seconds extra
latency on this already long test.  It also interfered with some
of the refactoring to fix the above to not needlessly create their
own executor when setUp has already created an appropriate one.

* Don't import the name from multiprocessing directly to avoid confusion.

(cherry picked from commit 7fa3a5a219)

Co-authored-by: Gregory P. Smith <greg@krypto.org>
2022-04-16 13:48:11 -07:00
Miss Islington (bot)
84c279b514
gh-91595: fix the comparison of character and integer by using ord() (GH-91596)
* fix the comparison of character and integer by using ord()

* 📜🤖 Added by blurb_it.

Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
(cherry picked from commit 9300b6d729)

Co-authored-by: Yu Liu <yuki.liu@utexas.edu>
2022-04-16 07:59:32 -07:00
Miss Islington (bot)
f5542ecf6d
gh-82849: revise intro to os.path.rst (GH-32232)
* revise the first paragraph of docs for os.path
* add a mention of `os.PathLike` protocol
* remove warnings rendered irrelevant by :pep:`383` and :pep:`529`

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 468314cc8b)

Co-authored-by: Jack DeVries <jdevries3133@gmail.com>
2022-04-15 21:38:11 -07:00
Miss Islington (bot)
2e1f969333
Add link to documentation translation list (GH-91560) (#91589)
(cherry picked from commit c4e8a93eb3)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
2022-04-16 04:16:05 +02:00
Miss Islington (bot)
289f27d06b
gh-88513: clarify shutil.copytree's dirs_exist_ok arg (GH-91434) (GH-91464)
* add a paragraph to document this kwarg in detail
* update docstring in the source accordingly
(cherry picked from commit f33e2c87a8)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-04-15 15:55:13 +02:00
Miss Islington (bot)
de7b756521
gh-70979: Fix runpy.run_path parameter name in docs (GH-32265)
Noticed while reviewing GH-30729.
(cherry picked from commit f1e989b045)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-04-14 18:23:20 -07:00
Miss Islington (bot)
35fef27110
Add redirects to Misc/NEWS bpo links (GH-91454) (GH-91535)
(cherry picked from commit 17dbb6bc10)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2022-04-14 17:02:03 +02:00
Miss Islington (bot)
52ce75fc1e
gh-90879: Fix missing parameter for put_nowait() (GH-91514)
(cherry picked from commit 0fc3517cf4)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
2022-04-14 02:18:31 -07:00
Miss Islington (bot)
72114c06fd
gh-91421: Use constant value check during runtime (GH-91422) (GH-91492)
The left-hand side expression of the if-check can be converted to a
constant by the compiler, but the addition on the right-hand side is
performed during runtime.

Move the addition from the right-hand side to the left-hand side by
turning it into a subtraction there. Since the values are known to
be large enough to not turn negative, this is a safe operation.

Prevents a very unlikely integer overflow on 32 bit systems.

Fixes GH-91421.
(cherry picked from commit 0859368335)

Co-authored-by: Tobias Stoeckmann <stoeckmann@users.noreply.github.com>
2022-04-13 18:38:37 -07:00
Miss Islington (bot)
89697f7374
bpo-47260: Fix os.closerange() potentially being a no-op in a seccomp sandbox (GH-32418)
_Py_closerange() currently assumes that close_range() closes
all file descriptors even if it returns an error (other than ENOSYS).
This assumption can be wrong on Linux if a seccomp sandbox denies
the underlying syscall, pretending that it returns EPERM or EACCES.
In this case _Py_closerange() won't close any descriptors at all,
which in the worst case can be a security issue.

Fix this by falling back to other methods in case of any close_range()
error. Note that fallbacks will not be triggered on any problems with
closing individual file descriptors because close_range() is documented
to ignore such errors on both Linux[1] and FreeBSD[2].

[1] https://man7.org/linux/man-pages/man2/close_range.2.html
[2] https://www.freebsd.org/cgi/man.cgi?query=close_range&sektion=2
(cherry picked from commit 1c8b3b5d66)

Co-authored-by: Alexey Izbyshev <izbyshev@ispras.ru>
2022-04-08 11:10:38 -07:00
Miss Islington (bot)
69edc30d2b
Fix bad grammar and import docstring for split/rsplit (GH-32381) (GH-32416) 2022-04-08 12:06:19 -05:00
Miss Islington (bot)
89192c46da
pickle docs: Fix typos and improve wording (GH-24776) (GH-32395)
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 1d0f08fa46)

Co-authored-by: Géry Ogam <gery.ogam@gmail.com>
2022-04-07 18:56:17 -07:00
Steve Dower
b0ec17b6d9
bpo-47103: Copy pgort140.dll into output directory when building PGInstrument on Windows (GH-32083) 2022-04-07 23:21:03 +01:00
Miss Islington (bot)
877fd622e8
ssl docs: Fix typo (GH-32336)
(cherry picked from commit 9ee2d3a939)

Co-authored-by: Frederick <fmoor@users.noreply.github.com>
2022-04-07 09:51:40 -07:00
Miss Islington (bot)
b4abef2295
c-api docs: There are five fields, not four (GH-32379)
(cherry picked from commit 4c92427fb8)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-04-07 07:27:40 -07:00
Miss Islington (bot)
ccac6312b9
doc: Link to string.capwords from str.title (GH-20913)
Since `title()` mentions its own short-comings, it should also mention the library function which does not possess them.

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit b786d9ec52)

Co-authored-by: Eric Wieser <wieser.eric@gmail.com>
2022-04-06 18:52:51 -07:00
Miss Islington (bot)
b217ba7371
ssl docs: Fix typo (GH-32314)
(cherry picked from commit 1da9c38fd3)

Co-authored-by: Frederick <fmoor@users.noreply.github.com>
2022-04-06 18:13:46 -07:00
Miss Islington (bot)
08bd308dd2
pkgutil docs: Link sys constants, add backticks (GH-32356)
Co-authored-by: Éric <merwok@netwok.org>
(cherry picked from commit 63bd72448a)

Co-authored-by: Boris Verkhovskiy <boris.verk@gmail.com>
2022-04-06 18:12:34 -07:00
Miss Islington (bot)
55abb0ef25
stdtypes docs: fix typo (GH-32349) (GH-32370)
(cherry picked from commit b33c4564ac)

Co-authored-by: Ian <40774387+isteptoe@users.noreply.github.com>
2022-04-06 17:50:04 -07:00
Ken Jin
80af26d25a
[3.10] bpo-46769: Fix backticks in typing.rst to appease rstlint (GH-32374)
* Use double backticks to appease rstlint

* Update susp-ignored.csv
2022-04-07 02:00:26 +08:00
Miss Islington (bot)
3856b4995e
bpo-47235: Note where a typo is intentional in code. (GH-32348)
People keep popping up reporting these as typos in the docs despite
being described as typos in the surrounding text.  Hopefully a comment
on the line itself makes it more obvious?

Arguably some of the typo examples are not using the "right" typo as the
"assret" one in particular is now detected by default due to how common
it was in actual code.  But I don't want to to typo chasing by changing
these examples to be other not yet auto-detected typos as they still
illustrate the point well enough.
(cherry picked from commit ac1fb07b6e)

Co-authored-by: Gregory P. Smith <greg@krypto.org>
2022-04-06 08:30:01 -07:00
Jeremy Kloth
8bce3cb16d
bpo-47230: Silence compiler warnings on Windows from zlib 1.2.12 (GH-32337)
(cherry picked from commit 944f09adfc)

Co-authored-by: Jeremy Kloth <jeremy.kloth@gmail.com>
2022-04-06 00:36:18 +01:00
Matthieu Dartiailh
94609e3192
[3.10] Backport bpo-47212 (GH-32302) to Python 3.10 (GH-32334)
(cherry picked from commit aa0f056a00)

# Conflicts:
#	Grammar/python.gram
#	Parser/action_helpers.c

Automerge-Triggered-By: GH:pablogsal
2022-04-05 09:21:49 -07:00
Miss Islington (bot)
857cf55cbd
bpo-40982: shutil docs: Remove outdated copytree() example (GH-24778)
It is not preferable to keep a copy of the implementation in the
docs.
(cherry picked from commit e06f920c5b)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>
2022-04-04 20:16:16 -07:00
Miss Islington (bot)
97151e1e3a
crypt docs: Fix references to methods attr (GH-26806)
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit cae0f5d3da)

Co-authored-by: andrei kulakov <andrei.avk@gmail.com>
2022-04-04 20:09:45 -07:00
Miss Islington (bot)
d95e072c41
bpo-32658: Regex docs: Fix metacharacter reference (GH-32230)
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 43571a3eea)

Co-authored-by: Mike cm <mikecmcleod@gmail.com>
2022-04-04 20:08:17 -07:00
Miss Islington (bot)
f4e711bb49
bpo-45790: List macros in same order in which fields are described (GH-29529)
Signed-off-by: Rodrigo Tobar <rtobar@icrar.org>

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit b275267aa7)

Co-authored-by: rtobar <rtobar@icrar.org>
2022-04-04 19:57:22 -07:00
Miss Islington (bot)
f502dadb33
bpo-47007: [doc] str special method lookup (GH-31863)
Clarify the `str()` docs to point out that `object.__str__()`
follows special method lookup.

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit bb86d1d9fb)

Co-authored-by: Vanshaj Singhania <8797467+itsvs@users.noreply.github.com>
2022-04-04 19:56:29 -07:00
Miss Islington (bot)
3fa800d7a7
bpo-41233: Add links to errnos referenced in exceptions docs (GH-21380)
Co-authored-by: Andrew Kuchling <amk@amk.ca>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit a74892cb21)

Co-authored-by: yyyyyyyan <24644216+yyyyyyyan@users.noreply.github.com>
2022-04-04 19:30:06 -07:00
Miss Islington (bot)
6b4b892e09
bpo-46484:Add test for Calendar.iterweekdays (GH-30825)
(cherry picked from commit 48269ea9fd)

Co-authored-by: 180909 <734461790@qq.com>
2022-04-04 10:43:38 -07:00
Miss Islington (bot)
29ffac2d39
Demonstrate py --list in the quickstart section of the Windows doc page (GH-29383)
(cherry picked from commit 1ecfe3d5ae)

Co-authored-by: Christian Clauss <cclauss@me.com>
2022-04-04 08:58:44 -07:00
Miss Islington (bot)
a331d0f627
Follow PEP-8 guidelines in tutorial for standard library (GH-26127)
(cherry picked from commit 6db2db91b9)

Co-authored-by: Bob Kline <bkline@users.noreply.github.com>
2022-04-03 15:49:52 -07:00
Miss Islington (bot)
470dfe20cb
bpo-47205: Skip error check of sched_get/setaffinity on FreeBSD (GH-32285)
(cherry picked from commit b82cdd1dac)

Co-authored-by: Christian Heimes <christian@python.org>
2022-04-03 12:27:32 -07:00
Miss Islington (bot)
a5c90784be
Language reference: Remove duplicated text about iterable unpacking (GH-25212)
(cherry picked from commit 4f5d56f8f3)

Co-authored-by: Jiashuo Li <4003950+jiasli@users.noreply.github.com>
2022-04-02 20:05:11 -07:00
Miss Islington (bot)
ce6af314ca
bpo-24563: Link encoding names to encoding declarations (GH-32274)
(cherry picked from commit 01be5d6446)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2022-04-02 17:40:55 -07:00
Jelle Zijlstra
11f5fd1135
[3.10] More minor fixes to C API docs (GH-31525) (GH-32258)
* wording fixes in type.rst

* grammar and punctuation in sys.rst

* set: grammar fixes

* structures: capitalization fix

* grammar fixes for sequence

* objects: point to Py_TYPE instead of direct object access

* numbers: add more explicit Python equivalences

* method: add missing period

* memory: grammar fix

* mapping: grammar fixes

* long: grammar fix

* iter: fix grammar for PyAIter_Check

* init: grammar fix.
(cherry picked from commit 897bc6f928)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-04-02 16:00:51 -07:00
Jelle Zijlstra
a930062d25
[3.10] Document func parameter of locale.atof (GH-18183) (GH-32262)
The second parameter (named `func`) has been present since the `locale`
module was introduced in eef1d4e8b1, but has never been documented.

This commit updates the documentation for `locale.atof` to clarify the
behavior of the function and how the `func` parameter is used.

Signed-off-by: Kevin Locke <kevin@kevinlocke.name>
(cherry picked from commit 208da6d508)

Co-authored-by: Kevin Locke <kevin@kevinlocke.name>
2022-04-02 15:59:41 -07:00
Miss Islington (bot)
3031b86753
bpo-45584: Clarify math.trunc documentation (GH-29183)
While floor/ceil 's documentation are very precise, `truncate` was not explained. I actually had to search online to understand the difference between `truncate` and `floor` (admittedly, once I remembered that numbers are signed, and that floating numbers actually uses a bit for negation symbol instead of two complement, it became obvious)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: Éric Araujo <merwok@netwok.org>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit ebbdbbff5d)

Co-authored-by: Arthur Milchior <arthur@milchior.fr>
2022-04-02 15:30:59 -07:00
Miss Islington (bot)
8d9a75b206
os docs: fix typo (GH-28996)
Co-authored-by: Jacob Walls <jacobtylerwalls@gmail.com>
(cherry picked from commit 1f80dcd244)

Co-authored-by: Vitor Buxbaum Orlandi <vitorbuxbaum@gmail.com>
2022-04-02 15:00:12 -07:00
Miss Islington (bot)
2d936a42ac
codecs docs: fix grammar mistake (GH-29462)
(cherry picked from commit ea56845744)

Co-authored-by: 180909 <wjh180909@gmail.com>
2022-04-02 14:33:52 -07:00
Miss Islington (bot)
23c0200c43
bpo-45114: Use lstat() instead of stat() in stat docs example (GH-29845)
(cherry picked from commit c93a0ac697)

Co-authored-by: 180909 <wjh180909@gmail.com>
2022-04-02 14:19:48 -07:00