kmoe-manga-downloader 1.2.0__tar.gz → 1.2.2__tar.gz

{kmoe_manga_downloader-1.2.0/src/kmoe_manga_downloader.egg-info → kmoe_manga_downloader-1.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kmoe-manga-downloader
-Version: 1.2.0
+Version: 1.2.2
 Summary: A CLI-downloader for site @kox.moe.
 Author-email: Chris Zheng <chrisis58@outlook.com>
 License: MIT License
@@ -35,19 +35,20 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: deprecation~=2.1.0
 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">
@@ -55,11 +56,17 @@ Dynamic: license-file
 
 ## ✨功能特性
 
-- **现代化终端界面**: 使用 [rich](https://github.com/Textualize/rich) 构建的终端用户界面（TUI），提供进度条和菜单等现代化、美观的交互式终端界面。
+- **现代化终端界面**: 基于 [rich](https://github.com/Textualize/rich) 构建的终端用户界面（TUI），提供进度条和菜单等现代化、美观的交互式终端界面。
 - **凭证和配置管理**: 应用自动维护登录凭证和下载设置，实现一次配置、持久有效，提升使用效率。
-- **高效下载的性能**:  采用 `asyncio` 并发分片下载技术，充分利用网络带宽，极大加速单个大文件的下载速度。
-- **强大的高可用性**: 内置强大的自动重试与断点续传机制，无惧网络中断，确保下载任务最终成功。
-- **灵活的自动化接口**: 支持下载完成后自动执行自定义回调脚本，轻松集成到您的自动化流程。
+- **高效下载的性能**:  采用 `asyncio` 并发分片下载方式，充分利用网络带宽，显著加速单个大文件的下载速度。
+- **强大的高可用性**: 内置自动重试与断点续传机制，无惧网络中断，确保下载任务在不稳定环境下依然能够成功。
+- **灵活的自动化接口**: 支持在每个文件下载成功后自动执行自定义回调脚本，轻松集成到您的自动化工作流。
+
+## 🖼️ 使用场景
+
+- **通用的加速体验**: 采用并发分片下载方式，充分地利用不同类型用户的网络带宽，提升数据传输效率，从而有效缩短下载的等待时间。
+- **灵活部署与远程控制**: 支持在远端服务器或 NAS 上运行，可以在其他设备（PC、平板）上浏览，而通过简单的命令触发远程下载任务，实现浏览与存储的分离。
+- **智能化自动追新**: 应用支持识别重复内容，可配合定时任务实等现无人值守下载最新的内容，轻松打造时刻保持同步的个人资料库。
 
 ## 🛠️安装应用
 
@@ -73,7 +80,7 @@ pip install kmoe-manga-downloader
 
 ### 1. 登录 `kmoe`
 
-首先需要登录 `kox.moe` 并保存登录状态（Cookie）。
+首先需要登录 `kmoe` 并保存登录状态（Cookie）。
 
 ```bash
 kmdr login -u <your_username> -p <your_password>
@@ -91,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` 指令中获取。
 
@@ -127,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"
 ```
 
@@ -143,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. 持久化配置
 
@@ -167,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.2.0 → kmoe_manga_downloader-1.2.2}/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 @@
 
 ## ✨功能特性
 
-- **现代化终端界面**: 使用 [rich](https://github.com/Textualize/rich) 构建的终端用户界面（TUI），提供进度条和菜单等现代化、美观的交互式终端界面。
+- **现代化终端界面**: 基于 [rich](https://github.com/Textualize/rich) 构建的终端用户界面（TUI），提供进度条和菜单等现代化、美观的交互式终端界面。
 - **凭证和配置管理**: 应用自动维护登录凭证和下载设置，实现一次配置、持久有效，提升使用效率。
-- **高效下载的性能**:  采用 `asyncio` 并发分片下载技术，充分利用网络带宽，极大加速单个大文件的下载速度。
-- **强大的高可用性**: 内置强大的自动重试与断点续传机制，无惧网络中断，确保下载任务最终成功。
-- **灵活的自动化接口**: 支持下载完成后自动执行自定义回调脚本，轻松集成到您的自动化流程。
+- **高效下载的性能**:  采用 `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.2.0 → kmoe_manga_downloader-1.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kmoe-manga-downloader"
-version = "1.2.0"
+version = "1.2.2"
 authors = [
     { name="Chris Zheng", email="chrisis58@outlook.com" },
 ]
@@ -17,12 +17,13 @@ classifiers = [
 ]
 
 dependencies = [
-    "deprecation~=2.1.0",
     "beautifulsoup4~=4.13.4",
     "aiohttp~=3.12.15",
     "aiofiles~=24.1.0",
     "async-lru~=2.0.5",
-    "rich~=13.9.4"
+    "rich~=13.9.4",
+    "yarl~=1.20.1",
+    "typing-extensions~=4.15.0",
 ]
 
 [project.urls]

{kmoe_manga_downloader-1.2.0 → kmoe_manga_downloader-1.2.2}/src/kmdr/core/__init__.py

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

{kmoe_manga_downloader-1.2.0 → kmoe_manga_downloader-1.2.2}/src/kmdr/core/bases.py

@@ -7,7 +7,7 @@ from aiohttp import ClientSession
 from .error import LoginError
 from .registry import Registry
 from .structure import VolInfo, BookInfo
-from .utils import construct_callback
+from .utils import construct_callback, async_retry
 
 from .context import TerminalContext, SessionContext, UserProfileContext, ConfigContext
 
@@ -19,6 +19,14 @@ class Configurer(ConfigContext, TerminalContext):
     @abstractmethod
     def operate(self) -> None: ...
 
+class SessionManager(SessionContext, ConfigContext, TerminalContext):
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+    @abstractmethod
+    async def session(self) -> ClientSession: ...
+
 class Authenticator(SessionContext, ConfigContext, UserProfileContext, TerminalContext):
 
     def __init__(self, *args, **kwargs):
@@ -31,10 +39,10 @@ class Authenticator(SessionContext, ConfigContext, UserProfileContext, TerminalC
     async def authenticate(self) -> None:
         with self._console.status("认证中..."):
             try:
-                assert await self._authenticate()
+                assert await async_retry()(self._authenticate)()
             except LoginError as e:
-                self._console.print("[red]认证失败。请检查您的登录凭据或会话 cookie。[/red]")
                 self._console.print(f"[yellow]详细信息：{e}[/yellow]")
+                self._console.print("[red]认证失败。请检查您的登录凭据或会话 cookie。[/red]")
                 exit(1)
 
     @abstractmethod
@@ -74,7 +82,7 @@ class Downloader(SessionContext, UserProfileContext, TerminalContext):
 
     async def download(self, book: BookInfo, volumes: list[VolInfo]):
         if not volumes:
-            self._console.print("No volumes to download.")
+            self._console.print("没有可下载的卷。", style="blue")
             exit(0)
 
         try:
@@ -89,7 +97,7 @@ class Downloader(SessionContext, UserProfileContext, TerminalContext):
     @abstractmethod
     async def _download(self, book: BookInfo, volume: VolInfo): ...
 
-KMDR_SESSION = Registry[ClientSession]('KmdrSession', True)
+SESSION_MANAGER = Registry[SessionManager]('SessionManager', True)
 AUTHENTICATOR = Registry[Authenticator]('Authenticator')
 LISTERS = Registry[Lister]('Lister')
 PICKERS = Registry[Picker]('Picker')

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

@@ -0,0 +1,74 @@
+from dataclasses import dataclass
+from enum import Enum
+from typing import Union
+
+from typing_extensions import deprecated
+
+class BASE_URL(Enum):
+
+    @property
+    @deprecated("KOX 已过时，请使用 KXO 或 KOZ。")
+    def KOX(self) -> str:
+        return 'https://kox.moe'
+    
+    KXX = 'https://kxx.moe'
+
+    KXO = 'https://kxo.moe'
+
+    KOZ = 'https://koz.moe'
+
+    MOX = 'https://mox.moe'
+
+    @classmethod
+    def alternatives(cls) -> set[str]:
+        """返回备用的基础 URL 列表"""
+        return {cls.KXO.value, cls.KOZ.value, cls.MOX.value}
+
+    DEFAULT = 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)
+
+    @classmethod
+    def ok(cls, code: Union[str, 'LoginResponse']) -> bool:
+        if isinstance(code, LoginResponse):
+            return code == cls.m100
+        return cls.from_code(code) == cls.m100
+
+API_ROUTE = _ApiRoute()
+"""API 路由常量实例"""

{kmoe_manga_downloader-1.2.0 → kmoe_manga_downloader-1.2.2}/src/kmdr/core/context.py

@@ -1,6 +1,7 @@
 from aiohttp import ClientSession
 
-from .defaults import Configurer as InnerConfigurer, UserProfile, session_var, progress, console
+
+from .defaults import Configurer as InnerConfigurer, UserProfile, session_var, progress, console, base_url_var
 
 class TerminalContext:
 
@@ -9,12 +10,6 @@ class TerminalContext:
         self._progress = progress
         self._console = console
 
-class SessionContext:
-
-    def __init__(self, *args, **kwargs):
-        super().__init__()
-        self._session: ClientSession = session_var.get()
-
 class UserProfileContext:
 
     def __init__(self, *args, **kwargs):
@@ -26,3 +21,24 @@ 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()
+    
+    @_session.setter
+    def _session(self, value: ClientSession):
+        session_var.set(value)
+
+    @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)

{kmoe_manga_downloader-1.2.0 → kmoe_manga_downloader-1.2.2}/src/kmdr/core/defaults.py

@@ -1,6 +1,6 @@
 import os
 import json
-from typing import Optional
+from typing import Optional, Any
 import argparse
 from contextvars import ContextVar
 from rich.console import Console
@@ -15,6 +15,7 @@ from rich.progress import (
 
 from .utils import singleton
 from .structure import Config
+from .constants import BASE_URL
 
 HEADERS = {
     'User-Agent': 'kmdr/1.0 (https://github.com/chrisis58/kmoe-manga-downloader)'
@@ -75,6 +76,7 @@ def argument_parser():
     config_parser = subparsers.add_parser('config', help='配置下载器')
     config_parser.add_argument('-l', '--list-option', action='store_true', help='列出所有配置')
     config_parser.add_argument('-s', '--set', nargs='+', type=str, help='设置一个或多个配置项，格式为 `key=value`，例如: `num_workers=8`')
+    config_parser.add_argument('-b', '--base-url', type=str, help='设置镜像站点的基础 URL, 例如: `https://kxx.moe`')
     config_parser.add_argument('-c', '--clear', type=str, help='清除指定配置，可选值为 `all`, `cookie`, `option`')
     config_parser.add_argument('-d', '--delete', '--unset', dest='unset', type=str, help='删除特定的配置选项')
 
@@ -137,6 +139,9 @@ class Configurer:
             cookie = config.get('cookie', None)
             if cookie is not None and isinstance(cookie, dict):
                 self._config.cookie = cookie
+            base_url = config.get('base_url', None)
+            if base_url is not None and isinstance(base_url, str):
+                self._config.base_url = base_url
 
     @property
     def config(self) -> 'Config':
@@ -162,12 +167,27 @@ class Configurer:
         return self._config.option
     
     @option.setter
-    def option(self, value: Optional[dict[str, any]]):
+    def option(self, value: Optional[dict[str, Any]]):
         if self._config is None:
             self._config = Config()
         self._config.option = value
         self.update()
     
+    @property
+    def base_url(self) -> str:
+        if self._config is None or self._config.base_url is None:
+            return BASE_URL.DEFAULT.value
+        return self._config.base_url
+    
+    def set_base_url(self, value: str):
+        if self._config is None:
+            self._config = Config()
+        self._config.base_url = value
+        self.update()
+    
+    def get_base_url(self) -> str:
+        return self._config.base_url
+    
     def update(self):
         with open(os.path.join(os.path.expanduser("~"), self.__filename), 'w') as f:
             json.dump(self._config.__dict__, f, indent=4, ensure_ascii=False)
@@ -184,7 +204,7 @@ class Configurer:
 
         self.update()
     
-    def set_option(self, key: str, value: any):
+    def set_option(self, key: str, value: Any):
         if self._config.option is None:
             self._config.option = {}
 
@@ -209,5 +229,11 @@ def __combine_args(dest: argparse.Namespace, option: dict) -> argparse.Namespace
 
 def combine_args(dest: argparse.Namespace) -> argparse.Namespace:
     assert isinstance(dest, argparse.Namespace), "dest must be an argparse.Namespace instance"
-    option = Configurer().config.option
-    return __combine_args(dest, option)
+    option = Configurer().option
+    
+    if option is None:
+        return dest
+
+    return __combine_args(dest, option)
+
+base_url_var = ContextVar('base_url', default=Configurer().base_url)

kmoe_manga_downloader-1.2.2/src/kmdr/core/error.py

@@ -0,0 +1,38 @@
+from typing import Optional
+
+class KmdrError(RuntimeError):
+    def __init__(self, message: str, solution: Optional[list[str]] = None, *args: object, **kwargs: object):
+        super().__init__(message, *args, **kwargs)
+        self.message = message
+
+        self._solution = "" if solution is None else "\n[bold cyan]推荐解决方法:[/bold cyan] \n" + "\n".join(f"[cyan]>>> {sol}[/cyan]" for sol in solution)
+
+class InitializationError(KmdrError):
+    def __init__(self, message, solution: Optional[list[str]] = None):
+        super().__init__(message, solution)
+
+    def __str__(self):
+        return f"{self.message}\n{self._solution}"
+
+class LoginError(KmdrError):
+    def __init__(self, message, solution: Optional[list[str]] = None):
+        super().__init__(message, solution)
+
+    def __str__(self):
+        return f"{self.message}\n{self._solution}"
+
+class RedirectError(KmdrError):
+    def __init__(self, message, new_base_url: str):
+        super().__init__(message)
+        self.new_base_url = new_base_url
+
+    def __str__(self):
+        return f"{self.message} 新的地址: {self.new_base_url}"
+
+class ResponseError(KmdrError):
+    def __init__(self, message, status_code: int):
+        super().__init__(message)
+        self.status_code = status_code
+
+    def __str__(self):
+        return f"{self.message} (状态码: {self.status_code})"

kmoe_manga_downloader-1.2.2/src/kmdr/core/protocol.py

@@ -0,0 +1,10 @@
+from typing import Protocol, TypeVar
+
+S = TypeVar('S', covariant=True)
+T = TypeVar('T', contravariant=True)
+
+class Supplier(Protocol[S]):
+    def __call__(self) -> S: ...
+
+class Consumer(Protocol[T]):
+    def __call__(self, value: T) -> None: ...