pywechat127 1.5.8__py3-none-any.whl

pywechat/Clock.py

@@ -0,0 +1,88 @@
+
+'''
+定时模块schedule:可以按照当天指定时刻或一段时间后运行指定函数或方法\n
+使用方法:\n
+在指定的一段时间后执行\n
+from pywechat127.clock import schedule\n
+schedule(funcs=[func1,func2],parameters=[{func1的参数字典},{func2的参数字典},waitPeriods=['20s','20min']]).execute()
+在指定的一段时刻执行\n
+from pywechat127.clock import schedule\n
+schedule(funcs=[func1,func2],parameters=[{func1的参数字典},{func2的参数字典},Time=['08:31:14','08:45']]).execute()
+注:时刻可以精确到秒,若某个函数无需任何参数,那你在传入其对印的参数字典时,传入一个空字典即可\n
+若给定的时间戳与当前时间戳之差为负数,定时任务将会立即执行\n
+'''
+import re
+from  datetime import datetime
+import asyncio
+from pywechat.WinSettings import Systemsettings
+from pywechat.WechatTools import match_duration
+class schedule:#创建定时任务
+    '''
+    funcs:所有需要定时执行的函数名列表,注意函数名的类型为函数\n
+    不是类型为字符串的函数的名字!\n
+    parameters:所有需要定时执行的函数的参数\n
+    Times:各个函数定时执行的时间点,Times=['08:31','08:45:54']可精确到秒\n
+    waitPeriod:各个函数在指定的一段时间执行的等待时长,waitPeriod=['20s','1h']分别在20s后和1h后执行两个函数、\n
+    比如:有两个函数分别为,test1(num:int,string:str),test2(num:int,string:str)\n
+    那么传入funcs和parameters时应为:funcs=[test1,test2]\n
+    parameters=[{'num':2,'string':'test1'},{{'num':3,'string':'test2'}}]\n
+    这个类通过构建协程池来创建定时任务\n
+    '''
+    def __init__(self,funcs:list,parameters:list[dict],Times:list[str]=[],waitPeriods:list[str]=[]):
+        self.Times=Times#指定时间点，'08:31','08:45:54'可精确到秒
+        self.waitPeriods=waitPeriods#指定时长，20s,1min,1h
+        self.funcs=funcs#所有需要定时执行的函数名
+        self.parameters=parameters##所有需要定时执行的函数的参数[{},{}]，
+
+    def calculate_time_difference(self,target_time_string):
+        colons=re.findall(r':',target_time_string)
+        current_time = datetime.now()
+        target_date = current_time.date()  # 获取当前日期
+        if len(colons)==2:
+            target_time_format="%H:%M:%S"
+        elif len(colons)==1:
+            target_time_format="%H:%M"
+        else:
+            raise ValueError('输入的时间戳有误!请重新输入!')
+        target_time = datetime.combine(target_date, datetime.strptime(target_time_string, target_time_format).time())
+        # 计算时间差
+        time_difference = target_time - current_time
+        hours_difference = time_difference.seconds // 3600  # 整除3600得到小时数
+        minutes_remainder = time_difference.seconds % 3600  # 求余得到剩余的秒数，再转换为分钟
+        minutes_difference = minutes_remainder // 60  # 整除60得到分钟数
+        seconds_difference = minutes_remainder % 60  # 再次求余得到秒数
+        print(f"时间差：{hours_difference}小时 {minutes_difference}分钟 {seconds_difference}秒")
+        time_difference=time_difference.total_seconds()
+        return  time_difference
+    
+    async def async_task(self,func,parameter,Time:str=None,waitPeriod:str=None):
+        if Time:
+            print(f"函数{func.__name__}将会在{Time}时执行")
+            await asyncio.sleep(self.calculate_time_difference(Time))
+            result=func(**parameter)
+            return result
+        if waitPeriod:
+            print(f"函数{func.__name__}将会在{waitPeriod}后执行")
+            waitPeriod=match_duration(waitPeriod)
+            await asyncio.sleep(waitPeriod)
+            result=func(**parameter)
+            return result
+    async def main(self):
+        #构建协程池实现异步定时任务
+        self.tasks=[]
+        if self.waitPeriods:
+            for func,parameter,waitPeriod in zip(self.funcs,self.parameters,self.waitPeriods):
+                self.tasks.append(self.async_task(func,parameter,waitPeriod=waitPeriod))
+            results=await asyncio.gather(*self.tasks)
+            return results
+        if self.Times:
+            for func,parameter,time in zip(self.funcs,self.parameters,self.Times):
+                self.tasks.append(self.async_task(func,parameter,Time=time))
+            results=await asyncio.gather(*self.tasks)
+            return results
+    def execute(self):
+        #运行所有任务
+        Systemsettings.open_listening_mode()
+        results=asyncio.run(self.main())
+        Systemsettings.close_listening_mode()
+        return results

pywechat/Errors.py

@@ -0,0 +1,75 @@
+'''各种可能产生的错误'''
+class PathNotFoundError(Exception):
+    pass
+class WeChatNotStartError(Exception):
+    pass
+class NetWorkNotConnectError(Exception):
+    pass
+class ScanCodeToLogInError(Exception):
+    pass
+class TimeNotCorrectError(Exception):
+    pass
+class HaveBeenPinnedError(Exception):
+    pass
+class HaveBeenUnpinnedError(Exception):
+    pass
+class NoSuchFriendError(Exception):
+    pass
+class HaveBeenMutedError(Exception):
+    pass
+class HaveBeenStickiedError(Exception):
+    pass
+class HaveBeenUnmutedError(Exception):
+    pass
+class HaveBeenUnstickiedError(Exception):
+    pass
+class HaveBeenStaredError(Exception):
+    pass
+class HaveBeenUnstaredError(Exception):
+    pass
+class HaveBeenInBlackListError(Exception):
+    pass
+class HaveBeenOutofBlackListError(Exception):
+    pass
+class HaveBeenSetChatonlyError(Exception):
+    pass
+class HaveBeenSetUnseentohimError(Exception):
+    pass
+class HaveBeenSetDontseehimError(Exception):
+    pass
+class PrivacytNotCorrectError(Exception):
+    pass
+class NoWechat_number_or_Phone_numberError(Exception):
+    pass
+class EmptyFileError(Exception):
+    pass
+class EmptyFolderError(Exception):
+    pass
+class NotFileError(Exception):
+    pass
+class NotFolderError(Exception):
+    pass
+class CantCreateGroupError(Exception):
+    pass
+class NoPermissionError(Exception):
+    pass
+class SameNameError(Exception):
+    pass
+class AlreadyOpenError(Exception):
+    pass
+class AlreadyCloseError(Exception):
+    pass
+class AlreadyInContactsError(Exception):
+    pass
+class EmptyNoteError(Exception):
+    pass
+class NoChatHistoryError(Exception):
+    pass
+class HaveBeenSetError(Exception):
+    pass
+class NoResultsError(Exception):
+    pass
+class CantSendEmptyMessageError(Exception):
+    pass
+class WrongParameterError(Exception):
+    pass

pywechat/Uielements.py

@@ -0,0 +1,81 @@
+'''
+Uielements
+---------
+PC微信中的各种Ui-Object'''
+class Login_window():
+    '''登录界面要用到的唯二的两个Ui:登录界面与进入微信按钮\n'''
+    LoginWindow={'title':'微信','class_name':'WeChatLoginWndForPC','visible_only':False}
+    LoginButton={'title':'进入微信','control_type':'Button'}
+
+class ToolBar():
+    '''主界面导航栏下的所有Ui'''
+    Chat={'title':'聊天','control_type':'Button'}
+    Contacts={'title':'通讯录','control_type':'Button'}
+    Collections={'title':'收藏','control_type':'Button'}
+    ChatFiles={'title':'聊天文件','control_type':'Button'}
+    Moments={'title':'朋友圈','control_type':'Button'}
+    Channel={'title':'视频号','control_type':'Button'}
+    Topstories={'title':'看一看','control_type':'Button'}
+    Search={'title':'搜一搜','control_type':'Button'}
+    Miniprogram_pane={'title':'小程序面板','control_type':'Button'}
+    SettingsAndOthers={'title':'设置及其他','control_type':'Button'}
+
+    
+class Main_window():
+    '''主界面下所有的第一级Ui\n'''
+    AddTalkMemberWindow={'title':'AddTalkMemberWnd','control_type':'Window','class_name':'AddTalkMemberWnd','framework_id':'Win32'}
+    MainWindow={'title':'微信','class_name':'WeChatMainWndForPC'}
+    Toolbar={'title':'导航','control_type':'ToolBar'}
+    MessageList={'title':'会话','control_type':'List'}
+    Search={'title':'搜索','control_type':'Edit'}
+    SearchResult={'title_re':"@str:IDS_FAV_SEARCH_RESULT",'control_type':'List'}
+    CerateGroupChatButton={'title':"发起群聊",'control_type':"Button"}
+    ChatToolBar={'title':'','found_index':0,'control_type':'ToolBar'}
+    ChatMessage={'title':'聊天信息','control_type':'Button'}
+    CurrentChatWindow={'control_type':'Edit','found_index':1}
+    CerateNewNote={'title':'新建笔记','control_type':'Button'}
+    ProfileWindow={'class_name':"ContactProfileWnd",'control_type':'Pane','framework_id':'Win32'}
+    MoreButton={'title':'更多','control_type':'Button'}
+    FriendMenu={'control_type':'Menu','title':'','class_name':'CMenuWnd','framework_id':'Win32'}
+    FriendSettingsWindow={'class_name':'SessionChatRoomDetailWnd','control_type':'Pane','framework_id':'Win32'}
+    GroupSettingsWindow={'title':'SessionChatRoomDetailWnd','control_type':'Pane','framework_id':'Win32'}    
+    SettingsMenu={'class_name':'SetMenuWnd','control_type':'Window'}
+    SettingsButton={'title':'设置','control_type':'Button'}
+    ContactsManage={'title':'通讯录管理','control_type':'Button'}
+    ContactsList={'title':'联系人','control_type':'List'}
+    AddNewFriendButon={'title':'添加朋友','control_type':'Button'}
+    SearchNewFriendBar={'title':'微信号/手机号','control_type':'Edit'}
+    SearchNewFriendResult={'title_re':'@str:IDS_FAV_SEARCH_RESULT','control_type':'List'}
+    AddFriendRequestWindow={'title':'添加朋友请求','class_name':'WeUIDialog','control_type':'Window','framework_id':'Win32'}
+    AddMemberWindow={'title':'AddMemberWnd','control_type':'Window','framework_id':'Win32'}
+    DeleteMemberWindow={'title':'DeleteMemberWnd','control_type':'Window','framework_id':'Win32'}
+    QuitGroupButton={'title':"退出",'control_type':'Button'}
+    EmptyChatHistoryButon={'title':'清空','control_type':'Button'}
+    Tickle={'title':'拍一拍','control_type':'MenuItem'}
+    SelectContactWindow={'title':'','control_type':'Window','class_name':'SelectContactWnd','framework_id':'Win32'}
+    SetTag={'title':'设置标签','framework_id':'Win32','class_name':'StandardConfirmDialog'}
+    FriendChatList={'title':'消息','control_type':'List'}
+    CantSendEmptyMessageTips={'title':'不能发送空白信息','control_type':'Text'}
+
+class Independent_window():
+    '''独立于微信主界面,将微信主界面关闭后仍能在桌面显示的Ui\n'''
+    Desktop={'backend':'uia'}
+    SettingWindow={'title':'设置','class_name':"SettingWnd",'control_type':'Window'}
+    ContactManagerWindow={'title':'通讯录管理','class_name':'ContactManagerWindow'}
+    MomentsWindow={'title':'朋友圈','control_type':"Window",'class_name':"SnsWnd"}
+    ChatFilesWindow={'title':'聊天文件','control_type':'Window','class_name':'FileListMgrWnd'}
+    MiniProgramWindow={'title':'微信','control_type':'Pane','class_name':'Chrome_WidgetWin_0'}
+    SearchWindow={'title':'微信','class_name':'Chrome_WidgetWin_0','control_type':'Pane'}
+    ChannelWindow={'title':'微信','class_name':'Chrome_WidgetWin_0','control_type':'Pane'}
+    ContactProfileWindow={'title':'微信','class_name':'ContactProfileWnd','framework_id':'Win32','control_type':'Pane'}
+    TopStoriesWindow={'title':'微信','class_name':'Chrome_WidgetWin_0','control_type':'Pane'}
+    ChatHistoryWindow={'control_type':'Window','class_name':'FileManagerWnd','framework_id':'Win32'}
+    GroupAnnouncementWindow={'title':'群公告','framework_id':'Win32','class_name':'ChatRoomAnnouncementWnd'}
+    NoteWindow={'title':'笔记','class_name':'FavNoteWnd','framework_id':"Win32"}
+    OldIncomingCallWindow={'class_name':'VoipTrayWnd','title':'微信'}
+    NewIncomingCallWindow={'class_name':'ILinkVoipTrayWnd','title':'微信'}
+    OldVoiceCallWindow={'title':'微信','class_name':'AudioWnd'}
+    NewVoiceCallWindow={'title':'微信','class_name':'ILinkAudioWnd'}
+    OldVideoCallWindow={'title':'微信','class_name':'VoipWnd'}
+    NewVideoCallWindow={'title':'微信','class_name':'ILinkVoipWnd'}
+    OfficialAccountWindow={'title':'公众号','control_type':'Window','class_name':'H5SubscriptionProfileWnd'}

pywechat/Warnings.py

@@ -0,0 +1,13 @@
+
+from warnings import warn
+class LongTextWarning(Warning):
+    '''消息字数超长警告'''
+    #微信字数限制2000字，超长部分不发送，这时需要转化为word发送
+    pass
+class InputMethodWarning(Warning):#使用pywinauto的type_keys方法时
+    #电脑的输入法为微信输入法时无法打字，需要及时转换为ctrl+v复制消息发送，并按下win+空格切换一下输入法
+    '''输入法警告'''
+    pass
+class ChatHistoryNotEnough(Warning):
+    '''聊天记录不足指定的个数'''
+    pass