[issue43438] [doc] sys.addaudithook() documentation should be more explicit on its limitations

[Christian Heimes]

Christian Heimes <lists at cheimes.de> added the comment:

I agree with both of you.

The documention should explicitly state that the audit hooks are for auditing. They are not designed to sandbox Python. When used correctly, they can help to capture and analyze an event post-mortem.

The documentation of sys.addaudithook() should also mention that hooks may not trigger under some conditions, e.g. very late in the interpreter shutdown phase.

----------

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