diff options
| author | Steve Dower <steve.dower@python.org> | 2021-05-03 13:06:36 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-05-03 13:06:36 (GMT) |
| commit | bb2f3ff7a8f0c3565ccc1946dba7e09a3f7dc209 (patch) | |
| tree | 6fea32214cc39992ce43a29309a1a1076b804ae4 /Doc | |
| parent | 1536342c4491ffc70adeb540a04381e90ea623d7 (diff) | |
| download | cpython-bb2f3ff7a8f0c3565ccc1946dba7e09a3f7dc209.zip cpython-bb2f3ff7a8f0c3565ccc1946dba7e09a3f7dc209.tar.gz cpython-bb2f3ff7a8f0c3565ccc1946dba7e09a3f7dc209.tar.bz2 | |
bpo-42800: Add audit events for f_code and tb_frame (GH-24182)
Accessing the following attributes will now fire PEP 578 style audit hooks as (object.__getattr__, obj, name):
* PyTracebackObject: tb_frame
* PyFrameObject: f_code
* PyGenObject: gi_code, gi_frame
* PyCoroObject: cr_code, cr_frame
* PyAsyncGenObject: ag_code, ag_frame
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/library/audit_events.rst | 2 | ||||
| -rw-r--r-- | Doc/library/stdtypes.rst | 3 | ||||
| -rw-r--r-- | Doc/reference/datamodel.rst | 6 |
3 files changed, 10 insertions, 1 deletions
diff --git a/Doc/library/audit_events.rst b/Doc/library/audit_events.rst index 367d56e..8227a79 100644 --- a/Doc/library/audit_events.rst +++ b/Doc/library/audit_events.rst @@ -7,7 +7,7 @@ Audit events table This table contains all events raised by :func:`sys.audit` or :c:func:`PySys_Audit` calls throughout the CPython runtime and the -standard library. These calls were added in 3.8.0 or later. +standard library. These calls were added in 3.8.0 or later (see :pep:`578`). See :func:`sys.addaudithook` and :c:func:`PySys_AddAuditHook` for information on handling these events. diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst index 0667a60..8a03b73 100644 --- a/Doc/library/stdtypes.rst +++ b/Doc/library/stdtypes.rst @@ -5044,6 +5044,9 @@ environment. Code objects are returned by the built-in :func:`compile` function and can be extracted from function objects through their :attr:`__code__` attribute. See also the :mod:`code` module. +Accessing ``__code__`` raises an :ref:`auditing event <auditing>` +``object.__getattr__`` with arguments ``obj`` and ``"__code__"``. + .. index:: builtin: exec builtin: eval diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst index 46ee8ec..4030123 100644 --- a/Doc/reference/datamodel.rst +++ b/Doc/reference/datamodel.rst @@ -1005,6 +1005,9 @@ Internal types :attr:`f_lasti` gives the precise instruction (this is an index into the bytecode string of the code object). + Accessing ``f_code`` raises an :ref:`auditing event <auditing>` + ``object.__getattr__`` with arguments ``obj`` and ``"f_code"``. + .. index:: single: f_trace (frame attribute) single: f_trace_lines (frame attribute) @@ -1089,6 +1092,9 @@ Internal types :keyword:`try` statement with no matching except clause or with a finally clause. + Accessing ``tb_frame`` raises an :ref:`auditing event <auditing>` + ``object.__getattr__`` with arguments ``obj`` and ``"tb_frame"``. + .. index:: single: tb_next (traceback attribute) |