anilibria-api-types 1.0.0rc1__tar.gz

anilibria_api_types-1.0.0rc1/LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <https://unlicense.org>

anilibria_api_types-1.0.0rc1/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: anilibria-api-types
+Version: 1.0.0rc1
+Author-email: whynotix <semenbolotov414@gmail.com>
+License: The Unlicense
+Project-URL: Homepage, https://github.com/whynotix/anilibria-api-types
+Project-URL: Issues, https://github.com/whynotix/anilibria-api-types/issues
+Requires-Python: <4.0.0,>=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp<4.0.0,>=3.14.3
+Requires-Dist: aiofiles<26.0.0,>=24.1.0
+Requires-Dist: jsonref<2.0.0,>=1.1.0
+Requires-Dist: pydantic<3.0.0,>=2.13.3
+Requires-Dist: python-dotenv<2.0.0,>=1.2.3
+Requires-Dist: pydantic-settings<3.0.0,>=2.15.0
+Requires-Dist: anilibria-api-client>=1.0.0rc1
+Dynamic: license-file
+
+# anilibria-api-types
+
+[RU](https://github.com/whynotix/anilibria-api-types/tree/main/.github/README.ru_RU.md) | EN
+
+[![pypi](https://img.shields.io/pypi/v/anilibria-api-types.svg)](https://pypi.org/project/anilibria-api-types/) [![license](https://img.shields.io/github/license/whynotix/anilibria-api-types
+)](https://github.com/whynotix/anilibria-api-types/blob/main/LICENSE) [![Python](https://img.shields.io/pypi/pyversions/anilibria-api-types.svg)](https://pypi.org/project/anilibria-api-types/)
+
+Typed Pydantic-style stubs for the **AniLibria API** — method, enum, response, and error classes generated from the [OpenAPI schema](https://aniliberty.top/storage/api/docs/v1?aniliberty-api-v1-docs.json). The committed files under `anilibria_api_types/codegen/` are the deliverable, so running codegen and committing the diff is the work.
+
+## Setup
+
+- Python `>=3.13` (via [Poetry](https://python-poetry.org/)).
+- `.env` with `MAIN_FOLDER_NAME` (see `.env.example`); `anilibria_api_types/config.py` reads it and fails without it.
+
+## Run codegen
+
+```bash
+python -m anilibria_api_types.scripts.generate_methods
+python -m anilibria_api_types.scripts.generate_enums
+python -m anilibria_api_types.scripts.generate_errors
+python -m anilibria_api_types.scripts.generate_responses
+```
+
+On Windows with the Poetry venv, prefix with `.venv\Scripts\python.exe`. The package is a PEP 420 namespace package, so run with `-m` from the repo root.
+
+Run the whole pipeline (downloads the schema, then all four generators — requires network):
+
+```bash
+python -m anilibria_api_types.main
+```
+
+Each generator writes to `anilibria_api_types/codegen/{methods,enums,errors,responses}/`. The schema is cached at `anilibria_api_types/temp/schema.json` (gitignored); re-download it via `validate_schema/download_schema.py`.
+
+## How it works
+
+- Each generator is an independent entrypoint in `anilibria_api_types/scripts/`.
+- Type mapping is centralized in `anilibria_api_types/utils/type_map.py:get_type_map`.
+- Enum classes are named from the dotted schema path (e.g. `enums.anime.releases.release.ageRating` → `AnimeReleasesReleaseAgeRating`), grouped per category.
+- Response models share a single file, `anilibria_api_types/codegen/responses/models.py`, because the schema's data graph has cycles.
+- Generated method classes import a handwritten `BaseMethod` from `anilibria_api_types.methods.base_method`.
+
+## CI
+
+- `.github/workflows/codegen-refresh.yml` (weekly): regenerates codegen and opens a PR if the committed files change.
+- `.github/workflows/python-publish.yml` (release): builds and publishes to PyPI.
+
+## License
+
+Licensed under [The Unlicense](https://unlicense.org/).

anilibria_api_types-1.0.0rc1/README.md

@@ -0,0 +1,49 @@
+# anilibria-api-types
+
+[RU](https://github.com/whynotix/anilibria-api-types/tree/main/.github/README.ru_RU.md) | EN
+
+[![pypi](https://img.shields.io/pypi/v/anilibria-api-types.svg)](https://pypi.org/project/anilibria-api-types/) [![license](https://img.shields.io/github/license/whynotix/anilibria-api-types
+)](https://github.com/whynotix/anilibria-api-types/blob/main/LICENSE) [![Python](https://img.shields.io/pypi/pyversions/anilibria-api-types.svg)](https://pypi.org/project/anilibria-api-types/)
+
+Typed Pydantic-style stubs for the **AniLibria API** — method, enum, response, and error classes generated from the [OpenAPI schema](https://aniliberty.top/storage/api/docs/v1?aniliberty-api-v1-docs.json). The committed files under `anilibria_api_types/codegen/` are the deliverable, so running codegen and committing the diff is the work.
+
+## Setup
+
+- Python `>=3.13` (via [Poetry](https://python-poetry.org/)).
+- `.env` with `MAIN_FOLDER_NAME` (see `.env.example`); `anilibria_api_types/config.py` reads it and fails without it.
+
+## Run codegen
+
+```bash
+python -m anilibria_api_types.scripts.generate_methods
+python -m anilibria_api_types.scripts.generate_enums
+python -m anilibria_api_types.scripts.generate_errors
+python -m anilibria_api_types.scripts.generate_responses
+```
+
+On Windows with the Poetry venv, prefix with `.venv\Scripts\python.exe`. The package is a PEP 420 namespace package, so run with `-m` from the repo root.
+
+Run the whole pipeline (downloads the schema, then all four generators — requires network):
+
+```bash
+python -m anilibria_api_types.main
+```
+
+Each generator writes to `anilibria_api_types/codegen/{methods,enums,errors,responses}/`. The schema is cached at `anilibria_api_types/temp/schema.json` (gitignored); re-download it via `validate_schema/download_schema.py`.
+
+## How it works
+
+- Each generator is an independent entrypoint in `anilibria_api_types/scripts/`.
+- Type mapping is centralized in `anilibria_api_types/utils/type_map.py:get_type_map`.
+- Enum classes are named from the dotted schema path (e.g. `enums.anime.releases.release.ageRating` → `AnimeReleasesReleaseAgeRating`), grouped per category.
+- Response models share a single file, `anilibria_api_types/codegen/responses/models.py`, because the schema's data graph has cycles.
+- Generated method classes import a handwritten `BaseMethod` from `anilibria_api_types.methods.base_method`.
+
+## CI
+
+- `.github/workflows/codegen-refresh.yml` (weekly): regenerates codegen and opens a PR if the committed files change.
+- `.github/workflows/python-publish.yml` (release): builds and publishes to PyPI.
+
+## License
+
+Licensed under [The Unlicense](https://unlicense.org/).

anilibria_api_types-1.0.0rc1/anilibria_api_types/codegen/enums/accounts.py

@@ -0,0 +1,28 @@
+# Auto-generated for enums in accounts category
+from enum import Enum
+
+
+class AccountsUsersUserSocialType(str, Enum):
+	VK = 'vk'
+	GOOGLE = 'google'
+	PATREON = 'patreon'
+	DISCORD = 'discord'
+
+
+class AccountsUsersUserCollectionType(str, Enum):
+	PLANNED = 'PLANNED'
+	WATCHED = 'WATCHED'
+	WATCHING = 'WATCHING'
+	POSTPONED = 'POSTPONED'
+	ABANDONED = 'ABANDONED'
+
+
+class AccountsUsersUserFavoriteFilterSorting(str, Enum):
+	CREATED_AT_DESC = 'CREATED_AT_DESC'
+	CREATED_AT_ASC = 'CREATED_AT_ASC'
+	FRESH_AT_DESC = 'FRESH_AT_DESC'
+	FRESH_AT_ASC = 'FRESH_AT_ASC'
+	RATING_DESC = 'RATING_DESC'
+	RATING_ASC = 'RATING_ASC'
+	YEAR_DESC = 'YEAR_DESC'
+	YEAR_ASC = 'YEAR_ASC'

anilibria_api_types-1.0.0rc1/anilibria_api_types/codegen/enums/ads.py

@@ -0,0 +1,16 @@
+# Auto-generated for enums in ads category
+from enum import Enum
+
+
+class AdsBannerPlacement(str, Enum):
+	HOME_SUPPORT = 'HOME_SUPPORT'
+	RELEASE_SIDEBAR = 'RELEASE_SIDEBAR'
+
+
+class AdsStatisticsEventType(str, Enum):
+	AD_VAST_SHOW = 'AD_VAST_SHOW'
+	AD_VAST_REQUEST = 'AD_VAST_REQUEST'
+	AD_BANNER_VIEW = 'AD_BANNER_VIEW'
+	AD_BANNER_CLICK = 'AD_BANNER_CLICK'
+	MEDIA_PROMOTION_VIEW = 'MEDIA_PROMOTION_VIEW'
+	MEDIA_PROMOTION_CLICK = 'MEDIA_PROMOTION_CLICK'

anilibria_api_types-1.0.0rc1/anilibria_api_types/codegen/enums/anime.py

@@ -0,0 +1,106 @@
+# Auto-generated for enums in anime category
+from enum import Enum
+
+
+class AnimeCatalogFilterProductionStatus(str, Enum):
+	IS_IN_PRODUCTION = 'IS_IN_PRODUCTION'
+	IS_NOT_IN_PRODUCTION = 'IS_NOT_IN_PRODUCTION'
+
+
+class AnimeCatalogFilterPublishStatus(str, Enum):
+	IS_ONGOING = 'IS_ONGOING'
+	IS_NOT_ONGOING = 'IS_NOT_ONGOING'
+
+
+class AnimeCatalogFilterSorting(str, Enum):
+	FRESH_AT_DESC = 'FRESH_AT_DESC'
+	FRESH_AT_ASC = 'FRESH_AT_ASC'
+	RATING_DESC = 'RATING_DESC'
+	RATING_ASC = 'RATING_ASC'
+	YEAR_DESC = 'YEAR_DESC'
+	YEAR_ASC = 'YEAR_ASC'
+
+
+class AnimeReleasesReleaseAgeRating(str, Enum):
+	R0_PLUS = 'R0_PLUS'
+	R6_PLUS = 'R6_PLUS'
+	R12_PLUS = 'R12_PLUS'
+	R16_PLUS = 'R16_PLUS'
+	R18_PLUS = 'R18_PLUS'
+
+
+class AnimeReleasesReleasePublishDay(int, Enum):
+	VALUE_1 = 1
+	VALUE_2 = 2
+	VALUE_3 = 3
+	VALUE_4 = 4
+	VALUE_5 = 5
+	VALUE_6 = 6
+	VALUE_7 = 7
+
+
+class AnimeReleasesReleaseSeason(str, Enum):
+	WINTER = 'winter'
+	SPRING = 'spring'
+	SUMMER = 'summer'
+	AUTUMN = 'autumn'
+
+
+class AnimeReleasesReleaseType(str, Enum):
+	TV = 'TV'
+	ONA = 'ONA'
+	WEB = 'WEB'
+	OVA = 'OVA'
+	OAD = 'OAD'
+	MOVIE = 'MOVIE'
+	DORAMA = 'DORAMA'
+	SPECIAL = 'SPECIAL'
+
+
+class AnimeReleasesReleaseMemberRole(str, Enum):
+	POSTER = 'poster'
+	TIMING = 'timing'
+	VOICING = 'voicing'
+	EDITING = 'editing'
+	DECORATING = 'decorating'
+	TRANSLATING = 'translating'
+	HEVC = 'hevc'
+
+
+class AnimeTorrentsTorrentCodec(str, Enum):
+	AV1 = 'AV1'
+	X264_AVC = 'x264/AVC'
+	X265_HEVC = 'x265/HEVC'
+	X265HQ_HEVC_HQ = 'x265hq/HEVC-HQ'
+
+
+class AnimeTorrentsTorrentColor(str, Enum):
+	_8BIT = '8bit'
+	_10BIT = '10Bit'
+
+
+class AnimeTorrentsTorrentQuality(str, Enum):
+	_360P = '360p'
+	_480P = '480p'
+	_576P = '576p'
+	_720P = '720p'
+	_1080P = '1080p'
+	_2K = '2k'
+	_4K = '4k'
+	_8K = '8k'
+
+
+class AnimeTorrentsTorrentType(str, Enum):
+	BDRIP = 'BDRip'
+	HDRIP = 'HDRip'
+	TVRIP = 'TVRip'
+	WEBRIP = 'WEBRip'
+	DTVRIP = 'DTVRip'
+	DVDRIP = 'DVDRip'
+	HDTVRIP = 'HDTVRip'
+	WEB_DL = 'WEB-DL'
+	WEB_DLRIP = 'WEB-DLRip'
+
+
+class AnimeTorrentsTorrentMemberRole(str, Enum):
+	HEVC = 'HEVC'

anilibria_api_types-1.0.0rc1/anilibria_api_types/codegen/enums/media.py

@@ -0,0 +1,6 @@
+# Auto-generated for enums in media category
+from enum import Enum
+
+
+class MediaVideosVideoOriginType(str, Enum):
+	YOUTUBE_PLAYLIST = 'YOUTUBE_PLAYLIST'

anilibria_api_types-1.0.0rc1/anilibria_api_types/codegen/errors/validation.py

@@ -0,0 +1,7 @@
+# Auto-generated errors
+
+
+class ValidationError(Exception):
+	def __init__(self, errors: dict[str, list[str]]) -> None:
+		self.errors = errors
+		super().__init__(self.errors)