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

android_notify/base.py

@@ -1,90 +1,97 @@
-"""Assists Notification Class with Args keeps subclass cleaner"""
-from dataclasses import dataclass, fields
-import difflib
-from .styles import NotificationStyles
-
-@dataclass
-class BaseNotification:
-    """Encapsulation"""
-
-    # Basic options
-    title: str = ''
-    message: str = ''
-    style: str = 'simple'
-
-    # Style-specific attributes
-    big_picture_path: str = ''
-    large_icon_path: str = ''
-    progress_max_value: int = 100
-    progress_current_value: float = 0.0 # Also Takes in Ints
-    body: str = ''
-    lines_txt: str = ''
-
-    # Notification Functions
-    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)
-
-        # Assign validated values using the normal dataclass behavior
-        for field_ in fields(self):
-            field_name = field_.name
-            setattr(self, field_name, kwargs.get(field_name, getattr(self, field_name)))
-
-    def validate_args(self, inputted_kwargs):
-        """Check for unexpected arguments and suggest corrections before Python validation"""
-        default_fields =  {field.name : field.type for field in fields(self)} #{'title': <class 'str'>, 'message': <class 'str'>,...
-        allowed_fields_keys = set(default_fields.keys())
-
-        # Identify invalid arguments
-        invalid_args = set(inputted_kwargs) - allowed_fields_keys
-        if invalid_args:
-            suggestions = []
-            for arg in invalid_args:
-                closest_match = difflib.get_close_matches(arg, allowed_fields_keys, n=1, cutoff=0.6)
-                if closest_match:
-                    suggestions.append(f"* '{arg}' is invalid -> Did you mean '{closest_match[0]}'?")
-                else:
-                    suggestions.append(f"* '{arg}' is not a valid argument.")
-
-            suggestion_text = '\n'.join(suggestions)
-            raise ValueError(f"Invalid arguments provided:\n{suggestion_text}")
-
-        # Validating types
-        for each_arg in inputted_kwargs.keys():
-            expected_type = default_fields[each_arg]
-            actual_value = inputted_kwargs[each_arg]
-
-            # Allow both int and float for progress_current_value
-            if each_arg == "progress_current_value":
-                if not isinstance(actual_value, (int, float)):
-                    raise TypeError(f"Expected '{each_arg}' to be int or float, got {type(actual_value)} instead.")
-            else:
-                if not isinstance(actual_value, expected_type):
-                    raise TypeError(f"Expected '{each_arg}' to be {expected_type}, got {type(actual_value)} instead.")
-
-        # Validate `style` values
-        style_values = [value for key, value in vars(NotificationStyles).items() if not key.startswith("__")]
-        if 'style' in inputted_kwargs and inputted_kwargs['style'] not in ['',*style_values]:
-            inputted_style=inputted_kwargs['style']
-            allowed_styles=', '.join(style_values)
-            raise ValueError(
-                f"Invalid style '{inputted_style}'. Allowed styles: {allowed_styles}"
-            )
-
+"""Assists Notification Class with Args keeps subclass cleaner"""
+from dataclasses import dataclass, fields
+import difflib
+from .styles import NotificationStyles
+# For Dev when creating new attr use have to set type for validate_args to work
+
+@dataclass
+class BaseNotification:
+    """Encapsulation"""
+
+    # Basic options
+    title: str = ''
+    message: str = ''
+    style: str = 'simple'
+
+    # Style-specific attributes
+    big_picture_path: str = ''
+    large_icon_path: str = ''
+    progress_max_value: int = 0
+    progress_current_value: float = 0.0 # Also Takes in Ints
+    body: str = ''
+    lines_txt: str = ''
+
+    # Notification Functions
+    name: str = ''
+    callback: object = None
+
+    # Advanced Options
+    id: int = 0
+    app_icon: str = 'Defaults to package app icon'
+    sub_text: str=''
+
+    # Channel related
+    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
+
+    # Custom Notification Attrs
+    title_color: str = ''
+    message_color: str = ''
+
+    def __init__(self, **kwargs):
+        """Custom init to handle validation before dataclass assigns values"""
+
+        # Validate provided arguments
+        self.validate_args(kwargs)
+
+        # Assign validated values using the normal dataclass behavior
+        for field_ in fields(self):
+            field_name = field_.name
+            setattr(self, field_name, kwargs.get(field_name, getattr(self, field_name)))
+
+    def validate_args(self, inputted_kwargs):
+        """Check for unexpected arguments and suggest corrections before Python validation"""
+        default_fields =  {field.name : field.type for field in fields(self)} #{'title': <class 'str'>, 'message': <class 'str'>,...
+        allowed_fields_keys = set(default_fields.keys())
+
+        # Identify invalid arguments
+        invalid_args = set(inputted_kwargs) - allowed_fields_keys
+        if invalid_args:
+            suggestions = []
+            for arg in invalid_args:
+                closest_match = difflib.get_close_matches(arg, allowed_fields_keys, n=1, cutoff=0.6)
+                if closest_match:
+                    suggestions.append(f"* '{arg}' is invalid -> Did you mean '{closest_match[0]}'?")
+                else:
+                    suggestions.append(f"* '{arg}' is not a valid argument.")
+
+            suggestion_text = '\n'.join(suggestions)
+            raise ValueError(f"Invalid arguments provided:\n{suggestion_text}")
+
+        # Validating types
+        for each_arg in inputted_kwargs.keys():
+            expected_type = default_fields[each_arg]
+            actual_value = inputted_kwargs[each_arg]
+
+            # Allow both int and float for progress_current_value
+            if each_arg == "progress_current_value":
+                if not isinstance(actual_value, (int, float)):
+                    raise TypeError(f"Expected '{each_arg}' to be int or float, got {type(actual_value)} instead.")
+            else:
+                if not isinstance(actual_value, expected_type):
+                    raise TypeError(f"Expected '{each_arg}' to be {expected_type}, got {type(actual_value)} instead.")
+
+        # Validate `style` values
+        style_values = [value for key, value in vars(NotificationStyles).items() if not key.startswith("__")]
+        if 'style' in inputted_kwargs and inputted_kwargs['style'] not in ['',*style_values]:
+            inputted_style=inputted_kwargs['style']
+            allowed_styles=', '.join(style_values)
+            raise ValueError(
+                f"Invalid style '{inputted_style}'. Allowed styles: {allowed_styles}"
+            )
+

android_notify/config.py

@@ -0,0 +1,145 @@
+import os, traceback
+
+ON_ANDROID = False
+__version__ = "1.60.0"
+
+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)