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

1968 lines
53 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-03-23 17:40:12 +00:00
"POT-Creation-Date: 2022-03-23 18:39+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, "
"environments 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, "
"environments 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
msgid "*index* must be greater than or equal to 0."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:124 c-api/init_config.rst:528
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 ""
"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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:319 c-api/init_config.rst:649
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
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 ""
"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 ""
"If non-zero, enables the :ref:`Python Development Mode <devmode>`: see :c:"
"member:`PyConfig.dev_mode`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:655 c-api/init_config.rst:1123
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:820
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:833
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:597 c-api/init_config.rst:668
#: c-api/init_config.rst:792 c-api/init_config.rst:836
#: c-api/init_config.rst:910 c-api/init_config.rst:1019
#: c-api/init_config.rst:1087 c-api/init_config.rst:1158
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1132
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 ""
"Set by the :option:`-X utf8 <-X>` command line option and the :envvar:"
"`PYTHONUTF8` environment variable."
msgstr ""
#: c-api/init_config.rst:335
msgid "Default: ``-1`` in Python config and ``0`` in isolated config."
msgstr ""
#: c-api/init_config.rst:341
msgid "Preinitialize Python with PyPreConfig"
msgstr ""
#: c-api/init_config.rst:343
msgid "The preinitialization of Python:"
msgstr ""
#: c-api/init_config.rst:345
msgid "Set the Python memory allocators (:c:member:`PyPreConfig.allocator`)"
msgstr ""
#: c-api/init_config.rst:346
msgid "Configure the LC_CTYPE locale (:term:`locale encoding`)"
msgstr ""
#: c-api/init_config.rst:347
msgid ""
"Set the :ref:`Python UTF-8 Mode <utf8-mode>` (:c:member:`PyPreConfig."
"utf8_mode`)"
msgstr ""
#: c-api/init_config.rst:350
msgid ""
"The current preconfiguration (``PyPreConfig`` type) is stored in "
"``_PyRuntime.preconfig``."
msgstr ""
#: c-api/init_config.rst:353
msgid "Functions to preinitialize Python:"
msgstr ""
#: c-api/init_config.rst:363 c-api/init_config.rst:372
msgid "Preinitialize Python from *preconfig* preconfiguration."
msgstr ""
#: c-api/init_config.rst:368 c-api/init_config.rst:377
msgid "*preconfig* must not be ``NULL``."
msgstr ""
#: c-api/init_config.rst:365
msgid ""
"Parse *argv* command line arguments (bytes strings) if :c:member:"
"`~PyPreConfig.parse_argv` of *preconfig* is non-zero."
msgstr ""
#: c-api/init_config.rst:374
msgid ""
"Parse *argv* command line arguments (wide strings) if :c:member:"
"`~PyPreConfig.parse_argv` of *preconfig* is non-zero."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1220
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 ""
#: c-api/init_config.rst:382
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 ""
#: c-api/init_config.rst:389
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 ""
#: c-api/init_config.rst:394
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 ""
#: c-api/init_config.rst:399
msgid ""
"Example using the preinitialization to enable the :ref:`Python UTF-8 Mode "
"<utf8-mode>`::"
msgstr ""
#: c-api/init_config.rst:421
msgid "PyConfig"
msgstr ""
#: c-api/init_config.rst:425
msgid "Structure containing most parameters to configure Python."
msgstr ""
#: c-api/init_config.rst:427
msgid ""
"When done, the :c:func:`PyConfig_Clear` function must be used to release the "
"configuration memory."
msgstr ""
#: c-api/init_config.rst:430
msgid "Structure methods:"
msgstr ""
#: c-api/init_config.rst:434
msgid ""
"Initialize configuration with the :ref:`Python Configuration <init-python-"
"config>`."
msgstr ""
#: c-api/init_config.rst:439
msgid ""
"Initialize configuration with the :ref:`Isolated Configuration <init-"
"isolated-conf>`."
msgstr ""
#: c-api/init_config.rst:444
msgid "Copy the wide character string *str* into ``*config_str``."
msgstr ""
#: c-api/init_config.rst:453 c-api/init_config.rst:468
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:491
msgid ":ref:`Preinitialize Python <c-preinit>` if needed."
msgstr ""
#: c-api/init_config.rst:450
msgid ""
"Decode *str* using :c:func:`Py_DecodeLocale` and set the result into "
"``*config_str``."
msgstr ""
#: c-api/init_config.rst:457
msgid ""
"Set command line arguments (:c:member:`~PyConfig.argv` member of *config*) "
"from the *argv* list of wide character strings."
msgstr ""
#: c-api/init_config.rst:464
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 ""
#: c-api/init_config.rst:472
msgid "Set the list of wide strings *list* to *length* and *items*."
msgstr ""
#: c-api/init_config.rst:478
msgid "Read all Python configuration."
msgstr ""
#: c-api/init_config.rst:480
msgid "Fields which are already initialized are left unchanged."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:482
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:939
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:493
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:499
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 ""
#: c-api/init_config.rst:507
msgid "Release configuration memory."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:509
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:515
msgid ":c:member:`PyConfig.dev_mode`"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:516
msgid ":c:member:`PyConfig.isolated`"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:517
msgid ":c:member:`PyConfig.parse_argv`"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:518
msgid ":c:member:`PyConfig.use_environment`"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:520
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:525
msgid ""
"The caller of these methods is responsible to handle exceptions (error or "
"exit) using ``PyStatus_Exception()`` and ``Py_ExitStatusException()``."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:532
msgid "Command line arguments: :data:`sys.argv`."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:534
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:539
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:550 c-api/init_config.rst:570
#: c-api/init_config.rst:684 c-api/init_config.rst:880
#: c-api/init_config.rst:996 c-api/init_config.rst:1027
#: c-api/init_config.rst:1047
msgid "Default: ``NULL``."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:544
msgid "See also the :c:member:`~PyConfig.orig_argv` member."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:548
msgid ":data:`sys.base_exec_prefix`."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:564 c-api/init_config.rst:677
#: c-api/init_config.rst:897 c-api/init_config.rst:980
msgid "Part of the :ref:`Python Path Configuration <init-path-config>` output."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:556
msgid "Python base executable: :data:`sys._base_executable`."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:558
msgid "Set by the :envvar:`__PYVENV_LAUNCHER__` environment variable."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:560
msgid "Set from :c:member:`PyConfig.executable` if ``NULL``."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:568
msgid ":data:`sys.base_prefix`."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:576
msgid ""
"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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:579
msgid ""
"Set to 0 by the :option:`-u` command line option and the :envvar:"
"`PYTHONUNBUFFERED` environment variable."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:582
msgid "stdin is always opened in buffered mode."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:617 c-api/init_config.rst:1190
msgid "Default: ``1``."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:588
msgid ""
"If equals to 1, issue a warning when comparing :class:`bytes` or :class:"
"`bytearray` with :class:`str`, or comparing :class:`bytes` with :class:`int`."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:592
msgid ""
"If equal or greater to 2, raise a :exc:`BytesWarning` exception in these "
"cases."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:595
msgid "Incremented by the :option:`-b` command line option."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:601
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:610
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 ""
#: c-api/init_config.rst:614
msgid ""
"Set to ``0`` by the :envvar:`PYTHONNODEBUGRANGES` environment variable and "
"by the :option:`-X no_debug_ranges <-X>` command line option."
msgstr ""
#: c-api/init_config.rst:623
msgid ""
"Control the validation behavior of hash-based ``.pyc`` files: value of the :"
"option:`--check-hash-based-pycs` command line option."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:626
msgid "Valid values:"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:628
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:630
msgid "``L\"never\"``: Assume that hash-based pycs always are valid."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:631
msgid ""
"``L\"default\"``: The 'check_source' flag in hash-based pycs determines "
"invalidation."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:634
msgid "Default: ``L\"default\"``."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:636
msgid "See also :pep:`552` \"Deterministic pycs\"."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:640
msgid "If non-zero, configure C standard streams:"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:642
msgid ""
"On Windows, set the binary mode (``O_BINARY``) on stdin, stdout and stderr."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:644
msgid ""
"If :c:member:`~PyConfig.buffered_stdio` equals zero, disable buffering of "
"stdin, stdout and stderr streams."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:646
msgid ""
"If :c:member:`~PyConfig.interactive` is non-zero, enable stream buffering on "
"stdin and stdout (only stdout on Windows)."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:653
msgid "If non-zero, enable the :ref:`Python Development Mode <devmode>`."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:659
msgid "Dump Python references?"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:661
msgid "If non-zero, dump all objects which are still alive at exit."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:663
msgid "Set to ``1`` by the :envvar:`PYTHONDUMPREFS` environment variable."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:665
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:672
msgid ""
"The site-specific directory prefix where the platform-dependent Python files "
"are installed: :data:`sys.exec_prefix`."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:681
msgid ""
"The absolute path of the executable binary for the Python interpreter: :data:"
"`sys.executable`."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:690
msgid "Enable faulthandler?"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:692
msgid "If non-zero, call :func:`faulthandler.enable` at startup."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:694
msgid ""
"Set to ``1`` by :option:`-X faulthandler <-X>` and the :envvar:"
"`PYTHONFAULTHANDLER` environment variable."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:701
msgid ""
":term:`Filesystem encoding <filesystem encoding and error handler>`: :func:"
"`sys.getfilesystemencoding`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:704
msgid "On macOS, Android and VxWorks: use ``\"utf-8\"`` by default."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:706
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:710
msgid "Default encoding on other platforms:"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:712
msgid "``\"utf-8\"`` if :c:member:`PyPreConfig.utf8_mode` is non-zero."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:713
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:717
msgid "``\"utf-8\"`` if ``nl_langinfo(CODESET)`` returns an empty string."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:718
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:721
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:724
msgid "See also the :c:member:`~PyConfig.filesystem_errors` member."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:728
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:731
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:735
msgid "On other platforms: use ``\"surrogateescape\"`` by default."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:737
msgid "Supported error handlers:"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:739
msgid "``\"strict\"``"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:740
msgid "``\"surrogateescape\"``"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:741
msgid "``\"surrogatepass\"`` (only supported with the UTF-8 encoding)"
2019-10-09 16:10:12 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:743
msgid "See also the :c:member:`~PyConfig.filesystem_encoding` member."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:748
msgid "Randomized hash function seed."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:750
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:753
msgid "Set by the :envvar:`PYTHONHASHSEED` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:755
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:760
msgid "Python home directory."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:762
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:765
msgid "Set by the :envvar:`PYTHONHOME` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:862 c-api/init_config.rst:968
#: c-api/init_config.rst:998
msgid "Part of the :ref:`Python Path Configuration <init-path-config>` input."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:773
msgid "If non-zero, profile import time."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:775
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:782
msgid "Enter interactive mode after executing a script or a command."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:784
2019-09-04 09:39:22 +00:00
msgid ""
"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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:789
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:796
msgid "Install Python signal handlers?"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:945 c-api/init_config.rst:1142
msgid "Default: ``1`` in Python mode, ``0`` in isolated mode."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:802
msgid "If greater than 0, enable the interactive mode (REPL)."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:804
msgid "Incremented by the :option:`-i` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:810
msgid "If greater than 0, enable isolated mode:"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:812
msgid ""
":data:`sys.path` contains neither the script's directory (computed from "
"``argv[0]`` or the current directory) nor the user's site-packages directory."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:815
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:817
2019-09-04 09:39:22 +00:00
msgid ""
"Set :c:member:`~PyConfig.use_environment` and :c:member:`~PyConfig."
"user_site_directory` to 0."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:822
msgid "See also :c:member:`PyPreConfig.isolated`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:826
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:830
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:838
msgid "See also the :pep:`528` (Change Windows console encoding to UTF-8)."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:842
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:845
msgid "Set to ``1`` by the :envvar:`PYTHONMALLOCSTATS` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:847
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:854
msgid "Platform library directory name: :data:`sys.platlibdir`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:856
msgid "Set by the :envvar:`PYTHONPLATLIBDIR` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:858
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:866
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:875
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:878
msgid "Set by the :envvar:`PYTHONPATH` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:887
msgid "Module search paths: :data:`sys.path`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:889
msgid ""
2022-03-23 17:40:12 +00:00
"If :c:member:`~PyConfig.module_search_paths_set` is equal to 0, :c:func:"
"`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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:894
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:901
msgid "Compilation optimization level:"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:903
msgid "``0``: Peephole optimizer, set ``__debug__`` to ``True``."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:904
msgid "``1``: Level 0, remove assertions, set ``__debug__`` to ``False``."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:905
msgid "``2``: Level 1, strip docstrings."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:907
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:914
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:917
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:924
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1177 c-api/init_config.rst:1196
msgid "Default: empty list."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:933
msgid "Parse command line arguments?"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:935
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:947
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:953
msgid ""
"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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:956
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:963
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 "
"into ``stderr``. If equals to 0, suppress these warnings."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:970
msgid "Now also applies on Windows."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:975
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:984
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:987
msgid "If :func:`Py_SetProgramName` has been called, use its argument."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:988
msgid "On macOS, use :envvar:`PYTHONEXECUTABLE` environment variable if set."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:989
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:991
msgid ""
"Use ``argv[0]`` of :c:member:`~PyConfig.argv` if available and non-empty."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:993
msgid ""
"Otherwise, use ``L\"python\"`` on Windows, or ``L\"python3\"`` on other "
"platforms."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1002
msgid ""
"Directory where cached ``.pyc`` files are written: :data:`sys."
"pycache_prefix`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1005
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1008
msgid "If ``NULL``, :data:`sys.pycache_prefix` is set to ``None``."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1014
2019-10-09 16:10:12 +00:00
msgid ""
"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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1017
msgid "Incremented by the :option:`-q` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1023
msgid "Value of the :option:`-c` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1037 c-api/init_config.rst:1045
msgid "Used by :c:func:`Py_RunMain`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1031
msgid ""
"Filename passed on the command line: trailing command line argument without :"
"option:`-c` or :option:`-m`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1034
2019-09-04 09:39:22 +00:00
msgid ""
"For example, it is set to ``script.py`` by the ``python3 script.py arg`` "
"command."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1043
msgid "Value of the :option:`-m` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1051
msgid "Show total reference count at exit?"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1053
msgid "Set to 1 by :option:`-X showrefcount <-X>` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1055
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1062
msgid "Import the :mod:`site` module at startup?"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1064
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1067
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1070
msgid "Set to ``0`` by the :option:`-S` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1072
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1079
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1082
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1085
msgid "Set to ``1`` by the :option:`-x` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1092
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1096
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1099
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1102
msgid "Default encoding:"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1104
msgid "``\"UTF-8\"`` if :c:member:`PyPreConfig.utf8_mode` is non-zero."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1105
msgid "Otherwise, use the :term:`locale encoding`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1107
msgid "Default error handler:"
2019-10-09 16:10:12 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1109
msgid "On Windows: use ``\"surrogateescape\"``."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1110
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1112
msgid "``\"strict\"`` otherwise."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1116
msgid "Enable tracemalloc?"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1118
msgid "If non-zero, call :func:`tracemalloc.start` at startup."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1120
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1127
msgid "Use :ref:`environment variables <using-on-envvars>`?"
2019-10-09 16:10:12 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1129
msgid ""
"If equals to zero, ignore the :ref:`environment variables <using-on-"
"envvars>`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1136
msgid "If non-zero, add the user site directory to :data:`sys.path`."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1138
msgid "Set to ``0`` by the :option:`-s` and :option:`-I` command line options."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1140
msgid "Set to ``0`` by the :envvar:`PYTHONNOUSERSITE` environment variable."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1146
msgid ""
"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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1150
msgid ""
"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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1154
msgid "Incremented by the :option:`-v` command line option."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1156
msgid "Set to the :envvar:`PYTHONVERBOSE` environment variable value."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1162
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1165
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1170
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1173
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1181
msgid ""
"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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1184
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1187
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1194
msgid "Values of the :option:`-X` command line options: :data:`sys._xoptions`."
2020-07-20 08:56:42 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1198
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1203
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1208
2020-07-20 08:56:42 +00:00
msgid "The ``show_alloc_count`` field has been removed."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1212
2019-09-04 09:39:22 +00:00
msgid "Initialization with PyConfig"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1214
2019-09-04 09:39:22 +00:00
msgid "Function to initialize Python:"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1218
2019-09-04 09:39:22 +00:00
msgid "Initialize Python from *config* configuration."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1223
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1230
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1233
2019-09-04 09:39:22 +00:00
msgid "Example setting the program name::"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1261
2019-09-04 09:39:22 +00:00
msgid ""
"More complete example modifying the default configuration, read the "
"configuration, and then override some parameters::"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1312
2019-09-04 09:39:22 +00:00
msgid "Isolated Configuration"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1314
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1319
2019-09-04 09:39:22 +00:00
msgid ""
"This configuration ignores global configuration variables, environments "
2019-10-09 16:10:12 +00:00
"variables, command line arguments (:c:member:`PyConfig.argv` is not parsed) "
"and user site directory. The C standard streams (ex: ``stdout``) and the "
"LC_CTYPE locale are left unchanged. Signal handlers are not installed."
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1324
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1332
2019-09-04 09:39:22 +00:00
msgid "Python Configuration"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1334
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1338
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1341
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1350
msgid "Python Path Configuration"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1352
2019-09-04 09:39:22 +00:00
msgid ":c:type:`PyConfig` contains multiple fields for the path configuration:"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1354
2019-10-09 16:10:12 +00:00
msgid "Path configuration inputs:"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1356
2019-09-04 09:39:22 +00:00
msgid ":c:member:`PyConfig.home`"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1357
2020-07-20 08:56:42 +00:00
msgid ":c:member:`PyConfig.platlibdir`"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1358
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.pathconfig_warnings`"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1359
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.program_name`"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1360
2019-09-04 09:39:22 +00:00
msgid ":c:member:`PyConfig.pythonpath_env`"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1361
2019-10-09 16:10:12 +00:00
msgid "current working directory: to get absolute paths"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1362
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1364
2019-10-09 16:10:12 +00:00
msgid "``__PYVENV_LAUNCHER__`` environment variable"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1365
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1369
2019-09-04 09:39:22 +00:00
msgid "Path configuration output fields:"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1371
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1372
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.base_executable`"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1373
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.base_prefix`"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1374
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.exec_prefix`"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1375
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.executable`"
2019-09-04 09:39:22 +00:00
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1376
2019-09-04 09:39:22 +00:00
msgid ""
":c:member:`PyConfig.module_search_paths_set`, :c:member:`PyConfig."
"module_search_paths`"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1378
2019-10-09 16:10:12 +00:00
msgid ":c:member:`PyConfig.prefix`"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1380
2019-09-04 09:39:22 +00:00
msgid ""
2019-10-09 16:10:12 +00:00
"If at least one \"output field\" is not set, Python calculates the path "
2019-09-04 09:39:22 +00:00
"configuration to fill unset fields. If :c:member:`~PyConfig."
"module_search_paths_set` is equal to 0, :c:member:`~PyConfig."
"module_search_paths` is overridden and :c:member:`~PyConfig."
"module_search_paths_set` is set to 1."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1386
2019-09-04 09:39:22 +00:00
msgid ""
2019-10-09 16:10:12 +00:00
"It is possible to completely ignore the function calculating the default "
"path configuration by setting explicitly all path configuration output "
"fields listed above. A string is considered as set even if it is non-empty. "
2019-09-04 09:39:22 +00:00
"``module_search_paths`` is considered as set if ``module_search_paths_set`` "
"is set to 1. In this case, path configuration input fields are ignored as "
"well."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1393
2019-09-04 09:39:22 +00:00
msgid ""
"Set :c:member:`~PyConfig.pathconfig_warnings` to 0 to suppress warnings when "
2019-10-09 16:10:12 +00:00
"calculating the path configuration (Unix only, Windows does not log any "
2019-09-04 09:39:22 +00:00
"warning)."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1396
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1400
2019-09-04 09:39:22 +00:00
msgid ":c:func:`Py_RunMain` and :c:func:`Py_Main` modify :data:`sys.path`:"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1402
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1405
2019-09-04 09:39:22 +00:00
msgid "If :c:member:`~PyConfig.isolated` is zero:"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1407
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1409
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1411
2019-09-04 09:39:22 +00:00
msgid "Otherwise, prepend an empty string to :data:`sys.path`."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1413
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1419
2019-09-04 09:39:22 +00:00
msgid "The following configuration files are used by the path configuration:"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1421
2019-09-04 09:39:22 +00:00
msgid "``pyvenv.cfg``"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1422
2019-09-04 09:39:22 +00:00
msgid "``python._pth`` (Windows only)"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1423
2019-09-04 09:39:22 +00:00
msgid "``pybuilddir.txt`` (Unix only)"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1425
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1430
2019-09-04 09:39:22 +00:00
msgid "Py_RunMain()"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1434
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1439
2019-09-04 09:39:22 +00:00
msgid "By default and when if :option:`-i` option is used, run the REPL."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1441
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1444
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1450
2020-07-20 08:56:42 +00:00
msgid "Py_GetArgcArgv()"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1454
2020-07-20 08:56:42 +00:00
msgid "Get the original command line arguments, before Python modified them."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1456
msgid "See also :c:member:`PyConfig.orig_argv` member."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1460
2019-09-04 09:39:22 +00:00
msgid "Multi-Phase Initialization Private Provisional API"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1462
2019-09-04 09:39:22 +00:00
msgid ""
"This section is a private provisional API introducing multi-phase "
"initialization, the core feature of the :pep:`432`:"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1465
2019-09-04 09:39:22 +00:00
msgid "\"Core\" initialization phase, \"bare minimum Python\":"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1467
2019-09-04 09:39:22 +00:00
msgid "Builtin types;"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1468
2019-09-04 09:39:22 +00:00
msgid "Builtin exceptions;"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1469
2019-09-04 09:39:22 +00:00
msgid "Builtin and frozen modules;"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1470
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1473
2019-09-04 09:39:22 +00:00
msgid "\"Main\" initialization phase, Python is fully initialized:"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1475
2019-09-04 09:39:22 +00:00
msgid "Install and configure :mod:`importlib`;"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1476
2019-09-04 09:39:22 +00:00
msgid "Apply the :ref:`Path Configuration <init-path-config>`;"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1477
2019-09-04 09:39:22 +00:00
msgid "Install signal handlers;"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1478
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1480
2019-09-04 09:39:22 +00:00
msgid ""
"Enable optional features like :mod:`faulthandler` and :mod:`tracemalloc`;"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1481
2019-09-04 09:39:22 +00:00
msgid "Import the :mod:`site` module;"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1482
2019-09-04 09:39:22 +00:00
msgid "etc."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1484
2019-09-04 09:39:22 +00:00
msgid "Private provisional API:"
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1486
2019-09-04 09:39:22 +00:00
msgid ""
":c:member:`PyConfig._init_main`: if set to 0, :c:func:"
"`Py_InitializeFromConfig` stops at the \"Core\" initialization phase."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1488
2020-07-20 08:56:42 +00:00
msgid ""
":c:member:`PyConfig._isolated_interpreter`: if non-zero, disallow threads, "
"subprocesses and fork."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1493
2019-09-04 09:39:22 +00:00
msgid ""
"Move to the \"Main\" initialization phase, finish the Python initialization."
msgstr ""
2022-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1495
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1501
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1505
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-03-23 17:40:12 +00:00
#: c-api/init_config.rst:1510
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"