py_compile.po

# Copyright (C) 2001-2023, Python Software Foundation
# This file is distributed under the same license as the Python package.
#
# Translators:
msgid ""
msgstr ""
"Project-Id-Version: Python 3.13\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2024-05-09 00:03+0000\n"
"PO-Revision-Date: 2018-05-23 16:08+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"

#: ../../library/py_compile.rst:2
msgid ":mod:`!py_compile` --- Compile Python source files"
msgstr ":mod:`!py_compile` — 編譯 Python 來源檔案"

#: ../../library/py_compile.rst:10
msgid "**Source code:** :source:`Lib/py_compile.py`"
msgstr "**原始碼：**\\ :source:`Lib/py_compile.py`"

#: ../../library/py_compile.rst:16
msgid ""
"The :mod:`py_compile` module provides a function to generate a byte-code "
"file from a source file, and another function used when the module source "
"file is invoked as a script."
msgstr ""

#: ../../library/py_compile.rst:20
msgid ""
"Though not often needed, this function can be useful when installing modules "
"for shared use, especially if some of the users may not have permission to "
"write the byte-code cache files in the directory containing the source code."
msgstr ""

#: ../../library/py_compile.rst:27
msgid ""
"Exception raised when an error occurs while attempting to compile the file."
msgstr ""

#: ../../library/py_compile.rst:32
msgid ""
"Compile a source file to byte-code and write out the byte-code cache file. "
"The source code is loaded from the file named *file*.  The byte-code is "
"written to *cfile*, which defaults to the :pep:`3147`/:pep:`488` path, "
"ending in ``.pyc``. For example, if *file* is ``/foo/bar/baz.py`` *cfile* "
"will default to ``/foo/bar/__pycache__/baz.cpython-32.pyc`` for Python 3.2.  "
"If *dfile* is specified, it is used instead of *file* as the name of the "
"source file from which source lines are obtained for display in exception "
"tracebacks. If *doraise* is true, a :exc:`PyCompileError` is raised when an "
"error is encountered while compiling *file*. If *doraise* is false (the "
"default), an error string is written to ``sys.stderr``, but no exception is "
"raised.  This function returns the path to byte-compiled file, i.e. whatever "
"*cfile* value was used."
msgstr ""

#: ../../library/py_compile.rst:46
msgid ""
"The *doraise* and *quiet* arguments determine how errors are handled while "
"compiling file. If *quiet* is 0 or 1, and *doraise* is false, the default "
"behaviour is enabled: an error string is written to ``sys.stderr``, and the "
"function returns ``None`` instead of a path. If *doraise* is true, a :exc:"
"`PyCompileError` is raised instead. However if *quiet* is 2, no message is "
"written, and *doraise* has no effect."
msgstr ""

#: ../../library/py_compile.rst:53
msgid ""
"If the path that *cfile* becomes (either explicitly specified or computed) "
"is a symlink or non-regular file, :exc:`FileExistsError` will be raised. "
"This is to act as a warning that import will turn those paths into regular "
"files if it is allowed to write byte-compiled files to those paths. This is "
"a side-effect of import using file renaming to place the final byte-compiled "
"file into place to prevent concurrent file writing issues."
msgstr ""

#: ../../library/py_compile.rst:60
msgid ""
"*optimize* controls the optimization level and is passed to the built-in :"
"func:`compile` function.  The default of ``-1`` selects the optimization "
"level of the current interpreter."
msgstr ""

#: ../../library/py_compile.rst:64
msgid ""
"*invalidation_mode* should be a member of the :class:`PycInvalidationMode` "
"enum and controls how the generated bytecode cache is invalidated at "
"runtime.  The default is :attr:`PycInvalidationMode.CHECKED_HASH` if the :"
"envvar:`SOURCE_DATE_EPOCH` environment variable is set, otherwise the "
"default is :attr:`PycInvalidationMode.TIMESTAMP`."
msgstr ""

#: ../../library/py_compile.rst:70
msgid ""
"Changed default value of *cfile* to be :PEP:`3147`-compliant.  Previous "
"default was *file* + ``'c'`` (``'o'`` if optimization was enabled). Also "
"added the *optimize* parameter."
msgstr ""

#: ../../library/py_compile.rst:75
msgid ""
"Changed code to use :mod:`importlib` for the byte-code cache file writing. "
"This means file creation/writing semantics now match what :mod:`importlib` "
"does, e.g. permissions, write-and-move semantics, etc. Also added the caveat "
"that :exc:`FileExistsError` is raised if *cfile* is a symlink or non-regular "
"file."
msgstr ""

#: ../../library/py_compile.rst:82
msgid ""
"The *invalidation_mode* parameter was added as specified in :pep:`552`. If "
"the :envvar:`SOURCE_DATE_EPOCH` environment variable is set, "
"*invalidation_mode* will be forced to :attr:`PycInvalidationMode."
"CHECKED_HASH`."
msgstr ""

#: ../../library/py_compile.rst:88
msgid ""
"The :envvar:`SOURCE_DATE_EPOCH` environment variable no longer overrides the "
"value of the *invalidation_mode* argument, and determines its default value "
"instead."
msgstr ""

#: ../../library/py_compile.rst:93
msgid "The *quiet* parameter was added."
msgstr "新增 *quiet* 參數。"

#: ../../library/py_compile.rst:99
msgid ""
"An enumeration of possible methods the interpreter can use to determine "
"whether a bytecode file is up to date with a source file. The ``.pyc`` file "
"indicates the desired invalidation mode in its header. See :ref:`pyc-"
"invalidation` for more information on how Python invalidates ``.pyc`` files "
"at runtime."
msgstr ""

#: ../../library/py_compile.rst:109
msgid ""
"The ``.pyc`` file includes the timestamp and size of the source file, which "
"Python will compare against the metadata of the source file at runtime to "
"determine if the ``.pyc`` file needs to be regenerated."
msgstr ""

#: ../../library/py_compile.rst:115
msgid ""
"The ``.pyc`` file includes a hash of the source file content, which Python "
"will compare against the source at runtime to determine if the ``.pyc`` file "
"needs to be regenerated."
msgstr ""

#: ../../library/py_compile.rst:121
msgid ""
"Like :attr:`CHECKED_HASH`, the ``.pyc`` file includes a hash of the source "
"file content. However, Python will at runtime assume the ``.pyc`` file is up "
"to date and not validate the ``.pyc`` against the source file at all."
msgstr ""

#: ../../library/py_compile.rst:125
msgid ""
"This option is useful when the ``.pycs`` are kept up to date by some system "
"external to Python like a build system."
msgstr ""

#: ../../library/py_compile.rst:131
msgid "Command-Line Interface"
msgstr ""

#: ../../library/py_compile.rst:133
msgid ""
"This module can be invoked as a script to compile several source files.  The "
"files named in *filenames* are compiled and the resulting bytecode is cached "
"in the normal manner.  This program does not search a directory structure to "
"locate source files; it only compiles files named explicitly. The exit "
"status is nonzero if one of the files could not be compiled."
msgstr ""

#: ../../library/py_compile.rst:145
msgid ""
"Positional arguments are files to compile.  If ``-`` is the only parameter, "
"the list of files is taken from standard input."
msgstr ""

#: ../../library/py_compile.rst:150
msgid "Suppress errors output."
msgstr ""

#: ../../library/py_compile.rst:152
msgid "Added support for ``-``."
msgstr "新增對 ``-`` 的支援。"

#: ../../library/py_compile.rst:155
msgid "Added support for :option:`-q`."
msgstr "新增對 :option:`-q` 的支援。"

#: ../../library/py_compile.rst:161
msgid "Module :mod:`compileall`"
msgstr ":mod:`compileall` 模組"

#: ../../library/py_compile.rst:162
msgid "Utilities to compile all Python source files in a directory tree."
msgstr ""

#: ../../library/py_compile.rst:12
msgid "file"
msgstr "file（檔案）"

#: ../../library/py_compile.rst:12
msgid "byte-code"
msgstr "byte-code（位元組碼）"