add message file bot

Author: wj-Mcat

.gitignore

@@ -127,4 +127,6 @@ dmypy.json
 
 # Pyre type checker
 .pyre/
-token.txt
+token.txt
+.idea/
+**/logs/

examples/advanced/message-file-bot.py

@@ -0,0 +1,91 @@
+"""send contact card to specific contact"""
+# pylint: disable=R0801
+import asyncio
+import logging
+from typing import Optional, Union
+
+from wechaty_puppet import FileBox, ScanStatus  # type: ignore
+from wechaty_puppet import MessageType
+
+from wechaty import Wechaty, Contact
+from wechaty.user import Message, Room
+
+logging.basicConfig(level=logging.INFO)
+log = logging.getLogger(__name__)
+
+
+class MyBot(Wechaty):
+    """
+    listen wechaty event with inherited functions, which is more friendly for
+    oop developer
+    """
+    def __init__(self):
+        super().__init__()
+
+    async def on_message(self, msg: Message):
+        """
+        listen for message event
+        """
+        from_contact = msg.talker()
+        text = msg.text()
+        room = msg.room()
+        # send contact-card
+        print(msg)
+        if msg.type() == MessageType.MESSAGE_TYPE_CONTACT:
+            contact = await msg.to_contact()
+        room = self.Room.load('19961884194@chatroom')
+        await room.ready()
+
+        if text == 'send card':
+            # find one of my friend
+            contacts = await bot.Contact.find_all()
+            if contacts:
+                # send one of my friend to the talker
+                await from_contact.say(contacts[0])
+                print('have sended')
+        elif msg.type() == MessageType.MESSAGE_TYPE_IMAGE:
+            img = await msg.to_file_box()
+            await img.to_file(f'./{img.name}')
+
+            await room.say(img)
+
+        elif msg.type() == MessageType.MESSAGE_TYPE_VIDEO:
+            video = await msg.to_file_box()
+            await video.to_file(f'./{video.name}')
+
+            await room.say(video)
+
+        elif msg.type() == MessageType.MESSAGE_TYPE_AUDIO:
+            audio = await msg.to_file_box()
+            # save the audio file as local file
+            await audio.to_file(f'./{audio.name}')
+
+        print('done')
+
+    async def on_login(self, contact: Contact):
+        """login event. It will be triggered every time you login"""
+        log.info(f'user: {contact} has login')
+
+    async def on_scan(self, status: ScanStatus, qr_code: Optional[str] = None,
+                      data: Optional[str] = None):
+        """scan event, It will be triggered when you scan the qrcode to login.
+        And it will not be triggered when you have logined
+        """
+        contact = self.Contact.load(self.contact_id)
+        await contact.ready()
+        print(f'user <{contact}> scan status: {status.name} , '
+              f'qr_code: {qr_code}')
+
+
+bot: Optional[MyBot] = None
+
+
+async def main():
+    """doc"""
+    # pylint: disable=W0603
+    global bot
+    bot = MyBot()
+    await bot.start()
+
+
+asyncio.run(main())