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

1936 lines
52 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: 2021-10-21 15:04+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, "
"environments 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, "
"environments 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:519
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:627
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 ""
"If non-zero, enables the :ref:`Python Development Mode <devmode>`: see :c:"
"member:`PyConfig.dev_mode`."
msgstr ""
#: c-api/init_config.rst:633 c-api/init_config.rst:1094
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:798
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:811
msgid ""
"Only available on Windows. ``#ifdef MS_WINDOWS`` macro can be used for "
"Windows specific code."
msgstr ""
#: c-api/init_config.rst:588 c-api/init_config.rst:646
#: c-api/init_config.rst:770 c-api/init_config.rst:814
#: c-api/init_config.rst:881 c-api/init_config.rst:990
#: c-api/init_config.rst:1058 c-api/init_config.rst:1129
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:1103
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 by the :option:`-X utf8 <-X>` command line option and the :envvar:"
"`PYTHONUTF8` environment variable."
msgstr ""
#: c-api/init_config.rst:335
msgid "Default: ``-1`` in Python config and ``0`` in isolated config."
msgstr ""
#: c-api/init_config.rst:341
msgid "Preinitialize Python with PyPreConfig"
msgstr ""
#: c-api/init_config.rst:343
msgid "The preinitialization of Python:"
msgstr ""
#: c-api/init_config.rst:345
msgid "Set the Python memory allocators (:c:member:`PyPreConfig.allocator`)"
msgstr ""
#: c-api/init_config.rst:346
msgid "Configure the LC_CTYPE locale (:term:`locale encoding`)"
msgstr ""
#: c-api/init_config.rst:347
msgid ""
"Set the :ref:`Python UTF-8 Mode <utf8-mode>` (:c:member:`PyPreConfig."
"utf8_mode`)"
msgstr ""
#: c-api/init_config.rst:350
msgid ""
"The current preconfiguration (``PyPreConfig`` type) is stored in "
"``_PyRuntime.preconfig``."
msgstr ""
#: c-api/init_config.rst:353
msgid "Functions to preinitialize Python:"
msgstr ""
#: c-api/init_config.rst:363 c-api/init_config.rst:372
msgid "Preinitialize Python from *preconfig* preconfiguration."
msgstr ""
#: c-api/init_config.rst:368 c-api/init_config.rst:377
msgid "*preconfig* must not be ``NULL``."
msgstr ""
#: c-api/init_config.rst:365
msgid ""
"Parse *argv* command line arguments (bytes strings) if :c:member:"
"`~PyPreConfig.parse_argv` of *preconfig* is non-zero."
msgstr ""
#: c-api/init_config.rst:374
msgid ""
"Parse *argv* command line arguments (wide strings) if :c:member:"
"`~PyPreConfig.parse_argv` of *preconfig* is non-zero."
msgstr ""
#: c-api/init_config.rst:1191
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:382
msgid ""
"For :ref:`Python Configuration <init-python-config>` (:c:func:"
"`PyPreConfig_InitPythonConfig`), if Python is initialized with command line "
"arguments, the command line arguments must also be passed to preinitialize "
"Python, since they have an effect on the pre-configuration like encodings. "
"For example, the :option:`-X utf8 <-X>` command line option enables the :ref:"
"`Python UTF-8 Mode <utf8-mode>`."
msgstr ""
#: c-api/init_config.rst:389
msgid ""
"``PyMem_SetAllocator()`` can be called after :c:func:`Py_PreInitialize` and "
"before :c:func:`Py_InitializeFromConfig` to install a custom memory "
"allocator. It can be called before :c:func:`Py_PreInitialize` if :c:member:"
"`PyPreConfig.allocator` is set to ``PYMEM_ALLOCATOR_NOT_SET``."
msgstr ""
#: c-api/init_config.rst:394
msgid ""
"Python memory allocation functions like :c:func:`PyMem_RawMalloc` must not "
"be used before the Python preinitialization, whereas calling directly "
"``malloc()`` and ``free()`` is always safe. :c:func:`Py_DecodeLocale` must "
"not be called before the Python preinitialization."
msgstr ""
#: c-api/init_config.rst:399
msgid ""
"Example using the preinitialization to enable the :ref:`Python UTF-8 Mode "
"<utf8-mode>`::"
msgstr ""
#: c-api/init_config.rst:421
msgid "PyConfig"
msgstr ""
#: c-api/init_config.rst:425
msgid "Structure containing most parameters to configure Python."
msgstr ""
#: c-api/init_config.rst:427
msgid ""
"When done, the :c:func:`PyConfig_Clear` function must be used to release the "
"configuration memory."
msgstr ""
#: c-api/init_config.rst:430
msgid "Structure methods:"
msgstr ""
#: c-api/init_config.rst:434
msgid ""
"Initialize configuration with the :ref:`Python Configuration <init-python-"
"config>`."
msgstr ""
#: c-api/init_config.rst:439
msgid ""
"Initialize configuration with the :ref:`Isolated Configuration <init-"
"isolated-conf>`."
msgstr ""
#: c-api/init_config.rst:444
msgid "Copy the wide character string *str* into ``*config_str``."
msgstr ""
#: c-api/init_config.rst:453 c-api/init_config.rst:468
#: c-api/init_config.rst:488
msgid ":ref:`Preinitialize Python <c-preinit>` if needed."
msgstr ""
#: c-api/init_config.rst:450
msgid ""
"Decode *str* using :c:func:`Py_DecodeLocale` and set the result into "
"``*config_str``."
msgstr ""
#: c-api/init_config.rst:457
msgid ""
"Set command line arguments (:c:member:`~PyConfig.argv` member of *config*) "
"from the *argv* list of wide character strings."
msgstr ""
#: c-api/init_config.rst:464
msgid ""
"Set command line arguments (:c:member:`~PyConfig.argv` member of *config*) "
"from the *argv* list of bytes strings. Decode bytes using :c:func:"
"`Py_DecodeLocale`."
msgstr ""
#: c-api/init_config.rst:472
msgid "Set the list of wide strings *list* to *length* and *items*."
msgstr ""
#: c-api/init_config.rst:478
msgid "Read all Python configuration."
msgstr ""
#: c-api/init_config.rst:480
msgid "Fields which are already initialized are left unchanged."
msgstr ""
#: c-api/init_config.rst:910
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:490
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:498
msgid "Release configuration memory."
msgstr ""
#: c-api/init_config.rst:500
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:506
msgid ":c:member:`PyConfig.dev_mode`"
msgstr ""
#: c-api/init_config.rst:507
msgid ":c:member:`PyConfig.isolated`"
msgstr ""
#: c-api/init_config.rst:508
msgid ":c:member:`PyConfig.parse_argv`"
msgstr ""
#: c-api/init_config.rst:509
msgid ":c:member:`PyConfig.use_environment`"
msgstr ""
#: c-api/init_config.rst:511
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:516
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:523
msgid "Command line arguments: :data:`sys.argv`."
msgstr ""
#: c-api/init_config.rst:525
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:530
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:541 c-api/init_config.rst:561
#: c-api/init_config.rst:662 c-api/init_config.rst:851
#: c-api/init_config.rst:967 c-api/init_config.rst:998
#: c-api/init_config.rst:1018
msgid "Default: ``NULL``."
msgstr ""
#: c-api/init_config.rst:535
msgid "See also the :c:member:`~PyConfig.orig_argv` member."
msgstr ""
#: c-api/init_config.rst:539
msgid ":data:`sys.base_exec_prefix`."
msgstr ""
#: c-api/init_config.rst:555 c-api/init_config.rst:655
#: c-api/init_config.rst:868 c-api/init_config.rst:951
msgid "Part of the :ref:`Python Path Configuration <init-path-config>` output."
msgstr ""
#: c-api/init_config.rst:547
msgid "Python base executable: :data:`sys._base_executable`."
msgstr ""
#: c-api/init_config.rst:549
msgid "Set by the :envvar:`__PYVENV_LAUNCHER__` environment variable."
msgstr ""
#: c-api/init_config.rst:551
msgid "Set from :c:member:`PyConfig.executable` if ``NULL``."
msgstr ""
#: c-api/init_config.rst:559
msgid ":data:`sys.base_prefix`."
msgstr ""
#: c-api/init_config.rst:567
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:570
msgid ""
"Set to 0 by the :option:`-u` command line option and the :envvar:"
"`PYTHONUNBUFFERED` environment variable."
msgstr ""
#: c-api/init_config.rst:573
msgid "stdin is always opened in buffered mode."
msgstr ""
#: c-api/init_config.rst:1046 c-api/init_config.rst:1161
msgid "Default: ``1``."
msgstr ""
#: c-api/init_config.rst:579
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:583
msgid ""
"If equal or greater to 2, raise a :exc:`BytesWarning` exception in these "
"cases."
msgstr ""
#: c-api/init_config.rst:586
msgid "Incremented by the :option:`-b` command line option."
msgstr ""
#: c-api/init_config.rst:592
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:601
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:604
msgid "Valid values:"
msgstr ""
#: c-api/init_config.rst:606
msgid ""
"``L\"always\"``: Hash the source file for invalidation regardless of value "
"of the 'check_source' flag."
msgstr ""
#: c-api/init_config.rst:608
msgid "``L\"never\"``: Assume that hash-based pycs always are valid."
msgstr ""
#: c-api/init_config.rst:609
msgid ""
"``L\"default\"``: The 'check_source' flag in hash-based pycs determines "
"invalidation."
msgstr ""
#: c-api/init_config.rst:612
msgid "Default: ``L\"default\"``."
msgstr ""
#: c-api/init_config.rst:614
msgid "See also :pep:`552` \"Deterministic pycs\"."
msgstr ""
#: c-api/init_config.rst:618
msgid "If non-zero, configure C standard streams:"
msgstr ""
#: c-api/init_config.rst:620
msgid ""
"On Windows, set the binary mode (``O_BINARY``) on stdin, stdout and stderr."
msgstr ""
#: c-api/init_config.rst:622
msgid ""
"If :c:member:`~PyConfig.buffered_stdio` equals zero, disable buffering of "
"stdin, stdout and stderr streams."
msgstr ""
#: c-api/init_config.rst:624
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:631
msgid "If non-zero, enable the :ref:`Python Development Mode <devmode>`."
msgstr ""
#: c-api/init_config.rst:637
msgid "Dump Python refererences?"
msgstr ""
#: c-api/init_config.rst:639
msgid "If non-zero, dump all objects which are still alive at exit."
msgstr ""
#: c-api/init_config.rst:641
msgid "Set to ``1`` by the :envvar:`PYTHONDUMPREFS` environment variable."
msgstr ""
#: c-api/init_config.rst:643
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:650
msgid ""
"The site-specific directory prefix where the platform-dependent Python files "
"are installed: :data:`sys.exec_prefix`."
msgstr ""
#: c-api/init_config.rst:659
msgid ""
"The absolute path of the executable binary for the Python interpreter: :data:"
"`sys.executable`."
msgstr ""
#: c-api/init_config.rst:668
msgid "Enable faulthandler?"
msgstr ""
#: c-api/init_config.rst:670
msgid "If non-zero, call :func:`faulthandler.enable` at startup."
msgstr ""
#: c-api/init_config.rst:672
msgid ""
"Set to ``1`` by :option:`-X faulthandler <-X>` and the :envvar:"
"`PYTHONFAULTHANDLER` environment variable."
msgstr ""
#: c-api/init_config.rst:679
msgid ""
":term:`Filesystem encoding <filesystem encoding and error handler>`: :func:"
"`sys.getfilesystemencoding`."
msgstr ""
#: c-api/init_config.rst:682
msgid "On macOS, Android and VxWorks: use ``\"utf-8\"`` by default."
msgstr ""
#: c-api/init_config.rst:684
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:688
msgid "Default encoding on other platforms:"
msgstr ""
#: c-api/init_config.rst:690
msgid "``\"utf-8\"`` if :c:member:`PyPreConfig.utf8_mode` is non-zero."
msgstr ""
#: c-api/init_config.rst:691
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:695
msgid "``\"utf-8\"`` if ``nl_langinfo(CODESET)`` returns an empty string."
msgstr ""
#: c-api/init_config.rst:696
msgid ""
"Otherwise, use the :term:`locale encoding`: ``nl_langinfo(CODESET)`` result."
msgstr ""
#: c-api/init_config.rst:699
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:702
msgid "See also the :c:member:`~PyConfig.filesystem_errors` member."
msgstr ""
#: c-api/init_config.rst:706
msgid ""
":term:`Filesystem error handler <filesystem encoding and error handler>`: :"
"func:`sys.getfilesystemencodeerrors`."
msgstr ""
#: c-api/init_config.rst:709
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:713
msgid "On other platforms: use ``\"surrogateescape\"`` by default."
msgstr ""
#: c-api/init_config.rst:715
msgid "Supported error handlers:"
msgstr ""
#: c-api/init_config.rst:717
msgid "``\"strict\"``"
msgstr ""
#: c-api/init_config.rst:718
msgid "``\"surrogateescape\"``"
msgstr ""
#: c-api/init_config.rst:719
msgid "``\"surrogatepass\"`` (only supported with the UTF-8 encoding)"
msgstr ""
#: c-api/init_config.rst:721
msgid "See also the :c:member:`~PyConfig.filesystem_encoding` member."
msgstr ""
#: c-api/init_config.rst:726
msgid "Randomized hash function seed."
msgstr ""
#: c-api/init_config.rst:728
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:731
msgid "Set by the :envvar:`PYTHONHASHSEED` environment variable."
msgstr ""
#: c-api/init_config.rst:733
msgid ""
"Default *use_hash_seed* value: ``-1`` in Python mode, ``0`` in isolated mode."
msgstr ""
#: c-api/init_config.rst:738
msgid "Python home directory."
msgstr ""
#: c-api/init_config.rst:740
msgid ""
"If :c:func:`Py_SetPythonHome` has been called, use its argument if it is not "
"``NULL``."
msgstr ""
#: c-api/init_config.rst:743
msgid "Set by the :envvar:`PYTHONHOME` environment variable."
msgstr ""
#: c-api/init_config.rst:840 c-api/init_config.rst:942
#: c-api/init_config.rst:969
msgid "Part of the :ref:`Python Path Configuration <init-path-config>` input."
msgstr ""
#: c-api/init_config.rst:751
msgid "If non-zero, profile import time."
msgstr ""
#: c-api/init_config.rst:753
msgid ""
"Set the ``1`` by the :option:`-X importtime <-X>` option and the :envvar:"
"`PYTHONPROFILEIMPORTTIME` environment variable."
msgstr ""
#: c-api/init_config.rst:760
msgid "Enter interactive mode after executing a script or a command."
msgstr ""
#: c-api/init_config.rst:762
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:767
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:774
msgid "Install Python signal handlers?"
msgstr ""
#: c-api/init_config.rst:916 c-api/init_config.rst:1113
msgid "Default: ``1`` in Python mode, ``0`` in isolated mode."
msgstr ""
#: c-api/init_config.rst:780
msgid "If greater than 0, enable the interactive mode (REPL)."
msgstr ""
#: c-api/init_config.rst:782
msgid "Incremented by the :option:`-i` command line option."
msgstr ""
#: c-api/init_config.rst:788
msgid "If greater than 0, enable isolated mode:"
msgstr ""
#: c-api/init_config.rst:790
msgid ""
":data:`sys.path` contains neither the script's directory (computed from "
"``argv[0]`` or the current directory) nor the user's site-packages directory."
msgstr ""
#: c-api/init_config.rst:793
msgid ""
"Python REPL doesn't import :mod:`readline` nor enable default readline "
"configuration on interactive prompts."
msgstr ""
#: c-api/init_config.rst:795
msgid ""
"Set :c:member:`~PyConfig.use_environment` and :c:member:`~PyConfig."
"user_site_directory` to 0."
msgstr ""
#: c-api/init_config.rst:800
msgid "See also :c:member:`PyPreConfig.isolated`."
msgstr ""
#: c-api/init_config.rst:804
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:808
msgid ""
"Set to ``1`` if the :envvar:`PYTHONLEGACYWINDOWSSTDIO` environment variable "
"is set to a non-empty string."
msgstr ""
#: c-api/init_config.rst:816
msgid "See also the :pep:`528` (Change Windows console encoding to UTF-8)."
msgstr ""
#: c-api/init_config.rst:820
msgid ""
"If non-zero, dump statistics on :ref:`Python pymalloc memory allocator "
"<pymalloc>` at exit."
msgstr ""
#: c-api/init_config.rst:823
msgid "Set to ``1`` by the :envvar:`PYTHONMALLOCSTATS` environment variable."
msgstr ""
#: c-api/init_config.rst:825
msgid ""
"The option is ignored if Python is :option:`configured using the --without-"
"pymalloc option <--without-pymalloc>`."
msgstr ""
#: c-api/init_config.rst:832
msgid "Platform library directory name: :data:`sys.platlibdir`."
msgstr ""
#: c-api/init_config.rst:834
msgid "Set by the :envvar:`PYTHONPLATLIBDIR` environment variable."
msgstr ""
#: c-api/init_config.rst:836
msgid ""
"Default: value of the ``PLATLIBDIR`` macro which is set by the :option:"
"`configure --with-platlibdir option <--with-platlibdir>` (default: ``\"lib"
"\"``)."
msgstr ""
#: c-api/init_config.rst:846
msgid ""
"Module search paths (:data:`sys.path`) as a string separated by ``DELIM`` (:"
"data:`os.path.pathsep`)."
msgstr ""
#: c-api/init_config.rst:849
msgid "Set by the :envvar:`PYTHONPATH` environment variable."
msgstr ""
#: c-api/init_config.rst:858
msgid "Module search paths: :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:860
msgid ""
"If :c:member:`~PyConfig.module_search_paths_set` is equal to 0, the function "
"calculating the :ref:`Python Path Configuration <init-path-config>` "
"overrides the :c:member:`~PyConfig.module_search_paths` and sets :c:member:"
"`~PyConfig.module_search_paths_set` to ``1``."
msgstr ""
#: c-api/init_config.rst:865
msgid ""
"Default: empty list (``module_search_paths``) and ``0`` "
"(``module_search_paths_set``)."
msgstr ""
#: c-api/init_config.rst:872
msgid "Compilation optimization level:"
msgstr ""
#: c-api/init_config.rst:874
msgid "``0``: Peephole optimizer, set ``__debug__`` to ``True``."
msgstr ""
#: c-api/init_config.rst:875
msgid "``1``: Level 0, remove assertions, set ``__debug__`` to ``False``."
msgstr ""
#: c-api/init_config.rst:876
msgid "``2``: Level 1, strip docstrings."
msgstr ""
#: c-api/init_config.rst:878
msgid ""
"Incremented by the :option:`-O` command line option. Set to the :envvar:"
"`PYTHONOPTIMIZE` environment variable value."
msgstr ""
#: c-api/init_config.rst:885
msgid ""
"The list of the original command line arguments passed to the Python "
"executable: :data:`sys.orig_argv`."
msgstr ""
#: c-api/init_config.rst:888
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:895
msgid ""
"See also the :c:member:`~PyConfig.argv` member and the :c:func:"
"`Py_GetArgcArgv` function."
msgstr ""
#: c-api/init_config.rst:1148 c-api/init_config.rst:1167
msgid "Default: empty list."
msgstr ""
#: c-api/init_config.rst:904
msgid "Parse command line arguments?"
msgstr ""
#: c-api/init_config.rst:906
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:918
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:924
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:927
msgid ""
"Incremented by the :option:`-d` command line option. Set to the :envvar:"
"`PYTHONDEBUG` environment variable value."
msgstr ""
#: c-api/init_config.rst:934
msgid ""
"On Unix, if non-zero, calculating the :ref:`Python Path Configuration <init-"
"path-config>` can log warnings into ``stderr``. If equals to 0, suppress "
"these warnings."
msgstr ""
#: c-api/init_config.rst:938
msgid "It has no effect on Windows."
msgstr ""
#: c-api/init_config.rst:946
msgid ""
"The site-specific directory prefix where the platform independent Python "
"files are installed: :data:`sys.prefix`."
msgstr ""
#: c-api/init_config.rst:955
msgid ""
"Program name used to initialize :c:member:`~PyConfig.executable` and in "
"early error messages during Python initialization."
msgstr ""
#: c-api/init_config.rst:958
msgid "If :func:`Py_SetProgramName` has been called, use its argument."
msgstr ""
#: c-api/init_config.rst:959
msgid "On macOS, use :envvar:`PYTHONEXECUTABLE` environment variable if set."
msgstr ""
#: c-api/init_config.rst:960
msgid ""
"If the ``WITH_NEXT_FRAMEWORK`` macro is defined, use :envvar:"
"`__PYVENV_LAUNCHER__` environment variable if set."
msgstr ""
#: c-api/init_config.rst:962
msgid ""
"Use ``argv[0]`` of :c:member:`~PyConfig.argv` if available and non-empty."
msgstr ""
#: c-api/init_config.rst:964
msgid ""
"Otherwise, use ``L\"python\"`` on Windows, or ``L\"python3\"`` on other "
"platforms."
msgstr ""
#: c-api/init_config.rst:973
msgid ""
"Directory where cached ``.pyc`` files are written: :data:`sys."
"pycache_prefix`."
msgstr ""
#: c-api/init_config.rst:976
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:979
msgid "If ``NULL``, :data:`sys.pycache_prefix` is set to ``None``."
msgstr ""
#: c-api/init_config.rst:985
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:988
msgid "Incremented by the :option:`-q` command line option."
msgstr ""
#: c-api/init_config.rst:994
msgid "Value of the :option:`-c` command line option."
msgstr ""
#: c-api/init_config.rst:1008 c-api/init_config.rst:1016
msgid "Used by :c:func:`Py_RunMain`."
msgstr ""
#: c-api/init_config.rst:1002
msgid ""
"Filename passed on the command line: trailing command line argument without :"
"option:`-c` or :option:`-m`."
msgstr ""
#: c-api/init_config.rst:1005
msgid ""
"For example, it is set to ``script.py`` by the ``python3 script.py arg`` "
"command."
msgstr ""
#: c-api/init_config.rst:1014
msgid "Value of the :option:`-m` command line option."
msgstr ""
#: c-api/init_config.rst:1022
msgid "Show total reference count at exit?"
msgstr ""
#: c-api/init_config.rst:1024
msgid "Set to 1 by :option:`-X showrefcount <-X>` command line option."
msgstr ""
#: c-api/init_config.rst:1026
msgid ""
"Need a :ref:`debug build of Python <debug-build>` (the ``Py_REF_DEBUG`` "
"macro must be defined)."
msgstr ""
#: c-api/init_config.rst:1033
msgid "Import the :mod:`site` module at startup?"
msgstr ""
#: c-api/init_config.rst:1035
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:1038
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:1041
msgid "Set to ``0`` by the :option:`-S` command line option."
msgstr ""
#: c-api/init_config.rst:1043
msgid ""
":data:`sys.flags.no_site` is set to the inverted value of :c:member:"
"`~PyConfig.site_import`."
msgstr ""
#: c-api/init_config.rst:1050
msgid ""
"If non-zero, skip the first line of the :c:member:`PyConfig.run_filename` "
"source."
msgstr ""
#: c-api/init_config.rst:1053
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:1056
msgid "Set to ``1`` by the :option:`-x` command line option."
msgstr ""
#: c-api/init_config.rst:1063
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:1067
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:1070
msgid ""
"Use the :envvar:`PYTHONIOENCODING` environment variable if it is non-empty."
msgstr ""
#: c-api/init_config.rst:1073
msgid "Default encoding:"
msgstr ""
#: c-api/init_config.rst:1075
msgid "``\"UTF-8\"`` if :c:member:`PyPreConfig.utf8_mode` is non-zero."
msgstr ""
#: c-api/init_config.rst:1076
msgid "Otherwise, use the :term:`locale encoding`."
msgstr ""
#: c-api/init_config.rst:1078
msgid "Default error handler:"
msgstr ""
#: c-api/init_config.rst:1080
msgid "On Windows: use ``\"surrogateescape\"``."
msgstr ""
#: c-api/init_config.rst:1081
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:1083
msgid "``\"strict\"`` otherwise."
msgstr ""
#: c-api/init_config.rst:1087
msgid "Enable tracemalloc?"
msgstr ""
#: c-api/init_config.rst:1089
msgid "If non-zero, call :func:`tracemalloc.start` at startup."
msgstr ""
#: c-api/init_config.rst:1091
msgid ""
"Set by :option:`-X tracemalloc=N <-X>` command line option and by the :"
"envvar:`PYTHONTRACEMALLOC` environment variable."
msgstr ""
#: c-api/init_config.rst:1098
msgid "Use :ref:`environment variables <using-on-envvars>`?"
msgstr ""
#: c-api/init_config.rst:1100
msgid ""
"If equals to zero, ignore the :ref:`environment variables <using-on-"
"envvars>`."
msgstr ""
#: c-api/init_config.rst:1107
msgid "If non-zero, add the user site directory to :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:1109
msgid "Set to ``0`` by the :option:`-s` and :option:`-I` command line options."
msgstr ""
#: c-api/init_config.rst:1111
msgid "Set to ``0`` by the :envvar:`PYTHONNOUSERSITE` environment variable."
msgstr ""
#: c-api/init_config.rst:1117
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:1121
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:1125
msgid "Incremented by the :option:`-v` command line option."
msgstr ""
#: c-api/init_config.rst:1127
msgid "Set to the :envvar:`PYTHONVERBOSE` environment variable value."
msgstr ""
#: c-api/init_config.rst:1133
msgid ""
"Options of the :mod:`warnings` module to build warnings filters, lowest to "
"highest priority: :data:`sys.warnoptions`."
msgstr ""
#: c-api/init_config.rst:1136
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:1141
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:1144
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:1152
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:1155
msgid ""
"Set to ``0`` by the :option:`-B` command line option and the :envvar:"
"`PYTHONDONTWRITEBYTECODE` environment variable."
msgstr ""
#: c-api/init_config.rst:1158
msgid ""
":data:`sys.dont_write_bytecode` is initialized to the inverted value of :c:"
"member:`~PyConfig.write_bytecode`."
msgstr ""
#: c-api/init_config.rst:1165
msgid "Values of the :option:`-X` command line options: :data:`sys._xoptions`."
msgstr ""
#: c-api/init_config.rst:1169
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:1174
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:1179
msgid "The ``show_alloc_count`` field has been removed."
msgstr ""
#: c-api/init_config.rst:1183
msgid "Initialization with PyConfig"
msgstr ""
#: c-api/init_config.rst:1185
msgid "Function to initialize Python:"
msgstr ""
#: c-api/init_config.rst:1189
msgid "Initialize Python from *config* configuration."
msgstr ""
#: c-api/init_config.rst:1194
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:1201
msgid ""
"The current configuration (``PyConfig`` type) is stored in "
"``PyInterpreterState.config``."
msgstr ""
#: c-api/init_config.rst:1204
msgid "Example setting the program name::"
msgstr ""
#: c-api/init_config.rst:1232
msgid ""
"More complete example modifying the default configuration, read the "
"configuration, and then override some parameters::"
msgstr ""
#: c-api/init_config.rst:1283
msgid "Isolated Configuration"
msgstr ""
#: c-api/init_config.rst:1285
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:1290
msgid ""
"This configuration ignores global configuration variables, environments "
"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:1295
msgid ""
"Configuration files are still used with this configuration. Set the :ref:"
"`Python Path Configuration <init-path-config>` (\"output fields\") to ignore "
"these configuration files and avoid the function computing the default path "
"configuration."
msgstr ""
#: c-api/init_config.rst:1304
msgid "Python Configuration"
msgstr ""
#: c-api/init_config.rst:1306
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:1310
msgid ""
"Environments variables and command line arguments are used to configure "
"Python, whereas global configuration variables are ignored."
msgstr ""
#: c-api/init_config.rst:1313
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:1322
msgid "Python Path Configuration"
msgstr ""
#: c-api/init_config.rst:1324
msgid ":c:type:`PyConfig` contains multiple fields for the path configuration:"
msgstr ""
#: c-api/init_config.rst:1326
msgid "Path configuration inputs:"
msgstr ""
#: c-api/init_config.rst:1328
msgid ":c:member:`PyConfig.home`"
msgstr ""
#: c-api/init_config.rst:1329
msgid ":c:member:`PyConfig.platlibdir`"
msgstr ""
#: c-api/init_config.rst:1330
msgid ":c:member:`PyConfig.pathconfig_warnings`"
msgstr ""
#: c-api/init_config.rst:1331
msgid ":c:member:`PyConfig.program_name`"
msgstr ""
#: c-api/init_config.rst:1332
msgid ":c:member:`PyConfig.pythonpath_env`"
msgstr ""
#: c-api/init_config.rst:1333
msgid "current working directory: to get absolute paths"
msgstr ""
#: c-api/init_config.rst:1334
msgid ""
"``PATH`` environment variable to get the program full path (from :c:member:"
"`PyConfig.program_name`)"
msgstr ""
#: c-api/init_config.rst:1336
msgid "``__PYVENV_LAUNCHER__`` environment variable"
msgstr ""
#: c-api/init_config.rst:1337
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:1341
msgid "Path configuration output fields:"
msgstr ""
#: c-api/init_config.rst:1343
msgid ":c:member:`PyConfig.base_exec_prefix`"
msgstr ""
#: c-api/init_config.rst:1344
msgid ":c:member:`PyConfig.base_executable`"
msgstr ""
#: c-api/init_config.rst:1345
msgid ":c:member:`PyConfig.base_prefix`"
msgstr ""
#: c-api/init_config.rst:1346
msgid ":c:member:`PyConfig.exec_prefix`"
msgstr ""
#: c-api/init_config.rst:1347
msgid ":c:member:`PyConfig.executable`"
msgstr ""
#: c-api/init_config.rst:1348
msgid ""
":c:member:`PyConfig.module_search_paths_set`, :c:member:`PyConfig."
"module_search_paths`"
msgstr ""
#: c-api/init_config.rst:1350
msgid ":c:member:`PyConfig.prefix`"
msgstr ""
#: c-api/init_config.rst:1352
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:1358
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, path configuration input fields are ignored as "
"well."
msgstr ""
#: c-api/init_config.rst:1365
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:1368
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:1372
msgid ":c:func:`Py_RunMain` and :c:func:`Py_Main` modify :data:`sys.path`:"
msgstr ""
#: c-api/init_config.rst:1374
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:1377
msgid "If :c:member:`~PyConfig.isolated` is zero:"
msgstr ""
#: c-api/init_config.rst:1379
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:1381
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:1383
msgid "Otherwise, prepend an empty string to :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:1385
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:1391
msgid "The following configuration files are used by the path configuration:"
msgstr ""
#: c-api/init_config.rst:1393
msgid "``pyvenv.cfg``"
msgstr ""
#: c-api/init_config.rst:1394
msgid "``python._pth`` (Windows only)"
msgstr ""
#: c-api/init_config.rst:1395
msgid "``pybuilddir.txt`` (Unix only)"
msgstr ""
#: c-api/init_config.rst:1397
msgid ""
"The ``__PYVENV_LAUNCHER__`` environment variable is used to set :c:member:"
"`PyConfig.base_executable`"
msgstr ""
#: c-api/init_config.rst:1402
msgid "Py_RunMain()"
msgstr ""
#: c-api/init_config.rst:1406
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:1411
msgid "By default and when if :option:`-i` option is used, run the REPL."
msgstr ""
#: c-api/init_config.rst:1413
msgid ""
"Finally, finalizes Python and returns an exit status that can be passed to "
"the ``exit()`` function."
msgstr ""
#: c-api/init_config.rst:1416
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:1422
msgid "Py_GetArgcArgv()"
msgstr ""
#: c-api/init_config.rst:1426
msgid "Get the original command line arguments, before Python modified them."
msgstr ""
#: c-api/init_config.rst:1428
msgid "See also :c:member:`PyConfig.orig_argv` member."
msgstr ""
#: c-api/init_config.rst:1432
msgid "Multi-Phase Initialization Private Provisional API"
msgstr ""
#: c-api/init_config.rst:1434
msgid ""
"This section is a private provisional API introducing multi-phase "
"initialization, the core feature of the :pep:`432`:"
msgstr ""
#: c-api/init_config.rst:1437
msgid "\"Core\" initialization phase, \"bare minimum Python\":"
msgstr ""
#: c-api/init_config.rst:1439
msgid "Builtin types;"
msgstr ""
#: c-api/init_config.rst:1440
msgid "Builtin exceptions;"
msgstr ""
#: c-api/init_config.rst:1441
msgid "Builtin and frozen modules;"
msgstr ""
#: c-api/init_config.rst:1442
msgid ""
"The :mod:`sys` module is only partially initialized (ex: :data:`sys.path` "
"doesn't exist yet)."
msgstr ""
#: c-api/init_config.rst:1445
msgid "\"Main\" initialization phase, Python is fully initialized:"
msgstr ""
#: c-api/init_config.rst:1447
msgid "Install and configure :mod:`importlib`;"
msgstr ""
#: c-api/init_config.rst:1448
msgid "Apply the :ref:`Path Configuration <init-path-config>`;"
msgstr ""
#: c-api/init_config.rst:1449
msgid "Install signal handlers;"
msgstr ""
#: c-api/init_config.rst:1450
msgid ""
"Finish :mod:`sys` module initialization (ex: create :data:`sys.stdout` and :"
"data:`sys.path`);"
msgstr ""
#: c-api/init_config.rst:1452
msgid ""
"Enable optional features like :mod:`faulthandler` and :mod:`tracemalloc`;"
msgstr ""
#: c-api/init_config.rst:1453
msgid "Import the :mod:`site` module;"
msgstr ""
#: c-api/init_config.rst:1454
msgid "etc."
msgstr ""
#: c-api/init_config.rst:1456
msgid "Private provisional API:"
msgstr ""
#: c-api/init_config.rst:1458
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:1460
msgid ""
":c:member:`PyConfig._isolated_interpreter`: if non-zero, disallow threads, "
"subprocesses and fork."
msgstr ""
#: c-api/init_config.rst:1465
msgid ""
"Move to the \"Main\" initialization phase, finish the Python initialization."
msgstr ""
#: c-api/init_config.rst:1467
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:1473
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:1477
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:1482
msgid ""
"Example running Python code between \"Core\" and \"Main\" initialization "
"phases::"
msgstr ""
#, fuzzy
#~ msgid "Functions:"
#~ msgstr "Fonctions"
#, fuzzy
#~ msgid "Interactive mode."
#~ msgstr "Mode interactif"