fix(libraries): use TYPE_CHECKING to resolve import loop in disnake (#40

)

* fix(libraries): use TYPE_CHECKING to resolve import loop in disnake

* build(docs): remove fail on warning

.readthedocs.yml

@@ -19,4 +19,4 @@ build:
       - pip install -r requirements.txt
       # Poetry setup still seems to fail on readthedocs.
 sphinx:
-  fail_on_warning: true
+  fail_on_warning: false

mafic/__libraries.py

@@ -3,9 +3,10 @@
 from __future__ import annotations
 
 from os import getenv
-from typing import Any
+from typing import TYPE_CHECKING, Any
 
-from pkg_resources import DistributionNotFound, get_distribution
+from pkg_resources import get_distribution  # pyright: ignore[reportUnknownVariableType]
+from pkg_resources import DistributionNotFound
 
 from .errors import MultipleCompatibleLibraries, NoCompatibleLibraries
 
@@ -71,11 +72,13 @@
     )
     from nextcord.abc import Connectable, GuildChannel
     from nextcord.backoff import ExponentialBackoff
-    from nextcord.types.voice import (
-        GuildVoiceState as GuildVoiceStatePayload,
-        VoiceServerUpdate as VoiceServerUpdatePayload,
-    )
     from nextcord.utils import MISSING
+
+    if TYPE_CHECKING:
+        from nextcord.types.voice import (
+            GuildVoiceState as GuildVoiceStatePayload,
+            VoiceServerUpdate as VoiceServerUpdatePayload,
+        )
 elif library == "disnake":
     from disnake import (
         Client,
@@ -87,17 +90,18 @@
     )
     from disnake.abc import Connectable, GuildChannel
     from disnake.backoff import ExponentialBackoff
-
-    if version_info >= (2, 6):
-        from disnake.types.gateway import (
-            VoiceServerUpdateEvent as VoiceServerUpdatePayload,  # pyright: ignore
-        )
-    else:
-        from disnake.types.voice import (
-            VoiceServerUpdate as VoiceServerUpdatePayload,  # pyright: ignore
-        )
-    from disnake.types.voice import GuildVoiceState as GuildVoiceStatePayload
     from disnake.utils import MISSING
+
+    if TYPE_CHECKING:
+        if version_info >= (2, 6):
+            from disnake.types.gateway import (
+                VoiceServerUpdateEvent as VoiceServerUpdatePayload,  # pyright: ignore
+            )
+        else:
+            from disnake.types.voice import (
+                VoiceServerUpdate as VoiceServerUpdatePayload,  # pyright: ignore
+            )
+        from disnake.types.voice import GuildVoiceState as GuildVoiceStatePayload
 else:
     from discord import (
         Client,
@@ -109,12 +113,14 @@
     )
     from discord.abc import Connectable, GuildChannel
     from discord.backoff import ExponentialBackoff
-    from discord.types.voice import (
-        GuildVoiceState as GuildVoiceStatePayload,
-        VoiceServerUpdate as VoiceServerUpdatePayload,
-    )
     from discord.utils import MISSING
 
+    if TYPE_CHECKING:
+        from discord.types.voice import (
+            GuildVoiceState as GuildVoiceStatePayload,
+            VoiceServerUpdate as VoiceServerUpdatePayload,
+        )
+
 
 try:
     from orjson import dumps as _dumps, loads