android-notify 1.59.4__py3-none-any.whl → 1.60.1__py3-none-any.whl

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/__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/an_types.py

@@ -1,91 +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.
-"""
-
-# Idea for typing autocompletion and reference
-# class Bundle:
-#     pass
-# class PythonActivity:
-#     mActivity=''# Get the app's context
-#     pass
-# class String(str):
-#     pass
-# class Intent:
-#     def __init__(self,context,activity):
-#         pass
-# 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):
-#         pass
-#     def createNotificationChannel(self, channel):
-#         pass
-#
-#     def getNotificationChannel(self, channel_id):
-#         pass
-# class IconCompat:
-#     def createWithBitmap(self,bitmap):
-#         pass
-#
-# class NotificationManagerCompat:
-#     IMPORTANCE_DEFAULT=3
-#     IMPORTANCE_HIGH=4
-#
-#
-# class NotificationCompat:
-#     DEFAULT_ALL=3
-#     PRIORITY_HIGH=4
-#
-#     def __init__(self,context):
-#         pass
-#     def Builder(self,context,channel_id):
-#         pass
-# class NotificationCompatBuilder:
-#     def __init__(self,context,channel_id):
-#         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):
-#         pass
-#     def setPriority(self,priority):
-#         pass
-#     def setDefaults(self,defaults):
-#         pass
-#     def build(self):
-#         pass
-# class NotificationCompatBigTextStyle:
-#     pass
-# class NotificationCompatBigPictureStyle:
-#     pass
-# class NotificationCompatInboxStyle:
-#     pass
-
-#Now writing Knowledge from errors
-# notify.(int, Builder.build()) # must be int
+"""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

android_notify/an_utils.py

@@ -1,18 +1,129 @@
-"""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
-
-
-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
+"""Collection of useful functions"""
+
+import inspect, os, re, traceback
+from .config import autoclass
+from .an_types import Importance
+from .config import (
+                     get_python_activity_context, app_storage_path,ON_ANDROID,
+                     BitmapFactory, BuildVersion, Bundle,
+                     NotificationManagerCompat,NotificationCompat
+                    )
+
+if ON_ANDROID:
+    Color = autoclass('android.graphics.Color')
+else:
+    from .an_types import Color
+
+def can_accept_arguments(func, *args, **kwargs):
+    try:
+        sig = inspect.signature(func)
+        sig.bind(*args, **kwargs)
+        return True
+    except TypeError:
+        return False
+
+if ON_ANDROID:
+    context = get_python_activity_context()
+else:
+    context = None
+
+def get_android_importance(importance: Importance):
+    """
+    Returns Android Importance Values
+    :param importance: ['urgent','high','medium','low','none']
+    :return: Android equivalent int or empty str
+    """
+    if not ON_ANDROID:
+        return None
+    value = ''
+    if importance == 'urgent':
+        value = NotificationCompat.PRIORITY_HIGH if BuildVersion.SDK_INT <= 25 else NotificationManagerCompat.IMPORTANCE_HIGH
+    elif importance == 'high':
+        value = NotificationCompat.PRIORITY_DEFAULT if BuildVersion.SDK_INT <= 25 else NotificationManagerCompat.IMPORTANCE_DEFAULT
+    elif importance == 'medium':
+        value = NotificationCompat.PRIORITY_LOW if BuildVersion.SDK_INT <= 25 else NotificationManagerCompat.IMPORTANCE_LOW
+    elif importance == 'low':
+        value = NotificationCompat.PRIORITY_MIN if BuildVersion.SDK_INT <= 25 else NotificationManagerCompat.IMPORTANCE_MIN
+    elif importance == 'none':
+        value = '' if BuildVersion.SDK_INT <= 25 else NotificationManagerCompat.IMPORTANCE_NONE
+
+    return value
+    # side-note 'medium' = NotificationCompat.PRIORITY_LOW and 'low' = NotificationCompat.PRIORITY_MIN # weird but from docs
+
+def generate_channel_id(channel_name: str) -> str:
+    """
+    Generate a readable and consistent channel ID from a channel name.
+
+    Args:
+        channel_name (str): The name of the notification channel.
+
+    Returns:
+        str: A sanitized channel ID.
+    """
+    # Normalize the channel name
+    channel_id = channel_name.strip().lower()
+    # Replace spaces and special characters with underscores
+    channel_id = re.sub(r'[^a-z0-9]+', '_', channel_id)
+    # Remove leading/trailing underscores
+    channel_id = channel_id.strip('_')
+    return channel_id[:50]
+
+def get_img_from_path(relative_path):
+    app_folder = os.path.join(app_storage_path(), 'app')
+    output_path = os.path.join(app_folder, relative_path)
+    if not os.path.exists(output_path):
+        print(f"\nImage not found at path: {app_folder}, (Local images gotten from App Path)")
+        try:
+            print("- These are the existing files in your app Folder:")
+            print('[' + ', '.join(os.listdir(app_folder)) + ']')
+        except Exception as could_not_get_files_in_path_error:
+            print('Exception: ', could_not_get_files_in_path_error)
+            print("Couldn't get Files in App Folder")
+        return None
+    # TODO test with a badly written Image and catch error
+    Uri = autoclass('android.net.Uri')
+    uri = Uri.parse(f"file://{output_path}")
+    return BitmapFactory.decodeStream(context.getContentResolver().openInputStream(uri))
+
+def setLayoutText(layout, id, text, color):
+    # checked if self.title_color available before entering method
+    if id and text:
+        layout.setTextViewText(id, text)
+        if color:
+            layout.setTextColor(id, Color.parseColor(color))
+
+def get_bitmap_from_url(url, callback, logs):
+    """Gets Bitmap from url
+
+    Args:
+        :param url: img url
+        :param callback: function to be called after thread done, callback receives bitmap data as argument
+        :param logs:
+    """
+    if logs:
+        print("getting Bitmap from URL---")
+    try:
+        URL = autoclass('java.net.URL')
+        url = URL(url)
+        connection = url.openConnection()
+        connection.connect()
+        input_stream = connection.getInputStream()
+        bitmap = BitmapFactory.decodeStream(input_stream)
+        input_stream.close()
+        if bitmap:
+            callback(bitmap)
+        else:
+            print('Error No Bitmap for small icon ------------')
+    except Exception as extracting_bitmap_frm_URL_error:
+        callback(None)
+        # TODO get all types of JAVA Error that can fail here
+        print('Error Type ', extracting_bitmap_frm_URL_error)
+        print('Failed to get Bitmap from URL ', traceback.format_exc())
+
+def add_data_to_intent(intent, title):
+    """Persist Some data to notification object for later use"""
+    bundle = Bundle()
+    bundle.putString("title", title or 'Title Placeholder')
+    # bundle.putInt("notify_id", self.__id)
+    bundle.putInt("notify_id", 101)
+    intent.putExtras(bundle)