Codestin Search App

283 lines (236 loc) · 8.14 KB
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2025, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
# Translators:
# python-doc bot, 2025
"Project-Id-Version: Python 3.9\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-01-03 16:35+0000\n"
"PO-Revision-Date: 2025-09-22 17:54+0000\n"
"Last-Translator: python-doc bot, 2025\n"
"Language-Team: Chinese (China) (https://app.transifex.com/python-doc/teams/5390/zh_CN/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: zh_CN\n"
"Plural-Forms: nplurals=1; plural=0;\n"
#: ../../library/devmode.rst:4
msgid "Python Development Mode"
#: ../../library/devmode.rst:8
"The Python Development Mode introduces additional runtime checks that 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."
#: ../../library/devmode.rst:13
"It can be enabled using the :option:`-X dev <-X>` command line option or by "
"setting the :envvar:`PYTHONDEVMODE` environment variable to ``1``."
#: ../../library/devmode.rst:17
msgid "Effects of the Python Development Mode"
#: ../../library/devmode.rst:19
"Enabling the Python Development Mode is similar to the following command, "
"but with additional effects described below::"
#: ../../library/devmode.rst:24
msgid "Effects of the Python Development Mode:"
#: ../../library/devmode.rst:26
"Add ``default`` :ref:`warning filter <describing-warning-filters>`. The "
"following warnings are shown:"
#: ../../library/devmode.rst:29
msgid ":exc:`DeprecationWarning`"
msgstr ":exc:`DeprecationWarning`"
#: ../../library/devmode.rst:30
msgid ":exc:`ImportWarning`"
msgstr ":exc:`ImportWarning`"
#: ../../library/devmode.rst:31
msgid ":exc:`PendingDeprecationWarning`"
msgstr ":exc:`PendingDeprecationWarning`"
#: ../../library/devmode.rst:32
msgid ":exc:`ResourceWarning`"
msgstr ":exc:`ResourceWarning`"
#: ../../library/devmode.rst:34
"Normally, the above warnings are filtered by the default :ref:`warning "
"filters <describing-warning-filters>`."
#: ../../library/devmode.rst:37
"It behaves as if the :option:`-W default <-W>` command line option is used."
#: ../../library/devmode.rst:39
"Use the :option:`-W error <-W>` command line option or set the "
":envvar:`PYTHONWARNINGS` environment variable to ``error`` to treat warnings"
" as errors."
#: ../../library/devmode.rst:43
msgid "Install debug hooks on memory allocators to check for:"
#: ../../library/devmode.rst:45
msgid "Buffer underflow"
#: ../../library/devmode.rst:46
msgid "Buffer overflow"
#: ../../library/devmode.rst:47
msgid "Memory allocator API violation"
#: ../../library/devmode.rst:48
msgid "Unsafe usage of the GIL"
#: ../../library/devmode.rst:50
msgid "See the :c:func:`PyMem_SetupDebugHooks` C function."
#: ../../library/devmode.rst:52
"It behaves as if the :envvar:`PYTHONMALLOC` environment variable is set to "
"``debug``."
#: ../../library/devmode.rst:55
"To enable the Python Development Mode without installing debug hooks on "
"memory allocators, set the :envvar:`PYTHONMALLOC` environment variable to "
"``default``."
#: ../../library/devmode.rst:59
"Call :func:`faulthandler.enable` at Python startup to install handlers for "
"the :const:`SIGSEGV`, :const:`SIGFPE`, :const:`SIGABRT`, :const:`SIGBUS` and"
" :const:`SIGILL` signals to dump the Python traceback on a crash."
#: ../../library/devmode.rst:63
"It behaves as if the :option:`-X faulthandler <-X>` command line option is "
"used or if the :envvar:`PYTHONFAULTHANDLER` environment variable is set to "
#: ../../library/devmode.rst:67
"Enable :ref:`asyncio debug mode <asyncio-debug-mode>`. For example, "
":mod:`asyncio` checks for coroutines that were not awaited and logs them."
#: ../../library/devmode.rst:70
"It behaves as if the :envvar:`PYTHONASYNCIODEBUG` environment variable is "
"set to ``1``."
#: ../../library/devmode.rst:73
"Check the *encoding* and *errors* arguments for string encoding and decoding"
" operations. Examples: :func:`open`, :meth:`str.encode` and "
":meth:`bytes.decode`."
#: ../../library/devmode.rst:77
"By default, for best performance, the *errors* argument is only checked at "
"the first encoding/decoding error and the *encoding* argument is sometimes "
"ignored for empty strings."
#: ../../library/devmode.rst:81
msgid "The :class:`io.IOBase` destructor logs ``close()`` exceptions."
#: ../../library/devmode.rst:82
"Set the :attr:`~sys.flags.dev_mode` attribute of :attr:`sys.flags` to "
"``True``."
#: ../../library/devmode.rst:85
"The Python Development Mode does not enable the :mod:`tracemalloc` module by"
" default, because the overhead cost (to performance and memory) would be too"
" large. Enabling the :mod:`tracemalloc` module provides additional "
"information on the origin of some errors. For example, "
":exc:`ResourceWarning` logs the traceback where the resource was allocated, "
"and a buffer overflow error logs the traceback where the memory block was "
"allocated."
#: ../../library/devmode.rst:92
"The Python Development Mode does not prevent the :option:`-O` command line "
"option from removing :keyword:`assert` statements nor from setting "
":const:`__debug__` to ``False``."
#: ../../library/devmode.rst:96
msgid "The :class:`io.IOBase` destructor now logs ``close()`` exceptions."
#: ../../library/devmode.rst:99
"The *encoding* and *errors* arguments are now checked for string encoding "
"and decoding operations."
#: ../../library/devmode.rst:105
msgid "ResourceWarning Example"
#: ../../library/devmode.rst:107
"Example of a script counting the number of lines of the text file specified "
"in the command line::"
#: ../../library/devmode.rst:121
"The script does not close the file explicitly. By default, Python does not "
"emit any warning. Example using README.txt, which has 269 lines:"
#: ../../library/devmode.rst:129
"Enabling the Python Development Mode displays a :exc:`ResourceWarning` "
#: ../../library/devmode.rst:139
"In addition, enabling :mod:`tracemalloc` shows the line where the file was "
#: ../../library/devmode.rst:154
"The fix is to close explicitly the file. Example using a context manager::"
#: ../../library/devmode.rst:162
"Not closing a resource explicitly can leave a resource open for way longer "
"than expected; it can cause severe issues upon exiting Python. It is bad in "
"CPython, but it is even worse in PyPy. Closing resources explicitly makes an"
" application more deterministic and more reliable."
#: ../../library/devmode.rst:169
msgid "Bad file descriptor error example"
#: ../../library/devmode.rst:171
msgid "Script displaying the first line of itself::"
#: ../../library/devmode.rst:184
msgid "By default, Python does not emit any warning:"
#: ../../library/devmode.rst:191
"The Python Development Mode shows a :exc:`ResourceWarning` and logs a \"Bad "
"file descriptor\" error when finalizing the file object:"
#: ../../library/devmode.rst:207
"``os.close(fp.fileno())`` closes the file descriptor. When the file object "
"finalizer tries to close the file descriptor again, it fails with the ``Bad "
"file descriptor`` error. A file descriptor must be closed only once. In the "
"worst case scenario, closing it twice can lead to a crash (see "
":issue:`18748` for an example)."
#: ../../library/devmode.rst:213
"The fix is to remove the ``os.close(fp.fileno())`` line, or open the file "
"with ``closefd=False``."
Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

FilesExpand file tree

devmode.po

Latest commit

History

devmode.po

File metadata and controls
