sync with cpython c7aa3928

Author: github-actions[bot]

library/email.mime.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.11\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-10-15 20:43+0000\n"
+"POT-Creation-Date: 2023-01-15 00:34+0000\n"
 "PO-Revision-Date: 2018-05-23 16:00+0000\n"
 "Last-Translator: Adrian Liaw <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -165,9 +165,9 @@ msgstr "模組：\\ :mod:`email.mime.application`"
 msgid ""
 "A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:"
 "`MIMEApplication` class is used to represent MIME message objects of major "
-"type :mimetype:`application`.  *_data* is a string containing the raw byte "
-"data.  Optional *_subtype* specifies the MIME subtype and defaults to :"
-"mimetype:`octet-stream`."
+"type :mimetype:`application`.  *_data* contains the bytes for the raw "
+"application data.  Optional *_subtype* specifies the MIME subtype and "
+"defaults to :mimetype:`octet-stream`."
 msgstr ""
 
 #: ../../library/email.mime.rst:121
@@ -194,7 +194,7 @@ msgstr "模組：\\ :mod:`email.mime.audio`"
 msgid ""
 "A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:"
 "`MIMEAudio` class is used to create MIME message objects of major type :"
-"mimetype:`audio`. *_audiodata* is a string containing the raw audio data.  "
+"mimetype:`audio`. *_audiodata* contains the bytes for the raw audio data.  "
 "If this data can be decoded as au, wav, aiff, or aifc, then the subtype will "
 "be automatically included in the :mailheader:`Content-Type` header. "
 "Otherwise you can explicitly specify the audio subtype via the *_subtype* "
@@ -222,7 +222,7 @@ msgstr "模組：\\ :mod:`email.mime.image`"
 msgid ""
 "A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:"
 "`MIMEImage` class is used to create MIME message objects of major type :"
-"mimetype:`image`. *_imagedata* is a string containing the raw image data.  "
+"mimetype:`image`. *_imagedata* contains the bytes for the raw image data.  "
 "If this data type can be detected (jpeg, png, gif, tiff, rgb, pbm, pgm, ppm, "
 "rast, xbm, bmp, webp, and exr attempted), then the subtype will be "
 "automatically included in the :mailheader:`Content-Type` header. Otherwise "

library/sqlite3.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.11\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-01-02 00:31+0000\n"
+"POT-Creation-Date: 2023-01-15 00:34+0000\n"
 "PO-Revision-Date: 2018-05-23 16:10+0000\n"
 "Last-Translator: Adrian Liaw <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -1760,29 +1760,38 @@ msgid ""
 "Instead, use the DB-API's parameter substitution. To insert a variable into "
 "a query string, use a placeholder in the string, and substitute the actual "
 "values into the query by providing them as a :class:`tuple` of values to the "
-"second argument of the cursor's :meth:`~Cursor.execute` method. An SQL "
-"statement may use one of two kinds of placeholders: question marks (qmark "
-"style) or named placeholders (named style). For the qmark style, "
-"``parameters`` must be a :term:`sequence <sequence>`. For the named style, "
-"it can be either a :term:`sequence <sequence>` or :class:`dict` instance. "
-"The length of the :term:`sequence <sequence>` must match the number of "
-"placeholders, or a :exc:`ProgrammingError` is raised. If a :class:`dict` is "
-"given, it must contain keys for all named parameters. Any extra items are "
-"ignored. Here's an example of both styles:"
-msgstr ""
-
-#: ../../library/sqlite3.rst:1865
+"second argument of the cursor's :meth:`~Cursor.execute` method."
+msgstr ""
+
+#: ../../library/sqlite3.rst:1828
+msgid ""
+"An SQL statement may use one of two kinds of placeholders: question marks "
+"(qmark style) or named placeholders (named style). For the qmark style, "
+"*parameters* must be a :term:`sequence` whose length must match the number "
+"of placeholders, or a :exc:`ProgrammingError` is raised. For the named "
+"style, *parameters* should be an instance of a :class:`dict` (or a "
+"subclass), which must contain keys for all named parameters; any extra items "
+"are ignored. Here's an example of both styles:"
+msgstr ""
+
+#: ../../library/sqlite3.rst:1866
+msgid ""
+":pep:`249` numeric placeholders are *not* supported. If used, they will be "
+"interpreted as named placeholders."
+msgstr ""
+
+#: ../../library/sqlite3.rst:1873
 msgid "How to adapt custom Python types to SQLite values"
 msgstr ""
 
-#: ../../library/sqlite3.rst:1867
+#: ../../library/sqlite3.rst:1875
 msgid ""
 "SQLite supports only a limited set of data types natively. To store custom "
 "Python types in SQLite databases, *adapt* them to one of the :ref:`Python "
 "types SQLite natively understands <sqlite3-types>`."
 msgstr ""
 
-#: ../../library/sqlite3.rst:1871
+#: ../../library/sqlite3.rst:1879
 msgid ""
 "There are two ways to adapt Python objects to SQLite types: letting your "
 "object adapt itself, or using an *adapter callable*. The latter will take "
@@ -1792,11 +1801,11 @@ msgid ""
 "custom adapter functions."
 msgstr ""
 
-#: ../../library/sqlite3.rst:1883
+#: ../../library/sqlite3.rst:1891
 msgid "How to write adaptable objects"
 msgstr ""
 
-#: ../../library/sqlite3.rst:1885
+#: ../../library/sqlite3.rst:1893
 msgid ""
 "Suppose we have a :class:`!Point` class that represents a pair of "
 "coordinates, ``x`` and ``y``, in a Cartesian coordinate system. The "
@@ -1806,84 +1815,84 @@ msgid ""
 "object passed to *protocol* will be of type :class:`PrepareProtocol`."
 msgstr ""
 
-#: ../../library/sqlite3.rst:1916
+#: ../../library/sqlite3.rst:1924
 msgid "How to register adapter callables"
 msgstr ""
 
-#: ../../library/sqlite3.rst:1918
+#: ../../library/sqlite3.rst:1926
 msgid ""
 "The other possibility is to create a function that converts the Python "
 "object to an SQLite-compatible type. This function can then be registered "
 "using :func:`register_adapter`."
 msgstr ""
 
-#: ../../library/sqlite3.rst:1948
+#: ../../library/sqlite3.rst:1956
 msgid "How to convert SQLite values to custom Python types"
 msgstr ""
 
-#: ../../library/sqlite3.rst:1950
+#: ../../library/sqlite3.rst:1958
 msgid ""
 "Writing an adapter lets you convert *from* custom Python types *to* SQLite "
 "values. To be able to convert *from* SQLite values *to* custom Python types, "
 "we use *converters*."
 msgstr ""
 
-#: ../../library/sqlite3.rst:1955
+#: ../../library/sqlite3.rst:1963
 msgid ""
 "Let's go back to the :class:`!Point` class. We stored the x and y "
 "coordinates separated via semicolons as strings in SQLite."
 msgstr ""
 
-#: ../../library/sqlite3.rst:1958
+#: ../../library/sqlite3.rst:1966
 msgid ""
 "First, we'll define a converter function that accepts the string as a "
 "parameter and constructs a :class:`!Point` object from it."
 msgstr ""
 
-#: ../../library/sqlite3.rst:1963
+#: ../../library/sqlite3.rst:1971
 msgid ""
 "Converter functions are **always** passed a :class:`bytes` object, no matter "
 "the underlying SQLite data type."
 msgstr ""
 
-#: ../../library/sqlite3.rst:1972
+#: ../../library/sqlite3.rst:1980
 msgid ""
 "We now need to tell :mod:`!sqlite3` when it should convert a given SQLite "
 "value. This is done when connecting to a database, using the *detect_types* "
 "parameter of :func:`connect`. There are three options:"
 msgstr ""
 
-#: ../../library/sqlite3.rst:1976
+#: ../../library/sqlite3.rst:1984
 msgid "Implicit: set *detect_types* to :const:`PARSE_DECLTYPES`"
 msgstr ""
 
-#: ../../library/sqlite3.rst:1977
+#: ../../library/sqlite3.rst:1985
 msgid "Explicit: set *detect_types* to :const:`PARSE_COLNAMES`"
 msgstr ""
 
-#: ../../library/sqlite3.rst:1978
+#: ../../library/sqlite3.rst:1986
 msgid ""
 "Both: set *detect_types* to ``sqlite3.PARSE_DECLTYPES | sqlite3."
 "PARSE_COLNAMES``. Column names take precedence over declared types."
 msgstr ""
 
-#: ../../library/sqlite3.rst:1982
+#: ../../library/sqlite3.rst:1990
 msgid "The following example illustrates the implicit and explicit approaches:"
 msgstr ""
 
-#: ../../library/sqlite3.rst:2033
+#: ../../library/sqlite3.rst:2041
 msgid "Adapter and converter recipes"
 msgstr ""
 
-#: ../../library/sqlite3.rst:2035
+#: ../../library/sqlite3.rst:2043
 msgid "This section shows recipes for common adapters and converters."
 msgstr ""
 
-#: ../../library/sqlite3.rst:2097
+#: ../../library/sqlite3.rst:2105
 msgid "How to use connection shortcut methods"
 msgstr ""
 
-#: ../../library/sqlite3.rst:2099
+#: ../../library/sqlite3.rst:2107
 msgid ""
 "Using the :meth:`~Connection.execute`, :meth:`~Connection.executemany`, and :"
 "meth:`~Connection.executescript` methods of the :class:`Connection` class, "
@@ -1895,11 +1904,11 @@ msgid ""
 "object."
 msgstr ""
 
-#: ../../library/sqlite3.rst:2140
+#: ../../library/sqlite3.rst:2148
 msgid "How to use the connection context manager"
 msgstr ""
 
-#: ../../library/sqlite3.rst:2142
+#: ../../library/sqlite3.rst:2150
 msgid ""
 "A :class:`Connection` object can be used as a context manager that "
 "automatically commits or rolls back open transactions when leaving the body "
@@ -1909,118 +1918,118 @@ msgid ""
 "exception, the transaction is rolled back."
 msgstr ""
 
-#: ../../library/sqlite3.rst:2151
+#: ../../library/sqlite3.rst:2159
 msgid ""
 "If there is no open transaction upon leaving the body of the ``with`` "
 "statement, the context manager is a no-op."
 msgstr ""
 
-#: ../../library/sqlite3.rst:2156
+#: ../../library/sqlite3.rst:2164
 msgid ""
 "The context manager neither implicitly opens a new transaction nor closes "
 "the connection."
 msgstr ""
 
-#: ../../library/sqlite3.rst:2189
+#: ../../library/sqlite3.rst:2197
 msgid "How to work with SQLite URIs"
 msgstr ""
 
-#: ../../library/sqlite3.rst:2191
+#: ../../library/sqlite3.rst:2199
 msgid "Some useful URI tricks include:"
 msgstr ""
 
-#: ../../library/sqlite3.rst:2193
+#: ../../library/sqlite3.rst:2201
 msgid "Open a database in read-only mode:"
 msgstr ""
 
-#: ../../library/sqlite3.rst:2202
+#: ../../library/sqlite3.rst:2210
 msgid ""
 "Do not implicitly create a new database file if it does not already exist; "
 "will raise :exc:`~sqlite3.OperationalError` if unable to create a new file:"
 msgstr ""
 
-#: ../../library/sqlite3.rst:2212
+#: ../../library/sqlite3.rst:2220
 msgid "Create a shared named in-memory database:"
 msgstr ""
 
-#: ../../library/sqlite3.rst:2226
+#: ../../library/sqlite3.rst:2234
 msgid ""
 "More information about this feature, including a list of parameters, can be "
 "found in the `SQLite URI documentation`_."
 msgstr ""
 
-#: ../../library/sqlite3.rst:2235
+#: ../../library/sqlite3.rst:2243
 msgid "How to create and use row factories"
 msgstr ""
 
-#: ../../library/sqlite3.rst:2237
+#: ../../library/sqlite3.rst:2245
 msgid ""
 "By default, :mod:`!sqlite3` represents each row as a :class:`tuple`. If a :"
 "class:`!tuple` does not suit your needs, you can use the :class:`sqlite3."
 "Row` class or a custom :attr:`~Cursor.row_factory`."
 msgstr ""
 
-#: ../../library/sqlite3.rst:2242
+#: ../../library/sqlite3.rst:2250
 msgid ""
 "While :attr:`!row_factory` exists as an attribute both on the :class:"
 "`Cursor` and the :class:`Connection`, it is recommended to set :class:"
 "`Connection.row_factory`, so all cursors created from the connection will "
 "use the same row factory."
 msgstr ""
 
-#: ../../library/sqlite3.rst:2247
+#: ../../library/sqlite3.rst:2255
 msgid ""
 ":class:`!Row` provides indexed and case-insensitive named access to columns, "
 "with minimal memory overhead and performance impact over a :class:`!tuple`. "
 "To use :class:`!Row` as a row factory, assign it to the :attr:`!row_factory` "
 "attribute:"
 msgstr ""
 
-#: ../../library/sqlite3.rst:2257
+#: ../../library/sqlite3.rst:2265
 msgid "Queries now return :class:`!Row` objects:"
 msgstr ""
 
-#: ../../library/sqlite3.rst:2272
+#: ../../library/sqlite3.rst:2280
 msgid ""
 "You can create a custom :attr:`~Cursor.row_factory` that returns each row as "
 "a :class:`dict`, with column names mapped to values:"
 msgstr ""
 
-#: ../../library/sqlite3.rst:2281
+#: ../../library/sqlite3.rst:2289
 msgid ""
 "Using it, queries now return a :class:`!dict` instead of a :class:`!tuple`:"
 msgstr ""
 
-#: ../../library/sqlite3.rst:2291
+#: ../../library/sqlite3.rst:2299
 msgid "The following row factory returns a :term:`named tuple`:"
 msgstr ""
 
-#: ../../library/sqlite3.rst:2302
+#: ../../library/sqlite3.rst:2310
 msgid ":func:`!namedtuple_factory` can be used as follows:"
 msgstr ""
 
-#: ../../library/sqlite3.rst:2317
+#: ../../library/sqlite3.rst:2325
 msgid ""
 "With some adjustments, the above recipe can be adapted to use a :class:"
 "`~dataclasses.dataclass`, or any other custom class, instead of a :class:"
 "`~collections.namedtuple`."
 msgstr ""
 
-#: ../../library/sqlite3.rst:2325
+#: ../../library/sqlite3.rst:2333
 msgid "Explanation"
 msgstr "解釋"
 
-#: ../../library/sqlite3.rst:2330
+#: ../../library/sqlite3.rst:2338
 msgid "Transaction control"
 msgstr ""
 
-#: ../../library/sqlite3.rst:2332
+#: ../../library/sqlite3.rst:2340
 msgid ""
 "The :mod:`!sqlite3` module does not adhere to the transaction handling "
 "recommended by :pep:`249`."
 msgstr ""
 
-#: ../../library/sqlite3.rst:2335
+#: ../../library/sqlite3.rst:2343
 msgid ""
 "If the connection attribute :attr:`~Connection.isolation_level` is not "
 "``None``, new transactions are implicitly opened before :meth:`~Cursor."
@@ -2034,7 +2043,7 @@ msgid ""
 "attribute."
 msgstr ""
 
-#: ../../library/sqlite3.rst:2348
+#: ../../library/sqlite3.rst:2356
 msgid ""
 "If :attr:`~Connection.isolation_level` is set to ``None``, no transactions "
 "are implicitly opened at all. This leaves the underlying SQLite library in "
@@ -2044,14 +2053,14 @@ msgid ""
 "in_transaction` attribute."
 msgstr ""
 
-#: ../../library/sqlite3.rst:2356
+#: ../../library/sqlite3.rst:2364
 msgid ""
 "The :meth:`~Cursor.executescript` method implicitly commits any pending "
 "transaction before execution of the given SQL script, regardless of the "
 "value of :attr:`~Connection.isolation_level`."
 msgstr ""
 
-#: ../../library/sqlite3.rst:2360
+#: ../../library/sqlite3.rst:2368
 msgid ""
 ":mod:`!sqlite3` used to implicitly commit an open transaction before DDL "
 "statements.  This is no longer the case."