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

2048 lines
55 KiB
Plaintext
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Copyright (C) 2001-2018, Python Software Foundation
# For licence information, see README file.
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-01-15 22:33+0100\n"
"PO-Revision-Date: 2019-09-04 11:42+0200\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: c-api/init_config.rst:7
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."
msgstr ""
#: c-api/init_config.rst:15
msgid "There are two kinds of configuration:"
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, "
"environment variables and command line arguments are used to configure "
"Python."
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, "
"environment variables are ignored, the LC_CTYPE locale is left unchanged and "
"no signal handler is registered."
msgstr ""
#: c-api/init_config.rst:27
msgid ""
"The :c:func:`Py_RunMain` function can be used to write a customized Python "
"program."
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
#, fuzzy
msgid "Example"
msgstr "Exemple ::"
#: c-api/init_config.rst:39
msgid "Example of customized Python always running in isolated mode::"
msgstr ""
#: c-api/init_config.rst:76
msgid "PyWideStringList"
msgstr ""
#: c-api/init_config.rst:80
msgid "List of ``wchar_t*`` strings."
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``."
msgstr ""
#: c-api/init_config.rst:85
#, fuzzy
msgid "Methods:"
msgstr "Méthodes :"
#: c-api/init_config.rst:89
msgid "Append *item* to *list*."
msgstr ""
#: c-api/init_config.rst:102
msgid "Python must be preinitialized to call this function."
msgstr ""
#: c-api/init_config.rst:95
msgid "Insert *item* into *list* at *index*."
msgstr ""
#: c-api/init_config.rst:97
msgid ""
"If *index* is greater than or equal to *list* length, append *item* to "
"*list*."
msgstr ""
#: c-api/init_config.rst:100
msgid "*index* must be greater than or equal to ``0``."
msgstr ""
#: c-api/init_config.rst:124 c-api/init_config.rst:530
msgid "Structure fields:"
msgstr ""
#: c-api/init_config.rst:108
msgid "List length."
msgstr ""
#: c-api/init_config.rst:112
msgid "List items."
msgstr ""
#: c-api/init_config.rst:115
msgid "PyStatus"
msgstr ""
#: c-api/init_config.rst:119
msgid ""
"Structure to store an initialization function status: success, error or exit."
msgstr ""
#: c-api/init_config.rst:122
msgid "For an error, it can store the C function name which created the error."
msgstr ""
#: c-api/init_config.rst:128
msgid "Exit code. Argument passed to ``exit()``."
msgstr ""
#: c-api/init_config.rst:132
msgid "Error message."
msgstr ""
#: c-api/init_config.rst:136
msgid "Name of the function which created an error, can be ``NULL``."
msgstr ""
#: c-api/init_config.rst:138
msgid "Functions to create a status:"
msgstr ""
#: c-api/init_config.rst:142
msgid "Success."
msgstr ""
#: c-api/init_config.rst:146
msgid "Initialization error with a message."
msgstr ""
#: c-api/init_config.rst:148
msgid "*err_msg* must not be ``NULL``."
msgstr ""
#: c-api/init_config.rst:152
msgid "Memory allocation failure (out of memory)."
msgstr ""
#: c-api/init_config.rst:156
msgid "Exit Python with the specified exit code."
msgstr ""
#: c-api/init_config.rst:158
msgid "Functions to handle a status:"
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."
msgstr ""
#: c-api/init_config.rst:167
msgid "Is the result an error?"
msgstr ""
#: c-api/init_config.rst:171
msgid "Is the result an exit?"
msgstr ""
#: c-api/init_config.rst:175
msgid ""
"Call ``exit(exitcode)`` if *status* is an exit. Print the error message and "
"exit with a non-zero exit code if *status* is an error. Must only be called "
"if ``PyStatus_Exception(status)`` is non-zero."
msgstr ""
#: c-api/init_config.rst:180
msgid ""
"Internally, Python uses macros which set ``PyStatus.func``, whereas "
"functions to create a status set ``func`` to ``NULL``."
msgstr ""
#: c-api/init_config.rst:183
msgid "Example::"
msgstr "Exemple ::"
#: c-api/init_config.rst:207
msgid "PyPreConfig"
msgstr ""
#: c-api/init_config.rst:211
msgid "Structure used to preinitialize Python."
msgstr ""
#: c-api/init_config.rst:213
msgid "Function to initialize a preconfiguration:"
msgstr ""
#: c-api/init_config.rst:217
msgid ""
"Initialize the preconfiguration with :ref:`Python Configuration <init-python-"
"config>`."
msgstr ""
#: c-api/init_config.rst:222
msgid ""
"Initialize the preconfiguration with :ref:`Isolated Configuration <init-"
"isolated-conf>`."
msgstr ""
#: c-api/init_config.rst:229
msgid "Name of the Python memory allocators:"
msgstr ""
#: c-api/init_config.rst:231
msgid ""
"``PYMEM_ALLOCATOR_NOT_SET`` (``0``): don't change memory allocators (use "
"defaults)."
msgstr ""
#: c-api/init_config.rst:233
msgid ""
"``PYMEM_ALLOCATOR_DEFAULT`` (``1``): :ref:`default memory allocators "
"<default-memory-allocators>`."
msgstr ""
#: c-api/init_config.rst:235
msgid ""
"``PYMEM_ALLOCATOR_DEBUG`` (``2``): :ref:`default memory allocators <default-"
"memory-allocators>` with :ref:`debug hooks <pymem-debug-hooks>`."
msgstr ""
#: c-api/init_config.rst:238
msgid "``PYMEM_ALLOCATOR_MALLOC`` (``3``): use ``malloc()`` of the C library."
msgstr ""
#: c-api/init_config.rst:239
msgid ""
"``PYMEM_ALLOCATOR_MALLOC_DEBUG`` (``4``): force usage of ``malloc()`` with :"
"ref:`debug hooks <pymem-debug-hooks>`."
msgstr ""
#: c-api/init_config.rst:241
msgid ""
"``PYMEM_ALLOCATOR_PYMALLOC`` (``5``): :ref:`Python pymalloc memory allocator "
"<pymalloc>`."
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>`."
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>`."
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
msgid ""
"If equals to ``0``, set :c:member:`~PyPreConfig.coerce_c_locale` and :c:"
"member:`~PyPreConfig.coerce_c_locale_warn` members to ``0``."
msgstr ""
#: c-api/init_config.rst:273
msgid "See the :term:`locale encoding`."
msgstr ""
#: c-api/init_config.rst:319 c-api/init_config.rst:670
msgid "Default: ``1`` in Python config, ``0`` in isolated config."
msgstr ""
#: c-api/init_config.rst:268
msgid "If equals to ``2``, coerce the C locale."
msgstr ""
#: c-api/init_config.rst:270
msgid ""
"If equals to ``1``, read the LC_CTYPE locale to decide if it should be "
"coerced."
msgstr ""
#: c-api/init_config.rst:281
msgid "Default: ``-1`` in Python config, ``0`` in isolated config."
msgstr ""
#: c-api/init_config.rst:279
msgid "If non-zero, emit a warning if the C locale is coerced."
msgstr ""
#: c-api/init_config.rst:285
msgid ""
":ref:`Python Development Mode <devmode>`: see :c:member:`PyConfig.dev_mode`."
msgstr ""
#: c-api/init_config.rst:679 c-api/init_config.rst:1150
msgid "Default: ``-1`` in Python mode, ``0`` in isolated mode."
msgstr ""
#: c-api/init_config.rst:292
msgid "Isolated mode: see :c:member:`PyConfig.isolated`."
msgstr ""
#: c-api/init_config.rst:846
msgid "Default: ``0`` in Python mode, ``1`` in isolated mode."
msgstr ""
#: c-api/init_config.rst:298
msgid "If non-zero:"
msgstr ""
#: c-api/init_config.rst:300
msgid "Set :c:member:`PyPreConfig.utf8_mode` to ``0``,"
msgstr ""
#: c-api/init_config.rst:301
msgid "Set :c:member:`PyConfig.filesystem_encoding` to ``\"mbcs\"``,"
msgstr ""
#: c-api/init_config.rst:302
msgid "Set :c:member:`PyConfig.filesystem_errors` to ``\"replace\"``."
msgstr ""
#: c-api/init_config.rst:304
msgid ""
"Initialized the from :envvar:`PYTHONLEGACYWINDOWSFSENCODING` environment "
"variable value."
msgstr ""
#: c-api/init_config.rst:859
msgid ""
"Only available on Windows. ``#ifdef MS_WINDOWS`` macro can be used for "
"Windows specific code."
msgstr ""
#: c-api/init_config.rst:618 c-api/init_config.rst:692
#: c-api/init_config.rst:815 c-api/init_config.rst:862
#: c-api/init_config.rst:936 c-api/init_config.rst:1045
#: c-api/init_config.rst:1114 c-api/init_config.rst:1187
msgid "Default: ``0``."
msgstr ""
#: c-api/init_config.rst:314
msgid ""
"If non-zero, :c:func:`Py_PreInitializeFromArgs` and :c:func:"
"`Py_PreInitializeFromBytesArgs` parse their ``argv`` argument the same way "
"the regular Python parses command line arguments: see :ref:`Command Line "
"Arguments <using-on-cmdline>`."
msgstr ""
#: c-api/init_config.rst:323
msgid ""
"Use :ref:`environment variables <using-on-envvars>`? See :c:member:`PyConfig."
"use_environment`."
msgstr ""
#: c-api/init_config.rst:1161
msgid "Default: ``1`` in Python config and ``0`` in isolated config."
msgstr ""
#: 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 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
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 ""
#: c-api/init_config.rst:343
msgid "Preinitialize Python with PyPreConfig"
msgstr ""
#: c-api/init_config.rst:345
msgid "The preinitialization of Python:"
msgstr ""
#: c-api/init_config.rst:347
msgid "Set the Python memory allocators (:c:member:`PyPreConfig.allocator`)"
msgstr ""
#: c-api/init_config.rst:348
msgid "Configure the LC_CTYPE locale (:term:`locale encoding`)"
msgstr ""
#: c-api/init_config.rst:349
msgid ""
"Set the :ref:`Python UTF-8 Mode <utf8-mode>` (:c:member:`PyPreConfig."
"utf8_mode`)"
msgstr ""
#: c-api/init_config.rst:352
msgid ""
"The current preconfiguration (``PyPreConfig`` type) is stored in "
"``_PyRuntime.preconfig``."
msgstr ""
#: c-api/init_config.rst:355
msgid "Functions to preinitialize Python:"
msgstr ""
#: c-api/init_config.rst:365 c-api/init_config.rst:374
msgid "Preinitialize Python from *preconfig* preconfiguration."
msgstr ""
#: c-api/init_config.rst:370 c-api/init_config.rst:379
msgid "*preconfig* must not be ``NULL``."
msgstr ""
#: 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 ""
#: c-api/init_config.rst:376
msgid ""
"Parse *argv* command line arguments (wide strings) if :c:member:"
"`~PyPreConfig.parse_argv` of *preconfig* is non-zero."
msgstr ""
#: c-api/init_config.rst:1249
msgid ""
"The caller is responsible to handle exceptions (error or exit) using :c:func:"
"`PyStatus_Exception` and :c:func:`Py_ExitStatusException`."
msgstr ""
#: 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 ""
#: 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 ""
#: 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 ""
#: c-api/init_config.rst:401
msgid ""
"Example using the preinitialization to enable the :ref:`Python UTF-8 Mode "
"<utf8-mode>`::"
msgstr ""
#: c-api/init_config.rst:423
msgid "PyConfig"
msgstr ""
#: c-api/init_config.rst:427
msgid "Structure containing most parameters to configure Python."
msgstr ""
#: c-api/init_config.rst:429
msgid ""
"When done, the :c:func:`PyConfig_Clear` function must be used to release the "
"configuration memory."
msgstr ""
#: c-api/init_config.rst:432
msgid "Structure methods:"
msgstr ""
#: c-api/init_config.rst:436
msgid ""
"Initialize configuration with the :ref:`Python Configuration <init-python-"
"config>`."
msgstr ""
#: c-api/init_config.rst:441
msgid ""
"Initialize configuration with the :ref:`Isolated Configuration <init-"
"isolated-conf>`."
msgstr ""
#: c-api/init_config.rst:446
msgid "Copy the wide character string *str* into ``*config_str``."
msgstr ""
#: 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 ""
#: c-api/init_config.rst:452
msgid ""
"Decode *str* using :c:func:`Py_DecodeLocale` and set the result into "
"``*config_str``."
msgstr ""
#: 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 ""
#: 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 ""
#: c-api/init_config.rst:474
msgid "Set the list of wide strings *list* to *length* and *items*."
msgstr ""
#: c-api/init_config.rst:480
msgid "Read all Python configuration."
msgstr ""
#: c-api/init_config.rst:482
msgid "Fields which are already initialized are left unchanged."
msgstr ""
#: c-api/init_config.rst:484
msgid ""
"Fields for :ref:`path configuration <init-path-config>` are no longer "
"calculated or modified when calling this function, as of Python 3.11."
msgstr ""
#: c-api/init_config.rst:965
msgid ""
"The :c:func:`PyConfig_Read` function only parses :c:member:`PyConfig.argv` "
"arguments once: :c:member:`PyConfig.parse_argv` is set to ``2`` after "
"arguments are parsed. Since Python arguments are strippped from :c:member:"
"`PyConfig.argv`, parsing arguments twice would parse the application options "
"as Python options."
msgstr ""
#: 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 ""
#: c-api/init_config.rst:501
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:509
msgid "Release configuration memory."
msgstr ""
#: 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 ""
#: c-api/init_config.rst:517
msgid ":c:member:`PyConfig.dev_mode`"
msgstr ""
#: c-api/init_config.rst:518
msgid ":c:member:`PyConfig.isolated`"
msgstr ""
#: c-api/init_config.rst:519
msgid ":c:member:`PyConfig.parse_argv`"
msgstr ""
#: c-api/init_config.rst:520
msgid ":c:member:`PyConfig.use_environment`"
msgstr ""
#: 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 ""
#: 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 ""
#: c-api/init_config.rst:534
msgid "Command line arguments: :data:`sys.argv`."
msgstr ""
#: 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 ""
#: 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."
msgstr ""
#: c-api/init_config.rst:571 c-api/init_config.rst:591
#: c-api/init_config.rst:708 c-api/init_config.rst:906
#: c-api/init_config.rst:1022 c-api/init_config.rst:1053
#: c-api/init_config.rst:1074
msgid "Default: ``NULL``."
msgstr ""
#: c-api/init_config.rst:546
msgid "See also the :c:member:`~PyConfig.orig_argv` member."
msgstr ""
#: 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 ""
#: c-api/init_config.rst:585 c-api/init_config.rst:701
#: c-api/init_config.rst:923 c-api/init_config.rst:1006
msgid "Part of the :ref:`Python Path Configuration <init-path-config>` output."
msgstr ""
#: c-api/init_config.rst:577
msgid "Python base executable: :data:`sys._base_executable`."
msgstr ""
#: c-api/init_config.rst:579
msgid "Set by the :envvar:`__PYVENV_LAUNCHER__` environment variable."
msgstr ""
#: c-api/init_config.rst:581
msgid "Set from :c:member:`PyConfig.executable` if ``NULL``."
msgstr ""
#: c-api/init_config.rst:589
msgid ":data:`sys.base_prefix`."
msgstr ""
#: c-api/init_config.rst:597
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 ""
#: c-api/init_config.rst:600
msgid ""
"Set to ``0`` by the :option:`-u` command line option and the :envvar:"
"`PYTHONUNBUFFERED` environment variable."
msgstr ""
#: c-api/init_config.rst:603
msgid "stdin is always opened in buffered mode."
msgstr ""
#: c-api/init_config.rst:638 c-api/init_config.rst:1219
msgid "Default: ``1``."
msgstr ""
#: c-api/init_config.rst:609
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 ""
#: c-api/init_config.rst:613
msgid ""
"If equal or greater to ``2``, raise a :exc:`BytesWarning` exception in these "
"cases."
msgstr ""
#: c-api/init_config.rst:616
msgid "Incremented by the :option:`-b` command line option."
msgstr ""
#: 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 ""
#: c-api/init_config.rst:631
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:635
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:644
msgid ""
"Control the validation behavior of hash-based ``.pyc`` files: value of the :"
"option:`--check-hash-based-pycs` command line option."
msgstr ""
#: c-api/init_config.rst:647
msgid "Valid values:"
msgstr ""
#: c-api/init_config.rst:649
msgid ""
"``L\"always\"``: Hash the source file for invalidation regardless of value "
"of the 'check_source' flag."
msgstr ""
#: c-api/init_config.rst:651
msgid "``L\"never\"``: Assume that hash-based pycs always are valid."
msgstr ""
#: c-api/init_config.rst:652
msgid ""
"``L\"default\"``: The 'check_source' flag in hash-based pycs determines "
"invalidation."
msgstr ""
#: c-api/init_config.rst:655
msgid "Default: ``L\"default\"``."
msgstr ""
#: c-api/init_config.rst:657
msgid "See also :pep:`552` \"Deterministic pycs\"."
msgstr ""
#: c-api/init_config.rst:661
msgid "If non-zero, configure C standard streams:"
msgstr ""
#: c-api/init_config.rst:663
msgid ""
"On Windows, set the binary mode (``O_BINARY``) on stdin, stdout and stderr."
msgstr ""
#: c-api/init_config.rst:665
msgid ""
"If :c:member:`~PyConfig.buffered_stdio` equals zero, disable buffering of "
"stdin, stdout and stderr streams."
msgstr ""
#: 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 ""
#: c-api/init_config.rst:674
msgid "If non-zero, enable the :ref:`Python Development Mode <devmode>`."
msgstr ""
#: 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
msgid "Dump Python references?"
msgstr ""
#: c-api/init_config.rst:685
msgid "If non-zero, dump all objects which are still alive at exit."
msgstr ""
#: c-api/init_config.rst:687
msgid "Set to ``1`` by the :envvar:`PYTHONDUMPREFS` environment variable."
msgstr ""
#: 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 ""
#: 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 ""
#: c-api/init_config.rst:705
msgid ""
"The absolute path of the executable binary for the Python interpreter: :data:"
"`sys.executable`."
msgstr ""
#: c-api/init_config.rst:714
msgid "Enable faulthandler?"
msgstr ""
#: c-api/init_config.rst:716
msgid "If non-zero, call :func:`faulthandler.enable` at startup."
msgstr ""
#: c-api/init_config.rst:718
msgid ""
"Set to ``1`` by :option:`-X faulthandler <-X>` and the :envvar:"
"`PYTHONFAULTHANDLER` environment variable."
msgstr ""
#: c-api/init_config.rst:725
msgid ""
":term:`Filesystem encoding <filesystem encoding and error handler>`: :func:"
"`sys.getfilesystemencoding`."
msgstr ""
#: c-api/init_config.rst:728
msgid "On macOS, Android and VxWorks: use ``\"utf-8\"`` by default."
msgstr ""
#: c-api/init_config.rst:730
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."
msgstr ""
#: c-api/init_config.rst:734
msgid "Default encoding on other platforms:"
msgstr ""
#: c-api/init_config.rst:736
msgid "``\"utf-8\"`` if :c:member:`PyPreConfig.utf8_mode` is non-zero."
msgstr ""
#: c-api/init_config.rst:737
msgid ""
"``\"ascii\"`` if Python detects that ``nl_langinfo(CODESET)`` announces the "
"ASCII encoding, whereas the ``mbstowcs()`` function decodes from a different "
"encoding (usually Latin1)."
msgstr ""
#: c-api/init_config.rst:740
msgid "``\"utf-8\"`` if ``nl_langinfo(CODESET)`` returns an empty string."
msgstr ""
#: c-api/init_config.rst:741
msgid ""
"Otherwise, use the :term:`locale encoding`: ``nl_langinfo(CODESET)`` result."
msgstr ""
#: c-api/init_config.rst:744
msgid ""
"At Python startup, the encoding name is normalized to the Python codec name. "
"For example, ``\"ANSI_X3.4-1968\"`` is replaced with ``\"ascii\"``."
msgstr ""
#: c-api/init_config.rst:747
msgid "See also the :c:member:`~PyConfig.filesystem_errors` member."
msgstr ""
#: c-api/init_config.rst:751
msgid ""
":term:`Filesystem error handler <filesystem encoding and error handler>`: :"
"func:`sys.getfilesystemencodeerrors`."
msgstr ""
#: c-api/init_config.rst:754
msgid ""
"On Windows: use ``\"surrogatepass\"`` by default, or ``\"replace\"`` if :c:"
"member:`~PyPreConfig.legacy_windows_fs_encoding` of :c:type:`PyPreConfig` is "
"non-zero."
msgstr ""
#: c-api/init_config.rst:758
msgid "On other platforms: use ``\"surrogateescape\"`` by default."
msgstr ""
#: c-api/init_config.rst:760
msgid "Supported error handlers:"
msgstr ""
#: c-api/init_config.rst:762
msgid "``\"strict\"``"
msgstr ""
#: c-api/init_config.rst:763
msgid "``\"surrogateescape\"``"
msgstr ""
#: c-api/init_config.rst:764
msgid "``\"surrogatepass\"`` (only supported with the UTF-8 encoding)"
msgstr ""
#: c-api/init_config.rst:766
msgid "See also the :c:member:`~PyConfig.filesystem_encoding` member."
msgstr ""
#: c-api/init_config.rst:771
msgid "Randomized hash function seed."
msgstr ""
#: c-api/init_config.rst:773
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."
msgstr ""
#: c-api/init_config.rst:776
msgid "Set by the :envvar:`PYTHONHASHSEED` environment variable."
msgstr ""
#: c-api/init_config.rst:778
msgid ""
"Default *use_hash_seed* value: ``-1`` in Python mode, ``0`` in isolated mode."
msgstr ""
#: c-api/init_config.rst:783
msgid "Python home directory."
msgstr ""
#: c-api/init_config.rst:785
msgid ""
"If :c:func:`Py_SetPythonHome` has been called, use its argument if it is not "
"``NULL``."
msgstr ""
#: c-api/init_config.rst:788
msgid "Set by the :envvar:`PYTHONHOME` environment variable."
msgstr ""
#: c-api/init_config.rst:888 c-api/init_config.rst:994
#: c-api/init_config.rst:1024
msgid "Part of the :ref:`Python Path Configuration <init-path-config>` input."
msgstr ""
#: c-api/init_config.rst:796
msgid "If non-zero, profile import time."
msgstr ""
#: c-api/init_config.rst:798
msgid ""
"Set the ``1`` by the :option:`-X importtime <-X>` option and the :envvar:"
"`PYTHONPROFILEIMPORTTIME` environment variable."
msgstr ""
#: c-api/init_config.rst:805
msgid "Enter interactive mode after executing a script or a command."
msgstr ""
#: c-api/init_config.rst:807
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."
msgstr ""
#: c-api/init_config.rst:812
msgid ""
"Incremented by the :option:`-i` command line option. Set to ``1`` if the :"
"envvar:`PYTHONINSPECT` environment variable is non-empty."
msgstr ""
#: c-api/init_config.rst:819
msgid "Install Python signal handlers?"
msgstr ""
#: c-api/init_config.rst:971 c-api/init_config.rst:1171
msgid "Default: ``1`` in Python mode, ``0`` in isolated mode."
msgstr ""
#: c-api/init_config.rst:825
msgid "If greater than ``0``, enable the interactive mode (REPL)."
msgstr ""
#: c-api/init_config.rst:827
msgid "Incremented by the :option:`-i` command line option."
msgstr ""
#: c-api/init_config.rst:833
msgid "If greater than ``0``, enable isolated mode:"
msgstr ""
#: c-api/init_config.rst:835
msgid ""
"Set :c:member:`~PyConfig.safe_path` to ``1``: don't prepend a potentially "
"unsafe path to :data:`sys.path` at Python startup."
msgstr ""
#: c-api/init_config.rst:1469
msgid "Set :c:member:`~PyConfig.use_environment` to ``0``."
msgstr ""
#: c-api/init_config.rst:839
msgid ""
"Set :c:member:`~PyConfig.user_site_directory` to ``0``: don't add the user "
"site directory to :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:841
msgid ""
"Python REPL doesn't import :mod:`readline` nor enable default readline "
"configuration on interactive prompts."
msgstr ""
#: c-api/init_config.rst:844
msgid "Set to ``1`` by the :option:`-I` command line option."
msgstr ""
#: c-api/init_config.rst:848
msgid "See also :c:member:`PyPreConfig.isolated`."
msgstr ""
#: c-api/init_config.rst:852
msgid ""
"If non-zero, use :class:`io.FileIO` instead of :class:`io.WindowsConsoleIO` "
"for :data:`sys.stdin`, :data:`sys.stdout` and :data:`sys.stderr`."
msgstr ""
#: c-api/init_config.rst:856
msgid ""
"Set to ``1`` if the :envvar:`PYTHONLEGACYWINDOWSSTDIO` environment variable "
"is set to a non-empty string."
msgstr ""
#: c-api/init_config.rst:864
msgid "See also the :pep:`528` (Change Windows console encoding to UTF-8)."
msgstr ""
#: c-api/init_config.rst:868
msgid ""
"If non-zero, dump statistics on :ref:`Python pymalloc memory allocator "
"<pymalloc>` at exit."
msgstr ""
#: c-api/init_config.rst:871
msgid "Set to ``1`` by the :envvar:`PYTHONMALLOCSTATS` environment variable."
msgstr ""
#: c-api/init_config.rst:873
msgid ""
"The option is ignored if Python is :option:`configured using the --without-"
"pymalloc option <--without-pymalloc>`."
msgstr ""
#: c-api/init_config.rst:880
msgid "Platform library directory name: :data:`sys.platlibdir`."
msgstr ""
#: c-api/init_config.rst:882
msgid "Set by the :envvar:`PYTHONPLATLIBDIR` environment variable."
msgstr ""
#: c-api/init_config.rst:884
msgid ""
"Default: value of the ``PLATLIBDIR`` macro which is set by the :option:"
"`configure --with-platlibdir option <--with-platlibdir>` (default: "
"``\"lib\"``, or ``\"DLLs\"`` on Windows)."
msgstr ""
#: c-api/init_config.rst:892
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."
msgstr ""
#: c-api/init_config.rst:901
msgid ""
"Module search paths (:data:`sys.path`) as a string separated by ``DELIM`` (:"
"data:`os.path.pathsep`)."
msgstr ""
#: c-api/init_config.rst:904
msgid "Set by the :envvar:`PYTHONPATH` environment variable."
msgstr ""
#: c-api/init_config.rst:913
msgid "Module search paths: :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:915
msgid ""
"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``."
msgstr ""
#: c-api/init_config.rst:920
msgid ""
"Default: empty list (``module_search_paths``) and ``0`` "
"(``module_search_paths_set``)."
msgstr ""
#: c-api/init_config.rst:927
msgid "Compilation optimization level:"
msgstr ""
#: c-api/init_config.rst:929
msgid "``0``: Peephole optimizer, set ``__debug__`` to ``True``."
msgstr ""
#: c-api/init_config.rst:930
msgid "``1``: Level 0, remove assertions, set ``__debug__`` to ``False``."
msgstr ""
#: c-api/init_config.rst:931
msgid "``2``: Level 1, strip docstrings."
msgstr ""
#: c-api/init_config.rst:933
msgid ""
"Incremented by the :option:`-O` command line option. Set to the :envvar:"
"`PYTHONOPTIMIZE` environment variable value."
msgstr ""
#: c-api/init_config.rst:940
msgid ""
"The list of the original command line arguments passed to the Python "
"executable: :data:`sys.orig_argv`."
msgstr ""
#: c-api/init_config.rst:943
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)."
msgstr ""
#: c-api/init_config.rst:950
msgid ""
"See also the :c:member:`~PyConfig.argv` member and the :c:func:"
"`Py_GetArgcArgv` function."
msgstr ""
#: c-api/init_config.rst:1206 c-api/init_config.rst:1225
msgid "Default: empty list."
msgstr ""
#: c-api/init_config.rst:959
msgid "Parse command line arguments?"
msgstr ""
#: c-api/init_config.rst:961
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`."
msgstr ""
#: c-api/init_config.rst:973
msgid ""
"The :c:member:`PyConfig.argv` arguments are now only parsed if :c:member:"
"`PyConfig.parse_argv` equals to ``1``."
msgstr ""
#: c-api/init_config.rst:979
msgid ""
"Parser debug mode. If greater than ``0``, turn on parser debugging output "
"(for expert only, depending on compilation options)."
msgstr ""
#: c-api/init_config.rst:982
msgid ""
"Incremented by the :option:`-d` command line option. Set to the :envvar:"
"`PYTHONDEBUG` environment variable value."
msgstr ""
#: c-api/init_config.rst:989
msgid ""
"If non-zero, calculation of path configuration is allowed to log warnings "
"into ``stderr``. If equals to ``0``, suppress these warnings."
msgstr ""
#: c-api/init_config.rst:996
msgid "Now also applies on Windows."
msgstr ""
#: c-api/init_config.rst:1001
msgid ""
"The site-specific directory prefix where the platform independent Python "
"files are installed: :data:`sys.prefix`."
msgstr ""
#: c-api/init_config.rst:1010
msgid ""
"Program name used to initialize :c:member:`~PyConfig.executable` and in "
"early error messages during Python initialization."
msgstr ""
#: c-api/init_config.rst:1013
msgid "If :func:`Py_SetProgramName` has been called, use its argument."
msgstr ""
#: c-api/init_config.rst:1014
msgid "On macOS, use :envvar:`PYTHONEXECUTABLE` environment variable if set."
msgstr ""
#: c-api/init_config.rst:1015
msgid ""
"If the ``WITH_NEXT_FRAMEWORK`` macro is defined, use :envvar:"
"`__PYVENV_LAUNCHER__` environment variable if set."
msgstr ""
#: c-api/init_config.rst:1017
msgid ""
"Use ``argv[0]`` of :c:member:`~PyConfig.argv` if available and non-empty."
msgstr ""
#: c-api/init_config.rst:1019
msgid ""
"Otherwise, use ``L\"python\"`` on Windows, or ``L\"python3\"`` on other "
"platforms."
msgstr ""
#: c-api/init_config.rst:1028
msgid ""
"Directory where cached ``.pyc`` files are written: :data:`sys."
"pycache_prefix`."
msgstr ""
#: c-api/init_config.rst:1031
msgid ""
"Set by the :option:`-X pycache_prefix=PATH <-X>` command line option and "
"the :envvar:`PYTHONPYCACHEPREFIX` environment variable."
msgstr ""
#: c-api/init_config.rst:1034
msgid "If ``NULL``, :data:`sys.pycache_prefix` is set to ``None``."
msgstr ""
#: c-api/init_config.rst:1040
msgid ""
"Quiet mode. If greater than ``0``, don't display the copyright and version "
"at Python startup in interactive mode."
msgstr ""
#: c-api/init_config.rst:1043
msgid "Incremented by the :option:`-q` command line option."
msgstr ""
#: c-api/init_config.rst:1049
msgid "Value of the :option:`-c` command line option."
msgstr ""
#: c-api/init_config.rst:1072
msgid "Used by :c:func:`Py_RunMain`."
msgstr ""
#: c-api/init_config.rst:1057
msgid ""
"Filename passed on the command line: trailing command line argument without :"
"option:`-c` or :option:`-m`. It is used by the :c:func:`Py_RunMain` function."
msgstr ""
#: c-api/init_config.rst:1061
msgid ""
"For example, it is set to ``script.py`` by the ``python3 script.py arg`` "
"command line."
msgstr ""
#: c-api/init_config.rst:1064
msgid "See also the :c:member:`PyConfig.skip_source_first_line` option."
msgstr ""
#: c-api/init_config.rst:1070
msgid "Value of the :option:`-m` command line option."
msgstr ""
#: c-api/init_config.rst:1078
msgid "Show total reference count at exit?"
msgstr ""
#: c-api/init_config.rst:1080
msgid "Set to ``1`` by :option:`-X showrefcount <-X>` command line option."
msgstr ""
#: c-api/init_config.rst:1082
msgid ""
"Need a :ref:`debug build of Python <debug-build>` (the ``Py_REF_DEBUG`` "
"macro must be defined)."
msgstr ""
#: c-api/init_config.rst:1089
msgid "Import the :mod:`site` module at startup?"
msgstr ""
#: c-api/init_config.rst:1091
msgid ""
"If equal to zero, disable the import of the module site and the site-"
"dependent manipulations of :data:`sys.path` that it entails."
msgstr ""
#: c-api/init_config.rst:1094
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)."
msgstr ""
#: c-api/init_config.rst:1097
msgid "Set to ``0`` by the :option:`-S` command line option."
msgstr ""
#: c-api/init_config.rst:1099
msgid ""
":data:`sys.flags.no_site` is set to the inverted value of :c:member:"
"`~PyConfig.site_import`."
msgstr ""
#: c-api/init_config.rst:1106
msgid ""
"If non-zero, skip the first line of the :c:member:`PyConfig.run_filename` "
"source."
msgstr ""
#: c-api/init_config.rst:1109
msgid ""
"It allows the usage of non-Unix forms of ``#!cmd``. This is intended for a "
"DOS specific hack only."
msgstr ""
#: c-api/init_config.rst:1112
msgid "Set to ``1`` by the :option:`-x` command line option."
msgstr ""
#: c-api/init_config.rst:1119
msgid ""
"Encoding and encoding errors of :data:`sys.stdin`, :data:`sys.stdout` and :"
"data:`sys.stderr` (but :data:`sys.stderr` always uses "
"``\"backslashreplace\"`` error handler)."
msgstr ""
#: c-api/init_config.rst:1123
msgid ""
"If :c:func:`Py_SetStandardStreamEncoding` has been called, use its *error* "
"and *errors* arguments if they are not ``NULL``."
msgstr ""
#: c-api/init_config.rst:1126
msgid ""
"Use the :envvar:`PYTHONIOENCODING` environment variable if it is non-empty."
msgstr ""
#: c-api/init_config.rst:1129
msgid "Default encoding:"
msgstr ""
#: c-api/init_config.rst:1131
msgid "``\"UTF-8\"`` if :c:member:`PyPreConfig.utf8_mode` is non-zero."
msgstr ""
#: c-api/init_config.rst:1132
msgid "Otherwise, use the :term:`locale encoding`."
msgstr ""
#: c-api/init_config.rst:1134
msgid "Default error handler:"
msgstr ""
#: c-api/init_config.rst:1136
msgid "On Windows: use ``\"surrogateescape\"``."
msgstr ""
#: c-api/init_config.rst:1137
msgid ""
"``\"surrogateescape\"`` if :c:member:`PyPreConfig.utf8_mode` is non-zero, or "
"if the LC_CTYPE locale is \"C\" or \"POSIX\"."
msgstr ""
#: c-api/init_config.rst:1139
msgid "``\"strict\"`` otherwise."
msgstr ""
#: c-api/init_config.rst:1143
msgid "Enable tracemalloc?"
msgstr ""
#: c-api/init_config.rst:1145
msgid "If non-zero, call :func:`tracemalloc.start` at startup."
msgstr ""
#: c-api/init_config.rst:1147
msgid ""
"Set by :option:`-X tracemalloc=N <-X>` command line option and by the :"
"envvar:`PYTHONTRACEMALLOC` environment variable."
msgstr ""
#: c-api/init_config.rst:1154
msgid "Use :ref:`environment variables <using-on-envvars>`?"
msgstr ""
#: c-api/init_config.rst:1156
msgid ""
"If equals to zero, ignore the :ref:`environment variables <using-on-"
"envvars>`."
msgstr ""
#: c-api/init_config.rst:1159
msgid "Set to ``0`` by the :option:`-E` environment variable."
msgstr ""
#: c-api/init_config.rst:1165
msgid "If non-zero, add the user site directory to :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:1167
msgid "Set to ``0`` by the :option:`-s` and :option:`-I` command line options."
msgstr ""
#: c-api/init_config.rst:1169
msgid "Set to ``0`` by the :envvar:`PYTHONNOUSERSITE` environment variable."
msgstr ""
#: c-api/init_config.rst:1175
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."
msgstr ""
#: c-api/init_config.rst:1179
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."
msgstr ""
#: c-api/init_config.rst:1183
msgid "Incremented by the :option:`-v` command line option."
msgstr ""
#: c-api/init_config.rst:1185
msgid "Set to the :envvar:`PYTHONVERBOSE` environment variable value."
msgstr ""
#: c-api/init_config.rst:1191
msgid ""
"Options of the :mod:`warnings` module to build warnings filters, lowest to "
"highest priority: :data:`sys.warnoptions`."
msgstr ""
#: c-api/init_config.rst:1194
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)."
msgstr ""
#: c-api/init_config.rst:1199
msgid ""
"The :option:`-W` command line options adds its value to :c:member:`~PyConfig."
"warnoptions`, it can be used multiple times."
msgstr ""
#: c-api/init_config.rst:1202
msgid ""
"The :envvar:`PYTHONWARNINGS` environment variable can also be used to add "
"warning options. Multiple options can be specified, separated by commas (``,"
"``)."
msgstr ""
#: c-api/init_config.rst:1210
msgid ""
"If equal to ``0``, Python won't try to write ``.pyc`` files on the import of "
"source modules."
msgstr ""
#: c-api/init_config.rst:1213
msgid ""
"Set to ``0`` by the :option:`-B` command line option and the :envvar:"
"`PYTHONDONTWRITEBYTECODE` environment variable."
msgstr ""
#: c-api/init_config.rst:1216
msgid ""
":data:`sys.dont_write_bytecode` is initialized to the inverted value of :c:"
"member:`~PyConfig.write_bytecode`."
msgstr ""
#: c-api/init_config.rst:1223
msgid "Values of the :option:`-X` command line options: :data:`sys._xoptions`."
msgstr ""
#: c-api/init_config.rst:1227
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`."
msgstr ""
#: c-api/init_config.rst:1232
msgid ""
"The :c:member:`~PyConfig.xoptions` options are parsed to set other options: "
"see the :option:`-X` command line option."
msgstr ""
#: c-api/init_config.rst:1237
msgid "The ``show_alloc_count`` field has been removed."
msgstr ""
#: c-api/init_config.rst:1241
msgid "Initialization with PyConfig"
msgstr ""
#: c-api/init_config.rst:1243
msgid "Function to initialize Python:"
msgstr ""
#: c-api/init_config.rst:1247
msgid "Initialize Python from *config* configuration."
msgstr ""
#: c-api/init_config.rst:1252
msgid ""
"If :c:func:`PyImport_FrozenModules`, :c:func:`PyImport_AppendInittab` or :c:"
"func:`PyImport_ExtendInittab` are used, they must be set or called after "
"Python preinitialization and before the Python initialization. If Python is "
"initialized multiple times, :c:func:`PyImport_AppendInittab` or :c:func:"
"`PyImport_ExtendInittab` must be called before each Python initialization."
msgstr ""
#: c-api/init_config.rst:1259
msgid ""
"The current configuration (``PyConfig`` type) is stored in "
"``PyInterpreterState.config``."
msgstr ""
#: c-api/init_config.rst:1262
msgid "Example setting the program name::"
msgstr ""
#: c-api/init_config.rst:1290
msgid ""
"More complete example modifying the default configuration, read the "
"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::"
msgstr ""
#: c-api/init_config.rst:1353
msgid "Isolated Configuration"
msgstr ""
#: c-api/init_config.rst:1355
msgid ""
":c:func:`PyPreConfig_InitIsolatedConfig` and :c:func:"
"`PyConfig_InitIsolatedConfig` functions create a configuration to isolate "
"Python from the system. For example, to embed Python into an application."
msgstr ""
#: c-api/init_config.rst:1360
msgid ""
"This configuration ignores global configuration variables, environment "
"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."
msgstr ""
#: c-api/init_config.rst:1365
msgid ""
"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."
msgstr ""
#: c-api/init_config.rst:1373
msgid "Python Configuration"
msgstr ""
#: c-api/init_config.rst:1375
msgid ""
":c:func:`PyPreConfig_InitPythonConfig` and :c:func:"
"`PyConfig_InitPythonConfig` functions create a configuration to build a "
"customized Python which behaves as the regular Python."
msgstr ""
#: c-api/init_config.rst:1379
msgid ""
"Environments variables and command line arguments are used to configure "
"Python, whereas global configuration variables are ignored."
msgstr ""
#: c-api/init_config.rst:1382
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."
msgstr ""
#: c-api/init_config.rst:1391
msgid "Python Path Configuration"
msgstr ""
#: c-api/init_config.rst:1393
msgid ":c:type:`PyConfig` contains multiple fields for the path configuration:"
msgstr ""
#: c-api/init_config.rst:1395
msgid "Path configuration inputs:"
msgstr ""
#: c-api/init_config.rst:1397
msgid ":c:member:`PyConfig.home`"
msgstr ""
#: c-api/init_config.rst:1398
msgid ":c:member:`PyConfig.platlibdir`"
msgstr ""
#: c-api/init_config.rst:1399
msgid ":c:member:`PyConfig.pathconfig_warnings`"
msgstr ""
#: c-api/init_config.rst:1400
msgid ":c:member:`PyConfig.program_name`"
msgstr ""
#: c-api/init_config.rst:1401
msgid ":c:member:`PyConfig.pythonpath_env`"
msgstr ""
#: c-api/init_config.rst:1402
msgid "current working directory: to get absolute paths"
msgstr ""
#: c-api/init_config.rst:1403
msgid ""
"``PATH`` environment variable to get the program full path (from :c:member:"
"`PyConfig.program_name`)"
msgstr ""
#: c-api/init_config.rst:1405
msgid "``__PYVENV_LAUNCHER__`` environment variable"
msgstr ""
#: c-api/init_config.rst:1406
msgid ""
"(Windows only) Application paths in the registry under "
"\"Software\\Python\\PythonCore\\X.Y\\PythonPath\" of HKEY_CURRENT_USER and "
"HKEY_LOCAL_MACHINE (where X.Y is the Python version)."
msgstr ""
#: c-api/init_config.rst:1410
msgid "Path configuration output fields:"
msgstr ""
#: c-api/init_config.rst:1412
msgid ":c:member:`PyConfig.base_exec_prefix`"
msgstr ""
#: c-api/init_config.rst:1413
msgid ":c:member:`PyConfig.base_executable`"
msgstr ""
#: c-api/init_config.rst:1414
msgid ":c:member:`PyConfig.base_prefix`"
msgstr ""
#: c-api/init_config.rst:1415
msgid ":c:member:`PyConfig.exec_prefix`"
msgstr ""
#: c-api/init_config.rst:1416
msgid ":c:member:`PyConfig.executable`"
msgstr ""
#: c-api/init_config.rst:1417
msgid ""
":c:member:`PyConfig.module_search_paths_set`, :c:member:`PyConfig."
"module_search_paths`"
msgstr ""
#: c-api/init_config.rst:1419
msgid ":c:member:`PyConfig.prefix`"
msgstr ""
#: c-api/init_config.rst:1421
msgid ""
"If at least one \"output field\" is not set, Python calculates the path "
"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 ""
#: c-api/init_config.rst:1427
msgid ""
"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. "
"``module_search_paths`` is considered as set if ``module_search_paths_set`` "
"is set to ``1``. In this case, ``module_search_paths`` will be used without "
"modification."
msgstr ""
#: c-api/init_config.rst:1434
msgid ""
"Set :c:member:`~PyConfig.pathconfig_warnings` to ``0`` to suppress warnings "
"when calculating the path configuration (Unix only, Windows does not log any "
"warning)."
msgstr ""
#: c-api/init_config.rst:1437
msgid ""
"If :c:member:`~PyConfig.base_prefix` or :c:member:`~PyConfig."
"base_exec_prefix` fields are not set, they inherit their value from :c:"
"member:`~PyConfig.prefix` and :c:member:`~PyConfig.exec_prefix` respectively."
msgstr ""
#: c-api/init_config.rst:1441
msgid ":c:func:`Py_RunMain` and :c:func:`Py_Main` modify :data:`sys.path`:"
msgstr ""
#: c-api/init_config.rst:1443
msgid ""
"If :c:member:`~PyConfig.run_filename` is set and is a directory which "
"contains a ``__main__.py`` script, prepend :c:member:`~PyConfig."
"run_filename` to :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:1446
msgid "If :c:member:`~PyConfig.isolated` is zero:"
msgstr ""
#: c-api/init_config.rst:1448
msgid ""
"If :c:member:`~PyConfig.run_module` is set, prepend the current directory "
"to :data:`sys.path`. Do nothing if the current directory cannot be read."
msgstr ""
#: c-api/init_config.rst:1450
msgid ""
"If :c:member:`~PyConfig.run_filename` is set, prepend the directory of the "
"filename to :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:1452
msgid "Otherwise, prepend an empty string to :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:1454
msgid ""
"If :c:member:`~PyConfig.site_import` is non-zero, :data:`sys.path` can be "
"modified by the :mod:`site` module. If :c:member:`~PyConfig."
"user_site_directory` is non-zero and the user's site-package directory "
"exists, the :mod:`site` module appends the user's site-package directory to :"
"data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:1460
msgid "The following configuration files are used by the path configuration:"
msgstr ""
#: c-api/init_config.rst:1462
msgid "``pyvenv.cfg``"
msgstr ""
#: c-api/init_config.rst:1463
msgid "``._pth`` file (ex: ``python._pth``)"
msgstr ""
#: c-api/init_config.rst:1464
msgid "``pybuilddir.txt`` (Unix only)"
msgstr ""
#: c-api/init_config.rst:1466
msgid "If a ``._pth`` file is present:"
msgstr ""
#: c-api/init_config.rst:1468
msgid "Set :c:member:`~PyConfig.isolated` to ``1``."
msgstr ""
#: c-api/init_config.rst:1470
msgid "Set :c:member:`~PyConfig.site_import` to ``0``."
msgstr ""
#: c-api/init_config.rst:1471
msgid "Set :c:member:`~PyConfig.safe_path` to ``1``."
msgstr ""
#: c-api/init_config.rst:1473
msgid ""
"The ``__PYVENV_LAUNCHER__`` environment variable is used to set :c:member:"
"`PyConfig.base_executable`"
msgstr ""
#: c-api/init_config.rst:1478
msgid "Py_RunMain()"
msgstr ""
#: c-api/init_config.rst:1482
msgid ""
"Execute the command (:c:member:`PyConfig.run_command`), the script (:c:"
"member:`PyConfig.run_filename`) or the module (:c:member:`PyConfig."
"run_module`) specified on the command line or in the configuration."
msgstr ""
#: c-api/init_config.rst:1487
msgid "By default and when if :option:`-i` option is used, run the REPL."
msgstr ""
#: c-api/init_config.rst:1489
msgid ""
"Finally, finalizes Python and returns an exit status that can be passed to "
"the ``exit()`` function."
msgstr ""
#: c-api/init_config.rst:1492
msgid ""
"See :ref:`Python Configuration <init-python-config>` for an example of "
"customized Python always running in isolated mode using :c:func:`Py_RunMain`."
msgstr ""
#: c-api/init_config.rst:1498
msgid "Py_GetArgcArgv()"
msgstr ""
#: c-api/init_config.rst:1502
msgid "Get the original command line arguments, before Python modified them."
msgstr ""
#: c-api/init_config.rst:1504
msgid "See also :c:member:`PyConfig.orig_argv` member."
msgstr ""
#: c-api/init_config.rst:1508
msgid "Multi-Phase Initialization Private Provisional API"
msgstr ""
#: c-api/init_config.rst:1510
msgid ""
"This section is a private provisional API introducing multi-phase "
"initialization, the core feature of :pep:`432`:"
msgstr ""
#: c-api/init_config.rst:1513
msgid "\"Core\" initialization phase, \"bare minimum Python\":"
msgstr ""
#: c-api/init_config.rst:1515
msgid "Builtin types;"
msgstr ""
#: c-api/init_config.rst:1516
msgid "Builtin exceptions;"
msgstr ""
#: c-api/init_config.rst:1517
msgid "Builtin and frozen modules;"
msgstr ""
#: c-api/init_config.rst:1518
msgid ""
"The :mod:`sys` module is only partially initialized (ex: :data:`sys.path` "
"doesn't exist yet)."
msgstr ""
#: c-api/init_config.rst:1521
msgid "\"Main\" initialization phase, Python is fully initialized:"
msgstr ""
#: c-api/init_config.rst:1523
msgid "Install and configure :mod:`importlib`;"
msgstr ""
#: c-api/init_config.rst:1524
msgid "Apply the :ref:`Path Configuration <init-path-config>`;"
msgstr ""
#: c-api/init_config.rst:1525
msgid "Install signal handlers;"
msgstr ""
#: c-api/init_config.rst:1526
msgid ""
"Finish :mod:`sys` module initialization (ex: create :data:`sys.stdout` and :"
"data:`sys.path`);"
msgstr ""
#: c-api/init_config.rst:1528
msgid ""
"Enable optional features like :mod:`faulthandler` and :mod:`tracemalloc`;"
msgstr ""
#: c-api/init_config.rst:1529
msgid "Import the :mod:`site` module;"
msgstr ""
#: c-api/init_config.rst:1530
msgid "etc."
msgstr ""
#: c-api/init_config.rst:1532
msgid "Private provisional API:"
msgstr ""
#: c-api/init_config.rst:1534
msgid ""
":c:member:`PyConfig._init_main`: if set to ``0``, :c:func:"
"`Py_InitializeFromConfig` stops at the \"Core\" initialization phase."
msgstr ""
#: c-api/init_config.rst:1536
msgid ""
":c:member:`PyConfig._isolated_interpreter`: if non-zero, disallow threads, "
"subprocesses and fork."
msgstr ""
#: c-api/init_config.rst:1541
msgid ""
"Move to the \"Main\" initialization phase, finish the Python initialization."
msgstr ""
#: c-api/init_config.rst:1543
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>`, "
"maybe install a custom :data:`sys.meta_path` importer or an import hook, etc."
msgstr ""
#: c-api/init_config.rst:1549
msgid ""
"It may become possible to calculatin the :ref:`Path Configuration <init-path-"
"config>` in Python, after the Core phase and before the Main phase, which is "
"one of the :pep:`432` motivation."
msgstr ""
#: c-api/init_config.rst:1553
msgid ""
"The \"Core\" phase is not properly defined: what should be and what should "
"not be available at this phase is not specified yet. The API is marked as "
"private and provisional: the API can be modified or even be removed anytime "
"until a proper public API is designed."
msgstr ""
#: c-api/init_config.rst:1558
msgid ""
"Example running Python code between \"Core\" and \"Main\" initialization "
"phases::"
msgstr ""
#, fuzzy
#~ msgid "Functions:"
#~ msgstr "Fonctions :"
#, fuzzy
#~ msgid "Interactive mode."
#~ msgstr "Mode interactif"