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"
2022-05-22 21:15:02 +00:00
"POT-Creation-Date: 2022-05-22 23:13+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
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:679 c-api/init_config.rst:1151
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:847
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:860
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:816 c-api/init_config.rst:863
#: c-api/init_config.rst:937 c-api/init_config.rst:1046
#: c-api/init_config.rst:1115 c-api/init_config.rst:1188
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1162
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1250
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:966
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:907
#: c-api/init_config.rst:1023 c-api/init_config.rst:1054
#: c-api/init_config.rst:1075
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:924 c-api/init_config.rst:1007
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:638 c-api/init_config.rst:1220
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 (or Roman8 encoding on HP-UX), whereas the ``mbstowcs()`` "
"function decodes from a different encoding (usually Latin1)."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:741
msgid "``\"utf-8\"`` if ``nl_langinfo(CODESET)`` returns an empty string."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:742
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:745
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:748
msgid "See also the :c:member:`~PyConfig.filesystem_errors` member."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:752
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:755
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:759
msgid "On other platforms: use ``\"surrogateescape\"`` by default."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:761
msgid "Supported error handlers:"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:763
msgid "``\"strict\"``"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:764
msgid "``\"surrogateescape\"``"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:765
msgid "``\"surrogatepass\"`` (only supported with the UTF-8 encoding)"
2019-10-09 16:10:12 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:767
msgid "See also the :c:member:`~PyConfig.filesystem_encoding` member."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:772
msgid "Randomized hash function seed."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:774
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:777
msgid "Set by the :envvar:`PYTHONHASHSEED` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:779
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:784
msgid "Python home directory."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:786
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:789
msgid "Set by the :envvar:`PYTHONHOME` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:889 c-api/init_config.rst:995
#: c-api/init_config.rst:1025
msgid "Part of the :ref:`Python Path Configuration <init-path-config>` input."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:797
msgid "If non-zero, profile import time."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:799
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:806
msgid "Enter interactive mode after executing a script or a command."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:808
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:813
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:820
msgid "Install Python signal handlers?"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:972 c-api/init_config.rst:1172
msgid "Default: ``1`` in Python mode, ``0`` in isolated mode."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:826
msgid "If greater than ``0``, enable the interactive mode (REPL)."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:828
msgid "Incremented by the :option:`-i` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:834
msgid "If greater than ``0``, enable isolated mode:"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:836
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1470
msgid "Set :c:member:`~PyConfig.use_environment` to ``0``."
msgstr ""
#: c-api/init_config.rst:840
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:842
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:845
msgid "Set to ``1`` by the :option:`-I` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:849
msgid "See also :c:member:`PyPreConfig.isolated`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:853
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:857
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:865
msgid "See also the :pep:`528` (Change Windows console encoding to UTF-8)."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:869
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:872
msgid "Set to ``1`` by the :envvar:`PYTHONMALLOCSTATS` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:874
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:881
msgid "Platform library directory name: :data:`sys.platlibdir`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:883
msgid "Set by the :envvar:`PYTHONPLATLIBDIR` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:885
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:893
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:902
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:905
msgid "Set by the :envvar:`PYTHONPATH` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:914
msgid "Module search paths: :data:`sys.path`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:916
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:921
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:928
msgid "Compilation optimization level:"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:930
msgid "``0``: Peephole optimizer, set ``__debug__`` to ``True``."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:931
msgid "``1``: Level 0, remove assertions, set ``__debug__`` to ``False``."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:932
msgid "``2``: Level 1, strip docstrings."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:934
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:941
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:944
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:951
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1207 c-api/init_config.rst:1226
msgid "Default: empty list."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:960
msgid "Parse command line arguments?"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:962
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:974
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:980
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:983
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:990
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:997
2022-03-23 17:40:12 +00:00
msgid "Now also applies on Windows."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1002
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1011
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1014
msgid "If :func:`Py_SetProgramName` has been called, use its argument."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1015
msgid "On macOS, use :envvar:`PYTHONEXECUTABLE` environment variable if set."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1016
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1018
msgid ""
"Use ``argv[0]`` of :c:member:`~PyConfig.argv` if available and non-empty."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1020
msgid ""
"Otherwise, use ``L\"python\"`` on Windows, or ``L\"python3\"`` 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:1029
msgid ""
"Directory where cached ``.pyc`` files are written: :data:`sys."
"pycache_prefix`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1032
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1035
msgid "If ``NULL``, :data:`sys.pycache_prefix` is set to ``None``."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1041
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1044
msgid "Incremented by the :option:`-q` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1050
msgid "Value of the :option:`-c` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1073
msgid "Used by :c:func:`Py_RunMain`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1058
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1062
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:1065
msgid "See also the :c:member:`PyConfig.skip_source_first_line` option."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1071
msgid "Value of the :option:`-m` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1079
msgid "Show total reference count at exit?"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1081
msgid "Set to ``1`` by :option:`-X showrefcount <-X>` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1083
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1090
msgid "Import the :mod:`site` module at startup?"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1092
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1095
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1098
msgid "Set to ``0`` by the :option:`-S` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1100
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1107
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1110
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1113
msgid "Set to ``1`` by the :option:`-x` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1120
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1124
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1127
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1130
msgid "Default encoding:"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1132
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:1133
msgid "Otherwise, use 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:1135
msgid "Default error handler:"
2019-10-09 16:10:12 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1137
msgid "On Windows: use ``\"surrogateescape\"``."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1138
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1140
msgid "``\"strict\"`` otherwise."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1144
msgid "Enable tracemalloc?"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1146
msgid "If non-zero, call :func:`tracemalloc.start` at startup."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1148
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1155
msgid "Use :ref:`environment variables <using-on-envvars>`?"
2019-10-09 16:10:12 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1157
msgid ""
"If equals to zero, ignore the :ref:`environment variables <using-on-"
"envvars>`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1160
msgid "Set to ``0`` by the :option:`-E` environment variable."
msgstr ""
#: c-api/init_config.rst:1166
msgid "If non-zero, add the user site directory to :data:`sys.path`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1168
msgid "Set to ``0`` by the :option:`-s` and :option:`-I` command line options."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1170
msgid "Set to ``0`` by the :envvar:`PYTHONNOUSERSITE` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1176
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1180
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1184
msgid "Incremented by the :option:`-v` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1186
msgid "Set to the :envvar:`PYTHONVERBOSE` environment variable value."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1192
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1195
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1200
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1203
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1211
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1214
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1217
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1224
msgid "Values of the :option:`-X` command line options: :data:`sys._xoptions`."
2020-07-20 08:56:42 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1228
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1233
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1238
2020-07-20 08:56:42 +00:00
msgid "The ``show_alloc_count`` field has been removed."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1242
2019-09-04 09:39:22 +00:00
msgid "Initialization with PyConfig"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1244
2019-09-04 09:39:22 +00:00
msgid "Function to initialize Python:"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1248
2019-09-04 09:39:22 +00:00
msgid "Initialize Python from *config* configuration."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1253
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1260
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1263
2019-09-04 09:39:22 +00:00
msgid "Example setting the program name::"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1291
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1354
2019-09-04 09:39:22 +00:00
msgid "Isolated Configuration"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1356
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1361
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1366
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1374
2019-09-04 09:39:22 +00:00
msgid "Python Configuration"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1376
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1380
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1383
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1392
msgid "Python Path Configuration"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1394
2019-09-04 09:39:22 +00:00
msgid ":c:type:`PyConfig` contains multiple fields for the path configuration:"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1396
2019-10-09 16:10:12 +00:00
msgid "Path configuration inputs:"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1398
2019-09-04 09:39:22 +00:00
msgid ":c:member:`PyConfig.home`"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1399
2020-07-20 08:56:42 +00:00
msgid ":c:member:`PyConfig.platlibdir`"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1400
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.pathconfig_warnings`"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1401
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.program_name`"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1402
2019-09-04 09:39:22 +00:00
msgid ":c:member:`PyConfig.pythonpath_env`"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1403
2019-10-09 16:10:12 +00:00
msgid "current working directory: to get absolute paths"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1404
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1406
2019-10-09 16:10:12 +00:00
msgid "``__PYVENV_LAUNCHER__`` environment variable"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1407
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1411
2019-09-04 09:39:22 +00:00
msgid "Path configuration output fields:"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1413
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.base_exec_prefix`"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1414
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.base_executable`"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1415
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.base_prefix`"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1416
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.exec_prefix`"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1417
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.executable`"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1418
2019-09-04 09:39:22 +00:00
msgid ""
":c:member:`PyConfig.module_search_paths_set`, :c:member:`PyConfig."
"module_search_paths`"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1420
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.prefix`"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1422
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1428
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1435
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1438
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1442
2019-09-04 09:39:22 +00:00
msgid ":c:func:`Py_RunMain` and :c:func:`Py_Main` modify :data:`sys.path`:"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1444
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1447
2019-09-04 09:39:22 +00:00
msgid "If :c:member:`~PyConfig.isolated` is zero:"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1449
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1451
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1453
2019-09-04 09:39:22 +00:00
msgid "Otherwise, prepend an empty string to :data:`sys.path`."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1455
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1461
2019-09-04 09:39:22 +00:00
msgid "The following configuration files are used by the path configuration:"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1463
2019-09-04 09:39:22 +00:00
msgid "``pyvenv.cfg``"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1464
msgid "``._pth`` file (ex: ``python._pth``)"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1465
2019-09-04 09:39:22 +00:00
msgid "``pybuilddir.txt`` (Unix only)"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1467
msgid "If a ``._pth`` file is present:"
msgstr ""
#: c-api/init_config.rst:1469
msgid "Set :c:member:`~PyConfig.isolated` to ``1``."
msgstr ""
#: c-api/init_config.rst:1471
msgid "Set :c:member:`~PyConfig.site_import` to ``0``."
msgstr ""
#: c-api/init_config.rst:1472
msgid "Set :c:member:`~PyConfig.safe_path` to ``1``."
msgstr ""
#: c-api/init_config.rst:1474
2019-10-09 16:10:12 +00:00
msgid ""
"The ``__PYVENV_LAUNCHER__`` environment variable is used to set :c:member:"
"`PyConfig.base_executable`"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1479
2019-09-04 09:39:22 +00:00
msgid "Py_RunMain()"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1483
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1488
2019-09-04 09:39:22 +00:00
msgid "By default and when if :option:`-i` option is used, run the REPL."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1490
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1493
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1499
2020-07-20 08:56:42 +00:00
msgid "Py_GetArgcArgv()"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1503
2020-07-20 08:56:42 +00:00
msgid "Get the original command line arguments, before Python modified them."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1505
msgid "See also :c:member:`PyConfig.orig_argv` member."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1509
2019-09-04 09:39:22 +00:00
msgid "Multi-Phase Initialization Private Provisional API"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1511
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1514
2019-09-04 09:39:22 +00:00
msgid "\"Core\" initialization phase, \"bare minimum Python\":"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1516
2019-09-04 09:39:22 +00:00
msgid "Builtin types;"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1517
2019-09-04 09:39:22 +00:00
msgid "Builtin exceptions;"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1518
2019-09-04 09:39:22 +00:00
msgid "Builtin and frozen modules;"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1519
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1522
2019-09-04 09:39:22 +00:00
msgid "\"Main\" initialization phase, Python is fully initialized:"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1524
2019-09-04 09:39:22 +00:00
msgid "Install and configure :mod:`importlib`;"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1525
2019-09-04 09:39:22 +00:00
msgid "Apply the :ref:`Path Configuration <init-path-config>`;"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1526
2019-09-04 09:39:22 +00:00
msgid "Install signal handlers;"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1527
2019-09-04 09:39:22 +00:00
msgid ""
"Finish :mod:`sys` module initialization (ex: create :data:`sys.stdout` and :"
"data:`sys.path`);"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1529
2019-09-04 09:39:22 +00:00
msgid ""
"Enable optional features like :mod:`faulthandler` and :mod:`tracemalloc`;"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1530
2019-09-04 09:39:22 +00:00
msgid "Import the :mod:`site` module;"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1531
2019-09-04 09:39:22 +00:00
msgid "etc."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1533
2019-09-04 09:39:22 +00:00
msgid "Private provisional API:"
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1535
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1537
2020-07-20 08:56:42 +00:00
msgid ""
":c:member:`PyConfig._isolated_interpreter`: if non-zero, disallow threads, "
"subprocesses and fork."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1542
2019-09-04 09:39:22 +00:00
msgid ""
"Move to the \"Main\" initialization phase, finish the Python initialization."
msgstr ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1544
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1550
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1554
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 ""
2022-05-22 21:15:02 +00:00
#: c-api/init_config.rst:1559
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"