]> git.ipfire.org Git - thirdparty/Python/cpython.git/commit
gh-108753: Enhance pystats (#108754)
authorVictor Stinner <vstinner@python.org>
Wed, 6 Sep 2023 15:54:59 +0000 (17:54 +0200)
committerGitHub <noreply@github.com>
Wed, 6 Sep 2023 15:54:59 +0000 (15:54 +0000)
commita0773b89dfe5cd2190d539905dd89e7f6455668e
treee11c7306e6ed7750265eda6ba8fa49f329bc0f85
parent8ff11425783806f8cb78e99f667546b1f7f3428e
gh-108753: Enhance pystats (#108754)

Statistics gathering is now off by default. Use the "-X pystats"
command line option or set the new PYTHONSTATS environment variable
to 1 to turn statistics gathering on at Python startup.

Statistics are no longer dumped at exit if statistics gathering was
off or statistics have been cleared.

Changes:

* Add PYTHONSTATS environment variable.
* sys._stats_dump() now returns False if statistics are not dumped
  because they are all equal to zero.
* Add PyConfig._pystats member.
* Add tests on sys functions and on setting PyConfig._pystats to 1.
* Add Include/cpython/pystats.h and Include/internal/pycore_pystats.h
  header files.
* Rename '_py_stats' variable to '_Py_stats'.
* Exclude Include/cpython/pystats.h from the Py_LIMITED_API.
* Move pystats.h include from object.h to Python.h.
* Add _Py_StatsOn() and _Py_StatsOff() functions. Remove
  '_py_stats_struct' variable from the API: make it static in
  specialize.c.
* Document API in Include/pystats.h and Include/cpython/pystats.h.
* Complete pystats documentation in Doc/using/configure.rst.
* Don't write "all zeros" stats: if _stats_off() and _stats_clear()
  or _stats_dump() were called.
* _PyEval_Fini() now always call _Py_PrintSpecializationStats() which
  does nothing if stats are all zeros.

Co-authored-by: Michael Droettboom <mdboom@gmail.com>
19 files changed:
Doc/using/configure.rst
Include/cpython/initconfig.h
Include/cpython/pystats.h [new file with mode: 0644]
Include/internal/pycore_code.h
Include/internal/pycore_pystats.h [new file with mode: 0644]
Include/pystats.h
Lib/test/test_embed.py
Lib/test/test_sys.py
Makefile.pre.in
Modules/gcmodule.c
PCbuild/pythoncore.vcxproj
PCbuild/pythoncore.vcxproj.filters
Programs/_testembed.c
Python/ceval_gil.c
Python/ceval_macros.h
Python/clinic/sysmodule.c.h
Python/initconfig.c
Python/specialize.c
Python/sysmodule.c