android-notify 1.24.4__py3-none-any.whl → 1.31__py3-none-any.whl

android_notify/advanced_dev.py

@@ -1,345 +0,0 @@
-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-1.24.4.dist-info/METADATA

@@ -1,298 +0,0 @@
-Metadata-Version: 2.1
-Name: android-notify
-Version: 1.24.4
-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
-License: MIT
-Project-URL: Documentation, https://github.com/fector101/android-notify/
-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
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-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: kivy>=2.0.0
-Requires-Dist: pyjnius>=1.4.2
-
-# Android Notify
-
-`android_notify` is a Python module designed to simplify sending Android notifications using Kivy and Pyjnius. It supports multiple notification styles, including text, images, and inbox layouts.
-
-## Features
-
-- Send Android notifications with custom titles and messages.
-- Support for multiple notification styles:
-  - Big Text
-  - Big Picture
-  - Large Icon
-  - Inbox
-- Supports including images in notifications.
-- Compatible with Android 8.0+ (Notification Channels).
-- Customizable notification channels.
-
-## Installation
-
-This package is available on PyPI and can be installed via pip:
-
-```bash
-pip install android-notify
-```
-
-## **Dependencies**
-
-**Prerequisites:**  
-
-- Buildozer  
-- Kivy
-
-In your **`buildozer.spec`** file, ensure you include the following:
-
-```ini
-# Add pyjnius so it's packaged with the build
-requirements = python3, kivy, pyjnius, android-notify
-
-# Add permission for notifications
-android.permissions = POST_NOTIFICATIONS
-
-# Required dependencies (write exactly as shown, no quotation marks)
-android.gradle_dependencies = androidx.core:core:1.6.0, androidx.core:core-ktx:1.15.0
-android.enable_androidx = True
-```
-
----
-
-### Example Notification
-
-#### Basic Notification
-
-```python
-from android_notify import send_notification
-
-# Send a basic notification
-send_notification("Hello", "This is a basic notification.")
-```
-
-**Example Image:**  
-![basic notification img sample](https://raw.githubusercontent.com/Fector101/android_notify/main/docs/imgs/basicnoti.jpg)
-#### Notification with an Image (Big Picture Style)
-
-```python
-# Send a notification with an image
-send_notification(
-    title='Picture Alert!',
-    message='This notification includes an image.',
-    style='big_picture',
-    img_path='assets/imgs/icon.png'
-)
-```
-
-**Example Image:**
-![big_picture img sample](https://raw.githubusercontent.com/Fector101/android_notify/main/docs/imgs/bigpicturenoti.jpg)
-#### Notification with an Image (Large Icon Style)
-
-```python
-# Send a notification with Large Icon
-send_notification(
-    title='Completed download',
-    message='profile.jpg',
-    style='large_icon',
-    img_path='assets/imgs/icon.png'
-)
-```
-
-**Example Image:**  
-![large_icon img sample](https://raw.githubusercontent.com/Fector101/android_notify/main/docs/imgs/large_icon.jpg)
-
-#### Inbox Notification Style
-
-```python
-# Send a notification with inbox style
-send_notification(
-    title='Inbox Notification',
-    message='Line 1\nLine 2\nLine 3',
-    style='inbox'
-)
-```
-
-**Example Image:**
-![Inbox Notification sample](https://raw.githubusercontent.com/Fector101/android_notify/main/docs/imgs/inboxnoti.jpg)
-
-#### Big Text Notification
-
-- (This will default to normal text if big text unsupported on device)
-
-```python
-# Send a Big Text notification
-send_notification(
-    title='Hello!',
-    message='This is a sample notification.',
-    style='big_text'
-)
-```
-<!-- 
-**Example Image:**  
-![Big Text Notification sample](https://raw.githubusercontent.com/Fector101/android_notify/main/docs/imgs/big_text.jpg) -->
-
----
-
-### Advanced Usage
-
-#### Channel Name (channel_name)
-
-- Can be found in App Settings where user can turn on/off specific Notifications
-
-```python
-#  if not specified Channel Name default's to "Default Channel"
-send_notification(
-    title="Download finished"
-    message="How to Catch a Fish.mp4"
-    channel_name="Download Notifications"
-)
-```
-
-**Sample Image:**  
-![channels img sample](https://raw.githubusercontent.com/Fector101/android_notify/main/docs/imgs/channel_name.jpg)
-
-#### Channel Name (channel_id)
-
-You can customize notification channels for different types of notifications.(In later version channel_id will be used to reference notification)
-
-```python
-send_notification(
-    title='Custom Channel Notification',
-    message='This uses a custom notification channel.',
-    channel_id='custom_channel'
-)
-```
-
----
-
-### **Assist**
-
-- How to Copy image to app folder
-
-```python
-import shutil,os # These modules come 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"))
-```
-
-- Avoiding Human Error when using different notification styles
-
-```python
-from android_notify import send_notification, NotificationStyles
-send_notification(
-    title='Picture Alert!',
-    message='This notification includes an image.',
-    img_path='assets/imgs/icon.png'
-    style=NotificationStyles.BIG_PICTURE,
-)
-```
-
----
-
-### **Functions Reference**
-
-### 1. `asks_permission_if_needed()`
-
-**Description:**
-
-- Checks if notification permissions are granted and requests them if missing.
-
-**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
-
-## Contribution
-
-Feel free to open issues or submit pull requests for improvements!
-
-## 🐛 Reporting Issues
-
-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: [Android Notify Repo](https://github.com/Fector101/android_notify)
-- Twitter: [FabianDev_](https://twitter.com/intent/user?user_id=1246911115319263233) -- 😊 I'm sure to answer
-
-For feedback or contributions, feel free to reach out!
-
----
-
-## ☕ 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>
-
----
-
-## Acknowledgments
-
-- This Project was "Made For Android" and thoroughly "Tested by" the [Laner Project](https://github.com/Fector101/Laner/) - Laner is an application that creates a secure connection between your PC and Phone to Transfer Files Wirelessly.
-- 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](https://github.com/Fector101/android_notify/)

android_notify-1.24.4.dist-info/RECORD

@@ -1,10 +0,0 @@
-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.4.dist-info/METADATA,sha256=AAvllXEKklI9vH9uOZPQATr4aA7wd_veWGKYJ8nfYtg,8311
-android_notify-1.24.4.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-android_notify-1.24.4.dist-info/top_level.txt,sha256=IR1ONMrRSRINZpWn2X0dL5gbWwWINsK7PW8Jy2p4fU8,15
-android_notify-1.24.4.dist-info/RECORD,,