feat: async implementation (#56)

Full asyncronous implementation of the library. 
For more infos please read the [dedicated wiki
page](https://github.com/filipporomani/whatsapp-python/wiki/Async)

Thanks to @Omigirl for the suggestion!

As this feature is still being tested, you may encounter bugs while
using it. In such case, please report them here so I can fix the ASAP! 😄


This closes #55.

README.md

@@ -40,11 +40,14 @@ The main reason why I decided to fork the original `heyoo` library is that it us
 In this fork I added app events (to listen to incoming messages) and implemented an easier way to send/receive messages and media by using the `Message` object.
 The API version is always up to date and I'm always adding new features and fixing bugs.
 
+I also added a full asyncronous version of the library, which is faster and more efficient than the syncronous one.
+
 I fixed some bugs and added many features, however the library can still be improved.
 
 ### Supported features:
 
 - Listening to events (messages, media, etc.)
+- Async version available
 - Sending messages
 - Sending messages from different numbers individually
 - Marking messages as read

async_test.py

@@ -0,0 +1,142 @@
+from whatsapp import WhatsApp, Message, AsyncWhatsApp
+from dotenv import load_dotenv
+from os import getenv
+import asyncio
+
+load_dotenv()
+token = getenv("GRAPH_API_TOKEN")
+phone_number_id = {1: getenv("TEST_PHONE_NUMBER_ID")}
+dest_phone_number = getenv("DEST_PHONE_NUMBER")
+
+app = AsyncWhatsApp(token=token, phone_number_id=phone_number_id,
+               update_check=False)
+loop = asyncio.get_event_loop()
+msg = app.create_message(to=dest_phone_number, content="Hello world")
+
+async def run_test():
+
+    # test every single method and print the result
+    print("Testing send_text")
+    v = await msg.send()
+    # print(v)
+    # await asyncio.sleep(1)
+    # print("Getting request status")
+    # print(v.result())
+
+
+    print("Testing send_reply_button")
+    v = await app.send_reply_button(
+        button={
+            "type": "button",
+            "body": {
+                    "text": "This is a test button"
+            },
+            "action": {
+                "buttons": [
+                    {
+                        "type": "reply",
+                        "reply": {
+                                "id": "b1",
+                                "title": "This is button 1"
+                        }
+                    },
+                    {
+                        "type": "reply",
+                        "reply": {
+                                "id": "b2",
+                                "title": "this is button 2"
+                        }
+                    }
+                ]
+            }
+        },
+        recipient_id=dest_phone_number,
+        sender=1
+
+    )
+    print(f"send_reply_button: {v}")
+
+
+    print("Creating button")
+    v = app.create_button(
+        button={
+            "header": {
+                "type": "text",
+                "text": "your-header-content"
+            },
+            "body": {
+                "text": "your-text-message-content"
+            },
+            "footer": {
+                "text": "your-footer-content"
+            },
+            "action": {
+                "button": "cta-button-content",
+                "sections": [
+                    {
+                        "title": "your-section-title-content",
+                        "rows": [
+                            {
+                                "id": "unique-row-identifier",
+                                "title": "row-title-content",
+                                "description": "row-description-content",
+                            }
+                        ]
+                    },
+                ]
+            }
+        },
+    )
+    print(f"create_button: {v}")
+    print("sending button")
+    v = await app.send_button({
+        "header": "Header Testing",
+        "body": "Body Testing",
+        "footer": "Footer Testing",
+        "action": {
+            "button": "cta-button-content",
+            "sections": [
+                {
+                    "title": "your-secti",
+                    "rows": [
+                        {
+                            "id": "unique-row-",
+                            "title": "row-title-",
+                            "description": "row-description-",
+                        }
+                    ]
+                },
+            ]
+        }
+    }, dest_phone_number, sender=1)
+    print(f"send_button: {v}")
+    print("sending image")
+    v = await app.send_image(
+        "https://file-examples.com/storage/feb05093336710053a32bc1/2017/10/file_example_JPG_1MB.jpg", dest_phone_number, sender=1)
+    print(f"send_image: {v}")
+    print("sending video")
+    v = await app.send_video(
+        "https://file-examples.com/storage/feb05093336710053a32bc1/2017/04/file_example_MP4_480_1_5MG.mp4", dest_phone_number, sender=1)
+    print(f"send_video: {v}")
+    print("sending audio")
+    v = await app.send_audio(
+        "https://file-examples.com/storage/feb05093336710053a32bc1/2017/11/file_example_MP3_1MG.mp3", dest_phone_number, sender=1)
+    print(f"send_audio: {v}")
+    print("sending document")
+    v = await app.send_document(
+        "https://file-examples.com/storage/feb05093336710053a32bc1/2017/10/file-example_PDF_1MB.pdf", dest_phone_number, sender=1)
+    print(f"send_document: {v}")
+    print("sending location")
+    v = await app.send_location("37.7749", "-122.4194", "test",
+                        "test, test", dest_phone_number, sender=1)
+    print(f"send_location: {v}")
+    print("sending template")
+    v = await app.send_template(
+        "hello_world", dest_phone_number, sender=1)
+    print(f"send_template: {v}") # this returns error if the phone number is not a test phone number
+
+    await asyncio.sleep(10)
+
+
+
+asyncio.run(run_test())