pyxllib 0.3.197__py3-none-any.whl → 0.3.200__py3-none-any.whl

pyxllib/ext/drissionlib.py

@@ -1,277 +1,277 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-# @Author : 陈坤泽
-# @Email  : 877362867@qq.com
-# @Date   : 2024/04/12
-
-import re
-from urllib.parse import unquote
-import tempfile
-import time
-from urllib.parse import urlparse
-
-from deprecated import deprecated
-from loguru import logger
-import DrissionPage
-from DrissionPage import ChromiumPage, Chromium
-from DrissionPage._pages.chromium_base import ChromiumBase
-from DrissionPage._pages.chromium_tab import ChromiumTab
-import DrissionPage.errors
-
-from pyxllib.prog.pupil import inject_members
-from pyxllib.text.pupil import strfind
-from pyxllib.file.specialist import GetEtag
-
-
-@deprecated(reason='get_dp_page逻辑不太对，请换用get_dp_tab')
-def get_dp_page(dp_page=None) -> 'XlPage':
-    """
-
-    :param dp_page:
-        默认None, 返回默认的page，一般就是当前页面
-        True, 新建一个page
-        str, 新建一个对应url的page
-        func(tab), 通过规则筛选tab，返回符合条件的第1个tab，否则新建一个tab
-    """
-
-    if isinstance(dp_page, Chromium):
-        return dp_page
-    elif isinstance(dp_page, ChromiumTab):
-        return dp_page.page
-    elif callable(dp_page):
-        page0 = Chromium()
-        for tab in page0.get_tabs():
-            if dp_page(tab):
-                return tab.page
-        return page0.new_tab().page
-    elif dp_page is True:
-        return Chromium().new_tab().page
-    elif isinstance(dp_page, str):
-        return Chromium().new_tab(dp_page).page
-    else:
-        return Chromium()
-
-
-def get_dp_tab(dp_tab=None) -> 'XlTab':
-    """ 智能获取一个标签页tab
-
-    :param dp_tab:
-        默认None, 返回默认的tab，一般就是当前页面
-        True, 新建一个tab
-        str, 新建一个对应url的tab，如果发现已存在的tab中已经有该url，则直接复用
-        func(tab), 通过规则筛选tab，返回符合条件的第1个tab，否则新建一个tab
-    """
-
-    if isinstance(dp_tab, Chromium):
-        return dp_tab.latest_tab
-    elif isinstance(dp_tab, ChromiumTab):
-        return dp_tab
-    elif callable(dp_tab):
-        page0 = Chromium()
-        for tab in page0.get_tabs():
-            if dp_tab(tab):
-                return tab
-        return page0.new_tab()
-    elif dp_tab is True:
-        return Chromium().new_tab()
-    elif isinstance(dp_tab, str):
-        def dp_page2(tab):  # 默认开启页面复用
-            if tab.url == dp_tab:
-                return tab
-
-        tab = get_dp_tab(dp_page2)
-        if tab.url == 'about:blank':
-            tab.get(dp_tab)
-        return tab
-    else:
-        return Chromium().latest_tab
-
-
-def get_latest_not_dev_tab(browser=None):
-    """ 开发工具本身也会算一个tab，这个函数返回最新的一个不是开发工具的tab """
-    if browser is None:
-        browser = Chromium()
-    tabs = browser.get_tabs()
-    for tab in tabs:
-        if strfind(tab.url, ['devtools://', 'chrome-extension://']) != -1:
-            continue
-        return tab
-
-
-class XlChromiumBase(ChromiumBase):
-    def get2(self, url, show_errmsg=False, retry=None, interval=None):
-        """
-        240418周四21:57，DrissionPage-4.0.4.21 官方自带page.get，有时候会有bug，不会实际刷新url，这里加个代码进行fix
-        """
-        old_url = self.url
-        if old_url == url:
-            # page.refresh()
-            return
-
-        ele = self.active_ele
-        self.get(url, show_errmsg=show_errmsg, retry=retry, interval=interval)
-        try:  # 如果新页面获取成功，理论上旧的ele会失效
-            ele
-            self.refresh()  # 如果不报错，这里网站要强制更新
-            return self
-        except DrissionPage.errors.ElementLostError:
-            return self
-
-    def get_download_files(self: Chromium):
-        """ 获取下载列表
-
-         (241205周四21:02，这个功能原本是用来做页面文件下载的，
-        但后来知道dp有更简洁的解决方案后，其实原本功能意义已不大，
-        只是作为一个结构化解析下载页面的功能，可以保留参考)
-
-        :param search_name: 搜索文件名，输入该参数时，只会从上往下找到第一个匹配的文件
-            否则返回一个list结构，存储下载清单里的文件
-        :return:
-
-        todo 默认应该显示是不全的，有时间可以考虑往下滑动继续检索的功能
-        """
-        files = []
-        page2 = Chromium().new_tab('chrome://downloads/')
-        items = page2('tag:downloads-manager', timeout=1).sr('#mainContainer')('#downloadsList').eles(
-            'tag:downloads-item')
-        for item in items:
-            loc = unquote(item.sr('tag:img').attr('src').replace('+', ' '))
-            file = re.search(r'path=(.+?)(&scale=(\d+(\.\d+)?)x)?$', loc).group(1)
-
-            files.append({
-                'file': file,
-                'url': unquote(item.sr('#url').attr('href'))
-            })
-
-        page2.close()
-
-        return files
-
-    def wait_page_not_change(self, interval=3):
-        """ 等待直到页面内容不再变化
-
-        :param interval: 时间间隔，需要判断当前内容和interval秒后的内容，看内容是否欧发生改变
-        """
-        last_html, last_etag = None, None
-        while True:
-            html = self.html
-            etag = GetEtag.from_text(html)
-            if etag == last_etag:
-                break
-
-            last_html, last_etag = html, etag
-            time.sleep(interval)
-        return last_html
-
-    def action_type(self, ele, text, clear=True):
-        """ 基于action实现的重写入，常用于日期相关操作
-        因为很多日期类组件，直接使用ele.input是不生效的，哪怕看似显示了文本，但其实并没有触发js改动，需要用动作链来实现
-        """
-        from DrissionPage.common import Keys
-        if clear:
-            self.actions.click(ele).key_down(Keys.CTRL).type('a').key_up(Keys.CTRL).type(text)
-        else:
-            self.actions.click(ele).type(text)
-
-
-inject_members(XlChromiumBase, ChromiumBase)
-
-
-class XlPage(XlChromiumBase, ChromiumTab, Chromium):
-    """ 只作为一个类型标记，无实质功能。在猴子补丁背景下，让ide能正确跳转函数定义。 """
-    pass
-
-
-class XlTab(XlChromiumBase, ChromiumTab, Chromium):
-    pass
-
-
-def wait_page_not_change(page, interval=3):
-    page.wait_page_not_change(interval)
-
-
-class DpWebBase:
-    """ 基于dp开发的爬虫工具的一个基础类 """
-
-    def __init__(self, url=None, *, base_url=None):
-        self.browser = Chromium()
-        self.browser.set.download_path(tempfile.gettempdir())
-
-        parsed_url = urlparse(url)
-        root_url = f"{parsed_url.scheme}://{parsed_url.netloc}"  # 构建基础 URL
-        self.tab: XlTab = self.browser.new_tab(url)
-        self.base_url = base_url or root_url  # 使用基础 URL 作为 base_url，后续同域名网站去重用
-
-    def close_if_exceeds_min_tabs(self, min_tabs_to_keep=1):
-        """ 检查同网站的tab数量，如果超过最小保留数量则关闭当前页面 """
-        try:  # 靠Py结束触发的可能报错：ImportError: sys.meta_path is None, Python is likely shutting down
-            if self.tab and self.base_url and len(self.browser.get_tabs(url=self.base_url)) > min_tabs_to_keep:
-                self.tab.close()
-        except Exception as e:
-            pass
-
-    # 实测效果不稳定，感觉还不如手动触发吧~
-    # def __del__(self):
-    #     """ 我习惯每次新任务建立新的tab处理，并在结束后自动检查同网页打开的标签是否不唯一则删掉 """
-    #     self.close_if_exceeds_min_tabs()
-
-
-def close_duplicate_tabs(browser=None):
-    """ 关闭浏览器重复标签页
-
-    遍历所有标签页（从前往后，dp的get_tabs拿到的tab就是从新到旧的），对每个域名仅保留第一个出现的标签页，其余同域名标签页关闭；
-    如果最后还剩多个标签页，则把'chrome://newtab/'也关掉。
-    """
-    # 1 初始化
-    if browser is None:
-        browser = Chromium()
-
-    # 250115周三21:12 这步不稳定，会报错，不知道为啥。导致dp最后经常没有清理tabs
-    # 250204周二09:21，好像是浏览器重启更新到最新版本就行了~ 这里也要加个try
-    try:
-        all_tabs = browser.get_tabs()
-    except TimeoutError:
-        logger.warning(
-            'browser.get_tabs()运行报错，请清查浏览器是否已更新但没有重启。本次将browser.quit()退出整个浏览器。')
-        # 你不让我关tabs是吧，那我就把整个浏览器关了
-        browser.quit()
-        return
-
-    seen_domains = set()
-
-    # 2 第一次遍历：保留首个出现的域名，其余重复则关闭
-    for t in all_tabs:
-        parsed_url = urlparse(t.url)
-        domain = parsed_url.netloc  # netloc 通常可拿到域名部分
-        # logger.info(f'{t.url}, {domain}')
-
-        if domain in seen_domains:
-            t.close()
-        else:
-            seen_domains.add(domain)
-
-    # 3 第二次遍历：如果剩余标签页 > 1，则关掉chrome://newtab/
-    remaining_tabs = browser.get_tabs()
-    if len(remaining_tabs) > 1:
-        for t in remaining_tabs:
-            if t.url.startswith('chrome://newtab'):
-                t.close()
-
-
-def dp_check_quit():
-    """ 检查当前页面是否只剩空标签页，则浏览器可以自动退出 """
-    browser = Chromium()
-    try:
-        tabs = browser.get_tabs()
-    except TimeoutError:
-        logger.warning('browser.get_tabs()运行报错，浏览器可能已更新但没有重启。将退出浏览器。')
-        browser.quit()
-        return
-
-    # 检查是否只剩下空标签页
-    if len(tabs) == 1 and tabs[0].url.startswith('chrome://newtab'):
-        # 如果只剩下一个空标签页，则退出浏览器
-        browser.quit()
-    elif len(tabs) == 0:
-        # 如果没有标签页，也退出浏览器
-        browser.quit()
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# @Author : 陈坤泽
+# @Email  : 877362867@qq.com
+# @Date   : 2024/04/12
+
+import re
+from urllib.parse import unquote
+import tempfile
+import time
+from urllib.parse import urlparse
+
+from deprecated import deprecated
+from loguru import logger
+import DrissionPage
+from DrissionPage import ChromiumPage, Chromium
+from DrissionPage._pages.chromium_base import ChromiumBase
+from DrissionPage._pages.chromium_tab import ChromiumTab
+import DrissionPage.errors
+
+from pyxllib.prog.pupil import inject_members
+from pyxllib.text.pupil import strfind
+from pyxllib.file.specialist import GetEtag
+
+
+@deprecated(reason='get_dp_page逻辑不太对，请换用get_dp_tab')
+def get_dp_page(dp_page=None) -> 'XlPage':
+    """
+
+    :param dp_page:
+        默认None, 返回默认的page，一般就是当前页面
+        True, 新建一个page
+        str, 新建一个对应url的page
+        func(tab), 通过规则筛选tab，返回符合条件的第1个tab，否则新建一个tab
+    """
+
+    if isinstance(dp_page, Chromium):
+        return dp_page
+    elif isinstance(dp_page, ChromiumTab):
+        return dp_page.page
+    elif callable(dp_page):
+        page0 = Chromium()
+        for tab in page0.get_tabs():
+            if dp_page(tab):
+                return tab.page
+        return page0.new_tab().page
+    elif dp_page is True:
+        return Chromium().new_tab().page
+    elif isinstance(dp_page, str):
+        return Chromium().new_tab(dp_page).page
+    else:
+        return Chromium()
+
+
+def get_dp_tab(dp_tab=None) -> 'XlTab':
+    """ 智能获取一个标签页tab
+
+    :param dp_tab:
+        默认None, 返回默认的tab，一般就是当前页面
+        True, 新建一个tab
+        str, 新建一个对应url的tab，如果发现已存在的tab中已经有该url，则直接复用
+        func(tab), 通过规则筛选tab，返回符合条件的第1个tab，否则新建一个tab
+    """
+
+    if isinstance(dp_tab, Chromium):
+        return dp_tab.latest_tab
+    elif isinstance(dp_tab, ChromiumTab):
+        return dp_tab
+    elif callable(dp_tab):
+        page0 = Chromium()
+        for tab in page0.get_tabs():
+            if dp_tab(tab):
+                return tab
+        return page0.new_tab()
+    elif dp_tab is True:
+        return Chromium().new_tab()
+    elif isinstance(dp_tab, str):
+        def dp_page2(tab):  # 默认开启页面复用
+            if tab.url == dp_tab:
+                return tab
+
+        tab = get_dp_tab(dp_page2)
+        if tab.url == 'about:blank':
+            tab.get(dp_tab)
+        return tab
+    else:
+        return Chromium().latest_tab
+
+
+def get_latest_not_dev_tab(browser=None):
+    """ 开发工具本身也会算一个tab，这个函数返回最新的一个不是开发工具的tab """
+    if browser is None:
+        browser = Chromium()
+    tabs = browser.get_tabs()
+    for tab in tabs:
+        if strfind(tab.url, ['devtools://', 'chrome-extension://']) != -1:
+            continue
+        return tab
+
+
+class XlChromiumBase(ChromiumBase):
+    def get2(self, url, show_errmsg=False, retry=None, interval=None):
+        """
+        240418周四21:57，DrissionPage-4.0.4.21 官方自带page.get，有时候会有bug，不会实际刷新url，这里加个代码进行fix
+        """
+        old_url = self.url
+        if old_url == url:
+            # page.refresh()
+            return
+
+        ele = self.active_ele
+        self.get(url, show_errmsg=show_errmsg, retry=retry, interval=interval)
+        try:  # 如果新页面获取成功，理论上旧的ele会失效
+            ele
+            self.refresh()  # 如果不报错，这里网站要强制更新
+            return self
+        except DrissionPage.errors.ElementLostError:
+            return self
+
+    def get_download_files(self: Chromium):
+        """ 获取下载列表
+
+         (241205周四21:02，这个功能原本是用来做页面文件下载的，
+        但后来知道dp有更简洁的解决方案后，其实原本功能意义已不大，
+        只是作为一个结构化解析下载页面的功能，可以保留参考)
+
+        :param search_name: 搜索文件名，输入该参数时，只会从上往下找到第一个匹配的文件
+            否则返回一个list结构，存储下载清单里的文件
+        :return:
+
+        todo 默认应该显示是不全的，有时间可以考虑往下滑动继续检索的功能
+        """
+        files = []
+        page2 = Chromium().new_tab('chrome://downloads/')
+        items = page2('tag:downloads-manager', timeout=1).sr('#mainContainer')('#downloadsList').eles(
+            'tag:downloads-item')
+        for item in items:
+            loc = unquote(item.sr('tag:img').attr('src').replace('+', ' '))
+            file = re.search(r'path=(.+?)(&scale=(\d+(\.\d+)?)x)?$', loc).group(1)
+
+            files.append({
+                'file': file,
+                'url': unquote(item.sr('#url').attr('href'))
+            })
+
+        page2.close()
+
+        return files
+
+    def wait_page_not_change(self, interval=3):
+        """ 等待直到页面内容不再变化
+
+        :param interval: 时间间隔，需要判断当前内容和interval秒后的内容，看内容是否欧发生改变
+        """
+        last_html, last_etag = None, None
+        while True:
+            html = self.html
+            etag = GetEtag.from_text(html)
+            if etag == last_etag:
+                break
+
+            last_html, last_etag = html, etag
+            time.sleep(interval)
+        return last_html
+
+    def action_type(self, ele, text, clear=True):
+        """ 基于action实现的重写入，常用于日期相关操作
+        因为很多日期类组件，直接使用ele.input是不生效的，哪怕看似显示了文本，但其实并没有触发js改动，需要用动作链来实现
+        """
+        from DrissionPage.common import Keys
+        if clear:
+            self.actions.click(ele).key_down(Keys.CTRL).type('a').key_up(Keys.CTRL).type(text)
+        else:
+            self.actions.click(ele).type(text)
+
+
+inject_members(XlChromiumBase, ChromiumBase)
+
+
+class XlPage(XlChromiumBase, ChromiumTab, Chromium):
+    """ 只作为一个类型标记，无实质功能。在猴子补丁背景下，让ide能正确跳转函数定义。 """
+    pass
+
+
+class XlTab(XlChromiumBase, ChromiumTab, Chromium):
+    pass
+
+
+def wait_page_not_change(page, interval=3):
+    page.wait_page_not_change(interval)
+
+
+class DpWebBase:
+    """ 基于dp开发的爬虫工具的一个基础类 """
+
+    def __init__(self, url=None, *, base_url=None):
+        self.browser = Chromium()
+        self.browser.set.download_path(tempfile.gettempdir())
+
+        parsed_url = urlparse(url)
+        root_url = f"{parsed_url.scheme}://{parsed_url.netloc}"  # 构建基础 URL
+        self.tab: XlTab = self.browser.new_tab(url)
+        self.base_url = base_url or root_url  # 使用基础 URL 作为 base_url，后续同域名网站去重用
+
+    def close_if_exceeds_min_tabs(self, min_tabs_to_keep=1):
+        """ 检查同网站的tab数量，如果超过最小保留数量则关闭当前页面 """
+        try:  # 靠Py结束触发的可能报错：ImportError: sys.meta_path is None, Python is likely shutting down
+            if self.tab and self.base_url and len(self.browser.get_tabs(url=self.base_url)) > min_tabs_to_keep:
+                self.tab.close()
+        except Exception as e:
+            pass
+
+    # 实测效果不稳定，感觉还不如手动触发吧~
+    # def __del__(self):
+    #     """ 我习惯每次新任务建立新的tab处理，并在结束后自动检查同网页打开的标签是否不唯一则删掉 """
+    #     self.close_if_exceeds_min_tabs()
+
+
+def close_duplicate_tabs(browser=None):
+    """ 关闭浏览器重复标签页
+
+    遍历所有标签页（从前往后，dp的get_tabs拿到的tab就是从新到旧的），对每个域名仅保留第一个出现的标签页，其余同域名标签页关闭；
+    如果最后还剩多个标签页，则把'chrome://newtab/'也关掉。
+    """
+    # 1 初始化
+    if browser is None:
+        browser = Chromium()
+
+    # 250115周三21:12 这步不稳定，会报错，不知道为啥。导致dp最后经常没有清理tabs
+    # 250204周二09:21，好像是浏览器重启更新到最新版本就行了~ 这里也要加个try
+    try:
+        all_tabs = browser.get_tabs()
+    except TimeoutError:
+        logger.warning(
+            'browser.get_tabs()运行报错，请清查浏览器是否已更新但没有重启。本次将browser.quit()退出整个浏览器。')
+        # 你不让我关tabs是吧，那我就把整个浏览器关了
+        browser.quit()
+        return
+
+    seen_domains = set()
+
+    # 2 第一次遍历：保留首个出现的域名，其余重复则关闭
+    for t in all_tabs:
+        parsed_url = urlparse(t.url)
+        domain = parsed_url.netloc  # netloc 通常可拿到域名部分
+        # logger.info(f'{t.url}, {domain}')
+
+        if domain in seen_domains:
+            t.close()
+        else:
+            seen_domains.add(domain)
+
+    # 3 第二次遍历：如果剩余标签页 > 1，则关掉chrome://newtab/
+    remaining_tabs = browser.get_tabs()
+    if len(remaining_tabs) > 1:
+        for t in remaining_tabs:
+            if t.url.startswith('chrome://newtab'):
+                t.close()
+
+
+def dp_check_quit():
+    """ 检查当前页面是否只剩空标签页，则浏览器可以自动退出 """
+    browser = Chromium()
+    try:
+        tabs = browser.get_tabs()
+    except TimeoutError:
+        logger.warning('browser.get_tabs()运行报错，浏览器可能已更新但没有重启。将退出浏览器。')
+        browser.quit()
+        return
+
+    # 检查是否只剩下空标签页
+    if len(tabs) == 1 and tabs[0].url.startswith('chrome://newtab'):
+        # 如果只剩下一个空标签页，则退出浏览器
+        browser.quit()
+    elif len(tabs) == 0:
+        # 如果没有标签页，也退出浏览器
+        browser.quit()

pyxllib/ext/kq5034lib.py

@@ -1,12 +1,12 @@
-# !/usr/bin/env python3
-# -*- coding: utf-8 -*-
-# @Author : 陈坤泽
-# @Email  : 877362867@qq.com
-# @Date   : 2022/4
-
-""" 惟海法师网课考勤工具
-
-为了使用便捷明了，程序开发上
-1、使用中文命名
-2、牺牲了一定的工程、扩展灵活性，用了尽可能多的自动推导，而不是参数配置
-"""
+# !/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# @Author : 陈坤泽
+# @Email  : 877362867@qq.com
+# @Date   : 2022/4
+
+""" 惟海法师网课考勤工具
+
+为了使用便捷明了，程序开发上
+1、使用中文命名
+2、牺牲了一定的工程、扩展灵活性，用了尽可能多的自动推导，而不是参数配置
+"""