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:
parent
801165e1a9
commit
3f9fe23c05
|
@ -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:
|
||||||
|
|
Loading…
Reference in New Issue