diff options
| author | Vexs <[email protected]> | 2019-04-09 10:00:16 -0500 |
|---|---|---|
| committer | Rapptz <[email protected]> | 2019-04-10 00:55:45 -0400 |
| commit | 4df0f79a6b60b89e5e0aeccaa3b7b642f456c9f2 (patch) | |
| tree | fd9eeb18c95bfd28db19831f938012938bb38096 | |
| parent | Fix various bugs with Asset._url None handling. (diff) | |
| download | discord.py-4df0f79a6b60b89e5e0aeccaa3b7b642f456c9f2.tar.xz discord.py-4df0f79a6b60b89e5e0aeccaa3b7b642f456c9f2.zip | |
Add notes warning that fetch_ methods are api calls
Also recommends using cache attributes/methods instead
| -rw-r--r-- | discord/client.py | 12 | ||||
| -rw-r--r-- | discord/guild.py | 13 |
2 files changed, 25 insertions, 0 deletions
diff --git a/discord/client.py b/discord/client.py index 008d44fe..a3ebdf08 100644 --- a/discord/client.py +++ b/discord/client.py @@ -861,6 +861,10 @@ class Client: Using this, you will only receive :attr:`Guild.owner`, :attr:`Guild.icon`, :attr:`Guild.id`, and :attr:`Guild.name` per :class:`Guild`. + .. note:: + + This method is an API call. For general usage, consider :attr:`guilds` instead. + All parameters are optional. Parameters @@ -912,6 +916,10 @@ class Client: Using this, you will not receive :attr:`Guild.channels`, :class:`Guild.members`, :attr:`Member.activity` and :attr:`Member.voice` per :class:`Member`. + .. note:: + + This method is an API call. For general usage, consider :meth:`get_guild` instead. + Parameters ----------- guild_id: :class:`int` @@ -1099,6 +1107,10 @@ class Client: with the user to get this information, however many operations do require that you do. + .. note:: + + This method is an API call. For general usage, consider :meth:`get_user` instead. + Parameters ----------- user_id: :class:`int` diff --git a/discord/guild.py b/discord/guild.py index 260d296b..52982856 100644 --- a/discord/guild.py +++ b/discord/guild.py @@ -931,6 +931,10 @@ class Guild(Hashable): Retreives a :class:`Member` from a guild ID, and a member ID. + .. note:: + + This method is an API call. For general usage, consider :meth:`get_member` instead. + Parameters ----------- member_id: :class:`int` @@ -1149,6 +1153,10 @@ class Guild(Hashable): Retrieves all custom :class:`Emoji`\s from the guild. + .. note:: + + This method is an API call. For general usage, consider :attr:`emojis` instead. + Raises --------- HTTPException @@ -1167,6 +1175,11 @@ class Guild(Hashable): Retrieves a custom :class:`Emoji` from the guild. + .. note:: + + This method is an API call. + For general usage, consider iterating over :attr:`emojis` instead. + Parameters ------------- emoji_id: :class:`int` |