Commit graph

23542 commits

Author SHA1 Message Date
Miss Islington (bot)
409ce4a09e
bpo-42669: Document that except rejects nested tuples (GH-23822) (GH-23870)
In Python 2, it was possible to use `except` with a nested tuple, and occasionally natural.  For example, `zope.formlib.interfaces.InputErrors` is a tuple of several exception classes, and one might reasonably think to do something like this:

    try:
        self.getInputValue()
        return True
    except (InputErrors, SomethingElse):
        return False

As of Python 3.0, this raises `TypeError: catching classes that do not inherit from BaseException is not allowed` instead: one must instead either break it up into multiple `except` clauses or flatten the tuple.  However, the reference documentation was never updated to match this new restriction.  Make it clear that the definition is no longer recursive.

Automerge-Triggered-By: GH:ericvsmith
(cherry picked from commit c95f8bc270)

Co-authored-by: Colin Watson <cjwatson@debian.org>

Co-authored-by: Colin Watson <cjwatson@debian.org>
2020-12-20 16:18:08 -05:00
Miss Islington (bot)
40b4c405f9
bpo-42572: Improve argparse docs for the type parameter. (GH-23849) (GH-23869) 2020-12-20 10:51:20 -08:00
Miss Islington (bot)
a34ab8188e
bpo-41724: Explain when the conversion is not possible with detect_types enabled (GH-23855) (GH-23862)
* Explain when the conversion is not possible with detect_types enabled
(cherry picked from commit 09a36cdfb7)

Co-authored-by: sblondon <sblondon@users.noreply.github.com>

Co-authored-by: sblondon <sblondon@users.noreply.github.com>
2020-12-19 19:02:25 -05:00
kj
597ebc8cf6
[3.9] bpo-42675: Document collections.abc.Callable changes (GH-23839) (#23852) 2020-12-19 14:32:06 -08:00
Miss Islington (bot)
d458d8dab0
bpo-42559: Not that getrandbits() is non-negative. (GH-23843) (GH-23851) 2020-12-18 19:10:06 -08:00
Miss Islington (bot)
782665885c
bpo-34805: Guarantee that __subclasses__() is in definition order. (GH-23844) (GH-23850) 2020-12-18 17:17:32 -08:00
Miss Islington (bot)
eef33e6d49
bpo-42670: Fix a missing word in the itertools.product() docs (GH-23823) (GH-23824) 2020-12-18 16:55:52 -08:00
Miss Islington (bot)
4b412e830d
bpo-36769: Document that fnmatch.filter supports any kind of iterable (GH-13039)
(cherry picked from commit e8d2264210)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2020-12-18 11:34:27 -08:00
Miss Islington (bot)
14619924c3
bpo-17140: Document multiprocessing's ThreadPool (GH-23812)
Up until now, the `multiprocessing.pool.ThreadPool` class has gone
undocumented, despite being a public class in multiprocessing that is
included in `multiprocessing.pool.__all__`.
(cherry picked from commit 84ebcf271a)

Co-authored-by: Matt Wozniski <mwozniski@bloomberg.net>
2020-12-18 05:27:02 -08:00
Miss Islington (bot)
b812e236df
bpo-39096: Format specification documentation fixes for numeric types (GH-23575)
(cherry picked from commit 886b2e5c7a)

Co-authored-by: Mark Dickinson <mdickinson@enthought.com>
2020-12-18 01:49:19 -08:00
Miss Islington (bot)
2fba8445a4
Fix indentation for get_stats_profile() docs (GH-23618)
The existing method is indented one too many times which
makes it look like a sub-method of print_callees().
(cherry picked from commit a6ba2b9015)

Co-authored-by: Matthew Suozzo <msuozzo@google.com>
2020-12-17 01:18:39 +02:00
Miss Islington (bot)
aba12b67c1
[3.9] bpo-42517: [Enum] deprecate private name members (GH-23722) (GH-23748)
private names will raise a DeprecationWarning; in 3.10 they will become normal attributes
2020-12-14 15:56:58 -08:00
Miss Islington (bot)
be9e4402db
[3.9] bpo-41879: Doc: Fix description of async for statement (GH-23548) (GH-23749)
Fix the wording in the documentation of `async for` to correctly describe asynchronous iterables.  This fix is relevant for version 3.7 onward.
(cherry picked from commit 4b8cdfcb22)


Co-authored-by: Nick Gaya <nicholasgaya+github@gmail.com>
2020-12-12 20:24:31 -08:00
Andre Delfino
c1a3f9a9cb
[3.9] [doc] Link to issue regarding logging.disable level param default value GH-23732
(cherry picked from commit 2a35137328)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2020-12-10 06:20:04 -08:00
Miss Islington (bot)
facca72eae
bpo-38843: Document behavior of default when the attribute is already set (GH-23653) (#23668)
(cherry picked from commit 752cdf21eb)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
2020-12-06 21:17:09 -08:00
Miss Islington (bot)
3689c25a10
bpo-42523: Fix supported versions in "Using Python on Windows" (GH-23603)
(cherry picked from commit db68544122)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>
2020-12-03 09:46:58 -08:00
Miss Islington (bot)
ed4614386f
bpo-37221: PyCode_New() didn't change in Python 3.8 (GH-23595)
(cherry picked from commit 1867b462de)

Co-authored-by: Victor Stinner <vstinner@python.org>
2020-12-01 07:54:54 -08:00
Miss Islington (bot)
4a44f53aa8
[3.9] bpo-17852: Doc: Fix the tutorial about closing files (GH-23135) (GH-23527)
Co-authored-by: Inada Naoki <songofacandy@gmail.com>
(cherry picked from commit c8aaf71dde)


Co-authored-by: Volker-Weissmann <39418860+Volker-Weissmann@users.noreply.github.com>
2020-12-01 02:53:42 -08:00
Miss Islington (bot)
aef482f7cf
Fix bz2 examples markup (GH-23580)
(cherry picked from commit 80a429eae9)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2020-12-01 02:04:23 -08:00
Julien Palard
7e80c0f40e
[3.9] [doc] Fix smtplib and xml.dom.minidom mark-up (GH-22769) (GH-23380) 2020-12-01 08:58:36 +01:00
Miss Islington (bot)
aab9390334
bpo-42501: Revise the usage note for Enums with the choices (GH-23563) (GH-23573) 2020-11-30 13:21:08 -08:00
Miss Islington (bot)
a83119d7be
bpo-42450: Minor updates to the itertools recipes (GH-23555) (GH-23562) 2020-11-29 11:14:10 -08:00
Miss Islington (bot)
cf47b3969e
bpo-39096: Improve description of 'e', 'f' and 'g' presentation types (GH-23537) (GH-23550)
* Improve description of 'e', 'f' and 'g' presentation types

* Drop the 'E' from Scientific 'E' notation; remove >= 0 qualifications

* Fix false statement that the alternate form is valid for Decimal

* Nitpick: remove the Harvard/Oxford comma

* Add note that the decimal point is also removed if no digits follow it, except in alternate form
(cherry picked from commit c642374b3e)

Co-authored-by: Mark Dickinson <mdickinson@enthought.com>

Co-authored-by: Mark Dickinson <mdickinson@enthought.com>
2020-11-29 09:58:01 +00:00
Miss Islington (bot)
cfb2f79634
Fix dis markup (GH-23524)
(cherry picked from commit fa840cc81d)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2020-11-28 14:06:05 -08:00
Miss Islington (bot)
5d54dfadcf
Fix multiprocessing markup (GH-23525)
(cherry picked from commit 4b44472966)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2020-11-28 14:05:37 -08:00
Miss Islington (bot)
cc5eb935c7
bpo-42489: Fix the signature for list.sort() in the tutorial (GH-23538)
(cherry picked from commit d41ec65ab7)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>
2020-11-28 07:14:23 -08:00
Miss Islington (bot)
dca61e770d
Typo: fix inverted sense of statement (GH-23288) (GH-23512) 2020-11-25 12:14:32 -08:00
Miss Islington (bot)
0aedcff34c
Add more tests to the descriptor howto guide (GH-23506) (GH-23510) 2020-11-25 02:16:32 -08:00
Miss Islington (bot)
543724b972
Add doctests to the descriptor HowTo (GH-23500) (GH-23505) 2020-11-24 22:47:17 -08:00
Miss Islington (bot)
b6416052f7
Typo (GH-23482) (#23483)
(cherry picked from commit 989af25616)

Co-authored-by: Jesús Cea <jcea@jcea.es>

Co-authored-by: Jesús Cea <jcea@jcea.es>
2020-11-24 01:11:13 +01:00
Miss Islington (bot)
2019e4ff98
Descriptor HowTo: Improve the fidelity of the member object simulation (GH-23475) (GH-23479) 2020-11-23 11:31:45 -08:00
Ned Deily
5aa6c99da1
bpo-41100: Update Whatsnew and installer ReadME for 3.9.1 (GH-23472) 2020-11-22 23:43:04 -05:00
Miss Islington (bot)
41d1ebb33e
Doc: fix typo in typing.Type docs (GH-23460)
(cherry picked from commit 5ef53a88f3)

Co-authored-by: John Belmonte <john@neggie.net>
2020-11-22 07:16:48 -08:00
Miss Islington (bot)
4f87126969
bpo-42391: Clarify documentation of TestCase.assertIs (GH-23348)
Removing 'evaluate' makes it more consistent with other assertX entries.
(cherry picked from commit bd8c22e1fa)

Co-authored-by: Ram Rachum <ram@rachum.com>
2020-11-21 22:24:21 -08:00
Miss Islington (bot)
89d74d0acd
Clarify that Set._from_iterable is not required to be a classmethod. (GH-23272) (GH-23450) 2020-11-21 12:20:26 -08:00
Miss Islington (bot)
3b5b1c82a3
Fix wrong availability for signal.SIGCHLD (GH-23285) (#23425)
I believe this is a mistake. SIGCHLD is only available on Unix systems, not Windows.
(cherry picked from commit 4c24b08cd3)

Co-authored-by: Zhang Maiyun <myzhang1029@hotmail.com>

Co-authored-by: Zhang Maiyun <myzhang1029@hotmail.com>
2020-11-21 13:22:46 +02:00
Miss Islington (bot)
d153eb8a1e
bpo-42412: Fix possible leaks and check arguments in PyType_FromModuleAndSpec() (GH-23410)
* There were leaks if Py_tp_bases is used more than once or if some call is
  failed before setting tp_bases.
* There was a crash if the bases argument or the Py_tp_bases slot is not a tuple.
* The documentation was not accurate.
(cherry picked from commit 1db76394ea)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2020-11-21 03:09:40 -08:00
Miss Islington (bot)
ed0201805c
bpo-42419: Correct 'deprecatations' is What's New 3.9 (GH-23421) (GH-23435)
(cherry picked from commit aa3a3521ce)
Co-authored-by: Quentin Hibon <qh.public@yahoo.com>
2020-11-20 23:34:55 -05:00
Miss Islington (bot)
c963da269d
bpo-42407: Use possessive appostrophe in multiprocessing doc (GH-23400)
(cherry picked from commit 6edf06b24a)

Co-authored-by: ArioA <ArioA@users.noreply.github.com>
2020-11-20 19:01:05 -08:00
Miss Islington (bot)
f552f4b2d6
bpo-42360: Add advice to help avoid pickling issues. (GH-23305) (GH-23429) 2020-11-20 13:19:49 -08:00
Miss Islington (bot)
1051ca4d97
bpo-42345: Add whatsnew and versionchanged for typing.Literal in 3.9 (GH-23386)
* Whatsnew entry in 3.9 same as the one in 3.10.
* versionchanged for typing.Literal docs

Needs backport to 3.9.
(cherry picked from commit e1dc0db8c7)

Co-authored-by: kj <28750310+Fidget-Spinner@users.noreply.github.com>
2020-11-19 09:59:10 -08:00
Miss Islington (bot)
2acd9d0c6c
bpo-42345: Fix hash implementation of typing.Literal (GH-23383)
Fix hash implementation of `typing.Literal`.

Update docs regarding `typing.Litaral` caching.

Base implementation was done in PR GH-23294.
(cherry picked from commit 1b54077ff6)

Co-authored-by: Yurii Karabas <1998uriyyo@gmail.com>
2020-11-19 08:51:01 -08:00
Miss Islington (bot)
f9fa920c30
[3.9] bpo-38320: Clarify that expectedFailure is satisfied by either failure or error of the test. (GH-22740) (GH-22783)
(cherry picked from commit fa8748271a)


Co-authored-by: Irit Katriel <iritkatriel@yahoo.com>
2020-11-18 14:37:37 -08:00
Miss Islington (bot)
7c4d8fa82a
bpo-42153 Fix link to IMAP documents in imaplib.rst (GH-23297)
The University of Washington stopped hosting the IMAP documents. Link to a rescued copy on GitHub.
(cherry picked from commit aa01011003)

Co-authored-by: Yash Shete <universeyash4@gmail.com>
2020-11-15 21:27:03 -08:00
Miss Islington (bot)
ec0788c7c9
More updates to the descriptor howto guide (GH-23238) (GH-23308) 2020-11-15 18:27:56 -08:00
Miss Islington (bot)
2369759a47
bpo-42317: Improve docs of typing.get_args concerning Union (GH-23254)
(cherry picked from commit c3b9592244)

Co-authored-by: Dominik1123 <15989985+Dominik1123@users.noreply.github.com>
2020-11-15 17:52:22 -08:00
Miss Islington (bot)
2837241f22
fix typo in ThreadedChildWatcher docs (GH-23277)
(cherry picked from commit 8836574a0f)

Co-authored-by: Thomas Grainger <tagrain@gmail.com>
2020-11-14 04:24:21 -08:00
Miss Islington (bot)
4defeb0071
bpo-42344: Improve pseudo implementation for SimpleNamespace (GH-23264) (GH-23270)
(cherry picked from commit bbeb2d266d)

Co-authored-by: Jürgen Gmach <juergen.gmach@googlemail.com>

Co-authored-by: Jürgen Gmach <juergen.gmach@googlemail.com>
2020-11-13 13:19:05 -05:00
Dong-hee Na
0f4dd87a31
[3.9] bpo-42042: Use ids attribute instead of names attribute (GH-22739) (GH-23265)
(cherry picked from commit 09490a109f)

Co-authored-by: Dong-hee Na <donghee.na@python.org>
2020-11-14 00:45:02 +09:00
Miss Islington (bot)
bc77704783
[3.9] bpo-42086: Document AST operator nodes acts as a singleton (GH-22896) (GH-22897)
Automerge-Triggered-By: GH:gvanrossum
(cherry picked from commit b37c994e5a)


Co-authored-by: Batuhan Taskaya <batuhanosmantaskaya@gmail.com>
2020-11-13 01:05:41 -08:00