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

android_notify-1.59/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: android-notify
+Version: 1.59
+Summary: A Python package that simplifies creating Android notifications in Kivy apps.
+Home-page: https://github.com/fector101/android-notify
+Author: Fabian
+Author-email: fector101@yahoo.com
+License: MIT
+Project-URL: Documentation, https://android-notify.vercel.app/getting-started
+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-Notifiy </h1>
+    <p><a href='https://android-notify.vercel.app/getting-started'>Android Notify</a> is a Python library for effortlessly creating and managing Android notifications in Kivy android 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>
+<!-- 
+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 channels for Android 8.0+
+  - Silent notifications
+  - Persistent notifications
+  - Click handlers and callbacks
+
+## 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/getting-started)
+
+## ☕ 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/README.md

@@ -0,0 +1,81 @@
+<div align="center">
+    <br>
+    <h1> Android-Notifiy </h1>
+    <p><a href='https://android-notify.vercel.app/getting-started'>Android Notify</a> is a Python library for effortlessly creating and managing Android notifications in Kivy android 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>
+<!-- 
+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 channels for Android 8.0+
+  - Silent notifications
+  - Persistent notifications
+  - Click handlers and callbacks
+
+## 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/getting-started)
+
+## ☕ 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/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.58 → android_notify-1.59}/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}"
             )
+