android-notify 1.59.4__tar.gz → 1.60.1__tar.gz

{android_notify-1.59.4 → android_notify-1.60.1}/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: android-notify
-Version: 1.59.4
-Summary: A Python package that simplifies creating Android notifications in Kivy apps.
+Version: 1.60.1
+Summary: A Python package that simplifies creating Android notifications in Kivy and Flet apps.
 Home-page: https://android-notify.vercel.app
 Author: Fabian
 Author-email: fector101@yahoo.com
 License: MIT
 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: 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
@@ -19,7 +19,6 @@ 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
 Dynamic: author
 Dynamic: author-email
@@ -37,7 +36,7 @@ Dynamic: summary
 <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 apps.</p>
+    <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"> -->
@@ -49,19 +48,20 @@ The Android Notify package provides a simple yet comprehensive way to create and
 
 - **Multiple Notification Styles**: Support for various notification styles including:
   - Simple text notifications
-  - Progress bar notifications (determinate and indeterminate)
-  - Big text notifications
-  - Inbox-style 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 content dynamically
+  - [Update notification](https://android-notify.vercel.app/advanced-methods#updating-notification) content dynamically
   - Manage progress bars with fine-grained control
-  - Custom notification Icon
-  - Custom notification channels for Android 8.0+ (Creating and Deleting)
+  - [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
@@ -85,6 +85,8 @@ Notification(
 
 ## Installation
 
+### Kivy apps:  
+
 In your **`buildozer.spec`** file, ensure you include the following:
 
 ```ini
@@ -99,13 +101,68 @@ android.enable_androidx = True
 android.api = 35
 ```
 
+### Flet apps:  
+
+1/3) In your `pyproject.toml` file, ensure you include the following:
+
+```toml
+[tool.flet.android]
+dependencies = [
+  "certifi==2025.6.15","pyjnius","android-notify"
+]
+
+[tool.flet.android.permission]
+"android.permission.POST_NOTIFICATIONS" = true
+```
+2/3) At Path `<project-root>/build/flutter/android/app/build.gradle` add the following lines at the end of the file:
+
+Change from this: `dependencies{}`  
+To this:
+```gradle
+dependencies {
+    implementation 'androidx.core:core:1.6.0'
+    implementation 'androidx.core:core-ktx:1.15.0'
+}
+```
+3/3) At Path `<project-root>/build/flutter/android/app/proguard-rules.pro` add the following lines at the end of the file:
+
+Change from this:
+```proguard
+-keep class com.flet.serious_python_android.** { *; }
+-keepnames class * { *; }
+```
+To this:
+```proguard
+-keep class com.flet.serious_python_android.** { *; }
+-keepnames class * { *; }
+
+# Keep any AndroidX Core class with 'Notification' in its name
+-keep class androidx.core.**Notification** { *; }
+-keep class androidx.core.**Notification**$* { *; }
+
+# Used to request access to Notification
+-keep class androidx.core.app.ActivityCompat { *; }
+```
+> [!NOTE]  
+> If you change these values `dependencies, name, bundle_id, product, company` in your `pyproject.toml` file, make sure to go through the above steps again to ensure the changes are reflected in the build files.
+[complete flet example](https://github.com/Fector101/android_notify/tree/main/docs/examples/flet-working)
+
 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/main.zip```
+
+
+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`
 
 For full documentation, examples, and advanced usage, API reference visit the
 [documentation](https://android-notify.vercel.app)

{android_notify-1.59.4 → android_notify-1.60.1}/README.md

@@ -1,83 +1,141 @@
-<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 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 (determinate and indeterminate)
-  - Big text notifications
-  - Inbox-style notifications
-  - Large icon notifications
-  - Big picture notifications
-  - Combined image styles
-
-- **Rich Functionality**:
-  - Add action buttons with custom callbacks
-  - Update notification content dynamically
-  - Manage progress bars with fine-grained control
-  - Custom notification Icon
-  - Custom notification channels 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
-
-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
-# 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
-android.api = 35
-```
-
-Can be installed via `pip` For testing purposes:
-
-```bash
-pip install android_notify
-```
-
-## Documentation
-
-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>
+<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
+# 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
+android.api = 35
+```
+
+### Flet apps:  
+
+1/3) In your `pyproject.toml` file, ensure you include the following:
+
+```toml
+[tool.flet.android]
+dependencies = [
+  "certifi==2025.6.15","pyjnius","android-notify"
+]
+
+[tool.flet.android.permission]
+"android.permission.POST_NOTIFICATIONS" = true
+```
+2/3) At Path `<project-root>/build/flutter/android/app/build.gradle` add the following lines at the end of the file:
+
+Change from this: `dependencies{}`  
+To this:
+```gradle
+dependencies {
+    implementation 'androidx.core:core:1.6.0'
+    implementation 'androidx.core:core-ktx:1.15.0'
+}
+```
+3/3) At Path `<project-root>/build/flutter/android/app/proguard-rules.pro` add the following lines at the end of the file:
+
+Change from this:
+```proguard
+-keep class com.flet.serious_python_android.** { *; }
+-keepnames class * { *; }
+```
+To this:
+```proguard
+-keep class com.flet.serious_python_android.** { *; }
+-keepnames class * { *; }
+
+# Keep any AndroidX Core class with 'Notification' in its name
+-keep class androidx.core.**Notification** { *; }
+-keep class androidx.core.**Notification**$* { *; }
+
+# Used to request access to Notification
+-keep class androidx.core.app.ActivityCompat { *; }
+```
+> [!NOTE]  
+> If you change these values `dependencies, name, bundle_id, product, company` in your `pyproject.toml` file, make sure to go through the above steps again to ensure the changes are reflected in the build files.
+[complete flet example](https://github.com/Fector101/android_notify/tree/main/docs/examples/flet-working)
+
+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/main.zip```
+
+
+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`
+
+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.59.4 → android_notify-1.60.1}/android_notify/__init__.py

@@ -1,4 +1,4 @@
-""""For Easier Imports For Public Classes"""
-from .core import send_notification
-from .styles import NotificationStyles
-from .sword import Notification,NotificationHandler
+""""For Easier Imports For Public Classes"""
+from .core import send_notification
+from .styles import NotificationStyles
+from .sword import Notification,NotificationHandler

android_notify-1.60.1/android_notify/__main__.py

@@ -0,0 +1,24 @@
+import argparse
+from .config import __version__
+
+def print_version():
+    text = f"android_notify: v{__version__}"
+    border = '+'+'-'*(len(text) + 2)+'+'
+    print(border)
+    print(f'| {text} |')
+    print(border)
+
+def main():
+    parser = argparse.ArgumentParser(description="Android Notify CLI")
+    parser.add_argument('-v','--version', action='store_true', help="Show the version of android_notify")
+    args = parser.parse_args()
+
+    if args.version:
+        print_version()
+    # # Placeholder for the main functionality
+    # print("Android Notify CLI is running...")
+    # DEV:  pip install -e ., when edit and test project locally
+
+
+if __name__ == "__main__":
+    main()

android_notify-1.60.1/android_notify/an_types.py

@@ -0,0 +1,226 @@
+"""For autocomplete Storing Reference to Available Methods"""
+from typing import Literal
+Importance = Literal['urgent','high','medium','low','none']
+"""
+    :argument urgent - Makes a sound and appears as a heads-up notification.
+    
+    :argument high - Makes a sound.
+    
+    :argument urgent - Makes no sound.
+    
+    :argument urgent - Makes no sound and doesn't appear in the status bar.
+    
+    :argument urgent - Makes no sound and doesn't in the status bar or shade.
+"""
+
+
+# For Dev
+# Idea for typing autocompletion and reference
+class Bundle:
+    def putString(self,key,value):
+        print(self,key,value)
+
+    def putInt(self,key,value):
+        print(self, key, value)
+
+class String(str):
+    pass
+
+
+class Intent:
+    def __init__(self,context,activity):
+        self.obj={}
+        pass
+
+    def setAction(self,action):
+        print(action)
+        return self
+
+    def setFlags(self,intent_flag):
+        print(intent_flag)
+        return self
+
+    def getAction(self):
+        return self
+
+    def getStringExtra(self,key):
+        return self
+
+    def putExtra(self,key,value):
+        self.obj[key] = value
+
+    def putExtras(self,bundle:Bundle):
+        self.obj['bundle'] = bundle
+
+class PendingIntent:
+    FLAG_IMMUTABLE=''
+    FLAG_UPDATE_CURRENT=''
+
+    def getActivity(self,context,value,action_intent,pending_intent_type):
+        pass
+
+class BitmapFactory:
+    def decodeStream(self,stream):
+        pass
+
+class BuildVersion:
+    SDK_INT=0
+
+class NotificationManager:
+    pass
+
+class NotificationChannel:
+    def __init__(self,channel_id,channel_name,importance):
+        self.description = None
+        self.channel_id = None
+        self.channel = None
+    def createNotificationChannel(self, channel):
+        self.channel=channel
+
+    def getNotificationChannel(self, channel_id):
+        self.channel_id=channel_id
+        pass
+
+    def setDescription(self, description):
+        self.description=description
+
+    def getId(self):
+        return  self.channel_id
+
+class IconCompat:
+    def createWithBitmap(self,bitmap):
+        pass
+
+class Color:
+    def __init__(self):
+        pass
+    def parseColor(self,color:str):
+        return self
+
+class RemoteViews:
+    def __init__(self, package_name, small_layout_id):
+        pass
+    def createWithBitmap(self,bitmap):
+        pass
+    def setTextViewText(self,id, text):
+        pass
+    def setTextColor(self,id, color:Color):
+        pass
+
+class NotificationManagerCompat:
+    IMPORTANCE_HIGH=4
+    IMPORTANCE_DEFAULT=3
+    IMPORTANCE_LOW=''
+    IMPORTANCE_MIN=''
+    IMPORTANCE_NONE=''
+
+class NotificationCompat:
+    DEFAULT_ALL=3
+    PRIORITY_HIGH=4
+    PRIORITY_DEFAULT = ''
+    PRIORITY_LOW=''
+    PRIORITY_MIN=''
+
+class MActions:
+    def clear(self):
+        """This Removes all buttons"""
+        print('dummy clear')
+
+class NotificationCompatBuilder:
+    def __init__(self,context,channel_id):
+        self.mActions = MActions()
+        pass
+    def setProgress(self,max_value,current_value,endless):
+        pass
+    def setStyle(self,style):
+        pass
+    def setContentTitle(self,title):
+        pass
+    def setContentText(self,text):
+        pass
+    def setSmallIcon(self,icon):
+        pass
+    def setLargeIcon(self,icon):
+        pass
+    def setAutoCancel(self,auto_cancel:bool):
+        pass
+    def setPriority(self,priority:Importance):
+        pass
+    def setDefaults(self,defaults:NotificationCompat.DEFAULT_ALL):
+        pass
+    def setOngoing(self,persistent:bool):
+        pass
+    def setOnlyAlertOnce(self,state):
+        pass
+    def build(self):
+        pass
+    def setContentIntent(self,pending_action_intent:PendingIntent):
+        pass
+    def addAction(self,icon_int,action_text,pending_action_intent):
+        pass
+    def setShowWhen(self,state):
+        pass
+    def setWhen(self,time_ms):
+        pass
+    def setCustomContentView(self,layout):
+        pass
+    def setCustomBigContentView(self,layout):
+        pass
+    def setSubText(self,text):
+        pass
+    def setColor(self, color:Color) -> None:
+        pass
+class NotificationCompatBigTextStyle:
+    def bigText(self,body):
+        return self
+
+class NotificationCompatBigPictureStyle:
+    def bigPicture(self,bitmap):
+        return self
+
+class NotificationCompatInboxStyle:
+    def addLine(self,line):
+        return self
+
+class NotificationCompatDecoratedCustomViewStyle:
+    pass
+
+class Permission:
+    POST_NOTIFICATIONS=''
+
+def check_permission(permission:Permission.POST_NOTIFICATIONS):
+    print(permission)
+
+def request_permissions(_list: [], _callback):
+    _callback()
+
+class AndroidActivity:
+    def bind(self,on_new_intent):
+        pass
+    def unbind(self,on_new_intent):
+        pass
+
+class PythonActivity:
+    pass
+
+class DummyIcon:
+    icon = 101
+    pass
+class Context:
+    def __init__(self):
+        pass
+
+    @staticmethod
+    def getApplicationInfo():
+        return DummyIcon
+
+    @staticmethod
+    def getResources():
+        return None
+
+    @staticmethod
+    def getPackageName():
+        return None # TODO get package name from buildozer.spec file
+
+#Now writing Knowledge from errors
+# notify.(int, Builder.build()) # must be int