pilou/python-docs-fr
1
0
Fork 0
forked from AFPy/python-docs-fr
Code Pull Requests Activity
3.9
python-docs-fr/c-api/init_config.po
Julien Palard d0254540c9
Make merge
2023-03-22 22:18:21 +01:00

1385 lines
36 KiB
Plaintext
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Copyright (C) 2001-2018, Python Software Foundation
# For licence information, see README file.
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-22 22:16+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 "Structures:"
msgstr ""
#: c-api/init_config.rst:13
msgid ":c:type:`PyConfig`"
msgstr ""
#: c-api/init_config.rst:14
msgid ":c:type:`PyPreConfig`"
msgstr ""
#: c-api/init_config.rst:15
msgid ":c:type:`PyStatus`"
msgstr ""
#: c-api/init_config.rst:16
msgid ":c:type:`PyWideStringList`"
msgstr ""
#: c-api/init_config.rst:18
#, fuzzy
msgid "Functions:"
msgstr "Fonctions"
#: c-api/init_config.rst:20
msgid ":c:func:`PyConfig_Clear`"
msgstr ""
#: c-api/init_config.rst:21
msgid ":c:func:`PyConfig_InitIsolatedConfig`"
msgstr ""
#: c-api/init_config.rst:22
msgid ":c:func:`PyConfig_InitPythonConfig`"
msgstr ""
#: c-api/init_config.rst:23
msgid ":c:func:`PyConfig_Read`"
msgstr ""
#: c-api/init_config.rst:24
msgid ":c:func:`PyConfig_SetArgv`"
msgstr ""
#: c-api/init_config.rst:25
msgid ":c:func:`PyConfig_SetBytesArgv`"
msgstr ""
#: c-api/init_config.rst:26
msgid ":c:func:`PyConfig_SetBytesString`"
msgstr ""
#: c-api/init_config.rst:27
msgid ":c:func:`PyConfig_SetString`"
msgstr ""
#: c-api/init_config.rst:28
msgid ":c:func:`PyConfig_SetWideStringList`"
msgstr ""
#: c-api/init_config.rst:29
msgid ":c:func:`PyPreConfig_InitIsolatedConfig`"
msgstr ""
#: c-api/init_config.rst:30
msgid ":c:func:`PyPreConfig_InitPythonConfig`"
msgstr ""
#: c-api/init_config.rst:31
msgid ":c:func:`PyStatus_Error`"
msgstr ""
#: c-api/init_config.rst:32
msgid ":c:func:`PyStatus_Exception`"
msgstr ""
#: c-api/init_config.rst:33
msgid ":c:func:`PyStatus_Exit`"
msgstr ""
#: c-api/init_config.rst:34
msgid ":c:func:`PyStatus_IsError`"
msgstr ""
#: c-api/init_config.rst:35
msgid ":c:func:`PyStatus_IsExit`"
msgstr ""
#: c-api/init_config.rst:36
msgid ":c:func:`PyStatus_NoMemory`"
msgstr ""
#: c-api/init_config.rst:37
msgid ":c:func:`PyStatus_Ok`"
msgstr ""
#: c-api/init_config.rst:38
msgid ":c:func:`PyWideStringList_Append`"
msgstr ""
#: c-api/init_config.rst:39
msgid ":c:func:`PyWideStringList_Insert`"
msgstr ""
#: c-api/init_config.rst:40
msgid ":c:func:`Py_ExitStatusException`"
msgstr ""
#: c-api/init_config.rst:41
msgid ":c:func:`Py_InitializeFromConfig`"
msgstr ""
#: c-api/init_config.rst:42
msgid ":c:func:`Py_PreInitialize`"
msgstr ""
#: c-api/init_config.rst:43
msgid ":c:func:`Py_PreInitializeFromArgs`"
msgstr ""
#: c-api/init_config.rst:44
msgid ":c:func:`Py_PreInitializeFromBytesArgs`"
msgstr ""
#: c-api/init_config.rst:45
msgid ":c:func:`Py_RunMain`"
msgstr ""
#: c-api/init_config.rst:46
msgid ":c:func:`Py_GetArgcArgv`"
msgstr ""
#: c-api/init_config.rst:48
msgid ""
"The preconfiguration (``PyPreConfig`` type) is stored in ``_PyRuntime."
"preconfig`` and the configuration (``PyConfig`` type) is stored in "
"``PyInterpreterState.config``."
msgstr ""
#: c-api/init_config.rst:52
msgid ""
"See also :ref:`Initialization, Finalization, and Threads <initialization>`."
msgstr ""
#: c-api/init_config.rst:55
msgid ":pep:`587` \"Python Initialization Configuration\"."
msgstr ""
#: c-api/init_config.rst:59
msgid "PyWideStringList"
msgstr ""
#: c-api/init_config.rst:63
msgid "List of ``wchar_t*`` strings."
msgstr ""
#: c-api/init_config.rst:65
msgid ""
"If *length* is non-zero, *items* must be non-``NULL`` and all strings must "
"be non-``NULL``."
msgstr ""
#: c-api/init_config.rst:68
#, fuzzy
msgid "Methods:"
msgstr "Méthodes"
#: c-api/init_config.rst:72
msgid "Append *item* to *list*."
msgstr ""
#: c-api/init_config.rst:85
msgid "Python must be preinitialized to call this function."
msgstr ""
#: c-api/init_config.rst:78
msgid "Insert *item* into *list* at *index*."
msgstr ""
#: c-api/init_config.rst:80
msgid ""
"If *index* is greater than or equal to *list* length, append *item* to "
"*list*."
msgstr ""
#: c-api/init_config.rst:83
msgid "*index* must be greater than or equal to 0."
msgstr ""
#: c-api/init_config.rst:107 c-api/init_config.rst:417
msgid "Structure fields:"
msgstr ""
#: c-api/init_config.rst:91
msgid "List length."
msgstr ""
#: c-api/init_config.rst:95
msgid "List items."
msgstr ""
#: c-api/init_config.rst:98
msgid "PyStatus"
msgstr ""
#: c-api/init_config.rst:102
msgid ""
"Structure to store an initialization function status: success, error or exit."
msgstr ""
#: c-api/init_config.rst:105
msgid "For an error, it can store the C function name which created the error."
msgstr ""
#: c-api/init_config.rst:111
msgid "Exit code. Argument passed to ``exit()``."
msgstr ""
#: c-api/init_config.rst:115
msgid "Error message."
msgstr ""
#: c-api/init_config.rst:119
msgid "Name of the function which created an error, can be ``NULL``."
msgstr ""
#: c-api/init_config.rst:121
msgid "Functions to create a status:"
msgstr ""
#: c-api/init_config.rst:125
msgid "Success."
msgstr ""
#: c-api/init_config.rst:129
msgid "Initialization error with a message."
msgstr ""
#: c-api/init_config.rst:133
msgid "Memory allocation failure (out of memory)."
msgstr ""
#: c-api/init_config.rst:137
msgid "Exit Python with the specified exit code."
msgstr ""
#: c-api/init_config.rst:139
msgid "Functions to handle a status:"
msgstr ""
#: c-api/init_config.rst:143
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:148
msgid "Is the result an error?"
msgstr ""
#: c-api/init_config.rst:152
msgid "Is the result an exit?"
msgstr ""
#: c-api/init_config.rst:156
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:161
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:164
msgid "Example::"
msgstr "Exemple ::"
#: c-api/init_config.rst:188
msgid "PyPreConfig"
msgstr ""
#: c-api/init_config.rst:192
msgid "Structure used to preinitialize Python:"
msgstr ""
#: c-api/init_config.rst:194
msgid "Set the Python memory allocator"
msgstr ""
#: c-api/init_config.rst:195
msgid "Configure the LC_CTYPE locale"
msgstr ""
#: c-api/init_config.rst:196
msgid "Set the UTF-8 mode"
msgstr ""
#: c-api/init_config.rst:198
msgid "Function to initialize a preconfiguration:"
msgstr ""
#: c-api/init_config.rst:202
msgid ""
"Initialize the preconfiguration with :ref:`Python Configuration <init-python-"
"config>`."
msgstr ""
#: c-api/init_config.rst:207
msgid ""
"Initialize the preconfiguration with :ref:`Isolated Configuration <init-"
"isolated-conf>`."
msgstr ""
#: c-api/init_config.rst:214
msgid "Name of the memory allocator:"
msgstr ""
#: c-api/init_config.rst:216
msgid ""
"``PYMEM_ALLOCATOR_NOT_SET`` (``0``): don't change memory allocators (use "
"defaults)"
msgstr ""
#: c-api/init_config.rst:218
msgid "``PYMEM_ALLOCATOR_DEFAULT`` (``1``): default memory allocators"
msgstr ""
#: c-api/init_config.rst:219
msgid ""
"``PYMEM_ALLOCATOR_DEBUG`` (``2``): default memory allocators with debug hooks"
msgstr ""
#: c-api/init_config.rst:221
msgid "``PYMEM_ALLOCATOR_MALLOC`` (``3``): force usage of ``malloc()``"
msgstr ""
#: c-api/init_config.rst:222
msgid ""
"``PYMEM_ALLOCATOR_MALLOC_DEBUG`` (``4``): force usage of ``malloc()`` with "
"debug hooks"
msgstr ""
#: c-api/init_config.rst:224
msgid ""
"``PYMEM_ALLOCATOR_PYMALLOC`` (``5``): :ref:`Python pymalloc memory allocator "
"<pymalloc>`"
msgstr ""
#: c-api/init_config.rst:226
msgid ""
"``PYMEM_ALLOCATOR_PYMALLOC_DEBUG`` (``6``): :ref:`Python pymalloc memory "
"allocator <pymalloc>` with debug hooks"
msgstr ""
#: c-api/init_config.rst:229
msgid ""
"``PYMEM_ALLOCATOR_PYMALLOC`` and ``PYMEM_ALLOCATOR_PYMALLOC_DEBUG`` are not "
"supported if Python is configured using ``--without-pymalloc``"
msgstr ""
#: c-api/init_config.rst:232
msgid "See :ref:`Memory Management <memory>`."
msgstr ""
#: c-api/init_config.rst:236
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 ""
#: c-api/init_config.rst:241
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 ""
#: c-api/init_config.rst:246
msgid "If non-zero, emit a warning if the C locale is coerced."
msgstr ""
#: c-api/init_config.rst:250
msgid "See :c:member:`PyConfig.dev_mode`."
msgstr ""
#: c-api/init_config.rst:254
msgid "See :c:member:`PyConfig.isolated`."
msgstr ""
#: c-api/init_config.rst:258
msgid ""
"If non-zero, disable UTF-8 Mode, set the Python filesystem encoding to "
"``mbcs``, set the filesystem error handler to ``replace``."
msgstr ""
#: c-api/init_config.rst:555
msgid ""
"Only available on Windows. ``#ifdef MS_WINDOWS`` macro can be used for "
"Windows specific code."
msgstr ""
#: c-api/init_config.rst:266
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:273
msgid "See :c:member:`PyConfig.use_environment`."
msgstr ""
#: c-api/init_config.rst:277
msgid "If non-zero, enable the UTF-8 mode."
msgstr ""
#: c-api/init_config.rst:280
msgid "Preinitialization with PyPreConfig"
msgstr ""
#: c-api/init_config.rst:282
msgid "Functions to preinitialize Python:"
msgstr ""
#: c-api/init_config.rst:286
msgid "Preinitialize Python from *preconfig* preconfiguration."
msgstr ""
#: c-api/init_config.rst:290
msgid ""
"Preinitialize Python from *preconfig* preconfiguration and command line "
"arguments (bytes strings)."
msgstr ""
#: c-api/init_config.rst:295
msgid ""
"Preinitialize Python from *preconfig* preconfiguration and command line "
"arguments (wide strings)."
msgstr ""
#: c-api/init_config.rst:730
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:301
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 ""
#: c-api/init_config.rst:308
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:313
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 ""
#: c-api/init_config.rst:318
msgid "Example using the preinitialization to enable the UTF-8 Mode::"
msgstr ""
#: c-api/init_config.rst:339
msgid "PyConfig"
msgstr ""
#: c-api/init_config.rst:343
msgid "Structure containing most parameters to configure Python."
msgstr ""
#: c-api/init_config.rst:345
msgid "Structure methods:"
msgstr ""
#: c-api/init_config.rst:349
msgid ""
"Initialize configuration with :ref:`Python Configuration <init-python-"
"config>`."
msgstr ""
#: c-api/init_config.rst:354
msgid ""
"Initialize configuration with :ref:`Isolated Configuration <init-isolated-"
"conf>`."
msgstr ""
#: c-api/init_config.rst:359
msgid "Copy the wide character string *str* into ``*config_str``."
msgstr ""
#: c-api/init_config.rst:367 c-api/init_config.rst:379
#: c-api/init_config.rst:393
msgid "Preinitialize Python if needed."
msgstr ""
#: c-api/init_config.rst:365
msgid ""
"Decode *str* using ``Py_DecodeLocale()`` and set the result into "
"``*config_str``."
msgstr ""
#: c-api/init_config.rst:371
msgid "Set command line arguments from wide character strings."
msgstr ""
#: c-api/init_config.rst:377
msgid ""
"Set command line arguments: decode bytes using :c:func:`Py_DecodeLocale`."
msgstr ""
#: c-api/init_config.rst:383
msgid "Set the list of wide strings *list* to *length* and *items*."
msgstr ""
#: c-api/init_config.rst:389
msgid "Read all Python configuration."
msgstr ""
#: c-api/init_config.rst:391
msgid "Fields which are already initialized are left unchanged."
msgstr ""
#: c-api/init_config.rst:397
msgid "Release configuration memory."
msgstr ""
#: c-api/init_config.rst:399
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 ""
#: c-api/init_config.rst:404
msgid ":c:member:`~PyConfig.dev_mode`"
msgstr ""
#: c-api/init_config.rst:405
msgid ":c:member:`~PyConfig.isolated`"
msgstr ""
#: c-api/init_config.rst:406
msgid ":c:member:`~PyConfig.parse_argv`"
msgstr ""
#: c-api/init_config.rst:407
msgid ":c:member:`~PyConfig.use_environment`"
msgstr ""
#: c-api/init_config.rst:409
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 ""
#: c-api/init_config.rst:414
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:421
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 ""
#: c-api/init_config.rst:429
msgid ":data:`sys.base_exec_prefix`."
msgstr ""
#: c-api/init_config.rst:433
msgid ""
":data:`sys._base_executable`: ``__PYVENV_LAUNCHER__`` environment variable "
"value, or copy of :c:member:`PyConfig.executable`."
msgstr ""
#: c-api/init_config.rst:438
msgid ":data:`sys.base_prefix`."
msgstr ""
#: c-api/init_config.rst:442
msgid ""
":data:`sys.platlibdir`: platform library directory name, set at configure "
"time by ``--with-platlibdir``, overrideable by the ``PYTHONPLATLIBDIR`` "
"environment variable."
msgstr ""
#: c-api/init_config.rst:450
msgid ""
"If equals to 0, enable unbuffered mode, making the stdout and stderr streams "
"unbuffered."
msgstr ""
#: c-api/init_config.rst:453
msgid "stdin is always opened in buffered mode."
msgstr ""
#: c-api/init_config.rst:457
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 ""
#: c-api/init_config.rst:464
msgid ""
"Control the validation behavior of hash-based ``.pyc`` files (see :pep:"
"`552`): :option:`--check-hash-based-pycs` command line option value."
msgstr ""
#: c-api/init_config.rst:467
msgid "Valid values: ``always``, ``never`` and ``default``."
msgstr ""
#: c-api/init_config.rst:469
msgid "The default value is: ``default``."
msgstr ""
#: c-api/init_config.rst:473
msgid ""
"If non-zero, configure C standard streams (``stdio``, ``stdout``, "
"``stdout``). For example, set their mode to ``O_BINARY`` on Windows."
msgstr ""
#: c-api/init_config.rst:478
msgid "If non-zero, enable the :ref:`Python Development Mode <devmode>`."
msgstr ""
#: c-api/init_config.rst:482
msgid "If non-zero, dump all objects which are still alive at exit."
msgstr ""
#: c-api/init_config.rst:484
msgid "``Py_TRACE_REFS`` macro must be defined in build."
msgstr ""
#: c-api/init_config.rst:488
msgid ":data:`sys.exec_prefix`."
msgstr ""
#: c-api/init_config.rst:492
msgid ":data:`sys.executable`."
msgstr ""
#: c-api/init_config.rst:496
msgid "If non-zero, call :func:`faulthandler.enable` at startup."
msgstr ""
#: c-api/init_config.rst:500
msgid "Filesystem encoding, :func:`sys.getfilesystemencoding`."
msgstr ""
#: c-api/init_config.rst:504
msgid "Filesystem encoding errors, :func:`sys.getfilesystemencodeerrors`."
msgstr ""
#: c-api/init_config.rst:509
msgid "Randomized hash function seed."
msgstr ""
#: c-api/init_config.rst:511
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 ""
#: c-api/init_config.rst:516
msgid "Python home directory."
msgstr ""
#: c-api/init_config.rst:518
msgid ""
"Initialized from :envvar:`PYTHONHOME` environment variable value by default."
msgstr ""
#: c-api/init_config.rst:523
msgid "If non-zero, profile import time."
msgstr ""
#: c-api/init_config.rst:527
msgid "Enter interactive mode after executing a script or a command."
msgstr ""
#: c-api/init_config.rst:531
msgid "Install signal handlers?"
msgstr ""
#: c-api/init_config.rst:535
#, fuzzy
msgid "Interactive mode."
msgstr "Mode interactif"
#: c-api/init_config.rst:539
msgid "If greater than 0, enable isolated mode:"
msgstr ""
#: c-api/init_config.rst:541
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:544
msgid ""
"Python REPL doesn't import :mod:`readline` nor enable default readline "
"configuration on interactive prompts."
msgstr ""
#: c-api/init_config.rst:546
msgid ""
"Set :c:member:`~PyConfig.use_environment` and :c:member:`~PyConfig."
"user_site_directory` to 0."
msgstr ""
#: c-api/init_config.rst:551
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:560
msgid ""
"If non-zero, dump statistics on :ref:`Python pymalloc memory allocator "
"<pymalloc>` at exit."
msgstr ""
#: c-api/init_config.rst:563
msgid "The option is ignored if Python is built using ``--without-pymalloc``."
msgstr ""
#: c-api/init_config.rst:567
msgid ""
"Module search paths as a string separated by ``DELIM`` (:data:`os.path."
"pathsep`)."
msgstr ""
#: c-api/init_config.rst:570
msgid ""
"Initialized from :envvar:`PYTHONPATH` environment variable value by default."
msgstr ""
#: c-api/init_config.rst:576
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 ""
#: c-api/init_config.rst:583
msgid "Compilation optimization level:"
msgstr ""
#: c-api/init_config.rst:585
msgid "0: Peephole optimizer (and ``__debug__`` is set to ``True``)"
msgstr ""
#: c-api/init_config.rst:586
msgid "1: Remove assertions, set ``__debug__`` to ``False``"
msgstr ""
#: c-api/init_config.rst:587
msgid "2: Strip docstrings"
msgstr ""
#: c-api/init_config.rst:591
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 ""
#: c-api/init_config.rst:598
msgid ""
"If non-zero, turn on parser debugging output (for expert only, depending on "
"compilation options)."
msgstr ""
#: c-api/init_config.rst:603
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 ""
#: c-api/init_config.rst:609
msgid ":data:`sys.prefix`."
msgstr ""
#: c-api/init_config.rst:613
msgid ""
"Program name. Used to initialize :c:member:`~PyConfig.executable`, and in "
"early error messages."
msgstr ""
#: c-api/init_config.rst:618
msgid ":data:`sys.pycache_prefix`: ``.pyc`` cache prefix."
msgstr ""
#: c-api/init_config.rst:620
msgid "If ``NULL``, :data:`sys.pycache_prefix` is set to ``None``."
msgstr ""
#: c-api/init_config.rst:624
msgid ""
"Quiet mode. For example, don't display the copyright and version messages in "
"interactive mode."
msgstr ""
#: c-api/init_config.rst:629
msgid "``python3 -c COMMAND`` argument. Used by :c:func:`Py_RunMain`."
msgstr ""
#: c-api/init_config.rst:633
msgid "``python3 FILENAME`` argument. Used by :c:func:`Py_RunMain`."
msgstr ""
#: c-api/init_config.rst:637
msgid "``python3 -m MODULE`` argument. Used by :c:func:`Py_RunMain`."
msgstr ""
#: c-api/init_config.rst:641
msgid "Show total reference count at exit?"
msgstr ""
#: c-api/init_config.rst:643
msgid "Set to 1 by :option:`-X showrefcount <-X>` command line option."
msgstr ""
#: c-api/init_config.rst:645
msgid "Need a debug build of Python (``Py_REF_DEBUG`` macro must be defined)."
msgstr ""
#: c-api/init_config.rst:649
msgid "Import the :mod:`site` module at startup?"
msgstr ""
#: c-api/init_config.rst:653
msgid "Skip the first line of the source?"
msgstr ""
#: c-api/init_config.rst:658
msgid ""
"Encoding and encoding errors of :data:`sys.stdin`, :data:`sys.stdout` and :"
"data:`sys.stderr`."
msgstr ""
#: c-api/init_config.rst:663
msgid "If non-zero, call :func:`tracemalloc.start` at startup."
msgstr ""
#: c-api/init_config.rst:667
msgid "If greater than 0, use :ref:`environment variables <using-on-envvars>`."
msgstr ""
#: c-api/init_config.rst:671
msgid "If non-zero, add user site directory to :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:675
msgid "If non-zero, enable verbose mode."
msgstr ""
#: c-api/init_config.rst:679
msgid ""
":data:`sys.warnoptions`: options of the :mod:`warnings` module to build "
"warnings filters: lowest to highest priority."
msgstr ""
#: c-api/init_config.rst:682
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:689
msgid "If non-zero, write ``.pyc`` files."
msgstr ""
#: c-api/init_config.rst:691
msgid ""
":data:`sys.dont_write_bytecode` is initialized to the inverted value of :c:"
"member:`~PyConfig.write_bytecode`."
msgstr ""
#: c-api/init_config.rst:696
msgid ":data:`sys._xoptions`."
msgstr ""
#: c-api/init_config.rst:700
msgid "Enable PEG parser? Default: 1."
msgstr ""
#: c-api/init_config.rst:702
msgid "Set to 0 by :option:`-X oldparser <-X>` and :envvar:`PYTHONOLDPARSER`."
msgstr ""
#: c-api/init_config.rst:704
msgid "See also :pep:`617`."
msgstr ""
#: c-api/init_config.rst:708
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 ""
#: c-api/init_config.rst:713
msgid ""
"The ``xoptions`` options are parsed to set other options: see :option:`-X` "
"option."
msgstr ""
#: c-api/init_config.rst:718
msgid "The ``show_alloc_count`` field has been removed."
msgstr ""
#: c-api/init_config.rst:722
msgid "Initialization with PyConfig"
msgstr ""
#: c-api/init_config.rst:724
msgid "Function to initialize Python:"
msgstr ""
#: c-api/init_config.rst:728
msgid "Initialize Python from *config* configuration."
msgstr ""
#: c-api/init_config.rst:733
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:740
msgid "Example setting the program name::"
msgstr ""
#: c-api/init_config.rst:768
msgid ""
"More complete example modifying the default configuration, read the "
"configuration, and then override some parameters::"
msgstr ""
#: c-api/init_config.rst:819
msgid "Isolated Configuration"
msgstr ""
#: c-api/init_config.rst:821
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:826
msgid ""
"This configuration ignores global configuration variables, environment "
"variables, command line arguments (:c:member:`PyConfig.argv` is not parsed) "
"and user site directory. The C standard streams (ex: ``stdout``) and the "
"LC_CTYPE locale are left unchanged. Signal handlers are not installed."
msgstr ""
#: c-api/init_config.rst:831
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 ""
#: c-api/init_config.rst:840
msgid "Python Configuration"
msgstr ""
#: c-api/init_config.rst:842
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:846
msgid ""
"Environments variables and command line arguments are used to configure "
"Python, whereas global configuration variables are ignored."
msgstr ""
#: c-api/init_config.rst:849
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 ""
#: c-api/init_config.rst:853
msgid "Example of customized Python always running in isolated mode::"
msgstr ""
#: c-api/init_config.rst:892
msgid "Path Configuration"
msgstr ""
#: c-api/init_config.rst:894
msgid ":c:type:`PyConfig` contains multiple fields for the path configuration:"
msgstr ""
#: c-api/init_config.rst:896
msgid "Path configuration inputs:"
msgstr ""
#: c-api/init_config.rst:898
msgid ":c:member:`PyConfig.home`"
msgstr ""
#: c-api/init_config.rst:899
msgid ":c:member:`PyConfig.platlibdir`"
msgstr ""
#: c-api/init_config.rst:900
msgid ":c:member:`PyConfig.pathconfig_warnings`"
msgstr ""
#: c-api/init_config.rst:901
msgid ":c:member:`PyConfig.program_name`"
msgstr ""
#: c-api/init_config.rst:902
msgid ":c:member:`PyConfig.pythonpath_env`"
msgstr ""
#: c-api/init_config.rst:903
msgid "current working directory: to get absolute paths"
msgstr ""
#: c-api/init_config.rst:904
msgid ""
"``PATH`` environment variable to get the program full path (from :c:member:"
"`PyConfig.program_name`)"
msgstr ""
#: c-api/init_config.rst:906
msgid "``__PYVENV_LAUNCHER__`` environment variable"
msgstr ""
#: c-api/init_config.rst:907
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:911
msgid "Path configuration output fields:"
msgstr ""
#: c-api/init_config.rst:913
msgid ":c:member:`PyConfig.base_exec_prefix`"
msgstr ""
#: c-api/init_config.rst:914
msgid ":c:member:`PyConfig.base_executable`"
msgstr ""
#: c-api/init_config.rst:915
msgid ":c:member:`PyConfig.base_prefix`"
msgstr ""
#: c-api/init_config.rst:916
msgid ":c:member:`PyConfig.exec_prefix`"
msgstr ""
#: c-api/init_config.rst:917
msgid ":c:member:`PyConfig.executable`"
msgstr ""
#: c-api/init_config.rst:918
msgid ""
":c:member:`PyConfig.module_search_paths_set`, :c:member:`PyConfig."
"module_search_paths`"
msgstr ""
#: c-api/init_config.rst:920
msgid ":c:member:`PyConfig.prefix`"
msgstr ""
#: c-api/init_config.rst:922
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:928
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:935
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:938
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:942
msgid ":c:func:`Py_RunMain` and :c:func:`Py_Main` modify :data:`sys.path`:"
msgstr ""
#: c-api/init_config.rst:944
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:947
msgid "If :c:member:`~PyConfig.isolated` is zero:"
msgstr ""
#: c-api/init_config.rst:949
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:951
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:953
msgid "Otherwise, prepend an empty string to :data:`sys.path`."
msgstr ""
#: c-api/init_config.rst:955
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:961
msgid "The following configuration files are used by the path configuration:"
msgstr ""
#: c-api/init_config.rst:963
msgid "``pyvenv.cfg``"
msgstr ""
#: c-api/init_config.rst:964
msgid "``python._pth`` (Windows only)"
msgstr ""
#: c-api/init_config.rst:965
msgid "``pybuilddir.txt`` (Unix only)"
msgstr ""
#: c-api/init_config.rst:967
msgid ""
"The ``__PYVENV_LAUNCHER__`` environment variable is used to set :c:member:"
"`PyConfig.base_executable`"
msgstr ""
#: c-api/init_config.rst:972
msgid "Py_RunMain()"
msgstr ""
#: c-api/init_config.rst:976
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:981
msgid "By default and when if :option:`-i` option is used, run the REPL."
msgstr ""
#: c-api/init_config.rst:983
msgid ""
"Finally, finalizes Python and returns an exit status that can be passed to "
"the ``exit()`` function."
msgstr ""
#: c-api/init_config.rst:986
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:992
msgid "Py_GetArgcArgv()"
msgstr ""
#: c-api/init_config.rst:996
msgid "Get the original command line arguments, before Python modified them."
msgstr ""
#: c-api/init_config.rst:1000
msgid "Multi-Phase Initialization Private Provisional API"
msgstr ""
#: c-api/init_config.rst:1002
msgid ""
"This section is a private provisional API introducing multi-phase "
"initialization, the core feature of :pep:`432`:"
msgstr ""
#: c-api/init_config.rst:1005
msgid "\"Core\" initialization phase, \"bare minimum Python\":"
msgstr ""
#: c-api/init_config.rst:1007
msgid "Builtin types;"
msgstr ""
#: c-api/init_config.rst:1008
msgid "Builtin exceptions;"
msgstr ""
#: c-api/init_config.rst:1009
msgid "Builtin and frozen modules;"
msgstr ""
#: c-api/init_config.rst:1010
msgid ""
"The :mod:`sys` module is only partially initialized (ex: :data:`sys.path` "
"doesn't exist yet)."
msgstr ""
#: c-api/init_config.rst:1013
msgid "\"Main\" initialization phase, Python is fully initialized:"
msgstr ""
#: c-api/init_config.rst:1015
msgid "Install and configure :mod:`importlib`;"
msgstr ""
#: c-api/init_config.rst:1016
msgid "Apply the :ref:`Path Configuration <init-path-config>`;"
msgstr ""
#: c-api/init_config.rst:1017
msgid "Install signal handlers;"
msgstr ""
#: c-api/init_config.rst:1018
msgid ""
"Finish :mod:`sys` module initialization (ex: create :data:`sys.stdout` and :"
"data:`sys.path`);"
msgstr ""
#: c-api/init_config.rst:1020
msgid ""
"Enable optional features like :mod:`faulthandler` and :mod:`tracemalloc`;"
msgstr ""
#: c-api/init_config.rst:1021
msgid "Import the :mod:`site` module;"
msgstr ""
#: c-api/init_config.rst:1022
msgid "etc."
msgstr ""
#: c-api/init_config.rst:1024
msgid "Private provisional API:"
msgstr ""
#: c-api/init_config.rst:1026
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:1028
msgid ""
":c:member:`PyConfig._isolated_interpreter`: if non-zero, disallow threads, "
"subprocesses and fork."
msgstr ""
#: c-api/init_config.rst:1033
msgid ""
"Move to the \"Main\" initialization phase, finish the Python initialization."
msgstr ""
#: c-api/init_config.rst:1035
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:1041
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:1045
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:1050
msgid ""
"Example running Python code between \"Core\" and \"Main\" initialization "
"phases::"
msgstr ""
View Git Blame Copy Permalink