mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-08-03 00:23:06 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 6

issue 9910

Browse source 
Add a Py_SetPath api to override magic path computations when starting up python.
This commit is contained in:
Kristján Valur Jónsson 2010-09-27 05:32:54 +00:00
parent 42ef4b1f4c
commit 3b69db27d7
4 changed files with 68 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

25
Doc/c-api/init.rst
View file

@ -27,8 +27,9 @@ Initialization, Finalization, and Threads
Initialize the Python interpreter. In an application embedding Python, this
should be called before using any other Python/C API functions; with the
exception of :cfunc:`Py_SetProgramName`, :cfunc:`PyEval_InitThreads`,
:cfunc:`PyEval_ReleaseLock`, and :cfunc:`PyEval_AcquireLock`. This initializes
exception of :cfunc:`Py_SetProgramName`, :cfunc:`Py_SetPath`,
:cfunc:`PyEval_InitThreads`, :cfunc:`PyEval_ReleaseLock`, and
:cfunc:`PyEval_AcquireLock`. This initializes
the table of loaded modules (``sys.modules``), and creates the fundamental
modules :mod:`builtins`, :mod:`__main__` and :mod:`sys`. It also initializes
the module search path (``sys.path``). It does not set ``sys.argv``; use
@ -256,6 +257,7 @@ Initialization, Finalization, and Threads
.. index::
triple: module; search; path
single: path (in module sys)
single: Py_SetPath()
Return the default module search path; this is computed from the program name
(set by :cfunc:`Py_SetProgramName` above) and some environment variables.
@ -270,6 +272,25 @@ Initialization, Finalization, and Threads
.. XXX should give the exact rules
.. cfunction:: void Py_SetPath(const wchar_t *)
.. index::
triple: module; search; path
single: path (in module sys)
single: Py_GetPath()
Set the default module search path. If this function is called before
:cfunc: `Py_Initialize` then :cfunc: Py_GetPath won't attempt to compute
a default serarch path but uses the provided one in stead. This is useful
if Python is being embedded by an application that has full knowledge
of the location of all modules. The path components should be separated
by semicolons.
This also causes `sys.executable` to be set only to the raw program name
(see :cfunc:`Py_SetProgramName`) and `for sys.prefix` and
`sys.exec_prefix` to be empty. It is up to the caller to modify these if
required after calling :cfunc: `Py_Initialize`.
.. cfunction:: const char* Py_GetVersion()
Return the version of this Python interpreter. This is a string that looks