android-notify 1.3__py3-none-any.whl → 1.60.6.dev0__py3-none-any.whl

android_notify-1.60.6.dev0.dist-info/METADATA

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: android-notify
+Version: 1.60.6.dev0
+Summary: A Python package that simplifies creating Android notifications in Kivy and Flet apps.
+Author-email: Fabian <fector101@yahoo.com>
+License-Expression: MIT
+Project-URL: Homepage, https://android-notify.vercel.app
+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: 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: pyjnius>=1.4.2
+Provides-Extra: dev
+Requires-Dist: kivy>=2.0.0; extra == "dev"
+
+<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 and Flet 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](https://android-notify.vercel.app/components#progress-bars) (determinate and indeterminate)
+  - Large icon notifications
+  - Big picture notifications
+  - Combined image styles
+  - Custom notification Icon - [images section](https://android-notify.vercel.app/components#images)
+  - Big text notifications
+  - Inbox-style notifications
+  - Colored texts and Icons
+
+- **Rich Functionality**:
+  - Add action buttons with custom callbacks
+  - [Update notification](https://android-notify.vercel.app/advanced-methods#updating-notification) content dynamically
+  - Manage progress bars with fine-grained control
+  - [Custom notification channels](https://android-notify.vercel.app/advanced-methods#channel-management) 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
+
+### Kivy apps:  
+
+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.6.dev0
+# Add permission for notifications
+android.permissions = POST_NOTIFICATIONS
+```
+
+### Flet apps:  
+
+In your `pyproject.toml` file, ensure you include the following:
+
+```toml
+[tool.flet.android]
+dependencies = [
+  "pyjnius","android-notify>=1.60.6.dev0"
+]
+
+[tool.flet.android.permission]
+"android.permission.POST_NOTIFICATIONS" = true
+```
+
+### Pydroid 3
+In 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.6.dev0`
+
+
+### Testing
+Can be installed via `pip` For testing purposes:
+
+```bash
+pip install android_notify
+android-notify -v
+```
+
+## Documentation
+For Dev Version use
+```requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/without-androidx.zip```
+
+### To talk to BroadCast Listener From Buttons
+
+- Make things happen without being in your app
+```python
+
+from android_notify import Notification
+notification = Notification(title="Reciver Notification")
+notification.addButton(text="Stop", receiver_name="CarouselReceiver", action="ACTION_STOP")
+notification.addButton(text="Skip", receiver_name="CarouselReceiver", action="ACTION_SKIP")
+```
+You can use this [wiki](https://github.com/Fector101/android_notify/wiki/How-to#use-with-broadcast-listener-in-kivy) as a guide create a broadcast listener
+
+### To use colored text in your notifications
+
+- Copy the [res](https://github.com/Fector101/android_notify/tree/main/android_notify/res) folder to your app path.  
+Lastly in your `buildozer.spec` file
+- Add `source.include_exts = xml` and `android.add_resources = ./res`
+
+
+### To use Custom Sounds
+
+- Put audio files in `res/raw` folder,
+- Then from `buildozer.spec` point to res folder `android.add_resources = res`
+- and includes it's format `source.include_exts = wav`.
+
+Lastly From the code 
+```py
+# Create a custom notification channel with a unique sound resource for android 8+
+Notification.createChannel(
+    id="weird_sound_tester",
+    name="Weird Sound Tester",
+    description="A test channel used to verify custom notification sounds from the res/raw folder.",
+    res_sound_name="sneeze" # file name without .wav or .mp3
+)
+
+# Send a notification through the created channel
+n=Notification(
+    title="Custom Sound Notification",
+    message="This tests playback of a custom sound (sneeze.wav) stored in res/raw.",
+    channel_id="weird_sound_tester" # important tells notification to use right channel
+)
+n.setSound("sneeze")# for android 7 below 
+n.send()
+```
+
+### 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.60.6.dev0.dist-info/RECORD

@@ -0,0 +1,24 @@
+android_notify/__init__.py,sha256=lcLjyfegXgU7cyGhfSphAOBipXwemrVkdYy3mcF6X5Y,172
+android_notify/__main__.py,sha256=TqZBjgW5wO61QvCpZje-YDKhBehtxXJSa71aM0RHom8,684
+android_notify/an_types.py,sha256=8qFBx4qLOz_Z2VxVWW3BxBx3jOj0DGoJ6T8dxnkcTB0,10428
+android_notify/an_utils.py,sha256=1GD9E8a3zVAA7ThttGQbqZQj333e5I44WqY4uyLDaxs,7448
+android_notify/base.py,sha256=6HKFseaVwPgxk1BKSocUIN-x-uYFW6IbhUJyb2mPoBE,3709
+android_notify/config.py,sha256=VN1ixPL4p7qDCD4u1oyI3sQEvWaifWp8hUgFHHhns6M,5384
+android_notify/core.py,sha256=3tHMKBwkGR8QKOJNu1feN9l9hKXnDlfY9ao7LCKMnFk,9133
+android_notify/styles.py,sha256=-8ueetUAec1xCXkMV2dF8Ywep_bu-5hiT9_eyh5TTyU,899
+android_notify/sword.py,sha256=Z_N3d-4gfy09v4n67lYxjwR0j8EDXRXH0fVzj6T9plo,49496
+android_notify/fallback-icons/flet-appicon.png,sha256=HLLHbB0MYu4Gimp6C7oe5QHK1frNKgRUHvht88JqBdE,32278
+android_notify/fallback-icons/pydroid3-appicon.png,sha256=R54qUn-ohBLKxMauwQpkJtIPIkEFRA2AEdTAEdD3e9w,13403
+docs/examples/flet-working/src/core.py,sha256=Pzhp6IhmHadvg_7zYhBBGz8araeVsuy44MVUVpW91cY,9261
+docs/examples/flet-working/src/main.py,sha256=zTc6hOid6OBLiH9X1ha4MzvZE5qtVDjFFi7SJmfzsk4,1838
+docs/tests/flet/adv/main.py,sha256=xVPB4HL1xD2aWUucemb8ha60z-rr9em_Kw-5oUPfp8s,3555
+docs/tests/flet/adv/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+docs/tests/flet/adv/tests/test_android_notify_full.py,sha256=jlB0ME_F1HlcgIQeHQTMtj9fIVa80_SizHkIM5pUO44,7283
+docs/tests/flet/basic/src/core.py,sha256=Pzhp6IhmHadvg_7zYhBBGz8araeVsuy44MVUVpW91cY,9261
+docs/tests/flet/basic/src/main.py,sha256=nnBp3tSIeBUcinmeSc2q7aAYri_e1GyfljOrFzHzSVE,3993
+docs/website/src/pages/data/laner_Sent.py,sha256=QQI8MxDO9X37qTIiVrydajoKE-MnRpmKeLPRsgJcfbs,609
+android_notify-1.60.6.dev0.dist-info/METADATA,sha256=wYblJ6yOf-zGQdqbVEUMK4U-uBy8TJVbz79lC2C4X5k,6697
+android_notify-1.60.6.dev0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+android_notify-1.60.6.dev0.dist-info/entry_points.txt,sha256=pMWHYogqxd-a8tXQ97tjyxay8sTpFO15J0YX1CYJe4U,64
+android_notify-1.60.6.dev0.dist-info/top_level.txt,sha256=kH29wUCpnrTwPF-o2KxkgUGFCQ96BinxQ0j7LneHKnw,20
+android_notify-1.60.6.dev0.dist-info/RECORD,,

{android_notify-1.3.dist-info → android_notify-1.60.6.dev0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.6.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

android_notify-1.60.6.dev0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+android-notify = android_notify.__main__:main

{android_notify-1.3.dist-info → android_notify-1.60.6.dev0.dist-info}/top_level.txt

@@ -1 +1,2 @@
 android_notify
+docs

docs/examples/flet-working/src/core.py

@@ -0,0 +1,221 @@
+""" Non-Advanced Stuff """
+import random
+import os
+ON_ANDROID = False
+
+def on_flet_app():
+    return os.getenv("MAIN_ACTIVITY_HOST_CLASS_NAME")
+
+def get_activity_class_name():
+    ACTIVITY_CLASS_NAME = os.getenv("MAIN_ACTIVITY_HOST_CLASS_NAME") # flet python
+    if not ACTIVITY_CLASS_NAME:
+        try:
+            from android import config
+            ACTIVITY_CLASS_NAME = getattr(config, "JAVA_NAMESPACE", None)
+        except (ImportError, AttributeError):
+            ACTIVITY_CLASS_NAME = 'org.kivy.android'
+    return ACTIVITY_CLASS_NAME
+
+try:
+
+    from jnius import autoclass # Needs Java to be installed
+    # Get the required Java classes
+    ACTIVITY_CLASS_NAME = get_activity_class_name()
+    PythonActivity = autoclass(ACTIVITY_CLASS_NAME)
+    context = PythonActivity.mActivity # Get the app's context 
+    NotificationChannel = autoclass('android.app.NotificationChannel')
+    String = autoclass('java.lang.String')
+    Intent = autoclass('android.content.Intent')
+    PendingIntent = autoclass('android.app.PendingIntent')
+    BitmapFactory = autoclass('android.graphics.BitmapFactory')
+    BuildVersion = autoclass('android.os.Build$VERSION')    
+    ON_ANDROID=True
+except Exception as e:
+    print('\nThis Package Only Runs on Android !!! ---> Check "https://github.com/Fector101/android_notify/" to see design patterns and more info.\n')
+
+if ON_ANDROID:
+    try:
+        NotificationManagerCompat = autoclass('androidx.core.app.NotificationManagerCompat')                                       
+        NotificationCompat = autoclass('androidx.core.app.NotificationCompat')
+
+        # Notification Design
+        NotificationCompatBuilder = autoclass('androidx.core.app.NotificationCompat$Builder')
+        NotificationCompatBigTextStyle = autoclass('androidx.core.app.NotificationCompat$BigTextStyle')
+        NotificationCompatBigPictureStyle = autoclass('androidx.core.app.NotificationCompat$BigPictureStyle')
+        NotificationCompatInboxStyle = autoclass('androidx.core.app.NotificationCompat$InboxStyle')
+    except Exception as e:
+        print("""\n
+        Dependency Error: Add the following in buildozer.spec:
+        * android.gradle_dependencies = androidx.core:core-ktx:1.15.0, androidx.core:core:1.6.0
+        * android.enable_androidx = True
+        * android.permissions = POST_NOTIFICATIONS\n
+        """)
+
+
+def get_app_root_path():
+    if on_flet_app():
+        return os.path.join(context.getFilesDir().getAbsolutePath(),'flet')
+    else:
+        from android.storage import app_storage_path # type: ignore
+        return app_storage_path()
+    
+def asks_permission_if_needed():
+    """
+    Ask for permission to send notifications if needed.
+    """
+    if on_flet_app():
+        VERSION_CODES = autoclass('android.os.Build$VERSION_CODES')
+        ContextCompat = autoclass('androidx.core.content.ContextCompat')
+        # if you get error `Failed to find class: androidx/core/app/ActivityCompat`
+        #in proguard-rules.pro add `-keep class androidx.core.app.ActivityCompat { *; }`
+        ActivityCompat = autoclass('androidx.core.app.ActivityCompat')
+        Manifest = autoclass('android.Manifest$permission')
+        VERSION_CODES = autoclass('android.os.Build$VERSION_CODES')
+
+        if BuildVersion.SDK_INT >= VERSION_CODES.TIRAMISU:
+            permission = Manifest.POST_NOTIFICATIONS
+            granted = ContextCompat.checkSelfPermission(context, permission)
+
+            if granted != 0:  # PackageManager.PERMISSION_GRANTED == 0
+                ActivityCompat.requestPermissions(context, [permission], 101)
+    else: # android package is from p4a which is for kivy
+        try:
+            from android.permissions import request_permissions, Permission,check_permission # type: ignore
+            permissions=[Permission.POST_NOTIFICATIONS]
+            if not all(check_permission(p) for p in permissions):
+                request_permissions(permissions)
+        except Exception as e:
+            print("android_notify- error trying to request notification access: ", e)
+
+def get_image_uri(relative_path):
+    """
+    Get the absolute URI for an image in the assets folder.
+    :param relative_path: The relative path to the image (e.g., 'assets/imgs/icon.png').
+    :return: Absolute URI java Object (e.g., 'file:///path/to/file.png').
+    """
+    app_root_path = get_app_root_path() 
+    output_path = os.path.join(app_root_path,'app', relative_path)
+    # print(output_path,'output_path')  # /data/user/0/org.laner.lan_ft/files/app/assets/imgs/icon.png
+    
+    if not os.path.exists(output_path):
+        raise FileNotFoundError(f"\nImage not found at path: {output_path}\n")
+    
+    Uri = autoclass('android.net.Uri')
+    return Uri.parse(f"file://{output_path}")
+
+def get_icon_object(uri):
+    BitmapFactory = autoclass('android.graphics.BitmapFactory')
+    IconCompat = autoclass('androidx.core.graphics.drawable.IconCompat')
+
+    bitmap= BitmapFactory.decodeStream(context.getContentResolver().openInputStream(uri))
+    return IconCompat.createWithBitmap(bitmap)
+
+def insert_app_icon(builder,custom_icon_path):
+    if custom_icon_path:
+        try:
+            uri = get_image_uri(custom_icon_path)
+            icon = get_icon_object(uri)
+            builder.setSmallIcon(icon)
+        except Exception as e:
+            print('android_notify- error: ',e)
+            builder.setSmallIcon(context.getApplicationInfo().icon)
+    else:
+        print('Found res icon -->',context.getApplicationInfo().icon,'<--')
+        builder.setSmallIcon(context.getApplicationInfo().icon)
+
+def send_notification(
+    title:str,
+    message:str,
+    style=None,
+    img_path=None,
+    channel_name="Default Channel",
+    channel_id:str="default_channel",
+    custom_app_icon_path="",
+
+    big_picture_path='',
+    large_icon_path='',
+    big_text="",
+    lines=""
+    ):
+    """
+    Send a notification on Android.
+
+    :param title: Title of the notification.
+    :param message: Message body.
+    :param style: Style of the notification ('big_text', 'big_picture', 'inbox', 'large_icon').
+    :param img_path: Path to the image resource.
+    :param channel_id: Notification channel ID.(Default is lowercase channel name arg in lowercase)
+    """
+    if not ON_ANDROID:
+        print('This Package Only Runs on Android !!! ---> Check "https://github.com/Fector101/android_notify/" for Documentation.')
+        return
+
+    asks_permission_if_needed()
+    channel_id=channel_name.replace(' ','_').lower().lower() if not channel_id else channel_id
+    # Get notification manager
+    notification_manager = context.getSystemService(context.NOTIFICATION_SERVICE)
+
+    # importance= autoclass('android.app.NotificationManager').IMPORTANCE_HIGH # also works #NotificationManager.IMPORTANCE_DEFAULT
+    importance= NotificationManagerCompat.IMPORTANCE_HIGH #autoclass('android.app.NotificationManager').IMPORTANCE_HIGH also works #NotificationManager.IMPORTANCE_DEFAULT
+
+    # Notification Channel (Required for Android 8.0+)
+    if BuildVersion.SDK_INT >= 26:
+        channel = NotificationChannel(channel_id, channel_name,importance)
+        notification_manager.createNotificationChannel(channel)
+
+    # Build the notification
+    builder = NotificationCompatBuilder(context, channel_id)
+    builder.setContentTitle(title)
+    builder.setContentText(message)
+    insert_app_icon(builder,custom_app_icon_path)
+    builder.setDefaults(NotificationCompat.DEFAULT_ALL)
+    builder.setPriority(NotificationCompat.PRIORITY_HIGH)
+
+    if img_path:
+        print('android_notify- img_path arg deprecated use "large_icon_path or big_picture_path or custom_app_icon_path"instead ')
+
+    big_picture = None
+    if big_picture_path:
+        try:
+            big_picture = get_image_uri(big_picture_path)
+        except FileNotFoundError as e:
+            print('android_notify- Error Getting Uri for big_picture_path: ',e)
+
+    large_icon = None
+    if large_icon_path:
+        try:
+            large_icon = get_image_uri(large_icon_path)
+        except FileNotFoundError as e:
+            print('android_notify- Error Getting Uri for large_icon_path: ',e)
+
+
+    # Apply notification styles
+    try:
+        if big_text:
+            big_text_style = NotificationCompatBigTextStyle()
+            big_text_style.bigText(big_text)
+            builder.setStyle(big_text_style)
+
+        elif lines:
+            inbox_style = NotificationCompatInboxStyle()
+            for line in lines.split("\n"):
+                inbox_style.addLine(line)
+            builder.setStyle(inbox_style)
+
+        if large_icon:
+            bitmap = BitmapFactory.decodeStream(context.getContentResolver().openInputStream(large_icon))
+            builder.setLargeIcon(bitmap)
+
+        if big_picture:
+            bitmap = BitmapFactory.decodeStream(context.getContentResolver().openInputStream(big_picture))
+            builder.setLargeIcon(bitmap)
+            big_picture_style = NotificationCompatBigPictureStyle().bigPicture(bitmap)
+            builder.setStyle(big_picture_style)
+
+    except Exception as e:
+        print('android_notify- Error Failed Adding Style: ',e)
+    # Display the notification
+    notification_id = random.randint(0, 100)
+    notification_manager.notify(notification_id, builder.build())
+    return notification_id
+

docs/examples/flet-working/src/main.py

@@ -0,0 +1,68 @@
+import flet as ft
+import os,traceback
+
+
+md1 = """ """
+i=0
+
+def main(page: ft.Page): 
+    page.scroll = ft.ScrollMode.ADAPTIVE
+    mdObj=ft.Markdown(
+            md1,
+            selectable=True,
+            extension_set=ft.MarkdownExtensionSet.GITHUB_WEB,
+            on_tap_link=lambda e: page.launch_url(e.data),
+        )
+    def console(a):
+        global md1
+        try:
+            with open(os.getenv("FLET_APP_CONSOLE"), "r") as f:
+                md1 = f.read()
+                mdObj.value=md1
+        except Exception as e:
+            print(e,"hello readddd it's me")
+            mdObj.value=f"{e}, hello readddd it's me"
+        finally:
+            mdObj.update()
+
+    def send_basic(e):
+        
+        try:
+            from core import send_notification
+            send_notification(title='Hello World',message='From android_notify',custom_app_icon_path=f'assets/icon.png')
+        except Exception as e:
+            print("Error importing android_notify: {}".format(e))
+    
+    def log_stuff(e):
+        global i
+        i+=1
+        print('Testing print visiblity: ',i,'\n')
+        console(None)
+
+    def request_permission(e):
+        try:
+            from core import asks_permission_if_needed
+            asks_permission_if_needed()
+        except Exception as e:
+            print( f"pyjnius android_ import error: {traceback.format_exc()}"            ) 
+
+    
+ 
+
+    page.add(
+        ft.OutlinedButton(
+            "Request Permission if Needed",
+            on_click=request_permission,
+        ), ft.OutlinedButton(
+            "Refresh Prints",
+            on_click=console,
+        ), ft.OutlinedButton(
+            "Testing print visiblity",
+            on_click=log_stuff,
+        )
+    )
+    btn = ft.ElevatedButton("Click me!", on_click=send_basic)
+    page.add(btn)
+    page.add(mdObj)
+
+ft.app(main)

docs/tests/flet/adv/main.py

@@ -0,0 +1,97 @@
+import os,traceback,io,sys,unittest
+import flet as ft
+from contextlib import redirect_stdout
+from android_notify.core import get_app_root_path,asks_permission_if_needed
+
+md1=''
+i=0
+def main(page: ft.Page):
+    page.scroll = ft.ScrollMode.ADAPTIVE
+    page.add(ft.Text("1111111111 Android Notify Test Results", size=24, weight=ft.FontWeight.BOLD))
+    logs_path=os.path.join(get_app_root_path(),'last.txt')
+    mdObj = ft.Markdown(
+        md1,
+        selectable=True,
+        extension_set=ft.MarkdownExtensionSet.GITHUB_WEB,
+        on_tap_link=lambda e: page.launch_url(e.data),
+    )
+    page.add(mdObj)
+    def console(a):
+        global md1,i
+        i+=1
+        print('Testing print visibility: ',i,'\n')
+        try:
+            if os.getenv("FLET_APP_CONSOLE"):
+                with open(os.getenv("FLET_APP_CONSOLE"), "r") as f:
+                    md1 = f.read()
+                    mdObj.value = md1
+
+            with open(logs_path, 'r') as logf:
+                mdObj.value = logf.read() + md1
+        except Exception as err:
+            mdObj.value = f"Error reading log: {err}"
+        finally:
+            mdObj.update()
+
+
+    def send_basic(e):
+        """Send a notification to verify android_notify works"""
+        try:
+            from android_notify import Notification
+            Notification(title="Hello World", message="From android_notify").send()
+        except Exception as err:
+            mdObj.value = f"Notification error: {err}"
+            mdObj.update()
+    def asks_permission_if_needed_(e):
+        asks_permission_if_needed()
+
+
+    def ensure_tests_folder():
+        try:
+            base_path = get_app_root_path()
+        except Exception:
+            base_path = os.path.dirname(__file__)
+
+        tests_path = os.path.join(base_path, "tests")
+        os.makedirs(tests_path, exist_ok=True)
+        init_file = os.path.join(tests_path, "__init__.py")
+        if not os.path.exists(init_file):
+            open(init_file, "w").close()
+
+        page.add(ft.Text(f"{tests_path}", size=24, weight=ft.FontWeight.BOLD))
+        return tests_path
+
+    page.add(ft.Text("2222222222 Android Notify Test Results", size=24, weight=ft.FontWeight.BOLD))
+
+    def run_tests(e=None):
+        """Run tests and log results to /sdcard/flet_app_console.txt"""
+        tests_path = ensure_tests_folder()
+
+        try:
+            with open(logs_path, "w") as logf, redirect_stdout(logf):
+                loader = unittest.TestLoader()
+                suite = loader.discover(start_dir=tests_path, pattern="test_*.py")
+                print("Discovered tests:",suite.countTestCases())
+                if suite.countTestCases() ==0:
+                    print("No tests found")
+
+
+                runner = unittest.TextTestRunner(stream=logf, verbosity=2)
+                runner.run(suite)
+
+            mdObj.value = f"Tests complete. Log saved to:\n`{logs_path}`"
+        except Exception as err:
+            mdObj.value = f"Test error:\n{traceback.format_exc()}"
+        mdObj.update()
+    def has_per(e=None):
+        from android_notify import NotificationHandler
+        print('permmm:',NotificationHandler.has_permission())
+    page.add(
+        ft.OutlinedButton("🔔 Send Basic Notification", on_click=send_basic),
+        ft.OutlinedButton("🔁 Refresh Prints", on_click=console),
+        ft.OutlinedButton("🧪 Run Tests", on_click=run_tests),
+        ft.OutlinedButton("🧪permmm", on_click=has_per),
+        ft.OutlinedButton("🧪asks_permission_if_needed", on_click=asks_permission_if_needed_),
+    )
+
+ft.app(main)