android-notify 1.52__tar.gz → 1.52.2__tar.gz

{android_notify-1.52 → android_notify-1.52.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: android-notify
-Version: 1.52
+Version: 1.52.2
 Summary: A Python package that simpilfies creating Android notifications in Kivy apps.
 Home-page: https://github.com/fector101/android-notify
 Author: Fabian
@@ -116,11 +116,11 @@ The library supports multiple notification styles:
 
 1. `simple` - Basic notification with title and message
 2. `progress` - Shows a progress bar
-3. `big_text` - Expandable notification with long text
-4. `inbox` - List-style notification
-5. `big_picture` - Notification with a large image
-6. `large_icon` - Notification with a custom icon
-7. `both_imgs` - Combines big picture and large icon
+3. `big_picture` - Notification with a large image
+4. `large_icon` - Notification with a custom icon
+5. `both_imgs` - Combines big picture and large icon
+6. `inbox` - List-style notification
+7. `big_text` - Expandable notification with long text
 8. `custom` - For custom notification styles
 
 ### Style Examples
@@ -138,7 +138,7 @@ notification = Notification(
     progress_current_value=0
 )
 notification.send()
-Clock.schedule_once(lambda dt: notification.updateProgressBar(30, "30% downloaded"), 350)
+Clock.schedule_interval(lambda dt: notification.updateProgressBar(dt, f"{dt}% downloaded"), 30)
 ```
 
 **Sample Image:**
@@ -223,11 +223,13 @@ notification.send()
 
 #### Big text notification
 
+When using `big_text` style `message` acts as sub-title, Then when notification drop down button is pressed `body` is revealed
+
 ```python
 notification = Notification(
     title="Article",
-    subject="Histroy of Loerm Ipsuim",
-    message="Lorem Ipsum is simply dummy text of the printing and ...",
+    message="Histroy of Loerm Ipsuim",
+    body="Lorem Ipsum is simply dummy text of the printing and ...",
     style="big_text"
 )
 ```
@@ -256,6 +258,8 @@ notification = Notification(
     title="Download..",
     style="progress"
 )
+# send notification
+notification.send()
 
 # Update progress
 notification.updateProgressBar(30, "30% downloaded")
@@ -264,22 +268,9 @@ notification.updateProgressBar(30, "30% downloaded")
 notification.removeProgressBar("Download Complete")
 ```
 
-### Channel Management
-
-Notifications are organized into channels. You can customize the channel name and ID:
-
-- Custom Channel Name's Gives User ability to turn on/off specific
-
-```python
-notification = Notification(
-    title="Download finished",
-    message="How to Catch a Fish.mp4",
-    channel_name="Download Notifications",  # Will create User-visible name "Download Notifications"
-    channel_id="downloads_notifications"  # Optional: specify custom channel ID
-)
-```
+### Adding Style even when already sent
 
-### Changing Style When Already Sent
+This is how you add a new style to notification, If already sent or not
 
 ```python
 from android_notify import NotificationStyles
@@ -292,11 +283,28 @@ notification.send()
 
 notification.updateTitle("Download Completed")
 notification.removeProgressBar()
+
+# Add New Style
 notification.large_icon_path="users/imgs/profile1234.png"
 notification.addNotificationStyle(NotificationStyles.LARGE_ICON,already_sent=True)
 
 ```
 
+### Channel Management
+
+Notifications are organized into channels. You can customize the channel name and ID:
+
+- Custom Channel Name's Gives User ability to turn on/off specific notifications
+
+```python
+notification = Notification(
+    title="Download finished",
+    message="How to Catch a Fish.mp4",
+    channel_name="Download Notifications",  # Will create User-visible name "Download Notifications"
+    channel_id="downloads_notifications"  # Optional: specify custom channel ID
+)
+```
+
 **Sample Image:**  
 ![channels img sample](https://raw.githubusercontent.com/Fector101/android_notify/main/docs/imgs/channel_name.jpg)
 

{android_notify-1.52 → android_notify-1.52.2}/README.md

@@ -80,11 +80,11 @@ The library supports multiple notification styles:
 
 1. `simple` - Basic notification with title and message
 2. `progress` - Shows a progress bar
-3. `big_text` - Expandable notification with long text
-4. `inbox` - List-style notification
-5. `big_picture` - Notification with a large image
-6. `large_icon` - Notification with a custom icon
-7. `both_imgs` - Combines big picture and large icon
+3. `big_picture` - Notification with a large image
+4. `large_icon` - Notification with a custom icon
+5. `both_imgs` - Combines big picture and large icon
+6. `inbox` - List-style notification
+7. `big_text` - Expandable notification with long text
 8. `custom` - For custom notification styles
 
 ### Style Examples
@@ -102,7 +102,7 @@ notification = Notification(
     progress_current_value=0
 )
 notification.send()
-Clock.schedule_once(lambda dt: notification.updateProgressBar(30, "30% downloaded"), 350)
+Clock.schedule_interval(lambda dt: notification.updateProgressBar(dt, f"{dt}% downloaded"), 30)
 ```
 
 **Sample Image:**
@@ -187,11 +187,13 @@ notification.send()
 
 #### Big text notification
 
+When using `big_text` style `message` acts as sub-title, Then when notification drop down button is pressed `body` is revealed
+
 ```python
 notification = Notification(
     title="Article",
-    subject="Histroy of Loerm Ipsuim",
-    message="Lorem Ipsum is simply dummy text of the printing and ...",
+    message="Histroy of Loerm Ipsuim",
+    body="Lorem Ipsum is simply dummy text of the printing and ...",
     style="big_text"
 )
 ```
@@ -220,6 +222,8 @@ notification = Notification(
     title="Download..",
     style="progress"
 )
+# send notification
+notification.send()
 
 # Update progress
 notification.updateProgressBar(30, "30% downloaded")
@@ -228,22 +232,9 @@ notification.updateProgressBar(30, "30% downloaded")
 notification.removeProgressBar("Download Complete")
 ```
 
-### Channel Management
-
-Notifications are organized into channels. You can customize the channel name and ID:
-
-- Custom Channel Name's Gives User ability to turn on/off specific
-
-```python
-notification = Notification(
-    title="Download finished",
-    message="How to Catch a Fish.mp4",
-    channel_name="Download Notifications",  # Will create User-visible name "Download Notifications"
-    channel_id="downloads_notifications"  # Optional: specify custom channel ID
-)
-```
+### Adding Style even when already sent
 
-### Changing Style When Already Sent
+This is how you add a new style to notification, If already sent or not
 
 ```python
 from android_notify import NotificationStyles
@@ -256,11 +247,28 @@ notification.send()
 
 notification.updateTitle("Download Completed")
 notification.removeProgressBar()
+
+# Add New Style
 notification.large_icon_path="users/imgs/profile1234.png"
 notification.addNotificationStyle(NotificationStyles.LARGE_ICON,already_sent=True)
 
 ```
 
+### Channel Management
+
+Notifications are organized into channels. You can customize the channel name and ID:
+
+- Custom Channel Name's Gives User ability to turn on/off specific notifications
+
+```python
+notification = Notification(
+    title="Download finished",
+    message="How to Catch a Fish.mp4",
+    channel_name="Download Notifications",  # Will create User-visible name "Download Notifications"
+    channel_id="downloads_notifications"  # Optional: specify custom channel ID
+)
+```
+
 **Sample Image:**  
 ![channels img sample](https://raw.githubusercontent.com/Fector101/android_notify/main/docs/imgs/channel_name.jpg)
 

{android_notify-1.52 → android_notify-1.52.2}/android_notify/sword.py

@@ -76,7 +76,7 @@ class Notification:
     :param large_icon_path: Relative Path to the image resource.
     :param progress_current_value: interger To set progress bar current value.
     :param progress_max_value: interger To set Max range for progress bar.
-    :param subject: Preview text For `big_Text` style `message`.
+    :param body: large text For `big_Text` style, while `message` acts as sub-title.
     ---
     (Advance Options)
     :param callback: Function for notification Click.
@@ -105,7 +105,7 @@ class Notification:
         'large_icon_path':'',
         'progress_max_value': 0,
         'progress_current_value': 0,
-        'subject':'',
+        'body':'',
         'channel_name':'Default Channel',
         'channel_id':'default_channel',
         'logs':True,
@@ -116,6 +116,7 @@ class Notification:
     # if key not in non_string_keys: value = str(value) to fix
     #non_string_keys=['progress_max_value','progress_current_value','callback','logs']
     # TODO using default values to check types
+    
     # During Development (When running on PC)
     logs=not ON_ANDROID
     def __init__(self,**kwargs):
@@ -128,7 +129,7 @@ class Notification:
         self.big_picture_path=''
         self.progress_current_value=0
         self.progress_max_value=0
-        self.subject= ''
+        self.body= ''
 
         # For Nofitication Functions
         self.identifer=''
@@ -139,9 +140,6 @@ class Notification:
         self.channel_id='default_channel'
         self.silent=False
 
-        # During Dev on PC
-        self.logs=self.logs
-
         # Private (Don't Touch)
         self.__id = self.__getUniqueID()
         self.__setArgs(kwargs)
@@ -160,6 +158,8 @@ class Notification:
             new_title (str): New Notification Title
         """
         self.title=new_title
+        if self.logs:
+            print(f'new notification title: {new_title}')
         if ON_ANDROID:
             self.__builder.setContentTitle(new_title)
 
@@ -170,11 +170,11 @@ class Notification:
             new_message (str): New Notification Message
         """
         self.message=new_message
+        if self.logs:
+            print(f'new notification message: {new_message}')
         if ON_ANDROID:
             self.__builder.setContentText(new_message)
-            
-            return True
-        return 'Updated'
+
     def updateProgressBar(self,current_value,message:str=''):
         """current_value is the value to set progressbar, message defaults to last message"""
 
@@ -193,7 +193,7 @@ class Notification:
         """message defaults to last message"""
 
         if self.logs:
-            print('removed')
+            print(f'removed progress bar with message: {self.message}')
 
         if not ON_ANDROID:
             return True
@@ -218,7 +218,7 @@ class Notification:
             string_to_display=''
             print("\n Sent Notification!!!")
             for name,value in vars(self).items():
-                if value and name in ["title", "message", "style", "subject", "large_icon_path", "big_picture_path", "progress_current_value", "progress_max_value", "channel_name"]:
+                if value and name in ["title", "message", "style", "body", "large_icon_path", "big_picture_path", "progress_current_value", "progress_max_value", "channel_name"]:
                     string_to_display += f'\n {name}: {value}'
             string_to_display +="\n (Won't Print Logs When Complied,except if selected `Notification.logs=True`)"
             print(string_to_display)
@@ -291,10 +291,7 @@ class Notification:
         # str() This is to prevent Error When user does Notification.title='blah' instead of Notification(title='blah'
         # TODO fix this by creating a on_Title method in other versions
         self.__builder.setContentTitle(str(self.title))
-        if self.style == NotificationStyles.BIG_TEXT:
-            self.__builder.setContentText(str(self.subject))
-        else:
-            self.__builder.setContentText(str(self.message))
+        self.__builder.setContentText(str(self.message))
         self.__builder.setSmallIcon(context.getApplicationInfo().icon)
         self.__builder.setDefaults(NotificationCompat.DEFAULT_ALL) # pylint: disable=E0606
         self.__builder.setPriority(NotificationCompat.PRIORITY_DEFAULT if self.silent else NotificationCompat.PRIORITY_HIGH)
@@ -303,7 +300,7 @@ class Notification:
     @run_on_ui_thread
     def addNotificationStyle(self,style:str,already_sent=False):
         """Adds Style to Notification
-            Version 1.51.2+ Exposing to Users (Note): Always Call On UI Thread
+            Version 1.51.2+ Exposes method to Users (Note): Always try to Call On UI Thread
 
         Args:
             style (str): required style
@@ -315,20 +312,18 @@ class Notification:
         
         if style == NotificationStyles.BIG_TEXT:
             big_text_style = NotificationCompatBigTextStyle() # pylint: disable=E0606
-            big_text_style.bigText(self.message)
+            big_text_style.bigText(str(self.body))
             self.__builder.setStyle(big_text_style)
 
         elif style == NotificationStyles.INBOX:
             inbox_style = NotificationCompatInboxStyle() # pylint: disable=E0606
             for line in self.message.split("\n"):
-                inbox_style.addLine(line)
+                inbox_style.addLine(str(line))
             self.__builder.setStyle(inbox_style)
 
-        elif style == NotificationStyles.BIG_PICTURE and self.big_picture_path:
-            self.__buildImg(self.big_picture_path, style)
-
-        elif style == NotificationStyles.LARGE_ICON and self.large_icon_path:
-            self.__buildImg(self.large_icon_path, style)
+        elif (style == NotificationStyles.LARGE_ICON and self.large_icon_path) or (style == NotificationStyles.BIG_PICTURE and self.big_picture_path):
+            img = self.large_icon_path if style == NotificationStyles.LARGE_ICON else self.big_picture_path
+            self.__buildImg(img, style)
 
         elif style == NotificationStyles.BOTH_IMGS and (self.big_picture_path or self.large_icon_path):
             if self.big_picture_path:
@@ -336,7 +331,7 @@ class Notification:
             if self.large_icon_path:
                 self.__buildImg(self.large_icon_path, NotificationStyles.LARGE_ICON)
 
-        elif style == 'progress':
+        elif style == NotificationStyles.PROGRESS:
             self.__builder.setContentTitle(String(self.title))
             self.__builder.setContentText(String(self.message))
             self.__builder.setProgress(self.progress_max_value, self.progress_current_value, False)

{android_notify-1.52 → android_notify-1.52.2}/android_notify.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: android-notify
-Version: 1.52
+Version: 1.52.2
 Summary: A Python package that simpilfies creating Android notifications in Kivy apps.
 Home-page: https://github.com/fector101/android-notify
 Author: Fabian
@@ -116,11 +116,11 @@ The library supports multiple notification styles:
 
 1. `simple` - Basic notification with title and message
 2. `progress` - Shows a progress bar
-3. `big_text` - Expandable notification with long text
-4. `inbox` - List-style notification
-5. `big_picture` - Notification with a large image
-6. `large_icon` - Notification with a custom icon
-7. `both_imgs` - Combines big picture and large icon
+3. `big_picture` - Notification with a large image
+4. `large_icon` - Notification with a custom icon
+5. `both_imgs` - Combines big picture and large icon
+6. `inbox` - List-style notification
+7. `big_text` - Expandable notification with long text
 8. `custom` - For custom notification styles
 
 ### Style Examples
@@ -138,7 +138,7 @@ notification = Notification(
     progress_current_value=0
 )
 notification.send()
-Clock.schedule_once(lambda dt: notification.updateProgressBar(30, "30% downloaded"), 350)
+Clock.schedule_interval(lambda dt: notification.updateProgressBar(dt, f"{dt}% downloaded"), 30)
 ```
 
 **Sample Image:**
@@ -223,11 +223,13 @@ notification.send()
 
 #### Big text notification
 
+When using `big_text` style `message` acts as sub-title, Then when notification drop down button is pressed `body` is revealed
+
 ```python
 notification = Notification(
     title="Article",
-    subject="Histroy of Loerm Ipsuim",
-    message="Lorem Ipsum is simply dummy text of the printing and ...",
+    message="Histroy of Loerm Ipsuim",
+    body="Lorem Ipsum is simply dummy text of the printing and ...",
     style="big_text"
 )
 ```
@@ -256,6 +258,8 @@ notification = Notification(
     title="Download..",
     style="progress"
 )
+# send notification
+notification.send()
 
 # Update progress
 notification.updateProgressBar(30, "30% downloaded")
@@ -264,22 +268,9 @@ notification.updateProgressBar(30, "30% downloaded")
 notification.removeProgressBar("Download Complete")
 ```
 
-### Channel Management
-
-Notifications are organized into channels. You can customize the channel name and ID:
-
-- Custom Channel Name's Gives User ability to turn on/off specific
-
-```python
-notification = Notification(
-    title="Download finished",
-    message="How to Catch a Fish.mp4",
-    channel_name="Download Notifications",  # Will create User-visible name "Download Notifications"
-    channel_id="downloads_notifications"  # Optional: specify custom channel ID
-)
-```
+### Adding Style even when already sent
 
-### Changing Style When Already Sent
+This is how you add a new style to notification, If already sent or not
 
 ```python
 from android_notify import NotificationStyles
@@ -292,11 +283,28 @@ notification.send()
 
 notification.updateTitle("Download Completed")
 notification.removeProgressBar()
+
+# Add New Style
 notification.large_icon_path="users/imgs/profile1234.png"
 notification.addNotificationStyle(NotificationStyles.LARGE_ICON,already_sent=True)
 
 ```
 
+### Channel Management
+
+Notifications are organized into channels. You can customize the channel name and ID:
+
+- Custom Channel Name's Gives User ability to turn on/off specific notifications
+
+```python
+notification = Notification(
+    title="Download finished",
+    message="How to Catch a Fish.mp4",
+    channel_name="Download Notifications",  # Will create User-visible name "Download Notifications"
+    channel_id="downloads_notifications"  # Optional: specify custom channel ID
+)
+```
+
 **Sample Image:**  
 ![channels img sample](https://raw.githubusercontent.com/Fector101/android_notify/main/docs/imgs/channel_name.jpg)
 

{android_notify-1.52 → android_notify-1.52.2}/setup.py

@@ -6,7 +6,7 @@ with open("README.md", "r", encoding="utf-8") as readme_data:
 
 setup(
     name="android-notify",
-    version="1.52",
+    version="1.52.2",
     author="Fabian",
     author_email='fector101@yahoo.com',
     description="A Python package that simpilfies creating Android notifications in Kivy apps.",