[New-bugs-announce] [issue47108] asyncio-stream does not document exceptions

[Christian Bodt]

New submission from Christian Bodt <christian.bodt at gmail.com>:

reader.read() might raise ConnectionResetError and possibly other exceptions, but this is not explained in the documentation.

See this stacktrace example:

Traceback (most recent call last):
  File "D:\Dropbox\repos\wxasync\src\examples\server.py", line 23, in handle_connection
    data = await reader.read(100)
  File "C:\Python-3.9\lib\asyncio\streams.py", line 684, in read
    await self._wait_for_data('read')
  File "C:\Python-3.9\lib\asyncio\streams.py", line 517, in _wait_for_data
    await self._waiter
  File "C:\Python-3.9\lib\asyncio\proactor_events.py", line 280, in _loop_reading
    data = fut.result()
  File "C:\Python-3.9\lib\asyncio\windows_events.py", line 812, in _poll
    value = callback(transferred, key, ov)
  File "C:\Python-3.9\lib\asyncio\windows_events.py", line 461, in finish_recv
    raise ConnectionResetError(*exc.args)
ConnectionResetError: [WinError 64] Le nom réseau spécifié n’est plus disponible

----------
assignee: docs at python
components: Documentation
messages: 415933
nosy: christian.bodt, docs at python
priority: normal
severity: normal
status: open
title: asyncio-stream does not document exceptions
versions: Python 3.11

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue47108>
_______________________________________