android-notify 1.60.4__tar.gz → 1.60.4.dev0__tar.gz

{android_notify-1.60.4 → android_notify-1.60.4.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: android-notify
-Version: 1.60.4
+Version: 1.60.4.dev0
 Summary: A Python package that simplifies creating Android notifications in Kivy and Flet apps.
 Author-email: Fabian <fector101@yahoo.com>
 License-Expression: MIT
@@ -79,81 +79,32 @@ 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
+requirements = python3, kivy, pyjnius, android-notify==1.60.4.dev0
 # 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
 ```
 
 ### Flet apps:  
- In your `pyproject.toml` file, ensure you include the following:
+
+In your `pyproject.toml` file, ensure you include the following:
+
 ```toml
 [tool.flet.android]
 dependencies = [
-  "pyjnius","https://github.com/Fector101/android_notify/archive/without-androidx.zip"
+  "pyjnius","android-notify==1.60.4.dev0"
 ]
 
 [tool.flet.android.permission]
 "android.permission.POST_NOTIFICATIONS" = true
 ```
-- example of [complete flet pyproject.toml](https://github.com/Fector101/flet-app/blob/main/pyproject.toml)
-------
-## Installing without Androidx
-How to use without `gradle_dependencies`
-Use `https://github.com/Fector101/android_notify/archive/without-androidx.zip` to install via `pip`
-### In Kivy
-```ini
-# buildozer.spec
-requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/without-androidx.zip
-```
 
-### On Pydroid 3 
-On the [pydroid 3](https://play.google.com/store/apps/details?id=ru.iiec.pydroid3) mobile app for running python code you can test some features.
-- In pip section where you're asked to insert `Libary name` paste `https://github.com/Fector101/android_notify/archive/without-androidx.zip`
-- Minimal working example 
-```py
-# Testing with `https://github.com/Fector101/android_notify/archive/without-androidx.zip` on pydroid
-from kivy.app import App
-from kivy.uix.boxlayout import BoxLayout
-from kivy.uix.button import Button
-from android_notify import Notification
-from android_notify.core import asks_permission_if_needed
-
-
-class AndroidNotifyDemoApp(App):
-    def build(self):
-        layout = BoxLayout(orientation='vertical', spacing=10, padding=20)
-        layout.add_widget(Button(
-            text="Ask Notification Permission",
-            on_release=self.request_permission
-        ))
-        layout.add_widget(Button(
-            text="Send Notification",
-            on_release=self.send_notification
-        ))
-        return layout
-
-    def request_permission(self, *args):
-        asks_permission_if_needed(no_androidx=True)
-
-    def send_notification(self, *args):
-        Notification(
-            title="Hello from Android Notify",
-            message="This is a basic notification.",
-            channel_id="android_notify_demo",
-            channel_name="Android Notify Demo"
-        ).send()
-
-
-if __name__ == "__main__":
-    AndroidNotifyDemoApp().run()
-```
+### Pydroid 3
+In the [pydroid 3](https://play.google.com/store/apps/details?id=ru.iiec.pydroid3) mobile app for running python code you can test some features.
+- In pip section where you're asked to insert `Libary name` paste `android-notify==1.60.4.dev0`
+
 
-For IDE IntelliSense Can be installed via `pip install`:
+### Testing
+Can be installed via `pip` For testing purposes:
 
 ```bash
 pip install android_notify
@@ -162,7 +113,7 @@ android-notify -v
 
 ## Documentation
 For Dev Version use
-```requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/main.zip```
+```requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/without-androidx.zip```
 
 
 To use colored text in your notifications:
@@ -170,34 +121,13 @@ To use colored text in your notifications:
 Lastly in your `buildozer.spec` file
 - Add `source.include_exts = xml` and `android.add_resources = ./res`
 
-To use Custom Sounds
-- Put audio files in `res/raw` folder,
-- Then from `buildozer.spec` point to res folder `android.add_resources = res`
-- and includes it's format `source.include_exts = wav`.
-
-Lastly From the code 
-```py
-# Create a custom notification channel with a unique sound resource for android 8+
-Notification.createChannel(
-    id="weird_sound_tester",
-    name="Weird Sound Tester",
-    description="A test channel used to verify custom notification sounds from the res/raw folder.",
-    res_sound_name="sneeze" # file name without .wav or .mp3
-)
-
-# Send a notification through the created channel
-n=Notification(
-    title="Custom Sound Notification",
-    message="This tests playback of a custom sound (sneeze.wav) stored in res/raw.",
-    channel_id="weird_sound_tester" # important tells notification to use right channel
-)
-n.setSound("sneeze")# for android 7 below 
-n.send()
-```
 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, any support would help me continue working on open-source projects. I’m currently saving for a laptop to keep developing and improving my skills.
-[donate](https://www.buymeacoffee.com/fector101)
+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.60.4.dev0/README.md

@@ -0,0 +1,110 @@
+<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 and Flet 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](https://android-notify.vercel.app/components#progress-bars) (determinate and indeterminate)
+  - Large icon notifications
+  - Big picture notifications
+  - Combined image styles
+  - Custom notification Icon - [images section](https://android-notify.vercel.app/components#images)
+  - Big text notifications
+  - Inbox-style notifications
+  - Colored texts and Icons
+
+- **Rich Functionality**:
+  - Add action buttons with custom callbacks
+  - [Update notification](https://android-notify.vercel.app/advanced-methods#updating-notification) content dynamically
+  - Manage progress bars with fine-grained control
+  - [Custom notification channels](https://android-notify.vercel.app/advanced-methods#channel-management) 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
+
+### Kivy apps:  
+
+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==1.60.4.dev0
+# Add permission for notifications
+android.permissions = POST_NOTIFICATIONS
+```
+
+### Flet apps:  
+
+In your `pyproject.toml` file, ensure you include the following:
+
+```toml
+[tool.flet.android]
+dependencies = [
+  "pyjnius","android-notify==1.60.4.dev0"
+]
+
+[tool.flet.android.permission]
+"android.permission.POST_NOTIFICATIONS" = true
+```
+
+### Pydroid 3
+In the [pydroid 3](https://play.google.com/store/apps/details?id=ru.iiec.pydroid3) mobile app for running python code you can test some features.
+- In pip section where you're asked to insert `Libary name` paste `android-notify==1.60.4.dev0`
+
+
+### Testing
+Can be installed via `pip` For testing purposes:
+
+```bash
+pip install android_notify
+android-notify -v
+```
+
+## Documentation
+For Dev Version use
+```requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/without-androidx.zip```
+
+
+To use colored text in your notifications:
+- Copy the [res](https://github.com/Fector101/android_notify/tree/main/android_notify/res) folder to your app path.  
+Lastly in your `buildozer.spec` file
+- Add `source.include_exts = xml` and `android.add_resources = ./res`
+
+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.60.4.dev0/android_notify/an_types.py

@@ -0,0 +1,251 @@
+"""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(f"[MOCK] Bundle.putString called with key={key}, value={value}")  
+  
+    def putInt(self,key,value):  
+        print(f"[MOCK] Bundle.putInt called with key={key}, value={value}")  
+  
+class String(str):  
+    def __new__(cls, value):
+        print(f"[MOCK] String created with value={value}")
+        return str.__new__(cls, value)
+  
+class Intent:  
+    def __init__(self,context,activity):  
+        self.obj={}
+        print(f"[MOCK] Intent initialized with context={context}, activity={activity}")  
+  
+    def setAction(self,action):  
+        print(f"[MOCK] Intent.setAction called with: {action}")  
+        return self  
+  
+    def setFlags(self,intent_flag):  
+        print(f"[MOCK] Intent.setFlags called with: {intent_flag}")  
+        return self  
+  
+    def getAction(self):  
+        print("[MOCK] Intent.getAction called")
+        return self  
+  
+    def getStringExtra(self,key):  
+        print(f"[MOCK] Intent.getStringExtra called with key={key}")
+        return self  
+  
+    def putExtra(self,key,value):  
+        self.obj[key] = value
+        print(f"[MOCK] Intent.putExtra called with key={key}, value={value}")  
+  
+    def putExtras(self,bundle:Bundle):  
+        self.obj['bundle'] = bundle
+        print(f"[MOCK] Intent.putExtras called with bundle={bundle}")  
+  
+class PendingIntent:  
+    FLAG_IMMUTABLE=''  
+    FLAG_UPDATE_CURRENT=''  
+  
+    def getActivity(self,context,value,action_intent,pending_intent_type):  
+        print(f"[MOCK] PendingIntent.getActivity called with context={context}, value={value}, action_intent={action_intent}, type={pending_intent_type}")  
+  
+class BitmapFactory:  
+    def decodeStream(self,stream):  
+        print(f"[MOCK] BitmapFactory.decodeStream called with stream={stream}")  
+  
+class BuildVersion:  
+    SDK_INT=0  
+  
+class NotificationManager:  
+    pass  
+  
+class NotificationChannel:  
+    def __init__(self,channel_id,channel_name,importance):  
+        self.description = None  
+        self.channel_id = channel_id
+        self.channel = None
+        print(f"[MOCK] NotificationChannel initialized with id={channel_id}, name={channel_name}, importance={importance}")  
+  
+    def createNotificationChannel(self, channel):  
+        self.channel=channel
+        print(f"[MOCK] NotificationChannel.createNotificationChannel called with channel={channel}")  
+  
+    def getNotificationChannel(self, channel_id):  
+        self.channel_id=channel_id
+        print(f"[MOCK] NotificationChannel.getNotificationChannel called with id={channel_id}")  
+  
+    def setDescription(self, description):  
+        self.description=description
+        print(f"[MOCK] NotificationChannel.setDescription called with description={description}")  
+  
+    def getId(self):  
+        print(f"[MOCK] NotificationChannel.getId called, returning {self.channel_id}")
+        return  self.channel_id  
+  
+class IconCompat:  
+    def createWithBitmap(self,bitmap):  
+        print(f"[MOCK] IconCompat.createWithBitmap called with bitmap={bitmap}")  
+  
+class Color:  
+    def __init__(self):  
+        print("[MOCK] Color initialized")  
+    def parseColor(self,color:str):  
+        print(f"[MOCK] Color.parseColor called with color={color}")
+        return self  
+  
+class RemoteViews:  
+    def __init__(self, package_name, small_layout_id):  
+        print(f"[MOCK] RemoteViews initialized with package_name={package_name}, layout_id={small_layout_id}")  
+    def createWithBitmap(self,bitmap):  
+        print(f"[MOCK] RemoteViews.createWithBitmap called with bitmap={bitmap}")  
+    def setTextViewText(self,id, text):  
+        print(f"[MOCK] RemoteViews.setTextViewText called with id={id}, text={text}")  
+    def setTextColor(self,id, color:Color):  
+        print(f"[MOCK] RemoteViews.setTextColor called with id={id}, color={color}")  
+  
+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('[MOCK] MActions.clear called')  
+  
+class NotificationCompatBuilder:  
+    def __init__(self,context,channel_id):  
+        self.mActions = MActions()  
+        print(f"[MOCK] NotificationCompatBuilder initialized with context={context}, channel_id={channel_id}")  
+    def setProgress(self,max_value,current_value,endless):  
+        print(f"[MOCK] setProgress called with max={max_value}, current={current_value}, endless={endless}")  
+    def setStyle(self,style):  
+        print(f"[MOCK] setStyle called with style={style}")  
+    def setContentTitle(self,title):  
+        print(f"[MOCK] setContentTitle called with title={title}")  
+    def setContentText(self,text):  
+        print(f"[MOCK] setContentText called with text={text}")  
+    def setSmallIcon(self,icon):  
+        print(f"[MOCK] setSmallIcon called with icon={icon}")  
+    def setLargeIcon(self,icon):  
+        print(f"[MOCK] setLargeIcon called with icon={icon}")  
+    def setAutoCancel(self,auto_cancel:bool):  
+        print(f"[MOCK] setAutoCancel called with auto_cancel={auto_cancel}")  
+    def setPriority(self,priority):  
+        print(f"[MOCK] setPriority called with priority={priority}")  
+    def setDefaults(self,defaults):  
+        print(f"[MOCK] setDefaults called with defaults={defaults}")  
+    def setOngoing(self,persistent:bool):  
+        print(f"[MOCK] setOngoing called with persistent={persistent}")  
+    def setOnlyAlertOnce(self,state):  
+        print(f"[MOCK] setOnlyAlertOnce called with state={state}")  
+    def build(self):  
+        print("[MOCK] build called")  
+    def setContentIntent(self,pending_action_intent:PendingIntent):  
+        print(f"[MOCK] setContentIntent called with {pending_action_intent}")  
+    def addAction(self,icon_int,action_text,pending_action_intent):  
+        print(f"[MOCK] addAction called with icon={icon_int}, text={action_text}, intent={pending_action_intent}")  
+    def setShowWhen(self,state):  
+        print(f"[MOCK] setShowWhen called with state={state}")  
+    def setWhen(self,time_ms):  
+        print(f"[MOCK] setWhen called with time_ms={time_ms}")  
+    def setCustomContentView(self,layout):  
+        print(f"[MOCK] setCustomContentView called with layout={layout}")  
+    def setCustomBigContentView(self,layout):  
+        print(f"[MOCK] setCustomBigContentView called with layout={layout}")  
+    def setSubText(self,text):  
+        print(f"[MOCK] setSubText called with text={text}")  
+    def setColor(self, color:Color) -> None:  
+        print(f"[MOCK] setColor called with color={color}")  
+
+class NotificationCompatBigTextStyle:
+    def bigText(self,body):
+        print(f"[MOCK] NotificationCompatBigTextStyle.bigText called with body={body}")
+        return self
+
+class NotificationCompatBigPictureStyle:
+    def bigPicture(self,bitmap):
+        print(f"[MOCK] NotificationCompatBigPictureStyle.bigPicture called with bitmap={bitmap}")
+        return self
+
+class NotificationCompatInboxStyle:
+    def addLine(self,line):
+        print(f"[MOCK] NotificationCompatInboxStyle.addLine called with line={line}")
+        return self
+
+class NotificationCompatDecoratedCustomViewStyle:
+    def __init__(self):
+        print("[MOCK] NotificationCompatDecoratedCustomViewStyle initialized")
+
+class Permission:
+    POST_NOTIFICATIONS=''
+
+def check_permission(permission:Permission.POST_NOTIFICATIONS):
+    print(f"[MOCK] check_permission called with {permission}")
+    print(permission)
+
+def request_permissions(_list: [], _callback):
+    print(f"[MOCK] request_permissions called with {_list}")
+    _callback()
+
+class AndroidActivity:
+    def bind(self,on_new_intent):
+        print(f"[MOCK] AndroidActivity.bind called with {on_new_intent}")
+    def unbind(self,on_new_intent):
+        print(f"[MOCK] AndroidActivity.unbind called with {on_new_intent}")
+
+class PythonActivity:
+    def __init__(self):
+        print("[MOCK] PythonActivity initialized") 
+    
+
+class DummyIcon:
+    icon = 101
+    def __init__(self):
+        print("[MOCK] DummyIcon initialized")
+        
+class Context:
+    def __init__(self):
+        print("[MOCK] Context initialized")
+        pass
+
+    @staticmethod
+    def getApplicationInfo():
+        print("[MOCK] Context.getApplicationInfo called")
+        return DummyIcon
+
+    @staticmethod
+    def getResources():
+        print("[MOCK] Context.getResources called")
+        return None
+
+    @staticmethod
+    def getPackageName():
+        print("[MOCK] Context.getPackageName called")
+        return None # TODO get package name from buildozer.spec file
+
+#Now writing Knowledge from errors
+# notify.(int, Builder.build()) # must be int

{android_notify-1.60.4 → android_notify-1.60.4.dev0}/android_notify/an_utils.py

@@ -6,7 +6,7 @@ from .an_types import Importance
 from .config import (
                      get_python_activity_context, app_storage_path,ON_ANDROID,
                      BitmapFactory, BuildVersion, Bundle,
-                     NotificationManagerCompat,NotificationCompat
+                     NotificationManagerClass,AndroidNotification
                     )
 
 if ON_ANDROID:
@@ -37,15 +37,15 @@ def get_android_importance(importance: Importance):
         return None
     value = ''
     if importance == 'urgent':
-        value = NotificationCompat.PRIORITY_HIGH if BuildVersion.SDK_INT <= 25 else NotificationManagerCompat.IMPORTANCE_HIGH
+        value = AndroidNotification.PRIORITY_HIGH if BuildVersion.SDK_INT <= 25 else NotificationManagerClass.IMPORTANCE_HIGH
     elif importance == 'high':
-        value = NotificationCompat.PRIORITY_DEFAULT if BuildVersion.SDK_INT <= 25 else NotificationManagerCompat.IMPORTANCE_DEFAULT
+        value = AndroidNotification.PRIORITY_DEFAULT if BuildVersion.SDK_INT <= 25 else NotificationManagerClass.IMPORTANCE_DEFAULT
     elif importance == 'medium':
-        value = NotificationCompat.PRIORITY_LOW if BuildVersion.SDK_INT <= 25 else NotificationManagerCompat.IMPORTANCE_LOW
+        value = AndroidNotification.PRIORITY_LOW if BuildVersion.SDK_INT <= 25 else NotificationManagerClass.IMPORTANCE_LOW
     elif importance == 'low':
-        value = NotificationCompat.PRIORITY_MIN if BuildVersion.SDK_INT <= 25 else NotificationManagerCompat.IMPORTANCE_MIN
+        value = AndroidNotification.PRIORITY_MIN if BuildVersion.SDK_INT <= 25 else NotificationManagerClass.IMPORTANCE_MIN
     elif importance == 'none':
-        value = '' if BuildVersion.SDK_INT <= 25 else NotificationManagerCompat.IMPORTANCE_NONE
+        value = '' if BuildVersion.SDK_INT <= 25 else NotificationManagerClass.IMPORTANCE_NONE
 
     return value
     # side-note 'medium' = NotificationCompat.PRIORITY_LOW and 'low' = NotificationCompat.PRIORITY_MIN # weird but from docs
@@ -69,10 +69,11 @@ def generate_channel_id(channel_name: str) -> str:
     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)")
+    app_folder = os.path.join(app_storage_path(), 'app')  
+    img_full_path = os.path.join(app_folder, relative_path)
+    img_name = os.path.basename(img_full_path)
+    if not os.path.exists(img_full_path):
+        print(f"\nImage - {img_name} 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)) + ']')
@@ -80,10 +81,8 @@ def get_img_from_path(relative_path):
             print('Exception: ', could_not_get_files_in_path_error)
             print("Couldn't get Files in App Folder")
         return None
+    return get_bitmap_from_path(img_full_path)
     # 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
@@ -128,7 +127,6 @@ def add_data_to_intent(intent, title):
     bundle.putInt("notify_id", 101)
     intent.putExtras(bundle)
 
-
 def get_sound_uri(res_sound_name):
   if not res_sound_name:
     return None
@@ -136,3 +134,25 @@ def get_sound_uri(res_sound_name):
   package_name = context.getPackageName()
   Uri = autoclass('android.net.Uri')
   return Uri.parse(f"android.resource://{package_name}/raw/{res_sound_name}")
+
+def get_package_path():
+    """
+    Returns the directory path of this Python package.
+    Works on Android, Windows, Linux, macOS.
+    """
+    return os.path.dirname(os.path.abspath(__file__))
+
+def get_bitmap_from_path(img_full_path):
+  Uri = autoclass('android.net.Uri')
+  uri = Uri.parse(f"file://{img_full_path}")
+  return BitmapFactory.decodeStream(context.getContentResolver().openInputStream(uri))
+
+def icon_finder(icon_name):
+    """Get the full path to an icon file."""
+    try:
+        import pkg_resources
+        return pkg_resources.resource_filename(__name__, f"fallback-icons/{icon_name}")
+    except Exception:
+        # Fallback if pkg_resources not available
+        package_dir = get_package_path()
+        return os.path.join(package_dir, "fallback-icons", icon_name)