Commit 7b69069e authored by Xtreak's avatar Xtreak Committed by Miss Islington (bot)

bpo-37651: Document CancelledError is now a subclass of BaseException (GH-15950)



https://bugs.python.org/issue37651



Automerge-Triggered-By: @1st1
parent 97b817ea
...@@ -25,26 +25,9 @@ Exceptions ...@@ -25,26 +25,9 @@ Exceptions
when asyncio Tasks are cancelled. In almost all situations the when asyncio Tasks are cancelled. In almost all situations the
exception must be re-raised. exception must be re-raised.
.. important:: .. versionchanged:: 3.8
This exception is a subclass of :exc:`Exception`, so it can be
accidentally suppressed by an overly broad ``try..except`` block::
try:
await operation
except Exception:
# The cancellation is broken because the *except* block
# suppresses the CancelledError exception.
log.log('an error has occurred')
Instead, the following pattern should be used::
try: :exc:`CancelledError` is now a subclass of :class:`BaseException`.
await operation
except asyncio.CancelledError:
raise
except Exception:
log.log('an error has occurred')
.. exception:: InvalidStateError .. exception:: InvalidStateError
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment