discordpy - en to ja_JP translation catalogue (46 entries)

en: Migrating to v0.10.0
ja_JP: v0.10.0への移行

en: v0.10.0 is one of the biggest breaking changes in the library due to massive fundamental changes in how the library operates.
ja_JP: v0.10.0は、ライブラリの根本的動作が大幅に変更された、ライブラリの中でも大きな更新の一つです。

en: The biggest major change is that the library has dropped support to all versions prior to Python 3.4.2. This was made to support :mod:`asyncio`, in which more detail can be seen :issue:`in the corresponding issue <50>`. To reiterate this, the implication is that **python version 2.7 and 3.3 are no longer supported**.
ja_JP: 最大の大きな変更点はPython 3.4.2以前のすべてのバージョンのサポートが打ち切られたことです。これは :mod:`asyncio` をサポートするためで、対応する :issue:`in the corresponding issue <50>` で詳細が見られます。繰り返しになりますが、 **Python 2.7及びPython3.3は、既にサポートされていません** 。

en: Below are all the other major changes from v0.9.0 to v0.10.0.
ja_JP: 以下は、v0.9.0からv0.10.0までのその他の主要な変更点です。

en: Event Registration
ja_JP: イベント登録

en: All events before were registered using :meth:`Client.event`. While this is still possible, the events must be decorated with ``@asyncio.coroutine``.
ja_JP: 以前まではすべてのイベントが :meth:`Client.event` を使用して登録されていました。このやり方はまだ可能ですが、 ``@asyncio.coroutine`` で修飾が必要です。

en: Before:
ja_JP: 更新前:

en: After:
ja_JP: 更新後:

en: Or in Python 3.5+:
ja_JP: Python 3.5以降の場合:

en: Because there is a lot of typing, a utility decorator (:meth:`Client.async_event`) is provided for easier registration. For example:
ja_JP: 多くの型付けがあるため、登録を簡単にするためにユーティリティデコレータ (:meth:`Client.async_event`) が用意されています。例:

en: Be aware however, that this is still a coroutine and your other functions that are coroutines must be decorated with ``@asyncio.coroutine`` or be ``async def``.
ja_JP: しかし、これはまだコルーチンであり、コルーチンである関数には ``@asyncio.coroutine`` あるいは ``async def`` での修飾が必要であることに注意してください。

en: Event Changes
ja_JP: イベントの変更

en: Some events in v0.9.0 were considered pretty useless due to having no separate states. The main events that were changed were the ``_update`` events since previously they had no context on what was changed.
ja_JP: v0.9.0でいくつかのイベントは、別の状態を持たないために、役に立たないと考えられていました。変更された主なイベントは、更新前と更新後の二つの状態を持つ ``_update`` イベントです。

en: Note that ``on_status`` was removed. If you want its functionality, use :func:`on_member_update`. See :ref:`discord-api-events` for more information. Other removed events include ``on_socket_closed``, ``on_socket_receive``, and ``on_socket_opened``.
ja_JP: ``on_status`` が削除されていることに注意してください。似たような機能が使いたい場合は、 :func:`on_member_update` を使用します。詳細は :ref:`discord-api-events` を参照してください。他に、 ``on_socket_closed`` 、 ``on_socket_receive`` や ``on_socket_opened`` も削除されています。

en: Coroutines
ja_JP: コルーチン

en: The biggest change that the library went through is that almost every function in :class:`Client` was changed to be a `coroutine <py:library/asyncio-task.html>`_. Functions that are marked as a coroutine in the documentation must be awaited from or yielded from in order for the computation to be done. For example...
ja_JP: ライブラリの最大の変更点は :class:`Client` を使用していたほとんどの関数が `コルーチン <py:library/asyncio-task.html>`_ へと変更されたことです。ドキュメントのコルーチンとして定義された関数は、処理の終了を待機します。例えば、

en: In order for you to ``yield from`` or ``await`` a coroutine then your function must be decorated with ``@asyncio.coroutine`` or ``async def``.
ja_JP: ``yield from`` あるいは ``await`` を使用するには、関数が ``@asyncio.coroutine`` または ``async def`` で修飾されている必要があります。

en: Iterables
ja_JP: イテラブル

en: For performance reasons, many of the internal data structures were changed into a dictionary to support faster lookup. As a consequence, this meant that some lists that were exposed via the API have changed into iterables and not sequences. In short, this means that certain attributes now only support iteration and not any of the sequence functions.
ja_JP: パフォーマンス上の理由から、より高速な情報の取得を可能とするため、多くの内部データ構造が辞書に変更されました。結果として、これはAPIを介して公開された一部リストが、シーケンスではなくイテラブルに変更されたことを意味します。つまるところ、現在、特定の属性はイテラブルのみをサポートしており、シーケンスを扱うことができないことを意味しています。

en: The affected attributes are as follows:
ja_JP: 影響を受ける属性は以下のとおりです。

en: Some examples of previously valid behaviour that is now invalid
ja_JP: 以前は有効であったが、現在は無効である操作の例。

en: Since they are no longer :obj:`list`\s, they no longer support indexing or any operation other than iterating. In order to get the old behaviour you should explicitly cast it to a list.
ja_JP: これらは、既に :obj:`list` ではないため、インデックスや反復処理以外の操作はサポートされなくなりました。以前の動作で処理を行うには、listに明示的にキャストする必要があります。

en: Due to internal changes of the structure, the order you receive the data in is not in a guaranteed order.
ja_JP: 構造の内部的な変更のため、データを受け取った順序は保証されません。

en: Enumerations
ja_JP: 列挙型

en: Due to dropping support for versions lower than Python 3.4.2, the library can now use :doc:`py:library/enum` in places where it makes sense.
ja_JP: Python 3.4.2以前のバージョンのサポートを打ち切ったため、ライブラリは理にかなった場所での :doc:`py:library/enum` の使用が可能になりました。

en: The common places where this was changed was in the server region, member status, and channel type.
ja_JP: 変更された主な場所は、サーバーリージョン、メンバーのステータス、およびチャンネルタイプです。

en: The main reason for this change was to reduce the use of finicky strings in the API as this could give users a false sense of power. More information can be found in the :ref:`discord-api-enums` page.
ja_JP: この変更の主な理由は、APIでの厄介な文字列の使用を削減することでした。ユーザーに誤った感覚を与える可能性があったためです。詳細は :ref:`discord-api-enums` を参照してください。

en: Properties
ja_JP: プロパティ

en: A lot of function calls that returned constant values were changed into Python properties for ease of use in format strings.
ja_JP: 定数値を返す関数呼び出しの多くは、書式化した文字列での使いやすさ向上を図るため、Pythonのプロパティに変更されました。

en: The following functions were changed into properties:
ja_JP: 以下はプロパティに変更された関数です。

en: Before
ja_JP: 変更前

en: After
ja_JP: 変更後

en: Member Management
ja_JP: メンバー管理

en: Functions that involved banning and kicking were changed.
ja_JP: BANやキックを含む関数が追加されました。

en: Renamed Functions
ja_JP: 関数の改名

en: Functions have been renamed.
ja_JP: いくつかの関数名が変更されました。

en: All the :class:`Permissions` related attributes have been renamed and the `can_` prefix has been dropped. So for example, ``can_manage_messages`` has become ``manage_messages``.
ja_JP: すべての :class:`Permissions` 関連の属性の名称が変更され、 接頭詞であった `can_` が削除されました。例を挙げると ``can_manage_messages`` が ``manage_messages`` になりました。

en: Forced Keyword Arguments
ja_JP: 強制キーワード引数

en: Since 3.0+ of Python, we can now force questions to take in forced keyword arguments. A keyword argument is when you explicitly specify the name of the variable and assign to it, for example: ``foo(name='test')``. Due to this support, some functions in the library were changed to force things to take said keyword arguments. This is to reduce errors of knowing the argument order and the issues that could arise from them.
ja_JP: Python 3.0以降では、強制的にキーワード引数をとるようにすることができるようになりました。キーワード引数は、変数の名前を明示的に指定してそれに割り当てることで、例えば ``foo(name='test')`` などです。このサポートにより、ライブラリ内のいくつかの関数が変更され、キーワード引数を取るようになりました。これは引数の順序が誤っていることが原因で発生するエラーを減らすためです。

en: The following parameters are now exclusively keyword arguments:
ja_JP: 次のパラメータは、現在、排他的なキーワード引数です。

en: In the documentation you can tell if a function parameter is a forced keyword argument if it is after ``\*,`` in the function signature.
ja_JP: ドキュメントでは、関数シグネチャ内の ``\*,`` の後に引数があるかどうかで、関数の引数が強制的なキーワード引数であるかを知ることができます。

en: Running the Client
ja_JP: クライアントの実行

en: In earlier versions of discord.py, ``client.run()`` was a blocking call to the main thread that called it. In v0.10.0 it is still a blocking call but it handles the event loop for you. However, in order to do that you must pass in your credentials to :meth:`Client.run`.
ja_JP: 以前のバージョンのdiscord.pyでは ``client.run()`` は呼び出したメインスレッドをブロッキングするブロック付き呼び出しでした。v0.10.0でも未だブロック付き呼び出しですが、イベントループで処理を行います。ただし、それを行うためには認証情報を :meth:`Client.run` に渡す必要があります。

en: Basically, before:
ja_JP: 以前:

en: Like in the older ``Client.run`` function, the newer one must be the one of the last functions to call. This is because the function is **blocking**. Registering events or doing anything after :meth:`Client.run` will not execute until the function returns.
ja_JP: 以前の ``Client.run`` 同様、新しくなった関数も最後に呼び出す必要があります。これは関数がブロッキングを行うためです。 :meth:`Client.run` の後に何かを定義しても、この関数が終了するまで、それらの処理は行われません。

en: This is a utility function that abstracts the event loop for you. There's no need for the run call to be blocking and out of your control. Indeed, if you want control of the event loop then doing so is quite straightforward:
ja_JP: これはイベントループを抽象化するユーティリティ関数です。 実行呼び出しがブロックされ、コントロールから外れる必要はありません。実際に、イベントループを制御したい場合、この方法では非常に簡単です。
