android-notify 1.60.7.dev0__tar.gz → 1.60.8.dev0__tar.gz

{android_notify-1.60.7.dev0 → android_notify-1.60.8.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: android-notify
-Version: 1.60.7.dev0
+Version: 1.60.8.dev0
 Summary: A Python package that simplifies creating Android notifications in Kivy and Flet apps.
 Author-email: Fabian <fector101@yahoo.com>
 License-Expression: MIT
@@ -81,7 +81,7 @@ 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==1.60.7.dev0
+requirements = python3, kivy, pyjnius, android-notify==1.60.8.dev0
 # Add permission for notifications
 android.permissions = POST_NOTIFICATIONS
 ```
@@ -99,7 +99,7 @@ In your `pyproject.toml` file, ensure you include the following:
 ```toml
 [tool.flet.android]
 dependencies = [
-  "pyjnius","android-notify==1.60.7.dev0"
+  "pyjnius","android-notify==1.60.8.dev0"
 ]
 
 [tool.flet.android.permission]
@@ -117,10 +117,10 @@ dependencies = [
 <br/>
 
 On the [pydroid 3](https://play.google.com/store/apps/details?id=ru.iiec.pydroid3) mobile app for running python code you can test some features.
-- In pip section where you're asked to insert `Libary name` paste `android-notify==1.60.7.dev0`
+- In pip section where you're asked to insert `Libary name` paste `android-notify==1.60.8.dev0`
 - Minimal working example 
 ```py
-# Testing with `android-notify==1.60.7.dev0` on pydroid
+# Testing with `android-notify==1.60.8.dev0` on pydroid
 from kivy.app import App
 from kivy.uix.boxlayout import BoxLayout
 from kivy.uix.button import Button

{android_notify-1.60.7.dev0 → android_notify-1.60.8.dev0}/README.md

@@ -58,7 +58,7 @@ 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==1.60.7.dev0
+requirements = python3, kivy, pyjnius, android-notify==1.60.8.dev0
 # Add permission for notifications
 android.permissions = POST_NOTIFICATIONS
 ```
@@ -76,7 +76,7 @@ In your `pyproject.toml` file, ensure you include the following:
 ```toml
 [tool.flet.android]
 dependencies = [
-  "pyjnius","android-notify==1.60.7.dev0"
+  "pyjnius","android-notify==1.60.8.dev0"
 ]
 
 [tool.flet.android.permission]
@@ -94,10 +94,10 @@ dependencies = [
 <br/>
 
 On the [pydroid 3](https://play.google.com/store/apps/details?id=ru.iiec.pydroid3) mobile app for running python code you can test some features.
-- In pip section where you're asked to insert `Libary name` paste `android-notify==1.60.7.dev0`
+- In pip section where you're asked to insert `Libary name` paste `android-notify==1.60.8.dev0`
 - Minimal working example 
 ```py
-# Testing with `android-notify==1.60.7.dev0` on pydroid
+# Testing with `android-notify==1.60.8.dev0` on pydroid
 from kivy.app import App
 from kivy.uix.boxlayout import BoxLayout
 from kivy.uix.button import Button

{android_notify-1.60.7.dev0 → android_notify-1.60.8.dev0}/android_notify/__init__.py

@@ -1,5 +1,10 @@
-""""
-For Easier Imports For Public Classes
+"""
+Android-Notify
+=================
+
+For Creating Android Notifications In Python Apps.
+
+All the documentation is available at: https://android-notify.vercel.app/
 """
 from .core import send_notification
 from .styles import NotificationStyles

{android_notify-1.60.7.dev0 → android_notify-1.60.8.dev0}/android_notify/config.py

@@ -1,6 +1,6 @@
 import os
 
-__version__ = "1.60.7.dev0"
+__version__ = "1.60.8.dev0"
 
 
 from .internal.java_classes import autoclass, cast, NotificationManager

{android_notify-1.60.7.dev0 → android_notify-1.60.8.dev0}/android_notify/internal/helper.py

@@ -40,14 +40,16 @@ def get_package_path():
     return os.path.dirname(os.path.abspath(__file__))
 
 
-def execute_callback(callback,arg):
+def execute_callback(callback,arg, from_who="user"):
     """
     Executing Callbacks Safely
     """
-    if callback:
+    if not callback:
         return None
+    if from_who == "user":
+        logger.info(f"Executing On Permission Result Callback...")
     try:
-        if can_accept_arguments(callback, True):
+        if can_accept_arguments(callback, arg):
             callback(arg)
         else:
             callback()

{android_notify-1.60.7.dev0 → android_notify-1.60.8.dev0}/android_notify/internal/permissions.py

@@ -1,6 +1,7 @@
 """
 For Permission Related Blocks
 """
+import os.path
 
 from .logger import logger
 from android_notify.config import on_android_platform, on_flet_app, get_python_activity_context
@@ -45,10 +46,16 @@ def ask_notification_permission(callback=None, set_requesting_state=None, legacy
         logger.warning("Already have permission to send notifications")
         return None
 
-    if not can_show_permission_request_popup():
+    if not is_first_permission_ask() and not can_show_permission_request_popup():
         logger.warning("""Permission to send notifications has been denied permanently.
-        This happens when the user denies permission twice from the popup.
-        Opening notification settings...""")
+        This can happen when the user denies permission twice from the popup.
+        
+        Opening notification settings...
+        
+        Add in MDApp().on_resume():
+        >> if NotificationHandler.has_permission() and self.screen_manager:
+        >>      self.screen_manager.current = "home_screen"
+        """)
         open_notification_settings_screen()
         return None
 
@@ -57,7 +64,7 @@ def ask_notification_permission(callback=None, set_requesting_state=None, legacy
     def on_permissions_result(_, grants):
         # _ is permissions
         execute_callback(callback, grants[0])
-        execute_callback(set_requesting_state, False)
+        execute_callback(set_requesting_state, False,from_who="package")
 
     if legacy or on_flet_app():
         # TODO Handle activity with request code
@@ -66,12 +73,18 @@ def ask_notification_permission(callback=None, set_requesting_state=None, legacy
         return None
     else:
         from android.permissions import request_permissions, Permission  # type: ignore
-        execute_callback(set_requesting_state, True)
+        execute_callback(set_requesting_state, True,from_who="package")
         request_permissions([Permission.POST_NOTIFICATIONS], on_permissions_result)
         return None
 
 
 def open_notification_settings_screen():
+    """In MDApp().on_resume()
+
+    Example:
+        >>> if NotificationHandler.has_permission() and self.screen_manager:
+        >>>     self.screen_manager.current = "home_screen"
+    """
     context = get_python_activity_context()
 
     if not context:
@@ -114,3 +127,14 @@ def can_show_permission_request_popup():
         return False
 
     return context.shouldShowRequestPermissionRationale(Manifest.POST_NOTIFICATIONS)
+
+
+def is_first_permission_ask():
+    from importlib.resources import files
+    buffer_file_name = "ASKED_PERMISSION.txt"
+    absolute_buffer_file_path = str(files("android_notify") / buffer_file_name) # Making sure one path is always used
+
+    if os.path.exists(absolute_buffer_file_path):
+        return False
+    open(absolute_buffer_file_path,'w').close()
+    return True

{android_notify-1.60.7.dev0 → android_notify-1.60.8.dev0}/android_notify/tests/main.py

@@ -29,6 +29,7 @@ from android_notify.tests.test_notification_behavior import TestNotificationBeha
 from android_notify.tests.test_notification_progress import TestNotificationProgress
 from android_notify.tests.test_notification_sound import TestNotificationSound
 from android_notify.tests.test_notification_clear import TestClearNotifications
+from android_notify.tests.test_notification_permission import NOTIFICATION_PERMISSION_TESTS
 from kivy.clock import Clock
 
 # -----------------------------
@@ -82,6 +83,7 @@ class TripleClickButton(Button):
 class AndroidNotifyDemoApp(MDApp):
 
     def on_start(self):
+        print('starting app...')
         try:
             from kivymd.toast import toast
             name = NotificationHandler.get_name(on_start=True)
@@ -89,6 +91,7 @@ class AndroidNotifyDemoApp(MDApp):
         except Exception as e:
             print("Error getting notify name:", e)
 
+        print('on_start','-'*33)
 
         def android_service():
 
@@ -154,11 +157,28 @@ class AndroidNotifyDemoApp(MDApp):
             self.test_buttons.append(btn)
             main.add_widget(btn)
 
+        # Permission request needs human inputs for tests
+        for label, action in NOTIFICATION_PERMISSION_TESTS.items():
+            btn = self._btn(
+                f"Run: {label}",
+                lambda _, fn=action: self.run_action(fn, _)
+            )
+            main.add_widget(btn)
         return root
 
-    # -----------------------------
-    # Helper to make buttons
-    # -----------------------------
+    def run_action(self, action_fn, btn_instance):
+        btn_instance.disabled = True
+        print(f"\n▶ Running action: {action_fn.__name__}")
+
+        try:
+            action_fn()
+        except Exception as error_running_action:
+            print("error_running_action:", error_running_action)
+            traceback.print_exc()
+        finally:
+            # Re-enable AFTER user interaction finishes
+            btn_instance.disabled = False
+
     def _btn(self, text, callback, height=80):
         return TripleClickButton(
             text=text,
@@ -185,9 +205,6 @@ class AndroidNotifyDemoApp(MDApp):
             for btn in self.test_buttons:
                 btn.disabled = False
 
-    # -----------------------------
-    # Actions
-    # -----------------------------
     def request_permission(self, btn_instance):
         asks_permission_if_needed()
         btn_instance.disabled = False
@@ -204,16 +221,17 @@ class AndroidNotifyDemoApp(MDApp):
         btn_instance.disabled = False
 
     def on_resume(self):
+        print('resuming app..')
         try:
             from kivymd.toast import toast
             name = NotificationHandler.get_name()
-            toast(text=f"name: {name}", length_long=True)
+
+            toast(text=f"name: {name}, Permission:{NotificationHandler.has_permission()}", length_long=True)
         except Exception as e:
             print("Error getting notify name:", e)
+        print('on_resume','-'*33)
+
 
 
-# -----------------------------
-# Entry
-# -----------------------------
 if __name__ == "__main__":
     AndroidNotifyDemoApp().run()

android_notify-1.60.8.dev0/android_notify/tests/test_notification_permission.py

@@ -0,0 +1,38 @@
+# android_notify/tests/basic_notification_actions.py
+
+from android_notify import NotificationHandler
+from android_notify.internal.permissions import ask_notification_permission
+from android_notify.core import asks_permission_if_needed
+
+
+def ask_permission_no_callback():
+    NotificationHandler.asks_permission()
+
+
+def ask_permission_with_callback():
+    def some_callback(answer):
+        print(f"Hey Dude, Notification Request result {answer}.")
+    NotificationHandler.asks_permission(some_callback)
+
+
+def ask_permission_simple_regular():
+    asks_permission_if_needed()
+
+
+def ask_permission_simple_legacy():
+    asks_permission_if_needed(legacy=True)
+
+
+def ask_permission_from_source():
+    def some_callback(answer):
+        print(f"Hey, Notification Request Request1: {answer}")
+    ask_notification_permission(callback=some_callback)
+
+
+NOTIFICATION_PERMISSION_TESTS = {
+    "permission (no callback)": ask_permission_no_callback,
+    "permission (with callback)": ask_permission_with_callback,
+    "permission (simple)": ask_permission_simple_regular,
+    "permission (legacy)": ask_permission_simple_legacy,
+    "permission (from source)": ask_permission_from_source,
+}

{android_notify-1.60.7.dev0 → android_notify-1.60.8.dev0}/android_notify/widgets/images.py

@@ -75,8 +75,6 @@ def icon_finder(icon_name):
         # noinspection PyPackageRequirements
         from importlib.resources import files
         return str(files("android_notify")/"fallback-icons"/icon_name)
-        # import pkg_resources
-        # return pkg_resources.resource_filename(__name__, f"fallback-icons/{icon_name}")
     except Exception:
         # Fallback if pkg_resources not available
         package_dir = get_package_path()

{android_notify-1.60.7.dev0 → android_notify-1.60.8.dev0}/android_notify.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: android-notify
-Version: 1.60.7.dev0
+Version: 1.60.8.dev0
 Summary: A Python package that simplifies creating Android notifications in Kivy and Flet apps.
 Author-email: Fabian <fector101@yahoo.com>
 License-Expression: MIT
@@ -81,7 +81,7 @@ 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==1.60.7.dev0
+requirements = python3, kivy, pyjnius, android-notify==1.60.8.dev0
 # Add permission for notifications
 android.permissions = POST_NOTIFICATIONS
 ```
@@ -99,7 +99,7 @@ In your `pyproject.toml` file, ensure you include the following:
 ```toml
 [tool.flet.android]
 dependencies = [
-  "pyjnius","android-notify==1.60.7.dev0"
+  "pyjnius","android-notify==1.60.8.dev0"
 ]
 
 [tool.flet.android.permission]
@@ -117,10 +117,10 @@ dependencies = [
 <br/>
 
 On the [pydroid 3](https://play.google.com/store/apps/details?id=ru.iiec.pydroid3) mobile app for running python code you can test some features.
-- In pip section where you're asked to insert `Libary name` paste `android-notify==1.60.7.dev0`
+- In pip section where you're asked to insert `Libary name` paste `android-notify==1.60.8.dev0`
 - Minimal working example 
 ```py
-# Testing with `android-notify==1.60.7.dev0` on pydroid
+# Testing with `android-notify==1.60.8.dev0` on pydroid
 from kivy.app import App
 from kivy.uix.boxlayout import BoxLayout
 from kivy.uix.button import Button

{android_notify-1.60.7.dev0 → android_notify-1.60.8.dev0}/android_notify.egg-info/SOURCES.txt

@@ -34,18 +34,19 @@ android_notify/tests/test_notification_appearance.py
 android_notify/tests/test_notification_behavior.py
 android_notify/tests/test_notification_channels.py
 android_notify/tests/test_notification_clear.py
+android_notify/tests/test_notification_permission.py
 android_notify/tests/test_notification_progress.py
 android_notify/tests/test_notification_sound.py
 android_notify/tests/test_notification_styles.py
+android_notify/tests/flet/adv/main.py
+android_notify/tests/flet/adv/tests/__init__.py
+android_notify/tests/flet/adv/tests/test_android_notify_full.py
+android_notify/tests/flet/basic/src/core.py
+android_notify/tests/flet/basic/src/main.py
+android_notify/tests/flet/flet-working/src/core.py
+android_notify/tests/flet/flet-working/src/main.py
 android_notify/tests/p4a/hook.py
 android_notify/tests/serivces/wallpaper.py
 android_notify/widgets/images.py
 android_notify/widgets/texts.py
-docs/examples/flet-working/src/core.py
-docs/examples/flet-working/src/main.py
-docs/tests/flet/adv/main.py
-docs/tests/flet/adv/tests/__init__.py
-docs/tests/flet/adv/tests/test_android_notify_full.py
-docs/tests/flet/basic/src/core.py
-docs/tests/flet/basic/src/main.py
 docs/website/src/pages/data/laner_Sent.py

{android_notify-1.60.7.dev0 → android_notify-1.60.8.dev0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "android-notify"
-version = "1.60.7.dev0"
+version = "1.60.8.dev0"
 description = "A Python package that simplifies creating Android notifications in Kivy and Flet apps."
 readme = { file = "README.md", content-type = "text/markdown" }
 authors = [