bpo-42179: Clarify exception chaining (GH-23160)

* Update errors.rst

Clarify exception chaining behaviour and give a reference to the library documentation.

* Update errors.rst

Wording

* Update errors.rst

Spelling

* Update errors.rst

Remove mentioning of special attributes as folks think it's too much for beginners.
This commit is contained in:
Vladimir 2020-12-15 18:47:26 -08:00 committed by GitHub
parent 801165e1a9
commit 3f9fe23c05
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 4 additions and 4 deletions

View File

@ -281,17 +281,17 @@ chaining exceptions. For example::
This can be useful when you are transforming exceptions. For example:: This can be useful when you are transforming exceptions. For example::
>>> def func(): >>> def func():
... raise IOError ... raise ConnectionError
... ...
>>> try: >>> try:
... func() ... func()
... except IOError as exc: ... except ConnectionError as exc:
... raise RuntimeError('Failed to open database') from exc ... raise RuntimeError('Failed to open database') from exc
... ...
Traceback (most recent call last): Traceback (most recent call last):
File "<stdin>", line 2, in <module> File "<stdin>", line 2, in <module>
File "<stdin>", line 2, in func File "<stdin>", line 2, in func
OSError ConnectionError
<BLANKLINE> <BLANKLINE>
The above exception was the direct cause of the following exception: The above exception was the direct cause of the following exception:
<BLANKLINE> <BLANKLINE>
@ -300,7 +300,7 @@ This can be useful when you are transforming exceptions. For example::
RuntimeError: Failed to open database RuntimeError: Failed to open database
Exception chaining happens automatically when an exception is raised inside an Exception chaining happens automatically when an exception is raised inside an
:keyword:`except` or :keyword:`finally` section. Exception chaining can be :keyword:`except` or :keyword:`finally` section. This can be
disabled by using ``from None`` idiom: disabled by using ``from None`` idiom:
>>> try: >>> try: