python-docs-fr/c-api/init_config.po

1385 lines
36 KiB
Plaintext
Raw Normal View History

# Copyright (C) 2001-2018, Python Software Foundation
# For licence information, see README file.
2019-09-04 09:39:22 +00:00
#
msgid ""
msgstr ""
2019-12-05 22:15:54 +00:00
"Project-Id-Version: Python 3\n"
2019-09-04 09:39:22 +00:00
"Report-Msgid-Bugs-To: \n"
2020-09-11 07:11:46 +00:00
"POT-Creation-Date: 2020-08-24 09:01+0200\n"
"PO-Revision-Date: 2019-09-04 11:42+0200\n"
2019-09-04 09:39:22 +00:00
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
"Language: fr\n"
2019-09-04 09:39:22 +00:00
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: c-api/init_config.rst:7
2019-09-04 09:39:22 +00:00
msgid "Python Initialization Configuration"
msgstr ""
#: c-api/init_config.rst:11
2019-09-04 09:39:22 +00:00
msgid "Structures:"
msgstr ""
#: c-api/init_config.rst:13
2019-09-04 09:39:22 +00:00
msgid ":c:type:`PyConfig`"
msgstr ""
#: c-api/init_config.rst:14
2019-09-04 09:39:22 +00:00
msgid ":c:type:`PyPreConfig`"
msgstr ""
#: c-api/init_config.rst:15
2019-09-04 09:39:22 +00:00
msgid ":c:type:`PyStatus`"
msgstr ""
#: c-api/init_config.rst:16
2019-09-04 09:39:22 +00:00
msgid ":c:type:`PyWideStringList`"
msgstr ""
#: c-api/init_config.rst:18
2020-02-14 10:18:53 +00:00
#, fuzzy
2019-09-04 09:39:22 +00:00
msgid "Functions:"
2020-02-14 10:18:53 +00:00
msgstr "Fonctions"
2019-09-04 09:39:22 +00:00
#: c-api/init_config.rst:20
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyConfig_Clear`"
msgstr ""
#: c-api/init_config.rst:21
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyConfig_InitIsolatedConfig`"
msgstr ""
#: c-api/init_config.rst:22
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyConfig_InitPythonConfig`"
msgstr ""
#: c-api/init_config.rst:23
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyConfig_Read`"
msgstr ""
#: c-api/init_config.rst:24
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyConfig_SetArgv`"
msgstr ""
#: c-api/init_config.rst:25
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyConfig_SetBytesArgv`"
msgstr ""
#: c-api/init_config.rst:26
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyConfig_SetBytesString`"
msgstr ""
#: c-api/init_config.rst:27
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyConfig_SetString`"
msgstr ""
#: c-api/init_config.rst:28
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyConfig_SetWideStringList`"
msgstr ""
#: c-api/init_config.rst:29
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyPreConfig_InitIsolatedConfig`"
msgstr ""
#: c-api/init_config.rst:30
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyPreConfig_InitPythonConfig`"
msgstr ""
#: c-api/init_config.rst:31
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyStatus_Error`"
msgstr ""
#: c-api/init_config.rst:32
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyStatus_Exception`"
msgstr ""
#: c-api/init_config.rst:33
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyStatus_Exit`"
msgstr ""
#: c-api/init_config.rst:34
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyStatus_IsError`"
msgstr ""
#: c-api/init_config.rst:35
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyStatus_IsExit`"
msgstr ""
#: c-api/init_config.rst:36
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyStatus_NoMemory`"
msgstr ""
#: c-api/init_config.rst:37
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyStatus_Ok`"
msgstr ""
#: c-api/init_config.rst:38
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyWideStringList_Append`"
msgstr ""
#: c-api/init_config.rst:39
2019-09-04 09:39:22 +00:00
msgid ":c:func:`PyWideStringList_Insert`"
msgstr ""
#: c-api/init_config.rst:40
2019-09-04 09:39:22 +00:00
msgid ":c:func:`Py_ExitStatusException`"
msgstr ""
#: c-api/init_config.rst:41
2019-09-04 09:39:22 +00:00
msgid ":c:func:`Py_InitializeFromConfig`"
msgstr ""
#: c-api/init_config.rst:42
2019-09-04 09:39:22 +00:00
msgid ":c:func:`Py_PreInitialize`"
msgstr ""
#: c-api/init_config.rst:43
2019-09-04 09:39:22 +00:00
msgid ":c:func:`Py_PreInitializeFromArgs`"
msgstr ""
#: c-api/init_config.rst:44
2019-09-04 09:39:22 +00:00
msgid ":c:func:`Py_PreInitializeFromBytesArgs`"
msgstr ""
#: c-api/init_config.rst:45
2019-09-04 09:39:22 +00:00
msgid ":c:func:`Py_RunMain`"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:46
msgid ":c:func:`Py_GetArgcArgv`"
msgstr ""
#: c-api/init_config.rst:48
2019-09-04 09:39:22 +00:00
msgid ""
"The preconfiguration (``PyPreConfig`` type) is stored in ``_PyRuntime."
"preconfig`` and the configuration (``PyConfig`` type) is stored in "
"``PyInterpreterState.config``."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:52
2019-09-04 09:39:22 +00:00
msgid ""
"See also :ref:`Initialization, Finalization, and Threads <initialization>`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:55
2019-09-04 09:39:22 +00:00
msgid ":pep:`587` \"Python Initialization Configuration\"."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:59
2019-09-04 09:39:22 +00:00
msgid "PyWideStringList"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:63
2019-09-04 09:39:22 +00:00
msgid "List of ``wchar_t*`` strings."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:65
2019-09-04 09:39:22 +00:00
msgid ""
"If *length* is non-zero, *items* must be non-``NULL`` and all strings must "
"be non-``NULL``."
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:68
2020-02-14 10:18:53 +00:00
#, fuzzy
2019-09-04 09:39:22 +00:00
msgid "Methods:"
2020-02-14 10:18:53 +00:00
msgstr "Méthodes"
2019-09-04 09:39:22 +00:00
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:72
2019-09-04 09:39:22 +00:00
msgid "Append *item* to *list*."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:74 c-api/init_config.rst:85
2019-09-04 09:39:22 +00:00
msgid "Python must be preinitialized to call this function."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:78
2019-09-04 09:39:22 +00:00
msgid "Insert *item* into *list* at *index*."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:80
2019-09-04 09:39:22 +00:00
msgid ""
"If *index* is greater than or equal to *list* length, append *item* to "
"*list*."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:83
2019-09-04 09:39:22 +00:00
msgid "*index* must be greater than or equal to 0."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:87 c-api/init_config.rst:107 c-api/init_config.rst:210
#: c-api/init_config.rst:417
2019-09-04 09:39:22 +00:00
msgid "Structure fields:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:91
2019-09-04 09:39:22 +00:00
msgid "List length."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:95
2019-09-04 09:39:22 +00:00
msgid "List items."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:98
2019-09-04 09:39:22 +00:00
msgid "PyStatus"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:102
2019-09-04 09:39:22 +00:00
msgid ""
"Structure to store an initialization function status: success, error or exit."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:105
2019-09-04 09:39:22 +00:00
msgid "For an error, it can store the C function name which created the error."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:111
2019-09-04 09:39:22 +00:00
msgid "Exit code. Argument passed to ``exit()``."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:115
2019-09-04 09:39:22 +00:00
msgid "Error message."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:119
2019-09-04 09:39:22 +00:00
msgid "Name of the function which created an error, can be ``NULL``."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:121
2019-09-04 09:39:22 +00:00
msgid "Functions to create a status:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:125
2019-09-04 09:39:22 +00:00
msgid "Success."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:129
2019-09-04 09:39:22 +00:00
msgid "Initialization error with a message."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:133
2019-09-04 09:39:22 +00:00
msgid "Memory allocation failure (out of memory)."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:137
2019-09-04 09:39:22 +00:00
msgid "Exit Python with the specified exit code."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:139
2019-09-04 09:39:22 +00:00
msgid "Functions to handle a status:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:143
2019-09-04 09:39:22 +00:00
msgid ""
"Is the status an error or an exit? If true, the exception must be handled; "
"by calling :c:func:`Py_ExitStatusException` for example."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:148
2019-09-04 09:39:22 +00:00
msgid "Is the result an error?"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:152
2019-09-04 09:39:22 +00:00
msgid "Is the result an exit?"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:156
2019-09-04 09:39:22 +00:00
msgid ""
"Call ``exit(exitcode)`` if *status* is an exit. Print the error message and "
"exit with a non-zero exit code if *status* is an error. Must only be called "
"if ``PyStatus_Exception(status)`` is non-zero."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:161
2019-09-04 09:39:22 +00:00
msgid ""
"Internally, Python uses macros which set ``PyStatus.func``, whereas "
"functions to create a status set ``func`` to ``NULL``."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:164
2019-09-04 09:39:22 +00:00
msgid "Example::"
2019-09-16 10:08:42 +00:00
msgstr "Exemple ::"
2019-09-04 09:39:22 +00:00
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:188
2019-09-04 09:39:22 +00:00
msgid "PyPreConfig"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:192
2019-09-04 09:39:22 +00:00
msgid "Structure used to preinitialize Python:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:194
2019-09-04 09:39:22 +00:00
msgid "Set the Python memory allocator"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:195
2019-09-04 09:39:22 +00:00
msgid "Configure the LC_CTYPE locale"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:196
2019-09-04 09:39:22 +00:00
msgid "Set the UTF-8 mode"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:198
2019-09-04 09:39:22 +00:00
msgid "Function to initialize a preconfiguration:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:202
2019-09-04 09:39:22 +00:00
msgid ""
"Initialize the preconfiguration with :ref:`Python Configuration <init-python-"
"config>`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:207
2019-09-04 09:39:22 +00:00
msgid ""
"Initialize the preconfiguration with :ref:`Isolated Configuration <init-"
"isolated-conf>`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:214
2019-09-04 09:39:22 +00:00
msgid "Name of the memory allocator:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:216
2019-09-04 09:39:22 +00:00
msgid ""
"``PYMEM_ALLOCATOR_NOT_SET`` (``0``): don't change memory allocators (use "
"defaults)"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:218
2019-09-04 09:39:22 +00:00
msgid "``PYMEM_ALLOCATOR_DEFAULT`` (``1``): default memory allocators"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:219
2019-09-04 09:39:22 +00:00
msgid ""
"``PYMEM_ALLOCATOR_DEBUG`` (``2``): default memory allocators with debug hooks"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:221
2019-09-04 09:39:22 +00:00
msgid "``PYMEM_ALLOCATOR_MALLOC`` (``3``): force usage of ``malloc()``"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:222
2019-09-04 09:39:22 +00:00
msgid ""
"``PYMEM_ALLOCATOR_MALLOC_DEBUG`` (``4``): force usage of ``malloc()`` with "
"debug hooks"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:224
2019-09-04 09:39:22 +00:00
msgid ""
"``PYMEM_ALLOCATOR_PYMALLOC`` (``5``): :ref:`Python pymalloc memory allocator "
"<pymalloc>`"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:226
2019-09-04 09:39:22 +00:00
msgid ""
"``PYMEM_ALLOCATOR_PYMALLOC_DEBUG`` (``6``): :ref:`Python pymalloc memory "
"allocator <pymalloc>` with debug hooks"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:229
2019-09-04 09:39:22 +00:00
msgid ""
"``PYMEM_ALLOCATOR_PYMALLOC`` and ``PYMEM_ALLOCATOR_PYMALLOC_DEBUG`` are not "
"supported if Python is configured using ``--without-pymalloc``"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:232
2019-09-04 09:39:22 +00:00
msgid "See :ref:`Memory Management <memory>`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:236
2019-09-04 09:39:22 +00:00
msgid ""
"Set the LC_CTYPE locale to the user preferred locale? If equals to 0, set :c:"
"member:`coerce_c_locale` and :c:member:`coerce_c_locale_warn` to 0."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:241
2019-09-04 09:39:22 +00:00
msgid ""
"If equals to 2, coerce the C locale; if equals to 1, read the LC_CTYPE "
"locale to decide if it should be coerced."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:246
2019-10-09 16:10:12 +00:00
msgid "If non-zero, emit a warning if the C locale is coerced."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:250
2019-09-04 09:39:22 +00:00
msgid "See :c:member:`PyConfig.dev_mode`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:254
2019-09-04 09:39:22 +00:00
msgid "See :c:member:`PyConfig.isolated`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:258
2019-09-04 09:39:22 +00:00
msgid ""
"If non-zero, disable UTF-8 Mode, set the Python filesystem encoding to "
"``mbcs``, set the filesystem error handler to ``replace``."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:261 c-api/init_config.rst:555
2019-09-04 09:39:22 +00:00
msgid ""
"Only available on Windows. ``#ifdef MS_WINDOWS`` macro can be used for "
"Windows specific code."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:266
2019-09-04 09:39:22 +00:00
msgid ""
"If non-zero, :c:func:`Py_PreInitializeFromArgs` and :c:func:"
"`Py_PreInitializeFromBytesArgs` parse their ``argv`` argument the same way "
"the regular Python parses command line arguments: see :ref:`Command Line "
"Arguments <using-on-cmdline>`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:273
2019-09-04 09:39:22 +00:00
msgid "See :c:member:`PyConfig.use_environment`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:277
2019-09-04 09:39:22 +00:00
msgid "If non-zero, enable the UTF-8 mode."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:280
2019-09-04 09:39:22 +00:00
msgid "Preinitialization with PyPreConfig"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:282
2019-09-04 09:39:22 +00:00
msgid "Functions to preinitialize Python:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:286
2019-09-04 09:39:22 +00:00
msgid "Preinitialize Python from *preconfig* preconfiguration."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:290
2019-09-04 09:39:22 +00:00
msgid ""
"Preinitialize Python from *preconfig* preconfiguration and command line "
"arguments (bytes strings)."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:295
2019-09-04 09:39:22 +00:00
msgid ""
"Preinitialize Python from *preconfig* preconfiguration and command line "
"arguments (wide strings)."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:298 c-api/init_config.rst:730
2019-09-04 09:39:22 +00:00
msgid ""
"The caller is responsible to handle exceptions (error or exit) using :c:func:"
"`PyStatus_Exception` and :c:func:`Py_ExitStatusException`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:301
2019-09-04 09:39:22 +00:00
msgid ""
"For :ref:`Python Configuration <init-python-config>` (:c:func:"
"`PyPreConfig_InitPythonConfig`), if Python is initialized with command line "
"arguments, the command line arguments must also be passed to preinitialize "
"Python, since they have an effect on the pre-configuration like encodings. "
2019-10-09 16:10:12 +00:00
"For example, the :option:`-X utf8 <-X>` command line option enables the "
"UTF-8 Mode."
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:308
2019-09-04 09:39:22 +00:00
msgid ""
"``PyMem_SetAllocator()`` can be called after :c:func:`Py_PreInitialize` and "
"before :c:func:`Py_InitializeFromConfig` to install a custom memory "
"allocator. It can be called before :c:func:`Py_PreInitialize` if :c:member:"
"`PyPreConfig.allocator` is set to ``PYMEM_ALLOCATOR_NOT_SET``."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:313
2019-09-04 09:39:22 +00:00
msgid ""
"Python memory allocation functions like :c:func:`PyMem_RawMalloc` must not "
"be used before Python preinitialization, whereas calling directly "
"``malloc()`` and ``free()`` is always safe. :c:func:`Py_DecodeLocale` must "
"not be called before the preinitialization."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:318
2019-09-04 09:39:22 +00:00
msgid "Example using the preinitialization to enable the UTF-8 Mode::"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:339
2019-09-04 09:39:22 +00:00
msgid "PyConfig"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:343
2019-09-04 09:39:22 +00:00
msgid "Structure containing most parameters to configure Python."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:345
2019-09-04 09:39:22 +00:00
msgid "Structure methods:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:349
2019-09-04 09:39:22 +00:00
msgid ""
"Initialize configuration with :ref:`Python Configuration <init-python-"
"config>`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:354
2019-09-04 09:39:22 +00:00
msgid ""
"Initialize configuration with :ref:`Isolated Configuration <init-isolated-"
"conf>`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:359
2019-09-04 09:39:22 +00:00
msgid "Copy the wide character string *str* into ``*config_str``."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:361 c-api/init_config.rst:367
#: c-api/init_config.rst:373 c-api/init_config.rst:379
#: c-api/init_config.rst:385 c-api/init_config.rst:393
2019-09-04 09:39:22 +00:00
msgid "Preinitialize Python if needed."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:365
2019-09-04 09:39:22 +00:00
msgid ""
"Decode *str* using ``Py_DecodeLocale()`` and set the result into "
"``*config_str``."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:371
2019-09-04 09:39:22 +00:00
msgid "Set command line arguments from wide character strings."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:377
2019-09-04 09:39:22 +00:00
msgid ""
"Set command line arguments: decode bytes using :c:func:`Py_DecodeLocale`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:383
2019-09-04 09:39:22 +00:00
msgid "Set the list of wide strings *list* to *length* and *items*."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:389
2019-09-04 09:39:22 +00:00
msgid "Read all Python configuration."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:391
2019-09-04 09:39:22 +00:00
msgid "Fields which are already initialized are left unchanged."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:397
2019-09-04 09:39:22 +00:00
msgid "Release configuration memory."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:399
2019-09-04 09:39:22 +00:00
msgid ""
"Most ``PyConfig`` methods preinitialize Python if needed. In that case, the "
"Python preinitialization configuration in based on the :c:type:`PyConfig`. "
"If configuration fields which are in common with :c:type:`PyPreConfig` are "
"tuned, they must be set before calling a :c:type:`PyConfig` method:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:404
2019-09-04 09:39:22 +00:00
msgid ":c:member:`~PyConfig.dev_mode`"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:405
2019-09-04 09:39:22 +00:00
msgid ":c:member:`~PyConfig.isolated`"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:406
2019-09-04 09:39:22 +00:00
msgid ":c:member:`~PyConfig.parse_argv`"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:407
2019-09-04 09:39:22 +00:00
msgid ":c:member:`~PyConfig.use_environment`"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:409
2019-09-04 09:39:22 +00:00
msgid ""
"Moreover, if :c:func:`PyConfig_SetArgv` or :c:func:`PyConfig_SetBytesArgv` "
"is used, this method must be called first, before other methods, since the "
"preinitialization configuration depends on command line arguments (if :c:"
"member:`parse_argv` is non-zero)."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:414
2019-09-04 09:39:22 +00:00
msgid ""
"The caller of these methods is responsible to handle exceptions (error or "
"exit) using ``PyStatus_Exception()`` and ``Py_ExitStatusException()``."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:421
2019-09-04 09:39:22 +00:00
msgid ""
"Command line arguments, :data:`sys.argv`. See :c:member:`~PyConfig."
"parse_argv` to parse :c:member:`~PyConfig.argv` the same way the regular "
"Python parses Python command line arguments. If :c:member:`~PyConfig.argv` "
"is empty, an empty string is added to ensure that :data:`sys.argv` always "
"exists and is never empty."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:429
2019-09-04 09:39:22 +00:00
msgid ":data:`sys.base_exec_prefix`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:433
2019-10-09 16:10:12 +00:00
msgid ""
":data:`sys._base_executable`: ``__PYVENV_LAUNCHER__`` environment variable "
"value, or copy of :c:member:`PyConfig.executable`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:438
2019-09-04 09:39:22 +00:00
msgid ":data:`sys.base_prefix`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:442
msgid ""
":data:`sys.platlibdir`: platform library directory name, set at configure "
"time by ``--with-platlibdir``, overrideable by the ``PYTHONPLATLIBDIR`` "
"environment variable."
msgstr ""
#: c-api/init_config.rst:450
2019-09-04 09:39:22 +00:00
msgid ""
"If equals to 0, enable unbuffered mode, making the stdout and stderr streams "
"unbuffered."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:453
2019-09-04 09:39:22 +00:00
msgid "stdin is always opened in buffered mode."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:457
2019-09-04 09:39:22 +00:00
msgid ""
"If equals to 1, issue a warning when comparing :class:`bytes` or :class:"
"`bytearray` with :class:`str`, or comparing :class:`bytes` with :class:"
"`int`. If equal or greater to 2, raise a :exc:`BytesWarning` exception."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:464
2019-09-04 09:39:22 +00:00
msgid ""
"Control the validation behavior of hash-based ``.pyc`` files (see :pep:"
"`552`): :option:`--check-hash-based-pycs` command line option value."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:467
2019-09-04 09:39:22 +00:00
msgid "Valid values: ``always``, ``never`` and ``default``."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:469
2019-09-04 09:39:22 +00:00
msgid "The default value is: ``default``."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:473
2019-09-04 09:39:22 +00:00
msgid ""
"If non-zero, configure C standard streams (``stdio``, ``stdout``, "
"``stdout``). For example, set their mode to ``O_BINARY`` on Windows."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:478
msgid "If non-zero, enable the :ref:`Python Development Mode <devmode>`."
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:482
2019-09-04 09:39:22 +00:00
msgid "If non-zero, dump all objects which are still alive at exit."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:484
msgid "``Py_TRACE_REFS`` macro must be defined in build."
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:488
2019-09-04 09:39:22 +00:00
msgid ":data:`sys.exec_prefix`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:492
2019-09-04 09:39:22 +00:00
msgid ":data:`sys.executable`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:496
2019-10-09 16:10:12 +00:00
msgid "If non-zero, call :func:`faulthandler.enable` at startup."
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:500
2019-09-04 09:39:22 +00:00
msgid "Filesystem encoding, :func:`sys.getfilesystemencoding`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:504
2019-09-04 09:39:22 +00:00
msgid "Filesystem encoding errors, :func:`sys.getfilesystemencodeerrors`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:509
2019-09-04 09:39:22 +00:00
msgid "Randomized hash function seed."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:511
2019-09-04 09:39:22 +00:00
msgid ""
"If :c:member:`~PyConfig.use_hash_seed` is zero, a seed is chosen randomly at "
"Pythonstartup, and :c:member:`~PyConfig.hash_seed` is ignored."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:516
2019-09-04 09:39:22 +00:00
msgid "Python home directory."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:518
2019-10-09 16:10:12 +00:00
msgid ""
"Initialized from :envvar:`PYTHONHOME` environment variable value by default."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:523
2019-09-04 09:39:22 +00:00
msgid "If non-zero, profile import time."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:527
2019-09-04 09:39:22 +00:00
msgid "Enter interactive mode after executing a script or a command."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:531
2019-09-04 09:39:22 +00:00
msgid "Install signal handlers?"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:535
2020-02-14 10:18:53 +00:00
#, fuzzy
2019-09-04 09:39:22 +00:00
msgid "Interactive mode."
2020-02-14 10:18:53 +00:00
msgstr "Mode interactif"
2019-09-04 09:39:22 +00:00
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:539
2019-09-04 09:39:22 +00:00
msgid "If greater than 0, enable isolated mode:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:541
2019-09-04 09:39:22 +00:00
msgid ""
":data:`sys.path` contains neither the script's directory (computed from "
"``argv[0]`` or the current directory) nor the user's site-packages directory."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:544
2019-09-04 09:39:22 +00:00
msgid ""
"Python REPL doesn't import :mod:`readline` nor enable default readline "
"configuration on interactive prompts."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:546
2019-09-04 09:39:22 +00:00
msgid ""
"Set :c:member:`~PyConfig.use_environment` and :c:member:`~PyConfig."
"user_site_directory` to 0."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:551
2019-09-04 09:39:22 +00:00
msgid ""
"If non-zero, use :class:`io.FileIO` instead of :class:`io.WindowsConsoleIO` "
"for :data:`sys.stdin`, :data:`sys.stdout` and :data:`sys.stderr`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:560
2019-09-04 09:39:22 +00:00
msgid ""
"If non-zero, dump statistics on :ref:`Python pymalloc memory allocator "
"<pymalloc>` at exit."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:563
2019-09-04 09:39:22 +00:00
msgid "The option is ignored if Python is built using ``--without-pymalloc``."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:567
2019-09-04 09:39:22 +00:00
msgid ""
"Module search paths as a string separated by ``DELIM`` (:data:`os.path."
"pathsep`)."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:570
2019-09-04 09:39:22 +00:00
msgid ""
"Initialized from :envvar:`PYTHONPATH` environment variable value by default."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:576
2019-09-04 09:39:22 +00:00
msgid ""
":data:`sys.path`. If :c:member:`~PyConfig.module_search_paths_set` is equal "
"to 0, the :c:member:`~PyConfig.module_search_paths` is overridden by the "
2019-10-09 16:10:12 +00:00
"function calculating the :ref:`Path Configuration <init-path-config>`."
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:583
2019-09-04 09:39:22 +00:00
msgid "Compilation optimization level:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:585
2019-09-04 09:39:22 +00:00
msgid "0: Peephole optimizer (and ``__debug__`` is set to ``True``)"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:586
2019-09-04 09:39:22 +00:00
msgid "1: Remove assertions, set ``__debug__`` to ``False``"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:587
2019-09-04 09:39:22 +00:00
msgid "2: Strip docstrings"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:591
2019-09-04 09:39:22 +00:00
msgid ""
"If non-zero, parse :c:member:`~PyConfig.argv` the same way the regular "
"Python command line arguments, and strip Python arguments from :c:member:"
"`~PyConfig.argv`: see :ref:`Command Line Arguments <using-on-cmdline>`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:598
2019-09-04 09:39:22 +00:00
msgid ""
"If non-zero, turn on parser debugging output (for expert only, depending on "
"compilation options)."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:603
2019-09-04 09:39:22 +00:00
msgid ""
2019-10-09 16:10:12 +00:00
"If equal to 0, suppress warnings when calculating the :ref:`Path "
"Configuration <init-path-config>` (Unix only, Windows does not log any "
"warning). Otherwise, warnings are written into ``stderr``."
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:609
2019-09-04 09:39:22 +00:00
msgid ":data:`sys.prefix`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:613
2019-10-09 16:10:12 +00:00
msgid ""
"Program name. Used to initialize :c:member:`~PyConfig.executable`, and in "
"early error messages."
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:618
2019-10-09 16:10:12 +00:00
msgid ":data:`sys.pycache_prefix`: ``.pyc`` cache prefix."
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:620
msgid "If ``NULL``, :data:`sys.pycache_prefix` is set to ``None``."
2019-10-09 16:10:12 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:624
2019-09-04 09:39:22 +00:00
msgid ""
2019-10-09 16:10:12 +00:00
"Quiet mode. For example, don't display the copyright and version messages in "
"interactive mode."
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:629
2019-10-09 16:10:12 +00:00
msgid "``python3 -c COMMAND`` argument. Used by :c:func:`Py_RunMain`."
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:633
2019-10-09 16:10:12 +00:00
msgid "``python3 FILENAME`` argument. Used by :c:func:`Py_RunMain`."
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:637
2019-10-09 16:10:12 +00:00
msgid "``python3 -m MODULE`` argument. Used by :c:func:`Py_RunMain`."
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:641
2019-09-04 09:39:22 +00:00
msgid "Show total reference count at exit?"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:643
2019-10-09 16:10:12 +00:00
msgid "Set to 1 by :option:`-X showrefcount <-X>` command line option."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:645
2019-09-04 09:39:22 +00:00
msgid "Need a debug build of Python (``Py_REF_DEBUG`` macro must be defined)."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:649
2019-09-04 09:39:22 +00:00
msgid "Import the :mod:`site` module at startup?"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:653
2019-09-04 09:39:22 +00:00
msgid "Skip the first line of the source?"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:658
2019-09-04 09:39:22 +00:00
msgid ""
"Encoding and encoding errors of :data:`sys.stdin`, :data:`sys.stdout` and :"
"data:`sys.stderr`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:663
2019-10-09 16:10:12 +00:00
msgid "If non-zero, call :func:`tracemalloc.start` at startup."
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:667
2019-09-04 09:39:22 +00:00
msgid "If greater than 0, use :ref:`environment variables <using-on-envvars>`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:671
2019-09-04 09:39:22 +00:00
msgid "If non-zero, add user site directory to :data:`sys.path`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:675
2019-09-04 09:39:22 +00:00
msgid "If non-zero, enable verbose mode."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:679
2019-10-09 16:10:12 +00:00
msgid ""
":data:`sys.warnoptions`: options of the :mod:`warnings` module to build "
"warnings filters: lowest to highest priority."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:682
2019-10-09 16:10:12 +00:00
msgid ""
"The :mod:`warnings` module adds :data:`sys.warnoptions` in the reverse "
"order: the last :c:member:`PyConfig.warnoptions` item becomes the first item "
"of :data:`warnings.filters` which is checked first (highest priority)."
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:689
2019-09-04 09:39:22 +00:00
msgid "If non-zero, write ``.pyc`` files."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:691
2019-10-09 16:10:12 +00:00
msgid ""
":data:`sys.dont_write_bytecode` is initialized to the inverted value of :c:"
"member:`~PyConfig.write_bytecode`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:696
2019-09-04 09:39:22 +00:00
msgid ":data:`sys._xoptions`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:700
msgid "Enable PEG parser? Default: 1."
msgstr ""
#: c-api/init_config.rst:702
msgid "Set to 0 by :option:`-X oldparser <-X>` and :envvar:`PYTHONOLDPARSER`."
msgstr ""
#: c-api/init_config.rst:704
msgid "See also :pep:`617`."
msgstr ""
#: c-api/init_config.rst:708
2019-09-04 09:39:22 +00:00
msgid ""
"If ``parse_argv`` is non-zero, ``argv`` arguments are parsed the same way "
"the regular Python parses command line arguments, and Python arguments are "
"stripped from ``argv``: see :ref:`Command Line Arguments <using-on-cmdline>`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:713
2019-09-04 09:39:22 +00:00
msgid ""
"The ``xoptions`` options are parsed to set other options: see :option:`-X` "
"option."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:718
msgid "The ``show_alloc_count`` field has been removed."
msgstr ""
#: c-api/init_config.rst:722
2019-09-04 09:39:22 +00:00
msgid "Initialization with PyConfig"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:724
2019-09-04 09:39:22 +00:00
msgid "Function to initialize Python:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:728
2019-09-04 09:39:22 +00:00
msgid "Initialize Python from *config* configuration."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:733
2019-09-04 09:39:22 +00:00
msgid ""
2019-10-09 16:10:12 +00:00
"If ``PyImport_FrozenModules``, ``PyImport_AppendInittab()`` or "
"``PyImport_ExtendInittab()`` are used, they must be set or called after "
2019-09-04 09:39:22 +00:00
"Python preinitialization and before the Python initialization."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:737
2019-09-04 09:39:22 +00:00
msgid "Example setting the program name::"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:765
2019-09-04 09:39:22 +00:00
msgid ""
"More complete example modifying the default configuration, read the "
"configuration, and then override some parameters::"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:816
2019-09-04 09:39:22 +00:00
msgid "Isolated Configuration"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:818
2019-09-04 09:39:22 +00:00
msgid ""
":c:func:`PyPreConfig_InitIsolatedConfig` and :c:func:"
"`PyConfig_InitIsolatedConfig` functions create a configuration to isolate "
"Python from the system. For example, to embed Python into an application."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:823
2019-09-04 09:39:22 +00:00
msgid ""
"This configuration ignores global configuration variables, environments "
2019-10-09 16:10:12 +00:00
"variables, command line arguments (:c:member:`PyConfig.argv` is not parsed) "
"and user site directory. The C standard streams (ex: ``stdout``) and the "
"LC_CTYPE locale are left unchanged. Signal handlers are not installed."
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:828
2019-09-04 09:39:22 +00:00
msgid ""
"Configuration files are still used with this configuration. Set the :ref:"
"`Path Configuration <init-path-config>` (\"output fields\") to ignore these "
"configuration files and avoid the function computing the default path "
"configuration."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:837
2019-09-04 09:39:22 +00:00
msgid "Python Configuration"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:839
2019-09-04 09:39:22 +00:00
msgid ""
":c:func:`PyPreConfig_InitPythonConfig` and :c:func:"
"`PyConfig_InitPythonConfig` functions create a configuration to build a "
"customized Python which behaves as the regular Python."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:843
2019-09-04 09:39:22 +00:00
msgid ""
"Environments variables and command line arguments are used to configure "
"Python, whereas global configuration variables are ignored."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:846
2019-09-04 09:39:22 +00:00
msgid ""
"This function enables C locale coercion (:pep:`538`) and UTF-8 Mode (:pep:"
"`540`) depending on the LC_CTYPE locale, :envvar:`PYTHONUTF8` and :envvar:"
"`PYTHONCOERCECLOCALE` environment variables."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:850
2019-09-04 09:39:22 +00:00
msgid "Example of customized Python always running in isolated mode::"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:889
2019-09-04 09:39:22 +00:00
msgid "Path Configuration"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:891
2019-09-04 09:39:22 +00:00
msgid ":c:type:`PyConfig` contains multiple fields for the path configuration:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:893
2019-10-09 16:10:12 +00:00
msgid "Path configuration inputs:"
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:895
2019-09-04 09:39:22 +00:00
msgid ":c:member:`PyConfig.home`"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:896
msgid ":c:member:`PyConfig.platlibdir`"
msgstr ""
#: c-api/init_config.rst:897
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.pathconfig_warnings`"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:898
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.program_name`"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:899
2019-09-04 09:39:22 +00:00
msgid ":c:member:`PyConfig.pythonpath_env`"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:900
2019-10-09 16:10:12 +00:00
msgid "current working directory: to get absolute paths"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:901
2019-10-09 16:10:12 +00:00
msgid ""
"``PATH`` environment variable to get the program full path (from :c:member:"
"`PyConfig.program_name`)"
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:903
2019-10-09 16:10:12 +00:00
msgid "``__PYVENV_LAUNCHER__`` environment variable"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:904
2019-10-09 16:10:12 +00:00
msgid ""
"(Windows only) Application paths in the registry under \"Software\\Python"
"\\PythonCore\\X.Y\\PythonPath\" of HKEY_CURRENT_USER and HKEY_LOCAL_MACHINE "
"(where X.Y is the Python version)."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:908
2019-09-04 09:39:22 +00:00
msgid "Path configuration output fields:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:910
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.base_exec_prefix`"
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:911
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.base_executable`"
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:912
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.base_prefix`"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:913
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.exec_prefix`"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:914
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.executable`"
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:915
2019-09-04 09:39:22 +00:00
msgid ""
":c:member:`PyConfig.module_search_paths_set`, :c:member:`PyConfig."
"module_search_paths`"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:917
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.prefix`"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:919
2019-09-04 09:39:22 +00:00
msgid ""
2019-10-09 16:10:12 +00:00
"If at least one \"output field\" is not set, Python calculates the path "
2019-09-04 09:39:22 +00:00
"configuration to fill unset fields. If :c:member:`~PyConfig."
"module_search_paths_set` is equal to 0, :c:member:`~PyConfig."
"module_search_paths` is overridden and :c:member:`~PyConfig."
"module_search_paths_set` is set to 1."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:925
2019-09-04 09:39:22 +00:00
msgid ""
2019-10-09 16:10:12 +00:00
"It is possible to completely ignore the function calculating the default "
"path configuration by setting explicitly all path configuration output "
"fields listed above. A string is considered as set even if it is non-empty. "
2019-09-04 09:39:22 +00:00
"``module_search_paths`` is considered as set if ``module_search_paths_set`` "
"is set to 1. In this case, path configuration input fields are ignored as "
"well."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:932
2019-09-04 09:39:22 +00:00
msgid ""
"Set :c:member:`~PyConfig.pathconfig_warnings` to 0 to suppress warnings when "
2019-10-09 16:10:12 +00:00
"calculating the path configuration (Unix only, Windows does not log any "
2019-09-04 09:39:22 +00:00
"warning)."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:935
2019-09-04 09:39:22 +00:00
msgid ""
"If :c:member:`~PyConfig.base_prefix` or :c:member:`~PyConfig."
"base_exec_prefix` fields are not set, they inherit their value from :c:"
"member:`~PyConfig.prefix` and :c:member:`~PyConfig.exec_prefix` respectively."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:939
2019-09-04 09:39:22 +00:00
msgid ":c:func:`Py_RunMain` and :c:func:`Py_Main` modify :data:`sys.path`:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:941
2019-09-04 09:39:22 +00:00
msgid ""
"If :c:member:`~PyConfig.run_filename` is set and is a directory which "
"contains a ``__main__.py`` script, prepend :c:member:`~PyConfig."
"run_filename` to :data:`sys.path`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:944
2019-09-04 09:39:22 +00:00
msgid "If :c:member:`~PyConfig.isolated` is zero:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:946
2019-09-04 09:39:22 +00:00
msgid ""
"If :c:member:`~PyConfig.run_module` is set, prepend the current directory "
"to :data:`sys.path`. Do nothing if the current directory cannot be read."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:948
2019-09-04 09:39:22 +00:00
msgid ""
"If :c:member:`~PyConfig.run_filename` is set, prepend the directory of the "
"filename to :data:`sys.path`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:950
2019-09-04 09:39:22 +00:00
msgid "Otherwise, prepend an empty string to :data:`sys.path`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:952
2019-09-04 09:39:22 +00:00
msgid ""
"If :c:member:`~PyConfig.site_import` is non-zero, :data:`sys.path` can be "
"modified by the :mod:`site` module. If :c:member:`~PyConfig."
"user_site_directory` is non-zero and the user's site-package directory "
"exists, the :mod:`site` module appends the user's site-package directory to :"
"data:`sys.path`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:958
2019-09-04 09:39:22 +00:00
msgid "The following configuration files are used by the path configuration:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:960
2019-09-04 09:39:22 +00:00
msgid "``pyvenv.cfg``"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:961
2019-09-04 09:39:22 +00:00
msgid "``python._pth`` (Windows only)"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:962
2019-09-04 09:39:22 +00:00
msgid "``pybuilddir.txt`` (Unix only)"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:964
2019-10-09 16:10:12 +00:00
msgid ""
"The ``__PYVENV_LAUNCHER__`` environment variable is used to set :c:member:"
"`PyConfig.base_executable`"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:969
2019-09-04 09:39:22 +00:00
msgid "Py_RunMain()"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:973
2019-09-04 09:39:22 +00:00
msgid ""
"Execute the command (:c:member:`PyConfig.run_command`), the script (:c:"
"member:`PyConfig.run_filename`) or the module (:c:member:`PyConfig."
"run_module`) specified on the command line or in the configuration."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:978
2019-09-04 09:39:22 +00:00
msgid "By default and when if :option:`-i` option is used, run the REPL."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:980
2019-09-04 09:39:22 +00:00
msgid ""
"Finally, finalizes Python and returns an exit status that can be passed to "
"the ``exit()`` function."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:983
2019-09-04 09:39:22 +00:00
msgid ""
"See :ref:`Python Configuration <init-python-config>` for an example of "
"customized Python always running in isolated mode using :c:func:`Py_RunMain`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:989
msgid "Py_GetArgcArgv()"
msgstr ""
#: c-api/init_config.rst:993
msgid "Get the original command line arguments, before Python modified them."
msgstr ""
#: c-api/init_config.rst:997
2019-09-04 09:39:22 +00:00
msgid "Multi-Phase Initialization Private Provisional API"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:999
2019-09-04 09:39:22 +00:00
msgid ""
"This section is a private provisional API introducing multi-phase "
"initialization, the core feature of the :pep:`432`:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:1002
2019-09-04 09:39:22 +00:00
msgid "\"Core\" initialization phase, \"bare minimum Python\":"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:1004
2019-09-04 09:39:22 +00:00
msgid "Builtin types;"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:1005
2019-09-04 09:39:22 +00:00
msgid "Builtin exceptions;"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:1006
2019-09-04 09:39:22 +00:00
msgid "Builtin and frozen modules;"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:1007
2019-09-04 09:39:22 +00:00
msgid ""
"The :mod:`sys` module is only partially initialized (ex: :data:`sys.path` "
2019-10-09 16:10:12 +00:00
"doesn't exist yet)."
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:1010
2019-09-04 09:39:22 +00:00
msgid "\"Main\" initialization phase, Python is fully initialized:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:1012
2019-09-04 09:39:22 +00:00
msgid "Install and configure :mod:`importlib`;"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:1013
2019-09-04 09:39:22 +00:00
msgid "Apply the :ref:`Path Configuration <init-path-config>`;"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:1014
2019-09-04 09:39:22 +00:00
msgid "Install signal handlers;"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:1015
2019-09-04 09:39:22 +00:00
msgid ""
"Finish :mod:`sys` module initialization (ex: create :data:`sys.stdout` and :"
"data:`sys.path`);"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:1017
2019-09-04 09:39:22 +00:00
msgid ""
"Enable optional features like :mod:`faulthandler` and :mod:`tracemalloc`;"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:1018
2019-09-04 09:39:22 +00:00
msgid "Import the :mod:`site` module;"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:1019
2019-09-04 09:39:22 +00:00
msgid "etc."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:1021
2019-09-04 09:39:22 +00:00
msgid "Private provisional API:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:1023
2019-09-04 09:39:22 +00:00
msgid ""
":c:member:`PyConfig._init_main`: if set to 0, :c:func:"
"`Py_InitializeFromConfig` stops at the \"Core\" initialization phase."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:1025
msgid ""
":c:member:`PyConfig._isolated_interpreter`: if non-zero, disallow threads, "
"subprocesses and fork."
msgstr ""
#: c-api/init_config.rst:1030
2019-09-04 09:39:22 +00:00
msgid ""
"Move to the \"Main\" initialization phase, finish the Python initialization."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:1032
2019-09-04 09:39:22 +00:00
msgid ""
"No module is imported during the \"Core\" phase and the ``importlib`` module "
"is not configured: the :ref:`Path Configuration <init-path-config>` is only "
"applied during the \"Main\" phase. It may allow to customize Python in "
"Python to override or tune the :ref:`Path Configuration <init-path-config>`, "
2019-10-09 16:10:12 +00:00
"maybe install a custom :data:`sys.meta_path` importer or an import hook, etc."
2019-09-04 09:39:22 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:1038
2019-09-04 09:39:22 +00:00
msgid ""
2019-10-09 16:10:12 +00:00
"It may become possible to calculatin the :ref:`Path Configuration <init-path-"
2019-09-04 09:39:22 +00:00
"config>` in Python, after the Core phase and before the Main phase, which is "
"one of the :pep:`432` motivation."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:1042
2019-09-04 09:39:22 +00:00
msgid ""
"The \"Core\" phase is not properly defined: what should be and what should "
"not be available at this phase is not specified yet. The API is marked as "
"private and provisional: the API can be modified or even be removed anytime "
"until a proper public API is designed."
msgstr ""
2020-07-20 08:56:42 +00:00
#: c-api/init_config.rst:1047
2019-09-04 09:39:22 +00:00
msgid ""
"Example running Python code between \"Core\" and \"Main\" initialization "
"phases::"
msgstr ""