[po] auto sync

Author: github-actions[bot]

.stat.json

@@ -1 +1 @@
-{"translation": "81.57%", "updated_at": "2025-07-11T15:57:31Z"}
+{"translation": "81.61%", "updated_at": "2025-07-11T23:56:55Z"}

glossary.po

@@ -12,7 +12,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-05-30 14:58+0000\n"
+"POT-Creation-Date: 2025-07-11 15:02+0000\n"
 "PO-Revision-Date: 2025-05-08 05:09+0000\n"
 "Last-Translator: Freesand Leo <yuqinju@163.com>, 2025\n"
 "Language-Team: Chinese (China) (https://app.transifex.com/python-doc/teams/5390/zh_CN/)\n"
@@ -7788,11 +7788,132 @@ msgstr ""
 "WARNING:demo:    1/0\n"
 "WARNING:demo:ZeroDivisionError: division by zero"
 
-#: ../../howto/logging-cookbook.rst:4072
+#: ../../howto/logging-cookbook.rst:4069
+msgid "How to uniformly handle newlines in logging output"
+msgstr "如何统一地处理日志记录输出中的换行符"
+
+#: ../../howto/logging-cookbook.rst:4071
+msgid ""
+"Usually, messages that are logged (say to console or file) consist of a "
+"single line of text. However, sometimes there is a need to handle messages "
+"with multiple lines - whether because a logging format string contains "
+"newlines, or logged data contains newlines. If you want to handle such "
+"messages uniformly, so that each line in the logged message appears "
+"uniformly formatted as if it was logged separately, you can do this using a "
+"handler mixin, as in the following snippet:"
+msgstr ""
+
+#: ../../howto/logging-cookbook.rst:4079
+msgid ""
+"# Assume this is in a module mymixins.py\n"
+"import copy\n"
+"\n"
+"class MultilineMixin:\n"
+"    def emit(self, record):\n"
+"        s = record.getMessage()\n"
+"        if '\\n' not in s:\n"
+"            super().emit(record)\n"
+"        else:\n"
+"            lines = s.splitlines()\n"
+"            rec = copy.copy(record)\n"
+"            rec.args = None\n"
+"            for line in lines:\n"
+"                rec.msg = line\n"
+"                super().emit(rec)"
+msgstr ""
+
+#: ../../howto/logging-cookbook.rst:4097
+msgid "You can use the mixin as in the following script:"
+msgstr ""
+
+#: ../../howto/logging-cookbook.rst:4099
+msgid ""
+"import logging\n"
+"\n"
+"from mymixins import MultilineMixin\n"
+"\n"
+"logger = logging.getLogger(__name__)\n"
+"\n"
+"class StreamHandler(MultilineMixin, logging.StreamHandler):\n"
+"    pass\n"
+"\n"
+"if __name__ == '__main__':\n"
+"    logging.basicConfig(level=logging.DEBUG, format='%(asctime)s %(levelname)-9s %(message)s',\n"
+"                        handlers = [StreamHandler()])\n"
+"    logger.debug('Single line')\n"
+"    logger.debug('Multiple lines:\\nfool me once ...')\n"
+"    logger.debug('Another single line')\n"
+"    logger.debug('Multiple lines:\\n%s', 'fool me ...\\ncan\\'t get fooled again')"
+msgstr ""
+
+#: ../../howto/logging-cookbook.rst:4118
+msgid "The script, when run, prints something like:"
+msgstr ""
+
+#: ../../howto/logging-cookbook.rst:4120
+msgid ""
+"2025-07-02 13:54:47,234 DEBUG     Single line\n"
+"2025-07-02 13:54:47,234 DEBUG     Multiple lines:\n"
+"2025-07-02 13:54:47,234 DEBUG     fool me once ...\n"
+"2025-07-02 13:54:47,234 DEBUG     Another single line\n"
+"2025-07-02 13:54:47,234 DEBUG     Multiple lines:\n"
+"2025-07-02 13:54:47,234 DEBUG     fool me ...\n"
+"2025-07-02 13:54:47,234 DEBUG     can't get fooled again"
+msgstr ""
+
+#: ../../howto/logging-cookbook.rst:4130
+msgid ""
+"If, on the other hand, you are concerned about `log injection "
+"<https://owasp.org/www-community/attacks/Log_Injection>`_, you can use a "
+"formatter which escapes newlines, as per the following example:"
+msgstr ""
+
+#: ../../howto/logging-cookbook.rst:4134
+msgid ""
+"import logging\n"
+"\n"
+"logger = logging.getLogger(__name__)\n"
+"\n"
+"class EscapingFormatter(logging.Formatter):\n"
+"    def format(self, record):\n"
+"        s = super().format(record)\n"
+"        return s.replace('\\n', r'\\n')\n"
+"\n"
+"if __name__ == '__main__':\n"
+"    h = logging.StreamHandler()\n"
+"    h.setFormatter(EscapingFormatter('%(asctime)s %(levelname)-9s %(message)s'))\n"
+"    logging.basicConfig(level=logging.DEBUG, handlers = [h])\n"
+"    logger.debug('Single line')\n"
+"    logger.debug('Multiple lines:\\nfool me once ...')\n"
+"    logger.debug('Another single line')\n"
+"    logger.debug('Multiple lines:\\n%s', 'fool me ...\\ncan\\'t get fooled again')"
+msgstr ""
+
+#: ../../howto/logging-cookbook.rst:4154
+msgid ""
+"You can, of course, use whatever escaping scheme makes the most sense for "
+"you. The script, when run, should produce output like this:"
+msgstr ""
+
+#: ../../howto/logging-cookbook.rst:4157
+msgid ""
+"2025-07-09 06:47:33,783 DEBUG     Single line\n"
+"2025-07-09 06:47:33,783 DEBUG     Multiple lines:\\nfool me once ...\n"
+"2025-07-09 06:47:33,783 DEBUG     Another single line\n"
+"2025-07-09 06:47:33,783 DEBUG     Multiple lines:\\nfool me ...\\ncan't get fooled again"
+msgstr ""
+
+#: ../../howto/logging-cookbook.rst:4164
+msgid ""
+"Escaping behaviour can't be the stdlib default , as it would break backwards"
+" compatibility."
+msgstr "转义行为不能是标准库默认设置，因为它会破坏向下兼容性。"
+
+#: ../../howto/logging-cookbook.rst:4170
 msgid "Patterns to avoid"
 msgstr "理应避免的用法"
 
-#: ../../howto/logging-cookbook.rst:4074
+#: ../../howto/logging-cookbook.rst:4172
 msgid ""
 "Although the preceding sections have described ways of doing things you "
 "might need to do or deal with, it is worth mentioning some usage patterns "
@@ -7801,11 +7922,11 @@ msgid ""
 msgstr ""
 "前几节虽介绍了几种方案，描述了可能需要处理的操作，但值得一提的是，有些用法是 *没有好处* 的，大多数情况下应该避免使用。下面几节的顺序不分先后。"
 
-#: ../../howto/logging-cookbook.rst:4080
+#: ../../howto/logging-cookbook.rst:4178
 msgid "Opening the same log file multiple times"
 msgstr "多次打开同一个日志文件"
 
-#: ../../howto/logging-cookbook.rst:4082
+#: ../../howto/logging-cookbook.rst:4180
 msgid ""
 "On Windows, you will generally not be able to open the same file multiple "
 "times as this will lead to a \"file is in use by another process\" error. "
@@ -7815,33 +7936,33 @@ msgstr ""
 "因会导致 \"文件被其他进程占用 \"错误，所以在 Windows 中一般无法多次打开同一个文件。但在 POSIX "
 "平台中，多次打开同一个文件不会报任何错误。这种操作可能是意外发生的，比如："
 
-#: ../../howto/logging-cookbook.rst:4087
+#: ../../howto/logging-cookbook.rst:4185
 msgid ""
 "Adding a file handler more than once which references the same file (e.g. by"
 " a copy/paste/forget-to-change error)."
 msgstr "多次添加指向同一文件的 handler（比如通过复制/粘贴，或忘记修改）。"
 
-#: ../../howto/logging-cookbook.rst:4090
+#: ../../howto/logging-cookbook.rst:4188
 msgid ""
 "Opening two files that look different, as they have different names, but are"
 " the same because one is a symbolic link to the other."
 msgstr "打开两个貌似不同（文件名不一样）的文件，但一个是另一个的符号链接，所以其实是同一个文件。"
 
-#: ../../howto/logging-cookbook.rst:4093
+#: ../../howto/logging-cookbook.rst:4191
 msgid ""
 "Forking a process, following which both parent and child have a reference to"
 " the same file. This might be through use of the :mod:`multiprocessing` "
 "module, for example."
 msgstr ""
 "进程 fork，然后父进程和子进程都有对同一文件的引用。 例如，这可能是通过使用 :mod:`multiprocessing` 模块实现的。"
 
-#: ../../howto/logging-cookbook.rst:4097
+#: ../../howto/logging-cookbook.rst:4195
 msgid ""
 "Opening a file multiple times might *appear* to work most of the time, but "
 "can lead to a number of problems in practice:"
 msgstr "在大多数情况下，多次打开同一个文件 *貌似* 一切正常，但实际会导致很多问题。"
 
-#: ../../howto/logging-cookbook.rst:4100
+#: ../../howto/logging-cookbook.rst:4198
 msgid ""
 "Logging output can be garbled because multiple threads or processes try to "
 "write to the same file. Although logging guards against concurrent use of "
@@ -7852,7 +7973,7 @@ msgstr ""
 "由于多个线程或进程会尝试写入同一个文件，日志输出可能会出现乱码。尽管日志对象可以防止多个线程同时使用同一个 handler "
 "实例，但如果两个不同的线程使用不同的 handler 实例同时写入文件，而这两个 handler 又恰好指向同一个文件，那么就失去了这种防护。"
 
-#: ../../howto/logging-cookbook.rst:4106
+#: ../../howto/logging-cookbook.rst:4204
 msgid ""
 "An attempt to delete a file (e.g. during file rotation) silently fails, "
 "because there is another reference pointing to it. This can lead to "
@@ -7865,17 +7986,17 @@ msgstr ""
 "日志条目会出现在意想不到的地方，或者完全丢失。 "
 "或者会有应当移除的文件仍然保持存在，文件还会在已经设置了基于文件大小的轮换的情况下仍然增长到预料之外的大小。"
 
-#: ../../howto/logging-cookbook.rst:4113
+#: ../../howto/logging-cookbook.rst:4211
 msgid ""
 "Use the techniques outlined in :ref:`multiple-processes` to circumvent such "
 "issues."
 msgstr "请用 :ref:`multiple-processes` 中介绍的技术来避免上述问题。"
 
-#: ../../howto/logging-cookbook.rst:4117
+#: ../../howto/logging-cookbook.rst:4215
 msgid "Using loggers as attributes in a class or passing them as parameters"
 msgstr "将日志对象用作属性或传递参数"
 
-#: ../../howto/logging-cookbook.rst:4119
+#: ../../howto/logging-cookbook.rst:4217
 msgid ""
 "While there might be unusual cases where you'll need to do this, in general "
 "there is no point because loggers are singletons. Code can always access a "
@@ -7889,13 +8010,13 @@ msgstr ""
 "用名称访问一个已有的日志对象实例，因此将实例作为参数来传递，或作为属性留存，都是毫无意义的。请注意，在其他语言中，如 Java 和 "
 "C#，日志对象通常是静态类属性。但在 Python 中是没有意义的，因为软件拆分的单位是模块（而不是类）。"
 
-#: ../../howto/logging-cookbook.rst:4128
+#: ../../howto/logging-cookbook.rst:4226
 msgid ""
 "Adding handlers other than :class:`~logging.NullHandler` to a logger in a "
 "library"
 msgstr "为库中的日志记录器添加 :class:`~logging.NullHandler` 以外的处理器"
 
-#: ../../howto/logging-cookbook.rst:4130
+#: ../../howto/logging-cookbook.rst:4228
 msgid ""
 "Configuring logging by adding handlers, formatters and filters is the "
 "responsibility of the application developer, not the library developer. If "
@@ -7906,11 +8027,11 @@ msgstr ""
 "来配置日志，这是应用程序开发人员的责任，而不是库开发人员该做的。如果正在维护一个库，请确保不要向任何日志对象添加 "
 ":class:`~logging.NullHandler` 实例以外的 handler。"
 
-#: ../../howto/logging-cookbook.rst:4136
+#: ../../howto/logging-cookbook.rst:4234
 msgid "Creating a lot of loggers"
 msgstr "创建大量的日志对象"
 
-#: ../../howto/logging-cookbook.rst:4138
+#: ../../howto/logging-cookbook.rst:4236
 msgid ""
 "Loggers are singletons that are never freed during a script execution, and "
 "so creating lots of loggers will use up memory which can't then be freed. "
@@ -7924,38 +8045,38 @@ msgstr ""
 " :ref:`已有机制 <context-info>` "
 "将上下文信息传给自定义日志对象，并将创建的日志对象限制在应用程序内的指定区域（通常是模块，但偶尔会再精细些）使用。"
 
-#: ../../howto/logging-cookbook.rst:4149
+#: ../../howto/logging-cookbook.rst:4247
 msgid "Other resources"
 msgstr "其他资源"
 
-#: ../../howto/logging-cookbook.rst:4153
+#: ../../howto/logging-cookbook.rst:4251
 msgid "Module :mod:`logging`"
 msgstr "模块 :mod:`logging`"
 
-#: ../../howto/logging-cookbook.rst:4154
+#: ../../howto/logging-cookbook.rst:4252
 msgid "API reference for the logging module."
 msgstr "日志记录模块的 API 参考。"
 
-#: ../../howto/logging-cookbook.rst:4156
+#: ../../howto/logging-cookbook.rst:4254
 msgid "Module :mod:`logging.config`"
 msgstr ":mod:`logging.config` 模块"
 
-#: ../../howto/logging-cookbook.rst:4157
+#: ../../howto/logging-cookbook.rst:4255
 msgid "Configuration API for the logging module."
 msgstr "日志记录模块的配置 API 。"
 
-#: ../../howto/logging-cookbook.rst:4159
+#: ../../howto/logging-cookbook.rst:4257
 msgid "Module :mod:`logging.handlers`"
 msgstr ":mod:`logging.handlers` 模块"
 
-#: ../../howto/logging-cookbook.rst:4160
+#: ../../howto/logging-cookbook.rst:4258
 msgid "Useful handlers included with the logging module."
 msgstr "日志记录模块附带的有用处理器。"
 
-#: ../../howto/logging-cookbook.rst:4162
+#: ../../howto/logging-cookbook.rst:4260
 msgid ":ref:`Basic Tutorial <logging-basic-tutorial>`"
 msgstr ":ref:`基础教程 <logging-basic-tutorial>`"
 
-#: ../../howto/logging-cookbook.rst:4164
+#: ../../howto/logging-cookbook.rst:4262
 msgid ":ref:`Advanced Tutorial <logging-advanced-tutorial>`"
 msgstr ":ref:`进阶教程 <logging-advanced-tutorial>`"

howto/logging-cookbook.po

@@ -334,6 +334,8 @@ msgid ""
 ":term:`generator`. The *errors* argument (as well as any other keyword "
 "argument) is passed through to the incremental encoder."
 msgstr ""
+"使用增量式编码器通过迭代来编码由 *iterator* 提供的输入。 *iterator* 必须产生 :class:`str` 对象。 此函数属于 "
+":term:`generator`。 *errors* 参数（以及任何其他关键字参数）会被传递给增量式编码器。"
 
 #: ../../library/codecs.rst:246
 msgid ""
@@ -350,6 +352,8 @@ msgid ""
 " :term:`generator`. The *errors* argument (as well as any other keyword "
 "argument) is passed through to the incremental decoder."
 msgstr ""
+"使用增量式解码器通过迭代来解码由 *iterator* 提供的输入。 *iterator* 必须产生 :class:`bytes` 对象。 此函数属于 "
+":term:`generator`。 *errors* 参数（以及任何其他关键字参数）会被传递给增量式解码器。"
 
 #: ../../library/codecs.rst:258
 msgid ""
@@ -367,16 +371,20 @@ msgid ""
 ":ref:`buffer-compatible object <bufferobjects>` or :class:`str` (encoded to "
 "UTF-8 before processing), and their length in bytes."
 msgstr ""
+"返回一个包含 *buffer* 中原始字节数据的 :class:`tuple`，一个 :ref:`缓冲区兼容对象 <bufferobjects>` 或 "
+":class:`str` (在处理前已编码为 UTF-8)，及其字节长度。"
 
 #: ../../library/codecs.rst:270
 msgid "The *errors* argument is ignored."
-msgstr ""
+msgstr "*errors* 参数会被忽略。"
 
 #: ../../library/codecs.rst:272
 msgid ""
 ">>> codecs.readbuffer_encode(b\"Zito\")\n"
 "(b'Zito', 4)"
 msgstr ""
+">>> codecs.readbuffer_encode(b\"Zito\")\n"
+"(b'Zito', 4)"
 
 #: ../../library/codecs.rst:278
 msgid ""
@@ -2631,7 +2639,7 @@ msgstr "undefined"
 
 #: ../../library/codecs.rst:1387
 msgid "This Codec should only be used for testing purposes."
-msgstr ""
+msgstr "该编解码器应当仅用于测试目的。"
 
 #: ../../library/codecs.rst:1391
 msgid ""
@@ -2825,7 +2833,7 @@ msgstr "恢复 ``rot13`` 别名。"
 
 #: ../../library/codecs.rst:1495
 msgid ":mod:`encodings` --- Encodings package"
-msgstr ""
+msgstr ":mod:`encodings` --- 编码格式包"
 
 #: ../../library/codecs.rst:1500
 msgid "This module implements the following functions:"

library/codecs.po

@@ -5,6 +5,7 @@
 # 
 # Translators:
 # Rafael Fontenelle <rffontenelle@gmail.com>, 2025
+# Freesand Leo <yuqinju@163.com>, 2025
 # 
 #, fuzzy
 msgid ""
@@ -13,7 +14,7 @@ msgstr ""
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2025-07-11 15:02+0000\n"
 "PO-Revision-Date: 2025-05-08 05:10+0000\n"
-"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2025\n"
+"Last-Translator: Freesand Leo <yuqinju@163.com>, 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"
@@ -29,7 +30,7 @@ msgstr ":mod:`!xml.parsers.expat` --- 使用 Expat 进行快速 XML 解析"
 msgid ""
 "If you need to parse untrusted or unauthenticated data, see :ref:`xml-"
 "security`."
-msgstr ""
+msgstr "如果你需要解析不受信任或未经身份验证的数据，请参阅 :ref:`xml-security`。"
 
 #: ../../library/pyexpat.rst:27
 msgid ""