tdrpa.tdworker 1.2.13.9__py310-none-win_amd64.whl → 1.2.13.50__py310-none-win_amd64.whl

tdrpa/tdworker/__init__.pyi

@@ -1,12 +1,4 @@
-from ._clip import Clipboard as Clipboard
 from ._excel import Excel as Excel
-from ._file import INI as INI
-from ._img import Image as Image
-from ._network import HTTP as HTTP, Mail as Mail
-from ._os import App as App
-from ._sp import PrintToScreen as PrintToScreen
-from ._w import Window as Window
+from ._other import App as App, Clipboard as Clipboard, HTTP as HTTP, INI as INI, Image as Image, Mail as Mail, PrintToScreen as PrintToScreen
 from ._web import Web as Web, WebPW as WebPW
-from ._winE import WinElement as WinElement
-from ._winK import WinKeyboard as WinKeyboard
-from ._winM import WinMouse as WinMouse
+from ._win import WinElement as WinElement, WinKeyboard as WinKeyboard, WinMouse as WinMouse, Window as Window

tdrpa/tdworker/{_img.pyi → _other.pyi}

@@ -1,6 +1,205 @@
 import uiautomation as uia
 from _typeshed import Incomplete
 
+class Clipboard:
+    @staticmethod
+    def GetText():
+        """
+        读取剪贴板文本
+
+        Clipboard.GetText()
+
+        :return:剪贴板的文本内容
+        """
+    @staticmethod
+    def SaveImage(savePath: str):
+        '''
+        保存剪贴板图像
+
+        Clipboard.SaveImage(savePath)
+
+        :param savePath:[必选参数]要将剪贴板的图像保存到的文件路径，如"D:\\1.png"
+        :return:图像保存成功返回True，保存失败返回False
+        '''
+    @staticmethod
+    def SetFile(paths: str | list):
+        '''
+        文件设置到剪贴板
+
+        Clipboard.SetFile(paths)
+
+        :param paths:[必选参数]文件的路径，单个文件用字符串类型，如"D:\x01.txt"，多个文件用 list 类型，其中每个元素用字符串，如["D:\x01.txt", "D:\x01.png"]
+        :return:成功返回True，失败返回False
+        '''
+    @staticmethod
+    def SetImage(picPath):
+        '''
+        图片设置到剪贴板
+
+        Clipboard.SetImage(picPath)
+
+        :param picPath:[必选参数]要放入剪贴板的图片路径，如"D:\\1.png"
+        :return:成功返回True，失败返回False
+        '''
+    @staticmethod
+    def SetText(content: str = ''):
+        '''
+        设置剪贴板文本
+
+        Clipboard.SetText(\'\')
+
+        :param content:[必选参数]新的剪贴板文本内容，默认""
+        :return:成功返回True，失败返回False
+        '''
+
+class PrintToScreen:
+    @staticmethod
+    def DrawText(msg: str = '', showSec: int = 0) -> None:
+        '''
+        绘制屏幕中央正上方显示的红字
+
+        PrintToScreen.DrawText(\'开始工作\', showSec=0)
+
+        :param msg:[可选参数]文字内容，默认为""
+        :param showSec:[可选参数]显示秒数。0:一直显示到程序结束，大于0:显示的时间，单位是秒
+        :return:无
+        '''
+    @staticmethod
+    def CleanText() -> None:
+        """
+        清除屏幕中央正上方显示的红字
+
+        PrintToScreen.CleanText()
+
+        :return:无
+        """
+
+class INI:
+    @staticmethod
+    def Read(iniPath: str, sectionName: str, keyName: str, defaultValue: str = '', encoding: str = 'GBK') -> str:
+        '''
+        读键值
+
+        value = INI.Read(\'D:\\conf.ini\',\'section1\', \'key1\', defaultValue=\'\', encoding=\'GBK\')
+
+        :param iniPath:[必选参数]INI 配置文件所在路径
+        :param sectionName:[必选参数]要访问 INI 配置文件的小节名字
+        :param keyName:[必选参数]要访问 INI 配置文件的键名
+        :param defaultValue:[可选参数]当 INI 配置文件键名不存在时，返回的默认内容。默认是空字符串
+        :param encoding:[可选参数]文件编码，常用"GBK"， "UTF8"等。默认 GBK
+        :return: 返回读取的值，字符串类型
+        '''
+    @staticmethod
+    def Write(iniPath: str, sectionName: str, keyName: str, value, encoding: str = 'GBK') -> None:
+        '''
+        写键值
+
+        INI.Write(\'D:\\conf.ini\',\'section1\', \'key1\', \'value1\', encoding=\'GBK\')
+
+        :param iniPath:[必选参数]INI 配置文件所在路径
+        :param sectionName:[必选参数]要访问 INI 配置文件的小节名字
+        :param keyName:[必选参数]INI 文件中被写入的键值对中的键名，若为空字符串，则此键值对不被写入
+        :param value:[必选参数]INI 文件中被写入的键值对中的键值
+        :param encoding:[可选参数]文件编码，常用"GBK"， "UTF8"等。默认 GBK
+        :return: None
+        '''
+    @staticmethod
+    def EnumSection(iniPath: str, encoding: str = 'GBK') -> list:
+        '''
+        枚举小节
+
+        sections = INI.EnumSection(\'D:\\conf.ini\', encoding=\'GBK\')
+
+        :param iniPath:[必选参数]INI 配置文件所在路径
+        :param encoding:[可选参数]文件编码，常用"GBK"， "UTF8"等。默认 GBK
+        :return: 返回一个列表，列表中每个元素为一个section的名字
+        '''
+    @staticmethod
+    def EnumKey(iniPath: str, sectionName: str, encoding: str = 'GBK') -> list:
+        '''
+        枚举键
+
+        keys = INI.EnumKey(\'D:\\conf.ini\', \'section1\', encoding=\'GBK\')
+
+        :param iniPath:[必选参数]INI 配置文件所在路径
+        :param sectionName:[必选参数]要访问 INI 配置文件的小节名字
+        :param encoding:[可选参数]文件编码，常用"GBK"， "UTF8"等。默认 GBK
+        :return: 返回一个列表，列表中每个元素为一个key的名字
+        '''
+    @staticmethod
+    def DeleteSection(iniPath: str, sectionName: str, encoding: str = 'GBK') -> None:
+        '''
+        删除小节
+
+        INI.DeleteSection(\'D:\\conf.ini\',\'section1\', encoding=\'GBK\')
+
+        :param iniPath:[必选参数]INI 配置文件所在路径
+        :param sectionName:[必选参数]要访问 INI 配置文件的小节名字
+        :param encoding:[可选参数]文件编码，常用"GBK"， "UTF8"等。默认 GBK
+        :return: None
+        '''
+    @staticmethod
+    def DeleteKey(iniPath: str, sectionName: str, keyName: str, encoding: str = 'GBK'):
+        '''
+        删除键
+
+        INI.DeleteKey(\'D:\\conf.ini\',\'section1\', \'key1\', encoding=\'GBK\')
+
+        :param iniPath:[必选参数]INI 配置文件所在路径
+        :param sectionName:[必选参数]要访问 INI 配置文件的小节名字
+        :param keyName:[必选参数]要访问 INI 配置文件的键名
+        :param encoding:[可选参数]文件编码，常用"GBK"， "UTF8"等。默认 GBK
+        :return: None
+        '''
+
+class App:
+    @staticmethod
+    def Kill(processName: str | int) -> bool:
+        """
+        强制停止应用程序的运行（结束进程）
+
+        App.Kill('chrome.exe')
+
+        :param processName:[必选参数]应用程序进程名或进程PID，忽略大小写字母
+        :return:命令执行成功返回True，失败返回False
+        """
+    @staticmethod
+    def GetStatus(processName: str | int, status: int = 0) -> bool:
+        """
+        获取应用运行状态
+
+        App.GetStatus('chrome.exe', status=0)
+
+        :param processName:[必选参数]应用程序进程名或进程PID，忽略大小写字母
+        :param status:[可选参数]筛选进程状态。0:所有状态 1:运行 2:暂停 3:未响应 4:未知。默认0
+        :return:进程存在返回True，不存在返回False
+        """
+    @staticmethod
+    def Run(exePath, waitType: int = 0, showType: int = 1, mode: int = 0):
+        """
+        启动应用程序
+
+        App.Run('''C:\\Windows\\system32\\mspaint.exe''')
+
+        :param exePath:[必选参数]应用程序文件路径
+        :param waitType:[可选参数]0:不等待 1：等待应用程序准备好 2：等待应用程序执行到退出。默认0
+        :param showType:[可选参数]程序启动后的显示样式（不一定生效） 0：隐藏 1：默认 3：最大化 6：最小化
+        :param mode:[可选参数]启动模式，0:常规模式启动, 1:增强模式启动。当常规模式启动后无法拾取元素时，可尝试增强模式启动。默认0
+        :return:返回应用程序的PID
+        """
+    @staticmethod
+    def WaitProcess(processName, waitType: str = 'open', delayTime: int = 30000) -> bool:
+        '''
+        等待应用启动或关闭
+
+        App.WaitProcess(\'chrome.exe\', waitType=\'open\', delayTime=30000)
+
+        :param processName:[必选参数]进程名称，忽略大小写字母。如:"chrome.exe"
+        :param waitType:[可选参数]期望应用状态。open:等待应用打开 close:等待应用关闭
+        :param delayTime:[可选参数]最大等待时间，默认30000毫秒(即30秒)
+        :return:等待时间内达到期望应用状态（开启/关闭）返回True，否则返回False
+        '''
+
 class Image:
     @staticmethod
     def Exists(imagePath: str, target: str | uia.Control, anchorsElement: uia.Control | None = None, rect: dict | None = None, accuracy: float = 0.9, searchDelay: int = 10000, continueOnError: bool = False, delayAfter: int = 0, delayBefore: int = 100, setForeground: bool = True, matchType: str = 'GrayMatch', backgroundPic: bool = False) -> bool:
@@ -224,3 +423,98 @@ class Image:
         :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
         :return:None
         '''
+
+class Mail:
+    @staticmethod
+    def SendMail(user: str = '', pwd: str = '', sender: str = '', title: str = '', content: str = '', to: str | list = '', cc: str | list = None, attr: str | list = None, server: str = 'smtp.qq.com', port: int = 465, ssl: bool = True, timeout: int = 10, continueOnError: bool = False):
+        '''
+        发送邮件
+
+        Mail.SendMail(user=\'\', pwd=\'\', sender=\'\', title=\'\', content=\'\', to=\'\', cc=None, attr=None, server="smtp.qq.com", port=465, ssl=True, timeout=10, continueOnError=False)
+
+        :param user: [必选参数]邮箱登录帐号，比如普通QQ邮箱的登录帐号与邮箱地址相同
+        :param pwd: [必选参数]登录密码
+        :param sender: [必选参数]发件人邮箱地址
+        :param title: [必选参数]邮件的标题
+        :param content: [必选参数]邮件正文内容，支持HTML类型的正文内容
+        :param to: [必选参数]收件人邮箱地址，多个地址可用["xxx@qq.com","xxx@163.com"]列表的形式填写, 也可以是单个邮箱地址字符串
+        :param cc: [可选参数]抄送邮箱地址，多个地址可用["xxx@qq.com","xxx@163.com"]列表的形式填写, 也可以是单个邮箱地址字符串, None:不需要抄送，默认None
+        :param attr: [可选参数]邮件附件，多个附件可以用["附件一路径","附件二路径"]列表的形式填写，也可以是单个附件路径字符串, None:不需要附件，默认None
+        :param server: [可选参数]SMTP服务器地址，默认smtp.qq.com
+        :param port: [可选参数]SMTP服务器端口，常见为 25、465、587，默认465
+        :param ssl: [可选参数]是否使用SSL协议加密，True为使用，False为不使用，默认True
+        :param timeout: [可选参数]超时时间(秒)，默认10
+        :param continueOnError: [可选参数]发生错误是否继续，True为继续，False为不继续。默认False
+        :return:None
+        '''
+
+class HTTP:
+    @staticmethod
+    def SetCookies(cookies: dict = None) -> None:
+        '''
+        设置cookies
+
+        HTTP.SetCookies(None)
+
+        :param cookies:[可选参数]字典类型的cookies，例如：{"name":"value","name2":"value2"}，默认None
+        :return:None
+        '''
+    @staticmethod
+    def SetHeaders(headers: dict = None) -> None:
+        '''
+        设置Headers
+
+        HTTP.SetHeaders(None)
+
+        :param headers:[可选参数]字典类型的请求头，例如：{"User-Agent": "Mozilla/5.0", "Accept-Language": "en-US"}，默认None
+        :return:None
+        '''
+    @staticmethod
+    def Get(url: str, form: str | dict = None, delayTime: int = 60000) -> str:
+        '''
+        Get获取数据
+
+        text = HTTP.Get("", None, 60000)
+
+        :param url:[必选参数]Get页面的链接地址
+        :param form:[可选参数]Get时传递的表单数据，可以是字符串或字典，默认None
+        :param delayTime:[可选参数]超时时间，单位毫秒，默认60000毫秒
+        :return:获取的网络数据的结果
+        '''
+    @staticmethod
+    def Post(url: str, form: str | dict = None, delayTime: int = 60000) -> str:
+        '''
+        Post提交表单
+
+        text = HTTP.Post("", None, 60000)
+
+        :param url:[必选参数]Post页面的链接地址
+        :param form:[可选参数]Post时传递的表单数据，可以是字符串或字典，默认None
+        :param delayTime:[可选参数]超时时间，单位毫秒，默认60000毫秒
+        :return:向网页提交表单的结果
+        '''
+    @staticmethod
+    def PostJson(url: str, form: str | dict = None, delayTime: int = 60000) -> str:
+        '''
+        Post提交JSON表单
+
+        text = HTTP.PostJson("", None, 60000)
+
+        :param url:[必选参数]Post页面的链接地址
+        :param form:[可选参数]Post时传递的表单数据，可以是字符串或字典，默认None
+        :param delayTime:[可选参数]超时时间，单位毫秒，默认60000毫秒
+        :return:向网页提交JSON表单的结果
+        '''
+    @staticmethod
+    def GetFile(url: str, file: str, form: str | dict = None, delayTime: int = 60000) -> bool:
+        '''
+        Get下载文件
+
+        result = HTTP.GetFile("","",None,60000)
+
+        :param url:[必选参数]下载文件的链接地址
+        :param file:[必选参数]保存的文件路径
+        :param form:[可选参数]Get时传递的表单数据，可以是字符串或字典，默认None
+        :param delayTime:[可选参数]超时时间，单位毫秒，默认60000毫秒
+        :return:是否下载成功
+        '''