android-notify 1.59.3__tar.gz → 1.59.4__tar.gz

{android_notify-1.59.3 → android_notify-1.59.4}/PKG-INFO

@@ -1,119 +1,119 @@
-Metadata-Version: 2.4
-Name: android-notify
-Version: 1.59.3
-Summary: A Python package that simplifies creating Android notifications in Kivy apps.
-Home-page: https://android-notify.vercel.app
-Author: Fabian
-Author-email: fector101@yahoo.com
-License: MIT
-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
-Keywords: android,notifications,kivy,mobile,post-notifications,pyjnius,android-notifications,kivy-notifications,python-android,mobile-development,push-notifications,mobile-app,kivy-application
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: Android
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-Requires-Dist: kivy>=2.0.0
-Requires-Dist: pyjnius>=1.4.2
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license
-Dynamic: project-url
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-<div align="center">
-    <br>
-    <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
-
-- **Multiple Notification Styles**: Support for various notification styles including:
-  - Simple text notifications
-  - Progress bar notifications (determinate and indeterminate)
-  - Big text notifications
-  - Inbox-style notifications
-  - Large icon notifications
-  - Big picture notifications
-  - Combined image styles
-
-- **Rich Functionality**:
-  - Add action buttons with custom callbacks
-  - Update notification content dynamically
-  - Manage progress bars with fine-grained control
-  - 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
-
-```python
-from android_notify import Notification
-
-# Simple notification
-Notification(
-    title="Hello",
-    message="This is a basic notification."
-).send()
-
-```
-
-**Sample Image:**  
-![basic notification img sample](https://raw.githubusercontent.com/Fector101/android_notify/main/docs/imgs/basicnoti.jpg)
-
-## Installation
-
-In your **`buildozer.spec`** file, ensure you include the following:
-
-```ini
-# Add pyjnius so ensure it's packaged with the build
-requirements = python3, kivy, pyjnius, android-notify
-# Add permission for notifications
-android.permissions = POST_NOTIFICATIONS
-
-# Required dependencies (write exactly as shown, no quotation marks)
-android.gradle_dependencies = androidx.core:core:1.6.0, androidx.core:core-ktx:1.15.0
-android.enable_androidx = True
-android.api = 35
-```
-
-Can be installed via `pip` For testing purposes:
-
-```bash
-pip install android_notify
-```
-
-## Documentation
-
-For full documentation, examples, and advanced usage, API reference visit the
-[documentation](https://android-notify.vercel.app)
-
-## ☕ Support the Project
-
-If you find this project helpful, consider buying me a coffee! 😊 Or Giving it a star on 🌟 [GitHub](https://github.com/Fector101/android_notify/) Your support helps maintain and improve the project.
-
-<a href="https://www.buymeacoffee.com/fector101" target="_blank">
-  <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="60">
-</a>
+Metadata-Version: 2.4
+Name: android-notify
+Version: 1.59.4
+Summary: A Python package that simplifies creating Android notifications in Kivy apps.
+Home-page: https://android-notify.vercel.app
+Author: Fabian
+Author-email: fector101@yahoo.com
+License: MIT
+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
+Keywords: android,notifications,kivy,mobile,post-notifications,pyjnius,android-notifications,kivy-notifications,python-android,mobile-development,push-notifications,mobile-app,kivy-application
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Android
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: kivy>=2.0.0
+Requires-Dist: pyjnius>=1.4.2
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+<div align="center">
+    <br>
+    <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
+
+- **Multiple Notification Styles**: Support for various notification styles including:
+  - Simple text notifications
+  - Progress bar notifications (determinate and indeterminate)
+  - Big text notifications
+  - Inbox-style notifications
+  - Large icon notifications
+  - Big picture notifications
+  - Combined image styles
+
+- **Rich Functionality**:
+  - Add action buttons with custom callbacks
+  - Update notification content dynamically
+  - Manage progress bars with fine-grained control
+  - 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
+
+```python
+from android_notify import Notification
+
+# Simple notification
+Notification(
+    title="Hello",
+    message="This is a basic notification."
+).send()
+
+```
+
+**Sample Image:**  
+![basic notification img sample](https://raw.githubusercontent.com/Fector101/android_notify/main/docs/imgs/basicnoti.jpg)
+
+## Installation
+
+In your **`buildozer.spec`** file, ensure you include the following:
+
+```ini
+# Add pyjnius so ensure it's packaged with the build
+requirements = python3, kivy, pyjnius, android-notify
+# Add permission for notifications
+android.permissions = POST_NOTIFICATIONS
+
+# Required dependencies (write exactly as shown, no quotation marks)
+android.gradle_dependencies = androidx.core:core:1.6.0, androidx.core:core-ktx:1.15.0
+android.enable_androidx = True
+android.api = 35
+```
+
+Can be installed via `pip` For testing purposes:
+
+```bash
+pip install android_notify
+```
+
+## Documentation
+
+For full documentation, examples, and advanced usage, API reference visit the
+[documentation](https://android-notify.vercel.app)
+
+## ☕ Support the Project
+
+If you find this project helpful, consider buying me a coffee! 😊 Or Giving it a star on 🌟 [GitHub](https://github.com/Fector101/android_notify/) Your support helps maintain and improve the project.
+
+<a href="https://www.buymeacoffee.com/fector101" target="_blank">
+  <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="60">
+</a>

{android_notify-1.59.3 → android_notify-1.59.4}/android_notify/sword.py

@@ -105,6 +105,7 @@ class Notification(BaseNotification):
     button_ids=[0]
     btns_box={}
     main_functions={}
+    passed_check = False
 
     # During Development (When running on PC)
     BaseNotification.logs=not ON_ANDROID
@@ -125,7 +126,9 @@ class Notification(BaseNotification):
 
         # For components
         self.__lines = []
-
+        self.__builder = None # want to make builder always available for getter
+        self.notification_manager = None
+        
         self.__format_channel(self.channel_name, self.channel_id)
         if not ON_ANDROID:
             return
@@ -419,29 +422,51 @@ class Notification(BaseNotification):
             persistent (bool): True To not remove Notification When User hits clears All notifications button
             close_on_click (bool): True if you want Notification to be removed when clicked
         """
-        self.silent= silent or self.silent
+        self.silent = silent or self.silent
         if ON_ANDROID:
             self.__start_notification_build(persistent, close_on_click)
             self.__dispatch_notification()
+        
+        self.__send_logs()
+    
+    def send_(self,silent:bool=False,persistent=False,close_on_click=True):
+        """Sends notification without checking for additional notification permission
 
-        if self.logs:
-            string_to_display=''
-            print("\n Sent Notification!!!")
-            for name,value in vars(self).items():
-                if value and name in ["title", "message", "style", "body", "large_icon_path", "big_picture_path", "progress_current_value", "progress_max_value", "channel_name",'body','name']:
-                    if name == "progress_max_value":
-                        if self.style == NotificationStyles.PROGRESS:
-                            string_to_display += f'\n {name}: {value}'
-                    elif name == "body":
-                        if self.style == NotificationStyles.BIG_TEXT:
-                            string_to_display += f'\n {name}: {value}'
-                    else:
-                        string_to_display += f'\n {name}: {value}'
+        Args:
+            silent (bool): True if you don't want to show briefly on screen
+            persistent (bool): True To not remove Notification When User hits clears All notifications button
+            close_on_click (bool): True if you want Notification to be removed when clicked
+        """        
+        self.passed_check = True
+        self.send(silent,persistent,close_on_click)
 
-            string_to_display +="\n (Won't Print Logs When Complied,except if selected `Notification.logs=True`)"
-            print(string_to_display)
-            if DEV:
-                print(f'channel_name: {self.channel_name}, Channel ID: {self.channel_id}, __id: {self.__id}')
+    def __send_logs(self):
+        if not self.logs:
+            return
+        string_to_display=''
+        print("\n Sent Notification!!!")
+        displayed_args = [
+            "title", "message",
+            "style", "body", "large_icon_path", "big_picture_path",
+            "progress_max_value",
+            'name', "channel_name",
+            ]
+        is_progress_not_default = isinstance(self.progress_current_value, int) or (isinstance(self.progress_current_value, float) and self.progress_current_value != 0.0)
+        for name,value in vars(self).items():
+            if value and name in displayed_args:
+                if name == "progress_max_value":
+                    if is_progress_not_default:
+                        string_to_display += f'\n progress_current_value: {self.progress_current_value}, {name}: {value}'
+                elif name == "channel_name":
+                    string_to_display += f'\n {name}: {value}, channel_id: {self.channel_id}'
+                else:
+                    string_to_display += f'\n {name}: {value}'
+
+        string_to_display +="\n (Won't Print Logs When Complied,except if selected `Notification.logs=True`)"
+        print(string_to_display)
+
+    def builder(self):
+        return self.__builder
 
     def addButton(self, text:str,on_release):
         """For adding action buttons
@@ -556,8 +581,14 @@ class Notification(BaseNotification):
             print('Added Lines: ', lines)
 
     def __dispatch_notification(self):
-        if NotificationHandler.has_permission():
-            self.notification_manager.notify(self.__id, self.__builder.build())
+        # self.passed_check is for self.send_() some devices don't return true when checking for permission when it's actually True in settings
+        # And so users can do Notification.passed_check = True at top of their file and use regular .send()
+        if self.passed_check or NotificationHandler.has_permission():
+            try:
+                self.notification_manager.notify(self.__id, self.__builder.build())
+            except Exception as notify_error:
+                print('Exception:', notify_error)
+                print('Failed to send traceback:', traceback.format_exc())
         else:
             print('Permission not granted to send notifications')
             # Not asking for permission too frequently, This makes dialog popup to stop showing

{android_notify-1.59.3 → android_notify-1.59.4}/android_notify.egg-info/PKG-INFO

@@ -1,119 +1,119 @@
-Metadata-Version: 2.4
-Name: android-notify
-Version: 1.59.3
-Summary: A Python package that simplifies creating Android notifications in Kivy apps.
-Home-page: https://android-notify.vercel.app
-Author: Fabian
-Author-email: fector101@yahoo.com
-License: MIT
-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
-Keywords: android,notifications,kivy,mobile,post-notifications,pyjnius,android-notifications,kivy-notifications,python-android,mobile-development,push-notifications,mobile-app,kivy-application
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: Android
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-Requires-Dist: kivy>=2.0.0
-Requires-Dist: pyjnius>=1.4.2
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license
-Dynamic: project-url
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-<div align="center">
-    <br>
-    <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
-
-- **Multiple Notification Styles**: Support for various notification styles including:
-  - Simple text notifications
-  - Progress bar notifications (determinate and indeterminate)
-  - Big text notifications
-  - Inbox-style notifications
-  - Large icon notifications
-  - Big picture notifications
-  - Combined image styles
-
-- **Rich Functionality**:
-  - Add action buttons with custom callbacks
-  - Update notification content dynamically
-  - Manage progress bars with fine-grained control
-  - 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
-
-```python
-from android_notify import Notification
-
-# Simple notification
-Notification(
-    title="Hello",
-    message="This is a basic notification."
-).send()
-
-```
-
-**Sample Image:**  
-![basic notification img sample](https://raw.githubusercontent.com/Fector101/android_notify/main/docs/imgs/basicnoti.jpg)
-
-## Installation
-
-In your **`buildozer.spec`** file, ensure you include the following:
-
-```ini
-# Add pyjnius so ensure it's packaged with the build
-requirements = python3, kivy, pyjnius, android-notify
-# Add permission for notifications
-android.permissions = POST_NOTIFICATIONS
-
-# Required dependencies (write exactly as shown, no quotation marks)
-android.gradle_dependencies = androidx.core:core:1.6.0, androidx.core:core-ktx:1.15.0
-android.enable_androidx = True
-android.api = 35
-```
-
-Can be installed via `pip` For testing purposes:
-
-```bash
-pip install android_notify
-```
-
-## Documentation
-
-For full documentation, examples, and advanced usage, API reference visit the
-[documentation](https://android-notify.vercel.app)
-
-## ☕ Support the Project
-
-If you find this project helpful, consider buying me a coffee! 😊 Or Giving it a star on 🌟 [GitHub](https://github.com/Fector101/android_notify/) Your support helps maintain and improve the project.
-
-<a href="https://www.buymeacoffee.com/fector101" target="_blank">
-  <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="60">
-</a>
+Metadata-Version: 2.4
+Name: android-notify
+Version: 1.59.4
+Summary: A Python package that simplifies creating Android notifications in Kivy apps.
+Home-page: https://android-notify.vercel.app
+Author: Fabian
+Author-email: fector101@yahoo.com
+License: MIT
+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
+Keywords: android,notifications,kivy,mobile,post-notifications,pyjnius,android-notifications,kivy-notifications,python-android,mobile-development,push-notifications,mobile-app,kivy-application
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Android
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: kivy>=2.0.0
+Requires-Dist: pyjnius>=1.4.2
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+<div align="center">
+    <br>
+    <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
+
+- **Multiple Notification Styles**: Support for various notification styles including:
+  - Simple text notifications
+  - Progress bar notifications (determinate and indeterminate)
+  - Big text notifications
+  - Inbox-style notifications
+  - Large icon notifications
+  - Big picture notifications
+  - Combined image styles
+
+- **Rich Functionality**:
+  - Add action buttons with custom callbacks
+  - Update notification content dynamically
+  - Manage progress bars with fine-grained control
+  - 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
+
+```python
+from android_notify import Notification
+
+# Simple notification
+Notification(
+    title="Hello",
+    message="This is a basic notification."
+).send()
+
+```
+
+**Sample Image:**  
+![basic notification img sample](https://raw.githubusercontent.com/Fector101/android_notify/main/docs/imgs/basicnoti.jpg)
+
+## Installation
+
+In your **`buildozer.spec`** file, ensure you include the following:
+
+```ini
+# Add pyjnius so ensure it's packaged with the build
+requirements = python3, kivy, pyjnius, android-notify
+# Add permission for notifications
+android.permissions = POST_NOTIFICATIONS
+
+# Required dependencies (write exactly as shown, no quotation marks)
+android.gradle_dependencies = androidx.core:core:1.6.0, androidx.core:core-ktx:1.15.0
+android.enable_androidx = True
+android.api = 35
+```
+
+Can be installed via `pip` For testing purposes:
+
+```bash
+pip install android_notify
+```
+
+## Documentation
+
+For full documentation, examples, and advanced usage, API reference visit the
+[documentation](https://android-notify.vercel.app)
+
+## ☕ Support the Project
+
+If you find this project helpful, consider buying me a coffee! 😊 Or Giving it a star on 🌟 [GitHub](https://github.com/Fector101/android_notify/) Your support helps maintain and improve the project.
+
+<a href="https://www.buymeacoffee.com/fector101" target="_blank">
+  <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="60">
+</a>

{android_notify-1.59.3 → android_notify-1.59.4}/setup.cfg

@@ -1,4 +1,4 @@
-[egg_info]
-tag_build = 
-tag_date = 0
-
+[egg_info]
+tag_build = 
+tag_date = 0
+

{android_notify-1.59.3 → android_notify-1.59.4}/setup.py

@@ -6,7 +6,7 @@ with open("README.md", "r", encoding="utf-8") as readme_data:
 
 setup(
     name="android-notify",
-    version="1.59.3",
+    version="1.59.4",
     author="Fabian",
     author_email='fector101@yahoo.com',
     description="A Python package that simplifies creating Android notifications in Kivy apps.",