Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
99 changes: 69 additions & 30 deletions deprecations/index.po
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-09-18 00:15+0000\n"
"POT-Creation-Date: 2025-09-19 00:15+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
Expand Down Expand Up @@ -181,7 +181,7 @@ msgstr ""
"`101866` 貢獻。)"

#: ../../deprecations/pending-removal-in-3.15.rst:80
#: ../../deprecations/pending-removal-in-3.17.rst:4
#: ../../deprecations/pending-removal-in-3.17.rst:26
msgid ":mod:`typing`:"
msgstr ":mod:`typing`:"

Expand Down Expand Up @@ -476,8 +476,46 @@ msgstr ""
msgid "Pending removal in Python 3.17"
msgstr "Python 3.17 中待移除的項目"

#: ../../deprecations/pending-removal-in-3.17.rst:4
msgid ":mod:`collections.abc`:"
msgstr ":mod:`collections.abc`:"

#: ../../deprecations/pending-removal-in-3.17.rst:6
msgid ""
":class:`collections.abc.ByteString` is scheduled for removal in Python 3.17."
msgstr ""

#: ../../deprecations/pending-removal-in-3.17.rst:8
#: ../../deprecations/pending-removal-in-3.17.rst:36
msgid ""
"Use ``isinstance(obj, collections.abc.Buffer)`` to test if ``obj`` "
"implements the :ref:`buffer protocol <bufferobjects>` at runtime. For use in "
"type annotations, either use :class:`~collections.abc.Buffer` or a union "
"that explicitly specifies the types your code supports (e.g., ``bytes | "
"bytearray | memoryview``)."
msgstr ""

#: ../../deprecations/pending-removal-in-3.17.rst:14
#: ../../deprecations/pending-removal-in-3.17.rst:42
msgid ""
":class:`!ByteString` was originally intended to be an abstract class that "
"would serve as a supertype of both :class:`bytes` and :class:`bytearray`. "
"However, since the ABC never had any methods, knowing that an object was an "
"instance of :class:`!ByteString` never actually told you anything useful "
"about the object. Other common buffer types such as :class:`memoryview` were "
"also never understood as subtypes of :class:`!ByteString` (either at runtime "
"or by static type checkers)."
msgstr ""

#: ../../deprecations/pending-removal-in-3.17.rst:22
#: ../../deprecations/pending-removal-in-3.17.rst:50
msgid ""
"See :pep:`PEP 688 <688#current-options>` for more details. (Contributed by "
"Shantanu Jain in :gh:`91896`.)"
msgstr ""

#: ../../deprecations/pending-removal-in-3.17.rst:28
msgid ""
"Before Python 3.14, old-style unions were implemented using the private "
"class ``typing._UnionGenericAlias``. This class is no longer needed for the "
"implementation, but it has been retained for backward compatibility, with "
Expand All @@ -490,35 +528,11 @@ msgstr ""
"除。使用者應該改用文件中記錄的內省輔助函式,例如 :func:`typing.get_origin` "
"和 :func:`typing.get_args`,或者依賴私有實作細節。"

#: ../../deprecations/pending-removal-in-3.17.rst:11
#: ../../deprecations/pending-removal-in-3.17.rst:33
msgid ""
":class:`typing.ByteString`, deprecated since Python 3.9, is scheduled for "
"removal in Python 3.17. Prefer :class:`~collections.abc.Sequence` or :class:"
"`~collections.abc.Buffer`. For use in type annotations, prefer a union, like "
"``bytes | bytearray``, or :class:`collections.abc.Buffer`. (Contributed by "
"Shantanu Jain in :gh:`91896`.)"
"removal in Python 3.17."
msgstr ""
"自 Python 3.9 起已被棄用的 :class:`typing.ByteString`,計劃在 Python "
"3.17 中移除。建議改用 :class:`~collections.abc.Sequence` 或 :class:`~"
"collections.abc.Buffer`。在型別註釋中建議改用聯集,例如 ``bytes | "
"bytearray`` 或 :class:`collections.abc.Buffer`。(Shantanu Jain 於 :gh:`91896` 貢獻。)"

#: ../../deprecations/pending-removal-in-3.17.rst:17
msgid ":mod:`collections.abc`:"
msgstr ":mod:`collections.abc`:"

#: ../../deprecations/pending-removal-in-3.17.rst:19
msgid ""
":class:`collections.abc.ByteString` is scheduled for removal in Python 3.17. "
"Prefer :class:`~collections.abc.Sequence` or :class:`~collections.abc."
"Buffer`. For use in type annotations, prefer a union, like ``bytes | "
"bytearray``, or :class:`collections.abc.Buffer`. (Contributed by Shantanu "
"Jain in :gh:`91896`.)"
msgstr ""
":class:`collections.abc.ByteString` 計劃在 Python 3.17 中移除。建議改用 "
":class:`~collections.abc.Sequence` 或 :class:`~collections.abc.Buffer`。在"
"型別註釋中建議改用聯集,例如 ``bytes | bytearray`` 或 :class:`collections.abc."
"Buffer`。(Shantanu Jain 於 :gh:`91896` 貢獻。)"

#: ../../deprecations/pending-removal-in-3.19.rst:2
msgid "Pending removal in Python 3.19"
Expand Down Expand Up @@ -1469,8 +1483,8 @@ msgid ""
"(Contributed by Victor Stinner in :gh:`128863`.)"
msgstr ""
"可以使用 `pythoncapi-compat project <https://github.com/python/pythoncapi-"
"compat/>`__ 來取得這些於 Python 3.13 及更早版本的新公開函式。(由 "
"Victor Stinner 在 :gh:`128863` 貢獻)"
"compat/>`__ 來取得這些於 Python 3.13 及更早版本的新公開函式。(由 Victor "
"Stinner 在 :gh:`128863` 貢獻)"

#: ../../deprecations/c-api-pending-removal-in-future.rst:4
msgid ""
Expand Down Expand Up @@ -1574,3 +1588,28 @@ msgstr ""
#: ../../deprecations/c-api-pending-removal-in-future.rst:41
msgid ":c:func:`PyThread_ReInitTLS`: Unneeded since Python 3.7."
msgstr ":c:func:`PyThread_ReInitTLS`:自 Python 3.7 起不再需要。"

#~ msgid ""
#~ ":class:`typing.ByteString`, deprecated since Python 3.9, is scheduled for "
#~ "removal in Python 3.17. Prefer :class:`~collections.abc.Sequence` or :"
#~ "class:`~collections.abc.Buffer`. For use in type annotations, prefer a "
#~ "union, like ``bytes | bytearray``, or :class:`collections.abc.Buffer`. "
#~ "(Contributed by Shantanu Jain in :gh:`91896`.)"
#~ msgstr ""
#~ "自 Python 3.9 起已被棄用的 :class:`typing.ByteString`,計劃在 Python 3.17 "
#~ "中移除。建議改用 :class:`~collections.abc.Sequence` 或 :class:"
#~ "`~collections.abc.Buffer`。在型別註釋中建議改用聯集,例如 ``bytes | "
#~ "bytearray`` 或 :class:`collections.abc.Buffer`。(Shantanu Jain 於 :gh:"
#~ "`91896` 貢獻。)"

#~ msgid ""
#~ ":class:`collections.abc.ByteString` is scheduled for removal in Python "
#~ "3.17. Prefer :class:`~collections.abc.Sequence` or :class:`~collections."
#~ "abc.Buffer`. For use in type annotations, prefer a union, like ``bytes | "
#~ "bytearray``, or :class:`collections.abc.Buffer`. (Contributed by Shantanu "
#~ "Jain in :gh:`91896`.)"
#~ msgstr ""
#~ ":class:`collections.abc.ByteString` 計劃在 Python 3.17 中移除。建議改用 :"
#~ "class:`~collections.abc.Sequence` 或 :class:`~collections.abc.Buffer`。在"
#~ "型別註釋中建議改用聯集,例如 ``bytes | bytearray`` 或 :class:`collections."
#~ "abc.Buffer`。(Shantanu Jain 於 :gh:`91896` 貢獻。)"
91 changes: 65 additions & 26 deletions deprecations/pending-removal-in-3.17.po
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-09-18 00:15+0000\n"
"POT-Creation-Date: 2025-09-19 00:15+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
Expand All @@ -21,10 +21,48 @@ msgid "Pending removal in Python 3.17"
msgstr "Python 3.17 中待移除的項目"

#: ../../deprecations/pending-removal-in-3.17.rst:4
msgid ":mod:`collections.abc`:"
msgstr ":mod:`collections.abc`:"

#: ../../deprecations/pending-removal-in-3.17.rst:6
msgid ""
":class:`collections.abc.ByteString` is scheduled for removal in Python 3.17."
msgstr ""

#: ../../deprecations/pending-removal-in-3.17.rst:8
#: ../../deprecations/pending-removal-in-3.17.rst:36
msgid ""
"Use ``isinstance(obj, collections.abc.Buffer)`` to test if ``obj`` "
"implements the :ref:`buffer protocol <bufferobjects>` at runtime. For use in "
"type annotations, either use :class:`~collections.abc.Buffer` or a union "
"that explicitly specifies the types your code supports (e.g., ``bytes | "
"bytearray | memoryview``)."
msgstr ""

#: ../../deprecations/pending-removal-in-3.17.rst:14
#: ../../deprecations/pending-removal-in-3.17.rst:42
msgid ""
":class:`!ByteString` was originally intended to be an abstract class that "
"would serve as a supertype of both :class:`bytes` and :class:`bytearray`. "
"However, since the ABC never had any methods, knowing that an object was an "
"instance of :class:`!ByteString` never actually told you anything useful "
"about the object. Other common buffer types such as :class:`memoryview` were "
"also never understood as subtypes of :class:`!ByteString` (either at runtime "
"or by static type checkers)."
msgstr ""

#: ../../deprecations/pending-removal-in-3.17.rst:22
#: ../../deprecations/pending-removal-in-3.17.rst:50
msgid ""
"See :pep:`PEP 688 <688#current-options>` for more details. (Contributed by "
"Shantanu Jain in :gh:`91896`.)"
msgstr ""

#: ../../deprecations/pending-removal-in-3.17.rst:26
msgid ":mod:`typing`:"
msgstr ":mod:`typing`:"

#: ../../deprecations/pending-removal-in-3.17.rst:6
#: ../../deprecations/pending-removal-in-3.17.rst:28
msgid ""
"Before Python 3.14, old-style unions were implemented using the private "
"class ``typing._UnionGenericAlias``. This class is no longer needed for the "
Expand All @@ -38,32 +76,33 @@ msgstr ""
"除。使用者應該改用文件中記錄的內省輔助函式,例如 :func:`typing.get_origin` "
"和 :func:`typing.get_args`,或者依賴私有實作細節。"

#: ../../deprecations/pending-removal-in-3.17.rst:11
#: ../../deprecations/pending-removal-in-3.17.rst:33
msgid ""
":class:`typing.ByteString`, deprecated since Python 3.9, is scheduled for "
"removal in Python 3.17. Prefer :class:`~collections.abc.Sequence` or :class:"
"`~collections.abc.Buffer`. For use in type annotations, prefer a union, like "
"``bytes | bytearray``, or :class:`collections.abc.Buffer`. (Contributed by "
"Shantanu Jain in :gh:`91896`.)"
"removal in Python 3.17."
msgstr ""
"自 Python 3.9 起已被棄用的 :class:`typing.ByteString`,計劃在 Python "
"3.17 中移除。建議改用 :class:`~collections.abc.Sequence` 或 :class:`~"
"collections.abc.Buffer`。在型別註釋中建議改用聯集,例如 ``bytes | "
"bytearray`` 或 :class:`collections.abc.Buffer`。(Shantanu Jain 於 :gh:`91896` 貢獻。)"

#: ../../deprecations/pending-removal-in-3.17.rst:17
msgid ":mod:`collections.abc`:"
msgstr ":mod:`collections.abc`:"
#~ msgid ""
#~ ":class:`typing.ByteString`, deprecated since Python 3.9, is scheduled for "
#~ "removal in Python 3.17. Prefer :class:`~collections.abc.Sequence` or :"
#~ "class:`~collections.abc.Buffer`. For use in type annotations, prefer a "
#~ "union, like ``bytes | bytearray``, or :class:`collections.abc.Buffer`. "
#~ "(Contributed by Shantanu Jain in :gh:`91896`.)"
#~ msgstr ""
#~ "自 Python 3.9 起已被棄用的 :class:`typing.ByteString`,計劃在 Python 3.17 "
#~ "中移除。建議改用 :class:`~collections.abc.Sequence` 或 :class:"
#~ "`~collections.abc.Buffer`。在型別註釋中建議改用聯集,例如 ``bytes | "
#~ "bytearray`` 或 :class:`collections.abc.Buffer`。(Shantanu Jain 於 :gh:"
#~ "`91896` 貢獻。)"

#: ../../deprecations/pending-removal-in-3.17.rst:19
msgid ""
":class:`collections.abc.ByteString` is scheduled for removal in Python 3.17. "
"Prefer :class:`~collections.abc.Sequence` or :class:`~collections.abc."
"Buffer`. For use in type annotations, prefer a union, like ``bytes | "
"bytearray``, or :class:`collections.abc.Buffer`. (Contributed by Shantanu "
"Jain in :gh:`91896`.)"
msgstr ""
":class:`collections.abc.ByteString` 計劃在 Python 3.17 中移除。建議改用 "
":class:`~collections.abc.Sequence` 或 :class:`~collections.abc.Buffer`。在"
"型別註釋中建議改用聯集,例如 ``bytes | bytearray`` 或 :class:`collections.abc."
"Buffer`。(Shantanu Jain 於 :gh:`91896` 貢獻。)"
#~ msgid ""
#~ ":class:`collections.abc.ByteString` is scheduled for removal in Python "
#~ "3.17. Prefer :class:`~collections.abc.Sequence` or :class:`~collections."
#~ "abc.Buffer`. For use in type annotations, prefer a union, like ``bytes | "
#~ "bytearray``, or :class:`collections.abc.Buffer`. (Contributed by Shantanu "
#~ "Jain in :gh:`91896`.)"
#~ msgstr ""
#~ ":class:`collections.abc.ByteString` 計劃在 Python 3.17 中移除。建議改用 :"
#~ "class:`~collections.abc.Sequence` 或 :class:`~collections.abc.Buffer`。在"
#~ "型別註釋中建議改用聯集,例如 ``bytes | bytearray`` 或 :class:`collections."
#~ "abc.Buffer`。(Shantanu Jain 於 :gh:`91896` 貢獻。)"
Loading