feat: genres

anmoku/clients/async_.py

@@ -7,7 +7,12 @@
     from ..typing.anmoku import SnowflakeT
     from ..typing.jikan import SearchResultData
 
-    from .base import ResourceGenericT, SearchResourceGenericT, RandomResourceGenericT
+    from .base import (
+        ResourceGenericT, 
+        SearchResourceGenericT, 
+        RandomResourceGenericT, 
+        GenresResourceGenericT
+    )
 
 from aiohttp import ClientSession
 from devgoldyutils import Colours
@@ -88,6 +93,17 @@ async def random(self, resource: Type[RandomResourceGenericT]) -> RandomResource
 
         return resource(json_data)
 
+    async def genres(self, resource: Type[GenresResourceGenericT]) -> GenresResourceGenericT:
+        """Fetches a random object of the specified resource."""
+        url = resource._random_endpoint
+
+        if url is None:
+            raise ResourceNotSupportedError(resource, "random")
+
+        json_data = await self._request(url)
+
+        return resource(json_data)
+
     async def _request(
         self, 
         route: str, 

anmoku/clients/base.py

@@ -27,6 +27,12 @@
         resources.Manga
     )
 
+    GenresResourceGenericT = TypeVar(
+        "GenresResourceGenericT", 
+        resources.AnimeGenres,
+        resources.MangaGenres
+    )
+
 import logging
 from urllib.parse import quote
 from abc import ABC, abstractmethod
@@ -77,6 +83,11 @@ def search(self, resource: Type[SearchResourceGenericT], query: str) -> SearchRe
     def random(self, resource: Type[RandomResourceGenericT]) -> RandomResourceGenericT:
         """Fetches a random object of the specified resource."""
         ...
+
+    @abstractmethod
+    def genres(self, resource: Type[GenresResourceGenericT]) -> GenresResourceGenericT:
+        """Fetches a genres of the specified resource."""
+        ...
 
     def _format_url(self, unformatted_url: str, resource: Type[ResourceGenericT], *args: str, **kwargs: str) -> str:
         """Formats the URL while also taking URL encoding into account."""

anmoku/clients/sync.py

@@ -7,7 +7,12 @@
     from ..typing.anmoku import SnowflakeT
     from ..typing.jikan import SearchResultData
 
-    from .base import ResourceGenericT, SearchResourceGenericT, RandomResourceGenericT
+    from .base import (
+        ResourceGenericT, 
+        SearchResourceGenericT, 
+        RandomResourceGenericT, 
+        GenresResourceGenericT
+    )
 
 from requests import Session
 from devgoldyutils import Colours
@@ -86,6 +91,17 @@ def random(self, resource: Type[RandomResourceGenericT]) -> RandomResourceGeneri
 
         return resource(json_data)
 
+    def genres(self, resource: Type[GenresResourceGenericT]) -> GenresResourceGenericT:
+        """Fetches a random object of the specified resource."""
+        url = resource._genres_endpoint
+
+        if url is None:
+            raise ResourceNotSupportedError(resource, "random")
+
+        json_data = self._request(url)
+
+        return resource(json_data)
+
     def _request(
         self, 
         route: str, 

anmoku/resources/anime/__init__.py

@@ -8,4 +8,5 @@
 from .recommendations import *
 from .reviews import *
 from .relations import *
-from .external import *
+from .external import *
+from .genre import *

anmoku/resources/anime/anime.py

@@ -72,7 +72,7 @@ class Anime(JikanResource):
     _get_endpoint = "/anime/{id}"
     _search_endpoint = "/anime"
     _random_endpoint = "/random/anime"
-
+    _genres_endpoint = "/genres/anime"
 
     data: JikanResponseData[AnimeData] = field(repr = False)
 

anmoku/resources/anime/genre.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from typing import List
+
+    from ...typing.jikan import (
+        GenreData,
+        JikanResponseData,
+    )
+
+from dataclasses import dataclass, field
+
+from ..base import JikanResource
+from ..helpers import Genre
+
+__all__ = (
+    "AnimeGenres",
+)
+
+@dataclass
+class AnimeGenres(JikanResource):
+    _genres_endpoint = "/genres/anime"
+
+    data: JikanResponseData[List[GenreData]] = field(repr = False)
+
+    def __iter__(self):
+        for genre in self.data["data"]:
+            yield Genre(genre)

anmoku/resources/base.py

@@ -16,5 +16,7 @@ class JikanResource():
     """The jikan api endpoint to search with this resource."""
     _random_endpoint: Optional[str] = field(init = False, default = None)
     """The jikan api endpoint to get a random object with this resource."""
+    _genres_endpoint: Optional[str] = field(init = False, default = None)
+    """The jikan api endpoint where you can get the genres of this resource."""
 
     data: JikanResponseData[Any]

anmoku/resources/helpers/__init__.py

@@ -9,4 +9,5 @@
 from .review import *
 from .user import *
 from .relations import *
-from .external import *
+from .external import *
+from .genre import *

anmoku/resources/helpers/genre.py

@@ -0,0 +1,30 @@
+from __future__ import annotations
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ...typing.jikan import (
+        GenreData,
+    )
+
+from dataclasses import dataclass, field
+
+__all__ = (
+    "Genre",
+)
+
+@dataclass
+class Genre():
+    data: GenreData = field(repr = False)
+
+    id: int = field(init = False)
+    name: str = field(init = False)
+    url: str = field(init = False)
+    count: int = field(init = False)
+
+    def __post_init__(self):
+        genre = self.data
+
+        self.id = genre["mal_id"]
+        self.name = genre["name"]
+        self.url = genre["url"]
+        self.count = genre["count"]

anmoku/resources/manga/__init__.py

@@ -8,4 +8,5 @@
 from .reviews import *
 from .user_updates import *
 from .relations import *
-from .external import *
+from .external import *
+from .genre import *

anmoku/resources/manga/genre.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from typing import List
+
+    from ...typing.jikan import (
+        GenreData,
+        JikanResponseData,
+    )
+
+from dataclasses import dataclass, field
+
+from ..base import JikanResource
+from ..helpers import Genre
+
+__all__ = (
+    "MangaGenres",
+)
+
+@dataclass
+class MangaGenres(JikanResource):
+    _genres_endpoint = "/genres/manga"
+
+    data: JikanResponseData[List[GenreData]] = field(repr = False)
+
+    def __iter__(self):
+        for genre in self.data["data"]:
+            yield Genre(genre)

anmoku/typing/jikan/__init__.py

@@ -16,4 +16,5 @@
 from .review import *
 from .user import *
 from .entry import *
-from .external import *
+from .external import *
+from .genre import *

anmoku/typing/jikan/genre.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+from typing import TypedDict
+
+__all__ = (
+    "GenreData",
+)
+
+class GenreData(TypedDict):
+    mal_id: int
+    name: str
+    url: str
+    count: int