tdrpa.tdworker 1.2.12.6__py311-none-win_amd64.whl → 1.2.13.0__py311-none-win_amd64.whl

tdrpa/tdworker/__init__.pyi

@@ -1,6 +1,8 @@
 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

tdrpa/tdworker/_clip.pyi

@@ -2,49 +2,49 @@ class Clipboard:
     @staticmethod
     def GetText():
         """
-        获取剪贴板文本
+        读取剪贴板文本
 
         Clipboard.GetText()
 
-        :return:剪切板的文本内容
+        :return:剪贴板的文本内容
         """
     @staticmethod
-    def SetText(content: str = ''):
+    def SaveImage(savePath: str):
         '''
-        设置剪贴板文本
+        保存剪贴板图像
 
-        Clipboard.SetText(\'\')
+        Clipboard.SaveImage(savePath)
 
-        :param content:[必选参数]新的剪贴板文本内容，默认""
-        :return:成功返回True，失败返回False
+        :param savePath:[必选参数]要将剪贴板的图像保存到的文件路径，如"D:\\1.png"
+        :return:图像保存成功返回True，保存失败返回False
         '''
     @staticmethod
-    def SetImage(picPath):
-        """
-        把图片放入剪贴板
+    def SetFile(paths: str | list):
+        '''
+        文件设置到剪贴板
 
-        Clipboard.SetText(picPath)
+        Clipboard.SetFile(paths)
 
-        :param picPath:[必选参数]图片的路径
+        :param paths:[必选参数]文件的路径，单个文件用字符串类型，如"D:\x01.txt"，多个文件用 list 类型，其中每个元素用字符串，如["D:\x01.txt", "D:\x01.png"]
         :return:成功返回True，失败返回False
-        """
+        '''
     @staticmethod
-    def SaveImage(savePath: str):
-        """
-        将剪贴板中的图片保存到文件
+    def SetImage(picPath):
+        '''
+        图片设置到剪贴板
 
-        Clipboard.SaveImage(savePath)
+        Clipboard.SetImage(picPath)
 
-        :param savePath:[必选参数]需要保存的文件路径
-        :return:保存成功返回True，保存失败返回False
-        """
+        :param picPath:[必选参数]要放入剪贴板的图片路径，如"D:\\1.png"
+        :return:成功返回True，失败返回False
+        '''
     @staticmethod
-    def SetFile(paths: str | list):
-        """
-        把文件放入剪贴板
+    def SetText(content: str = ''):
+        '''
+        设置剪贴板文本
 
-        Clipboard.SetFile(filePath)
+        Clipboard.SetText(\'\')
 
-        :param paths:[必选参数]文件的路径，单个文件用字符串，多个文件用list类型，其中每个元素用字符串
+        :param content:[必选参数]新的剪贴板文本内容，默认""
         :return:成功返回True，失败返回False
-        """
+        '''

tdrpa/tdworker/_excel.pyi

@@ -99,6 +99,46 @@ class Excel:
         :return:指定单元格的值
         '''
     @staticmethod
+    def ReadFormula(excelWorkBook, sheet: str | int = 'Sheet1', cell: str | list = 'A1'):
+        '''
+        读取单元格公式
+
+        cellFormula = Excel.ReadFormula(excelWorkBook, sheet="Sheet1", cell="A1")
+
+        :param excelWorkBook:[必选参数]使用 "打开Excel工作簿"命令（Excel.OpenExcel） 或 "绑定Excel工作簿" 命令（Excel.BindBook）返回的工作簿对象
+        :param sheet:[可选参数]如果使用字符串，则表示指定工作表的名字；使用数字，则表示指定工作表的顺序（例如：0、1、2代表从左边开始正数第1、2、3个工作表；-1、-2、-3代表从右边开始倒数第1、2、3个工作表）。默认"Sheet1"
+        :param cell:[可选参数]指定的单元格，支持单元格名如"A1"与行列列表如[行号，列号]两种格式，当使用单元格名时不区分大小写。默认"A1"
+        :return:指定单元格的公式
+        '''
+    @staticmethod
+    def WriteFormula(excelWorkBook, sheet: str | int = 'Sheet1', cell: str | list = 'A1', formula: str = ''):
+        '''
+        写入单元格公式
+
+        Excel.WriteFormula(excelWorkBook, sheet="Sheet1", cell="A1", formula="=A1+B1")
+
+        :param excelWorkBook:[必选参数]使用 "打开Excel工作簿"命令（Excel.OpenExcel） 或 "绑定Excel工作簿" 命令（Excel.BindBook）返回的工作簿对象
+        :param sheet:[可选参数]如果使用字符串，则表示指定工作表的名字；使用数字，则表示指定工作表的顺序（例如：0、1、2代表从左边开始正数第1、2、3个工作表；-1、-2、-3代表从右边开始倒数第1、2、3个工作表）。默认"Sheet1"
+        :param cell:[可选参数]指定的单元格，支持单元格名如"A1"与行列列表如[行号，列号]两种格式，当使用单元格名时不区分大小写。默认"A1"
+        :param formula:[可选参数]需要写入的公式。默认""
+        :return:None
+        '''
+    @staticmethod
+    def WriteHyperlink(excelWorkBook, sheet: str | int = 'Sheet1', cell: str | list = 'A1', url: str = '', textToDisplay: str = '', screenTip: str = ''):
+        '''
+        写入单元格超链接
+
+        Excel.WriteHyperlink(excelWorkBook, sheet="Sheet1", cell="A1", url="www.baidu.com", textToDisplay = "", screenTip = "")
+
+        :param excelWorkBook:[必选参数]使用 "打开Excel工作簿"命令（Excel.OpenExcel） 或 "绑定Excel工作簿" 命令（Excel.BindBook）返回的工作簿对象
+        :param sheet:[可选参数]如果使用字符串，则表示指定工作表的名字；使用数字，则表示指定工作表的顺序（例如：0、1、2代表从左边开始正数第1、2、3个工作表；-1、-2、-3代表从右边开始倒数第1、2、3个工作表）。默认"Sheet1"
+        :param cell:[可选参数]指定的单元格，支持单元格名如"A1"与行列列表如[行号，列号]两种格式，当使用单元格名时不区分大小写。默认"A1"
+        :param url:[可选参数]超链接的URL。默认""
+        :param textToDisplay:[可选参数]超链接的显示字符串。默认""
+        :param screenTip:[可选参数]当鼠标停留在超链接上方是显示的屏幕提示。默认""
+        :return:None
+        '''
+    @staticmethod
     def ReadRange(excelWorkBook, sheet: str | int = 'Sheet1', cells: str | list = 'A1:B2', retStr: bool = False, excludeEndBlankRows: bool = False, excludeEndBlankColums: bool = False) -> list:
         '''
         读取区域

tdrpa/tdworker/_file.pyi

@@ -0,0 +1,77 @@
+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
+        :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
+        :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
+        :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
+        :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
+        :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
+        :return: None
+        """

tdrpa/tdworker/_network.pyi

@@ -0,0 +1,94 @@
+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:[可选参数]字典类型的请求头，例如：{"name":"value","name2":"value2"}，默认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:是否下载成功
+        '''

tdrpa/tdworker/_web.pyi

@@ -56,11 +56,11 @@ class Web:
         :return: 关闭成功返回True，失败返回False。只有一个标签页时不能关闭，会返回False
         """
     @staticmethod
-    def CreateBrowser(url: str = None, chromeExePath: str = None, isMaximize: bool = True, supportMode: str = 'web', userData: str = None, clearChrome: bool = True, otherStartupParam: Incomplete | None = None, waitPage: bool = True, delayTime: int = 60000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> None:
+    def CreateBrowser(url: str = None, chromeExePath: str = None, isMaximize: bool = True, supportMode: str = 'web', userData: str = None, clearChrome: bool = True, otherStartupParam: Incomplete | None = None, waitPage: bool = True, delayTime: int = 60000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100, debugPort: int = 9222) -> None:
         """
         创建浏览器
 
-        Web.CreateBrowser(url='https://www.baidu.com', chromeExePath=None, isMaximize=True, supportMode='web', userData=None, clearChrome=True, otherStartupParam=None, waitPage=True, delayTime=60000, continueOnError=False, delayAfter=100, delayBefore=100)
+        Web.CreateBrowser(url='https://www.baidu.com', chromeExePath=None, isMaximize=True, supportMode='web', userData=None, clearChrome=True, otherStartupParam=None, waitPage=True, delayTime=60000, continueOnError=False, delayAfter=100, delayBefore=100, debugPort=9222)
 
         :param url:[可选参数]启动浏览器后打开的链接，字符串类型。默认None
         :param chromeExePath:[可选参数]谷歌浏览器可执行程序的绝对路径，字符串类型，填写None时会自动寻找本地安装的路径。默认None
@@ -74,6 +74,7 @@ class Web:
         :param continueOnError:[可选参数]错误继续执行。默认False
         :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
         :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
+        :param debugPort:[可选参数]调试端口。默认9222
         :return:None
         """
     @staticmethod
@@ -125,6 +126,7 @@ class Web:
         :param delayBefore:[可选参数]执行前延时(毫秒)。默认100。
         :return:所有目标元素的tdrpa_element_id列表 或 指定模式的值列表。
         '''
+    @staticmethod
     def GetAttribute(target: str | dict, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, attrname: str | list | None = 'class', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None | dict:
         '''
         获取网页元素属性值
@@ -820,6 +822,168 @@ class WebPW:
 
         eh = WebPW.Input(text, target, anchorsElement=None, continueOnError=False, delayTime=10000, delayAfter=100, delayBefore=100)
 
+        :param text:[必选参数]文本内容
+        :param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串 或 ElementHandle
+        :param anchorsElement:[可选参数]锚点元素，默认None
+        :param continueOnError:[可选参数]错误继续执行。默认False
+        :param delayTime:超时（豪秒）。默认10000
+        :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
+        :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
+        :return: ElementHandle
+        """
+
+    @staticmethod
+    def GetActivePage(delayTime: int = 10000, continueOnError: bool = False) -> Page:
+        """
+        获取当前激活的页面
+
+        page = WebPW.GetActivePage(delayTime=10000, continueOnError=False)
+
+        :param delayTime: 查找延时（豪秒）。默认10000
+        :param continueOnError: 错误继续执行。默认False
+        :return: Page
+        """
+    @staticmethod
+    def FindWebElement(target: str, anchorsElement: ElementHandle = None, delayTime: int = 10000, continueOnError: bool = False, isVisible: bool = True) -> ElementHandle:
+        """
+        查找元素
+
+        eh = WebPW.FindWebElement(target, anchorsElement=None, delayTime=10000, continueOnError=False, isVisible=True)
+
+        :param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串
+        :param anchorsElement:[可选参数]锚点元素，默认None
+        :param delayTime: 查找延时（豪秒）。默认10000
+        :param continueOnError: 错误继续执行。默认False
+        :param isVisible:检查是否可见。默认True
+        :return: ElementHandle
+        """
+    @staticmethod
+    def Exists(target: str, anchorsElement: ElementHandle = None, isVisible: bool = True, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> bool:
+        """
+        元素是否存在（不可见归于不存在）
+
+        WebPW.Exists(target, anchorsElement=None, isVisible=True, continueOnError=False, delayAfter=100, delayBefore=100)
+
+        :param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串
+        :param anchorsElement:[可选参数]锚点元素，默认None
+        :param isVisible:[可选参数]检查是否可见。默认True
+        :param continueOnError:[可选参数]错误继续执行。默认False
+        :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
+        :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
+        :return:存在返回True，不存在返回False
+        """
+    @staticmethod
+    def Wait(target: str, anchorsElement: ElementHandle = None, waitType: str = 'show', delayTime: int = 30000, isVisible: bool = True, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> None:
+        '''
+        等待元素加载
+
+        WebPW.Wait(target, anchorsElement=None, waitType="show", delayTime=30000, isVisible=True, continueOnError=False, delayAfter=100, delayBefore=100)
+
+        :param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串
+        :param anchorsElement:[可选参数]锚点元素，默认None
+        :param waitType:[可选参数]等待方式。 等待显示："show" 等待消失:"hide"。默认"show"
+        :param delayTime:[可选参数]等待最大时间。默认30000毫秒（30秒）
+        :param isVisible:[可选参数]检查是否可见。默认True
+        :param continueOnError:[可选参数]错误继续执行。默认False
+        :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
+        :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
+        :return:None
+        '''
+    @staticmethod
+    def GetParentElement(eh: ElementHandle, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
+        """
+        获取父级元素
+
+        eh = WebPW.GetParentElement(eh, continueOnError=False, delayAfter=100, delayBefore=100)
+
+        :param eh:[必选参数]ElementHandle
+        :param continueOnError:[可选参数]错误继续执行。默认False
+        :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
+        :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
+        :return:ElementHandle
+        """
+    @staticmethod
+    def GetNextSiblingElement(eh: ElementHandle, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
+        """
+        获取下一个兄弟元素
+
+        eh = WebPW.GetNextSiblingElement(eh, continueOnError=False, delayAfter=100, delayBefore=100)
+
+        :param eh:[必选参数]ElementHandle
+        :param continueOnError:[可选参数]错误继续执行。默认False
+        :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
+        :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
+        :return:ElementHandle
+        """
+    @staticmethod
+    def GetPreviousSiblingElement(eh: ElementHandle, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
+        """
+        获取前一个兄弟元素
+
+        eh = WebPW.GetPreviousSiblingElement(eh, continueOnError=False, delayAfter=100, delayBefore=100)
+
+        :param eh:[必选参数]ElementHandle
+        :param continueOnError:[可选参数]错误继续执行。默认False
+        :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
+        :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
+        :return:ElementHandle
+        """
+    @staticmethod
+    def GetChildrenElements(eh: ElementHandle, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> list | None:
+        """
+        获取子节点
+
+        ehList = WebPW.GetChildrenElements(eh, continueOnError=False, delayAfter=100, delayBefore=100)
+
+        :param eh:[必选参数]ElementHandle
+        :param continueOnError:[可选参数]错误继续执行。默认False
+        :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
+        :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
+        :return: list[ElementHandle, ElementHandle,...]
+        """
+    @staticmethod
+    def Click(target: str | ElementHandle, button: str = 'left', clickType: str = 'click', anchorsElement: ElementHandle = None, continueOnError: bool = False, position: dict = None, keyModifiers: list = None, delayTime: int = 10000, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
+        '''
+        点击元素
+
+        eh = WebPW.Click(target, button="left", clickType="click", anchorsElement=None, continueOnError=False, position=None, keyModifiers=None, delayTime=10000, delayAfter=100, delayBefore=100)
+
+        :param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串 或 ElementHandle
+        :param button:[可选参数]鼠标按键。left:左键，right:右键，middle:中键。默认left
+        :param clickType:[可选参数]点击方式。click 单击，dblclick 双击。默认click
+        :param anchorsElement:[可选参数]锚点元素，默认None
+        :param continueOnError:[可选参数]错误继续执行。默认False
+        :param position:以元素左上角偏移量{\'x\': 0, \'y\': 0}，None时点击中心
+        :param keyModifiers:[可选参数]辅助按键["Alt", "Ctrl", "Shift"]可多选。默认None
+        :param delayTime:超时（豪秒）。默认10000
+        :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
+        :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
+        :return: ElementHandle
+        '''
+    @staticmethod
+    def Hover(target: str | ElementHandle, anchorsElement: ElementHandle = None, continueOnError: bool = False, position: dict = None, keyModifiers: list = None, delayTime: int = 10000, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
+        '''
+        鼠标悬停在元素上
+
+        eh = WebPW.Hover(target, anchorsElement=None, continueOnError=False, position=None, keyModifiers=None, delayTime=10000, delayAfter=100, delayBefore=100)
+
+        :param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串 或 ElementHandle
+        :param anchorsElement:[可选参数]锚点元素，默认None
+        :param continueOnError:[可选参数]错误继续执行。默认False
+        :param position:以元素左上角偏移量{\'x\': 0, \'y\': 0}，None时点击中心
+        :param keyModifiers:[可选参数]辅助按键["Alt", "Ctrl", "Shift"]可多选。默认None
+        :param delayTime:超时（豪秒）。默认10000
+        :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
+        :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
+        :return: ElementHandle
+        '''
+    @staticmethod
+    def Input(text: str, target: str | ElementHandle, anchorsElement: ElementHandle = None, continueOnError: bool = False, delayTime: int = 10000, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
+        """
+        输入文本
+
+        eh = WebPW.Input(text, target, anchorsElement=None, continueOnError=False, delayTime=10000, delayAfter=100, delayBefore=100)
+
         :param text:[必选参数]文本内容
         :param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串 或 ElementHandle
         :param anchorsElement:[可选参数]锚点元素，默认None

{tdrpa.tdworker-1.2.12.6.dist-info → tdrpa.tdworker-1.2.13.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tdrpa.tdworker
-Version: 1.2.12.6
+Version: 1.2.13.0
 Summary: tdworker for tdrpa developers. supports python3.8+, windows x64
 Home-page: https://gitee.com/tdworker/command/wikis
 Author: vx:RPA_CREATOR
@@ -23,6 +23,7 @@ Requires-Dist: pyzmq
 Requires-Dist: pillow
 Requires-Dist: netifaces
 Requires-Dist: requests
+Requires-Dist: configobj
 
 tdworker for rpa developers. supports python3.8+, windows x64
 

{tdrpa.tdworker-1.2.12.6.dist-info → tdrpa.tdworker-1.2.13.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-tdrpa/tdworker.cp311-win_amd64.pyd,sha256=XXGAMTyVWt6cXyhgzw28GY4dhTkoLzgYpFBBM68MRCA,4776448
+tdrpa/tdworker.cp311-win_amd64.pyd,sha256=O032jxpOoZtYGD6GMIbCDh0c9HbFhe9G60frBaUZaAg,4924928
 tdrpa/_tdxlwings/__init__.py,sha256=mxmqGWQ7xFb6e1GqkKEBfMQtZ8YyO4kAcPOvcJnD_2k,4424
 tdrpa/_tdxlwings/_win32patch.py,sha256=_IxTfvj663osTXh8b1S-A_N4PthS9gEWFLjpY4V0iUA,3443
 tdrpa/_tdxlwings/_xlmac.py,sha256=23OusKchbqglFi1s909tbB9fIwoFj6Yny4GiYrsnx5s,68521
@@ -82,19 +82,20 @@ tdrpa/_tdxlwings/quickstart_fastapi/requirements.txt,sha256=y3pL1maFFVyROPGnd2YD
 tdrpa/_tdxlwings/rest/__init__.py,sha256=Dk7m0qKA9yIswBm_66Vw1MHmiiYRmqZ3egAUIMjUjts,41
 tdrpa/_tdxlwings/rest/api.py,sha256=yfv1VkTpjQOzxLh4aMnZQsh8wTRHg34KkyipKDa_w4g,12885
 tdrpa/_tdxlwings/rest/serializers.py,sha256=ztMzL_EgbhAb3rSbfWFE2A9uyOykoZbkSoDHPeKXzGg,2885
-tdrpa/tdworker/__init__.pyi,sha256=H5602jkV_k7msPClhkpuJxrLK7Hx2QubeoyqGI5LkYk,402
-tdrpa/tdworker/_clip.pyi,sha256=Y0FB0DHj8lLPC6uhfc8BOjpyfvhBZagrcm4hha7f_ss,1381
-tdrpa/tdworker/_excel.pyi,sha256=Kc684QBhV4p2lvj9y1K5Kmo2r0t492BzGN7Q5DRGVR4,61904
+tdrpa/tdworker/__init__.pyi,sha256=Lid_yROmUJbiHtVrZrLnF-wYK9sMk2jPR6nSINiLzew,483
+tdrpa/tdworker/_clip.pyi,sha256=BkWLBBqyoRMTP-Tm_BP4cN4O8vNo5mYBYOEdexW1-UA,1500
+tdrpa/tdworker/_excel.pyi,sha256=v5FYe98czmJ4YAfRKpqLBlBX0N-CIMJnV6osq_XwDLU,65221
+tdrpa/tdworker/_file.pyi,sha256=4WMemijmTqBgvnIBK0erEZL41C7UitnoPxyk3WVkfgU,3424
 tdrpa/tdworker/_img.pyi,sha256=f1FZQYHSItcjbtQ09LrXrD7IzUXWpOfe7Tu-J-9heuk,26375
-tdrpa/tdworker/_mail.pyi,sha256=2zTPzM2XIyjCjTSDYRraAaE1SegLsdabwUQmEpCbaIY,1998
+tdrpa/tdworker/_network.pyi,sha256=NcEOc6bNuZjvZGUQTbMkODBVaiekXDAtZGyQHRNhXss,4690
 tdrpa/tdworker/_os.pyi,sha256=cK2UJk6pM8piWA2Mkx3j1v0i5vYlttaiGvm62yaPhzc,2274
 tdrpa/tdworker/_sp.pyi,sha256=OwKyMzbxhTvjXcHBx-w_6et1hdlJTPyHMpC8DHjWW4Q,635
 tdrpa/tdworker/_w.pyi,sha256=ZwyIk5cLv8Rd0KpshdZSJ9EIN0XYMHYCARw31pvrzys,5229
-tdrpa/tdworker/_web.pyi,sha256=JT0Emv9ge-0u2ITLvqWDg-zh5P8cGE1Zantdpbw_odk,67984
+tdrpa/tdworker/_web.pyi,sha256=L3VsEArkmoiVxdizHpwF-thzQ9ep8xIMQhSbGkCLXz0,77598
 tdrpa/tdworker/_winE.pyi,sha256=s5IHyB4zLyshyvcPEEjaY-Vdyy02E1fnECASzXUsFZY,17557
 tdrpa/tdworker/_winK.pyi,sha256=lH1_smTsfHQVDaREOy37cb1Ied8zlKo6Q20oc1GXBGc,5407
 tdrpa/tdworker/_winM.pyi,sha256=E_PJm6cLgpkqy7fcD6CMNlSS31xVmE1N31DP1Cj47yI,7938
-tdrpa.tdworker-1.2.12.6.dist-info/METADATA,sha256=mxRKmndbzpU9WOwMBVwM4Q6Q1tet-FGzShv0nKH5Bsg,964
-tdrpa.tdworker-1.2.12.6.dist-info/WHEEL,sha256=eOLhNAGa2EW3wWl_TU484h7q1UNgy0JXjjoqKoxAAQc,92
-tdrpa.tdworker-1.2.12.6.dist-info/top_level.txt,sha256=S9UoqmC_cyGqKbGsBkLQPEeQLbDrWD0SRwbxPpQpyyU,6
-tdrpa.tdworker-1.2.12.6.dist-info/RECORD,,
+tdrpa.tdworker-1.2.13.0.dist-info/METADATA,sha256=_WYzahS-AKrfEv5sBvwLDcqZmggNoDWUT7aOptkRC_M,990
+tdrpa.tdworker-1.2.13.0.dist-info/WHEEL,sha256=eOLhNAGa2EW3wWl_TU484h7q1UNgy0JXjjoqKoxAAQc,92
+tdrpa.tdworker-1.2.13.0.dist-info/top_level.txt,sha256=S9UoqmC_cyGqKbGsBkLQPEeQLbDrWD0SRwbxPpQpyyU,6
+tdrpa.tdworker-1.2.13.0.dist-info/RECORD,,

tdrpa/tdworker/_mail.pyi

@@ -1,23 +0,0 @@
-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
-        '''