# Copyright (C) 2001-2020, Python Software Foundation
# This file is distributed under the same license as the Python package.
# Maintained by the python-doc-es workteam.
# docs-es@python.org /
# https://mail.python.org/mailman3/lists/docs-es.python.org/
# Check https://github.com/PyCampES/python-docs-es/blob/3.8/TRANSLATORS to
# get the list of volunteers
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.8\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-05-05 12:54+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME \n"
"Language-Team: python-doc-es\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.8.0\n"
#: ../Doc/using/cmdline.rst:9
msgid "Command line and environment"
msgstr ""
#: ../Doc/using/cmdline.rst:11
msgid ""
"The CPython interpreter scans the command line and the environment for "
"various settings."
msgstr ""
#: ../Doc/using/cmdline.rst:16
msgid ""
"Other implementations' command line schemes may differ. See :ref:"
"`implementations` for further resources."
msgstr ""
#: ../Doc/using/cmdline.rst:23
msgid "Command line"
msgstr ""
#: ../Doc/using/cmdline.rst:25
msgid "When invoking Python, you may specify any of these options::"
msgstr ""
#: ../Doc/using/cmdline.rst:29
msgid ""
"The most common use case is, of course, a simple invocation of a script::"
msgstr ""
#: ../Doc/using/cmdline.rst:37
msgid "Interface options"
msgstr ""
#: ../Doc/using/cmdline.rst:39
msgid ""
"The interpreter interface resembles that of the UNIX shell, but provides "
"some additional methods of invocation:"
msgstr ""
#: ../Doc/using/cmdline.rst:42
msgid ""
"When called with standard input connected to a tty device, it prompts for "
"commands and executes them until an EOF (an end-of-file character, you can "
"produce that with :kbd:`Ctrl-D` on UNIX or :kbd:`Ctrl-Z, Enter` on Windows) "
"is read."
msgstr ""
#: ../Doc/using/cmdline.rst:45
msgid ""
"When called with a file name argument or with a file as standard input, it "
"reads and executes a script from that file."
msgstr ""
#: ../Doc/using/cmdline.rst:47
msgid ""
"When called with a directory name argument, it reads and executes an "
"appropriately named script from that directory."
msgstr ""
#: ../Doc/using/cmdline.rst:49
msgid ""
"When called with ``-c command``, it executes the Python statement(s) given "
"as *command*. Here *command* may contain multiple statements separated by "
"newlines. Leading whitespace is significant in Python statements!"
msgstr ""
#: ../Doc/using/cmdline.rst:52
msgid ""
"When called with ``-m module-name``, the given module is located on the "
"Python module path and executed as a script."
msgstr ""
#: ../Doc/using/cmdline.rst:55
msgid ""
"In non-interactive mode, the entire input is parsed before it is executed."
msgstr ""
#: ../Doc/using/cmdline.rst:57
msgid ""
"An interface option terminates the list of options consumed by the "
"interpreter, all consecutive arguments will end up in :data:`sys.argv` -- "
"note that the first element, subscript zero (``sys.argv[0]``), is a string "
"reflecting the program's source."
msgstr ""
#: ../Doc/using/cmdline.rst:64
msgid ""
"Execute the Python code in *command*. *command* can be one or more "
"statements separated by newlines, with significant leading whitespace as in "
"normal module code."
msgstr ""
#: ../Doc/using/cmdline.rst:68
msgid ""
"If this option is given, the first element of :data:`sys.argv` will be ``\"-c"
"\"`` and the current directory will be added to the start of :data:`sys."
"path` (allowing modules in that directory to be imported as top level "
"modules)."
msgstr ""
#: ../Doc/using/cmdline.rst:73
msgid ""
"Raises an :ref:`auditing event ` ``cpython.run_command`` with "
"argument ``command``."
msgstr ""
#: ../Doc/using/cmdline.rst:77
msgid ""
"Search :data:`sys.path` for the named module and execute its contents as "
"the :mod:`__main__` module."
msgstr ""
#: ../Doc/using/cmdline.rst:80
msgid ""
"Since the argument is a *module* name, you must not give a file extension "
"(``.py``). The module name should be a valid absolute Python module name, "
"but the implementation may not always enforce this (e.g. it may allow you to "
"use a name that includes a hyphen)."
msgstr ""
#: ../Doc/using/cmdline.rst:85
msgid ""
"Package names (including namespace packages) are also permitted. When a "
"package name is supplied instead of a normal module, the interpreter will "
"execute ``.__main__`` as the main module. This behaviour is "
"deliberately similar to the handling of directories and zipfiles that are "
"passed to the interpreter as the script argument."
msgstr ""
#: ../Doc/using/cmdline.rst:94
msgid ""
"This option cannot be used with built-in modules and extension modules "
"written in C, since they do not have Python module files. However, it can "
"still be used for precompiled modules, even if the original source file is "
"not available."
msgstr ""
#: ../Doc/using/cmdline.rst:99
msgid ""
"If this option is given, the first element of :data:`sys.argv` will be the "
"full path to the module file (while the module file is being located, the "
"first element will be set to ``\"-m\"``). As with the :option:`-c` option, "
"the current directory will be added to the start of :data:`sys.path`."
msgstr ""
#: ../Doc/using/cmdline.rst:104
msgid ""
":option:`-I` option can be used to run the script in isolated mode where :"
"data:`sys.path` contains neither the current directory nor the user's site-"
"packages directory. All :envvar:`PYTHON*` environment variables are ignored, "
"too."
msgstr ""
#: ../Doc/using/cmdline.rst:109
msgid ""
"Many standard library modules contain code that is invoked on their "
"execution as a script. An example is the :mod:`timeit` module::"
msgstr ""
#: ../Doc/using/cmdline.rst:116
msgid ""
"Raises an :ref:`auditing event ` ``cpython.run_module`` with "
"argument ``module-name``."
msgstr ""
#: ../Doc/using/cmdline.rst:119
msgid ":func:`runpy.run_module`"
msgstr ""
#: ../Doc/using/cmdline.rst:119 ../Doc/using/cmdline.rst:171
msgid "Equivalent functionality directly available to Python code"
msgstr ""
#: ../Doc/using/cmdline.rst:121
msgid ":pep:`338` -- Executing modules as scripts"
msgstr ""
#: ../Doc/using/cmdline.rst:123
msgid "Supply the package name to run a ``__main__`` submodule."
msgstr ""
#: ../Doc/using/cmdline.rst:126
msgid "namespace packages are also supported"
msgstr ""
#: ../Doc/using/cmdline.rst:133
msgid ""
"Read commands from standard input (:data:`sys.stdin`). If standard input is "
"a terminal, :option:`-i` is implied."
msgstr ""
#: ../Doc/using/cmdline.rst:136
msgid ""
"If this option is given, the first element of :data:`sys.argv` will be ``\"-"
"\"`` and the current directory will be added to the start of :data:`sys."
"path`."
msgstr ""
#: ../Doc/using/cmdline.rst:140
msgid ""
"Raises an :ref:`auditing event ` ``cpython.run_stdin`` with no "
"arguments."
msgstr ""
#: ../Doc/using/cmdline.rst:146
msgid ""
"Execute the Python code contained in *script*, which must be a filesystem "
"path (absolute or relative) referring to either a Python file, a directory "
"containing a ``__main__.py`` file, or a zipfile containing a ``__main__.py`` "
"file."
msgstr ""
#: ../Doc/using/cmdline.rst:151
msgid ""
"If this option is given, the first element of :data:`sys.argv` will be the "
"script name as given on the command line."
msgstr ""
#: ../Doc/using/cmdline.rst:154
msgid ""
"If the script name refers directly to a Python file, the directory "
"containing that file is added to the start of :data:`sys.path`, and the file "
"is executed as the :mod:`__main__` module."
msgstr ""
#: ../Doc/using/cmdline.rst:158
msgid ""
"If the script name refers to a directory or zipfile, the script name is "
"added to the start of :data:`sys.path` and the ``__main__.py`` file in that "
"location is executed as the :mod:`__main__` module."
msgstr ""
#: ../Doc/using/cmdline.rst:162
msgid ""
":option:`-I` option can be used to run the script in isolated mode where :"
"data:`sys.path` contains neither the script's directory nor the user's site-"
"packages directory. All :envvar:`PYTHON*` environment variables are ignored, "
"too."
msgstr ""
#: ../Doc/using/cmdline.rst:168
msgid ""
"Raises an :ref:`auditing event ` ``cpython.run_file`` with "
"argument ``filename``."
msgstr ""
#: ../Doc/using/cmdline.rst:170
msgid ":func:`runpy.run_path`"
msgstr ""
#: ../Doc/using/cmdline.rst:174
msgid ""
"If no interface option is given, :option:`-i` is implied, ``sys.argv[0]`` is "
"an empty string (``\"\"``) and the current directory will be added to the "
"start of :data:`sys.path`. Also, tab-completion and history editing is "
"automatically enabled, if available on your platform (see :ref:`rlcompleter-"
"config`)."
msgstr ""
#: ../Doc/using/cmdline.rst:180
msgid ":ref:`tut-invoking`"
msgstr ""
#: ../Doc/using/cmdline.rst:182
msgid "Automatic enabling of tab-completion and history editing."
msgstr ""
#: ../Doc/using/cmdline.rst:187
msgid "Generic options"
msgstr ""
#: ../Doc/using/cmdline.rst:193
msgid "Print a short description of all command line options."
msgstr ""
#: ../Doc/using/cmdline.rst:199
msgid "Print the Python version number and exit. Example output could be:"
msgstr ""
#: ../Doc/using/cmdline.rst:205
msgid "When given twice, print more information about the build, like:"
msgstr ""
#: ../Doc/using/cmdline.rst:212
msgid "The ``-VV`` option."
msgstr ""
#: ../Doc/using/cmdline.rst:218
msgid "Miscellaneous options"
msgstr ""
#: ../Doc/using/cmdline.rst:222
msgid ""
"Issue a warning when comparing :class:`bytes` or :class:`bytearray` with :"
"class:`str` or :class:`bytes` with :class:`int`. Issue an error when the "
"option is given twice (:option:`!-bb`)."
msgstr ""
#: ../Doc/using/cmdline.rst:226
msgid "Affects comparisons of :class:`bytes` with :class:`int`."
msgstr ""
#: ../Doc/using/cmdline.rst:231
msgid ""
"If given, Python won't try to write ``.pyc`` files on the import of source "
"modules. See also :envvar:`PYTHONDONTWRITEBYTECODE`."
msgstr ""
#: ../Doc/using/cmdline.rst:237
msgid ""
"Control the validation behavior of hash-based ``.pyc`` files. See :ref:`pyc-"
"invalidation`. When set to ``default``, checked and unchecked hash-based "
"bytecode cache files are validated according to their default semantics. "
"When set to ``always``, all hash-based ``.pyc`` files, whether checked or "
"unchecked, are validated against their corresponding source file. When set "
"to ``never``, hash-based ``.pyc`` files are not validated against their "
"corresponding source files."
msgstr ""
#: ../Doc/using/cmdline.rst:245
msgid ""
"The semantics of timestamp-based ``.pyc`` files are unaffected by this "
"option."
msgstr ""
#: ../Doc/using/cmdline.rst:251
msgid ""
"Turn on parser debugging output (for expert only, depending on compilation "
"options). See also :envvar:`PYTHONDEBUG`."
msgstr ""
#: ../Doc/using/cmdline.rst:257
msgid ""
"Ignore all :envvar:`PYTHON*` environment variables, e.g. :envvar:"
"`PYTHONPATH` and :envvar:`PYTHONHOME`, that might be set."
msgstr ""
#: ../Doc/using/cmdline.rst:263
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. The :envvar:"
"`PYTHONSTARTUP` file is not read."
msgstr ""
#: ../Doc/using/cmdline.rst:268
msgid ""
"This can be useful to inspect global variables or a stack trace when a "
"script raises an exception. See also :envvar:`PYTHONINSPECT`."
msgstr ""
#: ../Doc/using/cmdline.rst:274
msgid ""
"Run Python in isolated mode. This also implies -E and -s. In isolated mode :"
"data:`sys.path` contains neither the script's directory nor the user's site-"
"packages directory. All :envvar:`PYTHON*` environment variables are ignored, "
"too. Further restrictions may be imposed to prevent the user from injecting "
"malicious code."
msgstr ""
#: ../Doc/using/cmdline.rst:285
msgid ""
"Remove assert statements and any code conditional on the value of :const:"
"`__debug__`. Augment the filename for compiled (:term:`bytecode`) files by "
"adding ``.opt-1`` before the ``.pyc`` extension (see :pep:`488`). See also :"
"envvar:`PYTHONOPTIMIZE`."
msgstr ""
#: ../Doc/using/cmdline.rst:290 ../Doc/using/cmdline.rst:300
msgid "Modify ``.pyc`` filenames according to :pep:`488`."
msgstr ""
#: ../Doc/using/cmdline.rst:296
msgid ""
"Do :option:`-O` and also discard docstrings. Augment the filename for "
"compiled (:term:`bytecode`) files by adding ``.opt-2`` before the ``.pyc`` "
"extension (see :pep:`488`)."
msgstr ""
#: ../Doc/using/cmdline.rst:306
msgid ""
"Don't display the copyright and version messages even in interactive mode."
msgstr ""
#: ../Doc/using/cmdline.rst:313
msgid ""
"Turn on hash randomization. This option only has an effect if the :envvar:"
"`PYTHONHASHSEED` environment variable is set to ``0``, since hash "
"randomization is enabled by default."
msgstr ""
#: ../Doc/using/cmdline.rst:317
msgid ""
"On previous versions of Python, this option turns on hash randomization, so "
"that the :meth:`__hash__` values of str and bytes objects are \"salted\" "
"with an unpredictable random value. Although they remain constant within an "
"individual Python process, they are not predictable between repeated "
"invocations of Python."
msgstr ""
#: ../Doc/using/cmdline.rst:323
msgid ""
"Hash randomization is intended to provide protection against a denial-of-"
"service caused by carefully-chosen inputs that exploit the worst case "
"performance of a dict construction, O(n^2) complexity. See http://www.ocert."
"org/advisories/ocert-2011-003.html for details."
msgstr ""
#: ../Doc/using/cmdline.rst:328
msgid ""
":envvar:`PYTHONHASHSEED` allows you to set a fixed value for the hash seed "
"secret."
msgstr ""
#: ../Doc/using/cmdline.rst:331
msgid "The option is no longer ignored."
msgstr ""
#: ../Doc/using/cmdline.rst:339
msgid ""
"Don't add the :data:`user site-packages directory ` to :data:"
"`sys.path`."
msgstr ""
#: ../Doc/using/cmdline.rst:344 ../Doc/using/cmdline.rst:675
#: ../Doc/using/cmdline.rst:687
msgid ":pep:`370` -- Per user site-packages directory"
msgstr ""
#: ../Doc/using/cmdline.rst:349
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 ""
#: ../Doc/using/cmdline.rst:357
msgid ""
"Force the stdout and stderr streams to be unbuffered. This option has no "
"effect on the stdin stream."
msgstr ""
#: ../Doc/using/cmdline.rst:360
msgid "See also :envvar:`PYTHONUNBUFFERED`."
msgstr ""
#: ../Doc/using/cmdline.rst:362
msgid "The text layer of the stdout and stderr streams now is unbuffered."
msgstr ""
#: ../Doc/using/cmdline.rst:368
msgid ""
"Print a message each time a module is initialized, showing the place "
"(filename or built-in module) from which it is loaded. When given twice (:"
"option:`!-vv`), print a message for each file that is checked for when "
"searching for a module. Also provides information on module cleanup at "
"exit. See also :envvar:`PYTHONVERBOSE`."
msgstr ""
#: ../Doc/using/cmdline.rst:378
msgid ""
"Warning control. Python's warning machinery by default prints warning "
"messages to :data:`sys.stderr`. A typical warning message has the following "
"form:"
msgstr ""
#: ../Doc/using/cmdline.rst:386
msgid ""
"By default, each warning is printed once for each source line where it "
"occurs. This option controls how often warnings are printed."
msgstr ""
#: ../Doc/using/cmdline.rst:389
msgid ""
"Multiple :option:`-W` options may be given; when a warning matches more than "
"one option, the action for the last matching option is performed. Invalid :"
"option:`-W` options are ignored (though, a warning message is printed about "
"invalid options when the first warning is issued)."
msgstr ""
#: ../Doc/using/cmdline.rst:394
msgid ""
"Warnings can also be controlled using the :envvar:`PYTHONWARNINGS` "
"environment variable and from within a Python program using the :mod:"
"`warnings` module."
msgstr ""
#: ../Doc/using/cmdline.rst:398 ../Doc/using/cmdline.rst:703
msgid ""
"The simplest settings apply a particular action unconditionally to all "
"warnings emitted by a process (even those that are otherwise ignored by "
"default)::"
msgstr ""
#: ../Doc/using/cmdline.rst:409
msgid ""
"The action names can be abbreviated as desired (e.g. ``-Wi``, ``-Wd``, ``-"
"Wa``, ``-We``) and the interpreter will resolve them to the appropriate "
"action name."
msgstr ""
#: ../Doc/using/cmdline.rst:413 ../Doc/using/cmdline.rst:714
msgid ""
"See :ref:`warning-filter` and :ref:`describing-warning-filters` for more "
"details."
msgstr ""
#: ../Doc/using/cmdline.rst:419
msgid ""
"Skip the first line of the source, allowing use of non-Unix forms of ``#!"
"cmd``. This is intended for a DOS specific hack only."
msgstr ""
#: ../Doc/using/cmdline.rst:425
msgid ""
"Reserved for various implementation-specific options. CPython currently "
"defines the following possible values:"
msgstr ""
#: ../Doc/using/cmdline.rst:428
msgid "``-X faulthandler`` to enable :mod:`faulthandler`;"
msgstr ""
#: ../Doc/using/cmdline.rst:429
msgid ""
"``-X showrefcount`` to output the total reference count and number of used "
"memory blocks when the program finishes or after each statement in the "
"interactive interpreter. This only works on debug builds."
msgstr ""
#: ../Doc/using/cmdline.rst:432
msgid ""
"``-X tracemalloc`` to start tracing Python memory allocations using the :mod:"
"`tracemalloc` module. By default, only the most recent frame is stored in a "
"traceback of a trace. Use ``-X tracemalloc=NFRAME`` to start tracing with a "
"traceback limit of *NFRAME* frames. See the :func:`tracemalloc.start` for "
"more information."
msgstr ""
#: ../Doc/using/cmdline.rst:437
msgid ""
"``-X showalloccount`` to output the total count of allocated objects for "
"each type when the program finishes. This only works when Python was built "
"with ``COUNT_ALLOCS`` defined."
msgstr ""
#: ../Doc/using/cmdline.rst:440
msgid ""
"``-X importtime`` to show how long each import takes. It shows module name, "
"cumulative time (including nested imports) and self time (excluding nested "
"imports). Note that its output may be broken in multi-threaded "
"application. Typical usage is ``python3 -X importtime -c 'import "
"asyncio'``. See also :envvar:`PYTHONPROFILEIMPORTTIME`."
msgstr ""
#: ../Doc/using/cmdline.rst:445
msgid ""
"``-X dev``: enable CPython's \"development mode\", introducing additional "
"runtime checks which are too expensive to be enabled by default. It should "
"not be more verbose than the default if the code is correct: new warnings "
"are only emitted when an issue is detected. Effect of the developer mode:"
msgstr ""
#: ../Doc/using/cmdline.rst:450
msgid "Add ``default`` warning filter, as :option:`-W` ``default``."
msgstr ""
#: ../Doc/using/cmdline.rst:451
msgid ""
"Install debug hooks on memory allocators: see the :c:func:"
"`PyMem_SetupDebugHooks` C function."
msgstr ""
#: ../Doc/using/cmdline.rst:453
msgid ""
"Enable the :mod:`faulthandler` module to dump the Python traceback on a "
"crash."
msgstr ""
#: ../Doc/using/cmdline.rst:455
msgid "Enable :ref:`asyncio debug mode `."
msgstr ""
#: ../Doc/using/cmdline.rst:456
msgid ""
"Set the :attr:`~sys.flags.dev_mode` attribute of :attr:`sys.flags` to "
"``True``."
msgstr ""
#: ../Doc/using/cmdline.rst:458
msgid ":class:`io.IOBase` destructor logs ``close()`` exceptions."
msgstr ""
#: ../Doc/using/cmdline.rst:460
msgid ""
"``-X utf8`` enables UTF-8 mode for operating system interfaces, overriding "
"the default locale-aware mode. ``-X utf8=0`` explicitly disables UTF-8 mode "
"(even when it would otherwise activate automatically). See :envvar:"
"`PYTHONUTF8` for more details."
msgstr ""
#: ../Doc/using/cmdline.rst:464
msgid ""
"``-X pycache_prefix=PATH`` enables writing ``.pyc`` files to a parallel tree "
"rooted at the given directory instead of to the code tree. See also :envvar:"
"`PYTHONPYCACHEPREFIX`."
msgstr ""
#: ../Doc/using/cmdline.rst:468
msgid ""
"It also allows passing arbitrary values and retrieving them through the :"
"data:`sys._xoptions` dictionary."
msgstr ""
#: ../Doc/using/cmdline.rst:471
msgid "The :option:`-X` option was added."
msgstr ""
#: ../Doc/using/cmdline.rst:474
msgid "The ``-X faulthandler`` option."
msgstr ""
#: ../Doc/using/cmdline.rst:477
msgid "The ``-X showrefcount`` and ``-X tracemalloc`` options."
msgstr ""
#: ../Doc/using/cmdline.rst:480
msgid "The ``-X showalloccount`` option."
msgstr ""
#: ../Doc/using/cmdline.rst:483
msgid "The ``-X importtime``, ``-X dev`` and ``-X utf8`` options."
msgstr ""
#: ../Doc/using/cmdline.rst:486
msgid ""
"The ``-X pycache_prefix`` option. The ``-X dev`` option now logs ``close()`` "
"exceptions in :class:`io.IOBase` destructor."
msgstr ""
#: ../Doc/using/cmdline.rst:492
msgid "Options you shouldn't use"
msgstr ""
#: ../Doc/using/cmdline.rst:496
msgid "Reserved for use by Jython_."
msgstr ""
#: ../Doc/using/cmdline.rst:504
msgid "Environment variables"
msgstr ""
#: ../Doc/using/cmdline.rst:506
msgid ""
"These environment variables influence Python's behavior, they are processed "
"before the command-line switches other than -E or -I. It is customary that "
"command-line switches override environmental variables where there is a "
"conflict."
msgstr ""
#: ../Doc/using/cmdline.rst:513
msgid ""
"Change the location of the standard Python libraries. By default, the "
"libraries are searched in :file:`{prefix}/lib/python{version}` and :file:"
"`{exec_prefix}/lib/python{version}`, where :file:`{prefix}` and :file:"
"`{exec_prefix}` are installation-dependent directories, both defaulting to :"
"file:`/usr/local`."
msgstr ""
#: ../Doc/using/cmdline.rst:519
msgid ""
"When :envvar:`PYTHONHOME` is set to a single directory, its value replaces "
"both :file:`{prefix}` and :file:`{exec_prefix}`. To specify different "
"values for these, set :envvar:`PYTHONHOME` to :file:`{prefix}:{exec_prefix}`."
msgstr ""
#: ../Doc/using/cmdline.rst:526
msgid ""
"Augment the default search path for module files. The format is the same as "
"the shell's :envvar:`PATH`: one or more directory pathnames separated by :"
"data:`os.pathsep` (e.g. colons on Unix or semicolons on Windows). Non-"
"existent directories are silently ignored."
msgstr ""
#: ../Doc/using/cmdline.rst:531
msgid ""
"In addition to normal directories, individual :envvar:`PYTHONPATH` entries "
"may refer to zipfiles containing pure Python modules (in either source or "
"compiled form). Extension modules cannot be imported from zipfiles."
msgstr ""
#: ../Doc/using/cmdline.rst:535
msgid ""
"The default search path is installation dependent, but generally begins "
"with :file:`{prefix}/lib/python{version}` (see :envvar:`PYTHONHOME` above). "
"It is *always* appended to :envvar:`PYTHONPATH`."
msgstr ""
#: ../Doc/using/cmdline.rst:539
msgid ""
"An additional directory will be inserted in the search path in front of :"
"envvar:`PYTHONPATH` as described above under :ref:`using-on-interface-"
"options`. The search path can be manipulated from within a Python program as "
"the variable :data:`sys.path`."
msgstr ""
#: ../Doc/using/cmdline.rst:547
msgid ""
"If this is the name of a readable file, the Python commands in that file are "
"executed before the first prompt is displayed in interactive mode. The file "
"is executed in the same namespace where interactive commands are executed so "
"that objects defined or imported in it can be used without qualification in "
"the interactive session. You can also change the prompts :data:`sys.ps1` "
"and :data:`sys.ps2` and the hook :data:`sys.__interactivehook__` in this "
"file."
msgstr ""
msgid ""
"Raises an :ref:`auditing event ` ``cpython.run_startup`` with "
"argument ``filename``."
msgstr ""
#: ../Doc/using/cmdline.rst:556
msgid ""
"Raises an :ref:`auditing event ` ``cpython.run_startup`` with the "
"filename as the argument when called on startup."
msgstr ""
#: ../Doc/using/cmdline.rst:562
msgid ""
"If this is set to a non-empty string it is equivalent to specifying the :"
"option:`-O` option. If set to an integer, it is equivalent to specifying :"
"option:`-O` multiple times."
msgstr ""
#: ../Doc/using/cmdline.rst:569
msgid ""
"If this is set, it names a callable using dotted-path notation. The module "
"containing the callable will be imported and then the callable will be run "
"by the default implementation of :func:`sys.breakpointhook` which itself is "
"called by built-in :func:`breakpoint`. If not set, or set to the empty "
"string, it is equivalent to the value \"pdb.set_trace\". Setting this to "
"the string \"0\" causes the default implementation of :func:`sys."
"breakpointhook` to do nothing but return immediately."
msgstr ""
#: ../Doc/using/cmdline.rst:581
msgid ""
"If this is set to a non-empty string it is equivalent to specifying the :"
"option:`-d` option. If set to an integer, it is equivalent to specifying :"
"option:`-d` multiple times."
msgstr ""
#: ../Doc/using/cmdline.rst:588
msgid ""
"If this is set to a non-empty string it is equivalent to specifying the :"
"option:`-i` option."
msgstr ""
#: ../Doc/using/cmdline.rst:591
msgid ""
"This variable can also be modified by Python code using :data:`os.environ` "
"to force inspect mode on program termination."
msgstr ""
#: ../Doc/using/cmdline.rst:597
msgid ""
"If this is set to a non-empty string it is equivalent to specifying the :"
"option:`-u` option."
msgstr ""
#: ../Doc/using/cmdline.rst:603
msgid ""
"If this is set to a non-empty string it is equivalent to specifying the :"
"option:`-v` option. If set to an integer, it is equivalent to specifying :"
"option:`-v` multiple times."
msgstr ""
#: ../Doc/using/cmdline.rst:610
msgid ""
"If this is set, Python ignores case in :keyword:`import` statements. This "
"only works on Windows and OS X."
msgstr ""
#: ../Doc/using/cmdline.rst:616
msgid ""
"If this is set to a non-empty string, Python won't try to write ``.pyc`` "
"files on the import of source modules. This is equivalent to specifying "
"the :option:`-B` option."
msgstr ""
#: ../Doc/using/cmdline.rst:623
msgid ""
"If this is set, Python will write ``.pyc`` files in a mirror directory tree "
"at this path, instead of in ``__pycache__`` directories within the source "
"tree. This is equivalent to specifying the :option:`-X` "
"``pycache_prefix=PATH`` option."
msgstr ""
#: ../Doc/using/cmdline.rst:633
msgid ""
"If this variable is not set or set to ``random``, a random value is used to "
"seed the hashes of str and bytes objects."
msgstr ""
#: ../Doc/using/cmdline.rst:636
msgid ""
"If :envvar:`PYTHONHASHSEED` is set to an integer value, it is used as a "
"fixed seed for generating the hash() of the types covered by the hash "
"randomization."
msgstr ""
#: ../Doc/using/cmdline.rst:640
msgid ""
"Its purpose is to allow repeatable hashing, such as for selftests for the "
"interpreter itself, or to allow a cluster of python processes to share hash "
"values."
msgstr ""
#: ../Doc/using/cmdline.rst:644
msgid ""
"The integer must be a decimal number in the range [0,4294967295]. "
"Specifying the value 0 will disable hash randomization."
msgstr ""
#: ../Doc/using/cmdline.rst:652
msgid ""
"If this is set before running the interpreter, it overrides the encoding "
"used for stdin/stdout/stderr, in the syntax ``encodingname:errorhandler``. "
"Both the ``encodingname`` and the ``:errorhandler`` parts are optional and "
"have the same meaning as in :func:`str.encode`."
msgstr ""
#: ../Doc/using/cmdline.rst:657
msgid ""
"For stderr, the ``:errorhandler`` part is ignored; the handler will always "
"be ``'backslashreplace'``."
msgstr ""
#: ../Doc/using/cmdline.rst:660
msgid "The ``encodingname`` part is now optional."
msgstr ""
#: ../Doc/using/cmdline.rst:663
msgid ""
"On Windows, the encoding specified by this variable is ignored for "
"interactive console buffers unless :envvar:`PYTHONLEGACYWINDOWSSTDIO` is "
"also specified. Files and pipes redirected through the standard streams are "
"not affected."
msgstr ""
#: ../Doc/using/cmdline.rst:670
msgid ""
"If this is set, Python won't add the :data:`user site-packages directory "
"` to :data:`sys.path`."
msgstr ""
#: ../Doc/using/cmdline.rst:680
msgid ""
"Defines the :data:`user base directory `, which is used to "
"compute the path of the :data:`user site-packages directory ` and :ref:`Distutils installation paths ` "
"for ``python setup.py install --user``."
msgstr ""
#: ../Doc/using/cmdline.rst:692
msgid ""
"If this environment variable is set, ``sys.argv[0]`` will be set to its "
"value instead of the value got through the C runtime. Only works on Mac OS "
"X."
msgstr ""
#: ../Doc/using/cmdline.rst:698
msgid ""
"This is equivalent to the :option:`-W` option. If set to a comma separated "
"string, it is equivalent to specifying :option:`-W` multiple times, with "
"filters later in the list taking precedence over those earlier in the list."
msgstr ""
#: ../Doc/using/cmdline.rst:720
msgid ""
"If this environment variable is set to a non-empty string, :func:"
"`faulthandler.enable` is called at startup: install a handler for :const:"
"`SIGSEGV`, :const:`SIGFPE`, :const:`SIGABRT`, :const:`SIGBUS` and :const:"
"`SIGILL` signals to dump the Python traceback. This is equivalent to :"
"option:`-X` ``faulthandler`` option."
msgstr ""
#: ../Doc/using/cmdline.rst:731
msgid ""
"If this environment variable is set to a non-empty string, start tracing "
"Python memory allocations using the :mod:`tracemalloc` module. The value of "
"the variable is the maximum number of frames stored in a traceback of a "
"trace. For example, ``PYTHONTRACEMALLOC=1`` stores only the most recent "
"frame. See the :func:`tracemalloc.start` for more information."
msgstr ""
#: ../Doc/using/cmdline.rst:742
msgid ""
"If this environment variable is set to a non-empty string, Python will show "
"how long each import takes. This is exactly equivalent to setting ``-X "
"importtime`` on the command line."
msgstr ""
#: ../Doc/using/cmdline.rst:751
msgid ""
"If this environment variable is set to a non-empty string, enable the :ref:"
"`debug mode ` of the :mod:`asyncio` module."
msgstr ""
#: ../Doc/using/cmdline.rst:759
msgid "Set the Python memory allocators and/or install debug hooks."
msgstr ""
#: ../Doc/using/cmdline.rst:761
msgid "Set the family of memory allocators used by Python:"
msgstr ""
#: ../Doc/using/cmdline.rst:763
msgid ""
"``default``: use the :ref:`default memory allocators `."
msgstr ""
#: ../Doc/using/cmdline.rst:765
msgid ""
"``malloc``: use the :c:func:`malloc` function of the C library for all "
"domains (:c:data:`PYMEM_DOMAIN_RAW`, :c:data:`PYMEM_DOMAIN_MEM`, :c:data:"
"`PYMEM_DOMAIN_OBJ`)."
msgstr ""
#: ../Doc/using/cmdline.rst:768
msgid ""
"``pymalloc``: use the :ref:`pymalloc allocator ` for :c:data:"
"`PYMEM_DOMAIN_MEM` and :c:data:`PYMEM_DOMAIN_OBJ` domains and use the :c:"
"func:`malloc` function for the :c:data:`PYMEM_DOMAIN_RAW` domain."
msgstr ""
#: ../Doc/using/cmdline.rst:772
msgid "Install debug hooks:"
msgstr ""
#: ../Doc/using/cmdline.rst:774
msgid ""
"``debug``: install debug hooks on top of the :ref:`default memory allocators "
"`."
msgstr ""
#: ../Doc/using/cmdline.rst:776
msgid "``malloc_debug``: same as ``malloc`` but also install debug hooks."
msgstr ""
#: ../Doc/using/cmdline.rst:777
msgid "``pymalloc_debug``: same as ``pymalloc`` but also install debug hooks."
msgstr ""
#: ../Doc/using/cmdline.rst:779
msgid ""
"See the :ref:`default memory allocators ` and "
"the :c:func:`PyMem_SetupDebugHooks` function (install debug hooks on Python "
"memory allocators)."
msgstr ""
#: ../Doc/using/cmdline.rst:783
msgid "Added the ``\"default\"`` allocator."
msgstr ""
#: ../Doc/using/cmdline.rst:791
msgid ""
"If set to a non-empty string, Python will print statistics of the :ref:"
"`pymalloc memory allocator ` every time a new pymalloc object "
"arena is created, and on shutdown."
msgstr ""
#: ../Doc/using/cmdline.rst:795
msgid ""
"This variable is ignored if the :envvar:`PYTHONMALLOC` environment variable "
"is used to force the :c:func:`malloc` allocator of the C library, or if "
"Python is configured without ``pymalloc`` support."
msgstr ""
#: ../Doc/using/cmdline.rst:799
msgid ""
"This variable can now also be used on Python compiled in release mode. It "
"now has no effect if set to an empty string."
msgstr ""
#: ../Doc/using/cmdline.rst:806
msgid ""
"If set to a non-empty string, the default filesystem encoding and errors "
"mode will revert to their pre-3.6 values of 'mbcs' and 'replace', "
"respectively. Otherwise, the new defaults 'utf-8' and 'surrogatepass' are "
"used."
msgstr ""
#: ../Doc/using/cmdline.rst:810
msgid ""
"This may also be enabled at runtime with :func:`sys."
"_enablelegacywindowsfsencoding()`."
msgstr ""
#: ../Doc/using/cmdline.rst:814 ../Doc/using/cmdline.rst:828
msgid ":ref:`Availability `: Windows."
msgstr ""
#: ../Doc/using/cmdline.rst:815
msgid "See :pep:`529` for more details."
msgstr ""
#: ../Doc/using/cmdline.rst:820
msgid ""
"If set to a non-empty string, does not use the new console reader and "
"writer. This means that Unicode characters will be encoded according to the "
"active console code page, rather than using utf-8."
msgstr ""
#: ../Doc/using/cmdline.rst:824
msgid ""
"This variable is ignored if the standard streams are redirected (to files or "
"pipes) rather than referring to console buffers."
msgstr ""
#: ../Doc/using/cmdline.rst:834
msgid ""
"If set to the value ``0``, causes the main Python command line application "
"to skip coercing the legacy ASCII-based C and POSIX locales to a more "
"capable UTF-8 based alternative."
msgstr ""
#: ../Doc/using/cmdline.rst:838
msgid ""
"If this variable is *not* set (or is set to a value other than ``0``), the "
"``LC_ALL`` locale override environment variable is also not set, and the "
"current locale reported for the ``LC_CTYPE`` category is either the default "
"``C`` locale, or else the explicitly ASCII-based ``POSIX`` locale, then the "
"Python CLI will attempt to configure the following locales for the "
"``LC_CTYPE`` category in the order listed before loading the interpreter "
"runtime:"
msgstr ""
#: ../Doc/using/cmdline.rst:846
msgid "``C.UTF-8``"
msgstr ""
#: ../Doc/using/cmdline.rst:847
msgid "``C.utf8``"
msgstr ""
#: ../Doc/using/cmdline.rst:848
msgid "``UTF-8``"
msgstr ""
#: ../Doc/using/cmdline.rst:850
msgid ""
"If setting one of these locale categories succeeds, then the ``LC_CTYPE`` "
"environment variable will also be set accordingly in the current process "
"environment before the Python runtime is initialized. This ensures that in "
"addition to being seen by both the interpreter itself and other locale-aware "
"components running in the same process (such as the GNU ``readline`` "
"library), the updated setting is also seen in subprocesses (regardless of "
"whether or not those processes are running a Python interpreter), as well as "
"in operations that query the environment rather than the current C locale "
"(such as Python's own :func:`locale.getdefaultlocale`)."
msgstr ""
#: ../Doc/using/cmdline.rst:860
msgid ""
"Configuring one of these locales (either explicitly or via the above "
"implicit locale coercion) automatically enables the ``surrogateescape`` :ref:"
"`error handler ` for :data:`sys.stdin` and :data:`sys."
"stdout` (:data:`sys.stderr` continues to use ``backslashreplace`` as it does "
"in any other locale). This stream handling behavior can be overridden using :"
"envvar:`PYTHONIOENCODING` as usual."
msgstr ""
#: ../Doc/using/cmdline.rst:867
msgid ""
"For debugging purposes, setting ``PYTHONCOERCECLOCALE=warn`` will cause "
"Python to emit warning messages on ``stderr`` if either the locale coercion "
"activates, or else if a locale that *would* have triggered coercion is still "
"active when the Python runtime is initialized."
msgstr ""
#: ../Doc/using/cmdline.rst:872
msgid ""
"Also note that even when locale coercion is disabled, or when it fails to "
"find a suitable target locale, :envvar:`PYTHONUTF8` will still activate by "
"default in legacy ASCII-based locales. Both features must be disabled in "
"order to force the interpreter to use ``ASCII`` instead of ``UTF-8`` for "
"system interfaces."
msgstr ""
#: ../Doc/using/cmdline.rst:879
msgid ":ref:`Availability `: \\*nix."
msgstr ""
#: ../Doc/using/cmdline.rst:880
msgid "See :pep:`538` for more details."
msgstr ""
#: ../Doc/using/cmdline.rst:886
msgid ""
"If this environment variable is set to a non-empty string, enable the "
"CPython \"development mode\". See the :option:`-X` ``dev`` option."
msgstr ""
#: ../Doc/using/cmdline.rst:893
msgid ""
"If set to ``1``, enables the interpreter's UTF-8 mode, where ``UTF-8`` is "
"used as the text encoding for system interfaces, regardless of the current "
"locale setting."
msgstr ""
#: ../Doc/using/cmdline.rst:897
msgid "This means that:"
msgstr ""
#: ../Doc/using/cmdline.rst:899
msgid ""
":func:`sys.getfilesystemencoding()` returns ``'UTF-8'`` (the locale encoding "
"is ignored)."
msgstr ""
#: ../Doc/using/cmdline.rst:901
msgid ""
":func:`locale.getpreferredencoding()` returns ``'UTF-8'`` (the locale "
"encoding is ignored, and the function's ``do_setlocale`` parameter has no "
"effect)."
msgstr ""
#: ../Doc/using/cmdline.rst:904
msgid ""
":data:`sys.stdin`, :data:`sys.stdout`, and :data:`sys.stderr` all use UTF-8 "
"as their text encoding, with the ``surrogateescape`` :ref:`error handler "
"` being enabled for :data:`sys.stdin` and :data:`sys.stdout` "
"(:data:`sys.stderr` continues to use ``backslashreplace`` as it does in the "
"default locale-aware mode)"
msgstr ""
#: ../Doc/using/cmdline.rst:910
msgid ""
"As a consequence of the changes in those lower level APIs, other higher "
"level APIs also exhibit different default behaviours:"
msgstr ""
#: ../Doc/using/cmdline.rst:913
msgid ""
"Command line arguments, environment variables and filenames are decoded to "
"text using the UTF-8 encoding."
msgstr ""
#: ../Doc/using/cmdline.rst:915
msgid ":func:`os.fsdecode()` and :func:`os.fsencode()` use the UTF-8 encoding."
msgstr ""
#: ../Doc/using/cmdline.rst:916
msgid ""
":func:`open()`, :func:`io.open()`, and :func:`codecs.open()` use the UTF-8 "
"encoding by default. However, they still use the strict error handler by "
"default so that attempting to open a binary file in text mode is likely to "
"raise an exception rather than producing nonsense data."
msgstr ""
#: ../Doc/using/cmdline.rst:921
msgid ""
"Note that the standard stream settings in UTF-8 mode can be overridden by :"
"envvar:`PYTHONIOENCODING` (just as they can be in the default locale-aware "
"mode)."
msgstr ""
#: ../Doc/using/cmdline.rst:925
msgid "If set to ``0``, the interpreter runs in its default locale-aware mode."
msgstr ""
#: ../Doc/using/cmdline.rst:927
msgid ""
"Setting any other non-empty string causes an error during interpreter "
"initialisation."
msgstr ""
#: ../Doc/using/cmdline.rst:930
msgid ""
"If this environment variable is not set at all, then the interpreter "
"defaults to using the current locale settings, *unless* the current locale "
"is identified as a legacy ASCII-based locale (as described for :envvar:"
"`PYTHONCOERCECLOCALE`), and locale coercion is either disabled or fails. In "
"such legacy locales, the interpreter will default to enabling UTF-8 mode "
"unless explicitly instructed not to do so."
msgstr ""
#: ../Doc/using/cmdline.rst:937
msgid "Also available as the :option:`-X` ``utf8`` option."
msgstr ""
#: ../Doc/using/cmdline.rst:939
msgid "See :pep:`540` for more details."
msgstr ""
#: ../Doc/using/cmdline.rst:944
msgid "Debug-mode variables"
msgstr ""
#: ../Doc/using/cmdline.rst:946
msgid "Setting these variables only has an effect in a debug build of Python."
msgstr ""
#: ../Doc/using/cmdline.rst:950
msgid "If set, Python will print threading debug info."
msgstr ""
#: ../Doc/using/cmdline.rst:952
msgid "Need Python configured with the ``--with-pydebug`` build option."
msgstr ""
#: ../Doc/using/cmdline.rst:957
msgid ""
"If set, Python will dump objects and reference counts still alive after "
"shutting down the interpreter."
msgstr ""
#: ../Doc/using/cmdline.rst:960
msgid "Need Python configured with the ``--with-trace-refs`` build option."
msgstr ""