refactor: rename SnowflakeT

anmoku/clients/async_.py

@@ -4,7 +4,7 @@
 if TYPE_CHECKING:
     from typing import Any, Optional, Type, Dict, Tuple
 
-    from ..typing.anmoku import SnowflakeT
+    from ..typing.anmoku import StrOrIntT
     from ..typing.jikan import SearchResultData
 
     from .base import (
@@ -66,10 +66,10 @@ async def get(self, resource: Type[NoArgsResourceGenericT]) -> NoArgsResourceGen
         ...
 
     @overload
-    async def get(self, resource: Type[ResourceGenericT], id: SnowflakeT, **kwargs) -> ResourceGenericT:
+    async def get(self, resource: Type[ResourceGenericT], id: StrOrIntT, **kwargs) -> ResourceGenericT:
         ...
 
-    async def get(self, resource: Type[ResourceGenericT], id: Optional[SnowflakeT] = None, **kwargs) -> ResourceGenericT:
+    async def get(self, resource: Type[ResourceGenericT], id: Optional[StrOrIntT] = None, **kwargs) -> ResourceGenericT:
         """Get's the exact resource typically by id."""
         if id is not None:
             kwargs["id"] = id

anmoku/clients/base.py

@@ -5,7 +5,7 @@
     from typing import Any, Mapping, TypeVar, Type, Optional
 
     from .. import resources
-    from ..typing.anmoku import SnowflakeT
+    from ..typing.anmoku import StrOrIntT
     from ..resources.helpers import SearchResult
 
     ResourceGenericT = TypeVar(
@@ -70,7 +70,7 @@ def __init__(self, debug: bool = False) -> None:
         super().__init__()
 
     @abstractmethod
-    def get(self, resource: Type[ResourceGenericT], id: Optional[SnowflakeT] = None, **kwargs) -> ResourceGenericT:
+    def get(self, resource: Type[ResourceGenericT], id: Optional[StrOrIntT] = None, **kwargs) -> ResourceGenericT:
         """Get's the exact resource by id."""
         ...
 

anmoku/clients/sync.py

@@ -4,7 +4,7 @@
 if TYPE_CHECKING:
     from typing import Any, Optional, Type, Tuple
 
-    from ..typing.anmoku import SnowflakeT
+    from ..typing.anmoku import StrOrIntT
     from ..typing.jikan import SearchResultData
 
     from .base import (
@@ -64,10 +64,10 @@ def get(self, resource: Type[NoArgsResourceGenericT]) -> NoArgsResourceGenericT:
         ...
 
     @overload
-    def get(self, resource: Type[ResourceGenericT], id: SnowflakeT, **kwargs) -> ResourceGenericT:
+    def get(self, resource: Type[ResourceGenericT], id: StrOrIntT, **kwargs) -> ResourceGenericT:
         ...
 
-    def get(self, resource: Type[ResourceGenericT], id: Optional[SnowflakeT] = None, **kwargs) -> ResourceGenericT:
+    def get(self, resource: Type[ResourceGenericT], id: Optional[StrOrIntT] = None, **kwargs) -> ResourceGenericT:
         """Get's the exact resource typically by id."""
         if id is not None:
             kwargs["id"] = id

anmoku/typing/anmoku.py

@@ -1,5 +1,7 @@
 from __future__ import annotations
 from typing import Union
 
-# TODO: tf, that's not what a snowflake is, what was I on. Rename this.
-SnowflakeT = Union[str, int]
+StrOrIntT = Union[str, int]
+"""
+StrOrIntT can be either a number (int) or string. Commonly used in methods that accept ID.
+"""