[pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

Author: pre-commit-ci[bot]

discord/abc.py

@@ -229,12 +229,14 @@ class User(Snowflake, Protocol):
 
     @property
     def display_name(self) -> str:
-        """Returns the user's display name."""
+        """Returns the user's display name.
+        """
         raise NotImplementedError
 
     @property
     def mention(self) -> str:
-        """Returns a string that allows you to mention the given user."""
+        """Returns a string that allows you to mention the given user.
+        """
         raise NotImplementedError
 
 
@@ -544,7 +546,8 @@ def changed_roles(self) -> list[Role]:
 
     @property
     def mention(self) -> str:
-        """The string that allows you to mention the channel."""
+        """The string that allows you to mention the channel.
+        """
         return f"<#{self.id}>"
 
     @property
@@ -557,7 +560,8 @@ def jump_url(self) -> str:
 
     @property
     def created_at(self) -> datetime:
-        """Returns the channel's creation time in UTC."""
+        """Returns the channel's creation time in UTC.
+        """
         return utils.snowflake_time(self.id)
 
     def overwrites_for(self, obj: Role | User) -> PermissionOverwrite:

discord/activity.py

@@ -279,7 +279,8 @@ def to_dict(self) -> dict[str, Any]:
 
     @property
     def start(self) -> datetime.datetime | None:
-        """When the user started doing this activity in UTC, if applicable."""
+        """When the user started doing this activity in UTC, if applicable.
+        """
         try:
             timestamp = self.timestamps["start"] / 1000
         except KeyError:
@@ -289,7 +290,8 @@ def start(self) -> datetime.datetime | None:
 
     @property
     def end(self) -> datetime.datetime | None:
-        """When the user will stop doing this activity in UTC, if applicable."""
+        """When the user will stop doing this activity in UTC, if applicable.
+        """
         try:
             timestamp = self.timestamps["end"] / 1000
         except KeyError:
@@ -299,7 +301,8 @@ def end(self) -> datetime.datetime | None:
 
     @property
     def large_image_url(self) -> str | None:
-        """Returns a URL pointing to the large image asset of this activity if applicable."""
+        """Returns a URL pointing to the large image asset of this activity if applicable.
+        """
         if self.application_id is None:
             return None
 
@@ -312,7 +315,8 @@ def large_image_url(self) -> str | None:
 
     @property
     def small_image_url(self) -> str | None:
-        """Returns a URL pointing to the small image asset of this activity if applicable."""
+        """Returns a URL pointing to the small image asset of this activity if applicable.
+        """
         if self.application_id is None:
             return None
 
@@ -325,12 +329,14 @@ def small_image_url(self) -> str | None:
 
     @property
     def large_image_text(self) -> str | None:
-        """Returns the large image asset hover text of this activity if applicable."""
+        """Returns the large image asset hover text of this activity if applicable.
+        """
         return self.assets.get("large_text", None)
 
     @property
     def small_image_text(self) -> str | None:
-        """Returns the small image asset hover text of this activity if applicable."""
+        """Returns the small image asset hover text of this activity if applicable.
+        """
         return self.assets.get("small_text", None)
 
 
@@ -393,7 +399,8 @@ def type(self) -> ActivityType:
 
     @property
     def start(self) -> datetime.datetime | None:
-        """When the user started playing this game in UTC, if applicable."""
+        """When the user started playing this game in UTC, if applicable.
+        """
         if self._start:
             return datetime.datetime.fromtimestamp(
                 self._start / 1000, tz=datetime.timezone.utc
@@ -402,7 +409,8 @@ def start(self) -> datetime.datetime | None:
 
     @property
     def end(self) -> datetime.datetime | None:
-        """When the user will stop playing this game in UTC, if applicable."""
+        """When the user will stop playing this game in UTC, if applicable.
+        """
         if self._end:
             return datetime.datetime.fromtimestamp(
                 self._end / 1000, tz=datetime.timezone.utc
@@ -643,7 +651,8 @@ def to_dict(self) -> dict[str, Any]:
 
     @property
     def name(self) -> str:
-        """The activity's name. This will always return "Spotify"."""
+        """The activity's name. This will always return "Spotify".
+        """
         return "Spotify"
 
     def __eq__(self, other: Any) -> bool:
@@ -671,12 +680,14 @@ def __repr__(self) -> str:
 
     @property
     def title(self) -> str:
-        """The title of the song being played."""
+        """The title of the song being played.
+        """
         return self._details
 
     @property
     def artists(self) -> list[str]:
-        """The artists of the song being played."""
+        """The artists of the song being played.
+        """
         return self._state.split("; ")
 
     @property
@@ -690,12 +701,14 @@ def artist(self) -> str:
 
     @property
     def album(self) -> str:
-        """The album that the song being played belongs to."""
+        """The album that the song being played belongs to.
+        """
         return self._assets.get("large_text", "")
 
     @property
     def album_cover_url(self) -> str:
-        """The album cover image URL from Spotify's CDN."""
+        """The album cover image URL from Spotify's CDN.
+        """
         large_image = self._assets.get("large_image", "")
         if large_image[:8] != "spotify:":
             return ""
@@ -704,7 +717,8 @@ def album_cover_url(self) -> str:
 
     @property
     def track_id(self) -> str:
-        """The track ID used by Spotify to identify this song."""
+        """The track ID used by Spotify to identify this song.
+        """
         return self._sync_id
 
     @property
@@ -717,26 +731,30 @@ def track_url(self) -> str:
 
     @property
     def start(self) -> datetime.datetime:
-        """When the user started playing this song in UTC."""
+        """When the user started playing this song in UTC.
+        """
         return datetime.datetime.fromtimestamp(
             self._timestamps["start"] / 1000, tz=datetime.timezone.utc
         )
 
     @property
     def end(self) -> datetime.datetime:
-        """When the user will stop playing this song in UTC."""
+        """When the user will stop playing this song in UTC.
+        """
         return datetime.datetime.fromtimestamp(
             self._timestamps["end"] / 1000, tz=datetime.timezone.utc
         )
 
     @property
     def duration(self) -> datetime.timedelta:
-        """The duration of the song being played."""
+        """The duration of the song being played.
+        """
         return self.end - self.start
 
     @property
     def party_id(self) -> str:
-        """The party ID of the listening party."""
+        """The party ID of the listening party.
+        """
         return self._party.get("id", "")
 
 

discord/appinfo.py

@@ -171,7 +171,8 @@ def __repr__(self) -> str:
 
     @property
     def icon(self) -> Asset | None:
-        """Retrieves the application's icon asset, if any."""
+        """Retrieves the application's icon asset, if any.
+        """
         if self._icon is None:
             return None
         return Asset._from_icon(self._state, self.id, self._icon, path="app")
@@ -253,7 +254,8 @@ def __repr__(self) -> str:
 
     @property
     def icon(self) -> Asset | None:
-        """Retrieves the application's icon asset, if any."""
+        """Retrieves the application's icon asset, if any.
+        """
         if self._icon is None:
             return None
         return Asset._from_icon(self._state, self.id, self._icon, path="app")

discord/asset.py

@@ -288,16 +288,19 @@ def __hash__(self):
 
     @property
     def url(self) -> str:
-        """Returns the underlying URL of the asset."""
+        """Returns the underlying URL of the asset.
+        """
         return self._url
 
     @property
     def key(self) -> str:
-        """Returns the identifying key of the asset."""
+        """Returns the identifying key of the asset.
+        """
         return self._key
 
     def is_animated(self) -> bool:
-        """Returns whether the asset is animated."""
+        """Returns whether the asset is animated.
+        """
         return self._animated
 
     def replace(

discord/audit_logs.py

@@ -528,7 +528,8 @@ def __repr__(self) -> str:
 
     @utils.cached_property
     def created_at(self) -> datetime.datetime:
-        """Returns the entry's creation time in UTC."""
+        """Returns the entry's creation time in UTC.
+        """
         return utils.snowflake_time(self.id)
 
     @utils.cached_property
@@ -557,24 +558,28 @@ def target(
 
     @utils.cached_property
     def category(self) -> enums.AuditLogActionCategory:
-        """The category of the action, if applicable."""
+        """The category of the action, if applicable.
+        """
         return self.action.category
 
     @utils.cached_property
     def changes(self) -> AuditLogChanges:
-        """The list of changes this entry has."""
+        """The list of changes this entry has.
+        """
         obj = AuditLogChanges(self, self._changes, state=self._state)
         del self._changes
         return obj
 
     @utils.cached_property
     def before(self) -> AuditLogDiff:
-        """The target's prior state."""
+        """The target's prior state.
+        """
         return self.changes.before
 
     @utils.cached_property
     def after(self) -> AuditLogDiff:
-        """The target's subsequent state."""
+        """The target's subsequent state.
+        """
         return self.changes.after
 
     def _convert_target_guild(self, target_id: int) -> Guild:

discord/automod.py

@@ -334,12 +334,14 @@ def __str__(self) -> str:
 
     @cached_property
     def guild(self) -> Guild | None:
-        """The guild this rule belongs to."""
+        """The guild this rule belongs to.
+        """
         return self._state._get_guild(self.guild_id)
 
     @cached_property
     def creator(self) -> Member | None:
-        """The member who created this rule."""
+        """The member who created this rule.
+        """
         if self.guild is None:
             return None
         return self.guild.get_member(self.creator_id)