android-notify 1.23.1__py3-none-any.whl → 1.24__py3-none-any.whl

android_notify/__init__.py

@@ -1,2 +1,8 @@
 from .core import send_notification
-from .styles import NotificationStyles
+from .styles import NotificationStyles
+try:
+    from .advanced import EnhancedNotificationManager
+    from ._dev import NotificationBuilder
+except Exception as e:
+    # print('Failed to Import Advanced Features:', e)
+    pass

android_notify/_dev.py

@@ -0,0 +1,112 @@
+
+class NotificationManager:
+    notification_ids=[]
+    def __init__(self, channel_id='',channel_name="Default Channel",importance_level=NotificationManagerCompat.IMPORTANCE_HIGH):
+        if not ON_ANDROID:
+            raise RuntimeError("This package only runs on Android!")
+        self.channel_name = channel_name
+        self.channel_id=channel_name.replace(' ','_').lower().lower() if not channel_id else channel_id
+        self.notification_manager = context.getSystemService(context.NOTIFICATION_SERVICE)
+        self.builder = NotificationCompatBuilder(context, self.channel_id)
+        self.notification_id = self.__getUniqueID()
+        
+        # Setup Channel (For Android 8.0+)
+        if BuildVersion.SDK_INT >= 26:
+            channel = NotificationChannel(self.channel_id, channel_name, importance_level)
+            self.notification_manager.createNotificationChannel(channel)
+        
+    def set_title(self, title: str):
+        """Set the title of the notification."""
+        self.builder.setContentTitle(title)
+    def set_message(self, message: str):
+        """Set the message of the notification."""
+        self.builder.setContentText(message)
+    def set_style(self, style: str, img_path=None):
+        """Set the style of the notification."""
+        try:
+            if style == "big_text":
+                big_text_style = NotificationCompatBigTextStyle()
+                big_text_style.bigText(self.builder.mContentText)
+                self.builder.setStyle(big_text_style)
+            elif style == "big_picture" and img_path:
+                img = get_image_uri(img_path)
+                big_picture_style = NotificationCompatBigPictureStyle().bigPicture(img)
+                self.builder.setStyle(big_picture_style)
+            elif style == "inbox":
+                inbox_style = NotificationCompatInboxStyle()
+                for line in self.builder.mContentText.split("\n"):
+                    inbox_style.addLine(line)
+                self.builder.setStyle(inbox_style)
+        except Exception as e:
+            print('Failed Adding Style:', e)
+    
+    def add_button(self, action_name: str, action_intent: str):
+        """Add a button to the notification."""
+        try:
+            intent = Intent(context, PythonActivity)
+            intent.setAction(action_intent)
+            pending_intent = PendingIntent.getActivity(
+                context,
+                0,
+                intent,
+                PendingIntent.FLAG_IMMUTABLE
+            )
+            action_text = cast('java.lang.CharSequence', String(action_name))
+            self.builder.addAction(
+                int(context.getApplicationInfo().icon),
+                action_text,
+                pending_intent
+            )
+        except Exception as e:
+            print('Failed adding button:', e)
+    def set_icon(self, img_path: str):
+        """Set the icon of the notification."""
+        try:
+            img = get_image_uri(img_path)
+            self.builder.setLargeIcon(BitmapFactory.decodeStream(context.getContentResolver().openInputStream(img)))
+        except Exception as e:
+            print('Failed Adding Bitmap:', e)
+    
+    def send(self):
+        """Send the notification."""
+        self.builder.setSmallIcon(context.getApplicationInfo().icon)
+        self.builder.setDefaults(NotificationCompat.DEFAULT_ALL)
+        self.builder.setPriority(NotificationCompat.PRIORITY_HIGH)
+        self.notification_manager.notify(self.notification_id, self.builder.build())
+        return self.notification_id
+    
+    def update(self, title=None, message=None):
+        """Update the notification."""
+        if title:
+            self.builder.setContentTitle(title)
+        if message:
+            self.builder.setContentText(message)
+        self.notification_manager.notify(self.notification_id, self.builder.build())
+    def __get_image(self, img_path):
+        """Get the image from the app Relative path."""
+        from android.storage import app_storage_path
+        output_path = os.path.join(app_storage_path(), 'app', img_path)
+        if not os.path.exists(output_path):
+            raise FileNotFoundError(f"Image not found at path: {output_path}")
+        Uri = autoclass('android.net.Uri')
+        return BitmapFactory.decodeStream(context.getContentResolver().openInputStream(Uri.parse(f"file://{output_path}")))
+        # return BitmapFactory.decodeStream(context.getContentResolver().openInputStream(get_image_uri(img_path)))
+    def cancel(self):
+        """Cancel the notification."""
+        self.notification_manager.cancel(self.notification_id)
+        self.__del__()
+    def cancel_all(self):
+        """Cancel all notifications."""
+        self.notification_manager.cancelAll()
+    def __del__(self):
+        """Delete the notification id."""
+        self.notification_ids.remove(self.notification_id)        
+    def __getUniqueID(self):
+        notification_id = random.randint(1, 100)
+        while notification_id in self.notification_ids:
+            notification_id = random.randint(1, 100)
+        self.notification_ids.append(notification_id)
+        return notification_id
+
+# notification_manager=NotificationManager()
+# notification_manager.s

android_notify/advanced_dev.py

@@ -0,0 +1,345 @@
+from jnius import autoclass, cast
+import random
+import os
+from enum import Enum
+from typing import Optional, List, Union
+from dataclasses import dataclass
+
+class NotificationImportance(Enum):
+    MIN = 1
+    LOW = 2
+    DEFAULT = 3
+    HIGH = 4
+
+class NotificationPriority(Enum):
+    MIN = -2
+    LOW = -1
+    DEFAULT = 0
+    HIGH = 1
+    MAX = 2
+
+class NotificationStyle(Enum):
+    DEFAULT = "default"
+    BIG_TEXT = "big_text"
+    BIG_PICTURE = "big_picture"
+    INBOX = "inbox"
+    MESSAGING = "messaging"
+
+@dataclass
+class NotificationAction:
+    name: str
+    intent: str
+    icon: Optional[int] = None
+
+class AndroidNotificationSystem:
+    """Singleton class to handle Android-specific initialization and classes"""
+    _instance = None
+    _initialized = False
+
+    def __new__(cls):
+        if cls._instance is None:
+            cls._instance = super(AndroidNotificationSystem, cls).__new__(cls)
+        return cls._instance
+
+    def __init__(self):
+        if not self._initialized:
+            self._initialize_android_classes()
+            self._initialized = True
+
+    def _initialize_android_classes(self):
+        try:
+            # Core Android classes
+            self.PythonActivity = autoclass('org.kivy.android.PythonActivity')
+            self.NotificationChannel = autoclass('android.app.NotificationChannel')
+            self.String = autoclass('java.lang.String')
+            self.Intent = autoclass('android.content.Intent')
+            self.PendingIntent = autoclass('android.app.PendingIntent')
+            self.Context = self.PythonActivity.mActivity
+            self.BitmapFactory = autoclass('android.graphics.BitmapFactory')
+            self.BuildVersion = autoclass('android.os.Build$VERSION')
+            
+            # Notification specific classes
+            self.NotificationManagerCompat = autoclass('androidx.core.app.NotificationManagerCompat')
+            self.NotificationCompat = autoclass('androidx.core.app.NotificationCompat')
+            self.NotificationBuilder = autoclass('androidx.core.app.NotificationCompat$Builder')
+            self.BigTextStyle = autoclass('androidx.core.app.NotificationCompat$BigTextStyle')
+            self.BigPictureStyle = autoclass('androidx.core.app.NotificationCompat$BigPictureStyle')
+            self.InboxStyle = autoclass('androidx.core.app.NotificationCompat$InboxStyle')
+            self.MessagingStyle = autoclass('androidx.core.app.NotificationCompat$MessagingStyle')
+            
+            self.is_initialized = True
+        except Exception as e:
+            raise ImportError(
+                "Failed to initialize Android classes. Ensure you have the following in buildozer.spec:\n"
+                "android.gradle_dependencies = androidx.core:core-ktx:1.15.0, androidx.core:core:1.6.0\n"
+                "android.enable_androidx = True\n"
+                "android.permissions = POST_NOTIFICATIONS"
+            ) from e
+
+class NotificationChannel:
+    def __init__(
+        self,
+        channel_id: str,
+        name: str,
+        importance: NotificationImportance = NotificationImportance.DEFAULT,
+        description: Optional[str] = None,
+        enable_lights: bool = True,
+        enable_vibration: bool = True
+    ):
+        self.android = AndroidNotificationSystem()
+        self.channel_id = channel_id
+        self.name = name
+        
+        if self.android.BuildVersion.SDK_INT >= 26:
+            channel = self.android.NotificationChannel(
+                channel_id,
+                name,
+                importance.value
+            )
+            if description:
+                channel.setDescription(description)
+            channel.enableLights(enable_lights)
+            channel.enableVibration(enable_vibration)
+            
+            self.android.Context.getSystemService(
+                self.android.Context.NOTIFICATION_SERVICE
+            ).createNotificationChannel(channel)
+
+class EnhancedNotificationManager:
+    """Enhanced notification manager with more features and better organization"""
+    
+    _notification_ids = set()
+
+    def __init__(
+        self,
+        channel_id: str,
+        channel_name: str,
+        importance: NotificationImportance = NotificationImportance.HIGH,
+        group_key: Optional[str] = None
+    ):
+        self.android = AndroidNotificationSystem()
+        self.channel = NotificationChannel(channel_id, channel_name, importance)
+        self.builder = self.android.NotificationBuilder(
+            self.android.Context,
+            channel_id
+        )
+        self.notification_id = self._generate_unique_id()
+        self.group_key = group_key
+        
+        if group_key:
+            self.builder.setGroup(group_key)
+
+    def _generate_unique_id(self) -> int:
+        while (notification_id := random.randint(1, 10000)) in self._notification_ids:
+            continue
+        self._notification_ids.add(notification_id)
+        return notification_id
+
+    def set_content(
+        self,
+        title: str,
+        message: str,
+        style: NotificationStyle = NotificationStyle.DEFAULT,
+        style_content: Optional[Union[str, str]] = None,
+        image_path: Optional[str] = None
+    ):
+        """Set notification content with enhanced styling options"""
+        self.builder.setContentTitle(title)
+        self.builder.setContentText(message)
+        
+        if style == NotificationStyle.BIG_TEXT:
+            big_text = style_content or message
+            self.builder.setStyle(
+                self.android.BigTextStyle().bigText(big_text)
+            )
+        elif style == NotificationStyle.BIG_PICTURE and image_path:
+            bitmap = self._load_image(image_path)
+            if bitmap:
+                self.builder.setStyle(
+                    self.android.BigPictureStyle()
+                    .bigPicture(bitmap)
+                    .setBigContentTitle(title)
+                )
+        elif style == NotificationStyle.INBOX and isinstance(style_content, list):
+            inbox_style = self.android.InboxStyle()
+            for line in style_content:
+                inbox_style.addLine(line)
+            self.builder.setStyle(inbox_style)
+        elif style == NotificationStyle.MESSAGING:
+            messaging_style = self.android.MessagingStyle("User")
+            if isinstance(style_content, list):
+                for msg in style_content:
+                    messaging_style.addMessage(msg, 0, "Sender")
+            self.builder.setStyle(messaging_style)
+
+    def add_actions(self, actions: List[NotificationAction]):
+        """Add multiple actions (buttons) to the notification"""
+        for action in actions:
+            intent = self.android.Intent(
+                self.android.Context,
+                self.android.PythonActivity
+            )
+            intent.setAction(action.intent)
+            
+            pending_intent = self.android.PendingIntent.getActivity(
+                self.android.Context,
+                random.randint(0, 10000),  # Unique request code
+                intent,
+                self.android.PendingIntent.FLAG_IMMUTABLE
+            )
+            
+            icon = action.icon or self.android.Context.getApplicationInfo().icon
+            action_text = cast('java.lang.CharSequence',
+                             self.android.String(action.name))
+            
+            self.builder.addAction(icon, action_text, pending_intent)
+
+    def set_icons(
+        self,
+        small_icon_path: Optional[str] = None,
+        large_icon_path: Optional[str] = None
+    ):
+        """Set both small and large icons"""
+        if small_icon_path:
+            small_icon = self._load_image(small_icon_path)
+            if small_icon:
+                self.builder.setSmallIcon(small_icon)
+        else:
+            self.builder.setSmallIcon(
+                self.android.Context.getApplicationInfo().icon
+            )
+            
+        if large_icon_path:
+            large_icon = self._load_image(large_icon_path)
+            if large_icon:
+                self.builder.setLargeIcon(large_icon)
+
+    def _load_image(self, image_path: str):
+        """Load image from app storage with error handling"""
+        try:
+            uri = self.__get_image_uri(image_path)
+            return self.android.BitmapFactory.decodeStream(
+                self.android.Context.getContentResolver().openInputStream(uri)
+            )
+        except Exception as e:
+            print(f"Failed to load image: {e}")
+            return None
+
+    def __get_image_uri(self, relative_path: str):
+        """Get URI for image file"""
+        from android.storage import app_storage_path # type: ignore
+        
+        output_path = os.path.join(
+            app_storage_path(),
+            'app',
+            relative_path
+        )
+        if not os.path.exists(output_path):
+            raise FileNotFoundError(
+                f"Image not found at path: {output_path}"
+            )
+        
+        Uri = autoclass('android.net.Uri')
+        return Uri.parse(f"file://{output_path}")
+
+    def set_priority(self, priority: NotificationPriority):
+        """Set notification priority"""
+        self.builder.setPriority(priority.value)
+
+    def set_ongoing(self, ongoing: bool = True):
+        """Set whether notification is ongoing"""
+        self.builder.setOngoing(ongoing)
+
+    def set_auto_cancel(self, auto_cancel: bool = True):
+        """Set whether notification is automatically canceled on click"""
+        self.builder.setAutoCancel(auto_cancel)
+
+    def send(self) -> int:
+        """Send the notification and return its ID"""
+        notification_manager = self.android.Context.getSystemService(
+            self.android.Context.NOTIFICATION_SERVICE
+        )
+        notification_manager.notify(
+            self.notification_id,
+            self.builder.build()
+        )
+        return self.notification_id
+
+    def update(
+        self,
+        title: Optional[str] = None,
+        message: Optional[str] = None,
+        progress: Optional[tuple] = None
+    ):
+        """Update existing notification"""
+        if title:
+            self.builder.setContentTitle(title)
+        if message:
+            self.builder.setContentText(message)
+        if progress:
+            current, max_value = progress
+            self.builder.setProgress(max_value, current, False)
+            
+        self.send()
+
+    def cancel(self):
+        """Cancel this notification"""
+        notification_manager = self.android.Context.getSystemService(
+            self.android.Context.NOTIFICATION_SERVICE
+        )
+        notification_manager.cancel(self.notification_id)
+        self._notification_ids.remove(self.notification_id)
+
+    @classmethod
+    def cancel_all(cls):
+        """Cancel all notifications"""
+        android = AndroidNotificationSystem()
+        notification_manager = android.Context.getSystemService(
+            android.Context.NOTIFICATION_SERVICE
+        )
+        notification_manager.cancelAll()
+        cls._notification_ids.clear()
+
+# Example usage:
+def example_usage():
+    # Create a notification
+    notification = EnhancedNotificationManager(
+        channel_id="messages",
+        channel_name="Messages",
+        importance=NotificationImportance.HIGH
+    )
+    
+    # Set basic content
+    notification.set_content(
+        title="New Message",
+        message="Hello World!",
+        style=NotificationStyle.BIG_TEXT
+    )
+    
+    # Add actions
+    actions = [
+        NotificationAction("Reply", "REPLY_ACTION"),
+        NotificationAction("Delete", "DELETE_ACTION")
+    ]
+    notification.add_actions(actions)
+    
+    # Set icons
+    notification.set_icons(
+        large_icon_path="assets/imgs/profile.png"
+    )
+    
+    # Configure behavior
+    notification.set_priority(NotificationPriority.HIGH)
+    notification.set_auto_cancel(True)
+    
+    # Send the notification
+    notification_id = notification.send()
+    
+    # Later, update the notification
+    notification.update(
+        message="Updated message!",
+        progress=(50, 100)
+    )
+    
+    # Cancel when done
+    notification.cancel()

android_notify/core.py

@@ -26,7 +26,6 @@ if ON_ANDROID:
         # Notification Design
         NotificationCompatBuilder = autoclass('androidx.core.app.NotificationCompat$Builder')
         NotificationCompatBigTextStyle = autoclass('androidx.core.app.NotificationCompat$BigTextStyle')
-        # NotificationCompatBigTextStyle = autoclass('android.app.Notification$BigTextStyle')
         NotificationCompatBigPictureStyle = autoclass('androidx.core.app.NotificationCompat$BigPictureStyle')
         NotificationCompatInboxStyle = autoclass('androidx.core.app.NotificationCompat$InboxStyle')
     except Exception as e:
@@ -65,7 +64,7 @@ def get_image_uri(relative_path):
     return Uri.parse(f"file://{output_path}")
 
 
-def send_notification(title:str, message:str, style=None, img_path=None, channel_id:str="default_channel"):
+def send_notification(title:str, message:str, style=None, img_path=None, channel_name="Default Channel",channel_id:str="default_channel"):
     """
     Send a notification on Android.
 
@@ -73,13 +72,13 @@ def send_notification(title:str, message:str, style=None, img_path=None, channel
     :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.
+    :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)
 
@@ -88,7 +87,7 @@ def send_notification(title:str, message:str, style=None, img_path=None, channel
     
     # Notification Channel (Required for Android 8.0+)
     if BuildVersion.SDK_INT >= 26:
-        channel = NotificationChannel(channel_id, "Default Channel",importance)
+        channel = NotificationChannel(channel_id, channel_name,importance)
         notification_manager.createNotificationChannel(channel)
 
     # Build the notification
@@ -130,4 +129,5 @@ def send_notification(title:str, message:str, style=None, img_path=None, channel
     # Display the notification
     notification_id = random.randint(0, 100)
     notification_manager.notify(notification_id, builder.build())
-    return notification_id
+    return notification_id
+

{android_notify-1.23.1.dist-info → android_notify-1.24.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: android-notify
-Version: 1.23.1
-Summary: A Python package for sending Android notifications using PyJNIus in Kivy apps.
+Version: 1.24
+Summary: A Python package that simpilfies creating Android Post notifications using PyJNIus in Kivy apps.
 Home-page: https://github.com/fector101/android-notify
 Author: Fabian
 Author-email: fector101@yahoo.com
@@ -14,7 +14,7 @@ Keywords: android,notifications,kivy,mobile,post notifications,pyjnius,android n
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: Android
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.6
@@ -128,6 +128,25 @@ send_notification(
 
 ---
 
+### Version 1.24 (Channel Name)
+
+- Can be found in App Settings where user can turn on/off specific Notifications
+
+```python
+# channel_id default is now channel_name in lowercase with spaces replaced for underscores(_)
+# In later version channel_id will be used to reference notification
+send_notification(
+    title="Downlooad Notifications"
+    message="How to Catch a Fish.mp4"
+    channel_name="Download finished"
+)
+```
+
+**Sample Image:**  
+![channels](docs/imgs/channel_name.jpg)
+
+---
+
 ### **Assist**
 
 - How to Copy image to app folder
@@ -242,7 +261,7 @@ For feedback or contributions, feel free to reach out!
 
 ## ☕ Support the Project
 
-If you find this project helpful, consider buying me a coffee! Your support helps maintain and improve 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">

android_notify-1.24.dist-info/RECORD

@@ -0,0 +1,10 @@
+android_notify/__init__.py,sha256=37Y04a1PbxeQlOpruIUhr7KibSZRfrV9uvSeelCNO58,261
+android_notify/__main__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+android_notify/_dev.py,sha256=zGHGQu8Tv2RBtxiPDdIR0H-TLbzDocktIu_d78IgQgU,5207
+android_notify/advanced_dev.py,sha256=sUY3OjTC3arvtqOKtDpor14QSTRrwsuMI9susyfXwZo,12065
+android_notify/core.py,sha256=JkI5uiJof_gbuJJQ6YqgwWBTOWkhSKsGtVR8A9IIUN4,6024
+android_notify/styles.py,sha256=P_8sAqb3Hbf_vbhqSoCVjKeqJ05Fr_CksO-HX5pj8pU,134
+android_notify-1.24.dist-info/METADATA,sha256=hD2y3u_5Jg2o82BX1gPGiAQNVYLqIJuoGyzN7YRL8N8,7253
+android_notify-1.24.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+android_notify-1.24.dist-info/top_level.txt,sha256=IR1ONMrRSRINZpWn2X0dL5gbWwWINsK7PW8Jy2p4fU8,15
+android_notify-1.24.dist-info/RECORD,,

android_notify-1.23.1.dist-info/RECORD

@@ -1,8 +0,0 @@
-android_notify/__init__.py,sha256=DOUMyhwcXFBbamkxf0fJCBtRemTGXTiJTrQpKV_XF_A,74
-android_notify/__main__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-android_notify/core.py,sha256=_47jZI0es_5PsqEVXL-WVsj815HOzn5hEU5d8s3-6j0,5948
-android_notify/styles.py,sha256=P_8sAqb3Hbf_vbhqSoCVjKeqJ05Fr_CksO-HX5pj8pU,134
-android_notify-1.23.1.dist-info/METADATA,sha256=GGxGcWmZa0GZtJxUxYFn_5Su9jV7K8iIF9uY_3DHRbE,6650
-android_notify-1.23.1.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-android_notify-1.23.1.dist-info/top_level.txt,sha256=IR1ONMrRSRINZpWn2X0dL5gbWwWINsK7PW8Jy2p4fU8,15
-android_notify-1.23.1.dist-info/RECORD,,