Skip to content

Commit ac5d692

Browse files
github-actions[bot]github-actions[bot]
authored
sync with cpython 665a3495
1 parent 71ca89d commit ac5d692

File tree

8 files changed

+903
-654
lines changed

8 files changed

+903
-654
lines changed

‎deprecations/index.po‎

Lines changed: 69 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ msgid ""
55
msgstr ""
66
"Project-Id-Version: Python 3.14\n"
77
"Report-Msgid-Bugs-To: \n"
8-
"POT-Creation-Date: 2025-09-18 00:15+0000\n"
8+
"POT-Creation-Date: 2025-09-19 00:15+0000\n"
99
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
1010
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
1111
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -181,7 +181,7 @@ msgstr ""
181181
"`101866` 貢獻。）"
182182

183183
#: ../../deprecations/pending-removal-in-3.15.rst:80
184-
#: ../../deprecations/pending-removal-in-3.17.rst:4
184+
#: ../../deprecations/pending-removal-in-3.17.rst:26
185185
msgid ":mod:`typing`:"
186186
msgstr ":mod:`typing`："
187187

@@ -476,8 +476,46 @@ msgstr ""
476476
msgid "Pending removal in Python 3.17"
477477
msgstr "Python 3.17 中待移除的項目"
478478

479+
#: ../../deprecations/pending-removal-in-3.17.rst:4
480+
msgid ":mod:`collections.abc`:"
481+
msgstr ":mod:`collections.abc`："
482+
479483
#: ../../deprecations/pending-removal-in-3.17.rst:6
480484
msgid ""
485+
":class:`collections.abc.ByteString` is scheduled for removal in Python 3.17."
486+
msgstr ""
487+
488+
#: ../../deprecations/pending-removal-in-3.17.rst:8
489+
#: ../../deprecations/pending-removal-in-3.17.rst:36
490+
msgid ""
491+
"Use ``isinstance(obj, collections.abc.Buffer)`` to test if ``obj`` "
492+
"implements the :ref:`buffer protocol <bufferobjects>` at runtime. For use in "
493+
"type annotations, either use :class:`~collections.abc.Buffer` or a union "
494+
"that explicitly specifies the types your code supports (e.g., ``bytes | "
495+
"bytearray | memoryview``)."
496+
msgstr ""
497+
498+
#: ../../deprecations/pending-removal-in-3.17.rst:14
499+
#: ../../deprecations/pending-removal-in-3.17.rst:42
500+
msgid ""
501+
":class:`!ByteString` was originally intended to be an abstract class that "
502+
"would serve as a supertype of both :class:`bytes` and :class:`bytearray`. "
503+
"However, since the ABC never had any methods, knowing that an object was an "
504+
"instance of :class:`!ByteString` never actually told you anything useful "
505+
"about the object. Other common buffer types such as :class:`memoryview` were "
506+
"also never understood as subtypes of :class:`!ByteString` (either at runtime "
507+
"or by static type checkers)."
508+
msgstr ""
509+
510+
#: ../../deprecations/pending-removal-in-3.17.rst:22
511+
#: ../../deprecations/pending-removal-in-3.17.rst:50
512+
msgid ""
513+
"See :pep:`PEP 688 <688#current-options>` for more details. (Contributed by "
514+
"Shantanu Jain in :gh:`91896`.)"
515+
msgstr ""
516+
517+
#: ../../deprecations/pending-removal-in-3.17.rst:28
518+
msgid ""
481519
"Before Python 3.14, old-style unions were implemented using the private "
482520
"class ``typing._UnionGenericAlias``. This class is no longer needed for the "
483521
"implementation, but it has been retained for backward compatibility, with "
@@ -490,35 +528,11 @@ msgstr ""
490528
"除。使用者應該改用文件中記錄的內省輔助函式，例如 :func:`typing.get_origin` "
491529
"和 :func:`typing.get_args`，或者依賴私有實作細節。"
492530

493-
#: ../../deprecations/pending-removal-in-3.17.rst:11
531+
#: ../../deprecations/pending-removal-in-3.17.rst:33
494532
msgid ""
495533
":class:`typing.ByteString`, deprecated since Python 3.9, is scheduled for "
496-
"removal in Python 3.17. Prefer :class:`~collections.abc.Sequence` or :class:"
497-
"`~collections.abc.Buffer`. For use in type annotations, prefer a union, like "
498-
"``bytes | bytearray``, or :class:`collections.abc.Buffer`. (Contributed by "
499-
"Shantanu Jain in :gh:`91896`.)"
534+
"removal in Python 3.17."
500535
msgstr ""
501-
"自 Python 3.9 起已被棄用的 :class:`typing.ByteString`，計劃在 Python "
502-
"3.17 中移除。建議改用 :class:`~collections.abc.Sequence` 或 :class:`~"
503-
"collections.abc.Buffer`。在型別註釋中建議改用聯集，例如 ``bytes | "
504-
"bytearray`` 或 :class:`collections.abc.Buffer`。（Shantanu Jain 於 :gh:`91896` 貢獻。）"
505-
506-
#: ../../deprecations/pending-removal-in-3.17.rst:17
507-
msgid ":mod:`collections.abc`:"
508-
msgstr ":mod:`collections.abc`："
509-
510-
#: ../../deprecations/pending-removal-in-3.17.rst:19
511-
msgid ""
512-
":class:`collections.abc.ByteString` is scheduled for removal in Python 3.17. "
513-
"Prefer :class:`~collections.abc.Sequence` or :class:`~collections.abc."
514-
"Buffer`. For use in type annotations, prefer a union, like ``bytes | "
515-
"bytearray``, or :class:`collections.abc.Buffer`. (Contributed by Shantanu "
516-
"Jain in :gh:`91896`.)"
517-
msgstr ""
518-
":class:`collections.abc.ByteString` 計劃在 Python 3.17 中移除。建議改用 "
519-
":class:`~collections.abc.Sequence` 或 :class:`~collections.abc.Buffer`。在"
520-
"型別註釋中建議改用聯集，例如 ``bytes | bytearray`` 或 :class:`collections.abc."
521-
"Buffer`。（Shantanu Jain 於 :gh:`91896` 貢獻。）"
522536

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

14751489
#: ../../deprecations/c-api-pending-removal-in-future.rst:4
14761490
msgid ""
@@ -1574,3 +1588,28 @@ msgstr ""
15741588
#: ../../deprecations/c-api-pending-removal-in-future.rst:41
15751589
msgid ":c:func:`PyThread_ReInitTLS`: Unneeded since Python 3.7."
15761590
msgstr ":c:func:`PyThread_ReInitTLS`：自 Python 3.7 起不再需要。"
1591+
1592+
#~ msgid ""
1593+
#~ ":class:`typing.ByteString`, deprecated since Python 3.9, is scheduled for "
1594+
#~ "removal in Python 3.17. Prefer :class:`~collections.abc.Sequence` or :"
1595+
#~ "class:`~collections.abc.Buffer`. For use in type annotations, prefer a "
1596+
#~ "union, like ``bytes | bytearray``, or :class:`collections.abc.Buffer`. "
1597+
#~ "(Contributed by Shantanu Jain in :gh:`91896`.)"
1598+
#~ msgstr ""
1599+
#~ "自 Python 3.9 起已被棄用的 :class:`typing.ByteString`，計劃在 Python 3.17 "
1600+
#~ "中移除。建議改用 :class:`~collections.abc.Sequence` 或 :class:"
1601+
#~ "`~collections.abc.Buffer`。在型別註釋中建議改用聯集，例如 ``bytes | "
1602+
#~ "bytearray`` 或 :class:`collections.abc.Buffer`。（Shantanu Jain 於 :gh:"
1603+
#~ "`91896` 貢獻。）"
1604+
1605+
#~ msgid ""
1606+
#~ ":class:`collections.abc.ByteString` is scheduled for removal in Python "
1607+
#~ "3.17. Prefer :class:`~collections.abc.Sequence` or :class:`~collections."
1608+
#~ "abc.Buffer`. For use in type annotations, prefer a union, like ``bytes | "
1609+
#~ "bytearray``, or :class:`collections.abc.Buffer`. (Contributed by Shantanu "
1610+
#~ "Jain in :gh:`91896`.)"
1611+
#~ msgstr ""
1612+
#~ ":class:`collections.abc.ByteString` 計劃在 Python 3.17 中移除。建議改用 :"
1613+
#~ "class:`~collections.abc.Sequence` 或 :class:`~collections.abc.Buffer`。在"
1614+
#~ "型別註釋中建議改用聯集，例如 ``bytes | bytearray`` 或 :class:`collections."
1615+
#~ "abc.Buffer`。（Shantanu Jain 於 :gh:`91896` 貢獻。）"

‎deprecations/pending-removal-in-3.17.po‎

Lines changed: 65 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ msgid ""
77
msgstr ""
88
"Project-Id-Version: Python 3.14\n"
99
"Report-Msgid-Bugs-To: \n"
10-
"POT-Creation-Date: 2025-09-18 00:15+0000\n"
10+
"POT-Creation-Date: 2025-09-19 00:15+0000\n"
1111
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
1212
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
1313
"Language-Team: LANGUAGE <[email protected]>\n"
@@ -21,10 +21,48 @@ msgid "Pending removal in Python 3.17"
2121
msgstr "Python 3.17 中待移除的項目"
2222

2323
#: ../../deprecations/pending-removal-in-3.17.rst:4
24+
msgid ":mod:`collections.abc`:"
25+
msgstr ":mod:`collections.abc`："
26+
27+
#: ../../deprecations/pending-removal-in-3.17.rst:6
28+
msgid ""
29+
":class:`collections.abc.ByteString` is scheduled for removal in Python 3.17."
30+
msgstr ""
31+
32+
#: ../../deprecations/pending-removal-in-3.17.rst:8
33+
#: ../../deprecations/pending-removal-in-3.17.rst:36
34+
msgid ""
35+
"Use ``isinstance(obj, collections.abc.Buffer)`` to test if ``obj`` "
36+
"implements the :ref:`buffer protocol <bufferobjects>` at runtime. For use in "
37+
"type annotations, either use :class:`~collections.abc.Buffer` or a union "
38+
"that explicitly specifies the types your code supports (e.g., ``bytes | "
39+
"bytearray | memoryview``)."
40+
msgstr ""
41+
42+
#: ../../deprecations/pending-removal-in-3.17.rst:14
43+
#: ../../deprecations/pending-removal-in-3.17.rst:42
44+
msgid ""
45+
":class:`!ByteString` was originally intended to be an abstract class that "
46+
"would serve as a supertype of both :class:`bytes` and :class:`bytearray`. "
47+
"However, since the ABC never had any methods, knowing that an object was an "
48+
"instance of :class:`!ByteString` never actually told you anything useful "
49+
"about the object. Other common buffer types such as :class:`memoryview` were "
50+
"also never understood as subtypes of :class:`!ByteString` (either at runtime "
51+
"or by static type checkers)."
52+
msgstr ""
53+
54+
#: ../../deprecations/pending-removal-in-3.17.rst:22
55+
#: ../../deprecations/pending-removal-in-3.17.rst:50
56+
msgid ""
57+
"See :pep:`PEP 688 <688#current-options>` for more details. (Contributed by "
58+
"Shantanu Jain in :gh:`91896`.)"
59+
msgstr ""
60+
61+
#: ../../deprecations/pending-removal-in-3.17.rst:26
2462
msgid ":mod:`typing`:"
2563
msgstr ":mod:`typing`："
2664

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

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

54-
#: ../../deprecations/pending-removal-in-3.17.rst:17
55-
msgid ":mod:`collections.abc`:"
56-
msgstr ":mod:`collections.abc`："
85+
#~ msgid ""
86+
#~ ":class:`typing.ByteString`, deprecated since Python 3.9, is scheduled for "
87+
#~ "removal in Python 3.17. Prefer :class:`~collections.abc.Sequence` or :"
88+
#~ "class:`~collections.abc.Buffer`. For use in type annotations, prefer a "
89+
#~ "union, like ``bytes | bytearray``, or :class:`collections.abc.Buffer`. "
90+
#~ "(Contributed by Shantanu Jain in :gh:`91896`.)"
91+
#~ msgstr ""
92+
#~ "自 Python 3.9 起已被棄用的 :class:`typing.ByteString`，計劃在 Python 3.17 "
93+
#~ "中移除。建議改用 :class:`~collections.abc.Sequence` 或 :class:"
94+
#~ "`~collections.abc.Buffer`。在型別註釋中建議改用聯集，例如 ``bytes | "
95+
#~ "bytearray`` 或 :class:`collections.abc.Buffer`。（Shantanu Jain 於 :gh:"
96+
#~ "`91896` 貢獻。）"
5797

58-
#: ../../deprecations/pending-removal-in-3.17.rst:19
59-
msgid ""
60-
":class:`collections.abc.ByteString` is scheduled for removal in Python 3.17. "
61-
"Prefer :class:`~collections.abc.Sequence` or :class:`~collections.abc."
62-
"Buffer`. For use in type annotations, prefer a union, like ``bytes | "
63-
"bytearray``, or :class:`collections.abc.Buffer`. (Contributed by Shantanu "
64-
"Jain in :gh:`91896`.)"
65-
msgstr ""
66-
":class:`collections.abc.ByteString` 計劃在 Python 3.17 中移除。建議改用 "
67-
":class:`~collections.abc.Sequence` 或 :class:`~collections.abc.Buffer`。在"
68-
"型別註釋中建議改用聯集，例如 ``bytes | bytearray`` 或 :class:`collections.abc."
69-
"Buffer`。（Shantanu Jain 於 :gh:`91896` 貢獻。）"
98+
#~ msgid ""
99+
#~ ":class:`collections.abc.ByteString` is scheduled for removal in Python "
100+
#~ "3.17. Prefer :class:`~collections.abc.Sequence` or :class:`~collections."
101+
#~ "abc.Buffer`. For use in type annotations, prefer a union, like ``bytes | "
102+
#~ "bytearray``, or :class:`collections.abc.Buffer`. (Contributed by Shantanu "
103+
#~ "Jain in :gh:`91896`.)"
104+
#~ msgstr ""
105+
#~ ":class:`collections.abc.ByteString` 計劃在 Python 3.17 中移除。建議改用 :"
106+
#~ "class:`~collections.abc.Sequence` 或 :class:`~collections.abc.Buffer`。在"
107+
#~ "型別註釋中建議改用聯集，例如 ``bytes | bytearray`` 或 :class:`collections."
108+
#~ "abc.Buffer`。（Shantanu Jain 於 :gh:`91896` 貢獻。）"

0 commit comments

Comments
 (0)