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

2048 lines
55 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"
"POT-Creation-Date: 2023-01-15 22:33+0100\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
msgid ""
"Python can be initialized with :c:func:`Py_InitializeFromConfig` and the :c:"
"type:`PyConfig` structure. It can be preinitialized with :c:func:"
"`Py_PreInitialize` and the :c:type:`PyPreConfig` structure."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:15
msgid "There are two kinds of configuration:"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:17
msgid ""
"The :ref:`Python Configuration <init-python-config>` can be used to build a "
"customized Python which behaves as the regular Python. For example, "
2022-05-22 21:15:02 +00:00
"environment variables and command line arguments are used to configure "
"Python."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:22
msgid ""
"The :ref:`Isolated Configuration <init-isolated-conf>` can be used to embed "
"Python into an application. It isolates Python from the system. For example, "
2022-05-22 21:15:02 +00:00
"environment variables are ignored, the LC_CTYPE locale is left unchanged and "
"no signal handler is registered."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:27
msgid ""
"The :c:func:`Py_RunMain` function can be used to write a customized Python "
"program."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:30
msgid ""
"See also :ref:`Initialization, Finalization, and Threads <initialization>`."
msgstr ""
#: c-api/init_config.rst:33
msgid ":pep:`587` \"Python Initialization Configuration\"."
msgstr ""
#: c-api/init_config.rst:37
2020-02-14 10:18:53 +00:00
#, fuzzy
msgid "Example"
msgstr "Exemple ::"
2019-09-04 09:39:22 +00:00
#: c-api/init_config.rst:39
msgid "Example of customized Python always running in isolated mode::"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:76
msgid "PyWideStringList"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:80
msgid "List of ``wchar_t*`` strings."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:82
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 ""
#: c-api/init_config.rst:85
#, fuzzy
msgid "Methods:"
msgstr "Méthodes :"
#: c-api/init_config.rst:89
msgid "Append *item* to *list*."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:102
msgid "Python must be preinitialized to call this function."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:95
msgid "Insert *item* into *list* at *index*."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:97
msgid ""
"If *index* is greater than or equal to *list* length, append *item* to "
"*list*."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:100
2022-05-22 21:15:02 +00:00
msgid "*index* must be greater than or equal to ``0``."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:124 c-api/init_config.rst:530
msgid "Structure fields:"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:108
msgid "List length."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:112
msgid "List items."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:115
msgid "PyStatus"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:119
msgid ""
"Structure to store an initialization function status: success, error or exit."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:122
msgid "For an error, it can store the C function name which created the error."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:128
msgid "Exit code. Argument passed to ``exit()``."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:132
msgid "Error message."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:136
msgid "Name of the function which created an error, can be ``NULL``."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:138
msgid "Functions to create a status:"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:142
msgid "Success."
msgstr ""
#: c-api/init_config.rst:146
msgid "Initialization error with a message."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:148
msgid "*err_msg* must not be ``NULL``."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:152
msgid "Memory allocation failure (out of memory)."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:156
msgid "Exit Python with the specified exit code."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:158
msgid "Functions to handle a status:"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:162
msgid ""
"Is the status an error or an exit? If true, the exception must be handled; "
"by calling :c:func:`Py_ExitStatusException` for example."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:167
msgid "Is the result an error?"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:171
msgid "Is the result an exit?"
2020-07-20 08:56:42 +00:00
msgstr ""
#: c-api/init_config.rst:175
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."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:180
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``."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:183
msgid "Example::"
msgstr "Exemple ::"
#: c-api/init_config.rst:207
msgid "PyPreConfig"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:211
msgid "Structure used to preinitialize Python."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:213
msgid "Function to initialize a preconfiguration:"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:217
2019-09-04 09:39:22 +00:00
msgid ""
"Initialize the preconfiguration with :ref:`Python Configuration <init-python-"
"config>`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:222
msgid ""
"Initialize the preconfiguration with :ref:`Isolated Configuration <init-"
"isolated-conf>`."
msgstr ""
2019-09-04 09:39:22 +00:00
#: c-api/init_config.rst:229
msgid "Name of the Python memory allocators:"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:231
msgid ""
"``PYMEM_ALLOCATOR_NOT_SET`` (``0``): don't change memory allocators (use "
"defaults)."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:233
msgid ""
"``PYMEM_ALLOCATOR_DEFAULT`` (``1``): :ref:`default memory allocators "
"<default-memory-allocators>`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:235
2019-09-04 09:39:22 +00:00
msgid ""
"``PYMEM_ALLOCATOR_DEBUG`` (``2``): :ref:`default memory allocators <default-"
"memory-allocators>` with :ref:`debug hooks <pymem-debug-hooks>`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:238
msgid "``PYMEM_ALLOCATOR_MALLOC`` (``3``): use ``malloc()`` of the C library."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:239
msgid ""
"``PYMEM_ALLOCATOR_MALLOC_DEBUG`` (``4``): force usage of ``malloc()`` with :"
"ref:`debug hooks <pymem-debug-hooks>`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:241
msgid ""
"``PYMEM_ALLOCATOR_PYMALLOC`` (``5``): :ref:`Python pymalloc memory allocator "
"<pymalloc>`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:243
msgid ""
"``PYMEM_ALLOCATOR_PYMALLOC_DEBUG`` (``6``): :ref:`Python pymalloc memory "
"allocator <pymalloc>` with :ref:`debug hooks <pymem-debug-hooks>`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:247
msgid ""
"``PYMEM_ALLOCATOR_PYMALLOC`` and ``PYMEM_ALLOCATOR_PYMALLOC_DEBUG`` are not "
"supported if Python is :option:`configured using --without-pymalloc <--"
"without-pymalloc>`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:251
msgid "See :ref:`Memory Management <memory>`."
msgstr ""
#: c-api/init_config.rst:253
msgid "Default: ``PYMEM_ALLOCATOR_NOT_SET``."
msgstr ""
#: c-api/init_config.rst:257
msgid "Set the LC_CTYPE locale to the user preferred locale."
msgstr ""
#: c-api/init_config.rst:259
2019-09-04 09:39:22 +00:00
msgid ""
2022-05-22 21:15:02 +00:00
"If equals to ``0``, set :c:member:`~PyPreConfig.coerce_c_locale` and :c:"
"member:`~PyPreConfig.coerce_c_locale_warn` members to ``0``."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:273
msgid "See the :term:`locale encoding`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:319 c-api/init_config.rst:670
msgid "Default: ``1`` in Python config, ``0`` in isolated config."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:268
2022-05-22 21:15:02 +00:00
msgid "If equals to ``2``, coerce the C locale."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:270
msgid ""
2022-05-22 21:15:02 +00:00
"If equals to ``1``, read the LC_CTYPE locale to decide if it should be "
"coerced."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:281
msgid "Default: ``-1`` in Python config, ``0`` in isolated config."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:279
msgid "If non-zero, emit a warning if the C locale is coerced."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:285
msgid ""
2022-05-22 21:15:02 +00:00
":ref:`Python Development Mode <devmode>`: see :c:member:`PyConfig.dev_mode`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:679 c-api/init_config.rst:1150
msgid "Default: ``-1`` in Python mode, ``0`` in isolated mode."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:292
msgid "Isolated mode: see :c:member:`PyConfig.isolated`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:846
msgid "Default: ``0`` in Python mode, ``1`` in isolated mode."
msgstr ""
#: c-api/init_config.rst:298
msgid "If non-zero:"
msgstr ""
#: c-api/init_config.rst:300
msgid "Set :c:member:`PyPreConfig.utf8_mode` to ``0``,"
msgstr ""
#: c-api/init_config.rst:301
msgid "Set :c:member:`PyConfig.filesystem_encoding` to ``\"mbcs\"``,"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:302
msgid "Set :c:member:`PyConfig.filesystem_errors` to ``\"replace\"``."
msgstr ""
#: c-api/init_config.rst:304
2019-09-04 09:39:22 +00:00
msgid ""
"Initialized the from :envvar:`PYTHONLEGACYWINDOWSFSENCODING` environment "
"variable value."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:859
msgid ""
"Only available on Windows. ``#ifdef MS_WINDOWS`` macro can be used for "
"Windows specific code."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:618 c-api/init_config.rst:692
#: c-api/init_config.rst:815 c-api/init_config.rst:862
#: c-api/init_config.rst:936 c-api/init_config.rst:1045
#: c-api/init_config.rst:1114 c-api/init_config.rst:1187
msgid "Default: ``0``."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:314
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>`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:323
2019-09-04 09:39:22 +00:00
msgid ""
"Use :ref:`environment variables <using-on-envvars>`? See :c:member:`PyConfig."
"use_environment`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1161
msgid "Default: ``1`` in Python config and ``0`` in isolated config."
msgstr ""
2019-09-04 09:39:22 +00:00
#: c-api/init_config.rst:330
msgid "If non-zero, enable the :ref:`Python UTF-8 Mode <utf8-mode>`."
msgstr ""
#: c-api/init_config.rst:332
msgid ""
2022-05-22 21:15:02 +00:00
"Set to ``0`` or ``1`` by the :option:`-X utf8 <-X>` command line option and "
"the :envvar:`PYTHONUTF8` environment variable."
msgstr ""
#: c-api/init_config.rst:335
2022-05-22 21:15:02 +00:00
msgid "Also set to ``1`` if the ``LC_CTYPE`` locale is ``C`` or ``POSIX``."
msgstr ""
#: c-api/init_config.rst:337
msgid "Default: ``-1`` in Python config and ``0`` in isolated config."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:343
msgid "Preinitialize Python with PyPreConfig"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:345
msgid "The preinitialization of Python:"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:347
msgid "Set the Python memory allocators (:c:member:`PyPreConfig.allocator`)"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:348
msgid "Configure the LC_CTYPE locale (:term:`locale encoding`)"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:349
msgid ""
"Set the :ref:`Python UTF-8 Mode <utf8-mode>` (:c:member:`PyPreConfig."
"utf8_mode`)"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:352
msgid ""
"The current preconfiguration (``PyPreConfig`` type) is stored in "
"``_PyRuntime.preconfig``."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:355
msgid "Functions to preinitialize Python:"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:365 c-api/init_config.rst:374
msgid "Preinitialize Python from *preconfig* preconfiguration."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:370 c-api/init_config.rst:379
msgid "*preconfig* must not be ``NULL``."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:367
msgid ""
"Parse *argv* command line arguments (bytes strings) if :c:member:"
"`~PyPreConfig.parse_argv` of *preconfig* is non-zero."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:376
msgid ""
"Parse *argv* command line arguments (wide strings) if :c:member:"
"`~PyPreConfig.parse_argv` of *preconfig* is non-zero."
msgstr ""
#: c-api/init_config.rst:1249
msgid ""
"The caller is responsible to handle exceptions (error or exit) using :c:func:"
"`PyStatus_Exception` and :c:func:`Py_ExitStatusException`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:384
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. "
"For example, the :option:`-X utf8 <-X>` command line option enables the :ref:"
"`Python UTF-8 Mode <utf8-mode>`."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:391
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:396
msgid ""
"Python memory allocation functions like :c:func:`PyMem_RawMalloc` must not "
"be used before the Python preinitialization, whereas calling directly "
"``malloc()`` and ``free()`` is always safe. :c:func:`Py_DecodeLocale` must "
"not be called before the Python preinitialization."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:401
msgid ""
"Example using the preinitialization to enable the :ref:`Python UTF-8 Mode "
"<utf8-mode>`::"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:423
msgid "PyConfig"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:427
msgid "Structure containing most parameters to configure Python."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:429
msgid ""
"When done, the :c:func:`PyConfig_Clear` function must be used to release the "
"configuration memory."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:432
msgid "Structure methods:"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:436
msgid ""
"Initialize configuration with the :ref:`Python Configuration <init-python-"
"config>`."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:441
msgid ""
"Initialize configuration with the :ref:`Isolated Configuration <init-"
"isolated-conf>`."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:446
msgid "Copy the wide character string *str* into ``*config_str``."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:455 c-api/init_config.rst:470
#: c-api/init_config.rst:493
msgid ":ref:`Preinitialize Python <c-preinit>` if needed."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:452
msgid ""
"Decode *str* using :c:func:`Py_DecodeLocale` and set the result into "
"``*config_str``."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:459
msgid ""
"Set command line arguments (:c:member:`~PyConfig.argv` member of *config*) "
"from the *argv* list of wide character strings."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:466
msgid ""
"Set command line arguments (:c:member:`~PyConfig.argv` member of *config*) "
"from the *argv* list of bytes strings. Decode bytes using :c:func:"
"`Py_DecodeLocale`."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:474
msgid "Set the list of wide strings *list* to *length* and *items*."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:480
msgid "Read all Python configuration."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:482
msgid "Fields which are already initialized are left unchanged."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:484
2022-03-23 17:40:12 +00:00
msgid ""
"Fields for :ref:`path configuration <init-path-config>` are no longer "
"calculated or modified when calling this function, as of Python 3.11."
msgstr ""
#: c-api/init_config.rst:965
msgid ""
"The :c:func:`PyConfig_Read` function only parses :c:member:`PyConfig.argv` "
"arguments once: :c:member:`PyConfig.parse_argv` is set to ``2`` after "
"arguments are parsed. Since Python arguments are strippped from :c:member:"
"`PyConfig.argv`, parsing arguments twice would parse the application options "
"as Python options."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:495
msgid ""
"The :c:member:`PyConfig.argv` arguments are now only parsed once, :c:member:"
"`PyConfig.parse_argv` is set to ``2`` after arguments are parsed, and "
"arguments are only parsed if :c:member:`PyConfig.parse_argv` equals ``1``."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:501
2022-03-23 17:40:12 +00:00
msgid ""
":c:func:`PyConfig_Read` no longer calculates all paths, and so fields listed "
"under :ref:`Python Path Configuration <init-path-config>` may no longer be "
"updated until :c:func:`Py_InitializeFromConfig` is called."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:509
msgid "Release configuration memory."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:511
msgid ""
"Most ``PyConfig`` methods :ref:`preinitialize Python <c-preinit>` if needed. "
"In that case, the Python preinitialization configuration (:c:type:"
"`PyPreConfig`) 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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:517
msgid ":c:member:`PyConfig.dev_mode`"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:518
msgid ":c:member:`PyConfig.isolated`"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:519
msgid ":c:member:`PyConfig.parse_argv`"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:520
msgid ":c:member:`PyConfig.use_environment`"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:522
msgid ""
"Moreover, if :c:func:`PyConfig_SetArgv` or :c:func:`PyConfig_SetBytesArgv` "
"is used, this method must be called before other methods, since the "
"preinitialization configuration depends on command line arguments (if :c:"
"member:`parse_argv` is non-zero)."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:527
msgid ""
"The caller of these methods is responsible to handle exceptions (error or "
"exit) using ``PyStatus_Exception()`` and ``Py_ExitStatusException()``."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:534
msgid "Command line arguments: :data:`sys.argv`."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:536
msgid ""
"Set :c:member:`~PyConfig.parse_argv` to ``1`` to parse :c:member:`~PyConfig."
"argv` the same way the regular Python parses Python command line arguments "
"and then to strip Python arguments from :c:member:`~PyConfig.argv`."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:541
msgid ""
"If :c:member:`~PyConfig.argv` is empty, an empty string is added to ensure "
"that :data:`sys.argv` always exists and is never empty."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:571 c-api/init_config.rst:591
#: c-api/init_config.rst:708 c-api/init_config.rst:906
#: c-api/init_config.rst:1022 c-api/init_config.rst:1053
#: c-api/init_config.rst:1074
msgid "Default: ``NULL``."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:546
msgid "See also the :c:member:`~PyConfig.orig_argv` member."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:550
msgid ""
"If equals to zero, ``Py_RunMain()`` prepends a potentially unsafe path to :"
"data:`sys.path` at startup:"
msgstr ""
#: c-api/init_config.rst:553
msgid ""
"If :c:member:`argv[0] <PyConfig.argv>` is equal to ``L\"-m\"`` (``python -m "
"module``), prepend the current working directory."
msgstr ""
#: c-api/init_config.rst:555
msgid ""
"If running a script (``python script.py``), prepend the script's directory. "
"If it's a symbolic link, resolve symbolic links."
msgstr ""
#: c-api/init_config.rst:557
msgid ""
"Otherwise (``python -c code`` and ``python``), prepend an empty string, "
"which means the current working directory."
msgstr ""
#: c-api/init_config.rst:560
msgid ""
"Set to ``1`` by the :option:`-P` command line option and the :envvar:"
"`PYTHONSAFEPATH` environment variable."
msgstr ""
#: c-api/init_config.rst:563
msgid "Default: ``0`` in Python config, ``1`` in isolated config."
msgstr ""
#: c-api/init_config.rst:569
msgid ":data:`sys.base_exec_prefix`."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:585 c-api/init_config.rst:701
#: c-api/init_config.rst:923 c-api/init_config.rst:1006
msgid "Part of the :ref:`Python Path Configuration <init-path-config>` output."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:577
msgid "Python base executable: :data:`sys._base_executable`."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:579
msgid "Set by the :envvar:`__PYVENV_LAUNCHER__` environment variable."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:581
msgid "Set from :c:member:`PyConfig.executable` if ``NULL``."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:589
msgid ":data:`sys.base_prefix`."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:597
msgid ""
2022-05-22 21:15:02 +00:00
"If equals to ``0`` and :c:member:`~PyConfig.configure_c_stdio` is non-zero, "
"disable buffering on the C streams stdout and stderr."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:600
msgid ""
2022-05-22 21:15:02 +00:00
"Set to ``0`` by the :option:`-u` command line option and the :envvar:"
"`PYTHONUNBUFFERED` environment variable."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:603
msgid "stdin is always opened in buffered mode."
msgstr ""
#: c-api/init_config.rst:638 c-api/init_config.rst:1219
msgid "Default: ``1``."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:609
msgid ""
2022-05-22 21:15:02 +00:00
"If equals to ``1``, issue a warning when comparing :class:`bytes` or :class:"
"`bytearray` with :class:`str`, or comparing :class:`bytes` with :class:`int`."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:613
msgid ""
2022-05-22 21:15:02 +00:00
"If equal or greater to ``2``, raise a :exc:`BytesWarning` exception in these "
"cases."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:616
msgid "Incremented by the :option:`-b` command line option."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:622
msgid ""
"If non-zero, emit a :exc:`EncodingWarning` warning when :class:`io."
"TextIOWrapper` uses its default encoding. See :ref:`io-encoding-warning` for "
"details."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:631
2022-03-23 17:40:12 +00:00
msgid ""
"If equals to ``0``, disables the inclusion of the end line and column "
"mappings in code objects. Also disables traceback printing carets to "
"specific error locations."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:635
2022-03-23 17:40:12 +00:00
msgid ""
"Set to ``0`` by the :envvar:`PYTHONNODEBUGRANGES` environment variable and "
"by the :option:`-X no_debug_ranges <-X>` command line option."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:644
msgid ""
"Control the validation behavior of hash-based ``.pyc`` files: value of the :"
"option:`--check-hash-based-pycs` command line option."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:647
msgid "Valid values:"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:649
msgid ""
"``L\"always\"``: Hash the source file for invalidation regardless of value "
"of the 'check_source' flag."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:651
msgid "``L\"never\"``: Assume that hash-based pycs always are valid."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:652
msgid ""
"``L\"default\"``: The 'check_source' flag in hash-based pycs determines "
"invalidation."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:655
msgid "Default: ``L\"default\"``."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:657
msgid "See also :pep:`552` \"Deterministic pycs\"."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:661
msgid "If non-zero, configure C standard streams:"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:663
msgid ""
"On Windows, set the binary mode (``O_BINARY``) on stdin, stdout and stderr."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:665
msgid ""
"If :c:member:`~PyConfig.buffered_stdio` equals zero, disable buffering of "
"stdin, stdout and stderr streams."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:667
msgid ""
"If :c:member:`~PyConfig.interactive` is non-zero, enable stream buffering on "
"stdin and stdout (only stdout on Windows)."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:674
msgid "If non-zero, enable the :ref:`Python Development Mode <devmode>`."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:676
msgid ""
"Set to ``1`` by the :option:`-X dev <-X>` option and the :envvar:"
"`PYTHONDEVMODE` environment variable."
msgstr ""
#: c-api/init_config.rst:683
2022-03-23 17:40:12 +00:00
msgid "Dump Python references?"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:685
msgid "If non-zero, dump all objects which are still alive at exit."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:687
msgid "Set to ``1`` by the :envvar:`PYTHONDUMPREFS` environment variable."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:689
msgid ""
"Need a special build of Python with the ``Py_TRACE_REFS`` macro defined: see "
"the :option:`configure --with-trace-refs option <--with-trace-refs>`."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:696
msgid ""
"The site-specific directory prefix where the platform-dependent Python files "
"are installed: :data:`sys.exec_prefix`."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:705
msgid ""
"The absolute path of the executable binary for the Python interpreter: :data:"
"`sys.executable`."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:714
msgid "Enable faulthandler?"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:716
msgid "If non-zero, call :func:`faulthandler.enable` at startup."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:718
msgid ""
"Set to ``1`` by :option:`-X faulthandler <-X>` and the :envvar:"
"`PYTHONFAULTHANDLER` environment variable."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:725
msgid ""
":term:`Filesystem encoding <filesystem encoding and error handler>`: :func:"
"`sys.getfilesystemencoding`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:728
msgid "On macOS, Android and VxWorks: use ``\"utf-8\"`` by default."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:730
2019-09-04 09:39:22 +00:00
msgid ""
"On Windows: use ``\"utf-8\"`` by default, or ``\"mbcs\"`` if :c:member:"
"`~PyPreConfig.legacy_windows_fs_encoding` of :c:type:`PyPreConfig` is non-"
"zero."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:734
msgid "Default encoding on other platforms:"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:736
msgid "``\"utf-8\"`` if :c:member:`PyPreConfig.utf8_mode` is non-zero."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:737
2019-09-04 09:39:22 +00:00
msgid ""
"``\"ascii\"`` if Python detects that ``nl_langinfo(CODESET)`` announces the "
"ASCII encoding, whereas the ``mbstowcs()`` function decodes from a different "
"encoding (usually Latin1)."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:740
msgid "``\"utf-8\"`` if ``nl_langinfo(CODESET)`` returns an empty string."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:741
2019-09-04 09:39:22 +00:00
msgid ""
"Otherwise, use the :term:`locale encoding`: ``nl_langinfo(CODESET)`` result."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:744
msgid ""
"At Python startup, the encoding name is normalized to the Python codec name. "
"For example, ``\"ANSI_X3.4-1968\"`` is replaced with ``\"ascii\"``."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:747
msgid "See also the :c:member:`~PyConfig.filesystem_errors` member."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:751
2019-09-04 09:39:22 +00:00
msgid ""
":term:`Filesystem error handler <filesystem encoding and error handler>`: :"
"func:`sys.getfilesystemencodeerrors`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:754
2019-09-04 09:39:22 +00:00
msgid ""
"On Windows: use ``\"surrogatepass\"`` by default, or ``\"replace\"`` if :c:"
"member:`~PyPreConfig.legacy_windows_fs_encoding` of :c:type:`PyPreConfig` is "
"non-zero."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:758
msgid "On other platforms: use ``\"surrogateescape\"`` by default."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:760
msgid "Supported error handlers:"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:762
msgid "``\"strict\"``"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:763
msgid "``\"surrogateescape\"``"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:764
msgid "``\"surrogatepass\"`` (only supported with the UTF-8 encoding)"
2019-10-09 16:10:12 +00:00
msgstr ""
#: c-api/init_config.rst:766
msgid "See also the :c:member:`~PyConfig.filesystem_encoding` member."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:771
msgid "Randomized hash function seed."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:773
2019-09-04 09:39:22 +00:00
msgid ""
"If :c:member:`~PyConfig.use_hash_seed` is zero, a seed is chosen randomly at "
"Python startup, and :c:member:`~PyConfig.hash_seed` is ignored."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:776
msgid "Set by the :envvar:`PYTHONHASHSEED` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:778
2019-09-04 09:39:22 +00:00
msgid ""
"Default *use_hash_seed* value: ``-1`` in Python mode, ``0`` in isolated mode."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:783
msgid "Python home directory."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:785
msgid ""
"If :c:func:`Py_SetPythonHome` has been called, use its argument if it is not "
"``NULL``."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:788
msgid "Set by the :envvar:`PYTHONHOME` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:888 c-api/init_config.rst:994
#: c-api/init_config.rst:1024
msgid "Part of the :ref:`Python Path Configuration <init-path-config>` input."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:796
msgid "If non-zero, profile import time."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:798
2019-09-04 09:39:22 +00:00
msgid ""
"Set the ``1`` by the :option:`-X importtime <-X>` option and the :envvar:"
"`PYTHONPROFILEIMPORTTIME` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:805
msgid "Enter interactive mode after executing a script or a command."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:807
2019-09-04 09:39:22 +00:00
msgid ""
2022-05-22 21:15:02 +00:00
"If greater than ``0``, enable inspect: when a script is passed as first "
"argument or the -c option is used, enter interactive mode after executing "
"the script or the command, even when :data:`sys.stdin` does not appear to be "
"a terminal."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:812
2019-09-04 09:39:22 +00:00
msgid ""
"Incremented by the :option:`-i` command line option. Set to ``1`` if the :"
"envvar:`PYTHONINSPECT` environment variable is non-empty."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:819
msgid "Install Python signal handlers?"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:971 c-api/init_config.rst:1171
msgid "Default: ``1`` in Python mode, ``0`` in isolated mode."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:825
2022-05-22 21:15:02 +00:00
msgid "If greater than ``0``, enable the interactive mode (REPL)."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:827
msgid "Incremented by the :option:`-i` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:833
2022-05-22 21:15:02 +00:00
msgid "If greater than ``0``, enable isolated mode:"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:835
msgid ""
2022-05-22 21:15:02 +00:00
"Set :c:member:`~PyConfig.safe_path` to ``1``: don't prepend a potentially "
"unsafe path to :data:`sys.path` at Python startup."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1469
2022-05-22 21:15:02 +00:00
msgid "Set :c:member:`~PyConfig.use_environment` to ``0``."
msgstr ""
#: c-api/init_config.rst:839
2022-05-22 21:15:02 +00:00
msgid ""
"Set :c:member:`~PyConfig.user_site_directory` to ``0``: don't add the user "
"site directory to :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:841
2019-09-04 09:39:22 +00:00
msgid ""
"Python REPL doesn't import :mod:`readline` nor enable default readline "
"configuration on interactive prompts."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:844
2022-05-22 21:15:02 +00:00
msgid "Set to ``1`` by the :option:`-I` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:848
msgid "See also :c:member:`PyPreConfig.isolated`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:852
msgid ""
"If non-zero, use :class:`io.FileIO` instead of :class:`io.WindowsConsoleIO` "
"for :data:`sys.stdin`, :data:`sys.stdout` and :data:`sys.stderr`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:856
2019-09-04 09:39:22 +00:00
msgid ""
"Set to ``1`` if the :envvar:`PYTHONLEGACYWINDOWSSTDIO` environment variable "
"is set to a non-empty string."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:864
msgid "See also the :pep:`528` (Change Windows console encoding to UTF-8)."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:868
2019-09-04 09:39:22 +00:00
msgid ""
"If non-zero, dump statistics on :ref:`Python pymalloc memory allocator "
"<pymalloc>` at exit."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:871
msgid "Set to ``1`` by the :envvar:`PYTHONMALLOCSTATS` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:873
msgid ""
"The option is ignored if Python is :option:`configured using the --without-"
"pymalloc option <--without-pymalloc>`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:880
msgid "Platform library directory name: :data:`sys.platlibdir`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:882
msgid "Set by the :envvar:`PYTHONPLATLIBDIR` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:884
2019-09-04 09:39:22 +00:00
msgid ""
"Default: value of the ``PLATLIBDIR`` macro which is set by the :option:"
2022-03-23 17:40:12 +00:00
"`configure --with-platlibdir option <--with-platlibdir>` (default: "
"``\"lib\"``, or ``\"DLLs\"`` on Windows)."
msgstr ""
#: c-api/init_config.rst:892
2022-03-23 17:40:12 +00:00
msgid ""
"This macro is now used on Windows to locate the standard library extension "
"modules, typically under ``DLLs``. However, for compatibility, note that "
"this value is ignored for any non-standard layouts, including in-tree builds "
"and virtual environments."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:901
msgid ""
"Module search paths (:data:`sys.path`) as a string separated by ``DELIM`` (:"
"data:`os.path.pathsep`)."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:904
msgid "Set by the :envvar:`PYTHONPATH` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:913
msgid "Module search paths: :data:`sys.path`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:915
msgid ""
2022-05-22 21:15:02 +00:00
"If :c:member:`~PyConfig.module_search_paths_set` is equal to ``0``, :c:func:"
2022-03-23 17:40:12 +00:00
"`Py_InitializeFromConfig` will replace :c:member:`~PyConfig."
"module_search_paths` and sets :c:member:`~PyConfig.module_search_paths_set` "
"to ``1``."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:920
2019-09-04 09:39:22 +00:00
msgid ""
"Default: empty list (``module_search_paths``) and ``0`` "
"(``module_search_paths_set``)."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:927
msgid "Compilation optimization level:"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:929
msgid "``0``: Peephole optimizer, set ``__debug__`` to ``True``."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:930
msgid "``1``: Level 0, remove assertions, set ``__debug__`` to ``False``."
msgstr ""
#: c-api/init_config.rst:931
msgid "``2``: Level 1, strip docstrings."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:933
2019-10-09 16:10:12 +00:00
msgid ""
"Incremented by the :option:`-O` command line option. Set to the :envvar:"
"`PYTHONOPTIMIZE` environment variable value."
2019-10-09 16:10:12 +00:00
msgstr ""
#: c-api/init_config.rst:940
msgid ""
"The list of the original command line arguments passed to the Python "
"executable: :data:`sys.orig_argv`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:943
2020-07-20 08:56:42 +00:00
msgid ""
"If :c:member:`~PyConfig.orig_argv` list is empty and :c:member:`~PyConfig."
"argv` is not a list only containing an empty string, :c:func:`PyConfig_Read` "
"copies :c:member:`~PyConfig.argv` into :c:member:`~PyConfig.orig_argv` "
"before modifying :c:member:`~PyConfig.argv` (if :c:member:`~PyConfig."
"parse_argv` is non-zero)."
2020-07-20 08:56:42 +00:00
msgstr ""
#: c-api/init_config.rst:950
2019-09-04 09:39:22 +00:00
msgid ""
"See also the :c:member:`~PyConfig.argv` member and the :c:func:"
"`Py_GetArgcArgv` function."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1206 c-api/init_config.rst:1225
msgid "Default: empty list."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:959
msgid "Parse command line arguments?"
msgstr ""
#: c-api/init_config.rst:961
2019-09-04 09:39:22 +00:00
msgid ""
"If equals to ``1``, parse :c:member:`~PyConfig.argv` the same way the "
"regular Python parses :ref:`command line arguments <using-on-cmdline>`, and "
"strip Python arguments from :c:member:`~PyConfig.argv`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:973
2019-09-04 09:39:22 +00:00
msgid ""
"The :c:member:`PyConfig.argv` arguments are now only parsed if :c:member:"
"`PyConfig.parse_argv` equals to ``1``."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:979
msgid ""
2022-05-22 21:15:02 +00:00
"Parser debug mode. If greater than ``0``, turn on parser debugging output "
"(for expert only, depending on compilation options)."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:982
msgid ""
"Incremented by the :option:`-d` command line option. Set to the :envvar:"
"`PYTHONDEBUG` environment variable value."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:989
2019-09-04 09:39:22 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"If non-zero, calculation of path configuration is allowed to log warnings "
2022-05-22 21:15:02 +00:00
"into ``stderr``. If equals to ``0``, suppress these warnings."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:996
2022-03-23 17:40:12 +00:00
msgid "Now also applies on Windows."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1001
msgid ""
"The site-specific directory prefix where the platform independent Python "
"files are installed: :data:`sys.prefix`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1010
msgid ""
"Program name used to initialize :c:member:`~PyConfig.executable` and in "
"early error messages during Python initialization."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1013
msgid "If :func:`Py_SetProgramName` has been called, use its argument."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1014
msgid "On macOS, use :envvar:`PYTHONEXECUTABLE` environment variable if set."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1015
msgid ""
"If the ``WITH_NEXT_FRAMEWORK`` macro is defined, use :envvar:"
"`__PYVENV_LAUNCHER__` environment variable if set."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1017
msgid ""
"Use ``argv[0]`` of :c:member:`~PyConfig.argv` if available and non-empty."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1019
msgid ""
"Otherwise, use ``L\"python\"`` on Windows, or ``L\"python3\"`` on other "
"platforms."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1028
msgid ""
"Directory where cached ``.pyc`` files are written: :data:`sys."
"pycache_prefix`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1031
2019-09-04 09:39:22 +00:00
msgid ""
"Set by the :option:`-X pycache_prefix=PATH <-X>` command line option and "
"the :envvar:`PYTHONPYCACHEPREFIX` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1034
msgid "If ``NULL``, :data:`sys.pycache_prefix` is set to ``None``."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1040
2019-10-09 16:10:12 +00:00
msgid ""
2022-05-22 21:15:02 +00:00
"Quiet mode. If greater than ``0``, don't display the copyright and version "
"at Python startup in interactive mode."
2019-10-09 16:10:12 +00:00
msgstr ""
#: c-api/init_config.rst:1043
msgid "Incremented by the :option:`-q` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1049
msgid "Value of the :option:`-c` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1072
msgid "Used by :c:func:`Py_RunMain`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1057
msgid ""
"Filename passed on the command line: trailing command line argument without :"
2022-05-22 21:15:02 +00:00
"option:`-c` or :option:`-m`. It is used by the :c:func:`Py_RunMain` function."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1061
2019-09-04 09:39:22 +00:00
msgid ""
"For example, it is set to ``script.py`` by the ``python3 script.py arg`` "
2022-05-22 21:15:02 +00:00
"command line."
msgstr ""
#: c-api/init_config.rst:1064
2022-05-22 21:15:02 +00:00
msgid "See also the :c:member:`PyConfig.skip_source_first_line` option."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1070
msgid "Value of the :option:`-m` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1078
msgid "Show total reference count at exit?"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1080
2022-05-22 21:15:02 +00:00
msgid "Set to ``1`` by :option:`-X showrefcount <-X>` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1082
2019-09-04 09:39:22 +00:00
msgid ""
"Need a :ref:`debug build of Python <debug-build>` (the ``Py_REF_DEBUG`` "
"macro must be defined)."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1089
msgid "Import the :mod:`site` module at startup?"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1091
2019-09-04 09:39:22 +00:00
msgid ""
"If equal to zero, disable the import of the module site and the site-"
"dependent manipulations of :data:`sys.path` that it entails."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1094
2019-09-04 09:39:22 +00:00
msgid ""
"Also disable these manipulations if the :mod:`site` module is explicitly "
"imported later (call :func:`site.main` if you want them to be triggered)."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1097
msgid "Set to ``0`` by the :option:`-S` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1099
msgid ""
":data:`sys.flags.no_site` is set to the inverted value of :c:member:"
"`~PyConfig.site_import`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1106
msgid ""
"If non-zero, skip the first line of the :c:member:`PyConfig.run_filename` "
"source."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1109
msgid ""
"It allows the usage of non-Unix forms of ``#!cmd``. This is intended for a "
"DOS specific hack only."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1112
msgid "Set to ``1`` by the :option:`-x` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1119
2019-09-04 09:39:22 +00:00
msgid ""
"Encoding and encoding errors of :data:`sys.stdin`, :data:`sys.stdout` and :"
2022-03-23 17:40:12 +00:00
"data:`sys.stderr` (but :data:`sys.stderr` always uses "
"``\"backslashreplace\"`` error handler)."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1123
2019-09-04 09:39:22 +00:00
msgid ""
"If :c:func:`Py_SetStandardStreamEncoding` has been called, use its *error* "
"and *errors* arguments if they are not ``NULL``."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1126
2019-09-04 09:39:22 +00:00
msgid ""
"Use the :envvar:`PYTHONIOENCODING` environment variable if it is non-empty."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1129
msgid "Default encoding:"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1131
msgid "``\"UTF-8\"`` if :c:member:`PyPreConfig.utf8_mode` is non-zero."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1132
msgid "Otherwise, use the :term:`locale encoding`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1134
msgid "Default error handler:"
2019-10-09 16:10:12 +00:00
msgstr ""
#: c-api/init_config.rst:1136
msgid "On Windows: use ``\"surrogateescape\"``."
msgstr ""
#: c-api/init_config.rst:1137
2019-09-04 09:39:22 +00:00
msgid ""
"``\"surrogateescape\"`` if :c:member:`PyPreConfig.utf8_mode` is non-zero, or "
"if the LC_CTYPE locale is \"C\" or \"POSIX\"."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1139
msgid "``\"strict\"`` otherwise."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1143
msgid "Enable tracemalloc?"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1145
msgid "If non-zero, call :func:`tracemalloc.start` at startup."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1147
msgid ""
"Set by :option:`-X tracemalloc=N <-X>` command line option and by the :"
"envvar:`PYTHONTRACEMALLOC` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1154
msgid "Use :ref:`environment variables <using-on-envvars>`?"
2019-10-09 16:10:12 +00:00
msgstr ""
#: c-api/init_config.rst:1156
msgid ""
"If equals to zero, ignore the :ref:`environment variables <using-on-"
"envvars>`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1159
2022-05-22 21:15:02 +00:00
msgid "Set to ``0`` by the :option:`-E` environment variable."
msgstr ""
#: c-api/init_config.rst:1165
msgid "If non-zero, add the user site directory to :data:`sys.path`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1167
msgid "Set to ``0`` by the :option:`-s` and :option:`-I` command line options."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1169
msgid "Set to ``0`` by the :envvar:`PYTHONNOUSERSITE` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1175
msgid ""
2022-05-22 21:15:02 +00:00
"Verbose mode. If greater than ``0``, print a message each time a module is "
"imported, showing the place (filename or built-in module) from which it is "
"loaded."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1179
msgid ""
2022-05-22 21:15:02 +00:00
"If greater or equal to ``2``, print a message for each file that is checked "
"for when searching for a module. Also provides information on module cleanup "
"at exit."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1183
msgid "Incremented by the :option:`-v` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1185
msgid "Set to the :envvar:`PYTHONVERBOSE` environment variable value."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1191
2019-10-09 16:10:12 +00:00
msgid ""
"Options of the :mod:`warnings` module to build warnings filters, lowest to "
"highest priority: :data:`sys.warnoptions`."
2019-10-09 16:10:12 +00:00
msgstr ""
#: c-api/init_config.rst:1194
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 ""
#: c-api/init_config.rst:1199
msgid ""
"The :option:`-W` command line options adds its value to :c:member:`~PyConfig."
"warnoptions`, it can be used multiple times."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1202
2019-10-09 16:10:12 +00:00
msgid ""
"The :envvar:`PYTHONWARNINGS` environment variable can also be used to add "
"warning options. Multiple options can be specified, separated by commas (``,"
"``)."
2019-10-09 16:10:12 +00:00
msgstr ""
#: c-api/init_config.rst:1210
msgid ""
2022-05-22 21:15:02 +00:00
"If equal to ``0``, Python won't try to write ``.pyc`` files on the import of "
"source modules."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1213
msgid ""
"Set to ``0`` by the :option:`-B` command line option and the :envvar:"
"`PYTHONDONTWRITEBYTECODE` environment variable."
2020-07-20 08:56:42 +00:00
msgstr ""
#: c-api/init_config.rst:1216
msgid ""
":data:`sys.dont_write_bytecode` is initialized to the inverted value of :c:"
"member:`~PyConfig.write_bytecode`."
2020-07-20 08:56:42 +00:00
msgstr ""
#: c-api/init_config.rst:1223
msgid "Values of the :option:`-X` command line options: :data:`sys._xoptions`."
2020-07-20 08:56:42 +00:00
msgstr ""
#: c-api/init_config.rst:1227
2019-09-04 09:39:22 +00:00
msgid ""
"If :c:member:`~PyConfig.parse_argv` is non-zero, :c:member:`~PyConfig.argv` "
"arguments are parsed the same way the regular Python parses :ref:`command "
"line arguments <using-on-cmdline>`, and Python arguments are stripped from :"
"c:member:`~PyConfig.argv`."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1232
2019-09-04 09:39:22 +00:00
msgid ""
"The :c:member:`~PyConfig.xoptions` options are parsed to set other options: "
"see the :option:`-X` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1237
2020-07-20 08:56:42 +00:00
msgid "The ``show_alloc_count`` field has been removed."
msgstr ""
#: c-api/init_config.rst:1241
2019-09-04 09:39:22 +00:00
msgid "Initialization with PyConfig"
msgstr ""
#: c-api/init_config.rst:1243
2019-09-04 09:39:22 +00:00
msgid "Function to initialize Python:"
msgstr ""
#: c-api/init_config.rst:1247
2019-09-04 09:39:22 +00:00
msgid "Initialize Python from *config* configuration."
msgstr ""
#: c-api/init_config.rst:1252
msgid ""
"If :c:func:`PyImport_FrozenModules`, :c:func:`PyImport_AppendInittab` or :c:"
"func:`PyImport_ExtendInittab` are used, they must be set or called after "
"Python preinitialization and before the Python initialization. If Python is "
"initialized multiple times, :c:func:`PyImport_AppendInittab` or :c:func:"
"`PyImport_ExtendInittab` must be called before each Python initialization."
msgstr ""
#: c-api/init_config.rst:1259
2019-09-04 09:39:22 +00:00
msgid ""
"The current configuration (``PyConfig`` type) is stored in "
"``PyInterpreterState.config``."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1262
2019-09-04 09:39:22 +00:00
msgid "Example setting the program name::"
msgstr ""
#: c-api/init_config.rst:1290
2019-09-04 09:39:22 +00:00
msgid ""
"More complete example modifying the default configuration, read the "
2022-05-22 21:15:02 +00:00
"configuration, and then override some parameters. Note that since 3.11, many "
"parameters are not calculated until initialization, and so values cannot be "
"read from the configuration structure. Any values set before initialize is "
"called will be left unchanged by initialization::"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1353
2019-09-04 09:39:22 +00:00
msgid "Isolated Configuration"
msgstr ""
#: c-api/init_config.rst:1355
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 ""
#: c-api/init_config.rst:1360
2019-09-04 09:39:22 +00:00
msgid ""
2022-05-22 21:15:02 +00:00
"This configuration ignores global configuration variables, environment "
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 ""
#: c-api/init_config.rst:1365
2019-09-04 09:39:22 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"Configuration files are still used with this configuration to determine "
"paths that are unspecified. Ensure :c:member:`PyConfig.home` is specified to "
"avoid computing the default path configuration."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1373
2019-09-04 09:39:22 +00:00
msgid "Python Configuration"
msgstr ""
#: c-api/init_config.rst:1375
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 ""
#: c-api/init_config.rst:1379
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 ""
#: c-api/init_config.rst:1382
2019-09-04 09:39:22 +00:00
msgid ""
"This function enables C locale coercion (:pep:`538`) and :ref:`Python UTF-8 "
"Mode <utf8-mode>` (:pep:`540`) depending on the LC_CTYPE locale, :envvar:"
"`PYTHONUTF8` and :envvar:`PYTHONCOERCECLOCALE` environment variables."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1391
msgid "Python Path Configuration"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1393
2019-09-04 09:39:22 +00:00
msgid ":c:type:`PyConfig` contains multiple fields for the path configuration:"
msgstr ""
#: c-api/init_config.rst:1395
2019-10-09 16:10:12 +00:00
msgid "Path configuration inputs:"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1397
2019-09-04 09:39:22 +00:00
msgid ":c:member:`PyConfig.home`"
msgstr ""
#: c-api/init_config.rst:1398
2020-07-20 08:56:42 +00:00
msgid ":c:member:`PyConfig.platlibdir`"
msgstr ""
#: c-api/init_config.rst:1399
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.pathconfig_warnings`"
msgstr ""
#: c-api/init_config.rst:1400
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.program_name`"
msgstr ""
#: c-api/init_config.rst:1401
2019-09-04 09:39:22 +00:00
msgid ":c:member:`PyConfig.pythonpath_env`"
msgstr ""
#: c-api/init_config.rst:1402
2019-10-09 16:10:12 +00:00
msgid "current working directory: to get absolute paths"
msgstr ""
#: c-api/init_config.rst:1403
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 ""
#: c-api/init_config.rst:1405
2019-10-09 16:10:12 +00:00
msgid "``__PYVENV_LAUNCHER__`` environment variable"
msgstr ""
#: c-api/init_config.rst:1406
2019-10-09 16:10:12 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"(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)."
2019-10-09 16:10:12 +00:00
msgstr ""
#: c-api/init_config.rst:1410
2019-09-04 09:39:22 +00:00
msgid "Path configuration output fields:"
msgstr ""
#: c-api/init_config.rst:1412
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.base_exec_prefix`"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1413
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.base_executable`"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1414
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.base_prefix`"
msgstr ""
#: c-api/init_config.rst:1415
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.exec_prefix`"
msgstr ""
#: c-api/init_config.rst:1416
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.executable`"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1417
2019-09-04 09:39:22 +00:00
msgid ""
":c:member:`PyConfig.module_search_paths_set`, :c:member:`PyConfig."
"module_search_paths`"
msgstr ""
#: c-api/init_config.rst:1419
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.prefix`"
msgstr ""
#: c-api/init_config.rst:1421
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."
2022-05-22 21:15:02 +00:00
"module_search_paths_set` is equal to ``0``, :c:member:`~PyConfig."
2019-09-04 09:39:22 +00:00
"module_search_paths` is overridden and :c:member:`~PyConfig."
2022-05-22 21:15:02 +00:00
"module_search_paths_set` is set to ``1``."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1427
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`` "
2022-05-22 21:15:02 +00:00
"is set to ``1``. In this case, ``module_search_paths`` will be used without "
"modification."
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1434
2019-09-04 09:39:22 +00:00
msgid ""
2022-05-22 21:15:02 +00:00
"Set :c:member:`~PyConfig.pathconfig_warnings` to ``0`` to suppress warnings "
"when calculating the path configuration (Unix only, Windows does not log any "
2019-09-04 09:39:22 +00:00
"warning)."
msgstr ""
#: c-api/init_config.rst:1437
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 ""
#: c-api/init_config.rst:1441
2019-09-04 09:39:22 +00:00
msgid ":c:func:`Py_RunMain` and :c:func:`Py_Main` modify :data:`sys.path`:"
msgstr ""
#: c-api/init_config.rst:1443
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 ""
#: c-api/init_config.rst:1446
2019-09-04 09:39:22 +00:00
msgid "If :c:member:`~PyConfig.isolated` is zero:"
msgstr ""
#: c-api/init_config.rst:1448
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 ""
#: c-api/init_config.rst:1450
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 ""
#: c-api/init_config.rst:1452
2019-09-04 09:39:22 +00:00
msgid "Otherwise, prepend an empty string to :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:1454
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 ""
#: c-api/init_config.rst:1460
2019-09-04 09:39:22 +00:00
msgid "The following configuration files are used by the path configuration:"
msgstr ""
#: c-api/init_config.rst:1462
2019-09-04 09:39:22 +00:00
msgid "``pyvenv.cfg``"
msgstr ""
#: c-api/init_config.rst:1463
2022-05-22 21:15:02 +00:00
msgid "``._pth`` file (ex: ``python._pth``)"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1464
2019-09-04 09:39:22 +00:00
msgid "``pybuilddir.txt`` (Unix only)"
msgstr ""
#: c-api/init_config.rst:1466
2022-05-22 21:15:02 +00:00
msgid "If a ``._pth`` file is present:"
msgstr ""
#: c-api/init_config.rst:1468
2022-05-22 21:15:02 +00:00
msgid "Set :c:member:`~PyConfig.isolated` to ``1``."
msgstr ""
#: c-api/init_config.rst:1470
2022-05-22 21:15:02 +00:00
msgid "Set :c:member:`~PyConfig.site_import` to ``0``."
msgstr ""
#: c-api/init_config.rst:1471
2022-05-22 21:15:02 +00:00
msgid "Set :c:member:`~PyConfig.safe_path` to ``1``."
msgstr ""
#: c-api/init_config.rst:1473
2019-10-09 16:10:12 +00:00
msgid ""
"The ``__PYVENV_LAUNCHER__`` environment variable is used to set :c:member:"
"`PyConfig.base_executable`"
msgstr ""
#: c-api/init_config.rst:1478
2019-09-04 09:39:22 +00:00
msgid "Py_RunMain()"
msgstr ""
#: c-api/init_config.rst:1482
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 ""
#: c-api/init_config.rst:1487
2019-09-04 09:39:22 +00:00
msgid "By default and when if :option:`-i` option is used, run the REPL."
msgstr ""
#: c-api/init_config.rst:1489
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 ""
#: c-api/init_config.rst:1492
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 ""
#: c-api/init_config.rst:1498
2020-07-20 08:56:42 +00:00
msgid "Py_GetArgcArgv()"
msgstr ""
#: c-api/init_config.rst:1502
2020-07-20 08:56:42 +00:00
msgid "Get the original command line arguments, before Python modified them."
msgstr ""
#: c-api/init_config.rst:1504
msgid "See also :c:member:`PyConfig.orig_argv` member."
msgstr ""
#: c-api/init_config.rst:1508
2019-09-04 09:39:22 +00:00
msgid "Multi-Phase Initialization Private Provisional API"
msgstr ""
#: c-api/init_config.rst:1510
2019-09-04 09:39:22 +00:00
msgid ""
"This section is a private provisional API introducing multi-phase "
2022-05-22 21:15:02 +00:00
"initialization, the core feature of :pep:`432`:"
2019-09-04 09:39:22 +00:00
msgstr ""
#: c-api/init_config.rst:1513
2019-09-04 09:39:22 +00:00
msgid "\"Core\" initialization phase, \"bare minimum Python\":"
msgstr ""
#: c-api/init_config.rst:1515
2019-09-04 09:39:22 +00:00
msgid "Builtin types;"
msgstr ""
#: c-api/init_config.rst:1516
2019-09-04 09:39:22 +00:00
msgid "Builtin exceptions;"
msgstr ""
#: c-api/init_config.rst:1517
2019-09-04 09:39:22 +00:00
msgid "Builtin and frozen modules;"
msgstr ""
#: c-api/init_config.rst:1518
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 ""
#: c-api/init_config.rst:1521
2019-09-04 09:39:22 +00:00
msgid "\"Main\" initialization phase, Python is fully initialized:"
msgstr ""
#: c-api/init_config.rst:1523
2019-09-04 09:39:22 +00:00
msgid "Install and configure :mod:`importlib`;"
msgstr ""
#: c-api/init_config.rst:1524
2019-09-04 09:39:22 +00:00
msgid "Apply the :ref:`Path Configuration <init-path-config>`;"
msgstr ""
#: c-api/init_config.rst:1525
2019-09-04 09:39:22 +00:00
msgid "Install signal handlers;"
msgstr ""
#: c-api/init_config.rst:1526
2019-09-04 09:39:22 +00:00
msgid ""
"Finish :mod:`sys` module initialization (ex: create :data:`sys.stdout` and :"
"data:`sys.path`);"
msgstr ""
#: c-api/init_config.rst:1528
2019-09-04 09:39:22 +00:00
msgid ""
"Enable optional features like :mod:`faulthandler` and :mod:`tracemalloc`;"
msgstr ""
#: c-api/init_config.rst:1529
2019-09-04 09:39:22 +00:00
msgid "Import the :mod:`site` module;"
msgstr ""
#: c-api/init_config.rst:1530
2019-09-04 09:39:22 +00:00
msgid "etc."
msgstr ""
#: c-api/init_config.rst:1532
2019-09-04 09:39:22 +00:00
msgid "Private provisional API:"
msgstr ""
#: c-api/init_config.rst:1534
2019-09-04 09:39:22 +00:00
msgid ""
2022-05-22 21:15:02 +00:00
":c:member:`PyConfig._init_main`: if set to ``0``, :c:func:"
2019-09-04 09:39:22 +00:00
"`Py_InitializeFromConfig` stops at the \"Core\" initialization phase."
msgstr ""
#: c-api/init_config.rst:1536
2020-07-20 08:56:42 +00:00
msgid ""
":c:member:`PyConfig._isolated_interpreter`: if non-zero, disallow threads, "
"subprocesses and fork."
msgstr ""
#: c-api/init_config.rst:1541
2019-09-04 09:39:22 +00:00
msgid ""
"Move to the \"Main\" initialization phase, finish the Python initialization."
msgstr ""
#: c-api/init_config.rst:1543
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 ""
#: c-api/init_config.rst:1549
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 ""
#: c-api/init_config.rst:1553
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 ""
#: c-api/init_config.rst:1558
2019-09-04 09:39:22 +00:00
msgid ""
"Example running Python code between \"Core\" and \"Main\" initialization "
"phases::"
msgstr ""
#, fuzzy
#~ msgid "Functions:"
#~ msgstr "Fonctions :"
#, fuzzy
#~ msgid "Interactive mode."
#~ msgstr "Mode interactif"