jmcomic 2.4.7__py3-none-any.whl → 2.4.9__py3-none-any.whl

jmcomic/__init__.py

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

jmcomic/jm_client_impl.py

@@ -309,7 +309,28 @@ class JmHtmlClient(AbstractJmClient):
             album = JmcomicText.analyse_jm_album_html(resp.text)
             return JmSearchPage.wrap_single_album(album)
         else:
-            return JmcomicText.analyse_jm_search_html(resp.text)
+            return JmPageTool.parse_html_to_search_page(resp.text)
+
+    def categories_filter(self,
+                          page: int,
+                          time: str,
+                          category: str,
+                          order_by: str,
+                          ) -> JmCategoryPage:
+        params = {
+            'page': page,
+            'o': order_by,
+            't': time,
+        }
+
+        url = f'/albums/' + (category if category != JmMagicConstants.CATEGORY_ALL else '')
+
+        resp = self.get_jm_html(
+            self.append_params_to_url(url, params),
+            allow_redirects=True,
+        )
+
+        return JmPageTool.parse_html_to_category_page(resp.text)
 
     # -- 帐号管理 --
 
@@ -525,6 +546,7 @@ class JmApiClient(AbstractJmClient):
     func_to_cache = ['search', 'fetch_detail_entity']
 
     API_SEARCH = '/search'
+    API_CATEGORIES_FILTER = '/categories/filter'
     API_ALBUM = '/album'
     API_CHAPTER = '/chapter'
     API_SCRAMBLE = '/chapter_view_template'
@@ -561,6 +583,26 @@ class JmApiClient(AbstractJmClient):
 
         return JmPageTool.parse_api_to_search_page(data)
 
+    def categories_filter(self,
+                          page: int,
+                          time: str,
+                          category: str,
+                          order_by: str,
+                          ):
+        # o: mv, mv_m, mv_w, mv_t
+        o = f'{order_by}_{time}' if time != JmMagicConstants.TIME_ALL else order_by
+
+        params = {
+            'page': page,
+            'order': '',  # 该参数为空
+            'c': category,
+            'o': o,
+        }
+
+        resp = self.req_api(self.append_params_to_url(self.API_CATEGORIES_FILTER, params))
+
+        return JmPageTool.parse_api_to_search_page(resp.model_data)
+
     def get_album_detail(self, album_id) -> JmAlbumDetail:
         return self.fetch_detail_entity(album_id,
                                         JmModuleConfig.album_class(),

jmcomic/jm_client_interface.py

@@ -84,6 +84,7 @@ class JmImageResp(JmResp):
 
 class JmJsonResp(JmResp):
 
+    @field_cache()
     def json(self) -> Dict:
         return self.resp.json()
 
@@ -128,9 +129,6 @@ class JmAlbumCommentResp(JmJsonResp):
     def is_success(self) -> bool:
         return super().is_success and self.json()['err'] is False
 
-    def json(self) -> Dict:
-        return self.resp.json()
-
 
 """
 
@@ -151,15 +149,6 @@ class JmDetailClient:
                          ) -> JmPhotoDetail:
         raise NotImplementedError
 
-    def of_api_url(self, api_path, domain):
-        raise NotImplementedError
-
-    def set_cache_dict(self, cache_dict: Optional[Dict]):
-        raise NotImplementedError
-
-    def get_cache_dict(self) -> Optional[Dict]:
-        raise NotImplementedError
-
     def check_photo(self, photo: JmPhotoDetail):
         """
         photo来源有两种:
@@ -381,12 +370,78 @@ class JmSearchAlbumClient:
         return self.search(search_query, page, 4, order_by, time)
 
 
+class JmCategoryClient:
+    """
+    该接口可以看作是对全体禁漫本子的排行，热门排行的功能也派生于此
+
+    月排行 = 分类【时间=月，排序=观看】
+    周排行 = 分类【时间=周，排序=观看】
+    日排行 = 分类【时间=周，排序=观看】
+    """
+
+    def categories_filter(self,
+                          page: int,
+                          time: str,
+                          category: str,
+                          order_by: str,
+                          ) -> JmCategoryPage:
+        """
+        分类
+
+        :param page: 页码
+        :param time: 时间范围，默认是全部时间
+        :param category: 类别，默认是最新，即显示最新的禁漫本子
+        :param order_by: 排序方式，默认是观看数
+        """
+        raise NotImplementedError
+
+    def month_ranking(self,
+                      page: int,
+                      category: str = JmMagicConstants.CATEGORY_ALL,
+                      ):
+        """
+        月排行 = 分类【时间=月，排序=观看】
+        """
+        return self.categories_filter(page,
+                                      JmMagicConstants.TIME_MONTH,
+                                      category,
+                                      JmMagicConstants.ORDER_BY_VIEW,
+                                      )
+
+    def week_ranking(self,
+                     page: int,
+                     category: str = JmMagicConstants.CATEGORY_ALL,
+                     ):
+        """
+        周排行 = 分类【时间=周，排序=观看】
+        """
+        return self.categories_filter(page,
+                                      JmMagicConstants.TIME_WEEK,
+                                      category,
+                                      JmMagicConstants.ORDER_BY_VIEW,
+                                      )
+
+    def day_ranking(self,
+                    page: int,
+                    category: str = JmMagicConstants.CATEGORY_ALL,
+                    ):
+        """
+        日排行 = 分类【时间=日，排序=观看】
+        """
+        return self.categories_filter(page,
+                                      JmMagicConstants.TIME_TODAY,
+                                      category,
+                                      JmMagicConstants.ORDER_BY_VIEW,
+                                      )
+
+
 # noinspection PyAbstractClass
 class JmcomicClient(
     JmImageClient,
     JmDetailClient,
     JmUserClient,
     JmSearchAlbumClient,
+    JmCategoryClient,
     Postman,
 ):
     client_key: None
@@ -403,6 +458,15 @@ class JmcomicClient(
         """
         raise NotImplementedError
 
+    def set_cache_dict(self, cache_dict: Optional[Dict]):
+        raise NotImplementedError
+
+    def get_cache_dict(self) -> Optional[Dict]:
+        raise NotImplementedError
+
+    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())
 
@@ -487,3 +551,20 @@ class JmcomicClient(
         }
 
         yield from self.do_page_iter(params, page, self.search)
+
+    def categories_filter_gen(self,
+                              page: int = 1,
+                              time: str = JmMagicConstants.TIME_ALL,
+                              category: str = JmMagicConstants.CATEGORY_ALL,
+                              order_by: str = JmMagicConstants.ORDER_BY_LATEST,
+                              ) -> Generator[JmCategoryPage, Dict, None]:
+        """
+        见 search_gen
+        """
+        params = {
+            'time': time,
+            'category': category,
+            'order_by': order_by,
+        }
+
+        yield from self.do_page_iter(params, page, self.categories_filter)

jmcomic/jm_config.py

@@ -22,12 +22,28 @@ class JmMagicConstants:
     ORDER_BY_PICTURE = 'mp'
     ORDER_BY_LIKE = 'tf'
 
+    ORDER_MONTH_RANKING = 'mv_m'
+    ORDER_WEEK_RANKING = 'mv_w'
+    ORDER_DAY_RANKING = 'mv_t'
+
     # 搜索参数-时间段
     TIME_TODAY = 't'
     TIME_WEEK = 'w'
     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'
+
     # 分页大小
     PAGE_SIZE_SEARCH = 80
     PAGE_SIZE_FAVORITE = 20

jmcomic/jm_entity.py

@@ -617,6 +617,9 @@ class JmSearchPage(JmPageContent):
         return page
 
 
+JmCategoryPage = JmSearchPage
+
+
 class JmFavoritePage(JmPageContent):
 
     def __init__(self, content, folder_list, total):

jmcomic/jm_option.py

@@ -220,6 +220,7 @@ class JmOption:
                 break
 
         from os.path import join
+        # noinspection PyTypeChecker
         return join(*dir_layer)
 
     # noinspection PyMethodMayBeStatic
@@ -293,6 +294,7 @@ class JmOption:
 
         # version
         version = dic.pop('version', None)
+        # noinspection PyTypeChecker
         if version is not None and float(version) >= float(JmModuleConfig.JM_OPTION_VER):
             # 版本号更高，跳过兼容代码
             return cls(**dic)

jmcomic/jm_toolkit.py

@@ -116,10 +116,6 @@ class JmcomicText:
             JmModuleConfig.album_class()
         )
 
-    @classmethod
-    def analyse_jm_search_html(cls, html: str) -> JmSearchPage:
-        return JmPageTool.parse_html_to_search_page(html)
-
     @classmethod
     def reflect_new_instance(cls, html: str, cls_field_prefix: str, clazz: type):
 
@@ -347,6 +343,15 @@ class JmPageTool:
         r'(<a[\s\S]*?) </div>'
     )
 
+    # 用来提取分类页面的的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'<div class="clearfix">'
+    )
+
     # 用来查找tag列表
     pattern_html_search_tag_list = compile(r'<a[^>]*?>(.*?)</a>')
 
@@ -405,6 +410,26 @@ class JmPageTool:
 
         return JmSearchPage(content, total)
 
+    @classmethod
+    def parse_html_to_category_page(cls, html: str) -> JmSearchPage:
+        # 3. 提取结果
+        content = []
+        total = int(PatternTool.match_or_default(html, *cls.pattern_html_search_total))
+
+        album_info_list = cls.pattern_html_category_album_info_list.findall(html)
+
+        for (album_id, title, tag_text) in album_info_list:
+            tag_list = cls.pattern_html_search_tag_list.findall(tag_text)
+            content.append((
+                album_id, {
+                    'name': title,  # 改成name是为了兼容 parse_api_resp_to_page
+                    'tag_list': tag_list
+                }
+            ))
+
+        return JmSearchPage(content, total)
+
+
     @classmethod
     def parse_html_to_favorite_page(cls, html: str) -> JmFavoritePage:
         total = int(PatternTool.require_match(

{jmcomic-2.4.7.dist-info → jmcomic-2.4.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: jmcomic
-Version: 2.4.7
+Version: 2.4.9
 Summary: Python API For JMComic (禁漫天堂)
 Home-page: https://github.com/hect0x7/JMComic-Crawler-Python
 Author: hect0x7
@@ -37,7 +37,7 @@ Requires-Dist: pycryptodome
 
 本项目的核心功能是下载本子，基于此，设计了一套方便使用、便于扩展，能满足一些特殊下载需求的框架。
 
-除了下载功能以外，也实现了其他的一些禁漫接口，例如登录、搜索、收藏夹等等，按需实现。
+除了下载功能以外，也实现了其他的一些禁漫接口，例如登录、搜索、收藏夹、分类、排行榜等等，按需实现。
 
 目前核心功能实现较为稳定，项目也处于维护阶段（因为禁漫接口经常变动，需要经常维护）。
 

jmcomic-2.4.9.dist-info/RECORD

@@ -0,0 +1,17 @@
+jmcomic/__init__.py,sha256=lU1wXRbpzgrJ3bBjL0IUiK-cPIqLEutUVaIRdd2EMfg,878
+jmcomic/api.py,sha256=yukYd5NCYYxP8K2Gj72iXu7vg9PHgaOvakQzQxEOcO8,2518
+jmcomic/cl.py,sha256=PBSh0JndNFZw3B7WJPj5Y8SeFdKzHE00jIwYo9An-K0,3475
+jmcomic/jm_client_impl.py,sha256=SDezH8AM9HzxqmE87zskGCB1Ms6khCUeWrA1G2xBsSw,35431
+jmcomic/jm_client_interface.py,sha256=GpH-laoRYT6xn7MWgS0hgDZfF2-7t9AMzC5jGwuEqis,17083
+jmcomic/jm_config.py,sha256=IZEK8o2AN2_NZW4SkofiRIUT6X7ZIH6StGcjZZV-rTQ,13668
+jmcomic/jm_downloader.py,sha256=E1M9CS9bYEHWe8SEsdaq_0c3zxQghpkN_4QLZiZ-o1g,7324
+jmcomic/jm_entity.py,sha256=CkzYIB_fUxwsAFax6xrZio3qun5l-4bcUuWcWd9mbZE,18703
+jmcomic/jm_option.py,sha256=htnAAk8zkpXQQDMpFvShvpE-V4VPVrHu9qgUYgbluKk,20019
+jmcomic/jm_plugin.py,sha256=ftL0iZbc1GWk75n6ZuP1j-7MaOTqK1mQA04E-rkNEPs,16198
+jmcomic/jm_toolkit.py,sha256=8zjK4ciTCds4R6yshxF8PLmp9c31qNUFJv-wVUa24_Y,29750
+jmcomic-2.4.9.dist-info/LICENSE,sha256=kz4coTxZxuGxisK3W00tjK57Zh3RcMGq-EnbXrK7-xA,1064
+jmcomic-2.4.9.dist-info/METADATA,sha256=VyhiTq5e4-6U8DlI__eQzYT18bv0fLDqtH-17oYBPIo,5491
+jmcomic-2.4.9.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+jmcomic-2.4.9.dist-info/entry_points.txt,sha256=tRbQltaGSBjejI0c9jYt-4SXQMd5nSDHcMvHmuTy4ow,44
+jmcomic-2.4.9.dist-info/top_level.txt,sha256=puvVMFYJqIbd6NOTMEvOyugMTT8woBfSQyxEBan3zY4,8
+jmcomic-2.4.9.dist-info/RECORD,,

jmcomic-2.4.7.dist-info/RECORD

@@ -1,17 +0,0 @@
-jmcomic/__init__.py,sha256=BYuf4ruBex9ljlTlGN0xXdUcus_eKTXS7ZLOqkgKJXM,878
-jmcomic/api.py,sha256=yukYd5NCYYxP8K2Gj72iXu7vg9PHgaOvakQzQxEOcO8,2518
-jmcomic/cl.py,sha256=PBSh0JndNFZw3B7WJPj5Y8SeFdKzHE00jIwYo9An-K0,3475
-jmcomic/jm_client_impl.py,sha256=uG4LIZZdz6zAePkgTq80n5pNV-G069cXiSgBRg_dAO8,34106
-jmcomic/jm_client_interface.py,sha256=xaPtHxdzGYmzsnRfq-fkH__hiARNUtxtjtEzD-SwbPg,14120
-jmcomic/jm_config.py,sha256=88YEZyzxBWJcKmbS6sYhfQ4ZoO6kb7ghMYOgUYBfuWg,13110
-jmcomic/jm_downloader.py,sha256=E1M9CS9bYEHWe8SEsdaq_0c3zxQghpkN_4QLZiZ-o1g,7324
-jmcomic/jm_entity.py,sha256=u5aJhIt2Q21re6moXfS0drVBmIJKjNQnRI2lVvbZ-nY,18671
-jmcomic/jm_option.py,sha256=-_Obz2m_roZOAkb1hw62TKDeKIy_iow99z65fXdvX7I,19945
-jmcomic/jm_plugin.py,sha256=ftL0iZbc1GWk75n6ZuP1j-7MaOTqK1mQA04E-rkNEPs,16198
-jmcomic/jm_toolkit.py,sha256=I67hbdHBLVsmi8RFanKy2sOIaMDU5GlOzi7AxfK_8vA,28892
-jmcomic-2.4.7.dist-info/LICENSE,sha256=kz4coTxZxuGxisK3W00tjK57Zh3RcMGq-EnbXrK7-xA,1064
-jmcomic-2.4.7.dist-info/METADATA,sha256=fqfirQgCGD85-12Vhf5hSo71eG3A3DSSSOjzzbi96Nc,5470
-jmcomic-2.4.7.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-jmcomic-2.4.7.dist-info/entry_points.txt,sha256=tRbQltaGSBjejI0c9jYt-4SXQMd5nSDHcMvHmuTy4ow,44
-jmcomic-2.4.7.dist-info/top_level.txt,sha256=puvVMFYJqIbd6NOTMEvOyugMTT8woBfSQyxEBan3zY4,8
-jmcomic-2.4.7.dist-info/RECORD,,