style: auto fixes from pre-commit hooks

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",
     )

mafic/player.py

@@ -1,4 +1,5 @@
 """A Player is used to connect to a channel."""
+
 # SPDX-License-Identifier: MIT
 
 from __future__ import annotations

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

mafic/typings/common.py

@@ -10,27 +10,27 @@
     from typing_extensions import NotRequired
 
 __all__ = (
-    "Filters",
+    "CPU",
     "ChannelMix",
-    "EQBand",
     "Distortion",
+    "EQBand",
+    "Filters",
     "Filters",
+    "FrameStats",
     "Karaoke",
     "LowPass",
+    "Memory",
     "Player",
     "PlaylistInfo",
     "Rotation",
+    "Stats",
     "Timescale",
     "TrackInfo",
     "TrackWithInfo",
     "Tremolo",
     "Vibrato",
     "VoiceState",
     "VoiceStateRequest",
-    "Memory",
-    "CPU",
-    "FrameStats",
-    "Stats",
 )