# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001 Python Software Foundation

# This file is distributed under the same license as the Python package.

# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

#

# Translators:

# python-doc bot, 2026

#

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: Python 3.14\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2026-04-05 14:30+0000\n"

"PO-Revision-Date: 2026-02-25 14:46+0000\n"

"Last-Translator: python-doc bot, 2026\n"

"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Language: pl\n"

"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && "

"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && "

"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n"

msgid "Interpreter initialization and finalization"

msgstr ""

msgid ""

"See :ref:`Python Initialization Configuration <init-config>` for details on "

"how to configure the interpreter prior to initialization."

msgstr ""

msgid "Before Python initialization"

msgstr ""

msgid ""

"In an application embedding Python, the :c:func:`Py_Initialize` function "

"must be called before using any other Python/C API functions; with the "

"exception of a few functions and the :ref:`global configuration variables "

"<global-conf-vars>`."

msgstr ""

msgid ""

"The following functions can be safely called before Python is initialized:"

msgstr ""

msgid "Functions that initialize the interpreter:"

msgstr ""

msgid ":c:func:`Py_Initialize`"

msgstr ":c:func:`Py_Initialize`"

msgid ":c:func:`Py_InitializeEx`"

msgstr ":c:func:`Py_InitializeEx`"

msgid ":c:func:`Py_InitializeFromConfig`"

msgstr ":c:func:`Py_InitializeFromConfig`"

msgid ":c:func:`Py_BytesMain`"

msgstr ":c:func:`Py_BytesMain`"

msgid ":c:func:`Py_Main`"

msgstr ":c:func:`Py_Main`"

msgid "the runtime pre-initialization functions covered in :ref:`init-config`"

msgstr ""

msgid "Configuration functions:"

msgstr "Konfiguracja funkcja:"

msgid ":c:func:`PyImport_AppendInittab`"

msgstr ":c:func:`PyImport_AppendInittab`"

msgid ":c:func:`PyImport_ExtendInittab`"

msgstr ":c:func:`PyImport_ExtendInittab`"

msgid ":c:func:`!PyInitFrozenExtensions`"

msgstr ":c:func:`!PyInitFrozenExtensions`"

msgid ":c:func:`PyMem_SetAllocator`"

msgstr ":c:func:`PyMem_SetAllocator`"

msgid ":c:func:`PyMem_SetupDebugHooks`"

msgstr ":c:func:`PyMem_SetupDebugHooks`"

msgid ":c:func:`PyObject_SetArenaAllocator`"

msgstr ":c:func:`PyObject_SetArenaAllocator`"

msgid ":c:func:`Py_SetProgramName`"

msgstr ":c:func:`Py_SetProgramName`"

msgid ":c:func:`Py_SetPythonHome`"

msgstr ":c:func:`Py_SetPythonHome`"

msgid "the configuration functions covered in :ref:`init-config`"

msgstr ""

msgid "Informative functions:"

msgstr "Informatiwne funkcje:"

msgid ":c:func:`Py_IsInitialized`"

msgstr ":c:func:`Py_IsInitialized`"

msgid ":c:func:`PyMem_GetAllocator`"

msgstr ":c:func:`PyMem_GetAllocator`"

msgid ":c:func:`PyObject_GetArenaAllocator`"

msgstr ":c:func:`PyObject_GetArenaAllocator`"

msgid ":c:func:`Py_GetBuildInfo`"

msgstr ":c:func:`Py_GetBuildInfo`"

msgid ":c:func:`Py_GetCompiler`"

msgstr ":c:func:`Py_GetCompiler`"

msgid ":c:func:`Py_GetCopyright`"

msgstr ":c:func:`Py_GetCopyright`"

msgid ":c:func:`Py_GetPlatform`"

msgstr ":c:func:`Py_GetPlatform`"

msgid ":c:func:`Py_GetVersion`"

msgstr ":c:func:`Py_GetVersion`"

msgid "Utilities:"

msgstr "Narzędzia:"

msgid ":c:func:`Py_DecodeLocale`"

msgstr ":c:func:`Py_DecodeLocale`"

msgid ""

"the status reporting and utility functions covered in :ref:`init-config`"

msgstr ""

msgid "Memory allocators:"

msgstr "Alokatory pamięci:"

msgid ":c:func:`PyMem_RawMalloc`"

msgstr ":c:func:`PyMem_RawMalloc`"

msgid ":c:func:`PyMem_RawRealloc`"

msgstr ":c:func:`PyMem_RawRealloc`"

msgid ":c:func:`PyMem_RawCalloc`"

msgstr ":c:func:`PyMem_RawCalloc`"

msgid ":c:func:`PyMem_RawFree`"

msgstr ":c:func:`PyMem_RawFree`"

msgid "Synchronization:"

msgstr ""

msgid ":c:func:`PyMutex_Lock`"

msgstr ":c:func:`PyMutex_Lock`"

msgid ":c:func:`PyMutex_Unlock`"

msgstr ":c:func:`PyMutex_Unlock`"

msgid ""

"Despite their apparent similarity to some of the functions listed above, the "

"following functions **should not be called** before the interpreter has been "

"initialized: :c:func:`Py_EncodeLocale`, :c:func:`PyEval_InitThreads`, and :c:"

"func:`Py_RunMain`."

msgstr ""

msgid "Global configuration variables"

msgstr ""

msgid ""

"Python has variables for the global configuration to control different "

"features and options. By default, these flags are controlled by :ref:"

"`command line options <using-on-interface-options>`."

msgstr ""

msgid ""

"When a flag is set by an option, the value of the flag is the number of "

"times that the option was set. For example, ``-b`` sets :c:data:"

"`Py_BytesWarningFlag` to 1 and ``-bb`` sets :c:data:`Py_BytesWarningFlag` to "

"2."

msgstr ""

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"bytes_warning` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

msgid ""

"Issue a warning when comparing :class:`bytes` or :class:`bytearray` with :"

"class:`str` or :class:`bytes` with :class:`int`. Issue an error if greater "

"or equal to ``2``."

msgstr ""

msgid "Set by the :option:`-b` option."

msgstr ""

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"parser_debug` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

msgid ""

"Turn on parser debugging output (for expert only, depending on compilation "

"options)."

msgstr ""

msgid ""

"Set by the :option:`-d` option and the :envvar:`PYTHONDEBUG` environment "

"variable."

msgstr ""

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"write_bytecode` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

msgid ""

"If set to non-zero, Python won't try to write ``.pyc`` files on the import "

"of source modules."

msgstr ""

msgid ""

"Set by the :option:`-B` option and the :envvar:`PYTHONDONTWRITEBYTECODE` "

"environment variable."

msgstr ""

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"pathconfig_warnings` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

msgid "Private flag used by ``_freeze_module`` and ``frozenmain`` programs."

msgstr ""

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"hash_seed` and :c:member:`PyConfig.use_hash_seed` should be used instead, "

"see :ref:`Python Initialization Configuration <init-config>`."

msgstr ""

msgid ""

"Set to ``1`` if the :envvar:`PYTHONHASHSEED` environment variable is set to "

"a non-empty string."

msgstr ""

msgid ""

"If the flag is non-zero, read the :envvar:`PYTHONHASHSEED` environment "

"variable to initialize the secret hash seed."

msgstr ""

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"use_environment` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

msgid ""

"Ignore all :envvar:`!PYTHON*` environment variables, e.g. :envvar:"

"`PYTHONPATH` and :envvar:`PYTHONHOME`, that might be set."

msgstr ""

msgid "Set by the :option:`-E` and :option:`-I` options."

msgstr ""

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"inspect` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

msgid ""

"When a script is passed as first argument or the :option:`-c` option is "

"used, enter interactive mode after executing the script or the command, even "

"when :data:`sys.stdin` does not appear to be a terminal."

msgstr ""

msgid ""

"Set by the :option:`-i` option and the :envvar:`PYTHONINSPECT` environment "

"variable."

msgstr ""

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"interactive` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

msgid "Set by the :option:`-i` option."

msgstr ""

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"isolated` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

msgid ""

"Run Python in isolated mode. In isolated mode :data:`sys.path` contains "

"neither the script's directory nor the user's site-packages directory."

msgstr ""

msgid "Set by the :option:`-I` option."

msgstr ""

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyPreConfig."

"legacy_windows_fs_encoding` should be used instead, see :ref:`Python "

"Initialization Configuration <init-config>`."

msgstr ""

msgid ""

"If the flag is non-zero, use the ``mbcs`` encoding with ``replace`` error "

"handler, instead of the UTF-8 encoding with ``surrogatepass`` error handler, "

"for the :term:`filesystem encoding and error handler`."

msgstr ""

msgid ""

"Set to ``1`` if the :envvar:`PYTHONLEGACYWINDOWSFSENCODING` environment "

"variable is set to a non-empty string."

msgstr ""

msgid "See :pep:`529` for more details."

msgstr ""

msgid "Availability"

msgstr "Dostępność"

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"legacy_windows_stdio` should be used instead, see :ref:`Python "

"Initialization Configuration <init-config>`."

msgstr ""

msgid ""

"If the flag is non-zero, use :class:`io.FileIO` instead of :class:`!io."

"_WindowsConsoleIO` for :mod:`sys` standard streams."

msgstr ""

msgid ""

"Set to ``1`` if the :envvar:`PYTHONLEGACYWINDOWSSTDIO` environment variable "

"is set to a non-empty string."

msgstr ""

msgid "See :pep:`528` for more details."

msgstr ""

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"site_import` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

msgid ""

"Disable the import of the module :mod:`site` and the site-dependent "

"manipulations of :data:`sys.path` that it entails. Also disable these "

"manipulations if :mod:`site` is explicitly imported later (call :func:`site."

"main` if you want them to be triggered)."

msgstr ""

msgid "Set by the :option:`-S` option."

msgstr ""

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"user_site_directory` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

msgid ""

"Don't add the :data:`user site-packages directory <site.USER_SITE>` to :data:"

"`sys.path`."

msgstr ""

msgid ""

"Set by the :option:`-s` and :option:`-I` options, and the :envvar:"

"`PYTHONNOUSERSITE` environment variable."

msgstr ""

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"optimization_level` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

msgid ""

"Set by the :option:`-O` option and the :envvar:`PYTHONOPTIMIZE` environment "

"variable."

msgstr ""

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"quiet` should be used instead, see :ref:`Python Initialization Configuration "

"<init-config>`."

msgstr ""

msgid ""

"Don't display the copyright and version messages even in interactive mode."

msgstr ""

msgid "Set by the :option:`-q` option."

msgstr ""

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"buffered_stdio` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

msgid "Force the stdout and stderr streams to be unbuffered."

msgstr ""

msgid ""

"Set by the :option:`-u` option and the :envvar:`PYTHONUNBUFFERED` "

"environment variable."

msgstr ""

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"verbose` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

msgid ""

"Print a message each time a module is initialized, showing the place "

"(filename or built-in module) from which it is loaded. If greater or equal "

"to ``2``, print a message for each file that is checked for when searching "

"for a module. Also provides information on module cleanup at exit."

msgstr ""

msgid ""

"Set by the :option:`-v` option and the :envvar:`PYTHONVERBOSE` environment "

"variable."

msgstr ""

msgid "Initializing and finalizing the interpreter"

msgstr ""

msgid ""

"Initialize the Python interpreter. In an application embedding Python, this "

"should be called before using any other Python/C API functions; see :ref:"

"`Before Python Initialization <pre-init-safe>` for the few exceptions."

msgstr ""

msgid ""

"This initializes the table of loaded modules (``sys.modules``), and creates "

"the fundamental modules :mod:`builtins`, :mod:`__main__` and :mod:`sys`. It "

"also initializes the module search path (``sys.path``). It does not set "

"``sys.argv``; use the :ref:`Python Initialization Configuration <init-"

"config>` API for that. This is a no-op when called for a second time "

"(without calling :c:func:`Py_FinalizeEx` first). There is no return value; "

"it is a fatal error if the initialization fails."

msgstr ""

msgid ""

"Use :c:func:`Py_InitializeFromConfig` to customize the :ref:`Python "

"Initialization Configuration <init-config>`."

msgstr ""

msgid ""

"On Windows, changes the console mode from ``O_TEXT`` to ``O_BINARY``, which "

"will also affect non-Python uses of the console using the C Runtime."

msgstr ""

msgid ""

"This function works like :c:func:`Py_Initialize` if *initsigs* is ``1``. If "

"*initsigs* is ``0``, it skips initialization registration of signal "

"handlers, which may be useful when CPython is embedded as part of a larger "

"application."

msgstr ""

msgid ""

"Initialize Python from *config* configuration, as described in :ref:`init-"

"from-config`."

msgstr ""

msgid ""

"See the :ref:`init-config` section for details on pre-initializing the "

"interpreter, populating the runtime configuration structure, and querying "

"the returned status structure."

msgstr ""

msgid ""

"Return true (nonzero) when the Python interpreter has been initialized, "

"false (zero) if not. After :c:func:`Py_FinalizeEx` is called, this returns "

"false until :c:func:`Py_Initialize` is called again."

msgstr ""

msgid ""

"Return true (non-zero) if the main Python interpreter is :term:`shutting "

"down <interpreter shutdown>`. Return false (zero) otherwise."

msgstr ""

msgid ""

"Undo all initializations made by :c:func:`Py_Initialize` and subsequent use "

"of Python/C API functions, and destroy all sub-interpreters (see :c:func:"

"`Py_NewInterpreter` below) that were created and not yet destroyed since the "

"last call to :c:func:`Py_Initialize`. This is a no-op when called for a "

"second time (without calling :c:func:`Py_Initialize` again first)."

msgstr ""

msgid ""

"Since this is the reverse of :c:func:`Py_Initialize`, it should be called in "

"the same thread with the same interpreter active. That means the main "

"thread and the main interpreter. This should never be called while :c:func:"

"`Py_RunMain` is running."

msgstr ""

msgid ""

"Normally the return value is ``0``. If there were errors during finalization "

"(flushing buffered data), ``-1`` is returned."

msgstr ""

msgid ""

"Note that Python will do a best effort at freeing all memory allocated by "

"the Python interpreter. Therefore, any C-Extension should make sure to "

"correctly clean up all of the previously allocated PyObjects before using "

"them in subsequent calls to :c:func:`Py_Initialize`. Otherwise it could "

"introduce vulnerabilities and incorrect behavior."

msgstr ""

msgid ""

"This function is provided for a number of reasons. An embedding application "

"might want to restart Python without having to restart the application "

"itself. An application that has loaded the Python interpreter from a "

"dynamically loadable library (or DLL) might want to free all memory "

"allocated by Python before unloading the DLL. During a hunt for memory leaks "

"in an application a developer might want to free all memory allocated by "

"Python before exiting from the application."

msgstr ""

msgid ""

"**Bugs and caveats:** The destruction of modules and objects in modules is "

"done in random order; this may cause destructors (:meth:`~object.__del__` "

"methods) to fail when they depend on other objects (even functions) or "

"modules. Dynamically loaded extension modules loaded by Python are not "

"unloaded. Small amounts of memory allocated by the Python interpreter may "

"not be freed (if you find a leak, please report it). Memory tied up in "

"circular references between objects is not freed. Interned strings will all "

"be deallocated regardless of their reference count. Some memory allocated by "

"extension modules may not be freed. Some extensions may not work properly "

"if their initialization routine is called more than once; this can happen if "

"an application calls :c:func:`Py_Initialize` and :c:func:`Py_FinalizeEx` "

"more than once. :c:func:`Py_FinalizeEx` must not be called recursively from "

"within itself. Therefore, it must not be called by any code that may be run "

"as part of the interpreter shutdown process, such as :py:mod:`atexit` "

"handlers, object finalizers, or any code that may be run while flushing the "

"stdout and stderr files."

msgstr ""

msgid ""

"Raises an :ref:`auditing event <auditing>` ``cpython."

"_PySys_ClearAuditHooks`` with no arguments."

msgstr ""

msgid ""

"This is a backwards-compatible version of :c:func:`Py_FinalizeEx` that "

"disregards the return value."

msgstr ""

msgid ""

"Similar to :c:func:`Py_Main` but *argv* is an array of bytes strings, "

"allowing the calling application to delegate the text decoding step to the "

"CPython runtime."

msgstr ""

msgid ""

"The main program for the standard interpreter, encapsulating a full "

"initialization/finalization cycle, as well as additional behaviour to "

"implement reading configurations settings from the environment and command "

"line, and then executing ``__main__`` in accordance with :ref:`using-on-"

"cmdline`."

msgstr ""

msgid ""

"This is made available for programs which wish to support the full CPython "

"command line interface, rather than just embedding a Python runtime in a "

"larger application."

msgstr ""

msgid ""

"The *argc* and *argv* parameters are similar to those which are passed to a "

"C program's :c:func:`main` function, except that the *argv* entries are "

"first converted to ``wchar_t`` using :c:func:`Py_DecodeLocale`. It is also "

"important to note that the argument list entries may be modified to point to "

"strings other than those passed in (however, the contents of the strings "

"pointed to by the argument list are not modified)."

msgstr ""

msgid ""

"The return value is ``2`` if the argument list does not represent a valid "

"Python command line, and otherwise the same as :c:func:`Py_RunMain`."

msgstr ""

msgid ""

"In terms of the CPython runtime configuration APIs documented in the :ref:"

"`runtime configuration <init-config>` section (and without accounting for "

"error handling), ``Py_Main`` is approximately equivalent to::"

msgstr ""

msgid ""

"PyConfig config;\n"

"PyConfig_InitPythonConfig(&config);\n"

"PyConfig_SetArgv(&config, argc, argv);\n"

"Py_InitializeFromConfig(&config);\n"

"PyConfig_Clear(&config);\n"

"\n"

"Py_RunMain();"

msgstr ""

msgid ""

"In normal usage, an embedding application will call this function *instead* "

"of calling :c:func:`Py_Initialize`, :c:func:`Py_InitializeEx` or :c:func:"

"`Py_InitializeFromConfig` directly, and all settings will be applied as "

"described elsewhere in this documentation. If this function is instead "

"called *after* a preceding runtime initialization API call, then exactly "

"which environmental and command line configuration settings will be updated "

"is version dependent (as it depends on which settings correctly support "

"being modified after they have already been set once when the runtime was "

"first initialized)."

msgstr ""

msgid "Executes the main module in a fully configured CPython runtime."

msgstr ""

msgid ""

"Executes 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. If none "

"of these values are set, runs the interactive Python prompt (REPL) using the "

"``__main__`` module's global namespace."

msgstr ""

msgid ""

"If :c:member:`PyConfig.inspect` is not set (the default), the return value "

"will be ``0`` if the interpreter exits normally (that is, without raising an "

"exception), the exit status of an unhandled :exc:`SystemExit`, or ``1`` for "

"any other unhandled exception."

msgstr ""

msgid ""

"If :c:member:`PyConfig.inspect` is set (such as when the :option:`-i` option "

"is used), rather than returning when the interpreter exits, execution will "

"instead resume in an interactive Python prompt (REPL) using the ``__main__`` "

"module's global namespace. If the interpreter exited with an exception, it "

"is immediately raised in the REPL session. The function return value is then "

"determined by the way the *REPL session* terminates: ``0``, ``1``, or the "

"status of a :exc:`SystemExit`, as specified above."

msgstr ""

msgid ""

"This function always finalizes the Python interpreter before it returns."

msgstr ""

msgid ""

"See :ref:`Python Configuration <init-python-config>` for an example of a "

"customized Python that always runs in isolated mode using :c:func:"

"`Py_RunMain`."

msgstr ""

msgid ""

"Register an :mod:`atexit` callback for the target interpreter *interp*. This "

"is similar to :c:func:`Py_AtExit`, but takes an explicit interpreter and "

"data pointer for the callback."

msgstr ""

msgid "There must be an :term:`attached thread state` for *interp*."

msgstr ""

msgid "Cautions regarding runtime finalization"

msgstr ""

msgid ""

"In the late stage of :term:`interpreter shutdown`, after attempting to wait "

"for non-daemon threads to exit (though this can be interrupted by :class:"

"`KeyboardInterrupt`) and running the :mod:`atexit` functions, the runtime is "

"marked as *finalizing*: :c:func:`Py_IsFinalizing` and :func:`sys."

"is_finalizing` return true. At this point, only the *finalization thread* "

"that initiated finalization (typically the main thread) is allowed to "

"acquire the :term:`GIL`."

msgstr ""

msgid ""

"If any thread, other than the finalization thread, attempts to attach a :"

"term:`thread state` during finalization, either explicitly or implicitly, "

"the thread enters **a permanently blocked state** where it remains until the "

"program exits. In most cases this is harmless, but this can result in "

"deadlock if a later stage of finalization attempts to acquire a lock owned "

"by the blocked thread, or otherwise waits on the blocked thread."

msgstr ""

msgid ""

"Gross? Yes. This prevents random crashes and/or unexpectedly skipped C++ "

"finalizations further up the call stack when such threads were forcibly "

"exited here in CPython 3.13 and earlier. The CPython runtime :term:`thread "

"state` C APIs have never had any error reporting or handling expectations "

"at :term:`thread state` attachment time that would've allowed for graceful "

"exit from this situation. Changing that would require new stable C APIs and "

"rewriting the majority of C code in the CPython ecosystem to use those with "

"error handling."

msgstr ""

msgid "Process-wide parameters"

msgstr ""

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"program_name` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

msgid ""

"This function should be called before :c:func:`Py_Initialize` is called for "

"the first time, if it is called at all. It tells the interpreter the value "

"of the ``argv[0]`` argument to the :c:func:`main` function of the program "

"(converted to wide characters). This is used by :c:func:`Py_GetPath` and "

"some other functions below to find the Python run-time libraries relative to "

"the interpreter executable. The default value is ``'python'``. The "

"argument should point to a zero-terminated wide character string in static "

"storage whose contents will not change for the duration of the program's "

"execution. No code in the Python interpreter will change the contents of "

"this storage."

msgstr ""

msgid ""

"Use :c:func:`Py_DecodeLocale` to decode a bytes string to get a :c:expr:"

"`wchar_t*` string."

msgstr ""

msgid ""

"Return the program name set with :c:member:`PyConfig.program_name`, or the "

"default. The returned string points into static storage; the caller should "

"not modify its value."

msgstr ""

msgid ""

"This function should not be called before :c:func:`Py_Initialize`, otherwise "

"it returns ``NULL``."

msgstr ""

msgid "It now returns ``NULL`` if called before :c:func:`Py_Initialize`."

msgstr ""

msgid ""

"Use :c:func:`PyConfig_Get(\"executable\") <PyConfig_Get>` (:data:`sys."

"executable`) instead."

msgstr ""

msgid ""

"Return the *prefix* for installed platform-independent files. This is "

"derived through a number of complicated rules from the program name set "

"with :c:member:`PyConfig.program_name` and some environment variables; for "

"example, if the program name is ``'/usr/local/bin/python'``, the prefix is "

"``'/usr/local'``. The returned string points into static storage; the caller "

"should not modify its value. This corresponds to the :makevar:`prefix` "

"variable in the top-level :file:`Makefile` and the :option:`--prefix` "

"argument to the :program:`configure` script at build time. The value is "

"available to Python code as ``sys.base_prefix``. It is only useful on Unix. "

"See also the next function."

msgstr ""

msgid ""

"Use :c:func:`PyConfig_Get(\"base_prefix\") <PyConfig_Get>` (:data:`sys."

"base_prefix`) instead. Use :c:func:`PyConfig_Get(\"prefix\") <PyConfig_Get>` "

"(:data:`sys.prefix`) if :ref:`virtual environments <venv-def>` need to be "

"handled."

msgstr ""

msgid ""

"Return the *exec-prefix* for installed platform-*dependent* files. This is "

"derived through a number of complicated rules from the program name set "

"with :c:member:`PyConfig.program_name` and some environment variables; for "

"example, if the program name is ``'/usr/local/bin/python'``, the exec-prefix "

"is ``'/usr/local'``. The returned string points into static storage; the "

"caller should not modify its value. This corresponds to the :makevar:"

"`exec_prefix` variable in the top-level :file:`Makefile` and the ``--exec-"

"prefix`` argument to the :program:`configure` script at build time. The "

"value is available to Python code as ``sys.base_exec_prefix``. It is only "

"useful on Unix."

msgstr ""

msgid ""

"Background: The exec-prefix differs from the prefix when platform dependent "

"files (such as executables and shared libraries) are installed in a "

"different directory tree. In a typical installation, platform dependent "

"files may be installed in the :file:`/usr/local/plat` subtree while platform "

"independent may be installed in :file:`/usr/local`."

msgstr ""

msgid ""

"Generally speaking, a platform is a combination of hardware and software "

"families, e.g. Sparc machines running the Solaris 2.x operating system are "

"considered the same platform, but Intel machines running Solaris 2.x are "

"another platform, and Intel machines running Linux are yet another "

"platform. Different major revisions of the same operating system generally "

"also form different platforms. Non-Unix operating systems are a different "

"story; the installation strategies on those systems are so different that "

"the prefix and exec-prefix are meaningless, and set to the empty string. "

"Note that compiled Python bytecode files are platform independent (but not "

"independent from the Python version by which they were compiled!)."

msgstr ""

msgid ""

"System administrators will know how to configure the :program:`mount` or :"

"program:`automount` programs to share :file:`/usr/local` between platforms "

"while having :file:`/usr/local/plat` be a different filesystem for each "

"platform."

msgstr ""

msgid ""

"Use :c:func:`PyConfig_Get(\"base_exec_prefix\") <PyConfig_Get>` (:data:`sys."

"base_exec_prefix`) instead. Use :c:func:`PyConfig_Get(\"exec_prefix\") "

"<PyConfig_Get>` (:data:`sys.exec_prefix`) if :ref:`virtual environments "

"<venv-def>` need to be handled."

msgstr ""

msgid ""

"Return the full program name of the Python executable; this is computed as "

"a side-effect of deriving the default module search path from the program "

"name (set by :c:member:`PyConfig.program_name`). The returned string points "

"into static storage; the caller should not modify its value. The value is "

"available to Python code as ``sys.executable``."

msgstr ""

msgid ""

"Return the default module search path; this is computed from the program "

"name (set by :c:member:`PyConfig.program_name`) and some environment "

"variables. The returned string consists of a series of directory names "

"separated by a platform dependent delimiter character. The delimiter "

"character is ``':'`` on Unix and macOS, ``';'`` on Windows. The returned "

"string points into static storage; the caller should not modify its value. "

"The list :data:`sys.path` is initialized with this value on interpreter "

"startup; it can be (and usually is) modified later to change the search path "

"for loading modules."

msgstr ""

msgid ""

"Use :c:func:`PyConfig_Get(\"module_search_paths\") <PyConfig_Get>` (:data:"

"`sys.path`) instead."

msgstr ""

msgid ""

"Return the version of this Python interpreter. This is a string that looks "

"something like ::"

msgstr ""

msgid "\"3.0a5+ (py3k:63103M, May 12 2008, 00:53:55) \\n[GCC 4.2.3]\""

msgstr ""

msgid ""

"The first word (up to the first space character) is the current Python "

"version; the first characters are the major and minor version separated by a "

"period. The returned string points into static storage; the caller should "

"not modify its value. The value is available to Python code as :data:`sys."

"version`."

msgstr ""

msgid "See also the :c:var:`Py_Version` constant."

msgstr ""

msgid ""

"Return the platform identifier for the current platform. On Unix, this is "

"formed from the \"official\" name of the operating system, converted to "

"lower case, followed by the major revision number; e.g., for Solaris 2.x, "

"which is also known as SunOS 5.x, the value is ``'sunos5'``. On macOS, it "

"is ``'darwin'``. On Windows, it is ``'win'``. The returned string points "

"into static storage; the caller should not modify its value. The value is "

"available to Python code as ``sys.platform``."

msgstr ""

msgid ""

"Return the official copyright string for the current Python version, for "

"example"

msgstr ""

msgid "``'Copyright 1991-1995 Stichting Mathematisch Centrum, Amsterdam'``"

msgstr ""

msgid ""

"The returned string points into static storage; the caller should not modify "

"its value. The value is available to Python code as ``sys.copyright``."

msgstr ""

msgid ""

"Return an indication of the compiler used to build the current Python "

"version, in square brackets, for example::"

msgstr ""

msgid "\"[GCC 2.7.2.2]\""

msgstr ""

msgid ""

"The returned string points into static storage; the caller should not modify "

"its value. The value is available to Python code as part of the variable "

"``sys.version``."

msgstr ""

msgid ""

"Return information about the sequence number and build date and time of the "

"current Python interpreter instance, for example ::"

msgstr ""

msgid "\"#67, Aug 1 1997, 22:34:28\""

msgstr ""

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"argv`, :c:member:`PyConfig.parse_argv` and :c:member:`PyConfig.safe_path` "

"should be used instead, see :ref:`Python Initialization Configuration <init-"

"config>`."

msgstr ""

msgid ""

"Set :data:`sys.argv` based on *argc* and *argv*. These parameters are "

"similar to those passed to the program's :c:func:`main` function with the "

"difference that the first entry should refer to the script file to be "

"executed rather than the executable hosting the Python interpreter. If "

"there isn't a script that will be run, the first entry in *argv* can be an "

"empty string. If this function fails to initialize :data:`sys.argv`, a "

"fatal condition is signalled using :c:func:`Py_FatalError`."

msgstr ""

msgid ""

"If *updatepath* is zero, this is all the function does. If *updatepath* is "

"non-zero, the function also modifies :data:`sys.path` according to the "

"following algorithm:"

msgstr ""

msgid ""

"If the name of an existing script is passed in ``argv[0]``, the absolute "

"path of the directory where the script is located is prepended to :data:`sys."

"path`."

msgstr ""

msgid ""

"Otherwise (that is, if *argc* is ``0`` or ``argv[0]`` doesn't point to an "

"existing file name), an empty string is prepended to :data:`sys.path`, which "

"is the same as prepending the current working directory (``\".\"``)."

msgstr ""

msgid ""

"See also :c:member:`PyConfig.orig_argv` and :c:member:`PyConfig.argv` "

"members of the :ref:`Python Initialization Configuration <init-config>`."

msgstr ""

msgid ""

"It is recommended that applications embedding the Python interpreter for "

"purposes other than executing a single script pass ``0`` as *updatepath*, "

"and update :data:`sys.path` themselves if desired. See :cve:`2008-5983`."

msgstr ""

msgid ""

"On versions before 3.1.3, you can achieve the same effect by manually "

"popping the first :data:`sys.path` element after having called :c:func:"

"`PySys_SetArgv`, for example using::"

msgstr ""

msgid "PyRun_SimpleString(\"import sys; sys.path.pop(0)\\n\");"

msgstr ""

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"argv` and :c:member:`PyConfig.parse_argv` should be used instead, see :ref:"

"`Python Initialization Configuration <init-config>`."

msgstr ""

msgid ""

"This function works like :c:func:`PySys_SetArgvEx` with *updatepath* set to "

"``1`` unless the :program:`python` interpreter was started with the :option:"

"`-I`."

msgstr ""

msgid "The *updatepath* value depends on :option:`-I`."

msgstr ""

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"home` should be used instead, see :ref:`Python Initialization Configuration "

"<init-config>`."

msgstr ""

msgid ""

"Set the default \"home\" directory, that is, the location of the standard "

"Python libraries. See :envvar:`PYTHONHOME` for the meaning of the argument "

"string."

msgstr ""

msgid ""

"The argument should point to a zero-terminated character string in static "

"storage whose contents will not change for the duration of the program's "

"execution. No code in the Python interpreter will change the contents of "

"this storage."

msgstr ""

msgid ""

"Return the default \"home\", that is, the value set by :c:member:`PyConfig."

"home`, or the value of the :envvar:`PYTHONHOME` environment variable if it "