whatsapp-python 4.0.2__tar.gz → 4.2.0__tar.gz

{whatsapp_python-4.0.2 → whatsapp_python-4.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: whatsapp-python
-Version: 4.0.2
+Version: 4.2.0
 Summary: Open source Python wrapper for the WhatsApp Cloud API
 Project-URL: Homepage, https://github.com/filipporomani/whatsapp-python
 Project-URL: Docs, https://github.com/filipporomani/whatsapp-python/wiki
@@ -8,7 +8,6 @@ Project-URL: Issues Reporting, https://github.com/filipporomani/whatsapp-python/
 Project-URL: Download, https://github.com/filipporomani/whatsapp-python/releases/latest
 Project-URL: Changelog, https://github.com/filipporomani/whatsapp-python/releases
 Author-email: Filippo Romani <mail@filipporomani.it>
-License-File: LICENSE
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Customer Service
 Classifier: Intended Audience :: Developers
@@ -72,16 +71,19 @@ Documentation is available in the [wiki](https://github.com/filipporomani/whatsa
 
 ## Why choose this library?
 
-The main reason why I decided to fork the original library is that it uses an old version of the API, it's missing many and it's not mantained anymore.
+The main reason why I decided to fork the original `heyoo` library is that it uses an old version of the API, it's missing many and it's not mantained anymore.
 
 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

{whatsapp_python-4.0.2 → whatsapp_python-4.2.0}/README.md

@@ -35,16 +35,19 @@ Documentation is available in the [wiki](https://github.com/filipporomani/whatsa
 
 ## Why choose this library?
 
-The main reason why I decided to fork the original library is that it uses an old version of the API, it's missing many and it's not mantained anymore.
+The main reason why I decided to fork the original `heyoo` library is that it uses an old version of the API, it's missing many and it's not mantained anymore.
 
 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

whatsapp_python-4.2.0/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())

whatsapp_python-4.2.0/tests.py

@@ -0,0 +1,128 @@
+from whatsapp import WhatsApp, Message
+from dotenv import load_dotenv
+from os import getenv
+
+load_dotenv()
+token = getenv("GRAPH_API_TOKEN")
+phone_number_id = {1: getenv("TEST_PHONE_NUMBER_ID")}
+dest_phone_number = getenv("DEST_PHONE_NUMBER")
+
+app = WhatsApp(token=token, phone_number_id=phone_number_id,
+               update_check=False)
+msg = app.create_message(to=dest_phone_number, content="Hello world")
+
+
+# test every single method and print the result
+print("Testing send_text")
+msg.send(sender=1)
+
+print("Testing send_reply_button")
+v = 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 = 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 = 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 = 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 = 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 = 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 = app.send_location("37.7749", "-122.4194", "test",
+                      "test, test", dest_phone_number, sender=1)
+print(f"send_location: {v}")
+print("sending template")
+v = 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