[po] auto sync

github-actions[bot] · github-actions[bot] · commit 3ab6467b0535 · 2022-06-17T07:23:40.000Z
diff --git a/library/__main__.po b/library/__main__.po
@@ -5,6 +5,7 @@
 # 
 # Translators:
 # Freesand Leo <yuqinju@163.com>, 2022
+# Alpha Du <alphanow@gmail.com>, 2022
 # 
 #, fuzzy
 msgid ""
@@ -13,7 +14,7 @@ msgstr ""
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2022-06-16 06:28+0000\n"
 "PO-Revision-Date: 2021-06-28 00:54+0000\n"
-"Last-Translator: Freesand Leo <yuqinju@163.com>, 2022\n"
+"Last-Translator: Alpha Du <alphanow@gmail.com>, 2022\n"
 "Language-Team: Chinese (China) (https://www.transifex.com/python-doc/teams/5390/zh_CN/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
@@ -107,22 +108,22 @@ msgstr "作为文件参数传给 Python 解释器的 Python 模块:"
 msgid ""
 "the Python module or package passed to the Python interpreter with the "
 ":option:`-m` argument:"
-msgstr ""
+msgstr "作为 :option:`-m` 参数传给 Python 解释器的 Python 模块或包:"
 
 #: ../../library/__main__.rst:75
 msgid "Python code read by the Python interpreter from standard input:"
-msgstr ""
+msgstr "Python 解释器从标准输入中读取的 Python 代码:"
 
 #: ../../library/__main__.rst:86
 msgid ""
 "Python code passed to the Python interpreter with the :option:`-c` argument:"
-msgstr ""
+msgstr "作为 :option:`-c` 参数传递给 Python 解释器的 Python 代码:"
 
 #: ../../library/__main__.rst:97
 msgid ""
 "In each of these situations, the top-level module's ``__name__`` is set to "
 "``'__main__'``."
-msgstr ""
+msgstr "在以上每个情形中，顶级模块的 ``__name__``  被设置为 ``'__main__'`` 。"
 
 #: ../../library/__main__.rst:100
 msgid ""
@@ -131,16 +132,18 @@ msgid ""
 "idiom for conditionally executing code when the module is not initialized "
 "from an import statement::"
 msgstr ""
+"因此，一个模块可以通过检查自己的 ``__name__``  "
+"，来发现它是否在顶层环境中运行。这是允许在模块没有从导入语句中初始化的情况下，有条件地执行代码的一个常见的语句::"
 
 #: ../../library/__main__.rst:111
 msgid ""
 "For a more detailed look at how ``__name__`` is set in all situations, see "
 "the tutorial section :ref:`tut-modules`."
-msgstr ""
+msgstr "关于在所有情况下 ``__name__`` 是如何设置的细节，请看教程部分 :ref:`tut-modules` 。"
 
 #: ../../library/__main__.rst:116 ../../library/__main__.rst:239
 msgid "Idiomatic Usage"
-msgstr ""
+msgstr "常见用法"
 
 #: ../../library/__main__.rst:118
 msgid ""
@@ -149,20 +152,25 @@ msgid ""
 "like this was imported from a different module, for example to unit test it,"
 " the script code would unintentionally execute as well."
 msgstr ""
+"有些模块包含了仅供脚本使用的代码，比如解析命令行参数或从标准输入获取数据。 "
+"如果这样的模块被从不同的模块中导入，例如为了单元测试，脚本代码也会无意中执行。"
 
 #: ../../library/__main__.rst:123
 msgid ""
 "This is where using the ``if __name__ == '__main__'`` code block comes in "
 "handy. Code within this block won't run unless the module is executed in the"
 " top-level environment."
 msgstr ""
+"这就是 ``if __name__ == '__main__'`` 代码块的用武之地。除非模块在顶层环境中被执行，否则该块内的代码不会运行。"
 
 #: ../../library/__main__.rst:127
 msgid ""
 "Putting as few statements as possible in the block below ``if __name___ == "
 "'__main__'`` can improve code clarity and correctness. Most often, a "
 "function named ``main`` encapsulates the program's primary behavior::"
 msgstr ""
+"将尽可能少的语句放在下面的 ``if __name___ == '__main__'`` 块中可以提高代码的清晰度和正确性。最常见的，一个名为 "
+"``main`` 的函数封装了程序的主要行为::"
 
 #: ../../library/__main__.rst:151
 msgid ""
@@ -173,6 +181,9 @@ msgid ""
 "using the global variable instead of a local name.  A ``main`` function "
 "solves this problem."
 msgstr ""
+"请注意，如果模块没有将代码封装在 ``main`` 函数内，而是直接放在 ``if __name__ == '__main__'`` 块内，那么这个 "
+"``phrase`` 变量对整个模块来说就是全局变量。 这很容易出错，因为模块内的其他函数可能会无意中使用全局变量而不是局部名称。 一个 "
+"``main`` 函数解决了这个问题。"
 
 #: ../../library/__main__.rst:158
 msgid ""
@@ -181,10 +192,12 @@ msgid ""
 "imported, the ``echo`` and ``main`` functions will be defined, but neither "
 "of them will be called, because ``__name__ != '__main__'``."
 msgstr ""
+"使用 ``main`` 函数有一个额外的好处，就是 ``echo`` 函数本身是孤立的，可以在其他地方导入。当 ``echo.py`` "
+"被导入时，``echo`` 和 ``main`` 函数将被定义，但它们都不会被调用，因为 ``__name__ != '__main__'`` 。"
 
 #: ../../library/__main__.rst:165
 msgid "Packaging Considerations"
-msgstr ""
+msgstr "打包考量"
 
 #: ../../library/__main__.rst:167
 msgid ""
@@ -194,6 +207,8 @@ msgid ""
 "where the return value of ``main`` is passed into :func:`sys.exit`. For "
 "example::"
 msgstr ""
+"``main`` 函数经常被用来创建命令行工具，把它们指定为控制台脚本的入口点。 当这样做时，`pip <https://pip.pypa.io/>`_"
+" 将函数调用插入到模板脚本中，其中 ``main`` 的返回值被传递到 :func:`sys.exit` 。例如::"
 
 #: ../../library/__main__.rst:175
 msgid ""
@@ -202,6 +217,8 @@ msgid ""
 ":func:`sys.exit`; typically, an integer or ``None`` (which is implicitly "
 "returned if your function does not have a return statement)."
 msgstr ""
+"由于 ``main`` 调用被包裹在 :func:`sys.exit` 中，期望你的函数将返回一些可被 :func:`sys.exit` "
+"作为输入而接受的值；通常为一个整数或 ``None`` （如果你的函数没有返回语句，则隐含返回）。"
 
 #: ../../library/__main__.rst:180
 msgid ""
@@ -210,6 +227,8 @@ msgid ""
 "if we later package it as a console script entry-point in a pip-installable "
 "package."
 msgstr ""
+"通过主动遵循这一惯例，我们的模块在直接运行时（即 ``python3 echo.py`` ）会有相同的行为，如果我们以后把它打包成可用 pip "
+"安装的包中的控制台脚本入口，它也会有相同的行为。"
 
 #: ../../library/__main__.rst:185
 msgid ""
@@ -220,17 +239,22 @@ msgid ""
 "``echo.py`` example from earlier exemplifies using the ``sys.exit(main())`` "
 "convention."
 msgstr ""
+"特别的是，要小心从你的 ``main`` 函数中返回字符串。 :func:`sys.exit` 将把一个字符串参数解释为失败信息，所以你的程序将有一个 "
+"``1`` 的退出代码，表示失败。并且这个字符串将被写入 :data:`sys.stderr` 。 前面的 ``echo.py`` 例子举例说明了使用 "
+"``sys.exit(main())`` 的约定。"
 
 #: ../../library/__main__.rst:193
 msgid ""
 "`Python Packaging User Guide <https://packaging.python.org/>`_ contains a "
 "collection of tutorials and references on how to distribute and install "
 "Python packages with modern tools."
 msgstr ""
+"`Python 打包用户指南 <https://packaging.python.org/>`_ 包含了一系列关于如何用现代工具分发和安装 Python"
+" 包的教程和参考资料。"
 
 #: ../../library/__main__.rst:199
 msgid "``__main__.py`` in Python Packages"
-msgstr ""
+msgstr "Python 包中的 ``__main__.py``"
 
 #: ../../library/__main__.rst:201
 msgid ""
@@ -239,12 +263,14 @@ msgid ""
 "to provide a command-line interface for a package. Consider the following "
 "hypothetical package, \"bandclass\":"
 msgstr ""
+"如果你不熟悉Python包，请参阅本教程的 :ref:`tut-packages` 一节。最常见的是， ``__main__.py`` "
+"文件被用来为一个包提供命令行接口。假设有下面这个虚构的包，\"bandclass\":"
 
 #: ../../library/__main__.rst:213
 msgid ""
 "``__main__.py`` will be executed when the package itself is invoked directly"
 " from the command line using the :option:`-m` flag. For example:"
-msgstr ""
+msgstr "当使用 :option:`-m` 标志从命令行直接调用软件包本身时，将执行 ``__main__.py`` 。比如说。"
 
 #: ../../library/__main__.rst:220
 msgid ""
@@ -253,6 +279,8 @@ msgid ""
 "this hypothetical case, it might make sense to allow the teacher to search "
 "for students::"
 msgstr ""
+"这个命令将导致 ``__main__.py`` "
+"的运行。你如何利用这一机制将取决于你所编写的软件包的性质，但在这个假设的案例中，允许教师搜索学生可能是有意义的::"
 
 #: ../../library/__main__.rst:233
 msgid ""
@@ -261,6 +289,9 @@ msgid ""
 "within a package.  For more details, see :ref:`intra-package-references` in "
 "the :ref:`tut-modules` section of the tutorial."
 msgstr ""
+"注意， ``from .student import search_students`` 是一个相对导入的例子。 "
+"这种导入方式可以在引用一个包内的模块时使用。 更多细节，请参见教程 :ref:`tut-modules` 中的 :ref:`intra-package-"
+"references` 一节。"
 
 #: ../../library/__main__.rst:241
 msgid ""
@@ -269,44 +300,54 @@ msgid ""
 "execute from other modules.  Those other modules can then be easily unit-"
 "tested and are properly reusable."
 msgstr ""
+"``__main__.py`` 的内容通常不是用 ``if __name__ == '__main__'`` 区块围起来的。 "
+"相反，这些文件保持简短，功能从其他模块执行。 那些其他模块可以很容易地进行单元测试，并且可以适当地重复使用。"
 
 #: ../../library/__main__.rst:246
 msgid ""
 "If used, an ``if __name__ == '__main__'`` block will still work as expected "
 "for a ``__main__.py`` file within a package, because its ``__name__`` "
 "attribute will include the package's path if imported::"
 msgstr ""
+"如果使用，一个 ``if __name__ == '__main__'`` 区块仍然会像预期的那样对包内的 ``__main__.py`` "
+"文件起作用，因为如果导入，它的 ``__name__`` 属性将包括包的路径::"
 
 #: ../../library/__main__.rst:254
 msgid ""
 "This won't work for ``__main__.py`` files in the root directory of a .zip "
 "file though.  Hence, for consistency, minimal ``__main__.py`` like the "
 ":mod:`venv` one mentioned below are preferred."
 msgstr ""
+"但这对 .zip 文件的根目录中的 ``__main__.py`` 文件不起作用。 因此，为了保持一致性，像下面提到的 :mod:`venv` "
+"这样的最小 ``__main__.py`` 是首选。"
 
 #: ../../library/__main__.rst:260
 msgid ""
 "See :mod:`venv` for an example of a package with a minimal ``__main__.py`` "
 "in the standard library. It doesn't contain a ``if __name__ == '__main__'`` "
 "block. You can invoke it with ``python3 -m venv [directory]``."
 msgstr ""
+"参见 :mod:`venv` 以了解标准库中最小 ``__main__.py`` 的软件包示例。它不包含一个 ``if __name__ == "
+"'__main__'`` 块。你可以用 ``python3 -m venv [directory]`` 调用它。"
 
 #: ../../library/__main__.rst:264
 msgid ""
 "See :mod:`runpy` for more details on the :option:`-m` flag to the "
 "interpreter executable."
-msgstr ""
+msgstr "参见 :mod:`runpy` 以了解更多关于 :option:`-m` 标志对解释器可执行包的细节。"
 
 #: ../../library/__main__.rst:267
 msgid ""
 "See :mod:`zipapp` for how to run applications packaged as *.zip* files. In "
 "this case Python looks for a ``__main__.py`` file in the root directory of "
 "the archive."
 msgstr ""
+"参见 :mod:`zipapp` 了解如何运行打包成 *.zip* 文件的应用程序。在这种情况下，Python 会在归档文件的根目录下寻找一个 "
+"``__main__.py`` 文件。"
 
 #: ../../library/__main__.rst:274
 msgid "``import __main__``"
-msgstr ""
+msgstr "``import __main__``"
 
 #: ../../library/__main__.rst:276
 msgid ""
@@ -316,25 +357,30 @@ msgid ""
 "doesn't import a ``__main__.py`` file but rather whichever module that "
 "received the special name ``'__main__'``."
 msgstr ""
+"不管 Python 程序是用哪个模块启动的，在同一程序中运行的其他模块可以通过导入 ``__main__`` 模块来导入顶级环境的范围 ( "
+":term:`namespace` )。这并不是导入一个 ``__main__.py`` 文件，而是导入使用特殊名称 ``'__main__'`` "
+"的哪个模块。"
 
 #: ../../library/__main__.rst:282
 msgid "Here is an example module that consumes the ``__main__`` namespace::"
-msgstr ""
+msgstr "下面是一个使用 ``__main__`` 命名空间的模块的例子::"
 
 #: ../../library/__main__.rst:300
 msgid "Example usage of this module could be as follows::"
-msgstr ""
+msgstr "该模块的用法示例如下::"
 
 #: ../../library/__main__.rst:319
 msgid "Now, if we started our program, the result would look like this:"
-msgstr ""
+msgstr "现在，如果我们启动我们的程序，结果会是这样的:"
 
 #: ../../library/__main__.rst:326
 msgid ""
 "The exit code of the program would be 1, indicating an error. Uncommenting "
 "the line with ``my_name = \"Dinsdale\"`` fixes the program and now it exits "
 "with status code 0, indicating success:"
 msgstr ""
+"该程序的退出代码为 1 ，表明有错误。取消对 ``my_name = \"Dinsdale\"`` 这一行的注释，就可以修复程序，现在它的退出状态代码为"
+" 0 ，表示成功。"
 
 #: ../../library/__main__.rst:335
 msgid ""
@@ -343,6 +389,8 @@ msgid ""
 "the ``if __name__ == \"__main__\"`` block of the ``start`` module. Why does "
 "this work?"
 msgstr ""
+"请注意，导入 ``__main__`` 不会导致无意中运行旨在用于脚本的顶层代码的问题，这些代码被放在模块 ``start`` 的 ``if "
+"__name__ == \"__main__\"`` 块中。为什么这样做？"
 
 #: ../../library/__main__.rst:339
 msgid ""
