# 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: 2020-08-24 09:01+0200\n" "PO-Revision-Date: 2019-09-04 11:42+0200\n" "Last-Translator: FULL NAME \n" "Language-Team: FRENCH \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 `." 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:74 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:87 c-api/init_config.rst:107 c-api/init_config.rst:210 #: 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 `." msgstr "" #: c-api/init_config.rst:207 msgid "" "Initialize the preconfiguration with :ref:`Isolated Configuration `." 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 " "`" msgstr "" #: c-api/init_config.rst:226 msgid "" "``PYMEM_ALLOCATOR_PYMALLOC_DEBUG`` (``6``): :ref:`Python pymalloc memory " "allocator ` 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 `." 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:261 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 `." 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:298 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 ` (: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 `." msgstr "" #: c-api/init_config.rst:354 msgid "" "Initialize configuration with :ref:`Isolated Configuration `." msgstr "" #: c-api/init_config.rst:359 msgid "Copy the wide character string *str* into ``*config_str``." msgstr "" #: c-api/init_config.rst:361 c-api/init_config.rst:367 #: c-api/init_config.rst:373 c-api/init_config.rst:379 #: c-api/init_config.rst:385 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 `." 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 " "` 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 `." 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 `." 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 ` (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 `." 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 `." 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 ``PyImport_FrozenModules``, ``PyImport_AppendInittab()`` or " "``PyImport_ExtendInittab()`` are used, they must be set or called after " "Python preinitialization and before the Python initialization." msgstr "" #: c-api/init_config.rst:737 msgid "Example setting the program name::" msgstr "" #: c-api/init_config.rst:765 msgid "" "More complete example modifying the default configuration, read the " "configuration, and then override some parameters::" msgstr "" #: c-api/init_config.rst:816 msgid "Isolated Configuration" msgstr "" #: c-api/init_config.rst:818 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:823 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:828 msgid "" "Configuration files are still used with this configuration. Set the :ref:" "`Path Configuration ` (\"output fields\") to ignore these " "configuration files and avoid the function computing the default path " "configuration." msgstr "" #: c-api/init_config.rst:837 msgid "Python Configuration" msgstr "" #: c-api/init_config.rst:839 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:843 msgid "" "Environments variables and command line arguments are used to configure " "Python, whereas global configuration variables are ignored." msgstr "" #: c-api/init_config.rst:846 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:850 msgid "Example of customized Python always running in isolated mode::" msgstr "" #: c-api/init_config.rst:889 msgid "Path Configuration" msgstr "" #: c-api/init_config.rst:891 msgid ":c:type:`PyConfig` contains multiple fields for the path configuration:" msgstr "" #: c-api/init_config.rst:893 msgid "Path configuration inputs:" msgstr "" #: c-api/init_config.rst:895 msgid ":c:member:`PyConfig.home`" msgstr "" #: c-api/init_config.rst:896 msgid ":c:member:`PyConfig.platlibdir`" msgstr "" #: c-api/init_config.rst:897 msgid ":c:member:`PyConfig.pathconfig_warnings`" msgstr "" #: c-api/init_config.rst:898 msgid ":c:member:`PyConfig.program_name`" msgstr "" #: c-api/init_config.rst:899 msgid ":c:member:`PyConfig.pythonpath_env`" msgstr "" #: c-api/init_config.rst:900 msgid "current working directory: to get absolute paths" msgstr "" #: c-api/init_config.rst:901 msgid "" "``PATH`` environment variable to get the program full path (from :c:member:" "`PyConfig.program_name`)" msgstr "" #: c-api/init_config.rst:903 msgid "``__PYVENV_LAUNCHER__`` environment variable" msgstr "" #: c-api/init_config.rst:904 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:908 msgid "Path configuration output fields:" msgstr "" #: c-api/init_config.rst:910 msgid ":c:member:`PyConfig.base_exec_prefix`" msgstr "" #: c-api/init_config.rst:911 msgid ":c:member:`PyConfig.base_executable`" msgstr "" #: c-api/init_config.rst:912 msgid ":c:member:`PyConfig.base_prefix`" msgstr "" #: c-api/init_config.rst:913 msgid ":c:member:`PyConfig.exec_prefix`" msgstr "" #: c-api/init_config.rst:914 msgid ":c:member:`PyConfig.executable`" msgstr "" #: c-api/init_config.rst:915 msgid "" ":c:member:`PyConfig.module_search_paths_set`, :c:member:`PyConfig." "module_search_paths`" msgstr "" #: c-api/init_config.rst:917 msgid ":c:member:`PyConfig.prefix`" msgstr "" #: c-api/init_config.rst:919 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:925 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:932 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:935 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:939 msgid ":c:func:`Py_RunMain` and :c:func:`Py_Main` modify :data:`sys.path`:" msgstr "" #: c-api/init_config.rst:941 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:944 msgid "If :c:member:`~PyConfig.isolated` is zero:" msgstr "" #: c-api/init_config.rst:946 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:948 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:950 msgid "Otherwise, prepend an empty string to :data:`sys.path`." msgstr "" #: c-api/init_config.rst:952 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:958 msgid "The following configuration files are used by the path configuration:" msgstr "" #: c-api/init_config.rst:960 msgid "``pyvenv.cfg``" msgstr "" #: c-api/init_config.rst:961 msgid "``python._pth`` (Windows only)" msgstr "" #: c-api/init_config.rst:962 msgid "``pybuilddir.txt`` (Unix only)" msgstr "" #: c-api/init_config.rst:964 msgid "" "The ``__PYVENV_LAUNCHER__`` environment variable is used to set :c:member:" "`PyConfig.base_executable`" msgstr "" #: c-api/init_config.rst:969 msgid "Py_RunMain()" msgstr "" #: c-api/init_config.rst:973 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:978 msgid "By default and when if :option:`-i` option is used, run the REPL." msgstr "" #: c-api/init_config.rst:980 msgid "" "Finally, finalizes Python and returns an exit status that can be passed to " "the ``exit()`` function." msgstr "" #: c-api/init_config.rst:983 msgid "" "See :ref:`Python Configuration ` for an example of " "customized Python always running in isolated mode using :c:func:`Py_RunMain`." msgstr "" #: c-api/init_config.rst:989 msgid "Py_GetArgcArgv()" msgstr "" #: c-api/init_config.rst:993 msgid "Get the original command line arguments, before Python modified them." msgstr "" #: c-api/init_config.rst:997 msgid "Multi-Phase Initialization Private Provisional API" msgstr "" #: c-api/init_config.rst:999 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:1002 msgid "\"Core\" initialization phase, \"bare minimum Python\":" msgstr "" #: c-api/init_config.rst:1004 msgid "Builtin types;" msgstr "" #: c-api/init_config.rst:1005 msgid "Builtin exceptions;" msgstr "" #: c-api/init_config.rst:1006 msgid "Builtin and frozen modules;" msgstr "" #: c-api/init_config.rst:1007 msgid "" "The :mod:`sys` module is only partially initialized (ex: :data:`sys.path` " "doesn't exist yet)." msgstr "" #: c-api/init_config.rst:1010 msgid "\"Main\" initialization phase, Python is fully initialized:" msgstr "" #: c-api/init_config.rst:1012 msgid "Install and configure :mod:`importlib`;" msgstr "" #: c-api/init_config.rst:1013 msgid "Apply the :ref:`Path Configuration `;" msgstr "" #: c-api/init_config.rst:1014 msgid "Install signal handlers;" msgstr "" #: c-api/init_config.rst:1015 msgid "" "Finish :mod:`sys` module initialization (ex: create :data:`sys.stdout` and :" "data:`sys.path`);" msgstr "" #: c-api/init_config.rst:1017 msgid "" "Enable optional features like :mod:`faulthandler` and :mod:`tracemalloc`;" msgstr "" #: c-api/init_config.rst:1018 msgid "Import the :mod:`site` module;" msgstr "" #: c-api/init_config.rst:1019 msgid "etc." msgstr "" #: c-api/init_config.rst:1021 msgid "Private provisional API:" msgstr "" #: c-api/init_config.rst:1023 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:1025 msgid "" ":c:member:`PyConfig._isolated_interpreter`: if non-zero, disallow threads, " "subprocesses and fork." msgstr "" #: c-api/init_config.rst:1030 msgid "" "Move to the \"Main\" initialization phase, finish the Python initialization." msgstr "" #: c-api/init_config.rst:1032 msgid "" "No module is imported during the \"Core\" phase and the ``importlib`` module " "is not configured: the :ref:`Path Configuration ` is only " "applied during the \"Main\" phase. It may allow to customize Python in " "Python to override or tune the :ref:`Path Configuration `, " "maybe install a custom :data:`sys.meta_path` importer or an import hook, etc." msgstr "" #: c-api/init_config.rst:1038 msgid "" "It may become possible to calculatin the :ref:`Path Configuration ` 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:1042 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:1047 msgid "" "Example running Python code between \"Core\" and \"Main\" initialization " "phases::" msgstr ""