android-notify 1.59__py3-none-any.whl → 1.59.1__py3-none-any.whl

android_notify/an_utils.py

@@ -0,0 +1,10 @@
+"""Collection of useful functions"""
+
+import inspect
+def can_accept_arguments(func, *args, **kwargs):
+    try:
+        sig = inspect.signature(func)
+        sig.bind(*args, **kwargs)
+        return True
+    except TypeError:
+        return False

android_notify/styles.py

@@ -6,8 +6,14 @@ class NotificationStyles:
 
     PROGRESS = "progress"
     INBOX = "inbox"
+    
+    # v1.59+
+    # Deprecated
+    # setBigText == Notification(...,big_picture_path="...",style=NotificationStyles.BIG_TEXT)
+    # setLargeIcon == Notification(...,large_icon_path="...",style=NotificationStyles.LARGE_ICON)
+    # setBigPicture == Notification(...,body="...",style=NotificationStyles.BIG_PICTURE)
+    # Use .refresh to apply any new changes after .send
     BIG_TEXT = "big_text"
-
     LARGE_ICON = "large_icon"
     BIG_PICTURE = "big_picture"
     BOTH_IMGS = "both_imgs"

android_notify/sword.py

@@ -3,6 +3,7 @@ import traceback
 import os,re
 import threading
 from .an_types import Importance
+from .an_utils import can_accept_arguments
 from .styles import NotificationStyles
 from .base import BaseNotification
 DEV=0
@@ -218,7 +219,7 @@ class Notification(BaseNotification):
 
     def setSmallIcon(self,path):
         """
-        sets small icon to the top right
+        sets small icon to the top left
         :param path: can be `Relative Path` or `URL`
         :return:
         """
@@ -241,6 +242,10 @@ class Notification(BaseNotification):
             print('Done setting large icon')
 
     def setBigText(self,body):
+        """Sets a big text for when drop down button is pressed
+
+        :param body: The big text that will be displayed
+        """
         if ON_ANDROID:
             big_text_style = NotificationCompatBigTextStyle()
             big_text_style.bigText(str(body))
@@ -526,7 +531,12 @@ class Notification(BaseNotification):
         return True
 
     def __dispatch_notification(self):
-        self.notification_manager.notify(self.__id, self.__builder.build())
+        if NotificationHandler.has_permission():
+            self.notification_manager.notify(self.__id, self.__builder.build())
+        else:
+            print('Permission not granted to send notifications')
+            # Not asking for permission too frequently, This makes dialog popup to stop showing
+            # NotificationHandler.asks_permission()
 
     def __start_notification_build(self, persistent, close_on_click):
         self.__create_basic_notification(persistent, close_on_click)
@@ -768,7 +778,7 @@ class NotificationHandler:
     """For Notification Operations """
     __name = None
     __bound = False
-
+    __requesting_permission=False
     @classmethod
     def get_name(cls):
         """Returns name or id str for Clicked Notification."""
@@ -876,22 +886,38 @@ class NotificationHandler:
         return check_permission(Permission.POST_NOTIFICATIONS)
 
     @classmethod
+    @run_on_ui_thread
     def asks_permission(cls,callback=None):
         """
         Ask for permission to send notifications if needed.
+        Passes True to callback if access granted
         """
-        if not ON_ANDROID:
-            return
-        def on_permissions_result(permissions, grant):
-            print("Permission Grant State: ",grant)
+        if cls.__requesting_permission or not ON_ANDROID:
+            return True
+
+        def on_permissions_result(permissions, grants):
             try:
                 if callback:
-                    callback()
+                    if can_accept_arguments(callback, True):
+                        callback(grants[0])
+                    else:
+                        callback()
             except Exception as request_permission_error:
                 print('Exception: ',request_permission_error)
-                print('Permission request callback error: ',traceback.format_exc())
+                print('Permission response callback error: ',traceback.format_exc())
+            finally:
+                cls.__requesting_permission = False
+
         if not cls.has_permission():
+            cls.__requesting_permission = True
             request_permissions([Permission.POST_NOTIFICATIONS],on_permissions_result)
+        else:
+            cls.__requesting_permission = False
+            if callback:
+                if can_accept_arguments(callback,True):
+                    callback(True)
+                else:
+                    callback()
 
 
 NotificationHandler.bindNotifyListener()

{android_notify-1.59.dist-info → android_notify-1.59.1.dist-info}/METADATA

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: android-notify
-Version: 1.59
+Version: 1.59.1
 Summary: A Python package that simplifies creating Android notifications in Kivy apps.
-Home-page: https://github.com/fector101/android-notify
+Home-page: https://android-notify.vercel.app
 Author: Fabian
 Author-email: fector101@yahoo.com
 License: MIT
-Project-URL: Documentation, https://android-notify.vercel.app/getting-started
+Project-URL: Documentation, https://android-notify.vercel.app/
 Project-URL: Source, https://github.com/fector101/android-notify
 Project-URL: Tracker, https://github.com/fector101/android-notify/issues
 Project-URL: Funding, https://www.buymeacoffee.com/fector101
@@ -36,13 +36,13 @@ Dynamic: summary
 
 <div align="center">
     <br>
-    <h1> Android-Notifiy </h1>
-    <p><a href='https://android-notify.vercel.app/getting-started'>Android Notify</a> is a Python library for effortlessly creating and managing Android notifications in Kivy android apps.</p>
+    <h1> Android-Notify </h1>
+    <p><a href='https://android-notify.vercel.app'>Android Notify</a> is a Python library for effortlessly creating and managing Android notifications in Kivy apps.</p>
     <p>Supports various styles and ensures seamless integration, customization and Pythonic APIs.</p>
     <!-- <br> -->
     <!-- <img src="https://raw.githubusercontent.com/Fector101/android_notify/main/docs/imgs/democollage.jpg"> -->
 </div>
-<!-- 
+<!-- Channel [CRUD]
 The Android Notify package provides a simple yet comprehensive way to create and manage rich notifications on Android devices directly from your Python code. This library bridges the gap between Python and Android's notification system, giving you full control over notifications with a clean, Pythonic API. -->
 
 ## Features
@@ -60,10 +60,12 @@ The Android Notify package provides a simple yet comprehensive way to create and
   - Add action buttons with custom callbacks
   - Update notification content dynamically
   - Manage progress bars with fine-grained control
-  - Custom notification channels for Android 8.0+
+  - Custom notification Icon
+  - Custom notification channels for Android 8.0+ (Creating and Deleting)
   - Silent notifications
   - Persistent notifications
   - Click handlers and callbacks
+  - Cancel Notifications
 
 ## Quick Start
 
@@ -106,7 +108,7 @@ pip install android_notify
 ## Documentation
 
 For full documentation, examples, and advanced usage, API reference visit the
-[documentation](https://android-notify.vercel.app/getting-started)
+[documentation](https://android-notify.vercel.app)
 
 ## ☕ Support the Project
 

android_notify-1.59.1.dist-info/RECORD

@@ -0,0 +1,12 @@
+android_notify/__init__.py,sha256=lcLjyfegXgU7cyGhfSphAOBipXwemrVkdYy3mcF6X5Y,172
+android_notify/__main__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+android_notify/an_types.py,sha256=LlE0zzPskVG2topZx3mVETGu5MqnpThs58Ph392ocy4,2390
+android_notify/an_utils.py,sha256=Io34r5JTorH3EbeR0bIfQ-8-bF3xO1wiVnvqafA2qyw,245
+android_notify/base.py,sha256=Fgv3hf-vwu-GvivDsKxseOyeOrLmw1moNAv_mZKvA5M,3477
+android_notify/core.py,sha256=Per4HFwYwP-mxHJqnwcLlWXsbZsSeeAYN49MmFU2qVk,6113
+android_notify/styles.py,sha256=jLxeXB41HXe0fn3l07JZsHi-d0u-dESvsV_OqQow_Xc,726
+android_notify/sword.py,sha256=Zut_Yr2rYsgW4PcjI6bpfHA37Lj9bpvG_ni6DGAIQgE,38327
+android_notify-1.59.1.dist-info/METADATA,sha256=D62WBGubg7FG5Pr8AY-rVTkGF-BpmmKDkqBA2R6QuTI,4375
+android_notify-1.59.1.dist-info/WHEEL,sha256=ck4Vq1_RXyvS4Jt6SI0Vz6fyVs4GWg7AINwpsaGEgPE,91
+android_notify-1.59.1.dist-info/top_level.txt,sha256=IR1ONMrRSRINZpWn2X0dL5gbWwWINsK7PW8Jy2p4fU8,15
+android_notify-1.59.1.dist-info/RECORD,,

android_notify-1.59.dist-info/RECORD

@@ -1,11 +0,0 @@
-android_notify/__init__.py,sha256=lcLjyfegXgU7cyGhfSphAOBipXwemrVkdYy3mcF6X5Y,172
-android_notify/__main__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-android_notify/an_types.py,sha256=LlE0zzPskVG2topZx3mVETGu5MqnpThs58Ph392ocy4,2390
-android_notify/base.py,sha256=Fgv3hf-vwu-GvivDsKxseOyeOrLmw1moNAv_mZKvA5M,3477
-android_notify/core.py,sha256=Per4HFwYwP-mxHJqnwcLlWXsbZsSeeAYN49MmFU2qVk,6113
-android_notify/styles.py,sha256=QBkCY8ZO26FnS-jPtRLf9CKEEnnYylmH9enCa5CNDes,354
-android_notify/sword.py,sha256=hBNIJDDszEozbvkXHuWhmiRz-9q2Kz4WBEnV1LAe8vw,37291
-android_notify-1.59.dist-info/METADATA,sha256=U4RSxaMqEaWBoS82Kp5L66992cka8MixFGwYlqYQiHM,4347
-android_notify-1.59.dist-info/WHEEL,sha256=ck4Vq1_RXyvS4Jt6SI0Vz6fyVs4GWg7AINwpsaGEgPE,91
-android_notify-1.59.dist-info/top_level.txt,sha256=IR1ONMrRSRINZpWn2X0dL5gbWwWINsK7PW8Jy2p4fU8,15
-android_notify-1.59.dist-info/RECORD,,