anilibria-api-client 0.1.4__py3-none-any.whl

methods/anime.py

@@ -0,0 +1,670 @@
+from ._libria import BaseMethod
+from ._helper import validate_filters, create_filters_from_release
+from ..models import Release
+from typing import Optional, List
+
+
+class AnimeMethod(BaseMethod):
+    async def catalog_releases_get(
+            self,
+            params: Release
+    ):
+        """
+        Возвращает список релизов по заданными параметрам (GET запрос)
+
+        :param params: Тело Release
+        """
+        body = {
+            "page": params.page,
+            "limit":params.limit,
+            "include": params.include,
+            "exclude": params.exclude,
+        }
+        validated_f_args = await validate_filters(params=params)
+        final_body = {**body, **validated_f_args}
+
+        return await self._api.get("/anime/catalog/releases", params=final_body)
+    
+    async def catalog_releases_post(
+            self,
+            params: Release
+    ):
+        """
+        Возвращает список релизов по заданными параметрам (POST запрос)
+
+        :param params: Тело Release
+        """
+        body = {
+            "page": params.page,
+            "limit":params.limit,
+            "include": params.include,
+            "exclude": params.exclude,
+        }
+        filters = await create_filters_from_release(params)
+        final_body = {**body, **filters}
+
+        return await self._api.post("/anime/catalog/releases", json_data=final_body)
+    
+    async def catalog_references_age_ratings(
+            self
+    ):
+        """
+        Возвращает список возможных возрастных рейтингов в каталоге
+        """
+        return await self._api.get("/anime/catalog/references/age-ratings")
+    
+    async def catalog_references_genres(
+            self
+    ):
+        """
+        Возвращает список всех жанров в каталоге
+        """
+        return await self._api.get("/anime/catalog/references/genres")
+    
+    async def catalog_references_production_statuses(
+            self
+    ):
+        """
+        Возвращает список возможных статусов озвучки релиза в каталоге
+        """
+        return await self._api.get("/anime/catalog/references/production-statuses")
+    
+    async def catalog_references_publish_statuses(
+            self
+    ):
+        """
+        Возвращает список возможных статусов выхода релиза в каталоге
+        """
+        return await self._api.get("/anime/catalog/references/publish-statuses")
+    
+    async def catalog_references_seasons(
+            self
+    ):
+        """
+        Возвращает список возможных сезонов релизов в каталоге
+        """
+        return await self._api.get("/anime/catalog/references/seasons")
+    
+    async def catalog_references_sorting(
+            self
+    ):
+        """
+        Возвращает список возможных типов сортировок в каталоге
+        """
+        return await self._api.get("/anime/catalog/references/sorting")
+    
+    async def catalog_references_types(
+            self
+    ):
+        """
+        Возвращает список возможных типов релизов в каталоге
+        """
+        return await self._api.get("/anime/catalog/references/types")
+    
+    async def catalog_references_years(
+            self
+    ):
+        """
+        Возвращает список годов в каталоге
+        """
+        return await self._api.get("/anime/catalog/references/years")
+    
+    async def franchises(
+            self,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает список франшиз
+
+        Args:
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "include": include,
+            "exclude": exclude
+        }
+        return await self._api.get("/anime/franchises", params=params)
+    
+    async def franchises_franchiseId(
+            self,
+            franchiseId: str,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает данные франшизы по Id
+
+        Args:
+            franchiseId: Обязательно. Id франшизы
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "include": include,
+            "exclude": exclude
+        }
+
+        endpoint = self._api.build_endpoint_with_params("/anime/franchises/{franchiseId}", franchiseId=franchiseId)
+        return await self._api.get(endpoint=endpoint, params=params)
+    
+    async def franchises_random(
+            self,
+            limit: Optional[int] = None,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает список случайных франшиз.
+
+        Args:
+            limit: Лимит случайных франшиз
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "limit": limit,
+            "include": include,
+            "exclude": exclude
+        }
+        
+        return await self._api.get("/anime/franchises/random", params=params)
+    
+    async def franchises_release_releaseId(
+            self,
+            releaseId: str,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает список франшиз, в которых участвует релиз
+
+        Args:
+            releaseId: Обязательно. Id франшизы
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "include": include,
+            "exclude": exclude
+        }
+
+        endpoint = self._api.build_endpoint_with_params("/anime/franchises/release/{releaseId}", releaseId=releaseId)
+        return await self._api.get(endpoint=endpoint, params=params)
+    
+    async def genres(
+            self,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает список всех жанров
+
+        Args:
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "include": include,
+            "exclude": exclude
+        }
+        
+        return await self._api.get("/anime/genres", params=params)
+    
+    async def genres_genreId(
+            self,
+            genreId: int,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает список всех жанров
+
+        Args:
+            genreId: ID жанра, обязательно
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "include": include,
+            "exclude": exclude
+        }
+        
+        endpoint = self._api.build_endpoint_with_params("/anime/genres/{genreId}", genreId=genreId)
+        return await self._api.get(endpoint, params=params)
+    
+    async def genres_random(
+            self,
+            limit: Optional[int] = None,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает список случайных жанров
+
+        Args:
+            limit: Лимит случайных жанров
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "limit": limit,
+            "include": include,
+            "exclude": exclude
+        }
+
+        return await self._api.get("/anime/genres/random", params=params)
+    
+    async def genres_genreId_releases(
+            self,
+            genreId: int,
+            page: Optional[int] = None,
+            limit: Optional[int] = None,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает список всех релизов жанра
+
+        Args:
+            genreId: Обязательно. ID жанра
+            page: Номер страницы
+            limit: Лимит на страницу
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "page": page,
+            "limit": limit,
+            "include": include,
+            "exclude": exclude
+        }
+
+        endpoint = self._api.build_endpoint_with_params("/anime/genres/{genreId}/releases", genreId=genreId)
+        return await self._api.get(endpoint, params=params)
+    
+    async def releases_latest(
+            self,
+            limit: Optional[int] = None,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает данные по последним релизам
+
+        Args:
+            limit: Количество последних релизов в выдаче
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "limit": limit,
+            "include": include,
+            "exclude": exclude
+        }
+
+        return await self._api.get("/anime/releases/latest", params=params)
+    
+    async def releases_random(
+            self,
+            limit: Optional[int] = None,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает данные по случайным релизам
+
+        Args:
+            limit: Количество случайных релизов
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "limit": limit,
+            "include": include,
+            "exclude": exclude
+        }
+
+        return await self._api.get("/anime/releases/random", params=params)
+    
+    async def releases_recommended(
+            self,
+            limit: Optional[int] = None,
+            release_id: Optional[int] = None,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает данные по рекомендованным релизам
+
+        Args:
+            limit: Количество рекомендованных релизов
+            release_id: Идентификатор релиза, для которого рекомендуем
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "limit": limit,
+            "release_id": release_id,
+            "include": include,
+            "exclude": exclude
+        }
+
+        return await self._api.get("/anime/releases/recommended", params=params)
+    
+    async def releases_list(
+            self,
+            ids: List[int],
+            aliases: List[str],
+            page: Optional[int] = None,
+            limit: Optional[int] = None,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает данные по списку релизов
+
+        Args:
+            ids: Список ID релизов Обязательно
+            aliases: Список alias релизов Обязательно
+            page: Номер страницы
+            limit: Лимит на страницу
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "ids": ids,
+            "aliases": aliases,
+            "page": page,
+            "limit": limit,
+            "include": include,
+            "exclude": exclude
+        }
+
+        return await self._api.get("/anime/releases/list", params=params)
+    
+    async def releases_idOrAlias(
+            self,
+            idOrAlias: str,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает данные по релизу
+
+        Args:
+            idOrAlias: id или alias релиза Обязательно
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "include": include,
+            "exclude": exclude
+        }
+
+        endpoint = self._api.build_endpoint_with_params("/anime/releases/{idOrAlias}", idOrAlias=idOrAlias)
+        return await self._api.get(endpoint, params)
+    
+    async def releases_idOrAlias_members(
+            self,
+            idOrAlias: str,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает данные по участникам релиза
+
+        Args:
+            idOrAlias: id или alias релиза Обязательно
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "include": include,
+            "exclude": exclude
+        }
+
+        endpoint = self._api.build_endpoint_with_params("/anime/releases/{idOrAlias}/members", idOrAlias=idOrAlias)
+        return await self._api.get(endpoint, params)
+    
+    async def releases_idOrAlias_episodes_timecodes(
+            self,
+            idOrAlias: str,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает данные по всем существующим таймкодам просмотра эпизодов релиза. Имеет 1-2-x минутный кэш.
+
+        Args:
+            idOrAlias: id или alias релиза Обязательно
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "include": include,
+            "exclude": exclude
+        }
+
+        endpoint = self._api.build_endpoint_with_params("/anime/releases/{idOrAlias}/episodes/timecodes", idOrAlias=idOrAlias)
+        return await self._api.get(endpoint, params)
+
+    async def releases_episodes_releaseEpisodeId(
+            self,
+            releaseEpisodeId: str,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает данные по эпизоду
+
+        Args:
+            releaseEpisodeId: Идентификатор эпизода Обязательно
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "include": include,
+            "exclude": exclude
+        }
+
+        endpoint = self._api.build_endpoint_with_params("/anime/releases/episodes/{releaseEpisodeId}", releaseEpisodeId=releaseEpisodeId)
+        return await self._api.get(endpoint, params)
+    
+    async def releases_episodes_releaseEpisodeId_timecode(
+            self,
+            releaseEpisodeId: str,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает данные по просмотру указанного эпизода авторизованным пользователем. Имеет 1-2-x минутный кэш.
+
+        Args:
+            releaseEpisodeId: Идентификатор эпизода Обязательно
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "include": include,
+            "exclude": exclude
+        }
+
+        endpoint = self._api.build_endpoint_with_params("/anime/releases/episodes/{releaseEpisodeId}/timecode", releaseEpisodeId=releaseEpisodeId)
+        return await self._api.get(endpoint, params)
+    
+    async def schedule_now(
+            self,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает список релизов в расписании на текущую дату
+
+        Args:
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "include": include,
+            "exclude": exclude
+        }
+
+        return await self._api.get("/anime/schedule/now", params=params)
+    
+    async def schedule_week(
+            self,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает список релизов в расписании на текущую неделю
+
+        Args:
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "include": include,
+            "exclude": exclude
+        }
+
+        return await self._api.get("/anime/schedule/week", params=params)
+    
+    
+    async def torrents(
+            self,
+            page: Optional[int] = None,
+            limit: Optional[int] = None,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает данные по последним торрентам
+
+        Args:
+            page: Номер страницы
+            limit: Лимит на страницу
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "page": page,
+            "limit": limit,
+            "include": include,
+            "exclude": exclude
+        }
+
+        return await self._api.get("/anime/torrents", params=params)
+    
+    async def torrents_hashOrId(
+            self,
+            hashOrId: str,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает данные по последним торрентам
+
+        Args:
+            hashOrId: Обязательно Хэш или ID торрента
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "include": include,
+            "exclude": exclude
+        }
+
+        endpoint = self._api.build_endpoint_with_params("/anime/torrents/{hashOrId}", hashOrId=hashOrId)
+        return await self._api.get(endpoint, params)
+        
+    async def torrents_hashOrId_file(
+            self,
+            hashOrId: str,
+            pk: Optional[str] = None
+    ):
+        """
+        Возвращает данные по последним торрентам
+
+        Args:
+            hashOrId: Обязательно Хэш или ID торрента
+            pk: passkey пользователя. Оставьте пустым для собственного pk (если аутентифицирован)
+        """
+        params = {
+            "pk": pk
+        }
+        headers = {
+            "Content-Type": "application/x-bittorrent; utf-8",
+            "Accept": "application/x-bittorrent"
+        }
+
+        endpoint = self._api.build_endpoint_with_params("/anime/torrents/{hashOrId}/file", hashOrId=hashOrId)
+        return await self._api.get(endpoint, params, headers)
+    
+    async def torrents_release_releaseId(
+            self,
+            releaseId: int,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает данные по последним торрентам
+
+        Args:
+            releaseId: Обязательно ID релиза
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "include": include,
+            "exclude": exclude
+        }
+
+        endpoint = self._api.build_endpoint_with_params("/anime/torrents/release/{releaseId}", releaseId=releaseId)
+        return await self._api.get(endpoint, params)
+    
+    async def torrents_rss(
+            self,
+            limit: Optional[int] = None,
+            pk: Optional[str]  = None
+    ):
+        """
+        Возвращает данные по последним торрентам в виде XML документа
+
+        Args:
+            limit: Количество торрентов в выдаче. По умолчанию 10
+            pk: passkey пользователя. Оставьте пустым для собственного pk (если аутентифицирован)
+        """
+        params = {
+            "limit": limit,
+            "pk": pk
+        }
+        headers = {
+            "Content-Type": "application/xml",
+        }
+
+        return await self._api.get("/anime/torrents/rss", params=params, headers=headers)
+    
+    async def torrents_rss_release_releaseId(
+            self,
+            releaseId: int,
+            pk: Optional[str]  = None
+    ):
+        """
+        Возвращает данные по торрентам релиза в виде RSS ленты (xml)
+
+        Args:
+            releaseId: Обязательно ID релиза
+            pk: passkey пользователя. Оставьте пустым для собственного pk (если аутентифицирован)
+        """
+        params = {
+            "pk": pk
+        }
+        headers = {
+            "Content-Type": "application/xml",
+        }
+        
+        endpoint = self._api.build_endpoint_with_params("/anime/torrents/rss/release/{releaseId}", releaseId=releaseId)
+        return await self._api.get(endpoint=endpoint, params=params, headers=headers)

methods/app.py

@@ -0,0 +1,34 @@
+from ._libria import BaseMethod
+from typing import Optional
+
+
+class AppMethod(BaseMethod):
+    async def search_releases(
+            self,
+            query: str,
+            include: Optional[str] = None,
+            exclude: Optional[str]  = None
+    ):
+        """
+        Возвращает данные по релизам, которые удовлетворяют поисковому запросу
+
+        Args:
+            query: Обязательный параметр. Строка поиска
+            include: Поля для включения
+            exclude: Поля для исключения
+        """
+        params = {
+            "query": query,
+            "include": include,
+            "exclude": exclude
+        }
+
+        return await self._api.get("/app/search/releases", params=params)
+    
+    async def status(
+            self
+    ):
+        """
+        Возвращает информацию о статусе API
+        """
+        return await self._api.get("/app/status")