Thanks to visit codestin.com
Credit goes to github.com

Skip to content

gh-110722: Add PYTHON_PRESITE to import a module before site.py is run #110769

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
ambv merged 10 commits into from
Oct 14, 2023
Merged

gh-110722: Add PYTHON_PRESITE to import a module before site.py is run #110769

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
3daa65a
gh-110722: Add PYTHON_PRESITE=package.module to import a module befor…
ambv Oct 12, 2023
1ef282b
Add Blurb and fix a refleak before anybody notices
ambv Oct 12, 2023
8a201b4
Fix versionadded
ambv Oct 12, 2023
f192e38
Merge branch 'main' into gh-110722-presite
ambv Oct 13, 2023
b89548d
Add test, refine docs, add whatsnew, separate run_presite in pylifecy…
ambv Oct 13, 2023
ebcc373
PEP 7
ambv Oct 13, 2023
bebb594
Only define the static function --with-pydebug
ambv Oct 13, 2023
08679d8
Fix visual indentation
ambv Oct 13, 2023
3d3f5d3
Mention PYTHON_PRESITE needs a pydebug build
ambv Oct 13, 2023
2e1d180
Address Victor's nits
ambv Oct 14, 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
Add Blurb and fix a refleak before anybody notices
  • Loading branch information
@ambv
ambv committed Oct 12, 2023
commit 1ef282b75e78dce1cc035a24746a49c5c2eaae04
16 changes: 16 additions & 0 deletions Doc/using/cmdline.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -552,6 +552,10 @@ Miscellaneous options
This option may be useful for users who need to limit CPU resources of a
container system. See also :envvar:`PYTHON_CPU_COUNT`.
If *n* is ``default``, nothing is overridden.
* :samp:`-X presite={package.module}` specifies a module that should be
imported before ``site.py`` is executed. Python needs to be
:ref:`built in debug mode <debug-build>` for this option to exist.
See also :envvar:`PYTHON_PRESITE <PYTHON_PRESITE=package.module>`.

It also allows passing arbitrary values and retrieving them through the
:data:`sys._xoptions` dictionary.
Expand Down Expand Up @@ -602,6 +606,8 @@ Miscellaneous options
.. versionadded:: 3.13
The ``-X cpu_count`` option.

The ``-X presite`` option.


Options you shouldn't use
~~~~~~~~~~~~~~~~~~~~~~~~~
Expand Down Expand Up @@ -1100,3 +1106,13 @@ Debug-mode variables
Need Python configured with the :option:`--with-trace-refs` build option.

.. versionadded:: 3.11

.. envvar:: PYTHON_PRESITE=package.module
Comment thread
ambv marked this conversation as resolved.
Outdated

If this variable is set to a module, that module will be imported
early in the interpreter lifecycle, before ``site.py`` is executed.

See also the :option:`-X presite <-X>` command-line option,
which takes precedence over this variable.

.. versionadded:: 3.13
3 changes: 3 additions & 0 deletions Misc/NEWS.d/next/Core and Builtins/2023-10-12-17-15-23.gh-issue-110722.sjMwQe.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
Add :envvar:`PYTHON_PRESITE=package.module` to import a module early in the
interpreter lifecycle before ``site.py`` is executed. Python needs to be
:ref:`built in debug mode <debug-build>` for this option to exist.
3 changes: 3 additions & 0 deletions Python/initconfig.c
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -305,6 +305,9 @@ static const char usage_envvars[] =
#ifdef Py_STATS
"PYTHONSTATS : turns on statistics gathering\n"
#endif
#ifdef Py_DEBUG
"PYTHON_PRESITE=pkg.mod : import this module before site.py is run\n"
#endif
;

#if defined(MS_WINDOWS)
Expand Down
3 changes: 2 additions & 1 deletion Python/pylifecycle.c
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1170,10 +1170,11 @@ init_interp_main(PyThreadState *tstate)
else {
PyObject *presite = PyImport_Import(presite_modname);
if (presite == NULL) {
fprintf(stderr, "pre-site import failed; traceback:\n");
fprintf(stderr, "pre-site import failed:\n");
_PyErr_Print(tstate);
}
Py_XDECREF(presite);
Py_DECREF(presite_modname);
}
}
#endif
Expand Down