Skip to content

GH-103082: Document PEP-669: Low Impact Monitoring for CPython #107772

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
markshannon merged 18 commits into from
Sep 5, 2023
Merged

GH-103082: Document PEP-669: Low Impact Monitoring for CPython #107772

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
22e5d83
Add what's new for PEP 669
markshannon Aug 4, 2023
6e5a435
Document sys.monitoring. First draft.
markshannon Aug 4, 2023
e373cbe
Fix sphinx errors
markshannon Aug 5, 2023
c648e70
Address review comments
markshannon Aug 28, 2023
ed94e2e
Merge branch 'main' into doc-669
markshannon Aug 28, 2023
c15022c
Use add more cross-references
markshannon Aug 28, 2023
5d54704
Fix note
markshannon Aug 28, 2023
7a500bd
Fix lint
markshannon Aug 28, 2023
bb4100c
Fix lint
markshannon Aug 28, 2023
181843e
Another attempt to fix the syntax
markshannon Aug 28, 2023
200e4a3
Remove double space
markshannon Sep 5, 2023
fb16167
Update Doc/library/sys.monitoring.rst
markshannon Sep 5, 2023
bfb3b1d
Update Doc/library/sys.monitoring.rst
markshannon Sep 5, 2023
0833922
Update Doc/library/sys.monitoring.rst
markshannon Sep 5, 2023
6364315
Update Doc/library/sys.monitoring.rst
markshannon Sep 5, 2023
4894333
Update Doc/library/sys.monitoring.rst
markshannon Sep 5, 2023
a943679
Apply suggestions from code review
markshannon Sep 5, 2023
002e744
Drop use of range(6) to avoid confusing sphinx
markshannon Sep 5, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Fix sphinx errors
  • Loading branch information
@markshannon
markshannon committed Aug 5, 2023
commit e373cbe678ee16518b9be02859fb1c320508c42d
1 change: 1 addition & 0 deletions Doc/library/python.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ overview:
.. toctree::

sys.rst
sys.monitoring.rst
sysconfig.rst
builtins.rst
__main__.rst
Expand Down
7 changes: 4 additions & 3 deletions Doc/library/sys.monitoring.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
====================================================

.. module:: sys.monitoring

:synopsis: Access and control event monitoring

.. note::
Expand All @@ -16,7 +17,7 @@ This namespace provides access to the functions and constants necessary to
activate and control event monitoring.

As programs execute, events occur that might be of interest to tools that
monitor execution. The `mod:`sys.monitoring` namespace provides means to
monitor execution. The :mod:`sys.monitoring` namespace provides means to
Comment thread
markshannon marked this conversation as resolved.
Outdated
receive callbacks when events of interest occur.

The monitoring API consists of three components:
Expand Down Expand Up @@ -86,7 +87,7 @@ The following events are supported:

More events may be added in the future.

These events are attributes of the `:mod:sys.monitoring.events` namespace.
These events are attributes of the :mod:`sys.monitoring.events` namespace.
Comment thread
markshannon marked this conversation as resolved.
Outdated
Each event is represented as a power-of-2 integer constant.
To define a set of events, simply bitwise or the individual events together.
For example, to specify both ``PY_RETURN`` and ``PY_START`` events, use the
Expand Down Expand Up @@ -196,7 +197,7 @@ Disabling events
''''''''''''''''

Local events can be disabled for a specific code location by returning
`sys.monitoring.DISABLE` from a callback function. This does not change
``sys.monitoring.DISABLE`` from a callback function. This does not change
which events are set, or any other code locations for the same event.

Disabling events for specific locations is very important for high
Expand Down
1 change: 1 addition & 0 deletions Doc/library/sys.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1881,6 +1881,7 @@ always available.


.. data:: monitoring
:noindex:

Namespace containing functions and constants for register callbacks
and controlling monitoring events.
Expand Down
2 changes: 1 addition & 1 deletion Doc/whatsnew/3.12.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -312,7 +312,7 @@ A Python API is anticipated for 3.13. (See :pep:`554`.)

(Contributed by Eric Snow in :gh:`104210`, etc.)

.. _whatsnew312-pep684:
.. _whatsnew312-pep669:

PEP 669: Low impact monitoring for CPython
------------------------------------------
Expand Down