bpo-32043: Rephrase -X dev documentation #4478
Conversation
Doc/using/cmdline.rst
Outdated
| when an isuse is detected. In short, ``python3 -X dev ...`` behaves as | ||
| ``PYTHONMALLOC=debug PYTHONASYNCIODEBUG=1 python3 -W default -X faulthandler ...``, | ||
| except that the :envvar:`PYTHONMALLOC` and :envvar:`PYTHONASYNCIODEBUG` | ||
| environment variables are not set in practice. Effect of the developer |
There was a problem hiding this comment.
Speaking of which, perhaps it would be nice to set those environment variables so that child processes launched using subprocess inherit them?
There was a problem hiding this comment.
Or perhaps let people set them themselves if they want to...
There was a problem hiding this comment.
It's a deliberate choice to not inherit the "developer mode" to child processes. If someone would like an inherited mode, I would prefer to add a new PYTHONDEVMODE=1 environment variable, since it's more natural to inherit environment modes.
It's the same for -W ignore vs PYTHONWARNINGS=ignore.
There was a problem hiding this comment.
Do you think that PYTHONDEVMODE=1 is needed?
There was a problem hiding this comment.
Perhaps PYTHONXOPTIONS=dev? That way it would more directly parallel the -W vs PYTHONWARNINGS arrangement.
Doc/using/cmdline.rst
Outdated
| and :envvar:`PYTHONASYNCIODEBUG` environment variables are not set in | ||
| practice. Developer mode: | ||
| * ``-X dev``: enable the "developer mode", enable runtime debug checks which | ||
| are too expensive to be enabled by default. It should not be more verbose |
There was a problem hiding this comment.
enable CPython's "developer mode", introducing additional runtime checks which are ...
Doc/using/cmdline.rst
Outdated
| * ``-X dev``: enable the "developer mode", enable runtime debug checks which | ||
| are too expensive to be enabled by default. It should not be more verbose | ||
| than the default if the code is correct: new warnings are only emitted | ||
| when an isuse is detected. In short, ``python3 -X dev ...`` behaves as |
* should not be more verbose if the code is correct * enabled checks can be "expensive"
|
I created bpo-32101: Add PYTHONDEVMODE=1 to enable the developer mode. |
https://bugs.python.org/issue32043