android-notify 1.60.0__tar.gz → 1.60.2__tar.gz

android_notify-1.60.2/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: android-notify
+Version: 1.60.2
+Summary: A Python package that simplifies creating Android notifications in Kivy and Flet apps.
+Author-email: Fabian <fector101@yahoo.com>
+License-Expression: MIT
+Project-URL: Homepage, https://android-notify.vercel.app
+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: 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
+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: pyjnius>=1.4.2
+Provides-Extra: dev
+Requires-Dist: kivy>=2.0.0; extra == "dev"
+
+<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 = [
+  "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.60.2/README.md

@@ -0,0 +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 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 = [
+  "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.60.2/android_notify/config.py

@@ -0,0 +1,145 @@
+import os, traceback
+
+ON_ANDROID = False
+__version__ = "1.60.2"
+
+def on_flet_app():
+    return os.getenv("MAIN_ACTIVITY_HOST_CLASS_NAME")
+
+def get_activity_class_name():
+    ACTIVITY_CLASS_NAME = os.getenv("MAIN_ACTIVITY_HOST_CLASS_NAME") # flet python
+    if not ACTIVITY_CLASS_NAME:
+        try:
+            from android import config
+            ACTIVITY_CLASS_NAME = config.JAVA_NAMESPACE
+        except (ImportError, AttributeError):
+            ACTIVITY_CLASS_NAME = 'org.kivy.android'
+    return ACTIVITY_CLASS_NAME
+
+
+if os.getenv("MAIN_ACTIVITY_HOST_CLASS_NAME"):
+    from jnius import cast, autoclass
+else:
+    # print('Not on Flet android env...\n')
+    try:
+        import kivy #TODO find var for kivy
+        from jnius import cast, autoclass
+    except Exception as e:
+        print('android-notify: No pjnius, not on android')
+        # So commandline still works if java isn't installed and get pyjinus import error
+        # print('Exception occured in __init__.py: ',e)
+        cast = lambda x: x
+        autoclass = lambda x: None
+try:
+    # Android Imports
+
+    # Get the required Java classes needs to on android to import
+    Bundle = autoclass('android.os.Bundle')
+    String = autoclass('java.lang.String')
+    Intent = autoclass('android.content.Intent')
+    PendingIntent = autoclass('android.app.PendingIntent')
+    BitmapFactory = autoclass('android.graphics.BitmapFactory')
+    BuildVersion = autoclass('android.os.Build$VERSION')
+    NotificationManager = autoclass('android.app.NotificationManager')
+    NotificationChannel = autoclass('android.app.NotificationChannel')
+    RemoteViews = autoclass('android.widget.RemoteViews')
+
+    ON_ANDROID = RemoteViews
+except Exception as e:
+    from .an_types import *
+    if hasattr(e,'name') and e.name != 'android' :
+        print('Exception: ',e)
+        print(traceback.format_exc())
+
+
+if ON_ANDROID:
+    try:
+        NotificationManagerCompat = autoclass('androidx.core.app.NotificationManagerCompat')
+        NotificationCompat = autoclass('androidx.core.app.NotificationCompat')
+        IconCompat = autoclass('androidx.core.graphics.drawable.IconCompat')
+        Color = autoclass('android.graphics.Color')
+
+        # Notification Design
+        NotificationCompatBuilder = autoclass('androidx.core.app.NotificationCompat$Builder')
+        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:
+        print('dependencies_import_error: ',dependencies_import_error)
+        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
+        """)
+
+        from .an_types import *
+else:
+    from .an_types import *
+
+def from_service_file():
+    return 'PYTHON_SERVICE_ARGUMENT' in os.environ
+
+run_on_ui_thread = None
+if on_flet_app() or from_service_file() or not ON_ANDROID:
+    def run_on_ui_thread(func):
+        """Fallback for Developing on PC"""
+
+        def wrapper(*args, **kwargs):
+            # print("Simulating run on UI thread")
+            return func(*args, **kwargs)
+
+        return wrapper
+else:# TODO find var for kivy
+    from android.runnable import run_on_ui_thread
+
+def get_python_activity():
+    if not ON_ANDROID:
+        from .an_types import PythonActivity
+        return PythonActivity
+    ACTIVITY_CLASS_NAME = get_activity_class_name()
+    if from_service_file():
+        PythonActivity = autoclass(ACTIVITY_CLASS_NAME + '.PythonService')
+    elif on_flet_app():
+        PythonActivity = autoclass(ACTIVITY_CLASS_NAME)
+    else:
+        PythonActivity = autoclass(ACTIVITY_CLASS_NAME + '.PythonActivity')
+    return PythonActivity
+
+def get_python_activity_context():
+    if not ON_ANDROID:
+        from .an_types import Context
+        return Context
+
+    PythonActivity = get_python_activity()
+    if from_service_file():
+        service = PythonActivity.mService
+        context = service.getApplication().getApplicationContext()
+        # context = PythonActivity.mService
+    else:
+        context = PythonActivity.mActivity
+    return context
+
+
+if ON_ANDROID:
+    context = get_python_activity_context()
+else:
+    context = None
+
+def get_notification_manager():
+    if not ON_ANDROID:
+        return None
+    notification_service = context.getSystemService(context.NOTIFICATION_SERVICE)
+    return cast(NotificationManager, notification_service)
+
+def app_storage_path():
+    if on_flet_app():
+        return os.path.join(context.getFilesDir().getAbsolutePath(), 'flet')
+    else:
+        try:
+            from android.storage import app_storage_path as kivy_app_storage_path  # type: ignore
+            return kivy_app_storage_path()
+        except Exception as e:
+            return './'  # TODO return file main.py path (not android)

android_notify-1.60.2/android_notify.egg-info/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: android-notify
+Version: 1.60.2
+Summary: A Python package that simplifies creating Android notifications in Kivy and Flet apps.
+Author-email: Fabian <fector101@yahoo.com>
+License-Expression: MIT
+Project-URL: Homepage, https://android-notify.vercel.app
+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: 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
+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: pyjnius>=1.4.2
+Provides-Extra: dev
+Requires-Dist: kivy>=2.0.0; extra == "dev"
+
+<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 = [
+  "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>