kmoe-manga-downloader 1.1.2__tar.gz → 1.2.1__tar.gz

{kmoe_manga_downloader-1.1.2/src/kmoe_manga_downloader.egg-info → kmoe_manga_downloader-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kmoe-manga-downloader
-Version: 1.1.2
+Version: 1.2.1
 Summary: A CLI-downloader for site @kox.moe.
 Author-email: Chris Zheng <chrisis58@outlook.com>
 License: MIT License
@@ -35,17 +35,20 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: beautifulsoup4<5.0.0,>=4.11.1
-Requires-Dist: requests<3.0.0,>=2.32.3
-Requires-Dist: tqdm<5.0.0,>=4.67.1
-Requires-Dist: cloudscraper<2.0.0,>=1.2.71
+Requires-Dist: beautifulsoup4~=4.13.4
+Requires-Dist: aiohttp~=3.12.15
+Requires-Dist: aiofiles~=24.1.0
+Requires-Dist: async-lru~=2.0.5
+Requires-Dist: rich~=13.9.4
+Requires-Dist: yarl~=1.20.1
+Requires-Dist: typing-extensions~=4.15.0
 Dynamic: license-file
 
 # Kmoe Manga Downloader
 
 [![PyPI Downloads](https://static.pepy.tech/badge/kmoe-manga-downloader)](https://pepy.tech/projects/kmoe-manga-downloader) [![PyPI version](https://img.shields.io/pypi/v/kmoe-manga-downloader.svg)](https://pypi.org/project/kmoe-manga-downloader/) [![Unit Tests](https://github.com/chrisis58/kmdr/actions/workflows/unit-test.yml/badge.svg)](https://github.com/chrisis58/kmdr/actions/workflows/unit-test.yml) [![Interpretor](https://img.shields.io/badge/python-3.9+-blue)](https://www.python.org/) [![License](https://img.shields.io/badge/License-MIT-green)](https://github.com/chrisis58/kmdr/blob/main/LICENSE)
 
-`kmdr (Kmoe Manga Downloader)` 是一个 Python 应用，用于从 [Kmoe](https://kox.moe/) 网站下载漫画。它支持在终端环境下的登录、下载指定书籍及其卷，并支持回调脚本执行。
+`kmdr (Kmoe Manga Downloader)` 是一个 Python 终端应用，用于从 [Kmoe](https://kxx.moe/) 网站下载漫画。它支持在终端环境下的登录、下载指定漫画及其卷，并支持回调脚本执行。
 
 <p align="center">
   <img src="assets/kmdr-demo.gif" alt="kmdr 使用演示" width="720">
@@ -53,11 +56,17 @@ Dynamic: license-file
 
 ## ✨功能特性
 
-- **凭证管理**: 命令行登录并持久化会话
-- **多种下载方式**: 支持通过书籍 URL 或从收藏列表下载
-- **高效下载**: 支持多线程、失败重试及断点续传
-- **配置持久化**: 保存常用下载目录、代理等设置
-- **回调支持**: 下载完成后自动执行自定义脚本
+- **现代化终端界面**: 基于 [rich](https://github.com/Textualize/rich) 构建的终端用户界面（TUI），提供进度条和菜单等现代化、美观的交互式终端界面。
+- **凭证和配置管理**: 应用自动维护登录凭证和下载设置，实现一次配置、持久有效，提升使用效率。
+- **高效下载的性能**:  采用 `asyncio` 并发分片下载方式，充分利用网络带宽，显著加速单个大文件的下载速度。
+- **强大的高可用性**: 内置自动重试与断点续传机制，无惧网络中断，确保下载任务在不稳定环境下依然能够成功。
+- **灵活的自动化接口**: 支持在每个文件下载成功后自动执行自定义回调脚本，轻松集成到您的自动化工作流。
+
+## 🖼️ 使用场景
+
+- **通用的加速体验**: 采用并发分片下载方式，充分地利用不同类型用户的网络带宽，提升数据传输效率，从而有效缩短下载的等待时间。
+- **灵活部署与远程控制**: 支持在远端服务器或 NAS 上运行，可以在其他设备（PC、平板）上浏览，而通过简单的命令触发远程下载任务，实现浏览与存储的分离。
+- **智能化自动追新**: 应用支持识别重复内容，可配合定时任务实等现无人值守下载最新的内容，轻松打造时刻保持同步的个人资料库。
 
 ## 🛠️安装应用
 
@@ -71,7 +80,7 @@ pip install kmoe-manga-downloader
 
 ### 1. 登录 `kmoe`
 
-首先需要登录 `kox.moe` 并保存登录状态（Cookie）。
+首先需要登录 `kmoe` 并保存登录状态（Cookie）。
 
 ```bash
 kmdr login -u <your_username> -p <your_password>
@@ -89,26 +98,28 @@ kmdr login -u <your_username>
 
 ```bash
 # 在当前目录下载第一、二、三卷
-kmdr download --dest . --book-url https://kox.moe/c/50076.htm --volume 1,2,3
-kmdr download -l https://kox.moe/c/50076.htm -v 1-3
+kmdr download --dest . --book-url https://kxx.moe/c/50076.htm --volume 1,2,3
+# 下面命令的功能与上面相同
+kmdr download -l https://kxx.moe/c/50076.htm -v 1-3
 ```
 
 ```bash
 # 在目标目录下载全部番外篇
-kmdr download --dest path/to/destination --book-url https://kox.moe/c/50076.htm --vol-type extra -v all
-kmdr download -d path/to/destination -l https://kox.moe/c/50076.htm -t extra -v all
+kmdr download --dest path/to/destination --book-url https://kxx.moe/c/50076.htm --vol-type extra -v all
+# 下面命令的功能与上面相同
+kmdr download -d path/to/destination -l https://kxx.moe/c/50076.htm -t extra -v all
 ```
 
 #### 常用参数说明：
 
-- `-d`, `--dest`: 下载的目标目录（默认为当前目录），在此基础上会额外添加一个为书籍名称的子目录
-- `-l`, `--book-url`: 指定书籍的主页地址
-- `-v`, `--volume`: 指定卷的名称，多个名称使用逗号分隔，`all` 表示下载所有卷
+- `-d`, `--dest`: 下载的目标目录（默认为当前目录），在此基础上会额外添加一个为漫画名称的子目录
+- `-l`, `--book-url`: 指定漫画的主页地址
+- `-v`, `--volume`: 指定下载的卷，多个用逗号分隔，例如 `1,2,3` 或 `1-5,8`，`all` 表示全部
 - `-t`, `--vol-type`: 卷类型，`vol`: 单行本（默认）；`extra`: 番外；`seri`: 连载话；`all`: 全部
 - `-p`, `--proxy`: 代理服务器地址
-- `-r`, `--retry`: 下载失败时的重试次数
+- `-r`, `--retry`: 下载失败时的重试次数，默认为 3
 - `-c`, `--callback`: 下载完成后的回调脚本（使用方式详见 [4. 回调函数](https://github.com/chrisis58/kmoe-manga-downlaoder?tab=readme-ov-file#4-%E5%9B%9E%E8%B0%83%E5%87%BD%E6%95%B0)）
-- `--num-workers`: 最大同时下载数量，默认为 1
+- `--num-workers`: 最大下载并发数量，默认为 8
 
 > 完整的参数说明可以从 `help` 指令中获取。
 
@@ -125,7 +136,7 @@ kmdr status
 你可以设置一个回调函数，下载完成后执行。回调可以是任何你想要的命令：
 
 ```bash
-kmdr download -d path/to/destination --book-url https://kox.moe/c/50076.htm -v 1-3 \
+kmdr download -d path/to/destination --book-url https://kxx.moe/c/50076.htm -v 1-3 \
 	--callback "echo '{b.name} {v.name} downloaded!' >> ~/kmdr.log"
 ```
 
@@ -141,7 +152,7 @@ kmdr download -d path/to/destination --book-url https://kox.moe/c/50076.htm -v 1
 | b.name   | 对应漫画的名字 |
 | b.author | 对应漫画的作者 |
 
-> 完整的可用参数请参考 [structure.py](https://github.com/chrisis58/kmdr/blob/main/core/structure.py#L11) 中关于 `VolInfo` 的定义。
+> 完整的可用参数请参考 [structure.py](https://github.com/chrisis58/kmoe-manga-downloader/blob/main/src/kmdr/core/structure.py#L11) 中关于 `VolInfo` 的定义。
 
 ### 5. 持久化配置
 
@@ -165,6 +176,20 @@ kmdr config -s num_workers=5 "callback=echo '{b.name} {v.name} downloaded!' >> ~
 
 > 当前仅支持部分下载参数的持久化：`num_workers`, `dest`, `retry`, `callback`, `proxy`
 
+### 6. 镜像源切换
+
+为了保证服务的长期可用性，并让用户能根据自己的网络环境选择最快的服务器，应用支持灵活地切换镜像源。
+
+当您发现默认源（当前为 `kxx.moe`）访问缓慢或失效时，可以通过 `config` 命令轻松切换到其他备用镜像源：
+
+```
+kmdr config --base-url https://mox.moe
+# 或者
+kmdr config -b https://mox.moe
+```
+
+你可以参考 [镜像目录](./mirror/mirrors.json) 来选择合适的镜像源，如果你发现部分镜像源过时或者有缺失，欢迎贡献你的内容！
+
 ## ⚠️ 声明
 
 - 本工具仅作学习、研究、交流使用，使用本工具的用户应自行承担风险

{kmoe_manga_downloader-1.1.2 → kmoe_manga_downloader-1.2.1}/README.md

@@ -2,7 +2,7 @@
 
 [![PyPI Downloads](https://static.pepy.tech/badge/kmoe-manga-downloader)](https://pepy.tech/projects/kmoe-manga-downloader) [![PyPI version](https://img.shields.io/pypi/v/kmoe-manga-downloader.svg)](https://pypi.org/project/kmoe-manga-downloader/) [![Unit Tests](https://github.com/chrisis58/kmdr/actions/workflows/unit-test.yml/badge.svg)](https://github.com/chrisis58/kmdr/actions/workflows/unit-test.yml) [![Interpretor](https://img.shields.io/badge/python-3.9+-blue)](https://www.python.org/) [![License](https://img.shields.io/badge/License-MIT-green)](https://github.com/chrisis58/kmdr/blob/main/LICENSE)
 
-`kmdr (Kmoe Manga Downloader)` 是一个 Python 应用，用于从 [Kmoe](https://kox.moe/) 网站下载漫画。它支持在终端环境下的登录、下载指定书籍及其卷，并支持回调脚本执行。
+`kmdr (Kmoe Manga Downloader)` 是一个 Python 终端应用，用于从 [Kmoe](https://kxx.moe/) 网站下载漫画。它支持在终端环境下的登录、下载指定漫画及其卷，并支持回调脚本执行。
 
 <p align="center">
   <img src="assets/kmdr-demo.gif" alt="kmdr 使用演示" width="720">
@@ -10,11 +10,17 @@
 
 ## ✨功能特性
 
-- **凭证管理**: 命令行登录并持久化会话
-- **多种下载方式**: 支持通过书籍 URL 或从收藏列表下载
-- **高效下载**: 支持多线程、失败重试及断点续传
-- **配置持久化**: 保存常用下载目录、代理等设置
-- **回调支持**: 下载完成后自动执行自定义脚本
+- **现代化终端界面**: 基于 [rich](https://github.com/Textualize/rich) 构建的终端用户界面（TUI），提供进度条和菜单等现代化、美观的交互式终端界面。
+- **凭证和配置管理**: 应用自动维护登录凭证和下载设置，实现一次配置、持久有效，提升使用效率。
+- **高效下载的性能**:  采用 `asyncio` 并发分片下载方式，充分利用网络带宽，显著加速单个大文件的下载速度。
+- **强大的高可用性**: 内置自动重试与断点续传机制，无惧网络中断，确保下载任务在不稳定环境下依然能够成功。
+- **灵活的自动化接口**: 支持在每个文件下载成功后自动执行自定义回调脚本，轻松集成到您的自动化工作流。
+
+## 🖼️ 使用场景
+
+- **通用的加速体验**: 采用并发分片下载方式，充分地利用不同类型用户的网络带宽，提升数据传输效率，从而有效缩短下载的等待时间。
+- **灵活部署与远程控制**: 支持在远端服务器或 NAS 上运行，可以在其他设备（PC、平板）上浏览，而通过简单的命令触发远程下载任务，实现浏览与存储的分离。
+- **智能化自动追新**: 应用支持识别重复内容，可配合定时任务实等现无人值守下载最新的内容，轻松打造时刻保持同步的个人资料库。
 
 ## 🛠️安装应用
 
@@ -28,7 +34,7 @@ pip install kmoe-manga-downloader
 
 ### 1. 登录 `kmoe`
 
-首先需要登录 `kox.moe` 并保存登录状态（Cookie）。
+首先需要登录 `kmoe` 并保存登录状态（Cookie）。
 
 ```bash
 kmdr login -u <your_username> -p <your_password>
@@ -46,26 +52,28 @@ kmdr login -u <your_username>
 
 ```bash
 # 在当前目录下载第一、二、三卷
-kmdr download --dest . --book-url https://kox.moe/c/50076.htm --volume 1,2,3
-kmdr download -l https://kox.moe/c/50076.htm -v 1-3
+kmdr download --dest . --book-url https://kxx.moe/c/50076.htm --volume 1,2,3
+# 下面命令的功能与上面相同
+kmdr download -l https://kxx.moe/c/50076.htm -v 1-3
 ```
 
 ```bash
 # 在目标目录下载全部番外篇
-kmdr download --dest path/to/destination --book-url https://kox.moe/c/50076.htm --vol-type extra -v all
-kmdr download -d path/to/destination -l https://kox.moe/c/50076.htm -t extra -v all
+kmdr download --dest path/to/destination --book-url https://kxx.moe/c/50076.htm --vol-type extra -v all
+# 下面命令的功能与上面相同
+kmdr download -d path/to/destination -l https://kxx.moe/c/50076.htm -t extra -v all
 ```
 
 #### 常用参数说明：
 
-- `-d`, `--dest`: 下载的目标目录（默认为当前目录），在此基础上会额外添加一个为书籍名称的子目录
-- `-l`, `--book-url`: 指定书籍的主页地址
-- `-v`, `--volume`: 指定卷的名称，多个名称使用逗号分隔，`all` 表示下载所有卷
+- `-d`, `--dest`: 下载的目标目录（默认为当前目录），在此基础上会额外添加一个为漫画名称的子目录
+- `-l`, `--book-url`: 指定漫画的主页地址
+- `-v`, `--volume`: 指定下载的卷，多个用逗号分隔，例如 `1,2,3` 或 `1-5,8`，`all` 表示全部
 - `-t`, `--vol-type`: 卷类型，`vol`: 单行本（默认）；`extra`: 番外；`seri`: 连载话；`all`: 全部
 - `-p`, `--proxy`: 代理服务器地址
-- `-r`, `--retry`: 下载失败时的重试次数
+- `-r`, `--retry`: 下载失败时的重试次数，默认为 3
 - `-c`, `--callback`: 下载完成后的回调脚本（使用方式详见 [4. 回调函数](https://github.com/chrisis58/kmoe-manga-downlaoder?tab=readme-ov-file#4-%E5%9B%9E%E8%B0%83%E5%87%BD%E6%95%B0)）
-- `--num-workers`: 最大同时下载数量，默认为 1
+- `--num-workers`: 最大下载并发数量，默认为 8
 
 > 完整的参数说明可以从 `help` 指令中获取。
 
@@ -82,7 +90,7 @@ kmdr status
 你可以设置一个回调函数，下载完成后执行。回调可以是任何你想要的命令：
 
 ```bash
-kmdr download -d path/to/destination --book-url https://kox.moe/c/50076.htm -v 1-3 \
+kmdr download -d path/to/destination --book-url https://kxx.moe/c/50076.htm -v 1-3 \
 	--callback "echo '{b.name} {v.name} downloaded!' >> ~/kmdr.log"
 ```
 
@@ -98,7 +106,7 @@ kmdr download -d path/to/destination --book-url https://kox.moe/c/50076.htm -v 1
 | b.name   | 对应漫画的名字 |
 | b.author | 对应漫画的作者 |
 
-> 完整的可用参数请参考 [structure.py](https://github.com/chrisis58/kmdr/blob/main/core/structure.py#L11) 中关于 `VolInfo` 的定义。
+> 完整的可用参数请参考 [structure.py](https://github.com/chrisis58/kmoe-manga-downloader/blob/main/src/kmdr/core/structure.py#L11) 中关于 `VolInfo` 的定义。
 
 ### 5. 持久化配置
 
@@ -122,6 +130,20 @@ kmdr config -s num_workers=5 "callback=echo '{b.name} {v.name} downloaded!' >> ~
 
 > 当前仅支持部分下载参数的持久化：`num_workers`, `dest`, `retry`, `callback`, `proxy`
 
+### 6. 镜像源切换
+
+为了保证服务的长期可用性，并让用户能根据自己的网络环境选择最快的服务器，应用支持灵活地切换镜像源。
+
+当您发现默认源（当前为 `kxx.moe`）访问缓慢或失效时，可以通过 `config` 命令轻松切换到其他备用镜像源：
+
+```
+kmdr config --base-url https://mox.moe
+# 或者
+kmdr config -b https://mox.moe
+```
+
+你可以参考 [镜像目录](./mirror/mirrors.json) 来选择合适的镜像源，如果你发现部分镜像源过时或者有缺失，欢迎贡献你的内容！
+
 ## ⚠️ 声明
 
 - 本工具仅作学习、研究、交流使用，使用本工具的用户应自行承担风险

{kmoe_manga_downloader-1.1.2 → kmoe_manga_downloader-1.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kmoe-manga-downloader"
-version = "1.1.2"
+version = "1.2.1"
 authors = [
     { name="Chris Zheng", email="chrisis58@outlook.com" },
 ]
@@ -17,10 +17,13 @@ classifiers = [
 ]
 
 dependencies = [
-    "beautifulsoup4>=4.11.1,<5.0.0",
-    "requests>=2.32.3,<3.0.0",
-    "tqdm>=4.67.1,<5.0.0",
-    "cloudscraper>=1.2.71,<2.0.0",
+    "beautifulsoup4~=4.13.4",
+    "aiohttp~=3.12.15",
+    "aiofiles~=24.1.0",
+    "async-lru~=2.0.5",
+    "rich~=13.9.4",
+    "yarl~=1.20.1",
+    "typing-extensions~=4.15.0",
 ]
 
 [project.urls]

{kmoe_manga_downloader-1.1.2 → kmoe_manga_downloader-1.2.1}/src/kmdr/core/__init__.py

@@ -1,7 +1,9 @@
 from .bases import Authenticator, Lister, Picker, Downloader, Configurer
 from .structure import VolInfo, BookInfo, VolumeType
-from .bases import AUTHENTICATOR, LISTERS, PICKERS, DOWNLOADER, CONFIGURER
+from .bases import AUTHENTICATOR, LISTERS, PICKERS, DOWNLOADER, CONFIGURER, KMDR_SESSION
 
-from .defaults import argument_parser
+from .defaults import argument_parser, session_var
 
-from .error import KmdrError, LoginError
+from .error import KmdrError, LoginError
+
+from .session import KmdrSession

kmoe_manga_downloader-1.2.1/src/kmdr/core/bases.py

@@ -0,0 +1,109 @@
+from typing import Callable, Optional
+from abc import abstractmethod
+
+import asyncio
+from aiohttp import ClientSession
+
+from .error import LoginError
+from .registry import Registry
+from .structure import VolInfo, BookInfo
+from .utils import construct_callback, async_retry
+
+from .context import TerminalContext, SessionContext, UserProfileContext, ConfigContext
+
+class Configurer(ConfigContext, TerminalContext):
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+    
+    @abstractmethod
+    def operate(self) -> None: ...
+
+class Authenticator(SessionContext, ConfigContext, UserProfileContext, TerminalContext):
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        # 这里的 base url 可能会在认证过程中被更新
+        self._inner_base_url: Optional[str] = None
+
+    # 在使用代理登录时，可能会出现问题，但是现在还不清楚是不是代理的问题。
+    # 主站正常情况下不使用代理也能登录成功。但是不排除特殊的网络环境下需要代理。
+    # 所以暂时保留代理登录的功能，如果后续确认是代理的问题，可以考虑启用 @no_proxy 装饰器。
+    # @no_proxy
+    async def authenticate(self) -> None:
+        with self._console.status("认证中..."):
+            try:
+                # 这里添加了 base_url_setter，以便在重定向时更新 base_url
+                assert await async_retry(
+                    base_url_setter=self._configurer.set_base_url
+                )(self._authenticate)()
+
+                # 登录成功后，更新 base_url
+                self._base_url = self.base_url
+            except LoginError as e:
+                self._console.print("[red]认证失败。请检查您的登录凭据或会话 cookie。[/red]")
+                self._console.print(f"[yellow]详细信息：{e}[/yellow]")
+                exit(1)
+    
+    @property
+    def base_url(self) -> str:
+        return self._inner_base_url or self._configurer.base_url
+
+    @abstractmethod
+    async def _authenticate(self) -> bool: ...
+
+class Lister(SessionContext, TerminalContext):
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+    @abstractmethod
+    async def list(self) -> tuple[BookInfo, list[VolInfo]]: ...
+
+class Picker(TerminalContext):
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+    @abstractmethod
+    def pick(self, volumes: list[VolInfo]) -> list[VolInfo]: ...
+
+class Downloader(SessionContext, UserProfileContext, TerminalContext):
+
+    def __init__(self,
+                 dest: str = '.',
+                 callback: Optional[str] = None,
+                 retry: int = 3,
+                 num_workers: int = 8,
+                 *args, **kwargs
+    ):
+        super().__init__(*args, **kwargs)
+
+        self._dest: str = dest
+        self._callback: Optional[Callable] = construct_callback(callback)
+        self._retry: int = retry
+        self._semaphore = asyncio.Semaphore(num_workers)
+
+    async def download(self, book: BookInfo, volumes: list[VolInfo]):
+        if not volumes:
+            self._console.print("No volumes to download.")
+            exit(0)
+
+        try:
+            with self._progress:
+                tasks = [self._download(book, volume) for volume in volumes]
+                await asyncio.gather(*tasks, return_exceptions=True)
+
+        except KeyboardInterrupt:
+            self._console.print("\n操作已取消（KeyboardInterrupt）")
+            exit(130)
+
+    @abstractmethod
+    async def _download(self, book: BookInfo, volume: VolInfo): ...
+
+KMDR_SESSION = Registry[ClientSession]('KmdrSession', True)
+AUTHENTICATOR = Registry[Authenticator]('Authenticator')
+LISTERS = Registry[Lister]('Lister')
+PICKERS = Registry[Picker]('Picker')
+DOWNLOADER = Registry[Downloader]('Downloader', True)
+CONFIGURER = Registry[Configurer]('Configurer')

kmoe_manga_downloader-1.2.1/src/kmdr/core/constants.py

@@ -0,0 +1,79 @@
+from dataclasses import dataclass
+from enum import Enum
+from typing_extensions import deprecated
+
+
+@dataclass(frozen=True)
+class _BaseUrl:
+
+    @property
+    @deprecated("KOX 已过时，请使用 KXO 或 KOZ。")
+    def KOX(self) -> str:
+        return 'https://kox.moe'
+    
+    @property
+    def KXX(self) -> str:
+        return 'https://kxx.moe'
+
+    @property
+    def KXO(self) -> str:
+        return 'https://kxo.moe'
+
+    @property
+    def KOZ(self) -> str:
+        return 'https://koz.moe'
+
+    @property
+    def MOX(self) -> str:
+        return 'https://mox.moe'
+
+    @property
+    def DEFAULT(self) -> str:
+        """默认基础 URL"""
+        return self.KXX
+
+
+@dataclass(frozen=True)
+class _ApiRoute():
+    PROFILE: str = '/my.php'
+    """用户信息页面"""
+
+    LOGIN: str = '/login.php'
+    """登录页面"""
+
+    LOGIN_DO: str = '/login_do.php'
+    """登录接口"""
+
+    MY_FOLLOW: str = '/myfollow.php'
+    """关注列表页面"""
+
+    BOOK_DATA: str = '/book_data.php'
+    """书籍数据接口"""
+
+    DOWNLOAD: str = '/dl/{book_id}/{volume_id}/1/2/{is_vip}/'
+    """下载接口"""
+
+    GETDOWNURL: str = '/getdownurl.php?b={book_id}&v={volume_id}&mobi=2&vip={is_vip}&json=1'
+    """获取下载链接接口"""
+
+
+class LoginResponse(Enum):
+    m100 = "登录成功。"
+
+    e400 = "帳號或密碼錯誤。"
+    e401 = "非法訪問，請使用瀏覽器正常打開本站。"
+    e402 = "帳號已經註銷。不會解釋原因，無需提問。"
+    e403 = "驗證失效，請刷新頁面重新操作。"
+
+    unknown = "未知响应代码。"
+
+    @classmethod
+    def from_code(cls, code: str) -> 'LoginResponse':
+        return cls.__members__.get(code, cls.unknown)
+
+
+API_ROUTE = _ApiRoute()
+"""API 路由常量实例"""
+
+BASE_URL = _BaseUrl()
+"""基础 URL 实例"""

kmoe_manga_downloader-1.2.1/src/kmdr/core/context.py

@@ -0,0 +1,40 @@
+from aiohttp import ClientSession
+
+
+from .defaults import Configurer as InnerConfigurer, UserProfile, session_var, progress, console, base_url_var
+
+class TerminalContext:
+
+    def __init__(self, *args, **kwargs):
+        super().__init__()
+        self._progress = progress
+        self._console = console
+
+class UserProfileContext:
+
+    def __init__(self, *args, **kwargs):
+        super().__init__()
+        self._profile = UserProfile()
+
+class ConfigContext:
+
+    def __init__(self, *args, **kwargs):
+        super().__init__()
+        self._configurer = InnerConfigurer()
+
+class SessionContext:
+
+    def __init__(self, *args, **kwargs):
+        super().__init__()
+
+    @property
+    def _session(self) -> ClientSession:
+        return session_var.get()
+
+    @property
+    def _base_url(self) -> str:
+        return base_url_var.get()
+
+    @_base_url.setter
+    def _base_url(self, value: str):
+        base_url_var.set(value)