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

1350 lines
37 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: 2019-11-15 18:54+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"
#: ../Doc/c-api/init_config.rst:7
msgid "Python Initialization Configuration"
msgstr ""
#: ../Doc/c-api/init_config.rst:11
msgid "Structures:"
msgstr ""
#: ../Doc/c-api/init_config.rst:13
msgid ":c:type:`PyConfig`"
msgstr ""
#: ../Doc/c-api/init_config.rst:14
msgid ":c:type:`PyPreConfig`"
msgstr ""
#: ../Doc/c-api/init_config.rst:15
msgid ":c:type:`PyStatus`"
msgstr ""
#: ../Doc/c-api/init_config.rst:16
msgid ":c:type:`PyWideStringList`"
msgstr ""
#: ../Doc/c-api/init_config.rst:18
msgid "Functions:"
msgstr ""
#: ../Doc/c-api/init_config.rst:20
msgid ":c:func:`PyConfig_Clear`"
msgstr ""
#: ../Doc/c-api/init_config.rst:21
msgid ":c:func:`PyConfig_InitIsolatedConfig`"
msgstr ""
#: ../Doc/c-api/init_config.rst:22
msgid ":c:func:`PyConfig_InitPythonConfig`"
msgstr ""
#: ../Doc/c-api/init_config.rst:23
msgid ":c:func:`PyConfig_Read`"
msgstr ""
#: ../Doc/c-api/init_config.rst:24
msgid ":c:func:`PyConfig_SetArgv`"
msgstr ""
#: ../Doc/c-api/init_config.rst:25
msgid ":c:func:`PyConfig_SetBytesArgv`"
msgstr ""
#: ../Doc/c-api/init_config.rst:26
msgid ":c:func:`PyConfig_SetBytesString`"
msgstr ""
#: ../Doc/c-api/init_config.rst:27
msgid ":c:func:`PyConfig_SetString`"
msgstr ""
#: ../Doc/c-api/init_config.rst:28
msgid ":c:func:`PyConfig_SetWideStringList`"
msgstr ""
#: ../Doc/c-api/init_config.rst:29
msgid ":c:func:`PyPreConfig_InitIsolatedConfig`"
msgstr ""
#: ../Doc/c-api/init_config.rst:30
msgid ":c:func:`PyPreConfig_InitPythonConfig`"
msgstr ""
#: ../Doc/c-api/init_config.rst:31
msgid ":c:func:`PyStatus_Error`"
msgstr ""
#: ../Doc/c-api/init_config.rst:32
msgid ":c:func:`PyStatus_Exception`"
msgstr ""
#: ../Doc/c-api/init_config.rst:33
msgid ":c:func:`PyStatus_Exit`"
msgstr ""
#: ../Doc/c-api/init_config.rst:34
msgid ":c:func:`PyStatus_IsError`"
msgstr ""
#: ../Doc/c-api/init_config.rst:35
msgid ":c:func:`PyStatus_IsExit`"
msgstr ""
#: ../Doc/c-api/init_config.rst:36
msgid ":c:func:`PyStatus_NoMemory`"
msgstr ""
#: ../Doc/c-api/init_config.rst:37
msgid ":c:func:`PyStatus_Ok`"
msgstr ""
#: ../Doc/c-api/init_config.rst:38
msgid ":c:func:`PyWideStringList_Append`"
msgstr ""
#: ../Doc/c-api/init_config.rst:39
msgid ":c:func:`PyWideStringList_Insert`"
msgstr ""
#: ../Doc/c-api/init_config.rst:40
msgid ":c:func:`Py_ExitStatusException`"
msgstr ""
#: ../Doc/c-api/init_config.rst:41
msgid ":c:func:`Py_InitializeFromConfig`"
msgstr ""
#: ../Doc/c-api/init_config.rst:42
msgid ":c:func:`Py_PreInitialize`"
msgstr ""
#: ../Doc/c-api/init_config.rst:43
msgid ":c:func:`Py_PreInitializeFromArgs`"
msgstr ""
#: ../Doc/c-api/init_config.rst:44
msgid ":c:func:`Py_PreInitializeFromBytesArgs`"
msgstr ""
#: ../Doc/c-api/init_config.rst:45
msgid ":c:func:`Py_RunMain`"
msgstr ""
#: ../Doc/c-api/init_config.rst:47
msgid ""
"The preconfiguration (``PyPreConfig`` type) is stored in ``_PyRuntime."
"preconfig`` and the configuration (``PyConfig`` type) is stored in "
"``PyInterpreterState.config``."
msgstr ""
#: ../Doc/c-api/init_config.rst:51
msgid ""
"See also :ref:`Initialization, Finalization, and Threads <initialization>`."
msgstr ""
#: ../Doc/c-api/init_config.rst:54
msgid ":pep:`587` \"Python Initialization Configuration\"."
msgstr ""
#: ../Doc/c-api/init_config.rst:58
msgid "PyWideStringList"
msgstr ""
#: ../Doc/c-api/init_config.rst:62
msgid "List of ``wchar_t*`` strings."
msgstr ""
#: ../Doc/c-api/init_config.rst:64
msgid ""
"If *length* is non-zero, *items* must be non-``NULL`` and all strings must "
"be non-``NULL``."
msgstr ""
#: ../Doc/c-api/init_config.rst:67
msgid "Methods:"
msgstr ""
#: ../Doc/c-api/init_config.rst:71
msgid "Append *item* to *list*."
msgstr ""
#: ../Doc/c-api/init_config.rst:73 ../Doc/c-api/init_config.rst:84
msgid "Python must be preinitialized to call this function."
msgstr ""
#: ../Doc/c-api/init_config.rst:77
msgid "Insert *item* into *list* at *index*."
msgstr ""
#: ../Doc/c-api/init_config.rst:79
msgid ""
"If *index* is greater than or equal to *list* length, append *item* to "
"*list*."
msgstr ""
#: ../Doc/c-api/init_config.rst:82
msgid "*index* must be greater than or equal to 0."
msgstr ""
#: ../Doc/c-api/init_config.rst:86 ../Doc/c-api/init_config.rst:106
#: ../Doc/c-api/init_config.rst:209 ../Doc/c-api/init_config.rst:416
msgid "Structure fields:"
msgstr ""
#: ../Doc/c-api/init_config.rst:90
msgid "List length."
msgstr ""
#: ../Doc/c-api/init_config.rst:94
msgid "List items."
msgstr ""
#: ../Doc/c-api/init_config.rst:97
msgid "PyStatus"
msgstr ""
#: ../Doc/c-api/init_config.rst:101
msgid ""
"Structure to store an initialization function status: success, error or exit."
msgstr ""
#: ../Doc/c-api/init_config.rst:104
msgid "For an error, it can store the C function name which created the error."
msgstr ""
#: ../Doc/c-api/init_config.rst:110
msgid "Exit code. Argument passed to ``exit()``."
msgstr ""
#: ../Doc/c-api/init_config.rst:114
msgid "Error message."
msgstr ""
#: ../Doc/c-api/init_config.rst:118
msgid "Name of the function which created an error, can be ``NULL``."
msgstr ""
#: ../Doc/c-api/init_config.rst:120
msgid "Functions to create a status:"
msgstr ""
#: ../Doc/c-api/init_config.rst:124
msgid "Success."
msgstr ""
#: ../Doc/c-api/init_config.rst:128
msgid "Initialization error with a message."
msgstr ""
#: ../Doc/c-api/init_config.rst:132
msgid "Memory allocation failure (out of memory)."
msgstr ""
#: ../Doc/c-api/init_config.rst:136
msgid "Exit Python with the specified exit code."
msgstr ""
#: ../Doc/c-api/init_config.rst:138
msgid "Functions to handle a status:"
msgstr ""
#: ../Doc/c-api/init_config.rst:142
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 ""
#: ../Doc/c-api/init_config.rst:147
msgid "Is the result an error?"
msgstr ""
#: ../Doc/c-api/init_config.rst:151
msgid "Is the result an exit?"
msgstr ""
#: ../Doc/c-api/init_config.rst:155
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 ""
#: ../Doc/c-api/init_config.rst:160
msgid ""
"Internally, Python uses macros which set ``PyStatus.func``, whereas "
"functions to create a status set ``func`` to ``NULL``."
msgstr ""
#: ../Doc/c-api/init_config.rst:163
msgid "Example::"
msgstr "Exemple ::"
#: ../Doc/c-api/init_config.rst:187
msgid "PyPreConfig"
msgstr ""
#: ../Doc/c-api/init_config.rst:191
msgid "Structure used to preinitialize Python:"
msgstr ""
#: ../Doc/c-api/init_config.rst:193
msgid "Set the Python memory allocator"
msgstr ""
#: ../Doc/c-api/init_config.rst:194
msgid "Configure the LC_CTYPE locale"
msgstr ""
#: ../Doc/c-api/init_config.rst:195
msgid "Set the UTF-8 mode"
msgstr ""
#: ../Doc/c-api/init_config.rst:197
msgid "Function to initialize a preconfiguration:"
msgstr ""
#: ../Doc/c-api/init_config.rst:201
msgid ""
"Initialize the preconfiguration with :ref:`Python Configuration <init-python-"
"config>`."
msgstr ""
#: ../Doc/c-api/init_config.rst:206
msgid ""
"Initialize the preconfiguration with :ref:`Isolated Configuration <init-"
"isolated-conf>`."
msgstr ""
#: ../Doc/c-api/init_config.rst:213
msgid "Name of the memory allocator:"
msgstr ""
#: ../Doc/c-api/init_config.rst:215
msgid ""
"``PYMEM_ALLOCATOR_NOT_SET`` (``0``): don't change memory allocators (use "
"defaults)"
msgstr ""
#: ../Doc/c-api/init_config.rst:217
msgid "``PYMEM_ALLOCATOR_DEFAULT`` (``1``): default memory allocators"
msgstr ""
#: ../Doc/c-api/init_config.rst:218
msgid ""
"``PYMEM_ALLOCATOR_DEBUG`` (``2``): default memory allocators with debug hooks"
msgstr ""
#: ../Doc/c-api/init_config.rst:220
msgid "``PYMEM_ALLOCATOR_MALLOC`` (``3``): force usage of ``malloc()``"
msgstr ""
#: ../Doc/c-api/init_config.rst:221
msgid ""
"``PYMEM_ALLOCATOR_MALLOC_DEBUG`` (``4``): force usage of ``malloc()`` with "
"debug hooks"
msgstr ""
#: ../Doc/c-api/init_config.rst:223
msgid ""
"``PYMEM_ALLOCATOR_PYMALLOC`` (``5``): :ref:`Python pymalloc memory allocator "
"<pymalloc>`"
msgstr ""
#: ../Doc/c-api/init_config.rst:225
msgid ""
"``PYMEM_ALLOCATOR_PYMALLOC_DEBUG`` (``6``): :ref:`Python pymalloc memory "
"allocator <pymalloc>` with debug hooks"
msgstr ""
#: ../Doc/c-api/init_config.rst:228
msgid ""
"``PYMEM_ALLOCATOR_PYMALLOC`` and ``PYMEM_ALLOCATOR_PYMALLOC_DEBUG`` are not "
"supported if Python is configured using ``--without-pymalloc``"
msgstr ""
#: ../Doc/c-api/init_config.rst:231
msgid "See :ref:`Memory Management <memory>`."
msgstr ""
#: ../Doc/c-api/init_config.rst:235
msgid ""
"Set the LC_CTYPE locale to the user preferred locale? If equals to 0, set :c:"
"member:`coerce_c_locale` and :c:member:`coerce_c_locale_warn` to 0."
msgstr ""
#: ../Doc/c-api/init_config.rst:240
msgid ""
"If equals to 2, coerce the C locale; if equals to 1, read the LC_CTYPE "
"locale to decide if it should be coerced."
msgstr ""
#: ../Doc/c-api/init_config.rst:245
msgid "If non-zero, emit a warning if the C locale is coerced."
msgstr ""
#: ../Doc/c-api/init_config.rst:249
msgid "See :c:member:`PyConfig.dev_mode`."
msgstr ""
#: ../Doc/c-api/init_config.rst:253
msgid "See :c:member:`PyConfig.isolated`."
msgstr ""
#: ../Doc/c-api/init_config.rst:257
msgid ""
"If non-zero, disable UTF-8 Mode, set the Python filesystem encoding to "
"``mbcs``, set the filesystem error handler to ``replace``."
msgstr ""
#: ../Doc/c-api/init_config.rst:260 ../Doc/c-api/init_config.rst:546
msgid ""
"Only available on Windows. ``#ifdef MS_WINDOWS`` macro can be used for "
"Windows specific code."
msgstr ""
#: ../Doc/c-api/init_config.rst:265
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 ""
#: ../Doc/c-api/init_config.rst:272
msgid "See :c:member:`PyConfig.use_environment`."
msgstr ""
#: ../Doc/c-api/init_config.rst:276
msgid "If non-zero, enable the UTF-8 mode."
msgstr ""
#: ../Doc/c-api/init_config.rst:279
msgid "Preinitialization with PyPreConfig"
msgstr ""
#: ../Doc/c-api/init_config.rst:281
msgid "Functions to preinitialize Python:"
msgstr ""
#: ../Doc/c-api/init_config.rst:285
msgid "Preinitialize Python from *preconfig* preconfiguration."
msgstr ""
#: ../Doc/c-api/init_config.rst:289
msgid ""
"Preinitialize Python from *preconfig* preconfiguration and command line "
"arguments (bytes strings)."
msgstr ""
#: ../Doc/c-api/init_config.rst:294
msgid ""
"Preinitialize Python from *preconfig* preconfiguration and command line "
"arguments (wide strings)."
msgstr ""
#: ../Doc/c-api/init_config.rst:297 ../Doc/c-api/init_config.rst:715
msgid ""
"The caller is responsible to handle exceptions (error or exit) using :c:func:"
"`PyStatus_Exception` and :c:func:`Py_ExitStatusException`."
msgstr ""
#: ../Doc/c-api/init_config.rst:300
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 "
"UTF-8 Mode."
msgstr ""
#: ../Doc/c-api/init_config.rst:307
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 ""
#: ../Doc/c-api/init_config.rst:312
msgid ""
"Python memory allocation functions like :c:func:`PyMem_RawMalloc` must not "
"be used before Python preinitialization, whereas calling directly "
"``malloc()`` and ``free()`` is always safe. :c:func:`Py_DecodeLocale` must "
"not be called before the preinitialization."
msgstr ""
#: ../Doc/c-api/init_config.rst:317
msgid "Example using the preinitialization to enable the UTF-8 Mode::"
msgstr ""
#: ../Doc/c-api/init_config.rst:338
msgid "PyConfig"
msgstr ""
#: ../Doc/c-api/init_config.rst:342
msgid "Structure containing most parameters to configure Python."
msgstr ""
#: ../Doc/c-api/init_config.rst:344
msgid "Structure methods:"
msgstr ""
#: ../Doc/c-api/init_config.rst:348
msgid ""
"Initialize configuration with :ref:`Python Configuration <init-python-"
"config>`."
msgstr ""
#: ../Doc/c-api/init_config.rst:353
msgid ""
"Initialize configuration with :ref:`Isolated Configuration <init-isolated-"
"conf>`."
msgstr ""
#: ../Doc/c-api/init_config.rst:358
msgid "Copy the wide character string *str* into ``*config_str``."
msgstr ""
#: ../Doc/c-api/init_config.rst:360 ../Doc/c-api/init_config.rst:366
#: ../Doc/c-api/init_config.rst:372 ../Doc/c-api/init_config.rst:378
#: ../Doc/c-api/init_config.rst:384 ../Doc/c-api/init_config.rst:392
msgid "Preinitialize Python if needed."
msgstr ""
#: ../Doc/c-api/init_config.rst:364
msgid ""
"Decode *str* using ``Py_DecodeLocale()`` and set the result into "
"``*config_str``."
msgstr ""
#: ../Doc/c-api/init_config.rst:370
msgid "Set command line arguments from wide character strings."
msgstr ""
#: ../Doc/c-api/init_config.rst:376
msgid ""
"Set command line arguments: decode bytes using :c:func:`Py_DecodeLocale`."
msgstr ""
#: ../Doc/c-api/init_config.rst:382
msgid "Set the list of wide strings *list* to *length* and *items*."
msgstr ""
#: ../Doc/c-api/init_config.rst:388
msgid "Read all Python configuration."
msgstr ""
#: ../Doc/c-api/init_config.rst:390
msgid "Fields which are already initialized are left unchanged."
msgstr ""
#: ../Doc/c-api/init_config.rst:396
msgid "Release configuration memory."
msgstr ""
#: ../Doc/c-api/init_config.rst:398
msgid ""
"Most ``PyConfig`` methods preinitialize Python if needed. In that case, the "
"Python preinitialization configuration 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 ""
#: ../Doc/c-api/init_config.rst:403
msgid ":c:member:`~PyConfig.dev_mode`"
msgstr ""
#: ../Doc/c-api/init_config.rst:404
msgid ":c:member:`~PyConfig.isolated`"
msgstr ""
#: ../Doc/c-api/init_config.rst:405
msgid ":c:member:`~PyConfig.parse_argv`"
msgstr ""
#: ../Doc/c-api/init_config.rst:406
msgid ":c:member:`~PyConfig.use_environment`"
msgstr ""
#: ../Doc/c-api/init_config.rst:408
msgid ""
"Moreover, if :c:func:`PyConfig_SetArgv` or :c:func:`PyConfig_SetBytesArgv` "
"is used, this method must be called first, before other methods, since the "
"preinitialization configuration depends on command line arguments (if :c:"
"member:`parse_argv` is non-zero)."
msgstr ""
#: ../Doc/c-api/init_config.rst:413
msgid ""
"The caller of these methods is responsible to handle exceptions (error or "
"exit) using ``PyStatus_Exception()`` and ``Py_ExitStatusException()``."
msgstr ""
#: ../Doc/c-api/init_config.rst:420
msgid ""
"Command line arguments, :data:`sys.argv`. See :c:member:`~PyConfig."
"parse_argv` to parse :c:member:`~PyConfig.argv` the same way the regular "
"Python parses Python command line arguments. 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 ""
#: ../Doc/c-api/init_config.rst:428
msgid ":data:`sys.base_exec_prefix`."
msgstr ""
#: ../Doc/c-api/init_config.rst:432
msgid ""
":data:`sys._base_executable`: ``__PYVENV_LAUNCHER__`` environment variable "
"value, or copy of :c:member:`PyConfig.executable`."
msgstr ""
#: ../Doc/c-api/init_config.rst:437
msgid ":data:`sys.base_prefix`."
msgstr ""
#: ../Doc/c-api/init_config.rst:441
msgid ""
"If equals to 0, enable unbuffered mode, making the stdout and stderr streams "
"unbuffered."
msgstr ""
#: ../Doc/c-api/init_config.rst:444
msgid "stdin is always opened in buffered mode."
msgstr ""
#: ../Doc/c-api/init_config.rst:448
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`. If equal or greater to 2, raise a :exc:`BytesWarning` exception."
msgstr ""
#: ../Doc/c-api/init_config.rst:455
msgid ""
"Control the validation behavior of hash-based ``.pyc`` files (see :pep:"
"`552`): :option:`--check-hash-based-pycs` command line option value."
msgstr ""
#: ../Doc/c-api/init_config.rst:458
msgid "Valid values: ``always``, ``never`` and ``default``."
msgstr ""
#: ../Doc/c-api/init_config.rst:460
msgid "The default value is: ``default``."
msgstr ""
#: ../Doc/c-api/init_config.rst:464
msgid ""
"If non-zero, configure C standard streams (``stdio``, ``stdout``, "
"``stdout``). For example, set their mode to ``O_BINARY`` on Windows."
msgstr ""
#: ../Doc/c-api/init_config.rst:469
msgid "Development mode: see :option:`-X dev <-X>`."
msgstr ""
#: ../Doc/c-api/init_config.rst:473
msgid "If non-zero, dump all objects which are still alive at exit."
msgstr ""
#: ../Doc/c-api/init_config.rst:475
msgid ""
"Require a debug build of Python (``Py_REF_DEBUG`` macro must be defined)."
msgstr ""
#: ../Doc/c-api/init_config.rst:479
msgid ":data:`sys.exec_prefix`."
msgstr ""
#: ../Doc/c-api/init_config.rst:483
msgid ":data:`sys.executable`."
msgstr ""
#: ../Doc/c-api/init_config.rst:487
msgid "If non-zero, call :func:`faulthandler.enable` at startup."
msgstr ""
#: ../Doc/c-api/init_config.rst:491
msgid "Filesystem encoding, :func:`sys.getfilesystemencoding`."
msgstr ""
#: ../Doc/c-api/init_config.rst:495
msgid "Filesystem encoding errors, :func:`sys.getfilesystemencodeerrors`."
msgstr ""
#: ../Doc/c-api/init_config.rst:500
msgid "Randomized hash function seed."
msgstr ""
#: ../Doc/c-api/init_config.rst:502
msgid ""
"If :c:member:`~PyConfig.use_hash_seed` is zero, a seed is chosen randomly at "
"Pythonstartup, and :c:member:`~PyConfig.hash_seed` is ignored."
msgstr ""
#: ../Doc/c-api/init_config.rst:507
msgid "Python home directory."
msgstr ""
#: ../Doc/c-api/init_config.rst:509
msgid ""
"Initialized from :envvar:`PYTHONHOME` environment variable value by default."
msgstr ""
#: ../Doc/c-api/init_config.rst:514
msgid "If non-zero, profile import time."
msgstr ""
#: ../Doc/c-api/init_config.rst:518
msgid "Enter interactive mode after executing a script or a command."
msgstr ""
#: ../Doc/c-api/init_config.rst:522
msgid "Install signal handlers?"
msgstr ""
#: ../Doc/c-api/init_config.rst:526
msgid "Interactive mode."
msgstr ""
#: ../Doc/c-api/init_config.rst:530
msgid "If greater than 0, enable isolated mode:"
msgstr ""
#: ../Doc/c-api/init_config.rst:532
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 ""
#: ../Doc/c-api/init_config.rst:535
msgid ""
"Python REPL doesn't import :mod:`readline` nor enable default readline "
"configuration on interactive prompts."
msgstr ""
#: ../Doc/c-api/init_config.rst:537
msgid ""
"Set :c:member:`~PyConfig.use_environment` and :c:member:`~PyConfig."
"user_site_directory` to 0."
msgstr ""
#: ../Doc/c-api/init_config.rst:542
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 ""
#: ../Doc/c-api/init_config.rst:551
msgid ""
"If non-zero, dump statistics on :ref:`Python pymalloc memory allocator "
"<pymalloc>` at exit."
msgstr ""
#: ../Doc/c-api/init_config.rst:554
msgid "The option is ignored if Python is built using ``--without-pymalloc``."
msgstr ""
#: ../Doc/c-api/init_config.rst:558
msgid ""
"Module search paths as a string separated by ``DELIM`` (:data:`os.path."
"pathsep`)."
msgstr ""
#: ../Doc/c-api/init_config.rst:561
msgid ""
"Initialized from :envvar:`PYTHONPATH` environment variable value by default."
msgstr ""
#: ../Doc/c-api/init_config.rst:567
msgid ""
":data:`sys.path`. If :c:member:`~PyConfig.module_search_paths_set` is equal "
"to 0, the :c:member:`~PyConfig.module_search_paths` is overridden by the "
"function calculating the :ref:`Path Configuration <init-path-config>`."
msgstr ""
#: ../Doc/c-api/init_config.rst:574
msgid "Compilation optimization level:"
msgstr ""
#: ../Doc/c-api/init_config.rst:576
msgid "0: Peephole optimizer (and ``__debug__`` is set to ``True``)"
msgstr ""
#: ../Doc/c-api/init_config.rst:577
msgid "1: Remove assertions, set ``__debug__`` to ``False``"
msgstr ""
#: ../Doc/c-api/init_config.rst:578
msgid "2: Strip docstrings"
msgstr ""
#: ../Doc/c-api/init_config.rst:582
msgid ""
"If non-zero, parse :c:member:`~PyConfig.argv` the same way the regular "
"Python command line arguments, and strip Python arguments from :c:member:"
"`~PyConfig.argv`: see :ref:`Command Line Arguments <using-on-cmdline>`."
msgstr ""
#: ../Doc/c-api/init_config.rst:589
msgid ""
"If non-zero, turn on parser debugging output (for expert only, depending on "
"compilation options)."
msgstr ""
#: ../Doc/c-api/init_config.rst:594
msgid ""
"If equal to 0, suppress warnings when calculating the :ref:`Path "
"Configuration <init-path-config>` (Unix only, Windows does not log any "
"warning). Otherwise, warnings are written into ``stderr``."
msgstr ""
#: ../Doc/c-api/init_config.rst:600
msgid ":data:`sys.prefix`."
msgstr ""
#: ../Doc/c-api/init_config.rst:604
msgid ""
"Program name. Used to initialize :c:member:`~PyConfig.executable`, and in "
"early error messages."
msgstr ""
#: ../Doc/c-api/init_config.rst:609
msgid ":data:`sys.pycache_prefix`: ``.pyc`` cache prefix."
msgstr ""
#: ../Doc/c-api/init_config.rst:611
msgid "If ``NULL``, :data:`sys.pycache_prefix` is set to ``None``."
msgstr ""
#: ../Doc/c-api/init_config.rst:615
msgid ""
"Quiet mode. For example, don't display the copyright and version messages in "
"interactive mode."
msgstr ""
#: ../Doc/c-api/init_config.rst:620
msgid "``python3 -c COMMAND`` argument. Used by :c:func:`Py_RunMain`."
msgstr ""
#: ../Doc/c-api/init_config.rst:624
msgid "``python3 FILENAME`` argument. Used by :c:func:`Py_RunMain`."
msgstr ""
#: ../Doc/c-api/init_config.rst:628
msgid "``python3 -m MODULE`` argument. Used by :c:func:`Py_RunMain`."
msgstr ""
#: ../Doc/c-api/init_config.rst:632
msgid "Show allocation counts at exit?"
msgstr ""
#: ../Doc/c-api/init_config.rst:634
msgid "Set to 1 by :option:`-X showalloccount <-X>` command line option."
msgstr ""
#: ../Doc/c-api/init_config.rst:636
msgid "Need a special Python build with ``COUNT_ALLOCS`` macro defined."
msgstr ""
#: ../Doc/c-api/init_config.rst:640
msgid "Show total reference count at exit?"
msgstr ""
#: ../Doc/c-api/init_config.rst:642
msgid "Set to 1 by :option:`-X showrefcount <-X>` command line option."
msgstr ""
#: ../Doc/c-api/init_config.rst:644
msgid "Need a debug build of Python (``Py_REF_DEBUG`` macro must be defined)."
msgstr ""
#: ../Doc/c-api/init_config.rst:648
msgid "Import the :mod:`site` module at startup?"
msgstr ""
#: ../Doc/c-api/init_config.rst:652
msgid "Skip the first line of the source?"
msgstr ""
#: ../Doc/c-api/init_config.rst:657
msgid ""
"Encoding and encoding errors of :data:`sys.stdin`, :data:`sys.stdout` and :"
"data:`sys.stderr`."
msgstr ""
#: ../Doc/c-api/init_config.rst:662
msgid "If non-zero, call :func:`tracemalloc.start` at startup."
msgstr ""
#: ../Doc/c-api/init_config.rst:666
msgid "If greater than 0, use :ref:`environment variables <using-on-envvars>`."
msgstr ""
#: ../Doc/c-api/init_config.rst:670
msgid "If non-zero, add user site directory to :data:`sys.path`."
msgstr ""
#: ../Doc/c-api/init_config.rst:674
msgid "If non-zero, enable verbose mode."
msgstr ""
#: ../Doc/c-api/init_config.rst:678
msgid ""
":data:`sys.warnoptions`: options of the :mod:`warnings` module to build "
"warnings filters: lowest to highest priority."
msgstr ""
#: ../Doc/c-api/init_config.rst:681
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 ""
#: ../Doc/c-api/init_config.rst:688
msgid "If non-zero, write ``.pyc`` files."
msgstr ""
#: ../Doc/c-api/init_config.rst:690
msgid ""
":data:`sys.dont_write_bytecode` is initialized to the inverted value of :c:"
"member:`~PyConfig.write_bytecode`."
msgstr ""
#: ../Doc/c-api/init_config.rst:695
msgid ":data:`sys._xoptions`."
msgstr ""
#: ../Doc/c-api/init_config.rst:697
msgid ""
"If ``parse_argv`` is non-zero, ``argv`` arguments are parsed the same way "
"the regular Python parses command line arguments, and Python arguments are "
"stripped from ``argv``: see :ref:`Command Line Arguments <using-on-cmdline>`."
msgstr ""
#: ../Doc/c-api/init_config.rst:702
msgid ""
"The ``xoptions`` options are parsed to set other options: see :option:`-X` "
"option."
msgstr ""
#: ../Doc/c-api/init_config.rst:707
msgid "Initialization with PyConfig"
msgstr ""
#: ../Doc/c-api/init_config.rst:709
msgid "Function to initialize Python:"
msgstr ""
#: ../Doc/c-api/init_config.rst:713
msgid "Initialize Python from *config* configuration."
msgstr ""
#: ../Doc/c-api/init_config.rst:718
msgid ""
"If ``PyImport_FrozenModules``, ``PyImport_AppendInittab()`` or "
"``PyImport_ExtendInittab()`` are used, they must be set or called after "
"Python preinitialization and before the Python initialization."
msgstr ""
#: ../Doc/c-api/init_config.rst:722
msgid "Example setting the program name::"
msgstr ""
#: ../Doc/c-api/init_config.rst:750
msgid ""
"More complete example modifying the default configuration, read the "
"configuration, and then override some parameters::"
msgstr ""
#: ../Doc/c-api/init_config.rst:801
msgid "Isolated Configuration"
msgstr ""
#: ../Doc/c-api/init_config.rst:803
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 ""
#: ../Doc/c-api/init_config.rst:808
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 ""
#: ../Doc/c-api/init_config.rst:813
msgid ""
"Configuration files are still used with this configuration. Set the :ref:"
"`Path Configuration <init-path-config>` (\"output fields\") to ignore these "
"configuration files and avoid the function computing the default path "
"configuration."
msgstr ""
#: ../Doc/c-api/init_config.rst:822
msgid "Python Configuration"
msgstr ""
#: ../Doc/c-api/init_config.rst:824
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 ""
#: ../Doc/c-api/init_config.rst:828
msgid ""
"Environments variables and command line arguments are used to configure "
"Python, whereas global configuration variables are ignored."
msgstr ""
#: ../Doc/c-api/init_config.rst:831
msgid ""
"This function enables C locale coercion (:pep:`538`) and UTF-8 Mode (:pep:"
"`540`) depending on the LC_CTYPE locale, :envvar:`PYTHONUTF8` and :envvar:"
"`PYTHONCOERCECLOCALE` environment variables."
msgstr ""
#: ../Doc/c-api/init_config.rst:835
msgid "Example of customized Python always running in isolated mode::"
msgstr ""
#: ../Doc/c-api/init_config.rst:874
msgid "Path Configuration"
msgstr ""
#: ../Doc/c-api/init_config.rst:876
msgid ":c:type:`PyConfig` contains multiple fields for the path configuration:"
msgstr ""
#: ../Doc/c-api/init_config.rst:878
msgid "Path configuration inputs:"
msgstr ""
#: ../Doc/c-api/init_config.rst:880
msgid ":c:member:`PyConfig.home`"
msgstr ""
#: ../Doc/c-api/init_config.rst:881
msgid ":c:member:`PyConfig.pathconfig_warnings`"
msgstr ""
#: ../Doc/c-api/init_config.rst:882
msgid ":c:member:`PyConfig.program_name`"
msgstr ""
#: ../Doc/c-api/init_config.rst:883
msgid ":c:member:`PyConfig.pythonpath_env`"
msgstr ""
#: ../Doc/c-api/init_config.rst:884
msgid "current working directory: to get absolute paths"
msgstr ""
#: ../Doc/c-api/init_config.rst:885
msgid ""
"``PATH`` environment variable to get the program full path (from :c:member:"
"`PyConfig.program_name`)"
msgstr ""
#: ../Doc/c-api/init_config.rst:887
msgid "``__PYVENV_LAUNCHER__`` environment variable"
msgstr ""
#: ../Doc/c-api/init_config.rst:888
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 ""
#: ../Doc/c-api/init_config.rst:892
msgid "Path configuration output fields:"
msgstr ""
#: ../Doc/c-api/init_config.rst:894
msgid ":c:member:`PyConfig.base_exec_prefix`"
msgstr ""
#: ../Doc/c-api/init_config.rst:895
msgid ":c:member:`PyConfig.base_executable`"
msgstr ""
#: ../Doc/c-api/init_config.rst:896
msgid ":c:member:`PyConfig.base_prefix`"
msgstr ""
#: ../Doc/c-api/init_config.rst:897
msgid ":c:member:`PyConfig.exec_prefix`"
msgstr ""
#: ../Doc/c-api/init_config.rst:898
msgid ":c:member:`PyConfig.executable`"
msgstr ""
#: ../Doc/c-api/init_config.rst:899
msgid ""
":c:member:`PyConfig.module_search_paths_set`, :c:member:`PyConfig."
"module_search_paths`"
msgstr ""
#: ../Doc/c-api/init_config.rst:901
msgid ":c:member:`PyConfig.prefix`"
msgstr ""
#: ../Doc/c-api/init_config.rst:903
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 ""
#: ../Doc/c-api/init_config.rst:909
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 ""
#: ../Doc/c-api/init_config.rst:916
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 ""
#: ../Doc/c-api/init_config.rst:919
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 ""
#: ../Doc/c-api/init_config.rst:923
msgid ":c:func:`Py_RunMain` and :c:func:`Py_Main` modify :data:`sys.path`:"
msgstr ""
#: ../Doc/c-api/init_config.rst:925
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 ""
#: ../Doc/c-api/init_config.rst:928
msgid "If :c:member:`~PyConfig.isolated` is zero:"
msgstr ""
#: ../Doc/c-api/init_config.rst:930
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 ""
#: ../Doc/c-api/init_config.rst:932
msgid ""
"If :c:member:`~PyConfig.run_filename` is set, prepend the directory of the "
"filename to :data:`sys.path`."
msgstr ""
#: ../Doc/c-api/init_config.rst:934
msgid "Otherwise, prepend an empty string to :data:`sys.path`."
msgstr ""
#: ../Doc/c-api/init_config.rst:936
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 ""
#: ../Doc/c-api/init_config.rst:942
msgid "The following configuration files are used by the path configuration:"
msgstr ""
#: ../Doc/c-api/init_config.rst:944
msgid "``pyvenv.cfg``"
msgstr ""
#: ../Doc/c-api/init_config.rst:945
msgid "``python._pth`` (Windows only)"
msgstr ""
#: ../Doc/c-api/init_config.rst:946
msgid "``pybuilddir.txt`` (Unix only)"
msgstr ""
#: ../Doc/c-api/init_config.rst:948
msgid ""
"The ``__PYVENV_LAUNCHER__`` environment variable is used to set :c:member:"
"`PyConfig.base_executable`"
msgstr ""
#: ../Doc/c-api/init_config.rst:953
msgid "Py_RunMain()"
msgstr ""
#: ../Doc/c-api/init_config.rst:957
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 ""
#: ../Doc/c-api/init_config.rst:962
msgid "By default and when if :option:`-i` option is used, run the REPL."
msgstr ""
#: ../Doc/c-api/init_config.rst:964
msgid ""
"Finally, finalizes Python and returns an exit status that can be passed to "
"the ``exit()`` function."
msgstr ""
#: ../Doc/c-api/init_config.rst:967
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 ""
#: ../Doc/c-api/init_config.rst:973
msgid "Multi-Phase Initialization Private Provisional API"
msgstr ""
#: ../Doc/c-api/init_config.rst:975
msgid ""
"This section is a private provisional API introducing multi-phase "
"initialization, the core feature of the :pep:`432`:"
msgstr ""
#: ../Doc/c-api/init_config.rst:978
msgid "\"Core\" initialization phase, \"bare minimum Python\":"
msgstr ""
#: ../Doc/c-api/init_config.rst:980
msgid "Builtin types;"
msgstr ""
#: ../Doc/c-api/init_config.rst:981
msgid "Builtin exceptions;"
msgstr ""
#: ../Doc/c-api/init_config.rst:982
msgid "Builtin and frozen modules;"
msgstr ""
#: ../Doc/c-api/init_config.rst:983
msgid ""
"The :mod:`sys` module is only partially initialized (ex: :data:`sys.path` "
"doesn't exist yet)."
msgstr ""
#: ../Doc/c-api/init_config.rst:986
msgid "\"Main\" initialization phase, Python is fully initialized:"
msgstr ""
#: ../Doc/c-api/init_config.rst:988
msgid "Install and configure :mod:`importlib`;"
msgstr ""
#: ../Doc/c-api/init_config.rst:989
msgid "Apply the :ref:`Path Configuration <init-path-config>`;"
msgstr ""
#: ../Doc/c-api/init_config.rst:990
msgid "Install signal handlers;"
msgstr ""
#: ../Doc/c-api/init_config.rst:991
msgid ""
"Finish :mod:`sys` module initialization (ex: create :data:`sys.stdout` and :"
"data:`sys.path`);"
msgstr ""
#: ../Doc/c-api/init_config.rst:993
msgid ""
"Enable optional features like :mod:`faulthandler` and :mod:`tracemalloc`;"
msgstr ""
#: ../Doc/c-api/init_config.rst:994
msgid "Import the :mod:`site` module;"
msgstr ""
#: ../Doc/c-api/init_config.rst:995
msgid "etc."
msgstr ""
#: ../Doc/c-api/init_config.rst:997
msgid "Private provisional API:"
msgstr ""
#: ../Doc/c-api/init_config.rst:999
msgid ""
":c:member:`PyConfig._init_main`: if set to 0, :c:func:"
"`Py_InitializeFromConfig` stops at the \"Core\" initialization phase."
msgstr ""
#: ../Doc/c-api/init_config.rst:1004
msgid ""
"Move to the \"Main\" initialization phase, finish the Python initialization."
msgstr ""
#: ../Doc/c-api/init_config.rst:1006
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 ""
#: ../Doc/c-api/init_config.rst:1012
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 ""
#: ../Doc/c-api/init_config.rst:1016
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 ""
#: ../Doc/c-api/init_config.rst:1021
msgid ""
"Example running Python code between \"Core\" and \"Main\" initialization "
"phases::"
msgstr ""