matthew/enhanced-discord.py
1
0
Fork 0
Code Issues 4 Pull Requests 21 Projects Releases Wiki Activity

Add notes warning that fetch_ methods are api calls

Browse Source 
Also recommends using cache attributes/methods instead
This commit is contained in:
Vexs 2019-04-09 10:00:16 -05:00 committed by Rapptz
parent 407d18a30d
commit 4df0f79a6b
2 changed files with 25 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
discord/client.py
View File

@ -861,6 +861,10 @@ class Client:
Using this, you will only receive :attr:`Guild.owner`, :attr:`Guild.icon`, Using this, you will only receive :attr:`Guild.owner`, :attr:`Guild.icon`,
:attr:`Guild.id`, and :attr:`Guild.name` per :class:`Guild`. :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. All parameters are optional.
Parameters Parameters
@ -912,6 +916,10 @@ class Client:
Using this, you will not receive :attr:`Guild.channels`, :class:`Guild.members`, Using this, you will not receive :attr:`Guild.channels`, :class:`Guild.members`,
:attr:`Member.activity` and :attr:`Member.voice` per :class:`Member`. :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 Parameters
----------- -----------
guild_id: :class:`int` guild_id: :class:`int`
@ -1099,6 +1107,10 @@ class Client:
with the user to get this information, however many operations with the user to get this information, however many operations
do require that you do. do require that you do.
.. note::
This method is an API call. For general usage, consider :meth:`get_user` instead.
Parameters Parameters
----------- -----------
user_id: :class:`int` user_id: :class:`int`

13
discord/guild.py
View File

@ -931,6 +931,10 @@ class Guild(Hashable):
Retreives a :class:`Member` from a guild ID, and a member ID. 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 Parameters
----------- -----------
member_id: :class:`int` member_id: :class:`int`
@ -1149,6 +1153,10 @@ class Guild(Hashable):
Retrieves all custom :class:`Emoji`\s from the guild. Retrieves all custom :class:`Emoji`\s from the guild.
.. note::
This method is an API call. For general usage, consider :attr:`emojis` instead.
Raises Raises
--------- ---------
HTTPException HTTPException
@ -1167,6 +1175,11 @@ class Guild(Hashable):
Retrieves a custom :class:`Emoji` from the guild. 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 Parameters
------------- -------------
emoji_id: :class:`int` emoji_id: :class:`int`