2101 lines
49 KiB
Plaintext
2101 lines
49 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2015-2017, Rapptz
|
|
# This file is distributed under the same license as the discord.py package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, 2018.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: discord.py 1.0.0a\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2018-07-31 14:21-0400\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"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=utf-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
"Generated-By: Babel 2.5.3\n"
|
|
|
|
#: ../../migrating.rst:6
|
|
msgid "Migrating to v1.0"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:8
|
|
msgid ""
|
|
"v1.0 is one of the biggest breaking changes in the library due to a "
|
|
"complete redesign."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:11
|
|
msgid ""
|
|
"The amount of changes are so massive and long that for all intents and "
|
|
"purposes, it is a completely new library."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:14
|
|
msgid ""
|
|
"Part of the redesign involves making things more easy to use and natural."
|
|
" Things are done on the :ref:`models <discord_api_models>` instead of "
|
|
"requiring a :class:`Client` instance to do any work."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:18
|
|
msgid "Python Version Change"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:20
|
|
msgid ""
|
|
"In order to make development easier and also to allow for our "
|
|
"dependencies to upgrade to allow usage of 3.7 or higher, the library had "
|
|
"to remove support for Python versions lower than 3.5.3, which essentially"
|
|
" means that **support for Python 3.4 is dropped**."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:25
|
|
msgid "Major Model Changes"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:27
|
|
msgid "Below are major model changes that have happened in v1.0"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:30
|
|
msgid "Snowflakes are int"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:32
|
|
msgid ""
|
|
"Before v1.0, all snowflakes (the ``id`` attribute) were strings. This has"
|
|
" been changed to :class:`int`."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:34 ../../migrating.rst:252
|
|
msgid "Quick example: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:46
|
|
msgid ""
|
|
"This change allows for fewer errors when using the Copy ID feature in the"
|
|
" official client since you no longer have to wrap it in quotes and allows"
|
|
" for optimisation opportunities by allowing ETF to be used instead of "
|
|
"JSON internally."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:50
|
|
msgid "Server is now Guild"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:52
|
|
msgid ""
|
|
"The official API documentation calls the \"Server\" concept a \"Guild\" "
|
|
"instead. In order to be more consistent with the API documentation when "
|
|
"necessary, the model has been renamed to :class:`Guild` and all instances"
|
|
" referring to it has been changed as well."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:56
|
|
msgid "A list of changes is as follows:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:59 ../../migrating.rst:95 ../../migrating.rst:852
|
|
msgid "Before"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:59 ../../migrating.rst:95 ../../migrating.rst:852
|
|
msgid "After"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:61
|
|
msgid "``Message.server``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:61
|
|
msgid ":attr:`Message.guild`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:63
|
|
msgid "``Channel.server``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:63
|
|
msgid ":attr:`.GuildChannel.guild`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:65
|
|
msgid "``Client.servers``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:65 ../../migrating.rst:231
|
|
msgid ":attr:`Client.guilds`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:67
|
|
msgid "``Client.get_server``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:67
|
|
msgid ":meth:`Client.get_guild`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:69
|
|
msgid "``Emoji.server``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:69
|
|
msgid ":attr:`Emoji.guild`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:71
|
|
msgid "``Role.server``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:71
|
|
msgid ":attr:`Role.guild`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:73
|
|
msgid "``Invite.server``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:73
|
|
msgid ":attr:`Invite.guild`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:75
|
|
msgid "``Member.server``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:75
|
|
msgid ":attr:`Member.guild`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:77
|
|
msgid "``Permissions.manage_server``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:77
|
|
msgid ":attr:`Permissions.manage_guild`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:79
|
|
msgid "``VoiceClient.server``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:79
|
|
msgid ":attr:`VoiceClient.guild`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:81
|
|
msgid "``Client.create_server``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:81
|
|
msgid ":meth:`Client.create_guild`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:87
|
|
msgid "Models are Stateful"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:89
|
|
msgid ""
|
|
"As mentioned earlier, a lot of functionality was moved out of "
|
|
":class:`Client` and put into their respective :ref:`model "
|
|
"<discord_api_models>`."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:92
|
|
msgid "A list of these changes is enumerated below."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:97
|
|
msgid "``Client.add_reaction``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:97
|
|
msgid ":meth:`Message.add_reaction`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:99
|
|
msgid "``Client.add_roles``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:99
|
|
msgid ":meth:`Member.add_roles`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:101
|
|
msgid "``Client.ban``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:101
|
|
msgid ":meth:`Member.ban` or :meth:`Guild.ban`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:103
|
|
msgid "``Client.change_nickname``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:103 ../../migrating.rst:167 ../../migrating.rst:183
|
|
#: ../../migrating.rst:191
|
|
msgid ":meth:`Member.edit`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:105
|
|
msgid "``Client.clear_reactions``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:105
|
|
msgid ":meth:`Message.clear_reactions`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:107
|
|
msgid "``Client.create_channel``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:107
|
|
msgid ":meth:`Guild.create_text_channel` and :meth:`Guild.create_voice_channel`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:109
|
|
msgid "``Client.create_custom_emoji``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:109
|
|
msgid ":meth:`Guild.create_custom_emoji`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:111
|
|
msgid "``Client.create_invite``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:111
|
|
msgid ":meth:`abc.GuildChannel.create_invite`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:113
|
|
msgid "``Client.create_role``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:113
|
|
msgid ":meth:`Guild.create_role`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:115
|
|
msgid "``Client.delete_channel``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:115
|
|
msgid ":meth:`abc.GuildChannel.delete`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:117
|
|
msgid "``Client.delete_channel_permissions``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:117
|
|
msgid ""
|
|
":meth:`abc.GuildChannel.set_permissions` with ``overwrite`` set to "
|
|
"``None``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:119
|
|
msgid "``Client.delete_custom_emoji``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:119
|
|
msgid ":meth:`Emoji.delete`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:121
|
|
msgid "``Client.delete_invite``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:121
|
|
msgid ":meth:`Invite.delete` or :meth:`Client.delete_invite`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:123
|
|
msgid "``Client.delete_message``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:123
|
|
msgid ":meth:`Message.delete`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:125
|
|
msgid "``Client.delete_messages``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:125
|
|
msgid ":meth:`TextChannel.delete_messages`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:127
|
|
msgid "``Client.delete_role``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:127
|
|
msgid ":meth:`Role.delete`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:129
|
|
msgid "``Client.delete_server``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:129
|
|
msgid ":meth:`Guild.delete`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:131
|
|
msgid "``Client.edit_channel``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:131 ../../migrating.rst:165
|
|
msgid ":meth:`TextChannel.edit` or :meth:`VoiceChannel.edit`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:133
|
|
msgid "``Client.edit_channel_permissions``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:133
|
|
msgid ":meth:`abc.GuildChannel.set_permissions`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:135
|
|
msgid "``Client.edit_custom_emoji``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:135
|
|
msgid ":meth:`Emoji.edit`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:137
|
|
msgid "``Client.edit_message``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:137
|
|
msgid ":meth:`Message.edit`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:139
|
|
msgid "``Client.edit_profile``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:139
|
|
msgid ":meth:`ClientUser.edit` (you get this from :attr:`Client.user`)"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:141
|
|
msgid "``Client.edit_role``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:141 ../../migrating.rst:169
|
|
msgid ":meth:`Role.edit`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:143
|
|
msgid "``Client.edit_server``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:143
|
|
msgid ":meth:`Guild.edit`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:145
|
|
msgid "``Client.estimate_pruned_members``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:145
|
|
msgid ":meth:`Guild.estimate_pruned_members`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:147 ../../migrating.rst:325
|
|
msgid "``Client.get_all_emojis``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:147
|
|
msgid ":attr:`Client.emojis`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:149
|
|
msgid "``Client.get_bans``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:149
|
|
msgid ":meth:`Guild.bans`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:151
|
|
msgid "``Client.get_message``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:151
|
|
msgid ":meth:`abc.Messageable.get_message`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:153
|
|
msgid "``Client.get_reaction_users``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:153 ../../migrating.rst:480
|
|
msgid ":meth:`Reaction.users`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:155
|
|
msgid "``Client.invites_from``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:155
|
|
msgid ":meth:`abc.GuildChannel.invites` or :meth:`Guild.invites`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:157
|
|
msgid "``Client.join_voice_channel``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:157
|
|
msgid ":meth:`VoiceChannel.connect` (see :ref:`migrating_1_0_voice`)"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:159
|
|
msgid "``Client.kick``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:159
|
|
msgid ":meth:`Guild.kick` or :meth:`Member.kick`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:161
|
|
msgid "``Client.leave_server``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:161
|
|
msgid ":meth:`Guild.leave`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:163
|
|
msgid "``Client.logs_from``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:163
|
|
msgid ":meth:`abc.Messageable.history` (see :ref:`migrating_1_0_async_iter`)"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:165
|
|
msgid "``Client.move_channel``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:167
|
|
msgid "``Client.move_member``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:169
|
|
msgid "``Client.move_role``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:171
|
|
msgid "``Client.pin_message``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:171
|
|
msgid ":meth:`Message.pin`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:173
|
|
msgid "``Client.pins_from``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:173
|
|
msgid ":meth:`abc.Messageable.pins`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:175
|
|
msgid "``Client.prune_members``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:175
|
|
msgid ":meth:`Guild.prune_members`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:177
|
|
msgid "``Client.purge_from``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:177
|
|
msgid ":meth:`TextChannel.purge`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:179
|
|
msgid "``Client.remove_reaction``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:179
|
|
msgid ":meth:`Message.remove_reaction`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:181
|
|
msgid "``Client.remove_roles``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:181
|
|
msgid ":meth:`Member.remove_roles`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:183
|
|
msgid "``Client.replace_roles``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:185
|
|
msgid "``Client.send_file``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:185 ../../migrating.rst:187
|
|
msgid ":meth:`abc.Messageable.send` (see :ref:`migrating_1_0_sending_messages`)"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:187
|
|
msgid "``Client.send_message``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:189
|
|
msgid "``Client.send_typing``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:189
|
|
msgid ""
|
|
":meth:`abc.Messageable.trigger_typing` (use "
|
|
":meth:`abc.Messageable.typing`)"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:191
|
|
msgid "``Client.server_voice_state``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:193
|
|
msgid "``Client.start_private_message``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:193
|
|
msgid ":meth:`User.create_dm`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:195
|
|
msgid "``Client.unban``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:195
|
|
msgid ":meth:`Guild.unban` or :meth:`Member.unban`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:197
|
|
msgid "``Client.unpin_message``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:197
|
|
msgid ":meth:`Message.unpin`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:199
|
|
msgid "``Client.wait_for_message``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:199 ../../migrating.rst:201
|
|
msgid ":meth:`Client.wait_for` (see :ref:`migrating_1_0_wait_for`)"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:201
|
|
msgid "``Client.wait_for_reaction``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:203
|
|
msgid "``Client.wait_until_login``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:203 ../../migrating.rst:205
|
|
msgid "Removed"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:205
|
|
msgid "``Client.messages``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:207
|
|
msgid "``Client.wait_until_ready``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:207
|
|
msgid "No change"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:211
|
|
msgid "Property Changes"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:213
|
|
msgid ""
|
|
"In order to be a bit more consistent, certain things that were properties"
|
|
" were changed to methods instead."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:215
|
|
msgid ""
|
|
"The following are now methods instead of properties (requires "
|
|
"parentheses):"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:217
|
|
msgid ":meth:`Role.is_default`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:218
|
|
msgid ":meth:`Client.is_ready`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:219
|
|
msgid ":meth:`Client.is_closed`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:222
|
|
msgid "Dict Value Change"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:224
|
|
msgid ""
|
|
"Prior to v1.0 some aggregating properties that retrieved models would "
|
|
"return \"dict view\" objects."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:226
|
|
msgid ""
|
|
"As a consequence, when the dict would change size while you would iterate"
|
|
" over it, a RuntimeError would be raised and crash the task. To alleviate"
|
|
" this, the \"dict view\" objects were changed into lists."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:229
|
|
msgid "The following views were changed to a list:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:232
|
|
msgid ":attr:`Client.users` (new in v1.0)"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:233
|
|
msgid ":attr:`Client.emojis` (new in v1.0)"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:234
|
|
msgid ":attr:`Guild.channels`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:235
|
|
msgid ":attr:`Guild.text_channels` (new in v1.0)"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:236
|
|
msgid ":attr:`Guild.voice_channels` (new in v1.0)"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:237
|
|
msgid ":attr:`Guild.emojis`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:238
|
|
msgid ":attr:`Guild.members`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:241
|
|
msgid "Voice State Changes"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:243
|
|
msgid ""
|
|
"Earlier, in v0.11.0 a :class:`VoiceState` class was added to refer to "
|
|
"voice states along with a :attr:`Member.voice` attribute to refer to it."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:246
|
|
msgid ""
|
|
"However, it was transparent to the user. In an effort to make the library"
|
|
" save more memory, the voice state change is now more visible."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:249
|
|
msgid ""
|
|
"The only way to access voice attributes is via the :attr:`Member.voice` "
|
|
"attribute. Note that if the member does not have a voice state this "
|
|
"attribute can be ``None``."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:265
|
|
msgid "User and Member Type Split"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:267
|
|
msgid ""
|
|
"In v1.0 to save memory, :class:`User` and :class:`Member` are no longer "
|
|
"inherited. Instead, they are \"flattened\" by having equivalent "
|
|
"properties that map out to the functional underlying :class:`User`. Thus,"
|
|
" there is no functional change in how they are used. However this breaks "
|
|
"``isinstance`` checks and thus is something to keep in mind."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:271
|
|
msgid ""
|
|
"These memory savings were accomplished by having a global :class:`User` "
|
|
"cache, and as a positive consequence you can now easily fetch a "
|
|
":class:`User` by their ID by using the new :meth:`Client.get_user`. You "
|
|
"can also get a list of all :class:`User` your client can see with "
|
|
":attr:`Client.users`."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:278
|
|
msgid "Channel Type Split"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:280
|
|
msgid ""
|
|
"Prior to v1.0, channels were two different types, ``Channel`` and "
|
|
"``PrivateChannel`` with a ``is_private`` property to help differentiate "
|
|
"between them."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:283
|
|
msgid ""
|
|
"In order to save memory the channels have been split into 4 different "
|
|
"types:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:285
|
|
msgid ":class:`TextChannel` for guild text channels."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:286
|
|
msgid ":class:`VoiceChannel` for guild voice channels."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:287
|
|
msgid ":class:`DMChannel` for DM channels with members."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:288
|
|
msgid ":class:`GroupChannel` for Group DM channels with members."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:290
|
|
msgid ""
|
|
"With this split came the removal of the ``is_private`` attribute. You "
|
|
"should now use ``isinstance``."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:292
|
|
msgid "The types are split into two different :ref:`discord_api_abcs`:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:294
|
|
msgid ":class:`abc.GuildChannel` for guild channels."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:295
|
|
msgid ":class:`abc.PrivateChannel` for private channels (DMs and group DMs)."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:297
|
|
msgid "So to check if something is a guild channel you would do: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:301
|
|
msgid "And to check if it's a private channel you would do: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:305
|
|
msgid ""
|
|
"Of course, if you're looking for only a specific type you can pass that "
|
|
"too, e.g. ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:309
|
|
msgid ""
|
|
"With this type split also came event changes, which are enumerated in "
|
|
":ref:`migrating_1_0_event_changes`."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:313
|
|
msgid "Miscellaneous Model Changes"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:315
|
|
msgid "There were lots of other things added or removed in the models in general."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:317
|
|
msgid "They will be enumerated here."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:319
|
|
msgid "**Removed**"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:321
|
|
msgid ":meth:`Client.login` no longer accepts email and password logins."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:323
|
|
msgid "Use a token and ``bot=False``."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:327
|
|
msgid "Use :attr:`Client.emojis` instead."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:329
|
|
msgid "``Client.wait_for_message`` and ``Client.wait_for_reaction`` are gone."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:331
|
|
msgid "Use :meth:`Client.wait_for` instead."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:333
|
|
msgid "``Channel.voice_members``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:335
|
|
msgid "Use :attr:`VoiceChannel.members` instead."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:337
|
|
msgid "``Channel.is_private``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:339
|
|
msgid ""
|
|
"Use ``isinstance`` instead with one of the :ref:`discord_api_abcs` "
|
|
"instead."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:340
|
|
msgid ""
|
|
"e.g. ``isinstance(channel, discord.abc.GuildChannel)`` will check if it "
|
|
"isn't a private channel."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:342
|
|
msgid "``Client.accept_invite``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:344
|
|
msgid ""
|
|
"There is no replacement for this one. This functionality is deprecated "
|
|
"API wise."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:346
|
|
msgid ""
|
|
"``Guild.default_channel`` / ``Server.default_channel`` and "
|
|
"``Channel.is_default``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:348
|
|
msgid ""
|
|
"The concept of a default channel was removed from Discord. See `#329 "
|
|
"<https://github.com/hammerandchisel/discord-api-docs/pull/329>`_."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:351
|
|
msgid "``Message.edited_timestamp``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:353
|
|
msgid "Use :attr:`Message.edited_at` instead."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:355
|
|
msgid "``Message.timestamp``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:357
|
|
msgid "Use :attr:`Message.created_at` instead."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:359
|
|
msgid "``Colour.to_tuple()``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:361
|
|
msgid "Use :meth:`Colour.to_rgb` instead."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:363
|
|
msgid "``Permissions.view_audit_logs``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:365
|
|
msgid "Use :attr:`Permissions.view_audit_log` instead."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:367
|
|
msgid "``Member.game``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:369
|
|
msgid "Use :attr:`Member.activity` instead."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:371
|
|
msgid "**Changed**"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:373
|
|
msgid ""
|
|
":attr:`Member.avatar_url` and :attr:`User.avatar_url` now return the "
|
|
"default avatar if a custom one is not set."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:374
|
|
msgid ""
|
|
":attr:`Message.embeds` is now a list of :class:`Embed` instead of "
|
|
"``dict`` objects."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:375
|
|
msgid ""
|
|
":attr:`Message.attachments` is now a list of :class:`Attachment` instead "
|
|
"of ``dict`` object."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:377
|
|
msgid "**Added**"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:379
|
|
msgid ":class:`Attachment` to represent a discord attachment."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:380
|
|
msgid ":class:`CategoryChannel` to represent a channel category."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:381
|
|
msgid ""
|
|
":attr:`VoiceChannel.members` for fetching members connected to a voice "
|
|
"channel."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:382
|
|
msgid ":attr:`TextChannel.members` for fetching members that can see the channel."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:383
|
|
msgid ":attr:`Role.members` for fetching members that have the role."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:384
|
|
msgid ":attr:`Guild.text_channels` for fetching text channels only."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:385
|
|
msgid ":attr:`Guild.voice_channels` for fetching voice channels only."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:386
|
|
msgid ":attr:`Guild.categories` for fetching channel categories only."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:387
|
|
msgid ""
|
|
":attr:`TextChannel.category` and :attr:`VoiceChannel.category` to get the"
|
|
" category a channel belongs to."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:388
|
|
msgid ":meth:`Guild.by_category` to get channels grouped by their category."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:389
|
|
msgid ":attr:`Guild.chunked` to check member chunking status."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:390
|
|
msgid ":attr:`Guild.explicit_content_filter` to fetch the content filter."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:391
|
|
msgid ":attr:`Guild.shard_id` to get a guild's Shard ID if you're sharding."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:392
|
|
msgid ":attr:`Client.users` to get all visible :class:`User` instances."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:393
|
|
msgid ":meth:`Client.get_user` to get a :class:`User` by ID."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:394
|
|
msgid ":meth:`User.avatar_url_as` to get an avatar in a specific size or format."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:395
|
|
msgid ":meth:`Guild.vanity_invite` to fetch the guild's vanity invite."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:396
|
|
msgid ":meth:`Guild.audit_logs` to fetch the guild's audit logs."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:397
|
|
msgid ":attr:`Message.webhook_id` to fetch the message's webhook ID."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:398
|
|
msgid ""
|
|
":attr:`Message.activity` and :attr:`Message.application` for Rich "
|
|
"Presence related information."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:399
|
|
msgid ":meth:`TextChannel.is_nsfw` to check if a text channel is NSFW."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:400
|
|
msgid ":meth:`Colour.from_rgb` to construct a :class:`Colour` from RGB tuple."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:405
|
|
msgid "Sending Messages"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:407
|
|
msgid ""
|
|
"One of the changes that were done was the merger of the previous "
|
|
"``Client.send_message`` and ``Client.send_file`` functionality into a "
|
|
"single method, :meth:`~abc.Messageable.send`."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:410 ../../migrating.rst:990
|
|
msgid "Basically: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:418
|
|
msgid ""
|
|
"This supports everything that the old ``send_message`` supported such as "
|
|
"embeds: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:423
|
|
msgid ""
|
|
"There is a caveat with sending files however, as this functionality was "
|
|
"expanded to support multiple file attachments, you must now use a "
|
|
":class:`File` pseudo-namedtuple to upload a single file. ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:432
|
|
msgid "This change was to facilitate multiple file uploads: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:444
|
|
msgid "Asynchronous Iterators"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:446
|
|
msgid ""
|
|
"Prior to v1.0, certain functions like ``Client.logs_from`` would return a"
|
|
" different type if done in Python 3.4 or 3.5+."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:448
|
|
msgid ""
|
|
"In v1.0, this change has been reverted and will now return a singular "
|
|
"type meeting an abstract concept called :class:`AsyncIterator`."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:451
|
|
msgid "This allows you to iterate over it like normal: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:456
|
|
msgid "Or turn it into a list: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:462
|
|
msgid ""
|
|
"A handy aspect of returning :class:`AsyncIterator` is that it allows you "
|
|
"to chain functions together such as :meth:`AsyncIterator.map` or "
|
|
":meth:`AsyncIterator.filter`: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:468
|
|
msgid ""
|
|
"The functions passed to :meth:`AsyncIterator.map` or "
|
|
":meth:`AsyncIterator.filter` can be either coroutines or regular "
|
|
"functions."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:471
|
|
msgid ""
|
|
"You can also get single elements a la :func:`discord.utils.find` or "
|
|
":func:`discord.utils.get` via :meth:`AsyncIterator.get` or "
|
|
":meth:`AsyncIterator.find`: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:476
|
|
msgid "The following return :class:`AsyncIterator`:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:478
|
|
msgid ":meth:`abc.Messageable.history`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:479
|
|
msgid ":meth:`Guild.audit_logs`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:485 ../../migrating.rst:907
|
|
msgid "Event Changes"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:487
|
|
msgid "A lot of events have gone through some changes."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:489
|
|
msgid ""
|
|
"Many events with ``server`` in the name were changed to use ``guild`` "
|
|
"instead."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:491 ../../migrating.rst:555
|
|
msgid "Before:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:493
|
|
msgid "``on_server_join``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:494
|
|
msgid "``on_server_remove``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:495
|
|
msgid "``on_server_update``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:496
|
|
msgid "``on_server_role_create``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:497
|
|
msgid "``on_server_role_delete``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:498
|
|
msgid "``on_server_role_update``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:499
|
|
msgid "``on_server_emojis_update``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:500
|
|
msgid "``on_server_available``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:501
|
|
msgid "``on_server_unavailable``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:503 ../../migrating.rst:561
|
|
msgid "After:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:505
|
|
msgid ":func:`on_guild_join`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:506
|
|
msgid ":func:`on_guild_remove`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:507
|
|
msgid ":func:`on_guild_update`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:508
|
|
msgid ":func:`on_guild_role_create`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:509
|
|
msgid ":func:`on_guild_role_delete`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:510
|
|
msgid ":func:`on_guild_role_update`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:511
|
|
msgid ":func:`on_guild_emojis_update`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:512
|
|
msgid ":func:`on_guild_available`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:513
|
|
msgid ":func:`on_guild_unavailable`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:516
|
|
msgid "The :func:`on_voice_state_update` event has received an argument change."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:518 ../../migrating.rst:530 ../../migrating.rst:542
|
|
#: ../../migrating.rst:602 ../../migrating.rst:911
|
|
msgid "Before: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:522 ../../migrating.rst:534 ../../migrating.rst:546
|
|
#: ../../migrating.rst:614 ../../migrating.rst:917 ../../migrating.rst:1070
|
|
msgid "After: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:526
|
|
msgid ""
|
|
"Instead of two :class:`Member` objects, the new event takes one "
|
|
":class:`Member` object and two :class:`VoiceState` objects."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:528
|
|
msgid "The :func:`on_guild_emojis_update` event has received an argument change."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:538
|
|
msgid ""
|
|
"The first argument is now the :class:`Guild` that the emojis were updated"
|
|
" from."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:540
|
|
msgid "The :func:`on_member_ban` event has received an argument change as well:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:550
|
|
msgid ""
|
|
"As part of the change, the event can either receive a :class:`User` or "
|
|
":class:`Member`. To help in the cases that have :class:`User`, the "
|
|
":class:`Guild` is provided as the first parameter."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:553
|
|
msgid ""
|
|
"The ``on_channel_`` events have received a type level split (see "
|
|
":ref:`migrating_1_0_channel_split`)."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:557
|
|
msgid "``on_channel_delete``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:558
|
|
msgid "``on_channel_create``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:559
|
|
msgid "``on_channel_update``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:563
|
|
msgid ":func:`on_guild_channel_delete`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:564
|
|
msgid ":func:`on_guild_channel_create`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:565
|
|
msgid ":func:`on_guild_channel_update`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:566
|
|
msgid ":func:`on_private_channel_delete`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:567
|
|
msgid ":func:`on_private_channel_create`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:568
|
|
msgid ":func:`on_private_channel_update`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:570
|
|
msgid ""
|
|
"The ``on_guild_channel_`` events correspond to :class:`abc.GuildChannel` "
|
|
"being updated (i.e. :class:`TextChannel` and :class:`VoiceChannel`) and "
|
|
"the ``on_private_channel_`` events correspond to "
|
|
":class:`abc.PrivateChannel` being updated (i.e. :class:`DMChannel` and "
|
|
":class:`GroupChannel`)."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:577
|
|
msgid "Voice Changes"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:579
|
|
msgid "Voice sending has gone through a complete redesign."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:581
|
|
msgid "In particular:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:583
|
|
msgid ""
|
|
"Connection is done through :meth:`VoiceChannel.connect` instead of "
|
|
"``Client.join_voice_channel``."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:584
|
|
msgid ""
|
|
"You no longer create players and operate on them (you no longer store "
|
|
"them)."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:585
|
|
msgid ""
|
|
"You instead request :class:`VoiceClient` to play an :class:`AudioSource` "
|
|
"via :meth:`VoiceClient.play`."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:586
|
|
msgid "There are different built-in :class:`AudioSource`\\s."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:588
|
|
msgid ":class:`FFmpegPCMAudio` is the equivalent of ``create_ffmpeg_player``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:590
|
|
msgid ""
|
|
"create_ffmpeg_player/create_stream_player/create_ytdl_player have all "
|
|
"been removed."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:592
|
|
msgid "The goal is to create :class:`AudioSource` instead."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:594
|
|
msgid "Using :meth:`VoiceClient.play` will not return an ``AudioPlayer``."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:596
|
|
msgid "Instead, it's \"flattened\" like :class:`User` -> :class:`Member` is."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:598
|
|
msgid "The ``after`` parameter now takes a single parameter (the error)."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:600
|
|
msgid "Basically:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:624
|
|
msgid ""
|
|
"With the changed :class:`AudioSource` design, you can now change the "
|
|
"source that the :class:`VoiceClient` is playing at runtime via "
|
|
":attr:`VoiceClient.source`."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:627
|
|
msgid ""
|
|
"For example, you can add a :class:`PCMVolumeTransformer` to allow "
|
|
"changing the volume: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:632
|
|
msgid ""
|
|
"An added benefit of the redesign is that it will be much more resilient "
|
|
"towards reconnections:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:634
|
|
msgid ""
|
|
"The voice websocket will now automatically re-connect and re-do the "
|
|
"handshake when disconnected."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:635
|
|
msgid ""
|
|
"The initial connect handshake will now retry up to 5 times so you no "
|
|
"longer get as many ``asyncio.TimeoutError``."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:636
|
|
msgid "Audio will now stop and resume when a disconnect is found."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:638
|
|
msgid "This includes changing voice regions etc."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:644
|
|
msgid "Waiting For Events"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:646
|
|
msgid ""
|
|
"Prior to v1.0, the machinery for waiting for an event outside of the "
|
|
"event itself was done through two different functions, "
|
|
"``Client.wait_for_message`` and ``Client.wait_for_reaction``. One problem"
|
|
" with one such approach is that it did not allow you to wait for events "
|
|
"outside of the ones provided by the library."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:650
|
|
msgid ""
|
|
"In v1.0 the concept of waiting for another event has been generalised to "
|
|
"work with any event as :meth:`Client.wait_for`."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:652
|
|
msgid "For example, to wait for a message: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:663
|
|
msgid ""
|
|
"To facilitate multiple returns, :meth:`Client.wait_for` returns either a "
|
|
"single argument, no arguments, or a tuple of arguments."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:666
|
|
msgid "For example, to wait for a reaction: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:672
|
|
msgid ""
|
|
"Since this function now can return multiple arguments, the ``timeout`` "
|
|
"parameter will now raise a :exc:`asyncio.TimeoutError` when reached "
|
|
"instead of setting the return to ``None``. For example:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:689
|
|
msgid "Upgraded Dependencies"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:691
|
|
msgid ""
|
|
"Following v1.0 of the library, we've updated our requirements to "
|
|
"``aiohttp`` v2.0 or higher."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:693
|
|
msgid ""
|
|
"Since this is a backwards incompatible change, it is recommended that you"
|
|
" see the `changes "
|
|
"<http://aiohttp.readthedocs.io/en/stable/changes.html#rc1-2017-03-15>`_ "
|
|
"and the `migrating "
|
|
"<http://aiohttp.readthedocs.io/en/stable/migration.html>`_ pages for "
|
|
"details on the breaking changes in ``aiohttp``."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:698
|
|
msgid ""
|
|
"Of the most significant for common users is the removal of helper "
|
|
"functions such as:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:700
|
|
msgid "``aiohttp.get``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:701
|
|
msgid "``aiohttp.post``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:702
|
|
msgid "``aiohttp.delete``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:703
|
|
msgid "``aiohttp.patch``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:704
|
|
msgid "``aiohttp.head``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:705
|
|
msgid "``aiohttp.put``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:706
|
|
msgid "``aiohttp.request``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:708
|
|
msgid "It is recommended that you create a session instead: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:714
|
|
msgid ""
|
|
"Since it is better to not create a session for every request, you should "
|
|
"store it in a variable and then call ``session.close`` on it when it "
|
|
"needs to be disposed."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:718
|
|
msgid "Sharding"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:720
|
|
msgid ""
|
|
"The library has received significant changes on how it handles sharding "
|
|
"and now has sharding as a first-class citizen."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:722
|
|
msgid ""
|
|
"If using a Bot account and you want to shard your bot in a single process"
|
|
" then you can use the :class:`AutoShardedClient`."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:724
|
|
msgid ""
|
|
"This class allows you to use sharding without having to launch multiple "
|
|
"processes or deal with complicated IPC."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:726
|
|
msgid ""
|
|
"It should be noted that **the sharded client does not support user "
|
|
"accounts**. This is due to the changes in connection logic and state "
|
|
"handling."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:729
|
|
msgid "Usage is as simple as doing: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:733
|
|
msgid "instead of using :class:`Client`."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:735
|
|
msgid ""
|
|
"This will launch as many shards as your bot needs using the "
|
|
"``/gateway/bot`` endpoint, which allocates about 1000 guilds per shard."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:738
|
|
msgid ""
|
|
"If you want more control over the sharding you can specify "
|
|
"``shard_count`` and ``shard_ids``. ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:746
|
|
msgid ""
|
|
"For users of the command extension, there is also "
|
|
":class:`~ext.commands.AutoShardedBot` which behaves similarly."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:749
|
|
msgid "Connection Improvements"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:751
|
|
msgid "In v1.0, the auto reconnection logic has been powered up significantly."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:753
|
|
msgid ""
|
|
":meth:`Client.connect` has gained a new keyword argument, ``reconnect`` "
|
|
"that defaults to ``True`` which controls the reconnect logic. When "
|
|
"enabled, the client will automatically reconnect in all instances of your"
|
|
" internet going offline or Discord going offline with exponential back-"
|
|
"off."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:757
|
|
msgid ""
|
|
":meth:`Client.run` and :meth:`Client.start` gains this keyword argument "
|
|
"as well, but for most cases you will not need to specify it unless "
|
|
"turning it off."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:763
|
|
msgid "Command Extension Changes"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:765
|
|
msgid ""
|
|
"Due to the :ref:`migrating_1_0_model_state` changes, some of the design "
|
|
"of the extension module had to undergo some design changes as well."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:769
|
|
msgid "Context Changes"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:771
|
|
msgid ""
|
|
"In v1.0, the :class:`.Context` has received a lot of changes with how "
|
|
"it's retrieved and used."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:773
|
|
msgid ""
|
|
"The biggest change is that ``pass_context=True`` no longer exists, "
|
|
":class:`.Context` is always passed. Ergo:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:787
|
|
msgid ""
|
|
"The reason for this is because :class:`~ext.commands.Context` now meets "
|
|
"the requirements of :class:`abc.Messageable`. This makes it have similar "
|
|
"functionality to :class:`TextChannel` or :class:`DMChannel`. Using "
|
|
":meth:`~.Context.send` will either DM the user in a DM context or send a "
|
|
"message in the channel it was in, similar to the old ``bot.say`` "
|
|
"functionality. The old helpers have been removed in favour of the new "
|
|
":class:`abc.Messageable` interface. See "
|
|
":ref:`migrating_1_0_removed_helpers` for more information."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:793
|
|
msgid ""
|
|
"Since the :class:`~ext.commands.Context` is now by default passed, "
|
|
"several shortcuts have been added:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:795
|
|
msgid "**New Shortcuts**"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:797
|
|
msgid ""
|
|
":attr:`~ext.commands.Context.author` is a shortcut for "
|
|
"``ctx.message.author``."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:798
|
|
msgid ""
|
|
":attr:`~ext.commands.Context.guild` is a shortcut for "
|
|
"``ctx.message.guild``."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:799
|
|
msgid ""
|
|
":attr:`~ext.commands.Context.channel` is a shortcut for "
|
|
"``ctx.message.channel``."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:800
|
|
msgid ""
|
|
":attr:`~ext.commands.Context.me` is a shortcut for "
|
|
"``ctx.message.guild.me`` or ``ctx.bot.user``."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:801
|
|
msgid ""
|
|
":attr:`~ext.commands.Context.voice_client` is a shortcut for "
|
|
"``ctx.message.guild.voice_client``."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:803
|
|
msgid "**New Functionality**"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:805
|
|
msgid ":meth:`~.Context.reinvoke` to invoke a command again."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:807
|
|
msgid "This is useful for bypassing cooldowns."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:810
|
|
msgid "Subclassing Context"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:812
|
|
msgid ""
|
|
"In v1.0, there is now the ability to subclass "
|
|
":class:`~ext.commands.Context` and use it instead of the default provided"
|
|
" one."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:815
|
|
msgid "For example, if you want to add some functionality to the context:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:824
|
|
msgid ""
|
|
"Then you can use :meth:`~ext.commands.Bot.get_context` inside "
|
|
":func:`on_message` with combination with :meth:`~ext.commands.Bot.invoke`"
|
|
" to use your custom context:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:834
|
|
msgid "Now inside your commands you will have access to your custom context:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:845
|
|
msgid "Removed Helpers"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:847
|
|
msgid ""
|
|
"With the new :class:`.Context` changes, a lot of message sending helpers "
|
|
"have been removed."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:849
|
|
msgid "For a full list of changes, see below:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:854
|
|
msgid "``Bot.say``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:854 ../../migrating.rst:856
|
|
msgid ":meth:`.Context.send`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:856
|
|
msgid "``Bot.upload``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:858
|
|
msgid "``Bot.whisper``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:858
|
|
msgid "``ctx.author.send``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:860
|
|
msgid "``Bot.type``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:860
|
|
msgid ":meth:`.Context.typing` or :meth:`.Context.trigger_typing`"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:862
|
|
msgid "``Bot.reply``"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:862
|
|
msgid "No replacement."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:866
|
|
msgid "Command Changes"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:868
|
|
msgid ""
|
|
"As mentioned earlier, the first command change is that "
|
|
"``pass_context=True`` no longer exists, so there is no need to pass this "
|
|
"as a parameter."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:871
|
|
msgid ""
|
|
"Another change is the removal of ``no_pm=True``. Instead, use the new "
|
|
":func:`~ext.commands.guild_only` built-in check."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:874
|
|
msgid ""
|
|
"The ``commands`` attribute of :class:`~ext.commands.Bot` and "
|
|
":class:`~ext.commands.Group` have been changed from a dictionary to a set"
|
|
" that does not have aliases. To retrieve the previous dictionary "
|
|
"behaviour, use ``all_commands`` instead."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:877
|
|
msgid "Command instances have gained new attributes and properties:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:879
|
|
msgid ""
|
|
":attr:`~ext.commands.Command.signature` to get the signature of the "
|
|
"command."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:880
|
|
msgid ":attr:`~.Command.usage`, an attribute to override the default signature."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:881
|
|
msgid ""
|
|
":attr:`~.Command.root_parent` to get the root parent group of a "
|
|
"subcommand."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:883
|
|
msgid ""
|
|
"For :class:`~ext.commands.Group` and :class:`~ext.commands.Bot` the "
|
|
"following changed:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:885
|
|
msgid "Changed :attr:`~.GroupMixin.commands` to be a ``set`` without aliases."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:887
|
|
msgid ""
|
|
"Use :attr:`~.GroupMixin.all_commands` to get the old ``dict`` with all "
|
|
"commands."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:890
|
|
msgid "Check Changes"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:892
|
|
msgid ""
|
|
"Prior to v1.0, :func:`~ext.commands.check`\\s could only be synchronous. "
|
|
"As of v1.0 checks can now be coroutines."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:894
|
|
msgid "Along with this change, a couple new checks were added."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:896
|
|
msgid ""
|
|
":func:`~ext.commands.guild_only` replaces the old ``no_pm=True`` "
|
|
"functionality."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:897
|
|
msgid ""
|
|
":func:`~ext.commands.is_owner` uses the :meth:`Client.application_info` "
|
|
"endpoint by default to fetch owner ID."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:899
|
|
msgid ""
|
|
"This is actually powered by a different function, "
|
|
":meth:`~ext.commands.Bot.is_owner`."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:900
|
|
msgid "You can set the owner ID yourself by setting :attr:`.Bot.owner_id`."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:902
|
|
msgid ""
|
|
":func:`~ext.commands.is_nsfw` checks if the channel the command is in is "
|
|
"a NSFW channel."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:904
|
|
msgid "This is powered by the new :meth:`TextChannel.is_nsfw` method."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:909
|
|
msgid "All command extension events have changed."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:923
|
|
msgid ""
|
|
"The extraneous ``command`` parameter in :func:`.on_command` and "
|
|
":func:`.on_command_completion` have been removed. The "
|
|
":class:`~ext.commands.Command` instance was not kept up-to date so it was"
|
|
" incorrect. In order to get the up to date :class:`~ext.commands.Command`"
|
|
" instance, use the :attr:`.Context.command` attribute."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:928
|
|
msgid ""
|
|
"The error handlers, either :meth:`.Command.error` or "
|
|
":func:`.on_command_error`, have been re-ordered to use the "
|
|
":class:`~ext.commands.Context` as its first parameter to be consistent "
|
|
"with other events and commands."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:933
|
|
msgid "Cog Changes"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:935
|
|
msgid "Cog special methods have changed slightly."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:937
|
|
msgid ""
|
|
"The previous ``__check`` special method has been renamed to "
|
|
"``__global_check`` to make it more clear that it's a global check."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:940
|
|
msgid ""
|
|
"To complement the new ``__global_check`` there is now a new "
|
|
"``__local_check`` to facilitate a check that will run on every command in"
|
|
" the cog. There is also a ``__global_check_once``, which is similar to a "
|
|
"global check instead it is only called once per :meth:`.Bot.invoke` call "
|
|
"rather than every :meth:`.Command.invoke` call. Practically, the "
|
|
"difference is only for black-listing users or channels without constantly"
|
|
" opening a database connection."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:945
|
|
msgid ""
|
|
"Cogs have also gained a ``__before_invoke`` and ``__after_invoke`` cog "
|
|
"local before and after invocation hook, which can be seen in "
|
|
":ref:`migrating_1_0_before_after_hook`."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:948
|
|
msgid ""
|
|
"The final addition is cog-local error handler, ``__error``, that is run "
|
|
"on every command in the cog."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:950
|
|
msgid "An example cog with every special method registered is as follows: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:981
|
|
msgid "Before and After Invocation Hooks"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:983
|
|
msgid ""
|
|
"Commands have gained new before and after invocation hooks that allow you"
|
|
" to do an action before and after a command is run."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:986
|
|
msgid ""
|
|
"They take a single parameter, :class:`~ext.commands.Context` and they "
|
|
"must be a coroutine."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:988
|
|
msgid "They are on a global, per-cog, or per-command basis."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1005
|
|
msgid ""
|
|
"The after invocation is hook always called, **regardless of an error in "
|
|
"the command**. This makes it ideal for some error handling or clean up of"
|
|
" certain resources such a database connection."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1008
|
|
msgid "The per-command registration is as follows: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1024
|
|
msgid ""
|
|
"The special cog method for these is ``__before_invoke`` and "
|
|
"``__after_invoke``, e.g.: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1037
|
|
msgid ""
|
|
"To check if a command failed in the after invocation hook, you can use "
|
|
":attr:`.Context.command_failed`."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1040
|
|
msgid "The invocation order is as follows:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1042
|
|
msgid "Command local before invocation hook"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1043
|
|
msgid "Cog local before invocation hook"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1044
|
|
msgid "Global before invocation hook"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1045
|
|
msgid "The actual command"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1046
|
|
msgid "Command local after invocation hook"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1047
|
|
msgid "Cog local after invocation hook"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1048
|
|
msgid "Global after invocation hook"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1051
|
|
msgid "Converter Changes"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1053
|
|
msgid ""
|
|
"Prior to v1.0, a converter was a type hint that could be a callable that "
|
|
"could be invoked with a singular argument denoting the argument passed by"
|
|
" the user as a string."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1056
|
|
msgid ""
|
|
"This system was eventually expanded to support a "
|
|
":class:`~ext.commands.Converter` system to allow plugging in the "
|
|
":class:`~ext.commands.Context` and do more complicated conversions such "
|
|
"as the built-in \"discord\" converters."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1060
|
|
msgid ""
|
|
"In v1.0 this converter system was revamped to allow instances of "
|
|
":class:`~ext.commands.Converter` derived classes to be passed. For "
|
|
"consistency, the :meth:`~ext.commands.Converter.convert` method was "
|
|
"changed to always be a coroutine and will now take the two arguments as "
|
|
"parameters."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1064
|
|
msgid "Essentially, before: ::"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1076
|
|
msgid "The command framework also got a couple new converters:"
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1078
|
|
msgid ""
|
|
":class:`~ext.commands.clean_content` this is akin to "
|
|
":attr:`Message.clean_content` which scrubs mentions."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1079
|
|
msgid ""
|
|
":class:`~ext.commands.UserConverter` will now appropriately convert "
|
|
":class:`User` only."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1080
|
|
msgid "``ChannelConverter`` is now split into two different converters."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1082
|
|
msgid ":class:`~ext.commands.TextChannelConverter` for :class:`TextChannel`."
|
|
msgstr ""
|
|
|
|
#: ../../migrating.rst:1083
|
|
msgid ":class:`~ext.commands.VoiceChannelConverter` for :class:`VoiceChannel`."
|
|
msgstr ""
|
|
|