Merge 3.11 into 3.10

github-actions · github-actions · commit e59b4c2ba031 · 2024-06-09T23:49:25.000Z
diff --git a/library/__future__.po b/library/__future__.po
@@ -291,6 +291,13 @@ msgid ""
 "python-dev@python.org/message/VIZEBX5EYMSYIJNDBF6DMUMZOCWHARSO/>`__). No "
 "final decision has been made yet. See also :pep:`563` and :pep:`649`."
 msgstr ""
+"``from __future__ import annotations`` は以前は Python 3.10 で必須となる予定"
+"でしたが、 Python 運営評議会はこの変更を延期することを2度決定しました "
+"(`Python 3.10 での発表 <https://mail.python.org/archives/list/python-"
+"dev@python.org/message/CLVXXPQ2T2LQ5MP2Y53VVQFCXYWQJHKZ/>`__; `Python 3.11 で"
+"の発表 <https://mail.python.org/archives/list/python-dev@python.org/message/"
+"VIZEBX5EYMSYIJNDBF6DMUMZOCWHARSO/>`__) 。最終決定はまだ下されていません。 :"
+"pep:`563` と :pep:`649` も参照してください。"
 
 #: ../../library/__future__.rst:110
 msgid ":ref:`future`"
diff --git a/library/__main__.po b/library/__main__.po
@@ -103,6 +103,11 @@ msgid ""
 "program needs. Sometimes \"top-level code\" is called an *entry point* to "
 "the application."
 msgstr ""
+"``__main__`` は、トップレベルのコードが実行される環境の名前です。 \"トップレ"
+"ベルのコード\" は、実行を開始する最初のユーザー指定の Python モジュールです。"
+"これは、このモジュールがプログラムに必要なすべての他のモジュールをインポート"
+"するために、 \"トップレベル\" なのです。時折、 \"トップレベルのコード\" は、"
+"アプリケーションには *エントリーポイント* と呼ばれます。"
 
 #: ../../library/__main__.rst:53
 msgid "The top-level code environment can be:"
@@ -226,7 +231,7 @@ msgstr ""
 
 #: ../../library/__main__.rst:165
 msgid "Packaging Considerations"
-msgstr ""
+msgstr "パッケージングで考慮すべき点"
 
 #: ../../library/__main__.rst:167
 msgid ""
diff --git a/library/asyncio-protocol.po b/library/asyncio-protocol.po
@@ -300,6 +300,12 @@ msgid ""
 "<BaseProtocol.connection_lost>` method will be called with :const:`None` as "
 "its argument. The transport should not be used once it is closed."
 msgstr ""
+"トランスポートが発信データのバッファーを持っていた場合、バッファーされたデー"
+"タは非同期にフラッシュされます。それ以降データは受信されません。バッファーさ"
+"れていたデータがすべてフラッシュされた後、そのプロトコルの :meth:`protocol."
+"connection_lost() <BaseProtocol.connection_lost>` メソッドが引数 :const:"
+"`None` で呼び出されます。一度閉じたトランスポートは、使用されるべきではありま"
+"せん。"
 
 #: ../../library/asyncio-protocol.rst:164
 msgid "Return ``True`` if the transport is closing or is closed."
@@ -968,6 +974,9 @@ msgid ""
 "at most once.  Once ``eof_received()`` is called, ``data_received()`` is not "
 "called anymore."
 msgstr ""
+"いっぽうで、 :meth:`protocol.eof_received() <Protocol.eof_received>` メソッド"
+"は最大でも一度だけ呼び出されます。いったん ``eof_received()`` が呼び出される"
+"と、それ以降 ``data_received()`` は呼び出されません。"
 
 #: ../../library/asyncio-protocol.rst:562
 msgid ""
diff --git a/library/contextvars.po b/library/contextvars.po
@@ -230,6 +230,10 @@ msgid ""
 "fashion to :func:`threading.local()` when values are assigned in different "
 "threads."
 msgstr ""
+"すべてのスレッドは、異なるトップレベルの :class:`~contextvars.Context` オブ"
+"ジェクトを持っています。これは、値が異なるスレッドに割り当てられたとき、 :"
+"class:`ContextVar` オブジェクトが :func:`threading.local()` と似た様式の振る"
+"舞いをするということを意味します。"
 
 #: ../../library/contextvars.rst:152
 msgid "Context implements the :class:`collections.abc.Mapping` interface."
diff --git a/library/copyreg.po b/library/copyreg.po
@@ -67,6 +67,8 @@ msgid ""
 "The *constructor_ob* parameter is a legacy feature and is now ignored, but "
 "if passed it must be a callable."
 msgstr ""
+"*constructor_ob* は古い機能で、現在は無視されますが、値を渡す場合は呼び出し可"
+"能 (callable) でなければなりません。"
 
 #: ../../library/copyreg.rst:38
 msgid ""
diff --git a/library/custominterp.po b/library/custominterp.po
@@ -34,11 +34,11 @@ msgid ""
 "look at the :mod:`code` module.  (The :mod:`codeop` module is lower-level, "
 "used to support compiling a possibly incomplete chunk of Python code.)"
 msgstr ""
-"この章で解説されるモジュールで Python の対話インタプリタに似たインターフェー"
-"スを書くことができます。もし Python そのもの以外に何か特殊な機能をサポートし"
-"た Python インタプリタを作りたければ、 :mod:`code` モジュールを参照してくださ"
-"い。 (:mod:`codeop` モジュールはより低レベルで、不完全(かもしれない) Python "
-"コード断片のコンパイルをサポートするために使われます。)"
+"この章で解説されるモジュールで Python の対話型インタープリターに似たインター"
+"フェースを書くことができます。もし Python そのもの以外に何か特殊な機能をサ"
+"ポートした Python インタープリターを作りたければ、 :mod:`code` モジュールを参"
+"照してください。 (:mod:`codeop` モジュールはより低レベルで、不完全かもしれな"
+"い Python コード断片のコンパイルをサポートするために使われます。)"
 
 #: ../../library/custominterp.rst:13
 msgid "The full list of modules described in this chapter is:"
diff --git a/library/distribution.po b/library/distribution.po
@@ -34,7 +34,6 @@ msgid ""
 "index server, or without any index server at all."
 msgstr ""
 "以下のライブラリは Python で書かれたソフトウェアを配布、インストールするため"
-"のものです。\n"
-"これらは `Python Package Index <https://pypi.org>`__ に対して動作するように設"
-"計されていますが、ローカルのインデックスサーバーや、インデックスサーバーなし"
-"に使うこともできます。"
+"のものです。これらのモジュールは `Python Package Index <https://pypi.org>`__ "
+"に対して動作するように設計されていますが、ローカルのインデックスサーバーや、"
+"インデックスサーバーなしに使うこともできます。"
diff --git a/library/email.examples.po b/library/email.examples.po
@@ -40,12 +40,16 @@ msgid ""
 "First, let's see how to create and send a simple text message (both the text "
 "content and the addresses may contain unicode characters):"
 msgstr ""
+"最初に、シンプルなテキストメッセージ (テキストコンテンツとアドレスの両方がユ"
+"ニコード文字を含み得る) を作成・送信する方法を見てみましょう:"
 
 #: ../../library/email.examples.rst:15
 msgid ""
 "Parsing :rfc:`822` headers can easily be done by the using the classes from "
 "the :mod:`~email.parser` module:"
 msgstr ""
+":rfc:`822` ヘッダーの解析は、 :mod:`~email.parser` モジュールにあるクラスを使"
+"用することにより、簡単に実現できます:"
 
 #: ../../library/email.examples.rst:21
 msgid ""
@@ -78,16 +82,21 @@ msgid ""
 "image in the html part, and we save a copy of what we are going to send to "
 "disk, as well as sending it."
 msgstr ""
+"代替のプレーンテキストバージョン付きの HTML メッセージを作成する方法の例で"
+"す。もう少し面白くするために、 HTML 部分に関連する画像を追加し、さらに送信だ"
+"けでなく、送信しようとしているもののコピーをディスクにも保存してみます。"
 
 #: ../../library/email.examples.rst:47
 msgid ""
 "If we were sent the message from the last example, here is one way we could "
 "process it:"
 msgstr ""
+"前の例のメッセージが送信されてきたら、これを処理する方法の一つは次のようなも"
+"のです:"
 
 #: ../../library/email.examples.rst:52
 msgid "Up to the prompt, the output from the above is:"
-msgstr ""
+msgstr "プロンプトまでの、上記のプログラムの出力はこうなります:"
 
 #: ../../library/email.examples.rst:66
 msgid "Footnotes"
diff --git a/library/ensurepip.po b/library/ensurepip.po
@@ -28,7 +28,7 @@ msgstr ":mod:`ensurepip` ---  ``pip`` インストーラのブートストラッ
 
 #: ../../library/ensurepip.rst:10
 msgid "**Source code:** :source:`Lib/ensurepip`"
-msgstr ""
+msgstr "**ソースコード:** :source:`Lib/ensurepip`"
 
 #: ../../library/ensurepip.rst:14
 msgid ""
diff --git a/library/filesys.po b/library/filesys.po
@@ -64,7 +64,7 @@ msgstr ""
 
 #: ../../library/filesys.rst:37
 msgid "Built-in function :func:`open`"
-msgstr ":func:`open` 組込み関数"
+msgstr ":func:`open` 組み込み関数"
 
 #: ../../library/filesys.rst:38
 msgid "The standard way to open files for reading and writing with Python."
diff --git a/library/grp.po b/library/grp.po
@@ -138,6 +138,8 @@ msgstr ""
 msgid ""
 ":exc:`TypeError` is raised for non-integer arguments like floats or strings."
 msgstr ""
+"浮動小数点数や文字列のような、整数でない引数には :exc:`TypeError` が送出され"
+"ます。"
 
 #: ../../library/grp.rst:51
 msgid ""
diff --git a/library/http.cookiejar.po b/library/http.cookiejar.po
@@ -148,6 +148,8 @@ msgstr ""
 msgid ""
 "This should not be initialized directly – use its subclasses below instead."
 msgstr ""
+"これは直接初期化されるべきではありません。以下のサブクラスを代わりに使用して"
+"ください。"
 
 #: ../../library/http.cookiejar.rst:78 ../../library/http.cookiejar.rst:351
 msgid "The filename parameter supports a :term:`path-like object`."
@@ -173,6 +175,14 @@ msgid ""
 "secure protocols. For all other arguments, see the documentation for :class:"
 "`CookiePolicy` and :class:`DefaultCookiePolicy` objects."
 msgstr ""
+"コンストラクタはキーワード引数しか取りません。 *blocked_domains* はドメイン名"
+"からなるシーケンスで、ここからは決してクッキーを受けとらないし、このドメイン"
+"にクッキーを返すこともありません。 *allowed_domains* が :const:`None` でない"
+"場合、クッキーを受けとり、返すのはこのシーケンスのドメインに限定されます。 "
+"*secure_protocols* は、安全なクッキーを追加できるプロトコルのシーケンスです。"
+"デフォルトでは、 *https* と *wss* (secure websocket) が安全なプロトコルとみな"
+"されます。これ以外の引数については :class:`CookiePolicy` および :class:"
+"`DefaultCookiePolicy` オブジェクトの説明をごらんください。"
 
 #: ../../library/http.cookiejar.rst:98
 msgid ""
@@ -333,6 +343,8 @@ msgid ""
 "*request* object needs :attr:`origin_req_host` attribute. Dependency on a "
 "deprecated method :meth:`get_origin_req_host` has been removed."
 msgstr ""
+"*request* オブジェクトには :attr:`origin_req_host` 属性が必要です。非推奨のメ"
+"ソッド :meth:`get_origin_req_host` への依存は解消されました。"
 
 #: ../../library/http.cookiejar.rst:178
 msgid ""
diff --git a/library/http.cookies.po b/library/http.cookies.po
@@ -143,13 +143,20 @@ msgid ""
 "``real_value`` can be any type. This method does no decoding in :class:"
 "`BaseCookie` --- it exists so it can be overridden."
 msgstr ""
+"文字列表現のタプル ``(real_value, coded_value)`` を返します。 ``real_value`` "
+"の型はどのようなものでも許容されます。このメソッドは :class:`BaseCookie` にお"
+"いてデコードを行わず、オーバーライドされるためにだけ存在します。"
 
 #: ../../library/http.cookies.rst:87
 msgid ""
 "Return a tuple ``(real_value, coded_value)``. *val* can be any type, but "
 "``coded_value`` will always be converted to a string. This method does no "
 "encoding in :class:`BaseCookie` --- it exists so it can be overridden."
 msgstr ""
+"タプル ``(real_value, coded_value)`` を返します。 *val* の型はどのようなもの"
+"でも許容されますが、 ``coded_value`` は常に文字列に変換されます。このメソッド"
+"は :class:`BaseCookie` においてエンコードを行わず、オーバーライドされるために"
+"だけ存在します。"
 
 #: ../../library/http.cookies.rst:92
 msgid ""
@@ -260,6 +267,9 @@ msgid ""
 "send the cookie along with cross-site requests. This helps to mitigate CSRF "
 "attacks. Valid values for this attribute are \"Strict\" and \"Lax\"."
 msgstr ""
+":attr:`samesite` 属性は、ブラウザーがクロスサイトリクエストに加えて cookie の"
+"送信も禁止することを指定します。これは CSRF 攻撃の軽減に役立ちます。この属性"
+"い有効な値は、 \"Strict\" と \"Lax\" です。"
 
 #: ../../library/http.cookies.rst:152
 msgid "The keys are case-insensitive and their default value is ``''``."
@@ -278,6 +288,8 @@ msgid ""
 "Attributes :attr:`~Morsel.key`, :attr:`~Morsel.value` and :attr:`~Morsel."
 "coded_value` are read-only.  Use :meth:`~Morsel.set` for setting them."
 msgstr ""
+":attr:`~Morsel.key` と :attr:`~Morsel.value` 、 :attr:`~Morsel.coded_value` "
+"属性は読み出し専用です。設定には、 :meth:`~Morsel.set` を使用してください。"
 
 #: ../../library/http.cookies.rst:163
 msgid "Added support for the :attr:`samesite` attribute."
diff --git a/library/http.po b/library/http.po
@@ -159,7 +159,7 @@ msgstr "``EARLY_HINTS``"
 
 #: ../../library/http.rst:65
 msgid "An HTTP Status Code for Indicating Hints :rfc:`8297`"
-msgstr ""
+msgstr "An HTTP Status Code for Indicating Hints :rfc:`8297`"
 
 #: ../../library/http.rst:66
 msgid "``200``"
@@ -663,7 +663,7 @@ msgstr "``TOO_EARLY``"
 
 #: ../../library/http.rst:107
 msgid "Using Early Data in HTTP :rfc:`8470`"
-msgstr ""
+msgstr "Using Early Data in HTTP :rfc:`8470`"
 
 #: ../../library/http.rst:108
 msgid "``426``"
@@ -716,7 +716,7 @@ msgstr "``UNAVAILABLE_FOR_LEGAL_REASONS``"
 
 #: ../../library/http.rst:112
 msgid "An HTTP Status Code to Report Legal Obstacles :rfc:`7725`"
-msgstr ""
+msgstr "An HTTP Status Code to Report Legal Obstacles :rfc:`7725`"
 
 #: ../../library/http.rst:113
 msgid "``500``"
diff --git a/library/importlib.metadata.po b/library/importlib.metadata.po
@@ -28,7 +28,7 @@ msgstr ":mod:`!importlib.metadata` を使う"
 
 #: ../../library/importlib.metadata.rst:11
 msgid "``importlib.metadata`` is no longer provisional."
-msgstr "``importlib.metadata`` は、暫定的なものではなくなりました。"
+msgstr "``importlib.metadata`` は暫定的なものではなくなりました。"
 
 #: ../../library/importlib.metadata.rst:14
 msgid "**Source code:** :source:`Lib/importlib/metadata/__init__.py`"
diff --git a/library/importlib.po b/library/importlib.po
@@ -862,7 +862,7 @@ msgstr "インポート機構はこれを自動的に考慮するようになり
 
 #: ../../library/importlib.rst:493
 msgid "*Superseded by TraversableResources*"
-msgstr ""
+msgstr "*TraversableResources に取って代わられました*"
 
 #: ../../library/importlib.rst:495
 msgid ""
diff --git a/library/secrets.po b/library/secrets.po
@@ -77,7 +77,7 @@ msgstr ""
 
 #: ../../library/secrets.rst:47
 msgid "Return a randomly chosen element from a non-empty sequence."
-msgstr ""
+msgstr "空でないシーケンスから要素をランダムに選択して返します。"
 
 #: ../../library/secrets.rst:51
 msgid "Return a random int in the range [0, *n*)."
@@ -190,6 +190,11 @@ msgid ""
 "lesson-in-timing-attacks/>`_. See :func:`hmac.compare_digest` for additional "
 "details."
 msgstr ""
+"文字列または :term:`bytes-like オブジェクト <bytes-like object>` *a* と *b* "
+"が等しければ ``True`` を、そうでなければ ``False`` を返します。比較は `タイミ"
+"ング攻撃 <https://codahale.com/a-lesson-in-timing-attacks/>`_ のリスクを減ら"
+"す \"定数時間比較\" の方法で行われます。詳細については :func:`hmac."
+"compare_digest` を参照してください。"
 
 #: ../../library/secrets.rst:140
 msgid "Recipes and best practices"
diff --git a/library/timeit.po b/library/timeit.po
@@ -399,6 +399,10 @@ msgid ""
 "within the best repetition of the timing loop. That is, the time the fastest "
 "repetition took divided by the loop count."
 msgstr ""
+"出力には、3つのフィールドがあります。ループ回数は、ループの反復ごとに何回文の"
+"内容が実行されたかを示します。反復回数 ('best of 5') は計時ループが何回繰り返"
+"されたかを示し、最後に文の内容が平均して計時ループの中の最良の反復で要した時"
+"間を示します。つまり、最速の反復をループ回数で割った時間です。"
 
 #: ../../library/timeit.rst:300
 msgid "The same can be done using the :class:`Timer` class and its methods::"
diff --git a/library/tk.po b/library/tk.po
@@ -24,7 +24,7 @@ msgstr ""
 
 #: ../../library/tk.rst:5
 msgid "Graphical User Interfaces with Tk"
-msgstr "Tk を用いたグラフィカルユーザインターフェイス"
+msgstr "Tk を用いたグラフィカルユーザーインターフェース"
 
 #: ../../library/tk.rst:13
 msgid ""
@@ -63,3 +63,10 @@ msgid ""
 "alternative `GUI frameworks and tools <https://wiki.python.org/moin/"
 "GuiProgramming>`_."
 msgstr ""
+":mod:`tkinter` の一番素晴らしい点は、速く、そしてほとんどの Python に付属して"
+"いることです。標準ドキュメントが頼りないものだとしても、代わりとなる、リファ"
+"レンス、チュートリアル、書籍その他が入手可能です。:mod:`tkinter` は古臭いルッ"
+"クアンドフィールでも有名ですが、その点は Tk 8.5 で大きく改善されました。とは"
+"いえ、他にも興味を引きそうな GUI ライブラリは多数あります。 Python wiki に"
+"は、いくつかの代替の `GUI フレームワークとツール <https://wiki.python.org/"
+"moin/GuiProgramming>`_ の一覧があります。"
diff --git a/library/urllib.robotparser.po b/library/urllib.robotparser.po
@@ -94,6 +94,10 @@ msgid ""
 "apply to the *useragent* specified or the ``robots.txt`` entry for this "
 "parameter has invalid syntax, return ``None``."
 msgstr ""
+"当該の *ユーザーエージェント* 用の ``robots.txt`` の ``Crawl-delay`` パラメー"
+"ターの値を返します。そのようなパラメーターが存在しないか、指定された *ユー"
+"ザーエージェント* にあてはまらない、もしくは ``robots.txt`` のこのパラメー"
+"ターのエントリの構文が無効な場合は、 ``None`` を返します。"
 
 #: ../../library/urllib.robotparser.rst:71
 msgid ""
@@ -102,13 +106,21 @@ msgid ""
 "such parameter or it doesn't apply to the *useragent* specified or the "
 "``robots.txt`` entry for this parameter has invalid syntax, return ``None``."
 msgstr ""
+"``robots.txt`` の ``Request-rate`` パラメーターの内容を :term:`named tuple` "
+"``RequestRate(requests, seconds)`` として返します。そのようなパラメーターが存"
+"在しないか、指定された *ユーザーエージェント* にあてはまらない、もしくは "
+"``robots.txt`` のこのパラメーターのエントリの構文が無効な場合は、 ``None`` を"
+"返します。"
 
 #: ../../library/urllib.robotparser.rst:81
 msgid ""
 "Returns the contents of the ``Sitemap`` parameter from ``robots.txt`` in the "
 "form of a :func:`list`. If there is no such parameter or the ``robots.txt`` "
 "entry for this parameter has invalid syntax, return ``None``."
 msgstr ""
+"``robots.txt`` の ``Sitemap`` パラメーターの内容を :func:`list` の形式で返し"
+"ます。そのようなパラメーターが存在しないか、 ``robots.txt`` のこのパラメー"
+"ターのエントリの構文が無効な場合は、 ``None`` を返します。"
 
 #: ../../library/urllib.robotparser.rst:89
 msgid ""
diff --git a/library/xmlrpc.server.po b/library/xmlrpc.server.po
@@ -156,7 +156,7 @@ msgstr ""
 
 #: ../../library/xmlrpc.server.rst:93 ../../library/xmlrpc.server.rst:307
 msgid ":meth:`register_function` can be used as a decorator."
-msgstr ""
+msgstr ":meth:`register_function` はデコレーターとして使用できます。"
 
 #: ../../library/xmlrpc.server.rst:99
 msgid ""
@@ -257,6 +257,8 @@ msgid ""
 ":meth:`register_function` can also be used as a decorator. The previous "
 "server example can register functions in a decorator way::"
 msgstr ""
+":meth:`register_function` はデコレーターとしても使用できます。前のサーバーの"
+"例は、デコレーターの方法で関数を登録することもできます。"
 
 #: ../../library/xmlrpc.server.rst:225
 msgid ""
