OpenCyphal / pycyphal / 23563546523

93%

push

github

Add option to hook into internal pycyphal errors (#377)

Currently, when pycyphal encounters an error in one of its background
asyncio tasks (e.g. a task receiving messages in the background), it
simply calls logger.exception. This is fine for debugging with a human
looking at the logs, but insufficient for production environments where
you need to react to unexpected problems — there is no way of knowing an
exception happened except by reading the logs.

This PR introduces set_internal_error_handler, which can be used to
register a global hook into pycyphal. This hook will receive all
background exceptions when they happen and can react to them as needed
(e.g. by raising a fatal error). When no hook is registered, the
behavior is unchanged — exceptions are simply logged.

---------

Co-authored-by: MAMMOTH BOT <pavels.bot@zubax.com>

1656 of 2027 branches covered (81.7%)

Branch coverage included in aggregate %.

14391 of 15155 relevant lines covered (94.96%)

0.95 hits per line