finevine/python-docs-fr
1
0
Fork 0
forked from AFPy/python-docs-fr
Code Issues Pull Requests Packages Projects Releases Wiki Activity
fecaae68a8
python-docs-fr/c-api/init_config.po
Julien Palard fecaae68a8
Make merge
2022-03-23 18:44:13 +01:00

1968 lines
53 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-03-23 18:39+0100\n"
"PO-Revision-Date: 2019-09-04 11:42+0200\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: c-api/init_config.rst:7
msgid "Python Initialization Configuration"
msgstr ""
#: c-api/init_config.rst:11
msgid ""
"Python can be initialized with :c:func:`Py_InitializeFromConfig` and the :c:"
"type:`PyConfig` structure. It can be preinitialized with :c:func:"
"`Py_PreInitialize` and the :c:type:`PyPreConfig` structure."
msgstr ""
#: c-api/init_config.rst:15
msgid "There are two kinds of configuration:"
msgstr ""
#: c-api/init_config.rst:17
msgid ""
"The :ref:`Python Configuration <init-python-config>` can be used to build a "
"customized Python which behaves as the regular Python. For example, "
"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:528
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:649
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:655 c-api/init_config.rst:1123
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:820
msgid "Default: ``0`` in Python mode, ``1`` in isolated mode."
msgstr ""
#: c-api/init_config.rst:298
msgid "If non-zero:"
msgstr ""
#: c-api/init_config.rst:300
msgid "Set :c:member:`PyPreConfig.utf8_mode` to ``0``,"
msgstr ""
#: c-api/init_config.rst:301
msgid "Set :c:member:`PyConfig.filesystem_encoding` to ``\"mbcs\"``,"
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:833
msgid ""
"Only available on Windows. ``#ifdef MS_WINDOWS`` macro can be used for "
"Windows specific code."
msgstr ""
#: c-api/init_config.rst:597 c-api/init_config.rst:668
#: c-api/init_config.rst:792 c-api/init_config.rst:836
#: c-api/init_config.rst:910 c-api/init_config.rst:1019
#: c-api/init_config.rst:1087 c-api/init_config.rst:1158
msgid "Default: ``0``."
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:1132
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:1220
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:491
msgid ":ref:`Preinitialize Python <c-preinit>` if needed."
msgstr ""
#: c-api/init_config.rst:450
msgid ""
"Decode *str* using :c:func:`Py_DecodeLocale` and set the result into "
"``*config_str``."
msgstr ""
#: c-api/init_config.rst:457
msgid ""
"Set command line arguments (:c:member:`~PyConfig.argv` member of *config*) "
"from the *argv* list of wide character strings."
msgstr ""
#: c-api/init_config.rst:464
msgid ""
"Set command line arguments (:c:member:`~PyConfig.argv` member of *config*) "
"from the *argv* list of bytes strings. Decode bytes using :c:func:"
"`Py_DecodeLocale`."
msgstr ""
#: c-api/init_config.rst:472
msgid "Set the list of wide strings *list* to *length* and *items*."
msgstr ""
#: c-api/init_config.rst:478
msgid "Read all Python configuration."
msgstr ""
#: c-api/init_config.rst:480
msgid "Fields which are already initialized are left unchanged."
msgstr ""
#: c-api/init_config.rst:482
msgid ""
"Fields for :ref:`path configuration <init-path-config>` are no longer "
"calculated or modified when calling this function, as of Python 3.11."
msgstr ""
#: c-api/init_config.rst:939
msgid ""
"The :c:func:`PyConfig_Read` function only parses :c:member:`PyConfig.argv` "
"arguments once: :c:member:`PyConfig.parse_argv` is set to ``2`` after "
"arguments are parsed. Since Python arguments are strippped from :c:member:"
"`PyConfig.argv`, parsing arguments twice would parse the application options "
"as Python options."
msgstr ""
#: c-api/init_config.rst:493
msgid ""
"The :c:member:`PyConfig.argv` arguments are now only parsed once, :c:member:"
"`PyConfig.parse_argv` is set to ``2`` after arguments are parsed, and "
"arguments are only parsed if :c:member:`PyConfig.parse_argv` equals ``1``."
msgstr ""
#: c-api/init_config.rst:499
msgid ""
":c:func:`PyConfig_Read` no longer calculates all paths, and so fields listed "
"under :ref:`Python Path Configuration <init-path-config>` may no longer be "
"updated until :c:func:`Py_InitializeFromConfig` is called."
msgstr ""
#: c-api/init_config.rst:507
msgid "Release configuration memory."
msgstr ""
#: c-api/init_config.rst:509
msgid ""
"Most ``PyConfig`` methods :ref:`preinitialize Python <c-preinit>` if needed. "
"In that case, the Python preinitialization configuration (:c:type:"
"`PyPreConfig`) in based on the :c:type:`PyConfig`. If configuration fields "
"which are in common with :c:type:`PyPreConfig` are tuned, they must be set "
"before calling a :c:type:`PyConfig` method:"
msgstr ""
#: c-api/init_config.rst:515
msgid ":c:member:`PyConfig.dev_mode`"
msgstr ""
#: c-api/init_config.rst:516
msgid ":c:member:`PyConfig.isolated`"
msgstr ""
#: c-api/init_config.rst:517
msgid ":c:member:`PyConfig.parse_argv`"
msgstr ""
#: c-api/init_config.rst:518
msgid ":c:member:`PyConfig.use_environment`"
msgstr ""
#: c-api/init_config.rst:520
msgid ""
"Moreover, if :c:func:`PyConfig_SetArgv` or :c:func:`PyConfig_SetBytesArgv` "
"is used, this method must be called before other methods, since the "
"preinitialization configuration depends on command line arguments (if :c:"
"member:`parse_argv` is non-zero)."
msgstr ""
#: c-api/init_config.rst:525
msgid ""
"The caller of these methods is responsible to handle exceptions (error or "
"exit) using ``PyStatus_Exception()`` and ``Py_ExitStatusException()``."
msgstr ""
#: c-api/init_config.rst:532
msgid "Command line arguments: :data:`sys.argv`."
msgstr ""
#: c-api/init_config.rst:534
msgid ""
"Set :c:member:`~PyConfig.parse_argv` to ``1`` to parse :c:member:`~PyConfig."
"argv` the same way the regular Python parses Python command line arguments "
"and then to strip Python arguments from :c:member:`~PyConfig.argv`."
msgstr ""
#: c-api/init_config.rst:539
msgid ""
"If :c:member:`~PyConfig.argv` is empty, an empty string is added to ensure "
"that :data:`sys.argv` always exists and is never empty."
msgstr ""
#: c-api/init_config.rst:550 c-api/init_config.rst:570
#: c-api/init_config.rst:684 c-api/init_config.rst:880
#: c-api/init_config.rst:996 c-api/init_config.rst:1027
#: c-api/init_config.rst:1047
msgid "Default: ``NULL``."
msgstr ""
#: c-api/init_config.rst:544
msgid "See also the :c:member:`~PyConfig.orig_argv` member."
msgstr ""
#: c-api/init_config.rst:548
msgid ":data:`sys.base_exec_prefix`."
msgstr ""
#: c-api/init_config.rst:564 c-api/init_config.rst:677
#: c-api/init_config.rst:897 c-api/init_config.rst:980
msgid "Part of the :ref:`Python Path Configuration <init-path-config>` output."
msgstr ""
#: c-api/init_config.rst:556
msgid "Python base executable: :data:`sys._base_executable`."
msgstr ""
#: c-api/init_config.rst:558
msgid "Set by the :envvar:`__PYVENV_LAUNCHER__` environment variable."
msgstr ""
#: c-api/init_config.rst:560
msgid "Set from :c:member:`PyConfig.executable` if ``NULL``."
msgstr ""
#: c-api/init_config.rst:568
msgid ":data:`sys.base_prefix`."
msgstr ""
#: c-api/init_config.rst:576
msgid ""
"If equals to 0 and :c:member:`~PyConfig.configure_c_stdio` is non-zero, "
"disable buffering on the C streams stdout and stderr."
msgstr ""
#: c-api/init_config.rst:579
msgid ""
"Set to 0 by the :option:`-u` command line option and the :envvar:"
"`PYTHONUNBUFFERED` environment variable."
msgstr ""
#: c-api/init_config.rst:582
msgid "stdin is always opened in buffered mode."
msgstr ""
#: c-api/init_config.rst:617 c-api/init_config.rst:1190
msgid "Default: ``1``."
msgstr ""
#: c-api/init_config.rst:588
msgid ""
"If equals to 1, issue a warning when comparing :class:`bytes` or :class:"
"`bytearray` with :class:`str`, or comparing :class:`bytes` with :class:`int`."
msgstr ""
#: c-api/init_config.rst:592
msgid ""
"If equal or greater to 2, raise a :exc:`BytesWarning` exception in these "
"cases."
msgstr ""
#: c-api/init_config.rst:595
msgid "Incremented by the :option:`-b` command line option."
msgstr ""
#: c-api/init_config.rst:601
msgid ""
"If non-zero, emit a :exc:`EncodingWarning` warning when :class:`io."
"TextIOWrapper` uses its default encoding. See :ref:`io-encoding-warning` for "
"details."
msgstr ""
#: c-api/init_config.rst:610
msgid ""
"If equals to ``0``, disables the inclusion of the end line and column "
"mappings in code objects. Also disables traceback printing carets to "
"specific error locations."
msgstr ""
#: c-api/init_config.rst:614
msgid ""
"Set to ``0`` by the :envvar:`PYTHONNODEBUGRANGES` environment variable and "
"by the :option:`-X no_debug_ranges <-X>` command line option."
msgstr ""
#: c-api/init_config.rst:623
msgid ""
"Control the validation behavior of hash-based ``.pyc`` files: value of the :"
"option:`--check-hash-based-pycs` command line option."
msgstr ""
#: c-api/init_config.rst:626
msgid "Valid values:"
msgstr ""
#: c-api/init_config.rst:628
msgid ""
"``L\"always\"``: Hash the source file for invalidation regardless of value "
"of the 'check_source' flag."
msgstr ""
#: c-api/init_config.rst:630
msgid "``L\"never\"``: Assume that hash-based pycs always are valid."
msgstr ""
#: c-api/init_config.rst:631
msgid ""
"``L\"default\"``: The 'check_source' flag in hash-based pycs determines "
"invalidation."
msgstr ""
#: c-api/init_config.rst:634
msgid "Default: ``L\"default\"``."
msgstr ""
#: c-api/init_config.rst:636
msgid "See also :pep:`552` \"Deterministic pycs\"."
msgstr ""
#: c-api/init_config.rst:640
msgid "If non-zero, configure C standard streams:"
msgstr ""
#: c-api/init_config.rst:642
msgid ""
"On Windows, set the binary mode (``O_BINARY``) on stdin, stdout and stderr."
msgstr ""
#: c-api/init_config.rst:644
msgid ""
"If :c:member:`~PyConfig.buffered_stdio` equals zero, disable buffering of "
"stdin, stdout and stderr streams."
msgstr ""
#: c-api/init_config.rst:646
msgid ""
"If :c:member:`~PyConfig.interactive` is non-zero, enable stream buffering on "
"stdin and stdout (only stdout on Windows)."
msgstr ""
#: c-api/init_config.rst:653
msgid "If non-zero, enable the :ref:`Python Development Mode <devmode>`."
msgstr ""
#: c-api/init_config.rst:659
msgid "Dump Python references?"
msgstr ""
#: c-api/init_config.rst:661
msgid "If non-zero, dump all objects which are still alive at exit."
msgstr ""
#: c-api/init_config.rst:663
msgid "Set to ``1`` by the :envvar:`PYTHONDUMPREFS` environment variable."
msgstr ""
#: c-api/init_config.rst:665
msgid ""
"Need a special build of Python with the ``Py_TRACE_REFS`` macro defined: see "
"the :option:`configure --with-trace-refs option <--with-trace-refs>`."
msgstr ""
#: c-api/init_config.rst:672
msgid ""
"The site-specific directory prefix where the platform-dependent Python files "
"are installed: :data:`sys.exec_prefix`."
msgstr ""
#: c-api/init_config.rst:681
msgid ""
"The absolute path of the executable binary for the Python interpreter: :data:"
"`sys.executable`."
msgstr ""
#: c-api/init_config.rst:690
msgid "Enable faulthandler?"
msgstr ""
#: c-api/init_config.rst:692
msgid "If non-zero, call :func:`faulthandler.enable` at startup."
msgstr ""
#: c-api/init_config.rst:694
msgid ""
"Set to ``1`` by :option:`-X faulthandler <-X>` and the :envvar:"
"`PYTHONFAULTHANDLER` environment variable."
msgstr ""
#: c-api/init_config.rst:701
msgid ""
":term:`Filesystem encoding <filesystem encoding and error handler>`: :func:"
"`sys.getfilesystemencoding`."
msgstr ""
#: c-api/init_config.rst:704
msgid "On macOS, Android and VxWorks: use ``\"utf-8\"`` by default."
msgstr ""
#: c-api/init_config.rst:706
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:710
msgid "Default encoding on other platforms:"
msgstr ""
#: c-api/init_config.rst:712
msgid "``\"utf-8\"`` if :c:member:`PyPreConfig.utf8_mode` is non-zero."
msgstr ""
#: c-api/init_config.rst:713
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:717
msgid "``\"utf-8\"`` if ``nl_langinfo(CODESET)`` returns an empty string."
msgstr ""
#: c-api/init_config.rst:718
msgid ""
"Otherwise, use the :term:`locale encoding`: ``nl_langinfo(CODESET)`` result."
msgstr ""
#: c-api/init_config.rst:721
msgid ""
"At Python startup, the encoding name is normalized to the Python codec name. "
"For example, ``\"ANSI_X3.4-1968\"`` is replaced with ``\"ascii\"``."
msgstr ""
#: c-api/init_config.rst:724
msgid "See also the :c:member:`~PyConfig.filesystem_errors` member."
msgstr ""
#: c-api/init_config.rst:728
msgid ""
":term:`Filesystem error handler <filesystem encoding and error handler>`: :"
"func:`sys.getfilesystemencodeerrors`."
msgstr ""
#: c-api/init_config.rst:731
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:735
msgid "On other platforms: use ``\"surrogateescape\"`` by default."
msgstr ""
#: c-api/init_config.rst:737
msgid "Supported error handlers:"
msgstr ""
#: c-api/init_config.rst:739
msgid "``\"strict\"``"
msgstr ""
#: c-api/init_config.rst:740
msgid "``\"surrogateescape\"``"
msgstr ""
#: c-api/init_config.rst:741
msgid "``\"surrogatepass\"`` (only supported with the UTF-8 encoding)"
msgstr ""
#: c-api/init_config.rst:743
msgid "See also the :c:member:`~PyConfig.filesystem_encoding` member."
msgstr ""
#: c-api/init_config.rst:748
msgid "Randomized hash function seed."
msgstr ""
#: c-api/init_config.rst:750
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:753
msgid "Set by the :envvar:`PYTHONHASHSEED` environment variable."
msgstr ""
#: c-api/init_config.rst:755
msgid ""
"Default *use_hash_seed* value: ``-1`` in Python mode, ``0`` in isolated mode."
msgstr ""
#: c-api/init_config.rst:760
msgid "Python home directory."
msgstr ""
#: c-api/init_config.rst:762
msgid ""
"If :c:func:`Py_SetPythonHome` has been called, use its argument if it is not "
"``NULL``."
msgstr ""
#: c-api/init_config.rst:765
msgid "Set by the :envvar:`PYTHONHOME` environment variable."
msgstr ""
#: c-api/init_config.rst:862 c-api/init_config.rst:968
#: c-api/init_config.rst:998
msgid "Part of the :ref:`Python Path Configuration <init-path-config>` input."
msgstr ""
#: c-api/init_config.rst:773
msgid "If non-zero, profile import time."
msgstr ""
#: c-api/init_config.rst:775
msgid ""
"Set the ``1`` by the :option:`-X importtime <-X>` option and the :envvar:"
"`PYTHONPROFILEIMPORTTIME` environment variable."
msgstr ""
#: c-api/init_config.rst:782
msgid "Enter interactive mode after executing a script or a command."
msgstr ""
#: c-api/init_config.rst:784
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:789
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:796
msgid "Install Python signal handlers?"
msgstr ""
#: c-api/init_config.rst:945 c-api/init_config.rst:1142
msgid "Default: ``1`` in Python mode, ``0`` in isolated mode."
msgstr ""
#: c-api/init_config.rst:802
msgid "If greater than 0, enable the interactive mode (REPL)."
msgstr ""
#: c-api/init_config.rst:804
msgid "Incremented by the :option:`-i` command line option."
msgstr ""
#: c-api/init_config.rst:810
msgid "If greater than 0, enable isolated mode:"
msgstr ""
#: c-api/init_config.rst:812
msgid ""
":data:`sys.path` contains neither the script's directory (computed from "
"``argv[0]`` or the current directory) nor the user's site-packages directory."
msgstr ""
#: c-api/init_config.rst:815
msgid ""
"Python REPL doesn't import :mod:`readline` nor enable default readline "
"configuration on interactive prompts."
msgstr ""
#: c-api/init_config.rst:817
msgid ""
"Set :c:member:`~PyConfig.use_environment` and :c:member:`~PyConfig."
"user_site_directory` to 0."
msgstr ""
#: c-api/init_config.rst:822
msgid "See also :c:member:`PyPreConfig.isolated`."
msgstr ""
#: c-api/init_config.rst:826
msgid ""
"If non-zero, use :class:`io.FileIO` instead of :class:`io.WindowsConsoleIO` "
"for :data:`sys.stdin`, :data:`sys.stdout` and :data:`sys.stderr`."
msgstr ""
#: c-api/init_config.rst:830
msgid ""
"Set to ``1`` if the :envvar:`PYTHONLEGACYWINDOWSSTDIO` environment variable "
"is set to a non-empty string."
msgstr ""
#: c-api/init_config.rst:838
msgid "See also the :pep:`528` (Change Windows console encoding to UTF-8)."
msgstr ""
#: c-api/init_config.rst:842
msgid ""
"If non-zero, dump statistics on :ref:`Python pymalloc memory allocator "
"<pymalloc>` at exit."
msgstr ""
#: c-api/init_config.rst:845
msgid "Set to ``1`` by the :envvar:`PYTHONMALLOCSTATS` environment variable."
msgstr ""
#: c-api/init_config.rst:847
msgid ""
"The option is ignored if Python is :option:`configured using the --without-"
"pymalloc option <--without-pymalloc>`."
msgstr ""
#: c-api/init_config.rst:854
msgid "Platform library directory name: :data:`sys.platlibdir`."
msgstr ""
#: c-api/init_config.rst:856
msgid "Set by the :envvar:`PYTHONPLATLIBDIR` environment variable."
msgstr ""
#: c-api/init_config.rst:858
msgid ""
"Default: value of the ``PLATLIBDIR`` macro which is set by the :option:"
"`configure --with-platlibdir option <--with-platlibdir>` (default: "
"``\"lib\"``, or ``\"DLLs\"`` on Windows)."
msgstr ""
#: c-api/init_config.rst:866
msgid ""
"This macro is now used on Windows to locate the standard library extension "
"modules, typically under ``DLLs``. However, for compatibility, note that "
"this value is ignored for any non-standard layouts, including in-tree builds "
"and virtual environments."
msgstr ""
#: c-api/init_config.rst:875
msgid ""
"Module search paths (:data:`sys.path`) as a string separated by ``DELIM`` (:"
"data:`os.path.pathsep`)."
msgstr ""
#: c-api/init_config.rst:878
msgid "Set by the :envvar:`PYTHONPATH` environment variable."
msgstr ""
#: c-api/init_config.rst:887
msgid "Module search paths: :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:889
msgid ""
"If :c:member:`~PyConfig.module_search_paths_set` is equal to 0, :c:func:"
"`Py_InitializeFromConfig` will replace :c:member:`~PyConfig."
"module_search_paths` and sets :c:member:`~PyConfig.module_search_paths_set` "
"to ``1``."
msgstr ""
#: c-api/init_config.rst:894
msgid ""
"Default: empty list (``module_search_paths``) and ``0`` "
"(``module_search_paths_set``)."
msgstr ""
#: c-api/init_config.rst:901
msgid "Compilation optimization level:"
msgstr ""
#: c-api/init_config.rst:903
msgid "``0``: Peephole optimizer, set ``__debug__`` to ``True``."
msgstr ""
#: c-api/init_config.rst:904
msgid "``1``: Level 0, remove assertions, set ``__debug__`` to ``False``."
msgstr ""
#: c-api/init_config.rst:905
msgid "``2``: Level 1, strip docstrings."
msgstr ""
#: c-api/init_config.rst:907
msgid ""
"Incremented by the :option:`-O` command line option. Set to the :envvar:"
"`PYTHONOPTIMIZE` environment variable value."
msgstr ""
#: c-api/init_config.rst:914
msgid ""
"The list of the original command line arguments passed to the Python "
"executable: :data:`sys.orig_argv`."
msgstr ""
#: c-api/init_config.rst:917
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:924
msgid ""
"See also the :c:member:`~PyConfig.argv` member and the :c:func:"
"`Py_GetArgcArgv` function."
msgstr ""
#: c-api/init_config.rst:1177 c-api/init_config.rst:1196
msgid "Default: empty list."
msgstr ""
#: c-api/init_config.rst:933
msgid "Parse command line arguments?"
msgstr ""
#: c-api/init_config.rst:935
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:947
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:953
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:956
msgid ""
"Incremented by the :option:`-d` command line option. Set to the :envvar:"
"`PYTHONDEBUG` environment variable value."
msgstr ""
#: c-api/init_config.rst:963
msgid ""
"If non-zero, calculation of path configuration is allowed to log warnings "
"into ``stderr``. If equals to 0, suppress these warnings."
msgstr ""
#: c-api/init_config.rst:970
msgid "Now also applies on Windows."
msgstr ""
#: c-api/init_config.rst:975
msgid ""
"The site-specific directory prefix where the platform independent Python "
"files are installed: :data:`sys.prefix`."
msgstr ""
#: c-api/init_config.rst:984
msgid ""
"Program name used to initialize :c:member:`~PyConfig.executable` and in "
"early error messages during Python initialization."
msgstr ""
#: c-api/init_config.rst:987
msgid "If :func:`Py_SetProgramName` has been called, use its argument."
msgstr ""
#: c-api/init_config.rst:988
msgid "On macOS, use :envvar:`PYTHONEXECUTABLE` environment variable if set."
msgstr ""
#: c-api/init_config.rst:989
msgid ""
"If the ``WITH_NEXT_FRAMEWORK`` macro is defined, use :envvar:"
"`__PYVENV_LAUNCHER__` environment variable if set."
msgstr ""
#: c-api/init_config.rst:991
msgid ""
"Use ``argv[0]`` of :c:member:`~PyConfig.argv` if available and non-empty."
msgstr ""
#: c-api/init_config.rst:993
msgid ""
"Otherwise, use ``L\"python\"`` on Windows, or ``L\"python3\"`` on other "
"platforms."
msgstr ""
#: c-api/init_config.rst:1002
msgid ""
"Directory where cached ``.pyc`` files are written: :data:`sys."
"pycache_prefix`."
msgstr ""
#: c-api/init_config.rst:1005
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:1008
msgid "If ``NULL``, :data:`sys.pycache_prefix` is set to ``None``."
msgstr ""
#: c-api/init_config.rst:1014
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:1017
msgid "Incremented by the :option:`-q` command line option."
msgstr ""
#: c-api/init_config.rst:1023
msgid "Value of the :option:`-c` command line option."
msgstr ""
#: c-api/init_config.rst:1037 c-api/init_config.rst:1045
msgid "Used by :c:func:`Py_RunMain`."
msgstr ""
#: c-api/init_config.rst:1031
msgid ""
"Filename passed on the command line: trailing command line argument without :"
"option:`-c` or :option:`-m`."
msgstr ""
#: c-api/init_config.rst:1034
msgid ""
"For example, it is set to ``script.py`` by the ``python3 script.py arg`` "
"command."
msgstr ""
#: c-api/init_config.rst:1043
msgid "Value of the :option:`-m` command line option."
msgstr ""
#: c-api/init_config.rst:1051
msgid "Show total reference count at exit?"
msgstr ""
#: c-api/init_config.rst:1053
msgid "Set to 1 by :option:`-X showrefcount <-X>` command line option."
msgstr ""
#: c-api/init_config.rst:1055
msgid ""
"Need a :ref:`debug build of Python <debug-build>` (the ``Py_REF_DEBUG`` "
"macro must be defined)."
msgstr ""
#: c-api/init_config.rst:1062
msgid "Import the :mod:`site` module at startup?"
msgstr ""
#: c-api/init_config.rst:1064
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:1067
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:1070
msgid "Set to ``0`` by the :option:`-S` command line option."
msgstr ""
#: c-api/init_config.rst:1072
msgid ""
":data:`sys.flags.no_site` is set to the inverted value of :c:member:"
"`~PyConfig.site_import`."
msgstr ""
#: c-api/init_config.rst:1079
msgid ""
"If non-zero, skip the first line of the :c:member:`PyConfig.run_filename` "
"source."
msgstr ""
#: c-api/init_config.rst:1082
msgid ""
"It allows the usage of non-Unix forms of ``#!cmd``. This is intended for a "
"DOS specific hack only."
msgstr ""
#: c-api/init_config.rst:1085
msgid "Set to ``1`` by the :option:`-x` command line option."
msgstr ""
#: c-api/init_config.rst:1092
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:1096
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:1099
msgid ""
"Use the :envvar:`PYTHONIOENCODING` environment variable if it is non-empty."
msgstr ""
#: c-api/init_config.rst:1102
msgid "Default encoding:"
msgstr ""
#: c-api/init_config.rst:1104
msgid "``\"UTF-8\"`` if :c:member:`PyPreConfig.utf8_mode` is non-zero."
msgstr ""
#: c-api/init_config.rst:1105
msgid "Otherwise, use the :term:`locale encoding`."
msgstr ""
#: c-api/init_config.rst:1107
msgid "Default error handler:"
msgstr ""
#: c-api/init_config.rst:1109
msgid "On Windows: use ``\"surrogateescape\"``."
msgstr ""
#: c-api/init_config.rst:1110
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:1112
msgid "``\"strict\"`` otherwise."
msgstr ""
#: c-api/init_config.rst:1116
msgid "Enable tracemalloc?"
msgstr ""
#: c-api/init_config.rst:1118
msgid "If non-zero, call :func:`tracemalloc.start` at startup."
msgstr ""
#: c-api/init_config.rst:1120
msgid ""
"Set by :option:`-X tracemalloc=N <-X>` command line option and by the :"
"envvar:`PYTHONTRACEMALLOC` environment variable."
msgstr ""
#: c-api/init_config.rst:1127
msgid "Use :ref:`environment variables <using-on-envvars>`?"
msgstr ""
#: c-api/init_config.rst:1129
msgid ""
"If equals to zero, ignore the :ref:`environment variables <using-on-"
"envvars>`."
msgstr ""
#: c-api/init_config.rst:1136
msgid "If non-zero, add the user site directory to :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:1138
msgid "Set to ``0`` by the :option:`-s` and :option:`-I` command line options."
msgstr ""
#: c-api/init_config.rst:1140
msgid "Set to ``0`` by the :envvar:`PYTHONNOUSERSITE` environment variable."
msgstr ""
#: c-api/init_config.rst:1146
msgid ""
"Verbose mode. If greater than 0, print a message each time a module is "
"imported, showing the place (filename or built-in module) from which it is "
"loaded."
msgstr ""
#: c-api/init_config.rst:1150
msgid ""
"If greater or equal to 2, print a message for each file that is checked for "
"when searching for a module. Also provides information on module cleanup at "
"exit."
msgstr ""
#: c-api/init_config.rst:1154
msgid "Incremented by the :option:`-v` command line option."
msgstr ""
#: c-api/init_config.rst:1156
msgid "Set to the :envvar:`PYTHONVERBOSE` environment variable value."
msgstr ""
#: c-api/init_config.rst:1162
msgid ""
"Options of the :mod:`warnings` module to build warnings filters, lowest to "
"highest priority: :data:`sys.warnoptions`."
msgstr ""
#: c-api/init_config.rst:1165
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:1170
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:1173
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:1181
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:1184
msgid ""
"Set to ``0`` by the :option:`-B` command line option and the :envvar:"
"`PYTHONDONTWRITEBYTECODE` environment variable."
msgstr ""
#: c-api/init_config.rst:1187
msgid ""
":data:`sys.dont_write_bytecode` is initialized to the inverted value of :c:"
"member:`~PyConfig.write_bytecode`."
msgstr ""
#: c-api/init_config.rst:1194
msgid "Values of the :option:`-X` command line options: :data:`sys._xoptions`."
msgstr ""
#: c-api/init_config.rst:1198
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:1203
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:1208
msgid "The ``show_alloc_count`` field has been removed."
msgstr ""
#: c-api/init_config.rst:1212
msgid "Initialization with PyConfig"
msgstr ""
#: c-api/init_config.rst:1214
msgid "Function to initialize Python:"
msgstr ""
#: c-api/init_config.rst:1218
msgid "Initialize Python from *config* configuration."
msgstr ""
#: c-api/init_config.rst:1223
msgid ""
"If :c:func:`PyImport_FrozenModules`, :c:func:`PyImport_AppendInittab` or :c:"
"func:`PyImport_ExtendInittab` are used, they must be set or called after "
"Python preinitialization and before the Python initialization. If Python is "
"initialized multiple times, :c:func:`PyImport_AppendInittab` or :c:func:"
"`PyImport_ExtendInittab` must be called before each Python initialization."
msgstr ""
#: c-api/init_config.rst:1230
msgid ""
"The current configuration (``PyConfig`` type) is stored in "
"``PyInterpreterState.config``."
msgstr ""
#: c-api/init_config.rst:1233
msgid "Example setting the program name::"
msgstr ""
#: c-api/init_config.rst:1261
msgid ""
"More complete example modifying the default configuration, read the "
"configuration, and then override some parameters::"
msgstr ""
#: c-api/init_config.rst:1312
msgid "Isolated Configuration"
msgstr ""
#: c-api/init_config.rst:1314
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:1319
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:1324
msgid ""
"Configuration files are still used with this configuration to determine "
"paths that are unspecified. Ensure :c:member:`PyConfig.home` is specified to "
"avoid computing the default path configuration."
msgstr ""
#: c-api/init_config.rst:1332
msgid "Python Configuration"
msgstr ""
#: c-api/init_config.rst:1334
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:1338
msgid ""
"Environments variables and command line arguments are used to configure "
"Python, whereas global configuration variables are ignored."
msgstr ""
#: c-api/init_config.rst:1341
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:1350
msgid "Python Path Configuration"
msgstr ""
#: c-api/init_config.rst:1352
msgid ":c:type:`PyConfig` contains multiple fields for the path configuration:"
msgstr ""
#: c-api/init_config.rst:1354
msgid "Path configuration inputs:"
msgstr ""
#: c-api/init_config.rst:1356
msgid ":c:member:`PyConfig.home`"
msgstr ""
#: c-api/init_config.rst:1357
msgid ":c:member:`PyConfig.platlibdir`"
msgstr ""
#: c-api/init_config.rst:1358
msgid ":c:member:`PyConfig.pathconfig_warnings`"
msgstr ""
#: c-api/init_config.rst:1359
msgid ":c:member:`PyConfig.program_name`"
msgstr ""
#: c-api/init_config.rst:1360
msgid ":c:member:`PyConfig.pythonpath_env`"
msgstr ""
#: c-api/init_config.rst:1361
msgid "current working directory: to get absolute paths"
msgstr ""
#: c-api/init_config.rst:1362
msgid ""
"``PATH`` environment variable to get the program full path (from :c:member:"
"`PyConfig.program_name`)"
msgstr ""
#: c-api/init_config.rst:1364
msgid "``__PYVENV_LAUNCHER__`` environment variable"
msgstr ""
#: c-api/init_config.rst:1365
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:1369
msgid "Path configuration output fields:"
msgstr ""
#: c-api/init_config.rst:1371
msgid ":c:member:`PyConfig.base_exec_prefix`"
msgstr ""
#: c-api/init_config.rst:1372
msgid ":c:member:`PyConfig.base_executable`"
msgstr ""
#: c-api/init_config.rst:1373
msgid ":c:member:`PyConfig.base_prefix`"
msgstr ""
#: c-api/init_config.rst:1374
msgid ":c:member:`PyConfig.exec_prefix`"
msgstr ""
#: c-api/init_config.rst:1375
msgid ":c:member:`PyConfig.executable`"
msgstr ""
#: c-api/init_config.rst:1376
msgid ""
":c:member:`PyConfig.module_search_paths_set`, :c:member:`PyConfig."
"module_search_paths`"
msgstr ""
#: c-api/init_config.rst:1378
msgid ":c:member:`PyConfig.prefix`"
msgstr ""
#: c-api/init_config.rst:1380
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:1386
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:1393
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:1396
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:1400
msgid ":c:func:`Py_RunMain` and :c:func:`Py_Main` modify :data:`sys.path`:"
msgstr ""
#: c-api/init_config.rst:1402
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:1405
msgid "If :c:member:`~PyConfig.isolated` is zero:"
msgstr ""
#: c-api/init_config.rst:1407
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:1409
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:1411
msgid "Otherwise, prepend an empty string to :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:1413
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:1419
msgid "The following configuration files are used by the path configuration:"
msgstr ""
#: c-api/init_config.rst:1421
msgid "``pyvenv.cfg``"
msgstr ""
#: c-api/init_config.rst:1422
msgid "``python._pth`` (Windows only)"
msgstr ""
#: c-api/init_config.rst:1423
msgid "``pybuilddir.txt`` (Unix only)"
msgstr ""
#: c-api/init_config.rst:1425
msgid ""
"The ``__PYVENV_LAUNCHER__`` environment variable is used to set :c:member:"
"`PyConfig.base_executable`"
msgstr ""
#: c-api/init_config.rst:1430
msgid "Py_RunMain()"
msgstr ""
#: c-api/init_config.rst:1434
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:1439
msgid "By default and when if :option:`-i` option is used, run the REPL."
msgstr ""
#: c-api/init_config.rst:1441
msgid ""
"Finally, finalizes Python and returns an exit status that can be passed to "
"the ``exit()`` function."
msgstr ""
#: c-api/init_config.rst:1444
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:1450
msgid "Py_GetArgcArgv()"
msgstr ""
#: c-api/init_config.rst:1454
msgid "Get the original command line arguments, before Python modified them."
msgstr ""
#: c-api/init_config.rst:1456
msgid "See also :c:member:`PyConfig.orig_argv` member."
msgstr ""
#: c-api/init_config.rst:1460
msgid "Multi-Phase Initialization Private Provisional API"
msgstr ""
#: c-api/init_config.rst:1462
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:1465
msgid "\"Core\" initialization phase, \"bare minimum Python\":"
msgstr ""
#: c-api/init_config.rst:1467
msgid "Builtin types;"
msgstr ""
#: c-api/init_config.rst:1468
msgid "Builtin exceptions;"
msgstr ""
#: c-api/init_config.rst:1469
msgid "Builtin and frozen modules;"
msgstr ""
#: c-api/init_config.rst:1470
msgid ""
"The :mod:`sys` module is only partially initialized (ex: :data:`sys.path` "
"doesn't exist yet)."
msgstr ""
#: c-api/init_config.rst:1473
msgid "\"Main\" initialization phase, Python is fully initialized:"
msgstr ""
#: c-api/init_config.rst:1475
msgid "Install and configure :mod:`importlib`;"
msgstr ""
#: c-api/init_config.rst:1476
msgid "Apply the :ref:`Path Configuration <init-path-config>`;"
msgstr ""
#: c-api/init_config.rst:1477
msgid "Install signal handlers;"
msgstr ""
#: c-api/init_config.rst:1478
msgid ""
"Finish :mod:`sys` module initialization (ex: create :data:`sys.stdout` and :"
"data:`sys.path`);"
msgstr ""
#: c-api/init_config.rst:1480
msgid ""
"Enable optional features like :mod:`faulthandler` and :mod:`tracemalloc`;"
msgstr ""
#: c-api/init_config.rst:1481
msgid "Import the :mod:`site` module;"
msgstr ""
#: c-api/init_config.rst:1482
msgid "etc."
msgstr ""
#: c-api/init_config.rst:1484
msgid "Private provisional API:"
msgstr ""
#: c-api/init_config.rst:1486
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:1488
msgid ""
":c:member:`PyConfig._isolated_interpreter`: if non-zero, disallow threads, "
"subprocesses and fork."
msgstr ""
#: c-api/init_config.rst:1493
msgid ""
"Move to the \"Main\" initialization phase, finish the Python initialization."
msgstr ""
#: c-api/init_config.rst:1495
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:1501
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:1505
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:1510
msgid ""
"Example running Python code between \"Core\" and \"Main\" initialization "
"phases::"
msgstr ""
#, fuzzy
#~ msgid "Functions:"
#~ msgstr "Fonctions"
#, fuzzy
#~ msgid "Interactive mode."
#~ msgstr "Mode interactif"
Reference in New Issue View Git Blame Copy Permalink