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

2048 lines
55 KiB
Plaintext
Raw Permalink 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: 2022-05-22 23:13+0200\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:1151
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:847
msgid "Default: ``0`` in Python mode, ``1`` in isolated mode."
msgstr ""
#: c-api/init_config.rst:298
msgid "If non-zero:"
msgstr ""
#: c-api/init_config.rst:300
msgid "Set :c:member:`PyPreConfig.utf8_mode` to ``0``,"
msgstr ""
#: c-api/init_config.rst:301
msgid "Set :c:member:`PyConfig.filesystem_encoding` to ``\"mbcs\"``,"
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:860
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:816 c-api/init_config.rst:863
#: c-api/init_config.rst:937 c-api/init_config.rst:1046
#: c-api/init_config.rst:1115 c-api/init_config.rst:1188
msgid "Default: ``0``."
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:1162
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:1250
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:966
msgid ""
"The :c:func:`PyConfig_Read` function only parses :c:member:`PyConfig.argv` "
"arguments once: :c:member:`PyConfig.parse_argv` is set to ``2`` after "
"arguments are parsed. Since Python arguments are strippped from :c:member:"
"`PyConfig.argv`, parsing arguments twice would parse the application options "
"as Python options."
msgstr ""
#: 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:907
#: c-api/init_config.rst:1023 c-api/init_config.rst:1054
#: c-api/init_config.rst:1075
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:924 c-api/init_config.rst:1007
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:1220
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 (or Roman8 encoding on HP-UX), whereas the ``mbstowcs()`` "
"function decodes from a different encoding (usually Latin1)."
msgstr ""
#: c-api/init_config.rst:741
msgid "``\"utf-8\"`` if ``nl_langinfo(CODESET)`` returns an empty string."
msgstr ""
#: c-api/init_config.rst:742
msgid ""
"Otherwise, use the :term:`locale encoding`: ``nl_langinfo(CODESET)`` result."
msgstr ""
#: c-api/init_config.rst:745
msgid ""
"At Python startup, the encoding name is normalized to the Python codec name. "
"For example, ``\"ANSI_X3.4-1968\"`` is replaced with ``\"ascii\"``."
msgstr ""
#: c-api/init_config.rst:748
msgid "See also the :c:member:`~PyConfig.filesystem_errors` member."
msgstr ""
#: c-api/init_config.rst:752
msgid ""
":term:`Filesystem error handler <filesystem encoding and error handler>`: :"
"func:`sys.getfilesystemencodeerrors`."
msgstr ""
#: c-api/init_config.rst:755
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:759
msgid "On other platforms: use ``\"surrogateescape\"`` by default."
msgstr ""
#: c-api/init_config.rst:761
msgid "Supported error handlers:"
msgstr ""
#: c-api/init_config.rst:763
msgid "``\"strict\"``"
msgstr ""
#: c-api/init_config.rst:764
msgid "``\"surrogateescape\"``"
msgstr ""
#: c-api/init_config.rst:765
msgid "``\"surrogatepass\"`` (only supported with the UTF-8 encoding)"
msgstr ""
#: c-api/init_config.rst:767
msgid "See also the :c:member:`~PyConfig.filesystem_encoding` member."
msgstr ""
#: c-api/init_config.rst:772
msgid "Randomized hash function seed."
msgstr ""
#: c-api/init_config.rst:774
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:777
msgid "Set by the :envvar:`PYTHONHASHSEED` environment variable."
msgstr ""
#: c-api/init_config.rst:779
msgid ""
"Default *use_hash_seed* value: ``-1`` in Python mode, ``0`` in isolated mode."
msgstr ""
#: c-api/init_config.rst:784
msgid "Python home directory."
msgstr ""
#: c-api/init_config.rst:786
msgid ""
"If :c:func:`Py_SetPythonHome` has been called, use its argument if it is not "
"``NULL``."
msgstr ""
#: c-api/init_config.rst:789
msgid "Set by the :envvar:`PYTHONHOME` environment variable."
msgstr ""
#: c-api/init_config.rst:889 c-api/init_config.rst:995
#: c-api/init_config.rst:1025
msgid "Part of the :ref:`Python Path Configuration <init-path-config>` input."
msgstr ""
#: c-api/init_config.rst:797
msgid "If non-zero, profile import time."
msgstr ""
#: c-api/init_config.rst:799
msgid ""
"Set the ``1`` by the :option:`-X importtime <-X>` option and the :envvar:"
"`PYTHONPROFILEIMPORTTIME` environment variable."
msgstr ""
#: c-api/init_config.rst:806
msgid "Enter interactive mode after executing a script or a command."
msgstr ""
#: c-api/init_config.rst:808
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:813
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:820
msgid "Install Python signal handlers?"
msgstr ""
#: c-api/init_config.rst:972 c-api/init_config.rst:1172
msgid "Default: ``1`` in Python mode, ``0`` in isolated mode."
msgstr ""
#: c-api/init_config.rst:826
msgid "If greater than ``0``, enable the interactive mode (REPL)."
msgstr ""
#: c-api/init_config.rst:828
msgid "Incremented by the :option:`-i` command line option."
msgstr ""
#: c-api/init_config.rst:834
msgid "If greater than ``0``, enable isolated mode:"
msgstr ""
#: c-api/init_config.rst:836
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:1470
msgid "Set :c:member:`~PyConfig.use_environment` to ``0``."
msgstr ""
#: c-api/init_config.rst:840
msgid ""
"Set :c:member:`~PyConfig.user_site_directory` to ``0``: don't add the user "
"site directory to :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:842
msgid ""
"Python REPL doesn't import :mod:`readline` nor enable default readline "
"configuration on interactive prompts."
msgstr ""
#: c-api/init_config.rst:845
msgid "Set to ``1`` by the :option:`-I` command line option."
msgstr ""
#: c-api/init_config.rst:849
msgid "See also :c:member:`PyPreConfig.isolated`."
msgstr ""
#: c-api/init_config.rst:853
msgid ""
"If non-zero, use :class:`io.FileIO` instead of :class:`io.WindowsConsoleIO` "
"for :data:`sys.stdin`, :data:`sys.stdout` and :data:`sys.stderr`."
msgstr ""
#: c-api/init_config.rst:857
msgid ""
"Set to ``1`` if the :envvar:`PYTHONLEGACYWINDOWSSTDIO` environment variable "
"is set to a non-empty string."
msgstr ""
#: c-api/init_config.rst:865
msgid "See also the :pep:`528` (Change Windows console encoding to UTF-8)."
msgstr ""
#: c-api/init_config.rst:869
msgid ""
"If non-zero, dump statistics on :ref:`Python pymalloc memory allocator "
"<pymalloc>` at exit."
msgstr ""
#: c-api/init_config.rst:872
msgid "Set to ``1`` by the :envvar:`PYTHONMALLOCSTATS` environment variable."
msgstr ""
#: c-api/init_config.rst:874
msgid ""
"The option is ignored if Python is :option:`configured using the --without-"
"pymalloc option <--without-pymalloc>`."
msgstr ""
#: c-api/init_config.rst:881
msgid "Platform library directory name: :data:`sys.platlibdir`."
msgstr ""
#: c-api/init_config.rst:883
msgid "Set by the :envvar:`PYTHONPLATLIBDIR` environment variable."
msgstr ""
#: c-api/init_config.rst:885
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:893
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:902
msgid ""
"Module search paths (:data:`sys.path`) as a string separated by ``DELIM`` (:"
"data:`os.path.pathsep`)."
msgstr ""
#: c-api/init_config.rst:905
msgid "Set by the :envvar:`PYTHONPATH` environment variable."
msgstr ""
#: c-api/init_config.rst:914
msgid "Module search paths: :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:916
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:921
msgid ""
"Default: empty list (``module_search_paths``) and ``0`` "
"(``module_search_paths_set``)."
msgstr ""
#: c-api/init_config.rst:928
msgid "Compilation optimization level:"
msgstr ""
#: c-api/init_config.rst:930
msgid "``0``: Peephole optimizer, set ``__debug__`` to ``True``."
msgstr ""
#: c-api/init_config.rst:931
msgid "``1``: Level 0, remove assertions, set ``__debug__`` to ``False``."
msgstr ""
#: c-api/init_config.rst:932
msgid "``2``: Level 1, strip docstrings."
msgstr ""
#: c-api/init_config.rst:934
msgid ""
"Incremented by the :option:`-O` command line option. Set to the :envvar:"
"`PYTHONOPTIMIZE` environment variable value."
msgstr ""
#: c-api/init_config.rst:941
msgid ""
"The list of the original command line arguments passed to the Python "
"executable: :data:`sys.orig_argv`."
msgstr ""
#: c-api/init_config.rst:944
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:951
msgid ""
"See also the :c:member:`~PyConfig.argv` member and the :c:func:"
"`Py_GetArgcArgv` function."
msgstr ""
#: c-api/init_config.rst:1207 c-api/init_config.rst:1226
msgid "Default: empty list."
msgstr ""
#: c-api/init_config.rst:960
msgid "Parse command line arguments?"
msgstr ""
#: c-api/init_config.rst:962
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:974
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:980
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:983
msgid ""
"Incremented by the :option:`-d` command line option. Set to the :envvar:"
"`PYTHONDEBUG` environment variable value."
msgstr ""
#: c-api/init_config.rst:990
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:997
msgid "Now also applies on Windows."
msgstr ""
#: c-api/init_config.rst:1002
msgid ""
"The site-specific directory prefix where the platform independent Python "
"files are installed: :data:`sys.prefix`."
msgstr ""
#: c-api/init_config.rst:1011
msgid ""
"Program name used to initialize :c:member:`~PyConfig.executable` and in "
"early error messages during Python initialization."
msgstr ""
#: c-api/init_config.rst:1014
msgid "If :func:`Py_SetProgramName` has been called, use its argument."
msgstr ""
#: c-api/init_config.rst:1015
msgid "On macOS, use :envvar:`PYTHONEXECUTABLE` environment variable if set."
msgstr ""
#: c-api/init_config.rst:1016
msgid ""
"If the ``WITH_NEXT_FRAMEWORK`` macro is defined, use :envvar:"
"`__PYVENV_LAUNCHER__` environment variable if set."
msgstr ""
#: c-api/init_config.rst:1018
msgid ""
"Use ``argv[0]`` of :c:member:`~PyConfig.argv` if available and non-empty."
msgstr ""
#: c-api/init_config.rst:1020
msgid ""
"Otherwise, use ``L\"python\"`` on Windows, or ``L\"python3\"`` on other "
"platforms."
msgstr ""
#: c-api/init_config.rst:1029
msgid ""
"Directory where cached ``.pyc`` files are written: :data:`sys."
"pycache_prefix`."
msgstr ""
#: c-api/init_config.rst:1032
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:1035
msgid "If ``NULL``, :data:`sys.pycache_prefix` is set to ``None``."
msgstr ""
#: c-api/init_config.rst:1041
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:1044
msgid "Incremented by the :option:`-q` command line option."
msgstr ""
#: c-api/init_config.rst:1050
msgid "Value of the :option:`-c` command line option."
msgstr ""
#: c-api/init_config.rst:1073
msgid "Used by :c:func:`Py_RunMain`."
msgstr ""
#: c-api/init_config.rst:1058
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:1062
msgid ""
"For example, it is set to ``script.py`` by the ``python3 script.py arg`` "
"command line."
msgstr ""
#: c-api/init_config.rst:1065
msgid "See also the :c:member:`PyConfig.skip_source_first_line` option."
msgstr ""
#: c-api/init_config.rst:1071
msgid "Value of the :option:`-m` command line option."
msgstr ""
#: c-api/init_config.rst:1079
msgid "Show total reference count at exit?"
msgstr ""
#: c-api/init_config.rst:1081
msgid "Set to ``1`` by :option:`-X showrefcount <-X>` command line option."
msgstr ""
#: c-api/init_config.rst:1083
msgid ""
"Need a :ref:`debug build of Python <debug-build>` (the ``Py_REF_DEBUG`` "
"macro must be defined)."
msgstr ""
#: c-api/init_config.rst:1090
msgid "Import the :mod:`site` module at startup?"
msgstr ""
#: c-api/init_config.rst:1092
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:1095
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:1098
msgid "Set to ``0`` by the :option:`-S` command line option."
msgstr ""
#: c-api/init_config.rst:1100
msgid ""
":data:`sys.flags.no_site` is set to the inverted value of :c:member:"
"`~PyConfig.site_import`."
msgstr ""
#: c-api/init_config.rst:1107
msgid ""
"If non-zero, skip the first line of the :c:member:`PyConfig.run_filename` "
"source."
msgstr ""
#: c-api/init_config.rst:1110
msgid ""
"It allows the usage of non-Unix forms of ``#!cmd``. This is intended for a "
"DOS specific hack only."
msgstr ""
#: c-api/init_config.rst:1113
msgid "Set to ``1`` by the :option:`-x` command line option."
msgstr ""
#: c-api/init_config.rst:1120
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:1124
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:1127
msgid ""
"Use the :envvar:`PYTHONIOENCODING` environment variable if it is non-empty."
msgstr ""
#: c-api/init_config.rst:1130
msgid "Default encoding:"
msgstr ""
#: c-api/init_config.rst:1132
msgid "``\"UTF-8\"`` if :c:member:`PyPreConfig.utf8_mode` is non-zero."
msgstr ""
#: c-api/init_config.rst:1133
msgid "Otherwise, use the :term:`locale encoding`."
msgstr ""
#: c-api/init_config.rst:1135
msgid "Default error handler:"
msgstr ""
#: c-api/init_config.rst:1137
msgid "On Windows: use ``\"surrogateescape\"``."
msgstr ""
#: c-api/init_config.rst:1138
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:1140
msgid "``\"strict\"`` otherwise."
msgstr ""
#: c-api/init_config.rst:1144
msgid "Enable tracemalloc?"
msgstr ""
#: c-api/init_config.rst:1146
msgid "If non-zero, call :func:`tracemalloc.start` at startup."
msgstr ""
#: c-api/init_config.rst:1148
msgid ""
"Set by :option:`-X tracemalloc=N <-X>` command line option and by the :"
"envvar:`PYTHONTRACEMALLOC` environment variable."
msgstr ""
#: c-api/init_config.rst:1155
msgid "Use :ref:`environment variables <using-on-envvars>`?"
msgstr ""
#: c-api/init_config.rst:1157
msgid ""
"If equals to zero, ignore the :ref:`environment variables <using-on-"
"envvars>`."
msgstr ""
#: c-api/init_config.rst:1160
msgid "Set to ``0`` by the :option:`-E` environment variable."
msgstr ""
#: c-api/init_config.rst:1166
msgid "If non-zero, add the user site directory to :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:1168
msgid "Set to ``0`` by the :option:`-s` and :option:`-I` command line options."
msgstr ""
#: c-api/init_config.rst:1170
msgid "Set to ``0`` by the :envvar:`PYTHONNOUSERSITE` environment variable."
msgstr ""
#: c-api/init_config.rst:1176
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:1180
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:1184
msgid "Incremented by the :option:`-v` command line option."
msgstr ""
#: c-api/init_config.rst:1186
msgid "Set to the :envvar:`PYTHONVERBOSE` environment variable value."
msgstr ""
#: c-api/init_config.rst:1192
msgid ""
"Options of the :mod:`warnings` module to build warnings filters, lowest to "
"highest priority: :data:`sys.warnoptions`."
msgstr ""
#: c-api/init_config.rst:1195
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:1200
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:1203
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:1211
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:1214
msgid ""
"Set to ``0`` by the :option:`-B` command line option and the :envvar:"
"`PYTHONDONTWRITEBYTECODE` environment variable."
msgstr ""
#: c-api/init_config.rst:1217
msgid ""
":data:`sys.dont_write_bytecode` is initialized to the inverted value of :c:"
"member:`~PyConfig.write_bytecode`."
msgstr ""
#: c-api/init_config.rst:1224
msgid "Values of the :option:`-X` command line options: :data:`sys._xoptions`."
msgstr ""
#: c-api/init_config.rst:1228
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:1233
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:1238
msgid "The ``show_alloc_count`` field has been removed."
msgstr ""
#: c-api/init_config.rst:1242
msgid "Initialization with PyConfig"
msgstr ""
#: c-api/init_config.rst:1244
msgid "Function to initialize Python:"
msgstr ""
#: c-api/init_config.rst:1248
msgid "Initialize Python from *config* configuration."
msgstr ""
#: c-api/init_config.rst:1253
msgid ""
"If :c:func:`PyImport_FrozenModules`, :c:func:`PyImport_AppendInittab` or :c:"
"func:`PyImport_ExtendInittab` are used, they must be set or called after "
"Python preinitialization and before the Python initialization. If Python is "
"initialized multiple times, :c:func:`PyImport_AppendInittab` or :c:func:"
"`PyImport_ExtendInittab` must be called before each Python initialization."
msgstr ""
#: c-api/init_config.rst:1260
msgid ""
"The current configuration (``PyConfig`` type) is stored in "
"``PyInterpreterState.config``."
msgstr ""
#: c-api/init_config.rst:1263
msgid "Example setting the program name::"
msgstr ""
#: c-api/init_config.rst:1291
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:1354
msgid "Isolated Configuration"
msgstr ""
#: c-api/init_config.rst:1356
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:1361
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:1366
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:1374
msgid "Python Configuration"
msgstr ""
#: c-api/init_config.rst:1376
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:1380
msgid ""
"Environments variables and command line arguments are used to configure "
"Python, whereas global configuration variables are ignored."
msgstr ""
#: c-api/init_config.rst:1383
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:1392
msgid "Python Path Configuration"
msgstr ""
#: c-api/init_config.rst:1394
msgid ":c:type:`PyConfig` contains multiple fields for the path configuration:"
msgstr ""
#: c-api/init_config.rst:1396
msgid "Path configuration inputs:"
msgstr ""
#: c-api/init_config.rst:1398
msgid ":c:member:`PyConfig.home`"
msgstr ""
#: c-api/init_config.rst:1399
msgid ":c:member:`PyConfig.platlibdir`"
msgstr ""
#: c-api/init_config.rst:1400
msgid ":c:member:`PyConfig.pathconfig_warnings`"
msgstr ""
#: c-api/init_config.rst:1401
msgid ":c:member:`PyConfig.program_name`"
msgstr ""
#: c-api/init_config.rst:1402
msgid ":c:member:`PyConfig.pythonpath_env`"
msgstr ""
#: c-api/init_config.rst:1403
msgid "current working directory: to get absolute paths"
msgstr ""
#: c-api/init_config.rst:1404
msgid ""
"``PATH`` environment variable to get the program full path (from :c:member:"
"`PyConfig.program_name`)"
msgstr ""
#: c-api/init_config.rst:1406
msgid "``__PYVENV_LAUNCHER__`` environment variable"
msgstr ""
#: c-api/init_config.rst:1407
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:1411
msgid "Path configuration output fields:"
msgstr ""
#: c-api/init_config.rst:1413
msgid ":c:member:`PyConfig.base_exec_prefix`"
msgstr ""
#: c-api/init_config.rst:1414
msgid ":c:member:`PyConfig.base_executable`"
msgstr ""
#: c-api/init_config.rst:1415
msgid ":c:member:`PyConfig.base_prefix`"
msgstr ""
#: c-api/init_config.rst:1416
msgid ":c:member:`PyConfig.exec_prefix`"
msgstr ""
#: c-api/init_config.rst:1417
msgid ":c:member:`PyConfig.executable`"
msgstr ""
#: c-api/init_config.rst:1418
msgid ""
":c:member:`PyConfig.module_search_paths_set`, :c:member:`PyConfig."
"module_search_paths`"
msgstr ""
#: c-api/init_config.rst:1420
msgid ":c:member:`PyConfig.prefix`"
msgstr ""
#: c-api/init_config.rst:1422
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:1428
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:1435
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:1438
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:1442
msgid ":c:func:`Py_RunMain` and :c:func:`Py_Main` modify :data:`sys.path`:"
msgstr ""
#: c-api/init_config.rst:1444
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:1447
msgid "If :c:member:`~PyConfig.isolated` is zero:"
msgstr ""
#: c-api/init_config.rst:1449
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:1451
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:1453
msgid "Otherwise, prepend an empty string to :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:1455
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:1461
msgid "The following configuration files are used by the path configuration:"
msgstr ""
#: c-api/init_config.rst:1463
msgid "``pyvenv.cfg``"
msgstr ""
#: c-api/init_config.rst:1464
msgid "``._pth`` file (ex: ``python._pth``)"
msgstr ""
#: c-api/init_config.rst:1465
msgid "``pybuilddir.txt`` (Unix only)"
msgstr ""
#: c-api/init_config.rst:1467
msgid "If a ``._pth`` file is present:"
msgstr ""
#: c-api/init_config.rst:1469
msgid "Set :c:member:`~PyConfig.isolated` to ``1``."
msgstr ""
#: c-api/init_config.rst:1471
msgid "Set :c:member:`~PyConfig.site_import` to ``0``."
msgstr ""
#: c-api/init_config.rst:1472
msgid "Set :c:member:`~PyConfig.safe_path` to ``1``."
msgstr ""
#: c-api/init_config.rst:1474
msgid ""
"The ``__PYVENV_LAUNCHER__`` environment variable is used to set :c:member:"
"`PyConfig.base_executable`"
msgstr ""
#: c-api/init_config.rst:1479
msgid "Py_RunMain()"
msgstr ""
#: c-api/init_config.rst:1483
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:1488
msgid "By default and when if :option:`-i` option is used, run the REPL."
msgstr ""
#: c-api/init_config.rst:1490
msgid ""
"Finally, finalizes Python and returns an exit status that can be passed to "
"the ``exit()`` function."
msgstr ""
#: c-api/init_config.rst:1493
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:1499
msgid "Py_GetArgcArgv()"
msgstr ""
#: c-api/init_config.rst:1503
msgid "Get the original command line arguments, before Python modified them."
msgstr ""
#: c-api/init_config.rst:1505
msgid "See also :c:member:`PyConfig.orig_argv` member."
msgstr ""
#: c-api/init_config.rst:1509
msgid "Multi-Phase Initialization Private Provisional API"
msgstr ""
#: c-api/init_config.rst:1511
msgid ""
"This section is a private provisional API introducing multi-phase "
"initialization, the core feature of :pep:`432`:"
msgstr ""
#: c-api/init_config.rst:1514
msgid "\"Core\" initialization phase, \"bare minimum Python\":"
msgstr ""
#: c-api/init_config.rst:1516
msgid "Builtin types;"
msgstr ""
#: c-api/init_config.rst:1517
msgid "Builtin exceptions;"
msgstr ""
#: c-api/init_config.rst:1518
msgid "Builtin and frozen modules;"
msgstr ""
#: c-api/init_config.rst:1519
msgid ""
"The :mod:`sys` module is only partially initialized (ex: :data:`sys.path` "
"doesn't exist yet)."
msgstr ""
#: c-api/init_config.rst:1522
msgid "\"Main\" initialization phase, Python is fully initialized:"
msgstr ""
#: c-api/init_config.rst:1524
msgid "Install and configure :mod:`importlib`;"
msgstr ""
#: c-api/init_config.rst:1525
msgid "Apply the :ref:`Path Configuration <init-path-config>`;"
msgstr ""
#: c-api/init_config.rst:1526
msgid "Install signal handlers;"
msgstr ""
#: c-api/init_config.rst:1527
msgid ""
"Finish :mod:`sys` module initialization (ex: create :data:`sys.stdout` and :"
"data:`sys.path`);"
msgstr ""
#: c-api/init_config.rst:1529
msgid ""
"Enable optional features like :mod:`faulthandler` and :mod:`tracemalloc`;"
msgstr ""
#: c-api/init_config.rst:1530
msgid "Import the :mod:`site` module;"
msgstr ""
#: c-api/init_config.rst:1531
msgid "etc."
msgstr ""
#: c-api/init_config.rst:1533
msgid "Private provisional API:"
msgstr ""
#: c-api/init_config.rst:1535
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:1537
msgid ""
":c:member:`PyConfig._isolated_interpreter`: if non-zero, disallow threads, "
"subprocesses and fork."
msgstr ""
#: c-api/init_config.rst:1542
msgid ""
"Move to the \"Main\" initialization phase, finish the Python initialization."
msgstr ""
#: c-api/init_config.rst:1544
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:1550
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:1554
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:1559
msgid ""
"Example running Python code between \"Core\" and \"Main\" initialization "
"phases::"
msgstr ""
#, fuzzy
#~ msgid "Functions:"
#~ msgstr "Fonctions"
#, fuzzy
#~ msgid "Interactive mode."
#~ msgstr "Mode interactif"