style: auto fixes from pre-commit hooks

Author: pre-commit-ci[bot]

docs/conf.py

@@ -22,7 +22,7 @@
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 sys.path.insert(0, os.path.abspath(".."))
 sys.path.append(os.path.abspath("extensions"))
-from mafic import __version__  # noqa: E402
+from mafic import __version__
 
 project = "Mafic"
 copyright = "2022-present, Oliver Wilkes"
@@ -91,7 +91,7 @@
 
 
 def typehints_formatter(annotation: Any, _: Config) -> str | None:  # noqa: ANN401
-    return aliases.get(annotation, None)
+    return aliases.get(annotation)
 
 
 intersphinx_mapping = {

mafic/__libraries.py

@@ -14,13 +14,13 @@
 from .errors import MultipleCompatibleLibraries, NoCompatibleLibraries
 
 __all__ = (
+    "MISSING",
     "Client",
     "Connectable",
     "ExponentialBackoff",
     "Guild",
     "GuildChannel",
     "GuildVoiceStatePayload",
-    "MISSING",
     "StageChannel",
     "VoiceChannel",
     "VoiceProtocol",
@@ -120,8 +120,8 @@
 
     if TYPE_CHECKING:
         from discord.types.voice import (
-            GuildVoiceState as GuildVoiceStatePayload,  # noqa: TCH004
-            VoiceServerUpdate as VoiceServerUpdatePayload,  # noqa: TCH004
+            GuildVoiceState as GuildVoiceStatePayload,  # noqa: TC004
+            VoiceServerUpdate as VoiceServerUpdatePayload,  # noqa: TC004
         )
 
 

mafic/__main__.py

@@ -1,4 +1,5 @@
 """Mafic CLI tools."""
+
 # SPDX-License-Identifier: MIT
 
 from __future__ import annotations

mafic/errors.py

@@ -1,4 +1,5 @@
 """Errors raised by Mafic."""
+
 # SPDX-License-Identifier: MIT
 
 from __future__ import annotations

mafic/events.py

@@ -1,4 +1,5 @@
 """Objects for dispatched events via the client."""
+
 # SPDX-License-Identifier: MIT
 # pyright: reportImportCycles=false
 # Player import.
@@ -71,7 +72,7 @@ class WebSocketClosedEvent(Generic[PlayerT]):
         The player that the event was dispatched from.
     """
 
-    __slots__ = ("code", "reason", "by_discord", "player")
+    __slots__ = ("by_discord", "code", "player", "reason")
 
     def __init__(
         self, *, payload: WebSocketClosedEventPayload, player: PlayerT
@@ -100,7 +101,7 @@ class TrackStartEvent(Generic[PlayerT]):
         The player that the event was dispatched from.
     """
 
-    __slots__ = ("track", "player")
+    __slots__ = ("player", "track")
 
     def __init__(self, *, track: Track, player: PlayerT) -> None:
         self.track: Track = track
@@ -124,7 +125,7 @@ class TrackEndEvent(Generic[PlayerT]):
         The player that the event was dispatched from.
     """
 
-    __slots__ = ("track", "reason", "player")
+    __slots__ = ("player", "reason", "track")
 
     def __init__(
         self, *, track: Track, payload: TrackEndEventPayload, player: PlayerT
@@ -157,7 +158,7 @@ class TrackExceptionEvent(Generic[PlayerT]):
         The player that the event was dispatched from.
     """
 
-    __slots__ = ("track", "exception", "player")
+    __slots__ = ("exception", "player", "track")
 
     def __init__(
         self,
@@ -190,7 +191,7 @@ class TrackStuckEvent(Generic[PlayerT]):
         The player that the event was dispatched from.
     """
 
-    __slots__ = ("track", "threshold_ms", "player")
+    __slots__ = ("player", "threshold_ms", "track")
 
     def __init__(
         self, *, track: Track, payload: TrackStuckEventPayload, player: PlayerT

mafic/filter.py

@@ -1,4 +1,5 @@
 """Filters that can be applied to a Player."""
+
 # SPDX-License-Identifier: MIT
 # Reference to filter meanings can be found in:
 # https://github.com/natanbc/lavadsp
@@ -601,26 +602,24 @@ class Filter:
     """
 
     __slots__ = (
+        "channel_mix",
+        "distortion",
         "equalizer",
         "karaoke",
+        "low_pass",
+        "rotation",
         "timescale",
         "tremolo",
         "vibrato",
-        "rotation",
-        "distortion",
-        "channel_mix",
-        "low_pass",
         "volume",
     )
 
     def __init__(
         self,
         *,
-        equalizer: Equalizer
-        | list[tuple[int, float]]
-        | list[float]
-        | list[EQBand]
-        | None = None,
+        equalizer: (
+            Equalizer | list[tuple[int, float]] | list[float] | list[EQBand] | None
+        ) = None,
         karaoke: Karaoke | None = None,
         timescale: Timescale | None = None,
         tremolo: Tremolo | None = None,
@@ -644,11 +643,9 @@ def __init__(
 
     def _convert_equalizer(
         self,
-        equalizer: Equalizer
-        | list[tuple[int, float]]
-        | list[float]
-        | list[EQBand]
-        | None,
+        equalizer: (
+            Equalizer | list[tuple[int, float]] | list[float] | list[EQBand] | None
+        ),
     ) -> Equalizer | None:
         if equalizer is None:
             return None

mafic/ip.py

@@ -1,4 +1,5 @@
 """The Lavalink route planner API."""
+
 # SPDX-License-Identifier: MIT
 
 from __future__ import annotations
@@ -20,12 +21,12 @@
     )
 
 __all__ = (
-    "IPRoutePlannerType",
-    "IPBlockType",
-    "IPBlock",
-    "FailingAddress",
-    "BaseIPRoutePlannerStatus",
     "BalancingIPRoutePlannerStatus",
+    "BaseIPRoutePlannerStatus",
+    "FailingAddress",
+    "IPBlock",
+    "IPBlockType",
+    "IPRoutePlannerType",
     "NanoIPRoutePlannerStatus",
     "RotatingIPRoutePlannerStatus",
     "RotatingNanoIPRoutePlannerStatus",

mafic/node.py

@@ -1,4 +1,5 @@
 """Node class to represent one Lavalink instance."""
+
 # SPDX-License-Identifier: MIT
 # pyright: reportImportCycles=false
 # Player import.
@@ -178,25 +179,25 @@ class Node(Generic[ClientT]):
         "_checked_version",
         "_client",
         "_connect_task",
+        "_event_queue",
         "_heartbeat",
         "_host",
         "_label",
         "_msg_tasks",
         "_players",
         "_port",
-        "_resume_key",
-        "_secure",
-        "_timeout",
         "_ready",
         "_rest_uri",
+        "_resume_key",
         "_resuming_session_id",
+        "_secure",
         "_session_id",
         "_stats",
+        "_timeout",
         "_version",
         "_ws",
-        "_ws_uri",
         "_ws_task",
-        "_event_queue",
+        "_ws_uri",
         "regions",
         "shard_ids",
     )
@@ -858,7 +859,7 @@ async def _handle_msg(self, data: IncomingMessage) -> None:
             self._ready.set()
         else:
             # Of course pyright considers this to be `Never`, so this is to keep types.
-            op = cast(str, data["op"])
+            op = cast("str", data["op"])
             _log.warn("Unknown incoming message op code %s", op)
 
     async def _handle_event(self, data: EventPayload) -> None:
@@ -1268,17 +1269,17 @@ async def fetch_route_planner_status(self) -> RoutePlannerStatus | None:
 
         if data["class"] == "RotatingIpRoutePlanner":
             return RotatingIPRoutePlannerStatus(
-                cast(RotatingIPRouteDetails, data["details"])
+                cast("RotatingIPRouteDetails", data["details"])
             )
         elif data["class"] == "NanoIpRoutePlanner":
-            return NanoIPRoutePlannerStatus(cast(NanoIPRouteDetails, data["details"]))
+            return NanoIPRoutePlannerStatus(cast("NanoIPRouteDetails", data["details"]))
         elif data["class"] == "RotatingNanoIpRoutePlanner":
             return RotatingNanoIPRoutePlannerStatus(
-                cast(RotatingNanoIPRouteDetails, data["details"])
+                cast("RotatingNanoIPRouteDetails", data["details"])
             )
         elif data["class"] == "BalancingIpRoutePlanner":
             return BalancingIPRoutePlannerStatus(
-                cast(BalancingIPRouteDetails, data["details"])
+                cast("BalancingIPRouteDetails", data["details"])
             )
         elif data["class"] is None:
             return None

mafic/player.py

@@ -1,4 +1,5 @@
 """A Player is used to connect to a channel."""
+
 # SPDX-License-Identifier: MIT
 
 from __future__ import annotations
@@ -255,7 +256,7 @@ def dispatch_event(self, data: EventPayload) -> None:
             track = (
                 self._current
                 if self.node.version == 3
-                else Track.from_data_with_info(cast(TrackWithInfo, data.get("track")))
+                else Track.from_data_with_info(cast("TrackWithInfo", data.get("track")))
             )
 
             if track is None:
@@ -272,7 +273,7 @@ def dispatch_event(self, data: EventPayload) -> None:
             track = (
                 self._last_track
                 if self.node.version == 3
-                else Track.from_data_with_info(cast(TrackWithInfo, data.get("track")))
+                else Track.from_data_with_info(cast("TrackWithInfo", data.get("track")))
             )
 
             if track is None:
@@ -291,7 +292,7 @@ def dispatch_event(self, data: EventPayload) -> None:
             track = (
                 self._current
                 if self.node.version == 3
-                else Track.from_data_with_info(cast(TrackWithInfo, data.get("track")))
+                else Track.from_data_with_info(cast("TrackWithInfo", data.get("track")))
             )
 
             if track is None:
@@ -308,7 +309,7 @@ def dispatch_event(self, data: EventPayload) -> None:
             track = (
                 self._current
                 if self.node.version == 3
-                else Track.from_data_with_info(cast(TrackWithInfo, data.get("track")))
+                else Track.from_data_with_info(cast("TrackWithInfo", data.get("track")))
             )
 
             if track is None:
@@ -324,7 +325,7 @@ def dispatch_event(self, data: EventPayload) -> None:
             # Pyright expects this to never happen, so do I, I really hope.
             # Nobody expects the Spanish Inquisition, neither does pyright.
 
-            event_type = cast(str, data["type"])
+            event_type = cast("str", data["type"])
             _log.warning("Unknown incoming event type %s", event_type)
 
     async def on_voice_state_update(  # pyright: ignore[reportIncompatibleMethodOverride]

mafic/playlist.py

@@ -1,4 +1,5 @@
 """The module containing :class:`Playlist`."""
+
 # SPDX-License-Identifier: MIT
 
 from __future__ import annotations

mafic/plugin.py

@@ -1,4 +1,5 @@
 """The Lavalink plugin system."""
+
 # SPDX-License-Identifier: MIT
 
 from __future__ import annotations

mafic/pool.py

@@ -1,4 +1,5 @@
 r"""A module containing a :class:`NodePool`, used to manage :class:`Node`\s."""
+
 # SPDX-License-Identifier: MIT
 
 from __future__ import annotations

mafic/region.py

@@ -1,4 +1,5 @@
 """A module contains region enums for voice regions and groups."""
+
 # SPDX-License-Identifier: MIT
 
 from __future__ import annotations

mafic/search_type.py

@@ -1,4 +1,5 @@
 """Represents a search type for Lavalink."""
+
 # SPDX-License-Identifier: MIT
 
 from __future__ import annotations

mafic/stats.py

@@ -1,4 +1,5 @@
 """A module containing classes to represent node statistics."""
+
 # SPDX-License-Identifier: MIT
 
 from __future__ import annotations
@@ -31,7 +32,7 @@ class CPUStats:
         The load Lavalink is using.
     """
 
-    __slots__ = ("cores", "system_load", "lavalink_load")
+    __slots__ = ("cores", "lavalink_load", "system_load")
 
     def __init__(self, payload: CPU) -> None:
         self.cores: int = payload["cores"]
@@ -54,7 +55,7 @@ class MemoryStats:
         The amount of reservable memory for the node. Set by ``-Xmx`` for Java.
     """
 
-    __slots__ = ("free", "used", "allocated", "reservable")
+    __slots__ = ("allocated", "free", "reservable", "used")
 
     def __init__(self, payload: Memory) -> None:
         self.free: int = payload["free"]
@@ -76,7 +77,7 @@ class FrameStats:
         The amount of frames deficit.
     """
 
-    __slots__ = ("sent", "nulled", "deficit")
+    __slots__ = ("deficit", "nulled", "sent")
 
     def __init__(self, payload: FrameStatsPayload) -> None:
         self.sent: int = payload["sent"]

mafic/strategy.py

@@ -1,4 +1,5 @@
 """The strategy system for selecting a :class:`Node` from a :class:`NodePool`."""
+
 # SPDX-License-Identifier: MIT
 
 from __future__ import annotations

mafic/track.py

@@ -1,4 +1,5 @@
 """The module containing :class:`Track`."""
+
 # SPDX-License-Identifier: MIT
 
 from __future__ import annotations
@@ -72,8 +73,8 @@ class Track:
     """
 
     __slots__ = (
-        "author",
         "artwork_url",
+        "author",
         "id",
         "identifier",
         "isrc",

mafic/type_variables.py

@@ -1,4 +1,5 @@
 """Type variables used in mafic."""
+
 # SPDX-License-Identifier: MIT
 # This was originally made to avoid the import cycle of
 # mafic.pool -> mafic.node -> mafic.pool