android-notify 1.1__py3-none-any.whl → 1.2__py3-none-any.whl

android_notify/core.py

@@ -3,22 +3,48 @@ from jnius import autoclass,cast
 import random
 import os
 
+ON_ANDROID = False
+try:
+    # Get the required Java classes
+    PythonActivity = autoclass('org.kivy.android.PythonActivity')
+    NotificationChannel = autoclass('android.app.NotificationChannel')
+    String = autoclass('java.lang.String')
+    Intent = autoclass('android.content.Intent')
+    PendingIntent = autoclass('android.app.PendingIntent')
+    context = PythonActivity.mActivity # Get the app's context 
+    BitmapFactory = autoclass('android.graphics.BitmapFactory')
+    BuildVersion = autoclass('android.os.Build$VERSION')    
+    ON_ANDROID=True
+except Exception as e:
+    print('This Package Only Runs on Android !!! ---> Check "https://github.com/Fector101/android_notify/" to see design patterns and more info.')
+
+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')
+        # NotificationCompatBigTextStyle = autoclass('android.app.Notification$BigTextStyle')
+        NotificationCompatBigPictureStyle = autoclass('androidx.core.app.NotificationCompat$BigPictureStyle')
+        NotificationCompatInboxStyle = autoclass('androidx.core.app.NotificationCompat$InboxStyle')
+    except Exception as e:
+        print("""
+        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
+        """)
 
 def asks_permission_if_needed():
     """
     Ask for permission to send notifications if needed.
     """
-    # Get the required Java classes
     from android.permissions import request_permissions, Permission,check_permission # type: ignore
-    
-    def check_permissions(permissions):
-        for permission in permissions:
-            if check_permission(permission) != True:
-                return False
-        return True
 
     permissions=[Permission.POST_NOTIFICATIONS]
-    if check_permissions(permissions):
+    if not all(check_permission(p) for p in permissions):
         request_permissions(permissions)
 
 def get_image_uri(relative_path):
@@ -28,62 +54,40 @@ def get_image_uri(relative_path):
     :return: Absolute URI java Object (e.g., 'file:///path/to/file.png').
     """
     from android.storage import app_storage_path # type: ignore
-    # print("app_storage_path()",app_storage_path())
 
     output_path = os.path.join(app_storage_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"Image not found at path: {output_path}")
+    
     Uri = autoclass('android.net.Uri')
     return Uri.parse(f"file://{output_path}")
 
-def send_notification(title, message, style=None, img_path=None, channel_id="default_channel"):
+
+def send_notification(title:str, message:str, style=None, img_path=None, channel_id:str="default_channel"):
     """
     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').
-    :param image: Image URL or drawable for 'big_picture' style.
+    :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.
     """
-    # TODO check if running on android short circuit and return message if not
-    
-    # Get the required Java classes
-    # Notification Base
-    PythonActivity = autoclass('org.kivy.android.PythonActivity')
-    NotificationChannel = autoclass('android.app.NotificationChannel')
-    String = autoclass('java.lang.String')
-    
-    
-    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')
-    # NotificationCompatBigTextStyle = autoclass('android.app.Notification$BigTextStyle')
-    
-    NotificationCompatBigPictureStyle = autoclass('androidx.core.app.NotificationCompat$BigPictureStyle')
-    NotificationCompatInboxStyle = autoclass('androidx.core.app.NotificationCompat$InboxStyle')
-    BitmapFactory = autoclass('android.graphics.BitmapFactory')
-    BuildVersion = autoclass('android.os.Build$VERSION')
-    PendingIntent = autoclass('android.app.PendingIntent')
-    Intent = autoclass('android.content.Intent')
+    if not ON_ANDROID:
+        print('This Package Only Runs on Android !!! ---> Check "https://github.com/Fector101/android_notify/" for Documentation.')
+        return
     
-    # Get the app's context and notification manager
-    context = PythonActivity.mActivity
+    # Get notification manager
     notification_manager = context.getSystemService(context.NOTIFICATION_SERVICE)
 
-    importance= NotificationManagerCompat.IMPORTANCE_HIGH #autoclass('android.app.NotificationManager').IMPORTANCE_HIGH also works #NotificationManager.IMPORTANCE_DEFAULT
+    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:
-        print('entered....')
-        channel = NotificationChannel(
-            channel_id,
-            "Default Channel",
-            importance
-        )
+        channel = NotificationChannel(channel_id, "Default Channel",importance)
         notification_manager.createNotificationChannel(channel)
 
     # Build the notification
@@ -95,74 +99,37 @@ def send_notification(title, message, style=None, img_path=None, channel_id="def
     builder.setPriority(NotificationCompat.PRIORITY_HIGH)
     
     # Get Image
-    img=img_path
+    img=None
     if img_path:
         try:
             img = get_image_uri(img_path)
-        except Exception as e:
-            print('Failed getting Image path',e)
+        except FileNotFoundError as e:
+            print('Failed Adding Bitmap: ',e)
     
-     # Add Actions (Buttons)
-    
-    # add Action 1 Button
-    # try:
-    #     # Create Action 1
-    #     action_intent = Intent(context, PythonActivity)
-    #     action_intent.setAction("ACTION_ONE")
-    #     pending_action_intent = PendingIntent.getActivity(
-    #         context, 
-    #         0, 
-    #         action_intent, 
-    #         PendingIntent.FLAG_IMMUTABLE
-    #     )
-        
-    #     # Convert text to CharSequence
-    #     action_text = cast('java.lang.CharSequence', String("Action 1"))
-        
-    #     # Add action with proper types
-    #     builder.addAction(
-    #         int(context.getApplicationInfo().icon),  # Cast icon to int
-    #         action_text,                             # CharSequence text
-    #         pending_action_intent                    # PendingIntent
-    #     )
-        
-        
-    #     # Set content intent for notification tap
-    #     builder.setContentIntent(pending_action_intent)
-    # except Exception as e:
-    #     print('Failed adding Action 1',e)
-
-    
-    # Apply styles
-    if style == "big_text":
-        big_text_style = NotificationCompatBigTextStyle()
-        big_text_style.bigText(message)
-        builder.setStyle(big_text_style)
-        
-        
-    elif style == "big_picture" and img_path:
-        try:
+    # Apply notification styles
+    try:
+        if style == "big_text":
+            big_text_style = NotificationCompatBigTextStyle()
+            big_text_style.bigText(message)
+            builder.setStyle(big_text_style)
+            
+            
+        elif style == "big_picture" and img_path:
             bitmap = BitmapFactory.decodeStream(context.getContentResolver().openInputStream(img))
-            # bitmap = BitmapFactory.decodeFile(img_path)
             builder.setLargeIcon(bitmap)
             big_picture_style = NotificationCompatBigPictureStyle().bigPicture(bitmap)
-            # big_picture_style.bigPicture(bitmap).bigLargeIcon(None)
-            # big_picture_style.bigLargeIcon(bitmap) # This just changes dropdown app icon
-            
             builder.setStyle(big_picture_style)
-        except Exception as e:
-            print('Failed Adding Bitmap...', e)
-    elif style == "inbox":
-        inbox_style = NotificationCompatInboxStyle()
-        for line in message.split("\n"):
-            inbox_style.addLine(line)
-        builder.setStyle(inbox_style)
-    elif style == "large_icon" and img_path:
-        try:
+        elif style == "inbox":
+            inbox_style = NotificationCompatInboxStyle()
+            for line in message.split("\n"):
+                inbox_style.addLine(line)
+            builder.setStyle(inbox_style)
+        elif style == "large_icon" and img_path:
             bitmap = BitmapFactory.decodeStream(context.getContentResolver().openInputStream(img))
             builder.setLargeIcon(bitmap)
-        except Exception as e:
-            print('Failed Large Icon...', e)
-    
-    # Show the notification
-    notification_manager.notify(random.randint(0, 100), builder.build())
+    except Exception as e:
+        print('Failed Adding Style: ',e)
+    # Display the notification
+    notification_id = random.randint(0, 100)
+    notification_manager.notify(notification_id, builder.build())
+    return notification_id

{android_notify-1.1.dist-info → android_notify-1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
-Name: android-notify
-Version: 1.1
+Name: android_notify
+Version: 1.2
 Summary: A Python package for sending Android notifications.
 Home-page: https://github.com/Fector101/android_notify/
 Author: Fabian
@@ -21,21 +21,21 @@ Requires-Dist: pyjnius
 - Support for multiple notification styles:
   - Big Text
   - Big Picture
+  - Large Icon
   - Inbox
-- Ability to include images in notifications.
+- Supports including images in notifications.
 - Compatible with Android 8.0+ (Notification Channels).
 - Customizable notification channels.
-- Support for large icons in notifications.
 
 ## Installation
 
-Make sure you have the required dependencies installed:
+This package is available on PyPI and can be installed via pip:
 
 ```bash
 pip install android-notify
 ```
 
-## Usage
+## **Dependencies**
 
 **Prerequisites:**  
 
@@ -52,10 +52,12 @@ requirements = python3,kivy,pyjnius
 android.permissions = POST_NOTIFICATIONS
 
 # Required dependencies (write exactly as shown, no quotation marks)
-android.gradle_dependencies = androidx.core:core:1.6.0
+android.gradle_dependencies = androidx.core:core:1.6.0, androidx.core:core-ktx:1.15.0
 android.enable_androidx = True
 ```
 
+---
+
 ### Example Notification
 
 ```python
@@ -87,20 +89,75 @@ send_notification(
 )
 ```
 
-### Function Reference
+---
+
+### **Assist** -- How to Copy image to app folder
+
+```python
+import shutil # This module comes packaged with python
+from android.storage import app_storage_path # type: ignore -- This works only on android
+
+app_path = os.path.join(app_storage_path(),'app')
+image_path= "/storage/emulated/0/Download/profile.png"
+
+shutil.copy(image_path, os.path.join(app_path, "profile.png"))
+```
+
+---
+
+### **Functions Reference**
 
-#### `send_notification`
+### 1. `asks_permission_if_needed()`
 
-- **title** (*str*): Notification title.
-- **message** (*str*): Notification message body.
-- **style** (*str*): Notification style (`big_text`, `big_picture`, `inbox`, `large_icon`).
-- **img_path** (*str*): Path to the image (for `big_picture` or `large_icon` styles).
-- **channel_id** (*str*): Notification channel ID.
+**Description:**
 
-#### `get_image_uri`
+- Checks if notification permissions are granted and requests them if missing.
 
-- Resolves the absolute URI of an image resource.
-- **relative_path** (*str*): The relative path to the image.
+**Usage:**
+
+```python
+asks_permission_if_needed()
+```
+
+---
+
+### 2. `get_image_uri(relative_path)`
+
+**Description:**
+
+- Resolves the absolute URI for an image in the app's storage.
+
+**Parameters:**
+
+- `relative_path` *(str)*: Path to the image (e.g., `assets/imgs/icon.png`).
+
+**Returns:**
+
+- `Uri`: Android URI object for the image.
+
+**Usage:**
+
+```python
+uri = get_image_uri('assets/imgs/icon.png')
+```
+
+---
+
+### 3. `send_notification(title, message, style=None, img_path=None, channel_id='default_channel')`
+
+**Description:**
+
+- Sends an Android notification with optional styles and images.
+
+**Parameters:**
+
+- `title` *(str)*: Notification title.
+- `message` *(str)*: Notification message.
+- `style` *(str, optional)*: Notification style (`big_text`, `big_picture`, `inbox`, `large_icon`).
+- `img_path` *(str, optional)*: Path to the image resource.(for `big_picture` or `large_icon` styles).
+- `channel_id` *(str, optional)*: Notification channel ID.
+
+Returns - notification id
 
 ### Advanced Usage
 
@@ -122,6 +179,15 @@ Feel free to open issues or submit pull requests for improvements!
 
 Found a bug? Please open an issue on our [GitHub Issues](https://github.com/Fector101/android_notify/issues) page.
 
+## Author
+
+- Fabian - <fector101@yahoo.com>
+- GitHub: <https://github.com/Fector101/android_notify>
+
+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.
@@ -130,11 +196,15 @@ If you find this project helpful, consider buying me a coffee! Your support help
   <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="60">
 </a>
 
-## Author
-
-- Fabian - <fector101@yahoo.com>
-- GitHub: <https://github.com/Fector101/android_notify>
+---
 
 ## Acknowledgments
 
 - Thanks to the Kivy and Pyjnius communities for their support.
+
+---
+
+## 🌐 **Links**
+
+- **PyPI:** [android-notify on PyPI](https://pypi.org/project/android-notify/)
+- **GitHub:** [Source Code Repository](hhttps://github.com/Fector101/android_notify/)

android_notify-1.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+android_notify/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+android_notify/__main__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+android_notify/core.py,sha256=P80jtB4Dim9c10ibgVPioEDJOKgjcoetl7rHAHEZEAI,5960
+android_notify/styles.py,sha256=P_8sAqb3Hbf_vbhqSoCVjKeqJ05Fr_CksO-HX5pj8pU,134
+android_notify-1.2.dist-info/METADATA,sha256=pkhzt6TaEZ1gTTEShVpXrATujLqcsVA-GQn3g7X65Qg,5125
+android_notify-1.2.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+android_notify-1.2.dist-info/top_level.txt,sha256=IR1ONMrRSRINZpWn2X0dL5gbWwWINsK7PW8Jy2p4fU8,15
+android_notify-1.2.dist-info/RECORD,,

{android_notify-1.1.dist-info → android_notify-1.2.dist-info}/WHEEL

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

android_notify-1.1.dist-info/RECORD

@@ -1,8 +0,0 @@
-android_notify/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-android_notify/__main__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-android_notify/core.py,sha256=0edRXIF6ltTboJtkGjnOhLJDrYCYa2fzrB7cy61Y1PM,6598
-android_notify/styles.py,sha256=P_8sAqb3Hbf_vbhqSoCVjKeqJ05Fr_CksO-HX5pj8pU,134
-android_notify-1.1.dist-info/METADATA,sha256=q2w4ak4jAcfJ9103bpKU-kPXdFdVgtpc4cbI7z5nd9I,3808
-android_notify-1.1.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-android_notify-1.1.dist-info/top_level.txt,sha256=IR1ONMrRSRINZpWn2X0dL5gbWwWINsK7PW8Jy2p4fU8,15
-android_notify-1.1.dist-info/RECORD,,