jmcomic 2.5.5__tar.gz → 2.5.7__tar.gz

{jmcomic-2.5.5/src/jmcomic.egg-info → jmcomic-2.5.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: jmcomic
-Version: 2.5.5
+Version: 2.5.7
 Summary: Python API For JMComic (禁漫天堂)
 Home-page: https://github.com/hect0x7/JMComic-Crawler-Python
 Author: hect0x7
@@ -42,16 +42,26 @@ Requires-Dist: pycryptodome
 
 本项目的核心功能是下载本子，基于此，设计了一套方便使用、便于扩展，能满足一些特殊下载需求的框架。
 
-除了下载功能以外，也实现了其他的一些禁漫接口，例如登录、搜索、收藏夹、分类、排行榜等等，按需实现。
+目前核心功能实现较为稳定，项目也处于维护阶段。
 
-目前核心功能实现较为稳定，项目也处于维护阶段（因为禁漫接口经常变动，需要经常维护）。
+除了下载功能以外，也实现了其他的一些禁漫接口，按需实现，具体如下。
+
+### 已实现的禁漫API：
+
+- 登录
+- 搜本
+- 分类 (排行榜)
+- 本子章节详情
+- 图片下载解码
+- 收藏夹
+- 移动端接口加解密
 
 ## 安装教程
 
 * 通过pip官方源安装（推荐，并且更新也是这个命令）
 
   ```shell
-  pip install jmcomic -i https://pypi.org/project --upgrade
+  pip install jmcomic -i https://pypi.org/project -U
   ```
 * 通过源代码安装
 
@@ -75,6 +85,21 @@ jmcomic.download_album('422866')  # 传入要下载的album的id，即可下载
 $ jmcomic 422866
 ```
 
+## 进阶使用
+
+文档网站：[jmcomic.readthedocs.io](https://jmcomic.readthedocs.io/en/latest)
+
+进阶使用可以参考：[jmcomic常用类和方法演示](assets/docs/sources/tutorial/0_demo.md)
+
+下面列出的是一些常用的文档：
+
+* [jmcomic常用类和方法演示](assets/docs/sources/tutorial/0_demo.md)
+* [option配置文件语法（包含插件配置）](./assets/docs/sources/option_file_syntax.md)
+* [GitHub Actions使用教程](./assets/docs/sources/tutorial/1_github_actions.md)
+* [命令行使用教程](assets/docs/sources/tutorial/2_command_line.md)
+* [插件机制](assets/docs/sources/tutorial/6_plugin.md)
+* [下载过滤器机制](assets/docs/sources/tutorial/5_filter.md)
+
 ## 项目特点
 
 - **绕过Cloudflare的反爬虫**
@@ -111,19 +136,6 @@ $ jmcomic 422866
         - `jpg图片合成为一个pdf插件`
         - `导出收藏夹为csv文件插件`
 
-## 进阶使用
-
-进阶使用请查阅文档：[文档](https://jmcomic.readthedocs.io/en/latest)
-
-下面列出一些常用的文档链接：
-
-* [option配置文件语法（包含插件配置）](./assets/docs/sources/option_file_syntax.md)
-* [常用类和方法演示（下载本子、获取实体类、搜索本子）](assets/docs/sources/tutorial/3_demo.md)
-* [命令行使用教程](assets/docs/sources/tutorial/2_command_line.md)
-* [GitHub Actions使用教程](./assets/docs/sources/tutorial/1_github_actions.md)
-* [插件机制](assets/docs/sources/tutorial/6_plugin.md)
-* [下载过滤器机制](assets/docs/sources/tutorial/5_filter.md)
-
 ## 使用小说明
 
 * Python >= 3.7
@@ -131,10 +143,11 @@ $ jmcomic 422866
 
 ## 项目文件夹介绍
 
+* .github：GitHub Actions配置文件
 * assets：存放一些非代码的资源文件
 
-    * config：存放配置文件
     * docs：项目文档
+    * option：存放配置文件
 
 * src：存放源代码
 

{jmcomic-2.5.5 → jmcomic-2.5.7}/README.md

@@ -14,16 +14,26 @@
 
 本项目的核心功能是下载本子，基于此，设计了一套方便使用、便于扩展，能满足一些特殊下载需求的框架。
 
-除了下载功能以外，也实现了其他的一些禁漫接口，例如登录、搜索、收藏夹、分类、排行榜等等，按需实现。
+目前核心功能实现较为稳定，项目也处于维护阶段。
 
-目前核心功能实现较为稳定，项目也处于维护阶段（因为禁漫接口经常变动，需要经常维护）。
+除了下载功能以外，也实现了其他的一些禁漫接口，按需实现，具体如下。
+
+### 已实现的禁漫API：
+
+- 登录
+- 搜本
+- 分类 (排行榜)
+- 本子章节详情
+- 图片下载解码
+- 收藏夹
+- 移动端接口加解密
 
 ## 安装教程
 
 * 通过pip官方源安装（推荐，并且更新也是这个命令）
 
   ```shell
-  pip install jmcomic -i https://pypi.org/project --upgrade
+  pip install jmcomic -i https://pypi.org/project -U
   ```
 * 通过源代码安装
 
@@ -47,6 +57,21 @@ jmcomic.download_album('422866')  # 传入要下载的album的id，即可下载
 $ jmcomic 422866
 ```
 
+## 进阶使用
+
+文档网站：[jmcomic.readthedocs.io](https://jmcomic.readthedocs.io/en/latest)
+
+进阶使用可以参考：[jmcomic常用类和方法演示](assets/docs/sources/tutorial/0_demo.md)
+
+下面列出的是一些常用的文档：
+
+* [jmcomic常用类和方法演示](assets/docs/sources/tutorial/0_demo.md)
+* [option配置文件语法（包含插件配置）](./assets/docs/sources/option_file_syntax.md)
+* [GitHub Actions使用教程](./assets/docs/sources/tutorial/1_github_actions.md)
+* [命令行使用教程](assets/docs/sources/tutorial/2_command_line.md)
+* [插件机制](assets/docs/sources/tutorial/6_plugin.md)
+* [下载过滤器机制](assets/docs/sources/tutorial/5_filter.md)
+
 ## 项目特点
 
 - **绕过Cloudflare的反爬虫**
@@ -83,19 +108,6 @@ $ jmcomic 422866
         - `jpg图片合成为一个pdf插件`
         - `导出收藏夹为csv文件插件`
 
-## 进阶使用
-
-进阶使用请查阅文档：[文档](https://jmcomic.readthedocs.io/en/latest)
-
-下面列出一些常用的文档链接：
-
-* [option配置文件语法（包含插件配置）](./assets/docs/sources/option_file_syntax.md)
-* [常用类和方法演示（下载本子、获取实体类、搜索本子）](assets/docs/sources/tutorial/3_demo.md)
-* [命令行使用教程](assets/docs/sources/tutorial/2_command_line.md)
-* [GitHub Actions使用教程](./assets/docs/sources/tutorial/1_github_actions.md)
-* [插件机制](assets/docs/sources/tutorial/6_plugin.md)
-* [下载过滤器机制](assets/docs/sources/tutorial/5_filter.md)
-
 ## 使用小说明
 
 * Python >= 3.7
@@ -103,10 +115,11 @@ $ jmcomic 422866
 
 ## 项目文件夹介绍
 
+* .github：GitHub Actions配置文件
 * assets：存放一些非代码的资源文件
 
-    * config：存放配置文件
     * docs：项目文档
+    * option：存放配置文件
 
 * src：存放源代码
 

{jmcomic-2.5.5 → jmcomic-2.5.7}/src/jmcomic/__init__.py

@@ -2,7 +2,7 @@
 # 被依赖方 <--- 使用方
 # config <--- entity <--- toolkit <--- client <--- option <--- downloader
 
-__version__ = '2.5.5'
+__version__ = '2.5.7'
 
 from .api import *
 from .jm_plugin import *

{jmcomic-2.5.5 → jmcomic-2.5.7}/src/jmcomic/api.py

@@ -1,11 +1,12 @@
 from .jm_downloader import *
 
+__DOWNLOAD_API_RET = Tuple[JmAlbumDetail, JmDownloader]
 
 def download_batch(download_api,
                    jm_id_iter: Union[Iterable, Generator],
                    option=None,
                    downloader=None,
-                   ) -> Set[Tuple[JmAlbumDetail, JmDownloader]]:
+                   ) -> Set[__DOWNLOAD_API_RET]:
     """
     批量下载 album / photo
 
@@ -46,7 +47,7 @@ def download_album(jm_album_id,
                    option=None,
                    downloader=None,
                    callback=None,
-                   ):
+                   ) -> Union[__DOWNLOAD_API_RET, Set[__DOWNLOAD_API_RET]]:
     """
     下载一个本子（album），包含其所有的章节（photo）
 
@@ -100,7 +101,7 @@ def new_downloader(option=None, downloader=None) -> JmDownloader:
     return downloader(option)
 
 
-def create_option(filepath):
+def create_option_by_file(filepath):
     return JmModuleConfig.option_class().from_file(filepath)
 
 
@@ -110,4 +111,14 @@ def create_option_by_env(env_name='JM_OPTION_PATH'):
     filepath = get_env(env_name, None)
     ExceptionTool.require_true(filepath is not None,
                                f'未配置环境变量: {env_name}，请配置为option的文件路径')
-    return create_option(filepath)
+    return create_option_by_file(filepath)
+
+
+def create_option_by_str(text: str, mode=None):
+    if mode is None:
+        mode = PackerUtil.mode_yml
+    data = PackerUtil.unpack_by_str(text, mode)[0]
+    return JmModuleConfig.option_class().construct(data)
+
+
+create_option = create_option_by_file

{jmcomic-2.5.5 → jmcomic-2.5.7}/src/jmcomic/jm_client_impl.py

@@ -79,9 +79,9 @@ class AbstractJmClient(
         """
         if domain_index >= len(self.domain_list):
             return self.fallback(request, url, domain_index, retry_count, **kwargs)
-        
+
         url_backup = url
-        
+
         if url.startswith('/'):
             # path → url
             domain = self.domain_list[domain_index]
@@ -976,10 +976,14 @@ class JmApiClient(AbstractJmClient):
         return cookies
 
 
-class FutureClientProxy(JmcomicClient):
+class PhotoConcurrentFetcherProxy(JmcomicClient):
     """
-    在Client上做了一层线程池封装来实现异步，对外仍然暴露JmcomicClient的接口，可以看作Client的代理。
-    除了使用线程池做异步，还通过加锁和缓存结果，实现同一个请求不会被多个线程发出，减少开销
+    为了解决 JmApiClient.get_photo_detail 方法的排队调用问题，
+    即在访问完photo的接口后，需要另外排队访问获取album和scramble_id的接口。
+
+    这三个接口可以并发请求，这样可以提高效率。
+
+    此Proxy代理了get_photo_detail，实现了并发请求这三个接口，然后组装返回值返回photo。
 
     可通过插件 ClientProxyPlugin 启用本类，配置如下:
     ```yml
@@ -987,10 +991,10 @@ class FutureClientProxy(JmcomicClient):
       after_init:
         - plugin: client_proxy
           kwargs:
-            proxy_client_key: cl_proxy_future
+            proxy_client_key: photo_concurrent_fetcher_proxy
     ```
     """
-    client_key = 'cl_proxy_future'
+    client_key = 'photo_concurrent_fetcher_proxy'
 
     class FutureWrapper:
         def __init__(self, future, after_done_callback):
@@ -1024,16 +1028,15 @@ class FutureClientProxy(JmcomicClient):
             executors = ThreadPoolExecutor(max_workers)
 
         self.executors = executors
-        self.future_dict: Dict[str, FutureClientProxy.FutureWrapper] = {}
+        self.future_dict: Dict[str, PhotoConcurrentFetcherProxy.FutureWrapper] = {}
         from threading import Lock
         self.lock = Lock()
 
     def route_notimpl_method_to_internal_client(self, client):
 
-        impl_methods = str_to_set('''
+        proxy_methods = str_to_set('''
         get_album_detail
         get_photo_detail
-        search
         ''')
 
         # 获取对象的所有属性和方法的名称列表
@@ -1043,7 +1046,7 @@ class FutureClientProxy(JmcomicClient):
             # 判断是否为方法（可调用对象）
             if (not method.startswith('_')
                     and callable(getattr(client, method))
-                    and method not in impl_methods
+                    and method not in proxy_methods
             ):
                 setattr(self, method, getattr(client, method))
 
@@ -1055,15 +1058,19 @@ class FutureClientProxy(JmcomicClient):
 
     def get_future(self, cache_key, task):
         if cache_key in self.future_dict:
+            # cache hit, means that a same task is running
             return self.future_dict[cache_key]
 
         with self.lock:
             if cache_key in self.future_dict:
                 return self.future_dict[cache_key]
 
+            # after future done, remove it from future_dict.
+            # cache depends on self.client instead of self.future_dict
             future = self.FutureWrapper(self.executors.submit(task),
                                         after_done_callback=lambda: self.future_dict.pop(cache_key, None)
                                         )
+
             self.future_dict[cache_key] = future
             return future
 
@@ -1115,8 +1122,3 @@ class FutureClientProxy(JmcomicClient):
             photo.scramble_id = scramble_id
 
         return photo
-
-    def search(self, search_query: str, page: int, main_tag: int, order_by: str, time: str) -> JmSearchPage:
-        cache_key = f'search_query_{search_query}_page_{page}_main_tag_{main_tag}_order_by_{order_by}_time_{time}'
-        future = self.get_future(cache_key, task=lambda: self.client.search(search_query, page, main_tag, order_by, time))
-        return future.result()

{jmcomic-2.5.5 → jmcomic-2.5.7}/src/jmcomic/jm_client_interface.py

@@ -6,8 +6,6 @@ Response Entity
 
 """
 
-DictModel = AdvancedEasyAccessDict
-
 
 class JmResp:
 
@@ -87,11 +85,11 @@ class JmJsonResp(JmResp):
     def json(self) -> Dict:
         try:
             return self.resp.json()
-        except Exception:
-            ExceptionTool.raises_resp('json解析失败', self, JsonResolveFailException)
+        except Exception as e:
+            ExceptionTool.raises_resp(f'json解析失败: {e}', self, JsonResolveFailException)
 
-    def model(self) -> DictModel:
-        return DictModel(self.json())
+    def model(self) -> AdvancedEasyAccessDict:
+        return AdvancedEasyAccessDict(self.json())
 
 
 class JmApiResp(JmJsonResp):
@@ -120,9 +118,9 @@ class JmApiResp(JmJsonResp):
         return loads(self.decoded_data)
 
     @property
-    def model_data(self) -> DictModel:
+    def model_data(self) -> AdvancedEasyAccessDict:
         self.require_success()
-        return DictModel(self.res_data)
+        return AdvancedEasyAccessDict(self.res_data)
 
 
 # album-comment
@@ -469,11 +467,14 @@ class JmcomicClient(
     def of_api_url(self, api_path, domain):
         raise NotImplementedError
 
-    def get_html_domain(self, postman=None):
-        return JmModuleConfig.get_html_domain(postman or self.get_root_postman())
+    def get_html_domain(self):
+        return JmModuleConfig.get_html_domain(self.get_root_postman())
+
+    def get_html_domain_all(self):
+        return JmModuleConfig.get_html_domain_all(self.get_root_postman())
 
-    def get_html_domain_all(self, postman=None):
-        return JmModuleConfig.get_html_domain_all(postman or self.get_root_postman())
+    def get_html_domain_all_via_github(self):
+        return JmModuleConfig.get_html_domain_all_via_github(self.get_root_postman())
 
     # noinspection PyMethodMayBeStatic
     def do_page_iter(self, params: dict, page: int, get_page_method):

{jmcomic-2.5.5 → jmcomic-2.5.7}/src/jmcomic/jm_config.py

@@ -2,8 +2,8 @@ from common import time_stamp, str_to_list, field_cache, ProxyBuilder
 
 
 def default_jm_logging(topic: str, msg: str):
-    from common import format_ts
-    print(f'{format_ts()}:【{topic}】{msg}')
+    from common import format_ts, current_thread
+    print('[{}] [{}]:【{}】{}'.format(format_ts(), current_thread().name, topic, msg))
 
 
 # 禁漫常量
@@ -24,17 +24,18 @@ class JmMagicConstants:
     TIME_MONTH = 'm'
     TIME_ALL = 'a'
 
-    # 全部, 同人, 单本, 短篇, 其他, 韩漫, 美漫, cosplay, 3D
-    # category = ["0", "doujin", "single", "short", "another", "hanman", "meiman", "doujin_cosplay", "3D"]
-    CATEGORY_ALL = '0'
-    CATEGORY_DOUJIN = 'doujin'
-    CATEGORY_SINGLE = 'single'
-    CATEGORY_SHORT = 'short'
-    CATEGORY_ANOTHER = 'another'
-    CATEGORY_HANMAN = 'hanman'
-    CATEGORY_MEIMAN = 'meiman'
-    CATEGORY_DOUJIN_COSPLAY = 'doujin_cosplay'
-    CATEGORY_3D = '3D'
+    # 分类参数API接口的category
+    CATEGORY_ALL = '0'  # 全部
+    CATEGORY_DOUJIN = 'doujin'  # 同人
+    CATEGORY_SINGLE = 'single'  # 单本
+    CATEGORY_SHORT = 'short'  # 短篇
+    CATEGORY_ANOTHER = 'another'  # 其他
+    CATEGORY_HANMAN = 'hanman'  # 韩漫
+    CATEGORY_MEIMAN = 'meiman'  # 美漫
+    CATEGORY_DOUJIN_COSPLAY = 'doujin_cosplay'  # cosplay
+    CATEGORY_3D = '3D'  # 3D
+    CATEGORY_ENGLISH_SITE = 'english_site'  # 英文站
+    CATEGORY_JM_TEAM = '禁漫漢化組'
 
     # 分页大小
     PAGE_SIZE_SEARCH = 80
@@ -52,10 +53,10 @@ class JmMagicConstants:
     APP_TOKEN_SECRET = '18comicAPP'
     APP_TOKEN_SECRET_2 = '18comicAPPContent'
     APP_DATA_SECRET = '185Hcomic3PAPP7R'
-    APP_VERSION = '1.6.6'
+    APP_VERSION = '1.6.7'
     APP_HEADERS_TEMPLATE = {
         'Accept-Encoding': 'gzip',
-        'user-agent': 'Mozilla/5.0 (Linux; Android 9; V1938CT Build/PQ3A.190705.09211555; wv) AppleWebKit/537.36 (KHTML, '
+        'user-agent': 'Mozilla/5.0 (Linux; Android 9; V1938CT Build/PQ3A.190705.11211812; wv) AppleWebKit/537.36 (KHTML, '
                       'like Gecko) Version/4.0 Chrome/91.0.4472.114 Safari/537.36',
     }
 
@@ -81,7 +82,7 @@ class JmModuleConfig:
     # 网站相关
     PROT = "https://"
     JM_REDIRECT_URL = f'{PROT}jm365.work/3YeBdF'  # 永久網域，怕走失的小伙伴收藏起来
-    JM_PUB_URL = f'{PROT}jmcomic.ltd'
+    JM_PUB_URL = f'{PROT}jmcomic-fb.vip'
     JM_CDN_IMAGE_URL_TEMPLATE = PROT + 'cdn-msp.{domain}/media/photos/{photo_id}/{index:05}{suffix}'  # index 从1开始
     JM_IMAGE_SUFFIX = ['.jpg', '.webp', '.png', '.gif']
 
@@ -259,6 +260,41 @@ class JmModuleConfig:
         cls.jm_log('module.html_domain_all', f'获取禁漫网页全部域名: [{resp.url}] → {domain_list}')
         return domain_list
 
+    @classmethod
+    def get_html_domain_all_via_github(cls,
+                                       postman=None,
+                                       template='https://jmcmomic.github.io/go/{}.html',
+                                       index_range=(300, 309)
+                                       ):
+        """
+        通过禁漫官方的github号的repo获取最新的禁漫域名
+        https://github.com/jmcmomic/jmcmomic.github.io
+        """
+        postman = postman or cls.new_postman(headers={
+            'authority': 'github.com',
+            'user-agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 '
+                          'Safari/537.36'
+        })
+        domain_set = set()
+
+        def fetch_domain(url):
+            resp = postman.get(url, allow_redirects=False)
+            text = resp.text
+            from .jm_toolkit import JmcomicText
+            for domain in JmcomicText.analyse_jm_pub_html(text):
+                if domain.startswith('jm365'):
+                    continue
+                domain_set.add(domain)
+
+        from common import multi_thread_launcher
+
+        multi_thread_launcher(
+            iter_objs=[template.format(i) for i in range(*index_range)],
+            apply_each_obj_func=fetch_domain,
+        )
+
+        return domain_set
+
     @classmethod
     def new_html_headers(cls, domain='18comic.vip'):
         """

{jmcomic-2.5.5 → jmcomic-2.5.7}/src/jmcomic/jm_downloader.py

@@ -50,8 +50,10 @@ class JmDownloader(DownloadCallback):
 
     def __init__(self, option: JmOption) -> None:
         self.option = option
-        # 收集所有下载的image，为plugin提供数据
-        self.all_downloaded: Dict[JmAlbumDetail, Dict[JmPhotoDetail, List[Tuple[str, JmImageDetail]]]] = {}
+        # 下载成功的记录dict
+        self.download_success_dict: Dict[JmAlbumDetail, Dict[JmPhotoDetail, List[Tuple[str, JmImageDetail]]]] = {}
+        # 下载失败的记录list
+        self.download_failed_list: List[Tuple[JmImageDetail, BaseException]] = []
 
     def download_album(self, album_id):
         client = self.client_for_album(album_id)
@@ -101,11 +103,21 @@ class JmDownloader(DownloadCallback):
         if use_cache is True and image.is_exists:
             return
 
-        client.download_by_image_detail(
-            image,
-            img_save_path,
-            decode_image=decode_image,
-        )
+        e = None
+        try:
+            client.download_by_image_detail(
+                image,
+                img_save_path,
+                decode_image=decode_image,
+            )
+        except BaseException as e:
+            jm_log('image.failed', f'图片下载失败: [{image.download_url}], 异常: {e}')
+            # 保存失败记录
+            self.download_failed_list.append((image, e))
+
+        if e is not None:
+            raise e
+
         self.after_image(image, img_save_path)
 
     # noinspection PyMethodMayBeStatic
@@ -164,16 +176,38 @@ class JmDownloader(DownloadCallback):
         """
         return self.option.build_jm_client()
 
+    @property
+    def all_success(self) -> bool:
+        """
+        是否成功下载了全部图片
+
+        该属性需要等到downloader的全部download_xxx方法完成后才有意义。
+
+        注意！如果使用了filter机制，例如通过filter只下载3张图片，那么all_success也会为False
+        """
+        if len(self.download_failed_list) != 0:
+            return False
+
+        for album, photo_dict in self.download_success_dict.items():
+            if len(album) != len(photo_dict):
+                return False
+
+            for photo, image_list in photo_dict.items():
+                if len(photo) != len(image_list):
+                    return False
+
+        return True
+
     # 下面是回调方法
 
     def before_album(self, album: JmAlbumDetail):
         super().before_album(album)
-        self.all_downloaded.setdefault(album, {})
-
-    def before_photo(self, photo: JmPhotoDetail):
-        super().before_photo(photo)
-        self.all_downloaded.setdefault(photo.from_album, {})
-        self.all_downloaded[photo.from_album].setdefault(photo, [])
+        self.download_success_dict.setdefault(album, {})
+        self.option.call_all_plugin(
+            'before_album',
+            album=album,
+            downloader=self,
+        )
 
     def after_album(self, album: JmAlbumDetail):
         super().after_album(album)
@@ -183,6 +217,16 @@ class JmDownloader(DownloadCallback):
             downloader=self,
         )
 
+    def before_photo(self, photo: JmPhotoDetail):
+        super().before_photo(photo)
+        self.download_success_dict.setdefault(photo.from_album, {})
+        self.download_success_dict[photo.from_album].setdefault(photo, [])
+        self.option.call_all_plugin(
+            'before_photo',
+            photo=photo,
+            downloader=self,
+        )
+
     def after_photo(self, photo: JmPhotoDetail):
         super().after_photo(photo)
         self.option.call_all_plugin(
@@ -191,12 +235,25 @@ class JmDownloader(DownloadCallback):
             downloader=self,
         )
 
+    def before_image(self, image: JmImageDetail, img_save_path):
+        super().before_image(image, img_save_path)
+        self.option.call_all_plugin(
+            'before_image',
+            image=image,
+            downloader=self,
+        )
+
     def after_image(self, image: JmImageDetail, img_save_path):
         super().after_image(image, img_save_path)
         photo = image.from_photo
         album = photo.from_album
 
-        self.all_downloaded.get(album).get(photo).append((img_save_path, image))
+        self.download_success_dict.get(album).get(photo).append((img_save_path, image))
+        self.option.call_all_plugin(
+            'after_image',
+            image=image,
+            downloader=self,
+        )
 
     # 下面是对with语法的支持
 
@@ -219,28 +276,23 @@ class JmDownloader(DownloadCallback):
 
 class DoNotDownloadImage(JmDownloader):
     """
-    本类仅用于测试
-
-    用法：
-
-    JmModuleConfig.CLASS_DOWNLOADER = DoNotDownloadImage
+    不会下载任何图片的Downloader，用作测试
     """
 
     def download_by_image_detail(self, image: JmImageDetail, client: JmcomicClient):
         # ensure make dir
         self.option.decide_image_filepath(image)
-        pass
 
 
 class JustDownloadSpecificCountImage(JmDownloader):
+    """
+    只下载特定数量图片的Downloader，用作测试
+    """
     from threading import Lock
 
     count_lock = Lock()
     count = 0
 
-    def __init__(self, option: JmOption) -> None:
-        super().__init__(option)
-
     def download_by_image_detail(self, image: JmImageDetail, client: JmcomicClient):
         # ensure make dir
         self.option.decide_image_filepath(image)

{jmcomic-2.5.5 → jmcomic-2.5.7}/src/jmcomic/jm_entity.py

@@ -91,17 +91,17 @@ class DetailEntity(JmBaseEntity, IndexedEntity):
         """
         authoroname = author + oname
 
-        比较好识别的一种本子名称方式
+        个人认为识别度比较高的本子名称，一眼看去就能获取到本子的关键信息
 
-        具体格式: f'【author】{oname}'
+        具体格式: '【author】oname'
 
         示例:
 
-        原本子名：喂我吃吧 老師! [欶瀾漢化組] [BLVEFO9] たべさせて、せんせい! (ブルーアーカイブ) [中國翻譯] [無修正]
+        Pname：喂我吃吧 老師! [欶瀾漢化組] [BLVEFO9] たべさせて、せんせい! (ブルーアーカイブ) [中國翻譯] [無修正]
 
-        authoroname：【BLVEFO9】喂我吃吧 老師!
+        Pauthoroname：【BLVEFO9】喂我吃吧 老師!
 
-        :return: 返回作者名+作品原名，格式为: '【author】{oname}'
+        :return: 返回作者名+本子原始名称，格式为: '【author】oname'
         """
         return f'【{self.author}】{self.oname}'
 
@@ -109,12 +109,16 @@ class DetailEntity(JmBaseEntity, IndexedEntity):
     def idoname(self):
         """
         类似 authoroname
-        :return: '[id] {oname}'
+        
+        :return: '[id] oname'
         """
         return f'[{self.id}] {self.oname}'
 
     def __str__(self):
-        return f'{self.__class__.__name__}({self.id}-{self.title})'
+        return f'{self.__class__.__name__}' \
+               '{' \
+               f'{self.id}: {self.title}'\
+               '}'
 
     @classmethod
     def __alias__(cls):

{jmcomic-2.5.5 → jmcomic-2.5.7}/src/jmcomic/jm_option.py

@@ -105,13 +105,11 @@ class DirRule:
         解析下载路径dsl，得到一个路径规则解析列表
         """
 
-        if '_' not in rule_dsl and rule_dsl != 'Bd':
-            ExceptionTool.raises(f'不支持的dsl: "{rule_dsl}"')
-
-        rule_list = rule_dsl.split('_')
+        rule_list = self.split_rule_dsl(rule_dsl)
         solver_ls: List[DirRule.RuleSolver] = []
 
         for rule in rule_list:
+            rule = rule.strip()
             if rule == 'Bd':
                 solver_ls.append((0, lambda _: base_dir, 'Bd'))
                 continue
@@ -124,6 +122,19 @@ class DirRule:
 
         return solver_ls
 
+    # noinspection PyMethodMayBeStatic
+    def split_rule_dsl(self, rule_dsl: str) -> List[str]:
+        if rule_dsl == 'Bd':
+            return [rule_dsl]
+
+        if '/' in rule_dsl:
+            return rule_dsl.split('/')
+
+        if '_' in rule_dsl:
+            return rule_dsl.split('_')
+
+        ExceptionTool.raises(f'不支持的rule配置: "{rule_dsl}"')
+
     @classmethod
     def get_rule_solver(cls, rule: str) -> Optional[RuleSolver]:
         # 查找缓存
@@ -181,6 +192,7 @@ class JmOption:
                  client: Dict,
                  plugins: Dict,
                  filepath=None,
+                 call_after_init_plugin=True,
                  ):
         # 路径规则配置
         self.dir_rule = DirRule(**dir_rule)
@@ -196,7 +208,21 @@ class JmOption:
         # 需要主线程等待完成的插件
         self.need_wait_plugins = []
 
-        self.call_all_plugin('after_init', safe=True)
+        if call_after_init_plugin:
+            self.call_all_plugin('after_init', safe=True)
+
+    def copy_option(self):
+        return self.__class__(
+            dir_rule={
+                'rule': self.dir_rule.rule_dsl,
+                'base_dir': self.dir_rule.base_dir,
+            },
+            download=self.download.src_dict,
+            client=self.client.src_dict,
+            plugins=self.plugins.src_dict,
+            filepath=self.filepath,
+            call_after_init_plugin=False
+        )
 
     """
     下面是decide系列方法，为了支持重写和增加程序动态性。

{jmcomic-2.5.5 → jmcomic-2.5.7}/src/jmcomic/jm_plugin.py

@@ -298,7 +298,7 @@ class ZipPlugin(JmOptionPlugin):
 
         # 原文件夹 -> zip文件
         dir_zip_dict: Dict[str, Optional[str]] = {}
-        photo_dict = downloader.all_downloaded[album]
+        photo_dict = downloader.download_success_dict[album]
 
         if level == 'album':
             zip_path = self.get_zip_path(album, None, filename_rule, suffix, zip_dir)
@@ -383,7 +383,7 @@ class ZipPlugin(JmOptionPlugin):
         dirs = sorted(dir_zip_dict.keys(), reverse=True)
         image_paths = [
             path
-            for photo_dict in self.downloader.all_downloaded.values()
+            for photo_dict in self.downloader.download_success_dict.values()
             for image_list in photo_dict.values()
             for path, image in image_list
         ]
@@ -752,7 +752,7 @@ class ConvertJpgToPdfPlugin(JmOptionPlugin):
 
             paths = [
                 path
-                for path, image in downloader.all_downloaded[photo.from_album][photo]
+                for path, image in downloader.download_success_dict[photo.from_album][photo]
             ]
 
             paths.append(self.option.decide_image_save_dir(photo, ensure_exists=False))
@@ -814,8 +814,6 @@ class JmServerPlugin(JmOptionPlugin):
             if self.running is True:
                 return
 
-            self.running = True
-
             # 服务器的代码位于一个独立库：plugin_jm_server，需要独立安装
             # 源代码仓库：https://github.com/hect0x7/plugin-jm-server
             try:
@@ -842,6 +840,7 @@ class JmServerPlugin(JmOptionPlugin):
                     # 不是主线程，return
                     return self.warning_wrong_usage_of_debug()
                 else:
+                    self.running = True
                     # 是主线程，启动服务器
                     blocking_run_server()
 
@@ -849,6 +848,7 @@ class JmServerPlugin(JmOptionPlugin):
                 # 非debug模式，开新线程启动
                 threading.Thread(target=blocking_run_server, daemon=True).start()
                 atexit_register(self.wait_server_stop)
+                self.running = True
 
     def warning_wrong_usage_of_debug(self):
         self.log('注意！当配置debug=True时，请确保当前插件是在主线程中被调用。\n'

{jmcomic-2.5.5 → jmcomic-2.5.7}/src/jmcomic/jm_toolkit.py

@@ -357,17 +357,16 @@ class JmPageTool:
     # 用来缩减html的长度
     pattern_html_search_shorten_for = compile(r'<div class="well well-sm">([\s\S]*)<div class="row">')
 
-    # 用来提取搜索页面的的album的信息
+    # 用来提取搜索页面的album的信息
     pattern_html_search_album_info_list = compile(
         r'<a href="/album/(\d+)/[\s\S]*?title="(.*?)"([\s\S]*?)<div class="title-truncate tags .*>([\s\S]*?)</div>'
     )
 
-    # 用来提取分类页面的的album的信息
+    # 用来提取分类页面的album的信息
     pattern_html_category_album_info_list = compile(
-        r'<a href="/album/(\d+)/[^>]*>[\s\S]*?title="(.*?)"[^>]*>'
-        r'\n</a>\n'
-        r'<div class="label-loveicon">'
-        r'([\s\S]*?)'
+        r'<a href="/album/(\d+)/[^>]*>[^>]*?'
+        r'title="(.*?)"[^>]*>[ \n]*</a>[ \n]*'
+        r'<div class="label-loveicon">([\s\S]*?)'
         r'<div class="clearfix">'
     )
 
@@ -473,7 +472,7 @@ class JmPageTool:
         return JmFavoritePage(content, folder_list, total)
 
     @classmethod
-    def parse_api_to_search_page(cls, data: DictModel) -> JmSearchPage:
+    def parse_api_to_search_page(cls, data: AdvancedEasyAccessDict) -> JmSearchPage:
         """
         model_data: {
           "search_query": "MANA",
@@ -502,7 +501,7 @@ class JmPageTool:
         return JmSearchPage(content, total)
 
     @classmethod
-    def parse_api_to_favorite_page(cls, data: DictModel) -> JmFavoritePage:
+    def parse_api_to_favorite_page(cls, data: AdvancedEasyAccessDict) -> JmFavoritePage:
         """
         {
           "list": [
@@ -547,7 +546,7 @@ class JmPageTool:
 
     @classmethod
     def adapt_content(cls, content):
-        def adapt_item(item: DictModel):
+        def adapt_item(item: AdvancedEasyAccessDict):
             item: dict = item.src_dict
             item.setdefault('tags', [])
             return item
@@ -674,7 +673,7 @@ class JmApiAdaptTool:
         series = data['series']
         episode_list = []
         for chapter in series:
-            chapter = DictModel(chapter)
+            chapter = AdvancedEasyAccessDict(chapter)
             # photo_id, photo_index, photo_title, photo_pub_date
             episode_list.append(
                 (chapter.id, chapter.sort, chapter.name, None)
@@ -689,7 +688,7 @@ class JmApiAdaptTool:
         sort = 1
         series: list = data['series']  # series中的sort从1开始
         for chapter in series:
-            chapter = DictModel(chapter)
+            chapter = AdvancedEasyAccessDict(chapter)
             if int(chapter.id) == int(data['id']):
                 sort = chapter.sort
                 break
@@ -755,23 +754,34 @@ class JmImageTool:
 
         # 创建新的解密图片
         img_decode = Image.new("RGB", (w, h))
-        remainder = h % num
-        copyW = w
+        over = h % num
         for i in range(num):
-            copyH = math.floor(h / num)
-            py = copyH * i
-            y = h - (copyH * (i + 1)) - remainder
+            move = math.floor(h / num)
+            y_src = h - (move * (i + 1)) - over
+            y_dst = move * i
 
             if i == 0:
-                copyH += remainder
+                move += over
             else:
-                py += remainder
+                y_dst += over
 
             img_decode.paste(
-                img_src.crop((0, y, copyW, y + copyH)),
-                (0, py, copyW, py + copyH)
+                img_src.crop((
+                    0, y_src,
+                    w, y_src + move
+                )),
+                (
+                    0, y_dst,
+                    w, y_dst + move
+                )
             )
 
+            # save every step result
+            # cls.save_image(img_decode, change_file_name(
+            #     decoded_save_path,
+            #     f'{of_file_name(decoded_save_path, trim_suffix=True)}_{i}{of_file_suffix(decoded_save_path)}'
+            # ))
+
         # 保存到新的解密文件
         cls.save_image(img_decode, decoded_save_path)
 
@@ -867,7 +877,7 @@ class JmCryptoTool:
         """
         解密接口返回值
 
-        :param data: data = resp.json()['data]
+        :param data: resp.json()['data']
         :param ts: 时间戳
         :param secret: 密钥
         :return: json格式的字符串

{jmcomic-2.5.5 → jmcomic-2.5.7/src/jmcomic.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: jmcomic
-Version: 2.5.5
+Version: 2.5.7
 Summary: Python API For JMComic (禁漫天堂)
 Home-page: https://github.com/hect0x7/JMComic-Crawler-Python
 Author: hect0x7
@@ -42,16 +42,26 @@ Requires-Dist: pycryptodome
 
 本项目的核心功能是下载本子，基于此，设计了一套方便使用、便于扩展，能满足一些特殊下载需求的框架。
 
-除了下载功能以外，也实现了其他的一些禁漫接口，例如登录、搜索、收藏夹、分类、排行榜等等，按需实现。
+目前核心功能实现较为稳定，项目也处于维护阶段。
 
-目前核心功能实现较为稳定，项目也处于维护阶段（因为禁漫接口经常变动，需要经常维护）。
+除了下载功能以外，也实现了其他的一些禁漫接口，按需实现，具体如下。
+
+### 已实现的禁漫API：
+
+- 登录
+- 搜本
+- 分类 (排行榜)
+- 本子章节详情
+- 图片下载解码
+- 收藏夹
+- 移动端接口加解密
 
 ## 安装教程
 
 * 通过pip官方源安装（推荐，并且更新也是这个命令）
 
   ```shell
-  pip install jmcomic -i https://pypi.org/project --upgrade
+  pip install jmcomic -i https://pypi.org/project -U
   ```
 * 通过源代码安装
 
@@ -75,6 +85,21 @@ jmcomic.download_album('422866')  # 传入要下载的album的id，即可下载
 $ jmcomic 422866
 ```
 
+## 进阶使用
+
+文档网站：[jmcomic.readthedocs.io](https://jmcomic.readthedocs.io/en/latest)
+
+进阶使用可以参考：[jmcomic常用类和方法演示](assets/docs/sources/tutorial/0_demo.md)
+
+下面列出的是一些常用的文档：
+
+* [jmcomic常用类和方法演示](assets/docs/sources/tutorial/0_demo.md)
+* [option配置文件语法（包含插件配置）](./assets/docs/sources/option_file_syntax.md)
+* [GitHub Actions使用教程](./assets/docs/sources/tutorial/1_github_actions.md)
+* [命令行使用教程](assets/docs/sources/tutorial/2_command_line.md)
+* [插件机制](assets/docs/sources/tutorial/6_plugin.md)
+* [下载过滤器机制](assets/docs/sources/tutorial/5_filter.md)
+
 ## 项目特点
 
 - **绕过Cloudflare的反爬虫**
@@ -111,19 +136,6 @@ $ jmcomic 422866
         - `jpg图片合成为一个pdf插件`
         - `导出收藏夹为csv文件插件`
 
-## 进阶使用
-
-进阶使用请查阅文档：[文档](https://jmcomic.readthedocs.io/en/latest)
-
-下面列出一些常用的文档链接：
-
-* [option配置文件语法（包含插件配置）](./assets/docs/sources/option_file_syntax.md)
-* [常用类和方法演示（下载本子、获取实体类、搜索本子）](assets/docs/sources/tutorial/3_demo.md)
-* [命令行使用教程](assets/docs/sources/tutorial/2_command_line.md)
-* [GitHub Actions使用教程](./assets/docs/sources/tutorial/1_github_actions.md)
-* [插件机制](assets/docs/sources/tutorial/6_plugin.md)
-* [下载过滤器机制](assets/docs/sources/tutorial/5_filter.md)
-
 ## 使用小说明
 
 * Python >= 3.7
@@ -131,10 +143,11 @@ $ jmcomic 422866
 
 ## 项目文件夹介绍
 
+* .github：GitHub Actions配置文件
 * assets：存放一些非代码的资源文件
 
-    * config：存放配置文件
     * docs：项目文档
+    * option：存放配置文件
 
 * src：存放源代码