android-notify 1.58__tar.gz → 1.59.1__tar.gz

android_notify-1.59.1/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: android-notify
+Version: 1.59.1
+Summary: A Python package that simplifies creating Android notifications in Kivy 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: 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: 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
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+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>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>

android_notify-1.59.1/README.md

@@ -0,0 +1,83 @@
+<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>

android_notify-1.58/android_notify/types_idea.py → android_notify-1.59.1/android_notify/an_types.py

@@ -1,3 +1,19 @@
+"""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.
+"""
+
+# Idea for typing autocompletion and reference
 # class Bundle:
 #     pass
 # class PythonActivity:
@@ -69,4 +85,7 @@
 # class NotificationCompatBigPictureStyle:
 #     pass
 # class NotificationCompatInboxStyle:
-#     pass
+#     pass
+
+#Now writing Knowledge from errors
+# notify.(int, Builder.build()) # must be int

android_notify-1.59.1/android_notify/an_utils.py

@@ -0,0 +1,10 @@
+"""Collection of useful functions"""
+
+import inspect
+def can_accept_arguments(func, *args, **kwargs):
+    try:
+        sig = inspect.signature(func)
+        sig.bind(*args, **kwargs)
+        return True
+    except TypeError:
+        return False

{android_notify-1.58 → android_notify-1.59.1}/android_notify/base.py

@@ -1,11 +1,11 @@
-"""Assists Notification Class with Args keeps sub class cleaner"""
+"""Assists Notification Class with Args keeps subclass cleaner"""
 from dataclasses import dataclass, fields
 import difflib
 from .styles import NotificationStyles
 
 @dataclass
 class BaseNotification:
-    """Encapsulator"""
+    """Encapsulation"""
 
     # Basic options
     title: str = ''
@@ -20,18 +20,24 @@ class BaseNotification:
     body: str = ''
 
     # Notification Functions
-    identifer: str = ''
+    name: str = ''
     callback: object = None
 
     # Advanced Options
+    id: int = 0
     app_icon: str = 'Defaults to package app icon'
+
     channel_name: str = 'Default Channel'
+    """User visible channel name"""
     channel_id: str = 'default_channel'
+    """Used to reference notification channel"""
+
     silent: bool = False
     logs: bool = False
 
     def __init__(self, **kwargs):
         """Custom init to handle validation before dataclass assigns values"""
+
         # Validate provided arguments
         self.validate_args(kwargs)
 
@@ -80,3 +86,4 @@ class BaseNotification:
             raise ValueError(
                 f"Invalid style '{inputted_style}'. Allowed styles: {allowed_styles}"
             )
+

android_notify-1.59.1/android_notify/styles.py

@@ -0,0 +1,22 @@
+"""Contains Safe way to call Styles"""
+
+class NotificationStyles:
+    """ Safely Adding Styles"""
+    DEFAULT = "simple"
+
+    PROGRESS = "progress"
+    INBOX = "inbox"
+    
+    # v1.59+
+    # Deprecated
+    # setBigText == Notification(...,big_picture_path="...",style=NotificationStyles.BIG_TEXT)
+    # setLargeIcon == Notification(...,large_icon_path="...",style=NotificationStyles.LARGE_ICON)
+    # setBigPicture == Notification(...,body="...",style=NotificationStyles.BIG_PICTURE)
+    # Use .refresh to apply any new changes after .send
+    BIG_TEXT = "big_text"
+    LARGE_ICON = "large_icon"
+    BIG_PICTURE = "big_picture"
+    BOTH_IMGS = "both_imgs"
+
+    # MESSAGING = "messaging" # TODO
+    # CUSTOM = "custom" # TODO