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

Correct the documentation for methods and properties that return Assets

Browse Source
This commit is contained in:
Vexs
2019-05-14 16:51:50 -05:00
committed by Rapptz
parent 5473cec6ac
commit bf5b267c55
5 changed files with 22 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
discord/channel.py
View File

@@ -1030,7 +1030,7 @@ class GroupChannel(discord.abc.Messageable, Hashable):
@property
def icon_url(self):
""":class:`Asset`: Returns the channel's icon asset if available."""
""":class:`Asset`: Returns the channel's icon asset."""
return Asset._from_icon(self._state, self, 'channel')
@property

12
discord/guild.py
View File

@@ -418,11 +418,11 @@ class Guild(Hashable):
@property
def icon_url(self):
"""Returns the URL version of the guild's icon. Returns an empty string if it has no icon."""
""":class:`Asset`: Returns the guild's icon asset."""
return self.icon_url_as()
def icon_url_as(self, *, format='webp', size=1024):
"""Returns a friendly URL version of the guild's icon. Returns an empty string if it has no icon.
"""Returns a :class:`Asset`: for the guild's icon.
The format must be one of 'webp', 'jpeg', 'jpg', or 'png'. The
size must be a power of 2 between 16 and 4096.
@@ -448,11 +448,11 @@ class Guild(Hashable):
@property
def banner_url(self):
"""Returns the URL version of the guild's banner. Returns an empty string if it has no banner."""
""":class:`Asset`: Returns the guild's banner asset."""
return self.banner_url_as()
def banner_url_as(self, *, format='webp', size=2048):
"""Returns a friendly URL version of the guild's banner. Returns an empty string if it has no banner.
"""Returns a :class:`Asset`: for the guild's banner.
The format must be one of 'webp', 'jpeg', or 'png'. The
size must be a power of 2 between 16 and 4096.
@@ -478,11 +478,11 @@ class Guild(Hashable):
@property
def splash_url(self):
"""Returns the URL version of the guild's invite splash. Returns an empty string if it has no splash."""
""":class:`Asset`: Returns the guild's invite splash asset."""
return self.splash_url_as()
def splash_url_as(self, *, format='webp', size=2048):
"""Returns a friendly URL version of the guild's invite splash. Returns an empty string if it has no splash.
"""Returns a :class:`Asset`: for the guild's invite splash.
The format must be one of 'webp', 'jpeg', 'jpg', or 'png'. The
size must be a power of 2 between 16 and 4096.

6
discord/invite.py
View File

@@ -151,7 +151,7 @@ class PartialInviteGuild:
@property
def icon_url(self):
"""Returns the URL version of the guild's icon. Returns an empty string if it has no icon."""
""":class:`Asset`: Returns the guild's icon asset."""
return self.icon_url_as()
def icon_url_as(self, *, format='webp', size=1024):
@@ -160,7 +160,7 @@ class PartialInviteGuild:
@property
def banner_url(self):
"""Returns the URL version of the guild's banner. Returns an empty string if it has no banner."""
""":class:`Asset`: Returns the guild's banner asset."""
return self.banner_url_as()
def banner_url_as(self, *, format='webp', size=2048):
@@ -169,7 +169,7 @@ class PartialInviteGuild:
@property
def splash_url(self):
"""Returns the URL version of the guild's invite splash. Returns an empty string if it has no splash."""
""":class:`Asset`: Returns the guild's invite splash asset."""
return self.splash_url_as()
def splash_url_as(self, *, format='webp', size=2048):

12
discord/user.py
View File

@@ -114,10 +114,10 @@ class BaseUser(_BaseUser):
@property
def avatar_url(self):
"""Returns a friendly URL version of the avatar the user has.
"""Returns a :class:`Asset`: for the avatar the user has.
If the user does not have a traditional avatar, their default
avatar URL is returned instead.
If the user does not have a traditional avatar, an asset for
the default avatar is returned instead.
This is equivalent to calling :meth:`avatar_url_as` with
the default parameters (i.e. webp/gif detection and a size of 1024).
@@ -129,10 +129,10 @@ class BaseUser(_BaseUser):
return bool(self.avatar and self.avatar.startswith('a_'))
def avatar_url_as(self, *, format=None, static_format='webp', size=1024):
"""Returns a friendly URL version of the avatar the user has.
"""Returns a :class:`Asset`: for the avatar the user has.
If the user does not have a traditional avatar, their default
avatar URL is returned instead.
If the user does not have a traditional avatar, an asset for
the default avatar is returned instead.
The format must be one of 'webp', 'jpeg', 'jpg', 'png' or 'gif', and
'gif' is only valid for animated avatars. The size must be a power of 2

12
discord/webhook.py
View File

@@ -523,10 +523,10 @@ class Webhook:
@property
def avatar_url(self):
"""Returns a friendly URL version of the avatar the webhook has.
"""Returns a :class:`Asset`: for the avatar the webhook has.
If the webhook does not have a traditional avatar, their default
avatar URL is returned instead.
If the webhook does not have a traditional avatar, an asset for
the default avatar is returned instead.
This is equivalent to calling :meth:`avatar_url_as` with the
default parameters.
@@ -534,10 +534,10 @@ class Webhook:
return self.avatar_url_as()
def avatar_url_as(self, *, format=None, size=1024):
"""Returns a friendly URL version of the avatar the webhook has.
"""Returns a :class:`Asset`: for the avatar the webhook has.
If the webhook does not have a traditional avatar, their default
avatar URL is returned instead.
If the webhook does not have a traditional avatar, an asset for
the default avatar is returned instead.
The format must be one of 'jpeg', 'jpg', or 'png'.
The size must be a power of 2 between 16 and 1024.