# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001-2018, Python Software Foundation

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

#

# Translators:

msgid ""

msgstr ""

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

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

"POT-Creation-Date: 2021-09-29 00:11+0000\n"

"PO-Revision-Date: 2018-05-23 16:19+0000\n"

"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"

"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"

"tw)\n"

"Language: zh_TW\n"

"MIME-Version: 1.0\n"

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

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

"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../using/cmdline.rst:9

msgid "Command line and environment"

msgstr ""

#: ../../using/cmdline.rst:11

msgid ""

"The CPython interpreter scans the command line and the environment for "

"various settings."

msgstr ""

#: ../../using/cmdline.rst:16

msgid ""

"Other implementations' command line schemes may differ. See :ref:"

"`implementations` for further resources."

msgstr ""

#: ../../using/cmdline.rst:23

msgid "Command line"

msgstr ""

#: ../../using/cmdline.rst:25

msgid "When invoking Python, you may specify any of these options::"

msgstr ""

#: ../../using/cmdline.rst:29

msgid ""

"The most common use case is, of course, a simple invocation of a script::"

msgstr ""

#: ../../using/cmdline.rst:37

msgid "Interface options"

msgstr ""

#: ../../using/cmdline.rst:39

msgid ""

"The interpreter interface resembles that of the UNIX shell, but provides "

"some additional methods of invocation:"

msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../using/cmdline.rst:47

msgid ""

"When called with a directory name argument, it reads and executes an "

"appropriately named script from that directory."

msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../using/cmdline.rst:55

msgid ""

"In non-interactive mode, the entire input is parsed before it is executed."

msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../using/cmdline.rst:73

msgid ""

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

"argument ``command``."

msgstr ""

#: ../../using/cmdline.rst:77

msgid ""

"Search :data:`sys.path` for the named module and execute its contents as "

"the :mod:`__main__` module."

msgstr ""

#: ../../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 ""

#: ../../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 ``<pkg>.__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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../using/cmdline.rst:115

msgid ""

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

"argument ``module-name``."

msgstr ""

#: ../../using/cmdline.rst:119

msgid ":func:`runpy.run_module`"

msgstr ""

#: ../../using/cmdline.rst:119 ../../using/cmdline.rst:171

msgid "Equivalent functionality directly available to Python code"

msgstr ""

#: ../../using/cmdline.rst:121

msgid ":pep:`338` -- Executing modules as scripts"

msgstr ""

#: ../../using/cmdline.rst:123

msgid "Supply the package name to run a ``__main__`` submodule."

msgstr ""

#: ../../using/cmdline.rst:126

msgid "namespace packages are also supported"

msgstr ""

#: ../../using/cmdline.rst:133

msgid ""

"Read commands from standard input (:data:`sys.stdin`). If standard input is "

"a terminal, :option:`-i` is implied."

msgstr ""

#: ../../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 ""

#: ../../using/cmdline.rst:140

msgid ""

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

"arguments."

msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../using/cmdline.rst:167

msgid ""

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

"argument ``filename``."

msgstr ""

#: ../../using/cmdline.rst:170

msgid ":func:`runpy.run_path`"

msgstr ""

#: ../../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 ""

#: ../../using/cmdline.rst:180

msgid ":ref:`tut-invoking`"

msgstr ""

#: ../../using/cmdline.rst:182

msgid "Automatic enabling of tab-completion and history editing."

msgstr ""

#: ../../using/cmdline.rst:187

msgid "Generic options"

msgstr ""

#: ../../using/cmdline.rst:193

msgid "Print a short description of all command line options."

msgstr ""

#: ../../using/cmdline.rst:199

msgid "Print the Python version number and exit. Example output could be:"

msgstr ""

#: ../../using/cmdline.rst:205

msgid "When given twice, print more information about the build, like:"

msgstr ""

#: ../../using/cmdline.rst:212

msgid "The ``-VV`` option."

msgstr ""

#: ../../using/cmdline.rst:218

msgid "Miscellaneous options"

msgstr ""

#: ../../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 ""

#: ../../using/cmdline.rst:226

msgid "Affects comparisons of :class:`bytes` with :class:`int`."

msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../using/cmdline.rst:245

msgid ""

"The semantics of timestamp-based ``.pyc`` files are unaffected by this "

"option."

msgstr ""

#: ../../using/cmdline.rst:251

msgid ""

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

"options). See also :envvar:`PYTHONDEBUG`."

msgstr ""

#: ../../using/cmdline.rst:257

msgid ""

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

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

msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../using/cmdline.rst:290 ../../using/cmdline.rst:300

msgid "Modify ``.pyc`` filenames according to :pep:`488`."

msgstr ""

#: ../../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 ""

#: ../../using/cmdline.rst:306

msgid ""

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

msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../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\\ :sup:`2`) complexity. See http://"

"www.ocert.org/advisories/ocert-2011-003.html for details."

msgstr ""

#: ../../using/cmdline.rst:328

msgid ""

":envvar:`PYTHONHASHSEED` allows you to set a fixed value for the hash seed "

"secret."

msgstr ""

#: ../../using/cmdline.rst:331

msgid "The option is no longer ignored."

msgstr ""

#: ../../using/cmdline.rst:339

msgid ""

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

"`sys.path`."

msgstr ""

#: ../../using/cmdline.rst:344 ../../using/cmdline.rst:688

#: ../../using/cmdline.rst:700

msgid ":pep:`370` -- Per user site-packages directory"

msgstr ""

#: ../../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 ""

#: ../../using/cmdline.rst:357

msgid ""

"Force the stdout and stderr streams to be unbuffered. This option has no "

"effect on the stdin stream."

msgstr ""

#: ../../using/cmdline.rst:360

msgid "See also :envvar:`PYTHONUNBUFFERED`."

msgstr ""

#: ../../using/cmdline.rst:362

msgid "The text layer of the stdout and stderr streams now is unbuffered."

msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../using/cmdline.rst:398 ../../using/cmdline.rst:716

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 ""

#: ../../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 ""

#: ../../using/cmdline.rst:413 ../../using/cmdline.rst:727

msgid ""

"See :ref:`warning-filter` and :ref:`describing-warning-filters` for more "

"details."

msgstr ""

#: ../../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 ""

#: ../../using/cmdline.rst:425

msgid ""

"Reserved for various implementation-specific options. CPython currently "

"defines the following possible values:"

msgstr ""

#: ../../using/cmdline.rst:428

msgid "``-X faulthandler`` to enable :mod:`faulthandler`;"

msgstr ""

#: ../../using/cmdline.rst:429

msgid ""

"``-X oldparser``: enable the traditional LL(1) parser. See also :envvar:"

"`PYTHONOLDPARSER` and :pep:`617`."

msgstr ""

#: ../../using/cmdline.rst:431

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 ""

#: ../../using/cmdline.rst:434

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 ""

#: ../../using/cmdline.rst:439

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 ""

#: ../../using/cmdline.rst:444

msgid ""

"``-X dev``: enable :ref:`Python Development Mode <devmode>`, introducing "

"additional runtime checks that are too expensive to be enabled by default."

msgstr ""

#: ../../using/cmdline.rst:447

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 ""

#: ../../using/cmdline.rst:451

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 ""

#: ../../using/cmdline.rst:455

msgid ""

"It also allows passing arbitrary values and retrieving them through the :"

"data:`sys._xoptions` dictionary."

msgstr ""

#: ../../using/cmdline.rst:458

msgid "The :option:`-X` option was added."

msgstr ""

#: ../../using/cmdline.rst:461

msgid "The ``-X faulthandler`` option."

msgstr ""

#: ../../using/cmdline.rst:464

msgid "The ``-X showrefcount`` and ``-X tracemalloc`` options."

msgstr ""

#: ../../using/cmdline.rst:467

msgid "The ``-X showalloccount`` option."

msgstr ""

#: ../../using/cmdline.rst:470

msgid "The ``-X importtime``, ``-X dev`` and ``-X utf8`` options."

msgstr ""

#: ../../using/cmdline.rst:473

msgid ""

"The ``-X pycache_prefix`` option. The ``-X dev`` option now logs ``close()`` "

"exceptions in :class:`io.IOBase` destructor."

msgstr ""

#: ../../using/cmdline.rst:477

msgid ""

"Using ``-X dev`` option, check *encoding* and *errors* arguments on string "

"encoding and decoding operations."

msgstr ""

#: ../../using/cmdline.rst:481

msgid "The ``-X showalloccount`` option has been removed."

msgstr ""

#: ../../using/cmdline.rst:484

msgid "The ``-X oldparser`` option."

msgstr ""

#: ../../using/cmdline.rst:488

msgid "Options you shouldn't use"

msgstr ""

#: ../../using/cmdline.rst:492

msgid "Reserved for use by Jython_."

msgstr ""

#: ../../using/cmdline.rst:500

msgid "Environment variables"

msgstr ""

#: ../../using/cmdline.rst:502

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 ""

#: ../../using/cmdline.rst:509

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 ""

#: ../../using/cmdline.rst:515

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 ""

#: ../../using/cmdline.rst:522

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 ""

#: ../../using/cmdline.rst:527

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 ""

#: ../../using/cmdline.rst:531

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 ""

#: ../../using/cmdline.rst:535

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 ""

#: ../../using/cmdline.rst:543

msgid ""

"If this is set to a non-empty string, it overrides the :data:`sys."

"platlibdir` value."

msgstr ""

#: ../../using/cmdline.rst:551

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 ""

#: ../../using/cmdline.rst:558

msgid ""

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

"argument ``filename``."

msgstr ""

#: ../../using/cmdline.rst:560

msgid ""

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

"filename as the argument when called on startup."

msgstr ""

#: ../../using/cmdline.rst:566

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 ""

#: ../../using/cmdline.rst:573

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 ""

#: ../../using/cmdline.rst:585

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 ""

#: ../../using/cmdline.rst:592

msgid ""

"If this is set to a non-empty string, enable the traditional LL(1) parser."

msgstr ""

#: ../../using/cmdline.rst:594

msgid "See also the :option:`-X` ``oldparser`` option and :pep:`617`."

msgstr ""

#: ../../using/cmdline.rst:601

msgid ""

"If this is set to a non-empty string it is equivalent to specifying the :"

"option:`-i` option."

msgstr ""

#: ../../using/cmdline.rst:604

msgid ""

"This variable can also be modified by Python code using :data:`os.environ` "

"to force inspect mode on program termination."

msgstr ""

#: ../../using/cmdline.rst:610

msgid ""

"If this is set to a non-empty string it is equivalent to specifying the :"

"option:`-u` option."

msgstr ""

#: ../../using/cmdline.rst:616

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 ""

#: ../../using/cmdline.rst:623

msgid ""

"If this is set, Python ignores case in :keyword:`import` statements. This "

"only works on Windows and macOS."

msgstr ""

#: ../../using/cmdline.rst:629

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 ""

#: ../../using/cmdline.rst:636

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 ""

#: ../../using/cmdline.rst:646

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 ""

#: ../../using/cmdline.rst:649

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 ""

#: ../../using/cmdline.rst:653

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 ""

#: ../../using/cmdline.rst:657

msgid ""

"The integer must be a decimal number in the range [0,4294967295]. "

"Specifying the value 0 will disable hash randomization."

msgstr ""

#: ../../using/cmdline.rst:665

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 ""

#: ../../using/cmdline.rst:670

msgid ""

"For stderr, the ``:errorhandler`` part is ignored; the handler will always "

"be ``'backslashreplace'``."

msgstr ""

#: ../../using/cmdline.rst:673

msgid "The ``encodingname`` part is now optional."

msgstr ""

#: ../../using/cmdline.rst:676

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 ""

#: ../../using/cmdline.rst:683

msgid ""

"If this is set, Python won't add the :data:`user site-packages directory "

"<site.USER_SITE>` to :data:`sys.path`."

msgstr ""

#: ../../using/cmdline.rst:693

msgid ""

"Defines the :data:`user base directory <site.USER_BASE>`, which is used to "

"compute the path of the :data:`user site-packages directory <site."

"USER_SITE>` and :ref:`Distutils installation paths <inst-alt-install-user>` "

"for ``python setup.py install --user``."

msgstr ""

#: ../../using/cmdline.rst:705

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 macOS."

msgstr ""

#: ../../using/cmdline.rst:711

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 ""

#: ../../using/cmdline.rst:733

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 ""

#: ../../using/cmdline.rst:744

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 ""

#: ../../using/cmdline.rst:755

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 ""

#: ../../using/cmdline.rst:764

msgid ""

"If this environment variable is set to a non-empty string, enable the :ref:"

"`debug mode <asyncio-debug-mode>` of the :mod:`asyncio` module."

msgstr ""

#: ../../using/cmdline.rst:772

msgid "Set the Python memory allocators and/or install debug hooks."

msgstr ""

#: ../../using/cmdline.rst:774

msgid "Set the family of memory allocators used by Python:"

msgstr ""

#: ../../using/cmdline.rst:776

msgid ""

"``default``: use the :ref:`default memory allocators <default-memory-"

"allocators>`."

msgstr ""

#: ../../using/cmdline.rst:778

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 ""

#: ../../using/cmdline.rst:781

msgid ""

"``pymalloc``: use the :ref:`pymalloc allocator <pymalloc>` 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 ""

#: ../../using/cmdline.rst:785

msgid "Install debug hooks:"

msgstr ""

#: ../../using/cmdline.rst:787

msgid ""

"``debug``: install debug hooks on top of the :ref:`default memory allocators "

"<default-memory-allocators>`."

msgstr ""

#: ../../using/cmdline.rst:789

msgid "``malloc_debug``: same as ``malloc`` but also install debug hooks."

msgstr ""

#: ../../using/cmdline.rst:790

msgid "``pymalloc_debug``: same as ``pymalloc`` but also install debug hooks."

msgstr ""

#: ../../using/cmdline.rst:792

msgid ""

"See the :ref:`default memory allocators <default-memory-allocators>` and "

"the :c:func:`PyMem_SetupDebugHooks` function (install debug hooks on Python "

"memory allocators)."

msgstr ""

#: ../../using/cmdline.rst:796

msgid "Added the ``\"default\"`` allocator."

msgstr ""

#: ../../using/cmdline.rst:804

msgid ""

"If set to a non-empty string, Python will print statistics of the :ref:"

"`pymalloc memory allocator <pymalloc>` every time a new pymalloc object "

"arena is created, and on shutdown."

msgstr ""

#: ../../using/cmdline.rst:808

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 ""

#: ../../using/cmdline.rst:812

msgid ""