1
0
Fork 0
python-docs-fr/c-api/init_config.po

1935 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: 2022-10-18 15:46+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
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:1093
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:797
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:810
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:769 c-api/init_config.rst:813
#: c-api/init_config.rst:880 c-api/init_config.rst:989
#: c-api/init_config.rst:1057 c-api/init_config.rst:1128
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:1102
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:1190
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:909
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:850
#: c-api/init_config.rst:966 c-api/init_config.rst:997
#: c-api/init_config.rst:1017
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:867 c-api/init_config.rst:950
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:1045 c-api/init_config.rst:1160
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 references?"
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, whereas the ``mbstowcs()`` function decodes from a different "
"encoding (usually Latin1)."
msgstr ""
#: c-api/init_config.rst:694
msgid "``\"utf-8\"`` if ``nl_langinfo(CODESET)`` returns an empty string."
msgstr ""
#: c-api/init_config.rst:695
msgid ""
"Otherwise, use the :term:`locale encoding`: ``nl_langinfo(CODESET)`` result."
msgstr ""
#: c-api/init_config.rst:698
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:701
msgid "See also the :c:member:`~PyConfig.filesystem_errors` member."
msgstr ""
#: c-api/init_config.rst:705
msgid ""
":term:`Filesystem error handler <filesystem encoding and error handler>`: :"
"func:`sys.getfilesystemencodeerrors`."
msgstr ""
#: c-api/init_config.rst:708
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:712
msgid "On other platforms: use ``\"surrogateescape\"`` by default."
msgstr ""
#: c-api/init_config.rst:714
msgid "Supported error handlers:"
msgstr ""
#: c-api/init_config.rst:716
msgid "``\"strict\"``"
msgstr ""
#: c-api/init_config.rst:717
msgid "``\"surrogateescape\"``"
msgstr ""
#: c-api/init_config.rst:718
msgid "``\"surrogatepass\"`` (only supported with the UTF-8 encoding)"
msgstr ""
#: c-api/init_config.rst:720
msgid "See also the :c:member:`~PyConfig.filesystem_encoding` member."
msgstr ""
#: c-api/init_config.rst:725
msgid "Randomized hash function seed."
msgstr ""
#: c-api/init_config.rst:727
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:730
msgid "Set by the :envvar:`PYTHONHASHSEED` environment variable."
msgstr ""
#: c-api/init_config.rst:732
msgid ""
"Default *use_hash_seed* value: ``-1`` in Python mode, ``0`` in isolated mode."
msgstr ""
#: c-api/init_config.rst:737
msgid "Python home directory."
msgstr ""
#: c-api/init_config.rst:739
msgid ""
"If :c:func:`Py_SetPythonHome` has been called, use its argument if it is not "
"``NULL``."
msgstr ""
#: c-api/init_config.rst:742
msgid "Set by the :envvar:`PYTHONHOME` environment variable."
msgstr ""
#: c-api/init_config.rst:839 c-api/init_config.rst:941
#: c-api/init_config.rst:968
msgid "Part of the :ref:`Python Path Configuration <init-path-config>` input."
msgstr ""
#: c-api/init_config.rst:750
msgid "If non-zero, profile import time."
msgstr ""
#: c-api/init_config.rst:752
msgid ""
"Set the ``1`` by the :option:`-X importtime <-X>` option and the :envvar:"
"`PYTHONPROFILEIMPORTTIME` environment variable."
msgstr ""
#: c-api/init_config.rst:759
msgid "Enter interactive mode after executing a script or a command."
msgstr ""
#: c-api/init_config.rst:761
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:766
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:773
msgid "Install Python signal handlers?"
msgstr ""
#: c-api/init_config.rst:915 c-api/init_config.rst:1112
msgid "Default: ``1`` in Python mode, ``0`` in isolated mode."
msgstr ""
#: c-api/init_config.rst:779
msgid "If greater than 0, enable the interactive mode (REPL)."
msgstr ""
#: c-api/init_config.rst:781
msgid "Incremented by the :option:`-i` command line option."
msgstr ""
#: c-api/init_config.rst:787
msgid "If greater than 0, enable isolated mode:"
msgstr ""
#: c-api/init_config.rst:789
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:792
msgid ""
"Python REPL doesn't import :mod:`readline` nor enable default readline "
"configuration on interactive prompts."
msgstr ""
#: c-api/init_config.rst:794
msgid ""
"Set :c:member:`~PyConfig.use_environment` and :c:member:`~PyConfig."
"user_site_directory` to 0."
msgstr ""
#: c-api/init_config.rst:799
msgid "See also :c:member:`PyPreConfig.isolated`."
msgstr ""
#: c-api/init_config.rst:803
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:807
msgid ""
"Set to ``1`` if the :envvar:`PYTHONLEGACYWINDOWSSTDIO` environment variable "
"is set to a non-empty string."
msgstr ""
#: c-api/init_config.rst:815
msgid "See also the :pep:`528` (Change Windows console encoding to UTF-8)."
msgstr ""
#: c-api/init_config.rst:819
msgid ""
"If non-zero, dump statistics on :ref:`Python pymalloc memory allocator "
"<pymalloc>` at exit."
msgstr ""
#: c-api/init_config.rst:822
msgid "Set to ``1`` by the :envvar:`PYTHONMALLOCSTATS` environment variable."
msgstr ""
#: c-api/init_config.rst:824
msgid ""
"The option is ignored if Python is :option:`configured using the --without-"
"pymalloc option <--without-pymalloc>`."
msgstr ""
#: c-api/init_config.rst:831
msgid "Platform library directory name: :data:`sys.platlibdir`."
msgstr ""
#: c-api/init_config.rst:833
msgid "Set by the :envvar:`PYTHONPLATLIBDIR` environment variable."
msgstr ""
#: c-api/init_config.rst:835
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:845
msgid ""
"Module search paths (:data:`sys.path`) as a string separated by ``DELIM`` (:"
"data:`os.path.pathsep`)."
msgstr ""
#: c-api/init_config.rst:848
msgid "Set by the :envvar:`PYTHONPATH` environment variable."
msgstr ""
#: c-api/init_config.rst:857
msgid "Module search paths: :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:859
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:864
msgid ""
"Default: empty list (``module_search_paths``) and ``0`` "
"(``module_search_paths_set``)."
msgstr ""
#: c-api/init_config.rst:871
msgid "Compilation optimization level:"
msgstr ""
#: c-api/init_config.rst:873
msgid "``0``: Peephole optimizer, set ``__debug__`` to ``True``."
msgstr ""
#: c-api/init_config.rst:874
msgid "``1``: Level 0, remove assertions, set ``__debug__`` to ``False``."
msgstr ""
#: c-api/init_config.rst:875
msgid "``2``: Level 1, strip docstrings."
msgstr ""
#: c-api/init_config.rst:877
msgid ""
"Incremented by the :option:`-O` command line option. Set to the :envvar:"
"`PYTHONOPTIMIZE` environment variable value."
msgstr ""
#: c-api/init_config.rst:884
msgid ""
"The list of the original command line arguments passed to the Python "
"executable: :data:`sys.orig_argv`."
msgstr ""
#: c-api/init_config.rst:887
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:894
msgid ""
"See also the :c:member:`~PyConfig.argv` member and the :c:func:"
"`Py_GetArgcArgv` function."
msgstr ""
#: c-api/init_config.rst:1147 c-api/init_config.rst:1166
msgid "Default: empty list."
msgstr ""
#: c-api/init_config.rst:903
msgid "Parse command line arguments?"
msgstr ""
#: c-api/init_config.rst:905
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:917
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:923
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:926
msgid ""
"Incremented by the :option:`-d` command line option. Set to the :envvar:"
"`PYTHONDEBUG` environment variable value."
msgstr ""
#: c-api/init_config.rst:933
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:937
msgid "It has no effect on Windows."
msgstr ""
#: c-api/init_config.rst:945
msgid ""
"The site-specific directory prefix where the platform independent Python "
"files are installed: :data:`sys.prefix`."
msgstr ""
#: c-api/init_config.rst:954
msgid ""
"Program name used to initialize :c:member:`~PyConfig.executable` and in "
"early error messages during Python initialization."
msgstr ""
#: c-api/init_config.rst:957
msgid "If :func:`Py_SetProgramName` has been called, use its argument."
msgstr ""
#: c-api/init_config.rst:958
msgid "On macOS, use :envvar:`PYTHONEXECUTABLE` environment variable if set."
msgstr ""
#: c-api/init_config.rst:959
msgid ""
"If the ``WITH_NEXT_FRAMEWORK`` macro is defined, use :envvar:"
"`__PYVENV_LAUNCHER__` environment variable if set."
msgstr ""
#: c-api/init_config.rst:961
msgid ""
"Use ``argv[0]`` of :c:member:`~PyConfig.argv` if available and non-empty."
msgstr ""
#: c-api/init_config.rst:963
msgid ""
"Otherwise, use ``L\"python\"`` on Windows, or ``L\"python3\"`` on other "
"platforms."
msgstr ""
#: c-api/init_config.rst:972
msgid ""
"Directory where cached ``.pyc`` files are written: :data:`sys."
"pycache_prefix`."
msgstr ""
#: c-api/init_config.rst:975
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:978
msgid "If ``NULL``, :data:`sys.pycache_prefix` is set to ``None``."
msgstr ""
#: c-api/init_config.rst:984
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:987
msgid "Incremented by the :option:`-q` command line option."
msgstr ""
#: c-api/init_config.rst:993
msgid "Value of the :option:`-c` command line option."
msgstr ""
#: c-api/init_config.rst:1007 c-api/init_config.rst:1015
msgid "Used by :c:func:`Py_RunMain`."
msgstr ""
#: c-api/init_config.rst:1001
msgid ""
"Filename passed on the command line: trailing command line argument without :"
"option:`-c` or :option:`-m`."
msgstr ""
#: c-api/init_config.rst:1004
msgid ""
"For example, it is set to ``script.py`` by the ``python3 script.py arg`` "
"command."
msgstr ""
#: c-api/init_config.rst:1013
msgid "Value of the :option:`-m` command line option."
msgstr ""
#: c-api/init_config.rst:1021
msgid "Show total reference count at exit?"
msgstr ""
#: c-api/init_config.rst:1023
msgid "Set to 1 by :option:`-X showrefcount <-X>` command line option."
msgstr ""
#: c-api/init_config.rst:1025
msgid ""
"Need a :ref:`debug build of Python <debug-build>` (the ``Py_REF_DEBUG`` "
"macro must be defined)."
msgstr ""
#: c-api/init_config.rst:1032
msgid "Import the :mod:`site` module at startup?"
msgstr ""
#: c-api/init_config.rst:1034
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:1037
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:1040
msgid "Set to ``0`` by the :option:`-S` command line option."
msgstr ""
#: c-api/init_config.rst:1042
msgid ""
":data:`sys.flags.no_site` is set to the inverted value of :c:member:"
"`~PyConfig.site_import`."
msgstr ""
#: c-api/init_config.rst:1049
msgid ""
"If non-zero, skip the first line of the :c:member:`PyConfig.run_filename` "
"source."
msgstr ""
#: c-api/init_config.rst:1052
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:1055
msgid "Set to ``1`` by the :option:`-x` command line option."
msgstr ""
#: c-api/init_config.rst:1062
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:1066
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:1069
msgid ""
"Use the :envvar:`PYTHONIOENCODING` environment variable if it is non-empty."
msgstr ""
#: c-api/init_config.rst:1072
msgid "Default encoding:"
msgstr ""
#: c-api/init_config.rst:1074
msgid "``\"UTF-8\"`` if :c:member:`PyPreConfig.utf8_mode` is non-zero."
msgstr ""
#: c-api/init_config.rst:1075
msgid "Otherwise, use the :term:`locale encoding`."
msgstr ""
#: c-api/init_config.rst:1077
msgid "Default error handler:"
msgstr ""
#: c-api/init_config.rst:1079
msgid "On Windows: use ``\"surrogateescape\"``."
msgstr ""
#: c-api/init_config.rst:1080
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:1082
msgid "``\"strict\"`` otherwise."
msgstr ""
#: c-api/init_config.rst:1086
msgid "Enable tracemalloc?"
msgstr ""
#: c-api/init_config.rst:1088
msgid "If non-zero, call :func:`tracemalloc.start` at startup."
msgstr ""
#: c-api/init_config.rst:1090
msgid ""
"Set by :option:`-X tracemalloc=N <-X>` command line option and by the :"
"envvar:`PYTHONTRACEMALLOC` environment variable."
msgstr ""
#: c-api/init_config.rst:1097
msgid "Use :ref:`environment variables <using-on-envvars>`?"
msgstr ""
#: c-api/init_config.rst:1099
msgid ""
"If equals to zero, ignore the :ref:`environment variables <using-on-"
"envvars>`."
msgstr ""
#: c-api/init_config.rst:1106
msgid "If non-zero, add the user site directory to :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:1108
msgid "Set to ``0`` by the :option:`-s` and :option:`-I` command line options."
msgstr ""
#: c-api/init_config.rst:1110
msgid "Set to ``0`` by the :envvar:`PYTHONNOUSERSITE` environment variable."
msgstr ""
#: c-api/init_config.rst:1116
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:1120
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:1124
msgid "Incremented by the :option:`-v` command line option."
msgstr ""
#: c-api/init_config.rst:1126
msgid "Set to the :envvar:`PYTHONVERBOSE` environment variable value."
msgstr ""
#: c-api/init_config.rst:1132
msgid ""
"Options of the :mod:`warnings` module to build warnings filters, lowest to "
"highest priority: :data:`sys.warnoptions`."
msgstr ""
#: c-api/init_config.rst:1135
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:1140
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:1143
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:1151
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:1154
msgid ""
"Set to ``0`` by the :option:`-B` command line option and the :envvar:"
"`PYTHONDONTWRITEBYTECODE` environment variable."
msgstr ""
#: c-api/init_config.rst:1157
msgid ""
":data:`sys.dont_write_bytecode` is initialized to the inverted value of :c:"
"member:`~PyConfig.write_bytecode`."
msgstr ""
#: c-api/init_config.rst:1164
msgid "Values of the :option:`-X` command line options: :data:`sys._xoptions`."
msgstr ""
#: c-api/init_config.rst:1168
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:1173
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:1178
msgid "The ``show_alloc_count`` field has been removed."
msgstr ""
#: c-api/init_config.rst:1182
msgid "Initialization with PyConfig"
msgstr ""
#: c-api/init_config.rst:1184
msgid "Function to initialize Python:"
msgstr ""
#: c-api/init_config.rst:1188
msgid "Initialize Python from *config* configuration."
msgstr ""
#: c-api/init_config.rst:1193
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:1200
msgid ""
"The current configuration (``PyConfig`` type) is stored in "
"``PyInterpreterState.config``."
msgstr ""
#: c-api/init_config.rst:1203
msgid "Example setting the program name::"
msgstr ""
#: c-api/init_config.rst:1231
msgid ""
"More complete example modifying the default configuration, read the "
"configuration, and then override some parameters::"
msgstr ""
#: c-api/init_config.rst:1282
msgid "Isolated Configuration"
msgstr ""
#: c-api/init_config.rst:1284
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:1289
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:1294
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:1303
msgid "Python Configuration"
msgstr ""
#: c-api/init_config.rst:1305
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:1309
msgid ""
"Environments variables and command line arguments are used to configure "
"Python, whereas global configuration variables are ignored."
msgstr ""
#: c-api/init_config.rst:1312
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:1321
msgid "Python Path Configuration"
msgstr ""
#: c-api/init_config.rst:1323
msgid ":c:type:`PyConfig` contains multiple fields for the path configuration:"
msgstr ""
#: c-api/init_config.rst:1325
msgid "Path configuration inputs:"
msgstr ""
#: c-api/init_config.rst:1327
msgid ":c:member:`PyConfig.home`"
msgstr ""
#: c-api/init_config.rst:1328
msgid ":c:member:`PyConfig.platlibdir`"
msgstr ""
#: c-api/init_config.rst:1329
msgid ":c:member:`PyConfig.pathconfig_warnings`"
msgstr ""
#: c-api/init_config.rst:1330
msgid ":c:member:`PyConfig.program_name`"
msgstr ""
#: c-api/init_config.rst:1331
msgid ":c:member:`PyConfig.pythonpath_env`"
msgstr ""
#: c-api/init_config.rst:1332
msgid "current working directory: to get absolute paths"
msgstr ""
#: c-api/init_config.rst:1333
msgid ""
"``PATH`` environment variable to get the program full path (from :c:member:"
"`PyConfig.program_name`)"
msgstr ""
#: c-api/init_config.rst:1335
msgid "``__PYVENV_LAUNCHER__`` environment variable"
msgstr ""
#: c-api/init_config.rst:1336
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:1340
msgid "Path configuration output fields:"
msgstr ""
#: c-api/init_config.rst:1342
msgid ":c:member:`PyConfig.base_exec_prefix`"
msgstr ""
#: c-api/init_config.rst:1343
msgid ":c:member:`PyConfig.base_executable`"
msgstr ""
#: c-api/init_config.rst:1344
msgid ":c:member:`PyConfig.base_prefix`"
msgstr ""
#: c-api/init_config.rst:1345
msgid ":c:member:`PyConfig.exec_prefix`"
msgstr ""
#: c-api/init_config.rst:1346
msgid ":c:member:`PyConfig.executable`"
msgstr ""
#: c-api/init_config.rst:1347
msgid ""
":c:member:`PyConfig.module_search_paths_set`, :c:member:`PyConfig."
"module_search_paths`"
msgstr ""
#: c-api/init_config.rst:1349
msgid ":c:member:`PyConfig.prefix`"
msgstr ""
#: c-api/init_config.rst:1351
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:1357
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:1364
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:1367
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:1371
msgid ":c:func:`Py_RunMain` and :c:func:`Py_Main` modify :data:`sys.path`:"
msgstr ""
#: c-api/init_config.rst:1373
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:1376
msgid "If :c:member:`~PyConfig.isolated` is zero:"
msgstr ""
#: c-api/init_config.rst:1378
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:1380
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:1382
msgid "Otherwise, prepend an empty string to :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:1384
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:1390
msgid "The following configuration files are used by the path configuration:"
msgstr ""
#: c-api/init_config.rst:1392
msgid "``pyvenv.cfg``"
msgstr ""
#: c-api/init_config.rst:1393
msgid "``python._pth`` (Windows only)"
msgstr ""
#: c-api/init_config.rst:1394
msgid "``pybuilddir.txt`` (Unix only)"
msgstr ""
#: c-api/init_config.rst:1396
msgid ""
"The ``__PYVENV_LAUNCHER__`` environment variable is used to set :c:member:"
"`PyConfig.base_executable`"
msgstr ""
#: c-api/init_config.rst:1401
msgid "Py_RunMain()"
msgstr ""
#: c-api/init_config.rst:1405
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:1410
msgid "By default and when if :option:`-i` option is used, run the REPL."
msgstr ""
#: c-api/init_config.rst:1412
msgid ""
"Finally, finalizes Python and returns an exit status that can be passed to "
"the ``exit()`` function."
msgstr ""
#: c-api/init_config.rst:1415
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:1421
msgid "Py_GetArgcArgv()"
msgstr ""
#: c-api/init_config.rst:1425
msgid "Get the original command line arguments, before Python modified them."
msgstr ""
#: c-api/init_config.rst:1427
msgid "See also :c:member:`PyConfig.orig_argv` member."
msgstr ""
#: c-api/init_config.rst:1431
msgid "Multi-Phase Initialization Private Provisional API"
msgstr ""
#: c-api/init_config.rst:1433
msgid ""
"This section is a private provisional API introducing multi-phase "
"initialization, the core feature of :pep:`432`:"
msgstr ""
#: c-api/init_config.rst:1436
msgid "\"Core\" initialization phase, \"bare minimum Python\":"
msgstr ""
#: c-api/init_config.rst:1438
msgid "Builtin types;"
msgstr ""
#: c-api/init_config.rst:1439
msgid "Builtin exceptions;"
msgstr ""
#: c-api/init_config.rst:1440
msgid "Builtin and frozen modules;"
msgstr ""
#: c-api/init_config.rst:1441
msgid ""
"The :mod:`sys` module is only partially initialized (ex: :data:`sys.path` "
"doesn't exist yet)."
msgstr ""
#: c-api/init_config.rst:1444
msgid "\"Main\" initialization phase, Python is fully initialized:"
msgstr ""
#: c-api/init_config.rst:1446
msgid "Install and configure :mod:`importlib`;"
msgstr ""
#: c-api/init_config.rst:1447
msgid "Apply the :ref:`Path Configuration <init-path-config>`;"
msgstr ""
#: c-api/init_config.rst:1448
msgid "Install signal handlers;"
msgstr ""
#: c-api/init_config.rst:1449
msgid ""
"Finish :mod:`sys` module initialization (ex: create :data:`sys.stdout` and :"
"data:`sys.path`);"
msgstr ""
#: c-api/init_config.rst:1451
msgid ""
"Enable optional features like :mod:`faulthandler` and :mod:`tracemalloc`;"
msgstr ""
#: c-api/init_config.rst:1452
msgid "Import the :mod:`site` module;"
msgstr ""
#: c-api/init_config.rst:1453
msgid "etc."
msgstr ""
#: c-api/init_config.rst:1455
msgid "Private provisional API:"
msgstr ""
#: c-api/init_config.rst:1457
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:1459
msgid ""
":c:member:`PyConfig._isolated_interpreter`: if non-zero, disallow threads, "
"subprocesses and fork."
msgstr ""
#: c-api/init_config.rst:1464
msgid ""
"Move to the \"Main\" initialization phase, finish the Python initialization."
msgstr ""
#: c-api/init_config.rst:1466
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:1472
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:1476
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:1481
msgid ""
"Example running Python code between \"Core\" and \"Main\" initialization "
"phases::"
msgstr ""
#, fuzzy
#~ msgid "Functions:"
#~ msgstr "Fonctions"
#, fuzzy
#~ msgid "Interactive mode."
#~ msgstr "Mode interactif"