android-notify 1.60.8.dev0__tar.gz → 1.60.9__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: android-notify
-Version: 1.60.8.dev0
+Version: 1.60.9
 Summary: A Python package that simplifies creating Android notifications in Kivy and Flet apps.
 Author-email: Fabian <fector101@yahoo.com>
 License-Expression: MIT
@@ -81,9 +81,14 @@ 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.8.dev0
+requirements = python3, kivy, pyjnius, android-notify
 # Add permission for notifications
 android.permissions = POST_NOTIFICATIONS
+
+# Required dependency (write exactly as shown, no quotation marks)
+android.gradle_dependencies = androidx.core:core-ktx:1.15.0
+android.enable_androidx = True
+android.api = 35
 ```
 
 </details>
@@ -93,13 +98,13 @@ android.permissions = POST_NOTIFICATIONS
 <summary><b>Flet apps:</b></summary>
 <br/>
 
-In your `pyproject.toml` file, ensure you include the following:
+ In your `pyproject.toml` file, ensure you include the following:
 
 
 ```toml
 [tool.flet.android]
 dependencies = [
-  "pyjnius","android-notify==1.60.8.dev0"
+  "pyjnius","android-notify==1.60.9.dev0"
 ]
 
 [tool.flet.android.permission]
@@ -109,7 +114,35 @@ dependencies = [
 
 </details>
 
+<details>
+
+<summary><b>Desktop</b></summary>
+<br/>
+
+For IDE IntelliSense Can be installed via `pip install`:
+
+```bash
+pip install android_notify
+android-notify -v
+```
+
+</details>
+
+------
+## Installing without Androidx
+How to use without `gradle_dependencies`
+Use `android-notify==1.60.9.dev0` to install via `pip`
+
+<details>
+<summary><b>In Kivy</b></summary>
+<br/>
+
+```ini
+# buildozer.spec
+requirements = python3, kivy, pyjnius, android-notify==1.60.9.dev0
+```
 
+</details>
 
 <details>
 
@@ -117,10 +150,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.8.dev0`
+- In pip section where you're asked to insert `Libary name` paste `android-notify==1.60.9.dev0`
 - Minimal working example 
 ```py
-# Testing with `android-notify==1.60.8.dev0` on pydroid
+# Testing with `android-notify==1.60.9.dev0` on pydroid
 from kivy.app import App
 from kivy.uix.boxlayout import BoxLayout
 from kivy.uix.button import Button
@@ -160,23 +193,11 @@ if __name__ == "__main__":
 </details>
 
 
-<details>
-
-<summary><b>Desktop</b></summary>
-<br/>
-
-For IDE IntelliSense Can be installed via `pip install`:
-
-```bash
-pip install android_notify
-android-notify -v
-```
-</details>
 
 ## Documentation
-For Dev Version use
+For Dev Version usage
 ```ini
-requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/without-androidx.zip
+requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/main.zip
 ```
 
 <details>
@@ -185,7 +206,7 @@ requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_noti
 - Make things happen without being in your app
 ```python
 from android_notify import Notification
-notification = Notification(title="Receiver 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")
 ```
@@ -248,7 +269,7 @@ Notification.createChannel(id='shake', name="Shake Passage", vibrate=True)
 
 n=Notification(title='Vibrate',channel_id='shake')
 n.setVibrate() # for less than android 8
-n.fVibrate() # To Force Vibrate (when user turned off in settings)
+n.fVibrate() # To Force Vibrate
 n.send()
 ```
 
@@ -286,9 +307,5 @@ from android_notify import Notification, NotificationHandler
 
 ## ☕ 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>
+If you find this project helpful, your support would help me continue working on open-source projects
+[donate](https://www.buymeacoffee.com/fector101)

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

@@ -58,9 +58,14 @@ 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.8.dev0
+requirements = python3, kivy, pyjnius, android-notify
 # Add permission for notifications
 android.permissions = POST_NOTIFICATIONS
+
+# Required dependency (write exactly as shown, no quotation marks)
+android.gradle_dependencies = androidx.core:core-ktx:1.15.0
+android.enable_androidx = True
+android.api = 35
 ```
 
 </details>
@@ -70,13 +75,13 @@ android.permissions = POST_NOTIFICATIONS
 <summary><b>Flet apps:</b></summary>
 <br/>
 
-In your `pyproject.toml` file, ensure you include the following:
+ In your `pyproject.toml` file, ensure you include the following:
 
 
 ```toml
 [tool.flet.android]
 dependencies = [
-  "pyjnius","android-notify==1.60.8.dev0"
+  "pyjnius","android-notify==1.60.9.dev0"
 ]
 
 [tool.flet.android.permission]
@@ -86,7 +91,35 @@ dependencies = [
 
 </details>
 
+<details>
+
+<summary><b>Desktop</b></summary>
+<br/>
+
+For IDE IntelliSense Can be installed via `pip install`:
+
+```bash
+pip install android_notify
+android-notify -v
+```
+
+</details>
+
+------
+## Installing without Androidx
+How to use without `gradle_dependencies`
+Use `android-notify==1.60.9.dev0` to install via `pip`
+
+<details>
+<summary><b>In Kivy</b></summary>
+<br/>
+
+```ini
+# buildozer.spec
+requirements = python3, kivy, pyjnius, android-notify==1.60.9.dev0
+```
 
+</details>
 
 <details>
 
@@ -94,10 +127,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.8.dev0`
+- In pip section where you're asked to insert `Libary name` paste `android-notify==1.60.9.dev0`
 - Minimal working example 
 ```py
-# Testing with `android-notify==1.60.8.dev0` on pydroid
+# Testing with `android-notify==1.60.9.dev0` on pydroid
 from kivy.app import App
 from kivy.uix.boxlayout import BoxLayout
 from kivy.uix.button import Button
@@ -137,23 +170,11 @@ if __name__ == "__main__":
 </details>
 
 
-<details>
-
-<summary><b>Desktop</b></summary>
-<br/>
-
-For IDE IntelliSense Can be installed via `pip install`:
-
-```bash
-pip install android_notify
-android-notify -v
-```
-</details>
 
 ## Documentation
-For Dev Version use
+For Dev Version usage
 ```ini
-requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/without-androidx.zip
+requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/main.zip
 ```
 
 <details>
@@ -162,7 +183,7 @@ requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_noti
 - Make things happen without being in your app
 ```python
 from android_notify import Notification
-notification = Notification(title="Receiver 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")
 ```
@@ -225,7 +246,7 @@ Notification.createChannel(id='shake', name="Shake Passage", vibrate=True)
 
 n=Notification(title='Vibrate',channel_id='shake')
 n.setVibrate() # for less than android 8
-n.fVibrate() # To Force Vibrate (when user turned off in settings)
+n.fVibrate() # To Force Vibrate
 n.send()
 ```
 
@@ -263,9 +284,5 @@ from android_notify import Notification, NotificationHandler
 
 ## ☕ 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>
+If you find this project helpful, your support would help me continue working on open-source projects
+[donate](https://www.buymeacoffee.com/fector101)

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

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

{android_notify-1.60.8.dev0 → android_notify-1.60.9}/android_notify/core.py

@@ -6,7 +6,7 @@ from android_notify.internal.logger import logger
 from android_notify.config import get_python_activity, on_android_platform, get_python_activity_context
 from android_notify.internal.permissions import has_notification_permission, ask_notification_permission
 from android_notify.internal.java_classes import autoclass, BuildVersion, BitmapFactory, NotificationChannel, NotificationManagerCompat, NotificationCompat, NotificationCompatBuilder, \
-    NotificationCompatBigTextStyle, NotificationCompatBigPictureStyle, NotificationCompatInboxStyle
+    NotificationCompatBigTextStyle, NotificationCompatBigPictureStyle, NotificationCompatInboxStyle, IconCompat
 
 
 
@@ -60,7 +60,6 @@ def get_image_uri(relative_path):
 
 def get_icon_object(uri):
     context = get_python_activity_context()
-    IconCompat = autoclass('android.graphics.drawable.Icon')
     bitmap = BitmapFactory.decodeStream(context.getContentResolver().openInputStream(uri))
     return IconCompat.createWithBitmap(bitmap)
 
@@ -115,7 +114,9 @@ def send_notification(
         return None
     context = get_python_activity_context()
 
-    asks_permission_if_needed(legacy=True)
+
+    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)

{android_notify-1.60.8.dev0 → android_notify-1.60.9}/android_notify/internal/facade.py

@@ -3,8 +3,10 @@ For autocomplete Storing and Safely Running on PC
 Also For Reference of Available Methods
 """
 
+from enum import IntFlag, auto
 from android_notify.internal.logger import logger
 
+
 class Bundle:
     def putString(self, key, value):
         logger.debug(f"[MOCK] Bundle.putString called with key={key}, value={value}")
@@ -19,11 +21,16 @@ class String(str):
         return str.__new__(cls, value)
 
 
-class Intent:
-    FLAG_ACTIVITY_NEW_TASK = 'FACADE_FLAG_ACTIVITY_NEW_TASK'
-    CATEGORY_DEFAULT = 'FACADE_FLAG_CATEGORY_DEFAULT'
+
+
+class Intent(IntFlag):
+    NONE = 0
+    FLAG_ACTIVITY_CLEAR_TOP = auto()
+    FLAG_ACTIVITY_NEW_TASK = auto()
+    FLAG_ACTIVITY_SINGLE_TOP = auto()
 
     def __init__(self, context='', activity=''):
+        self.IS = "FACADE"
         self.obj = {}
         logger.debug(f"[MOCK] Intent initialized with context={context}, activity={activity}")
 
@@ -132,12 +139,13 @@ class NotificationChannel:
     def setSound(self, sound_uri, _):
         logger.debug(f"[MOCK] NotificationChannel.setSound called, sound_uri={sound_uri}")
 
-    def enableVibration(self,state):
+    def enableVibration(self, state):
         logger.debug(f"[MOCK] NotificationChannel.enableVibration called, state={state}")
 
-    def setVibrationPattern(self,list_of_numbers):
+    def setVibrationPattern(self, list_of_numbers):
         logger.debug(f"[MOCK] NotificationChannel.setVibrationPattern called, list_of_numbers={list_of_numbers}")
 
+
 class IconCompat:
     @classmethod
     def createWithBitmap(cls, bitmap):
@@ -175,6 +183,7 @@ class NotificationManagerCompat:
     IMPORTANCE_MIN = ''
     IMPORTANCE_NONE = ''
 
+
 class AndroidNotification:
     DEFAULT_ALL = 3
     PRIORITY_HIGH = 4
@@ -182,6 +191,7 @@ class AndroidNotification:
     PRIORITY_LOW = ''
     PRIORITY_MIN = ''
 
+
 class NotificationCompat:
     DEFAULT_ALL = 3
     PRIORITY_HIGH = 4
@@ -201,76 +211,97 @@ class NotificationCompatBuilder:
         self.mActions = MActions()
         logger.debug(f"[MOCK] NotificationCompatBuilder initialized with context={context}, channel_id={channel_id}")
 
-    def setProgress(self, max_value, current_value, endless):
+    @classmethod
+    def setProgress(cls, max_value, current_value, endless):
         logger.debug(f"[MOCK] setProgress called with max={max_value}, current={current_value}, endless={endless}")
 
-    def setStyle(self, style):
+    @classmethod
+    def setStyle(cls, style):
         logger.debug(f"[MOCK] setStyle called with style={style}")
 
-    def setContentTitle(self, title):
+    @classmethod
+    def setContentTitle(cls, title):
         logger.debug(f"[MOCK] setContentTitle called with title={title}")
 
-    def setContentText(self, text):
+    @classmethod
+    def setContentText(cls, text):
         logger.debug(f"[MOCK] setContentText called with text={text}")
 
-    def setSmallIcon(self, icon):
+    @classmethod
+    def setSmallIcon(cls, icon):
         logger.debug(f"[MOCK] setSmallIcon called with icon={icon}")
 
-    def setLargeIcon(self, icon):
+    @classmethod
+    def setLargeIcon(cls, icon):
         logger.debug(f"[MOCK] setLargeIcon called with icon={icon}")
 
-    def setAutoCancel(self, auto_cancel: bool):
+    @classmethod
+    def setAutoCancel(cls, auto_cancel: bool):
         logger.debug(f"[MOCK] setAutoCancel called with auto_cancel={auto_cancel}")
 
-    def setPriority(self, priority):
+    @classmethod
+    def setPriority(cls, priority):
         logger.debug(f"[MOCK] setPriority called with priority={priority}")
 
-    def setDefaults(self, defaults):
+    @classmethod
+    def setDefaults(cls, defaults):
         logger.debug(f"[MOCK] setDefaults called with defaults={defaults}")
 
-    def setOngoing(self, persistent: bool):
+    @classmethod
+    def setOngoing(cls, persistent: bool):
         logger.debug(f"[MOCK] setOngoing called with persistent={persistent}")
 
-    def setOnlyAlertOnce(self, state):
+    @classmethod
+    def setOnlyAlertOnce(cls, state):
         logger.debug(f"[MOCK] setOnlyAlertOnce called with state={state}")
 
-    def build(self):
+    @classmethod
+    def build(cls):
         logger.debug("[MOCK] build called")
 
-    def setContentIntent(self, pending_action_intent: PendingIntent):
+    @classmethod
+    def setContentIntent(cls, pending_action_intent: PendingIntent):
         logger.debug(f"[MOCK] setContentIntent called with {pending_action_intent}")
 
-    def addAction(self, icon_int, action_text, pending_action_intent):
+    @classmethod
+    def addAction(cls, icon_int, action_text, pending_action_intent):
         logger.debug(
             f"[MOCK] addAction called with icon={icon_int}, text={action_text}, intent={pending_action_intent}"
         )
 
-    def setShowWhen(self, state):
+    @classmethod
+    def setShowWhen(cls, state):
         logger.debug(f"[MOCK] setShowWhen called with state={state}")
 
-    def setWhen(self, time_ms):
+    @classmethod
+    def setWhen(cls, time_ms):
         logger.debug(f"[MOCK] setWhen called with time_ms={time_ms}")
 
-    def setCustomContentView(self, layout):
+    @classmethod
+    def setCustomContentView(cls, layout):
         logger.debug(f"[MOCK] setCustomContentView called with layout={layout}")
 
-    def setCustomBigContentView(self, layout):
+    @classmethod
+    def setCustomBigContentView(cls, layout):
         logger.debug(f"[MOCK] setCustomBigContentView called with layout={layout}")
 
-    def setSubText(self, text):
+    @classmethod
+    def setSubText(cls, text):
         logger.debug(f"[MOCK] setSubText called with text={text}")
 
-    def setColor(self, color: Color) -> None:
+    @classmethod
+    def setColor(cls, color: Color) -> None:
         logger.debug(f"[MOCK] setColor called with color={color}")
 
-    def setVibrate(self, state) -> None:
+    @classmethod
+    def setVibrate(cls, state) -> None:
         logger.debug(f"[MOCK] setVibrate called with state={state}")
 
 
 class NotificationCompatBigTextStyle:
-    def bigText(self, body):
+    def bigText(cls, body):
         logger.debug(f"[MOCK] NotificationCompatBigTextStyle.bigText called with body={body}")
-        return self
+        return cls
 
     def setBigContentTitle(self, title):
         logger.debug(f"[MOCK] NotificationCompatBigTextStyle.setBigContentTitle called with title={title}")
@@ -334,6 +365,15 @@ class PythonActivity:
         logger.debug("[MOCK] mActivity used")
         return MActivity()
 
+    @staticmethod
+    def startForeground(notification_id, builder_build, foreground_type):
+        logger.debug(
+            f"[MOCK] startForeground called with notification_id={notification_id}, builder.build()={builder_build}, foreground_type={foreground_type}")
+
+    def setAutoRestartService(self):
+        logger.debug("[MOCK] setAutoRestartService called")
+        return self
+
 
 class DummyIcon:
     icon = 101

{android_notify-1.60.8.dev0 → android_notify-1.60.9}/android_notify/internal/java_classes.py

@@ -39,24 +39,31 @@ if on_android_platform():
         Manifest = autoclass('android.Manifest$permission')
         Color = autoclass('android.graphics.Color')
         Context = autoclass('android.content.Context')
-        PackageManager = autoclass("android.content.pm.PackageManager")
     except Exception as e:
         from .facade import *
         logger.exception("Didn't get Basic Java Classes")
 
     # noinspection PyBroadException
     try:
-        NotificationManagerCompat = NotificationManager # I need other files identical to main branch so it's easier to maintain
-        NotificationCompat = autoclass("android.app.Notification")
-        NotificationCompatBuilder = autoclass('android.app.Notification$Builder')
-        NotificationCompatBigTextStyle = autoclass('android.app.Notification$BigTextStyle')
-        NotificationCompatBigPictureStyle = autoclass('android.app.Notification$BigPictureStyle')
-        NotificationCompatInboxStyle = autoclass('android.app.Notification$InboxStyle')
+        NotificationManagerCompat = autoclass('androidx.core.app.NotificationManagerCompat')
+        NotificationCompat = autoclass('androidx.core.app.NotificationCompat')
+        NotificationCompatBuilder = autoclass('androidx.core.app.NotificationCompat$Builder')
+        IconCompat = autoclass('androidx.core.graphics.drawable.IconCompat')
 
-    except Exception as styles_import_error:
-        logger.exception(styles_import_error)
-        from .facade import *
+        # Notification Design
+        NotificationCompatBigTextStyle = autoclass('androidx.core.app.NotificationCompat$BigTextStyle')
+        NotificationCompatBigPictureStyle = autoclass('androidx.core.app.NotificationCompat$BigPictureStyle')
+        NotificationCompatInboxStyle = autoclass('androidx.core.app.NotificationCompat$InboxStyle')
+        NotificationCompatDecoratedCustomViewStyle = autoclass('androidx.core.app.NotificationCompat$DecoratedCustomViewStyle')
+
+    except Exception as dependencies_import_error:
+        logger.exception("""
+        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
+        """)
 
+        from .facade import *
 else:
     cast = lambda x, y: x
     autoclass = lambda x: None

android_notify-1.60.9/android_notify/internal/logger.py

@@ -0,0 +1,94 @@
+import logging
+import sys
+import os
+
+try:
+    from jnius import autoclass
+except ModuleNotFoundError:
+    autoclass = lambda x: None
+
+
+def on_kivy_android():
+    kivy_build = os.environ.get('KIVY_BUILD', '')
+    if kivy_build in {'android'}:
+        return True
+    elif 'P4A_BOOTSTRAP' in os.environ:
+        return True
+    elif 'ANDROID_ARGUMENT' in os.environ:
+        return True
+
+    return False
+
+
+def on_flet_app():
+    return os.getenv("MAIN_ACTIVITY_HOST_CLASS_NAME")
+
+
+def on_android_platform():
+    return on_kivy_android() or on_flet_app()
+
+
+def android_print(msg):
+    msg = str(msg)
+    if on_android_platform():
+        Log = autoclass("android.util.Log")
+        Log.i("python", msg)
+        return None
+    print(msg)
+    return None
+
+
+def kivy_logger_patch():
+    if not on_kivy_android():
+        return
+
+    handler = logging.StreamHandler(sys.stdout)
+    formatter = KivyColorFormatter()
+    handler.setFormatter(formatter)
+
+    # Avoid duplicate logs if root logger is configured
+    logger.propagate = False
+    logger.addHandler(handler)
+    logger._configured = True
+
+
+class KivyColorFormatter(logging.Formatter):
+    COLORS = {
+        'DEBUG': '\x1b[1;36m',  # bold cyan
+        'INFO': '\x1b[1;92m',  # bold lime green
+        'WARNING': '\x1b[1;93m',  # bold yellow
+        'ERROR': '\x1b[1;91m',  # bold red
+        'CRITICAL': '\x1b[1;95m',  # bold magenta
+    }
+    RESET = '\x1b[0m'
+
+    def format(self, record):
+        level = record.levelname.ljust(7)
+        name = record.name.ljust(14)
+        msg = record.getMessage()
+
+        if getattr(sys.stdout, "isatty", lambda: False)():
+            color = self.COLORS.get(record.levelname, '')
+            level = f"{color}{level}{self.RESET}"
+
+        return f"[{level}] [{name}] {msg}"
+
+
+logger = logging.getLogger("android_notify")
+kivy_logger_patch()
+
+env_level = os.getenv("ANDROID_NOTIFY_LOGLEVEL")
+if env_level:
+    try:
+        logging.getLogger("android_notify").setLevel(getattr(logging, env_level.upper()))
+    except Exception as android_notify_loglevel_error:
+        android_print(f"android_notify_loglevel_error: {android_notify_loglevel_error}")
+
+if __name__ == "__main__":
+    # from kivymd.app import MDApp
+
+    logger.debug("Debug message - should not appear with INFO level")
+    logger.info("Info message")
+    logger.warning("Warning message")
+    logger.error("Error message")
+    logger.critical("Critical message")