From 700d2e4755921d6c339ff20dacecde1aea64de34 Mon Sep 17 00:00:00 2001 From: Barry Warsaw Date: Thu, 2 Nov 2017 16:13:36 -0700 Subject: bpo-31415: Support PYTHONPROFILEIMPORTTIME envvar equivalent to -X importtime (#4240) Support PYTHONPROFILEIMPORTTIME envvar equivalent to -X importtime --- Doc/using/cmdline.rst | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) (limited to 'Doc/using') diff --git a/Doc/using/cmdline.rst b/Doc/using/cmdline.rst index 8ab26f5955..310891d6d0 100644 --- a/Doc/using/cmdline.rst +++ b/Doc/using/cmdline.rst @@ -411,7 +411,8 @@ Miscellaneous options * ``-X importtime`` to show how long each import takes. It shows module name, cumulative time (including nested imports) and self time (exluding nested imports). Note that its output may be broken in multi threaded application. - Typical usage is ``python3 -X importtime -c 'import asyncio'``. + Typical usage is ``python3 -X importtime -c 'import asyncio'``. See also + :envvar:`PYTHONPROFILEIMPORTTIME`. It also allows passing arbitrary values and retrieving them through the :data:`sys._xoptions` dictionary. @@ -429,7 +430,7 @@ Miscellaneous options The ``-X showalloccount`` option. .. versionadded:: 3.7 - The ``-X importtime`` option. + The ``-X importtime`` and :envvar:`PYTHONPROFILEIMPORTTIME` options. Options you shouldn't use @@ -650,6 +651,15 @@ conflict. .. versionadded:: 3.4 +.. envvar:: PYTHONPROFILEIMPORTTIME + + If this environment variable is set to a non-empty string, Python will + show how long each import takes. This is exactly equivalent to setting + ``-X importtime`` on the command line. + + .. versionadded:: 3.7 + + .. envvar:: PYTHONASYNCIODEBUG If this environment variable is set to a non-empty string, enable the -- cgit v1.2.1