android-widgets 0.1.0__tar.gz → 0.1.2__tar.gz

{android_widgets-0.1.0 → android_widgets-0.1.2}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: android-widgets
-Version: 0.1.0
-Summary: A simple hello world package for Kivy Android widgets.
+Version: 0.1.2
+Summary: This would be used to auto gen XMLs for Android Home Screen widgets.
 Author-email: Fabian <fector101@yahoo.com>
 License: MIT
-Project-URL: Homepage, https://github.com/yourusername/kivy-androidwidgets
-Project-URL: Documentation, https://github.com/yourusername/kivy-androidwidgets
-Project-URL: Source, https://github.com/yourusername/kivy-androidwidgets
-Project-URL: Tracker, https://github.com/yourusername/kivy-androidwidgets/issues
+Project-URL: Homepage, https://github.com/Fector101/kivy-androidwidgets
+Project-URL: Documentation, https://github.com/Fector101/kivy-androidwidgets
+Project-URL: Source, https://github.com/Fector101/kivy-androidwidgets
+Project-URL: Tracker, https://github.com/Fector101/kivy-androidwidgets/issues
 Keywords: kivy,android,widgets,hello-world,python-package
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
@@ -27,7 +27,7 @@ Complete Sample: [working app](https://github.com/Fector101/wallpaper-carousel)
 5 Steps For a simple widget
 ---
 
-step 1: First you Design How you want the Widget to Look [it's Layout].   
+### step 1: First you Design How you want the Widget to Look [it's Layout].   
 Store it in: `res/layout/simple_widget.xml`
 This a simple widget with a text
 ```xml
@@ -50,7 +50,7 @@ This a simple widget with a text
 
 </LinearLayout>
 ```
-step 2: Create an xml containing the info about the widget.  
+### step 2: Create an xml containing the info about the widget.  
 Like: size, preview icon and others   
 path: `res/xml/widgetproviderinfo.xml`
 ```xml
@@ -66,7 +66,7 @@ path: `res/xml/widgetproviderinfo.xml`
 ```
 Create preview image png in right path`res/drawable/ic_launcher_foreground.png`
 
-step 3: Create a `AppWidgetProvider` it's used to receive events for widget.   
+### step 3: Create a `AppWidgetProvider` it's used to receive events for widget.   
 path: `src/SimpleWidget.java`.  
 This will receive an event when widget is add to change it's text
 
@@ -99,7 +99,8 @@ public class SimpleWidget extends AppWidgetProvider {
     }
 }
 ```
-Step 4: Automate injecting Receiver in XML
+
+### Step 4: Automate injecting Receiver in XML
 
 path:`p4a/hook.py`
 
@@ -138,16 +139,19 @@ def after_apk_build(toolchain: ToolchainCL):
     print("Successfully_101: Manifest update completed successfully!")
 
 ```
-Step 5: From `buildozer.spec` tell it you want to add resources, src and p4a hook
+
+### Step 5: From `buildozer.spec` tell it you want to add resources, src and p4a hook
 ```ini
 android.add_resources = res
 android.add_src = src
 p4a.hook = p4a/hook.py
 ```
 
-For More widget customisation check: [How to Customise.md](how-to-customise.md)
----
 
 Sample Image:
 
 ![Rounded corners widget](https://raw.githubusercontent.com/Fector101/kivy-androidwidgets/main/imgs/not-rounded.jpg)
+
+
+### For More widget customisation check: [How to Customise.md](how-to-customise.md)
+

{android_widgets-0.1.0 → android_widgets-0.1.2}/README.md

@@ -6,7 +6,7 @@ Complete Sample: [working app](https://github.com/Fector101/wallpaper-carousel)
 5 Steps For a simple widget
 ---
 
-step 1: First you Design How you want the Widget to Look [it's Layout].   
+### step 1: First you Design How you want the Widget to Look [it's Layout].   
 Store it in: `res/layout/simple_widget.xml`
 This a simple widget with a text
 ```xml
@@ -29,7 +29,7 @@ This a simple widget with a text
 
 </LinearLayout>
 ```
-step 2: Create an xml containing the info about the widget.  
+### step 2: Create an xml containing the info about the widget.  
 Like: size, preview icon and others   
 path: `res/xml/widgetproviderinfo.xml`
 ```xml
@@ -45,7 +45,7 @@ path: `res/xml/widgetproviderinfo.xml`
 ```
 Create preview image png in right path`res/drawable/ic_launcher_foreground.png`
 
-step 3: Create a `AppWidgetProvider` it's used to receive events for widget.   
+### step 3: Create a `AppWidgetProvider` it's used to receive events for widget.   
 path: `src/SimpleWidget.java`.  
 This will receive an event when widget is add to change it's text
 
@@ -78,7 +78,8 @@ public class SimpleWidget extends AppWidgetProvider {
     }
 }
 ```
-Step 4: Automate injecting Receiver in XML
+
+### Step 4: Automate injecting Receiver in XML
 
 path:`p4a/hook.py`
 
@@ -117,16 +118,19 @@ def after_apk_build(toolchain: ToolchainCL):
     print("Successfully_101: Manifest update completed successfully!")
 
 ```
-Step 5: From `buildozer.spec` tell it you want to add resources, src and p4a hook
+
+### Step 5: From `buildozer.spec` tell it you want to add resources, src and p4a hook
 ```ini
 android.add_resources = res
 android.add_src = src
 p4a.hook = p4a/hook.py
 ```
 
-For More widget customisation check: [How to Customise.md](how-to-customise.md)
----
 
 Sample Image:
 
 ![Rounded corners widget](https://raw.githubusercontent.com/Fector101/kivy-androidwidgets/main/imgs/not-rounded.jpg)
+
+
+### For More widget customisation check: [How to Customise.md](how-to-customise.md)
+

android_widgets-0.1.2/android_widgets/__init__.py

@@ -0,0 +1,206 @@
+
+import os
+import traceback
+
+from .config import is_platform_android
+from .aw_logging import logger, enable_logging
+
+
+__all__ = ["logger"]
+
+from .config import get_python_activity_context
+
+try:
+    from .java_classes import *
+except Exception as e:
+    print("[android_widgets] Import Java classes Error:", e)
+    from .facade import *
+
+    RemoteViews_ = RemoteViews
+    AppWidgetManager_ = AppWidgetManager
+
+from .tools import SpecFile
+
+if is_platform_android():
+    enable_logging()
+
+def get_resources():
+    context = get_python_activity_context()
+    return context.getResources()
+
+def get_package_name():
+    context = get_python_activity_context()
+    return context.getPackageName()  # package.domain + "." + package.name
+
+def get_resource(name, folder_base):
+    resources = get_resources()
+    package_name = get_package_name()
+    print("resources.getIdentifier",name, folder_base,"id:",resources.getIdentifier(name, folder_base, package_name))
+    return resources.getIdentifier(name, folder_base, package_name)
+
+def get_buildozer_spec_file_path():
+    return os.path.join(os.getcwd(), "buildozer.spec")
+
+
+class Layout:
+    def __init__(self, layout_name):
+        """
+
+        :param layout_name: base name without '.xml'
+        """
+        self.layout_name = layout_name
+        self.id = get_resource(layout_name, "layout")
+        self.check_if_layout_exists()
+
+    @property
+    def layout_path(self):
+        specFile = SpecFile(get_buildozer_spec_file_path())
+        resources_folder = specFile.get("app", "android.add_resources", '')
+        layout_path = os.path.join(resources_folder, 'layout', self.layout_name + '.xml')
+        return layout_path
+
+    def check_if_layout_exists(self):
+        if is_platform_android():
+            if not self.id:
+                logger.error(f"Layout doesn't exist: {self.layout_name}")
+            return None
+
+        spec_file_path = get_buildozer_spec_file_path()
+        # This not a real path on android /data/data/org.wally.waller/files/app/buildozer.spec
+
+        if not os.path.exists(spec_file_path):
+            logger.debug(f"buildozer.spec file not found at: {spec_file_path}")
+            return None
+
+        if not os.path.exists(self.layout_path):
+            logger.error(f"Layout doesn't exist: {self.layout_path}")
+            return None
+        else:
+            logger.info(f"Found Layout: {self.layout_path}")
+            return None
+
+
+class RemoteViews:
+    def __init__(self, layout:Layout):
+        self.layout = layout
+        layout_id = layout.id
+        package_name = get_package_name()
+        self.main = RemoteViews_(package_name, layout_id)
+
+    def setTextViewText(self, text_id, text):
+        resources = get_resources()
+        package_name = get_package_name()
+        __text_id = resources.getIdentifier(text_id, "id",package_name)
+        # print("text_id:", __text_id)
+        if not __text_id:
+            logger.error(f"Text ID doesn't exist: No @+id/{text_id} in res/layout/{self.layout.layout_name}.xml")
+            return None
+        self.main.setTextViewText(__text_id, String(text))
+        return None
+
+
+class AppWidgetManager:
+    def __init__(self, java_class_name):
+        self.java_class_name = java_class_name
+        context = get_python_activity_context()
+        package_name = get_package_name()
+        component = ComponentName(context, f'{package_name}.{java_class_name}')
+        self.main = AppWidgetManager_.getInstance(context)
+        self.widget_ids = self.main.getAppWidgetIds(component)
+        self.check_if_java_file_exists()
+
+    def updateAppWidget(self, java_view_object):
+        self.main.updateAppWidget(self.widget_ids, java_view_object)
+
+    @property
+    def java_file_path(self):
+        specFile = SpecFile(get_buildozer_spec_file_path())
+        jave_src_folder = specFile.get("app", "android.add_src", '')
+        java_file_path__ = os.path.join(jave_src_folder, self.java_class_name + '.java')
+        return java_file_path__
+
+    def check_if_java_file_exists(self):
+        spec_file_path = get_buildozer_spec_file_path()
+        if is_platform_android():
+            if not self.widget_ids: # when wrong .java file name is given self.widget_ids == []
+                logger.warning(f"Java File might not exist: {self.java_class_name}.java")
+            return None
+
+        if not os.path.exists(spec_file_path):
+            logger.debug(f"buildozer.spec file not found at: {spec_file_path}")
+            return None
+
+        java_file_path = self.java_file_path
+        if not os.path.exists(java_file_path):
+            logger.error(f"Java File doesn't exist: {java_file_path}")
+            # TODO Write emtpy java file
+            return None
+        else:
+            logger.info(f"Found Layout: {java_file_path}")
+            return None
+
+# try:
+#     print("-"*5,'test 1','-'*5)
+#     appWidgetManager = AppWidgetManager("Image")
+#     print("The widget_ids:", appWidgetManager.widget_ids)
+#
+#     text_layout = Layout("image_test_widget")
+#     views = RemoteViews(layout=text_layout)
+#     views.setTextViewText(text_id="widget_text", text="Frm py 1")
+#
+#     appWidgetManager.updateAppWidget(java_view_object=views.main)
+# except Exception as e:
+#     print("-"*5,"test 1  Error:",e,"-"*5)
+#     traceback.print_exc()
+#
+# try:
+#     print("-"*5,'test 2','-'*5)
+#
+#     appWidgetManager = AppWidgetManager("Image1")
+#     print("The widget_ids:", appWidgetManager.widget_ids)
+#
+#     text_layout = Layout("image_test_widget1")
+#     views = RemoteViews(layout=text_layout)
+#     views.setTextViewText(text_id="widget_text", text="Frm py 2")
+#
+#     appWidgetManager.updateAppWidget(java_view_object=views.main)
+# except Exception as e:
+#     print("-" * 5, "test 2  Error:",e, "-" * 5)
+#     traceback.print_exc()
+#
+# try:
+#     print("-" * 5, 'test 3', '-' * 5)
+#
+#     appWidgetManager = AppWidgetManager("Image1")
+#     print("The widget_ids:", appWidgetManager.widget_ids)
+#
+#     text_layout = Layout("image_test_widget")
+#     views = RemoteViews(layout=text_layout)
+#     views.setTextViewText(text_id="widget_text3", text="Frm py 3")
+#
+#     appWidgetManager.updateAppWidget(java_view_object=views.main)
+# except Exception as e:
+#     print("-" * 5, "test 3 Error:",e, "-" * 5)
+#     traceback.print_exc()
+
+# For Reference
+# AppWidgetManager = autoclass('android.appwidget.AppWidgetManager')
+# ComponentName = autoclass('android.content.ComponentName')
+# RemoteViews = autoclass('android.widget.RemoteViews')
+#
+# context = get_python_activity_context()  # PythonActivity.mActivity.getApplicationContext()
+# resources = context.getResources()
+# package_name = context.getPackageName()
+#
+# # IMPORTANT: use CLASS NAME STRING, NOT autoclass
+# component = ComponentName( context, 'org.wally.waller.Image1' )
+#
+# appWidgetManager = AppWidgetManager.getInstance(context)
+# ids = appWidgetManager.getAppWidgetIds(component)
+#
+# text_layout = resources.getIdentifier("image_test_widget", "layout", package_name)
+# title_id = resources.getIdentifier("widget_text", "id", package_name)
+#
+# views = RemoteViews(package_name, text_layout)
+# views.setTextViewText(title_id, AndroidString("Madness"))
+# appWidgetManager.updateAppWidget(ids, views)

android_widgets-0.1.2/android_widgets/aw_logging.py

@@ -0,0 +1,58 @@
+import logging
+
+
+logger = logging.getLogger("android_widgets")
+logger.addHandler(logging.NullHandler())
+# logger.propagate = False #The point of package is to help developing with python on PC, so logs very Useful
+
+
+# ANSI color codes
+COLORS = {
+    "DEBUG": "\033[36m",    # Cyan
+    "INFO": "\033[32m",     # Green
+    "WARNING": "\033[33m",  # Yellow
+    "ERROR": "\033[31m",    # Red
+    "CRITICAL": "\033[41m", # Red background
+}
+RESET = "\033[0m"
+
+
+class BracketColorFormatter(logging.Formatter):
+    def format(self, record):
+        # Fixed-width levelname
+        levelname = f"{record.levelname:<7}"
+        color = COLORS.get(record.levelname, "")
+        level_colored = f"{color}{levelname}{RESET}"
+
+        # Fixed-width logger name
+        name_fixed = f"{record.name:<15}"
+
+        # Build the final string manually to avoid any extra spaces
+        return f"[{level_colored}][{name_fixed}] {record.getMessage()}"
+
+
+def enable_logging(level=logging.DEBUG):
+    """Enable colored logging for android_widgets logger."""
+    # Avoid adding multiple StreamHandlers
+    if any(isinstance(h, logging.StreamHandler) for h in logger.handlers):
+        return
+
+    handler = logging.StreamHandler()
+    handler.setFormatter(BracketColorFormatter())
+    logger.addHandler(handler)
+    logger.setLevel(level)
+
+def disable_logging():
+    """Disable colored logging for android_widgets logger."""
+    # Remove all StreamHandlers (the ones we added in enable_colored_logging)
+    for handler in logger.handlers[:]:
+        if isinstance(handler, logging.StreamHandler):
+            logger.removeHandler(handler)
+    # Ensure logger stays silent
+    logger.addHandler(logging.NullHandler())
+    logger.setLevel(logging.NOTSET)
+
+# ------------------ Test ------------------
+if __name__ == "__main__":
+    enable_logging()
+    logger.info("Found Layout: app_src/android/res/layout/image_test_widget.xml")

android_widgets-0.1.2/android_widgets/config.py

@@ -0,0 +1,74 @@
+import os
+from jnius import autoclass
+
+
+ON_ANDROID = False
+def is_platform_android():
+    # Took this from kivy to fix my logs in P4A.hook, so no need to import things i don't need by doing `from kivy.utils import platform`
+    if os.getenv("MAIN_ACTIVITY_HOST_CLASS_NAME"):
+        return True
+    kivy_build = os.environ.get('KIVY_BUILD', '')
+    if kivy_build in {'android'}:
+        return True
+    elif 'P4A_BOOTSTRAP' in os.environ:
+        return True
+    elif 'ANDROID_ARGUMENT' in os.environ:
+        return True
+
+    return False
+
+
+if is_platform_android():
+    ON_ANDROID = True
+
+def from_service_file():
+    return 'PYTHON_SERVICE_ARGUMENT' in os.environ
+
+
+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
+
+
+
+def get_python_activity():
+    if not ON_ANDROID:
+        from .facade import PythonActivity
+        return PythonActivity
+    ACTIVITY_CLASS_NAME = get_activity_class_name()
+    if on_flet_app():
+        PythonActivity = autoclass(ACTIVITY_CLASS_NAME)
+    else:
+        PythonActivity = autoclass(ACTIVITY_CLASS_NAME + '.PythonActivity')
+    return PythonActivity
+
+
+def get_python_service():
+    if not ON_ANDROID:
+        return None
+    PythonService = autoclass(get_activity_class_name() + '.PythonService')
+    return PythonService.mService
+
+
+def get_python_activity_context():
+    if not ON_ANDROID:
+        from .facade import Context
+        return Context
+
+    PythonActivity = get_python_activity()
+    if from_service_file():
+        service = get_python_service()
+        context = service.getApplication().getApplicationContext()
+    else:
+        context = PythonActivity.mActivity
+    return context
+

android_widgets-0.1.2/android_widgets/facade.py

@@ -0,0 +1,376 @@
+"""For autocomplete Storing Reference to Available Methods"""
+from typing import Literal
+from .aw_logging import logger
+
+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):
+        logger.debug(f"[MOCK] Bundle.putString called with key={key}, value={value}")
+
+    def putInt(self, key, value):
+        logger.debug(f"[MOCK] Bundle.putInt called with key={key}, value={value}")
+
+
+class String(str):
+    def __new__(cls, value):
+        logger.debug(f"[MOCK] String created with value={value}")
+        return str.__new__(cls, value)
+
+
+class Intent:
+    FLAG_ACTIVITY_NEW_TASK = 'FACADE_FLAG_ACTIVITY_NEW_TASK'
+    CATEGORY_DEFAULT = 'FACADE_FLAG_CATEGORY_DEFAULT'
+
+    def __init__(self, context='', activity=''):
+        self.obj = {}
+        logger.debug(f"[MOCK] Intent initialized with context={context}, activity={activity}")
+
+    def setAction(self, action):
+        logger.debug(f"[MOCK] Intent.setAction called with: {action}")
+        return self
+
+    def addFlags(self, *flags):
+        logger.debug(f"[MOCK] Intent.addFlags called with: {flags}")
+        return self
+
+    def setData(self, uri):
+        logger.debug(f"[MOCK] Intent.setData called with: {uri}")
+        return self
+
+    def setFlags(self, intent_flag):
+        logger.debug(f"[MOCK] Intent.setFlags called with: {intent_flag}")
+        return self
+
+    def addCategory(self, intent_category):
+        logger.debug(f"[MOCK] Intent.addCategory called with: {intent_category}")
+        return self
+
+    def getAction(self):
+        logger.debug("[MOCK] Intent.getAction called")
+        return self
+
+    def getStringExtra(self, key):
+        logger.debug(f"[MOCK] Intent.getStringExtra called with key={key}")
+        return self
+
+    def putExtra(self, key, value):
+        self.obj[key] = value
+        logger.debug(f"[MOCK] Intent.putExtra called with key={key}, value={value}")
+
+    def putExtras(self, bundle: Bundle):
+        self.obj['bundle'] = bundle
+        logger.debug(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):
+        logger.debug(
+            f"[MOCK] PendingIntent.getActivity called with "
+            f"context={context}, value={value}, action_intent={action_intent}, type={pending_intent_type}"
+        )
+
+
+class BitmapFactory:
+    def decodeStream(self, stream):
+        logger.debug(f"[MOCK] BitmapFactory.decodeStream called with stream={stream}")
+
+
+class BuildVersion:
+    SDK_INT = 0
+
+
+class Manifest:
+    POST_NOTIFICATIONS = 'FACADE_IMPORT'
+
+
+class Settings:
+    ACTION_APP_NOTIFICATION_SETTINGS = 'FACADE_IMPORT_ACTION_APP_NOTIFICATION_SETTINGS'
+    EXTRA_APP_PACKAGE = 'FACADE_IMPORT_EXTRA_APP_PACKAGE'
+    ACTION_APPLICATION_DETAILS_SETTINGS = 'FACADE_IMPORT_ACTION_APPLICATION_DETAILS_SETTINGS'
+
+
+class Uri:
+    def __init__(self, package_name):
+        logger.debug("[MOCK] Uri initialized")
+
+
+class NotificationManager:
+    pass
+
+
+class NotificationChannel:
+    def __init__(self, channel_id, channel_name, importance):
+        self.description = None
+        self.channel_id = channel_id
+        self.channel = None
+        logger.debug(
+            f"[MOCK] NotificationChannel initialized with "
+            f"id={channel_id}, name={channel_name}, importance={importance}"
+        )
+
+    def createNotificationChannel(self, channel):
+        self.channel = channel
+        logger.debug(f"[MOCK] NotificationChannel.createNotificationChannel called with channel={channel}")
+
+    def getNotificationChannel(self, channel_id):
+        self.channel_id = channel_id
+        logger.debug(f"[MOCK] NotificationChannel.getNotificationChannel called with id={channel_id}")
+
+    def setDescription(self, description):
+        self.description = description
+        logger.debug(f"[MOCK] NotificationChannel.setDescription called with description={description}")
+
+    def getId(self):
+        logger.debug(f"[MOCK] NotificationChannel.getId called, returning {self.channel_id}")
+        return self.channel_id
+
+
+class IconCompat:
+    def createWithBitmap(self, bitmap):
+        logger.debug(f"[MOCK] IconCompat.createWithBitmap called with bitmap={bitmap}")
+
+
+class Color:
+    def __init__(self):
+        logger.debug("[MOCK] Color initialized")
+
+    def parseColor(self, color: str):
+        logger.debug(f"[MOCK] Color.parseColor called with color={color}")
+        return self
+
+
+class RemoteViews:
+    def __init__(self, package_name, small_layout_id):
+        logger.debug(
+            f"[MOCK] RemoteViews initialized with package_name={package_name}, layout_id={small_layout_id}"
+        )
+
+    def createWithBitmap(self, bitmap):
+        logger.debug(f"[MOCK] RemoteViews.createWithBitmap called with bitmap={bitmap}")
+
+    def setTextViewText(self, id, text):
+        logger.debug(f"[MOCK] RemoteViews.setTextViewText called with id={id}, text={text}")
+
+    def setTextColor(self, id, color: Color):
+        logger.debug(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"""
+        logger.debug('[MOCK] MActions.clear called')
+
+
+class NotificationCompatBuilder:
+    def __init__(self, context, channel_id):
+        self.mActions = MActions()
+
+    def setProgress(self, max_value, current_value, endless):
+        logger.debug(f"[MOCK] setProgress called max={max_value}, current={current_value}, endless={endless}")
+
+    def setStyle(self, style):
+        logger.debug(f"[MOCK] setStyle called with style={style}")
+
+    def setContentTitle(self, title):
+        logger.debug(f"[MOCK] setContentTitle called with title={title}")
+
+    def setContentText(self, text):
+        logger.debug(f"[MOCK] setContentText called with text={text}")
+
+    def setSmallIcon(self, icon):
+        logger.debug(f"[MOCK] setSmallIcon called with icon={icon}")
+
+    def setLargeIcon(self, icon):
+        logger.debug(f"[MOCK] setLargeIcon called with icon={icon}")
+
+    def setAutoCancel(self, auto_cancel: bool):
+        logger.debug(f"[MOCK] setAutoCancel called with auto_cancel={auto_cancel}")
+
+    def setPriority(self, priority: Importance):
+        logger.debug(f"[MOCK] setPriority called with priority={priority}")
+
+    def setDefaults(self, defaults):
+        logger.debug(f"[MOCK] setDefaults called with defaults={defaults}")
+
+    def setOngoing(self, persistent: bool):
+        logger.debug(f"[MOCK] setOngoing called with persistent={persistent}")
+
+    def setOnlyAlertOnce(self, state):
+        logger.debug(f"[MOCK] setOnlyAlertOnce called with state={state}")
+
+    def build(self):
+        logger.debug("[MOCK] build called")
+
+    def setContentIntent(self, pending_action_intent: PendingIntent):
+        logger.debug(f"[MOCK] setContentIntent called with {pending_action_intent}")
+
+    def addAction(self, icon_int, action_text, pending_action_intent):
+        logger.debug(
+            f"[MOCK] addAction called with icon={icon_int}, text={action_text}, intent={pending_action_intent}"
+        )
+
+    def setShowWhen(self, state):
+        logger.debug(f"[MOCK] setShowWhen called with state={state}")
+
+    def setWhen(self, time_ms):
+        logger.debug(f"[MOCK] setWhen called with time_ms={time_ms}")
+
+    def setCustomContentView(self, layout):
+        logger.debug(f"[MOCK] setCustomContentView called with layout={layout}")
+
+    def setCustomBigContentView(self, layout):
+        logger.debug(f"[MOCK] setCustomBigContentView called with layout={layout}")
+
+    def setSubText(self, text):
+        logger.debug(f"[MOCK] setSubText called with text={text}")
+
+    def setColor(self, color: Color) -> None:
+        logger.debug(f"[MOCK] setColor called with color={color}")
+
+
+class NotificationCompatBigTextStyle:
+    def bigText(self, body):
+        logger.debug(f"[MOCK] NotificationCompatBigTextStyle.bigText called with body={body}")
+        return self
+
+
+class NotificationCompatBigPictureStyle:
+    def bigPicture(self, bitmap):
+        logger.debug(f"[MOCK] NotificationCompatBigPictureStyle.bigPicture called with bitmap={bitmap}")
+        return self
+
+
+class NotificationCompatInboxStyle:
+    def addLine(self, line):
+        logger.debug(f"[MOCK] NotificationCompatInboxStyle.addLine called with line={line}")
+        return self
+
+
+class NotificationCompatDecoratedCustomViewStyle:
+    def __init__(self):
+        logger.debug("[MOCK] NotificationCompatDecoratedCustomViewStyle initialized")
+
+
+class Permission:
+    POST_NOTIFICATIONS = str
+
+
+def check_permission(permission: Permission.POST_NOTIFICATIONS):
+    logger.debug(f"[MOCK] check_permission called with {permission}")
+
+
+def request_permissions(_list: [], _callback):
+    logger.debug(f"[MOCK] request_permissions called with {_list}")
+    _callback()
+
+
+class AndroidActivity:
+    def bind(self, on_new_intent):
+        logger.debug(f"[MOCK] AndroidActivity.bind called with {on_new_intent}")
+
+    def unbind(self, on_new_intent):
+        logger.debug(f"[MOCK] AndroidActivity.unbind called with {on_new_intent}")
+
+
+class PythonActivity:
+    def __init__(self):
+        logger.debug("[MOCK] PythonActivity initialized")
+
+
+class DummyIcon:
+    icon = 101
+
+    def __init__(self):
+        logger.debug("[MOCK] DummyIcon initialized")
+
+
+class Context:
+    def __init__(self):
+        logger.debug("[MOCK] Context initialized")
+
+    @staticmethod
+    def getApplicationInfo():
+        logger.debug("[MOCK] Context.getApplicationInfo called")
+        return DummyIcon
+
+    @staticmethod
+    def getResources():
+        logger.debug("[MOCK] Context.getResources called")
+        return Resources
+
+    @staticmethod
+    def getPackageName():
+        logger.debug("[MOCK] Context.getPackageName called")
+        return None  # TODO get package name from buildozer.spec file
+
+
+class Resources:
+    @staticmethod
+    def getIdentifier(layout_name, folder_base, package_name):
+        logger.debug(
+            f"[MOCK] Resources.getIdentifier called "
+            f"layout={layout_name}, folder={folder_base}, package={package_name}"
+        )
+        return 0
+
+    def setTextViewText(self, text_id, text):
+        logger.debug(f"[MOCK] Resources.setTextViewText called with text_id={text_id}, text={text}")
+
+
+
+class AppWidgetManager:
+    @classmethod #imporatnt
+    def getInstance(cls, context):
+        logger.debug(f"[MOCK] AppWidgetManager got context instance={context}")
+        return cls
+
+    @classmethod #important 1
+    def updateAppWidget(cls, widget_ids, java_view_object):
+        logger.debug(f"[MOCK] updateAppWidget called with widget_ids={widget_ids}, java_view_object={java_view_object}")
+
+    @classmethod #important 2
+    def getAppWidgetIds(cls,component):
+        logger.debug(f"[MOCK] getAppWidgetIds called with component={component}")
+
+
+
+class ComponentName:
+    def __init__(self, context='', apk_name=''):
+        logger.debug(f"[MOCK] ComponentName initialized with context={context}, apk_name={apk_name}")
+
+    def getInstance(self,context):
+        logger.debug(f"[MOCK] AppWidgetManager got context instance={context}")
+        return self
+
+
+

android_widgets-0.1.2/android_widgets/java_classes.py

@@ -0,0 +1,11 @@
+from .config import is_platform_android
+
+if is_platform_android():
+    from jnius import autoclass
+    String = autoclass("java.lang.String")
+    RemoteViews_ = autoclass('android.widget.RemoteViews')
+    AppWidgetManager_ = autoclass('android.appwidget.AppWidgetManager')
+    ComponentName = autoclass('android.content.ComponentName')
+
+else:
+    raise ImportError("Not on Android, Unable to import Java classes")

android_widgets-0.1.2/android_widgets/maker.py

@@ -0,0 +1,129 @@
+print("----------------------Running android_widget.maker-----------------")
+
+from dataclasses import dataclass
+from typing import List, Optional
+
+
+@dataclass
+class Receiver:
+    name: str
+    actions: List[str]
+    enabled: bool = True
+    exported: bool = False
+    label: Optional[str] = None
+    meta_name: Optional[str] = "android.appwidget.provider"
+    meta_resource: Optional[str] = None
+
+    def to_xml(self, package: str) -> str:
+        attrs = [
+            f'android:name="{package}.{self.name}"',
+            f'android:enabled="{str(self.enabled).lower()}"',
+            f'android:exported="{str(self.exported).lower()}"',
+        ]
+
+        if self.label:
+            attrs.append(f'android:label="{self.label}"')
+
+        xml = [f"<receiver {' '.join(attrs)}>"]
+        xml.append("    <intent-filter>")
+
+        for action in self.actions:
+            xml.append(f'        <action android:name="{action}" />')
+
+        xml.append("    </intent-filter>")
+
+        if self.meta_resource:
+            xml.append(
+                f'    <meta-data android:name="{self.meta_name}"\n'
+                f'           android:resource="{self.meta_resource}" />'
+            )
+
+        xml.append("</receiver>")
+        return "\n".join(xml)
+
+
+def generate_receivers(package: str) -> str:
+    receivers = [
+        Receiver(
+            name="Action1",
+            actions=["android.intent.action.BOOT_COMPLETED"],
+        ),
+        Receiver(
+            name="SimpleWidget",
+            label="Simple Text",
+            actions=["android.appwidget.action.APPWIDGET_UPDATE"],
+            meta_resource="@xml/widgetproviderinfo",
+        ),
+        Receiver(
+            name="ButtonWidget",
+            label="Counter Button Demo",
+            actions=["android.appwidget.action.APPWIDGET_UPDATE"],
+            meta_resource="@xml/button_widget_provider",
+        ),
+        Receiver(
+            name="Image1",
+            actions=[
+                "android.intent.action.BOOT_COMPLETED",
+                "android.appwidget.action.APPWIDGET_UPDATE",
+            ],
+            meta_resource="@xml/image_test_widget_info",
+        ),
+    ]
+
+    return "\n\n".join(r.to_xml(package) for r in receivers)
+
+
+
+print("------------------ Hello from android_widget.service_injector ------------------")
+
+
+def inject_foreground_service_types(
+    manifest_text: str,
+    package: str,
+    services: dict[str, str],
+) -> str:
+    """
+    Inject android:foregroundServiceType into <service /> tags.
+    :param manifest_text: AndroidManifest.xml file Text Content
+    :param package: package.domain + "." + package.name
+    :param services:
+        {
+            "service_name": "service_type",
+            "music": "mediaPlayback",
+            "location": "location"
+        }
+    """
+
+    for name, fgs_type in services.items():
+        service_name = f"{package}.Service{name.capitalize()}"
+        target = f'android:name="{service_name}"'
+
+        pos = manifest_text.find(target)
+        if pos == -1:
+            print(f"Error_101: {service_name} not found in manifest")
+            continue
+
+        # Find the end of the <service ... /> tag
+        end = manifest_text.find("/>", pos)
+        if end == -1:
+            print(f"Error_101: {service_name} found but no '/>' closing tag")
+            continue
+
+        segment = manifest_text[pos:end]
+
+        if "android:foregroundServiceType=" in segment:
+            print(f"Error_101: {service_name} already has foregroundServiceType")
+            continue
+
+        manifest_text = (
+                manifest_text[:end]
+                + f' android:foregroundServiceType="{fgs_type}"'
+                + manifest_text[end:]
+        )
+
+        print(
+            f"Successfully_101: Added foregroundServiceType='{fgs_type}' "
+            f"to {service_name}"
+        )
+
+    return manifest_text

android_widgets-0.1.2/android_widgets/tools.py

@@ -0,0 +1,43 @@
+from pathlib import Path
+
+
+class SpecFile:
+    def __init__(self, path: str):
+        self.path = Path(path)
+        self.data = {}
+        self._parse()
+
+    def _parse(self):
+        current_section = None
+
+        for raw_line in self.path.read_text().splitlines():
+            line = raw_line.strip()
+
+            # skip empty lines and full-line comments
+            if not line or line.startswith("#"):
+                continue
+
+            # section header
+            if line.startswith("[") and line.endswith("]"):
+                current_section = line[1:-1].strip()
+                self.data.setdefault(current_section, {})
+                continue
+
+            # key = value lines
+            if "=" in line and current_section:
+                key, value = line.split("=", 1)
+
+                key = key.strip()
+                value = value.strip()
+
+                # ignore commented keys like "# key = value"
+                if key.startswith("#"):
+                    continue
+
+                self.data[current_section][key] = value
+
+    def get(self, section: str, key: str, default=None):
+        return self.data.get(section, {}).get(key, default)
+
+    def section(self, section: str) -> dict:
+        return self.data.get(section, {}).copy()

{android_widgets-0.1.0 → android_widgets-0.1.2}/android_widgets.egg-info/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: android-widgets
-Version: 0.1.0
-Summary: A simple hello world package for Kivy Android widgets.
+Version: 0.1.2
+Summary: This would be used to auto gen XMLs for Android Home Screen widgets.
 Author-email: Fabian <fector101@yahoo.com>
 License: MIT
-Project-URL: Homepage, https://github.com/yourusername/kivy-androidwidgets
-Project-URL: Documentation, https://github.com/yourusername/kivy-androidwidgets
-Project-URL: Source, https://github.com/yourusername/kivy-androidwidgets
-Project-URL: Tracker, https://github.com/yourusername/kivy-androidwidgets/issues
+Project-URL: Homepage, https://github.com/Fector101/kivy-androidwidgets
+Project-URL: Documentation, https://github.com/Fector101/kivy-androidwidgets
+Project-URL: Source, https://github.com/Fector101/kivy-androidwidgets
+Project-URL: Tracker, https://github.com/Fector101/kivy-androidwidgets/issues
 Keywords: kivy,android,widgets,hello-world,python-package
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
@@ -27,7 +27,7 @@ Complete Sample: [working app](https://github.com/Fector101/wallpaper-carousel)
 5 Steps For a simple widget
 ---
 
-step 1: First you Design How you want the Widget to Look [it's Layout].   
+### step 1: First you Design How you want the Widget to Look [it's Layout].   
 Store it in: `res/layout/simple_widget.xml`
 This a simple widget with a text
 ```xml
@@ -50,7 +50,7 @@ This a simple widget with a text
 
 </LinearLayout>
 ```
-step 2: Create an xml containing the info about the widget.  
+### step 2: Create an xml containing the info about the widget.  
 Like: size, preview icon and others   
 path: `res/xml/widgetproviderinfo.xml`
 ```xml
@@ -66,7 +66,7 @@ path: `res/xml/widgetproviderinfo.xml`
 ```
 Create preview image png in right path`res/drawable/ic_launcher_foreground.png`
 
-step 3: Create a `AppWidgetProvider` it's used to receive events for widget.   
+### step 3: Create a `AppWidgetProvider` it's used to receive events for widget.   
 path: `src/SimpleWidget.java`.  
 This will receive an event when widget is add to change it's text
 
@@ -99,7 +99,8 @@ public class SimpleWidget extends AppWidgetProvider {
     }
 }
 ```
-Step 4: Automate injecting Receiver in XML
+
+### Step 4: Automate injecting Receiver in XML
 
 path:`p4a/hook.py`
 
@@ -138,16 +139,19 @@ def after_apk_build(toolchain: ToolchainCL):
     print("Successfully_101: Manifest update completed successfully!")
 
 ```
-Step 5: From `buildozer.spec` tell it you want to add resources, src and p4a hook
+
+### Step 5: From `buildozer.spec` tell it you want to add resources, src and p4a hook
 ```ini
 android.add_resources = res
 android.add_src = src
 p4a.hook = p4a/hook.py
 ```
 
-For More widget customisation check: [How to Customise.md](how-to-customise.md)
----
 
 Sample Image:
 
 ![Rounded corners widget](https://raw.githubusercontent.com/Fector101/kivy-androidwidgets/main/imgs/not-rounded.jpg)
+
+
+### For More widget customisation check: [How to Customise.md](how-to-customise.md)
+

android_widgets-0.1.2/android_widgets.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+README.md
+pyproject.toml
+android_widgets/__init__.py
+android_widgets/aw_logging.py
+android_widgets/config.py
+android_widgets/facade.py
+android_widgets/java_classes.py
+android_widgets/maker.py
+android_widgets/tools.py
+android_widgets.egg-info/PKG-INFO
+android_widgets.egg-info/SOURCES.txt
+android_widgets.egg-info/dependency_links.txt
+android_widgets.egg-info/requires.txt
+android_widgets.egg-info/top_level.txt

android_widgets-0.1.2/android_widgets.egg-info/top_level.txt

@@ -0,0 +1,3 @@
+android_widgets
+dist
+imgs

{android_widgets-0.1.0 → android_widgets-0.1.2}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "android-widgets"
-version = "0.1.0"
-description = "A simple hello world package for Kivy Android widgets."
+version = "0.1.2"
+description = "This would be used to auto gen XMLs for Android Home Screen widgets."
 readme = { file = "README.md", content-type = "text/markdown" }
 authors = [
     { name = "Fabian", email = "fector101@yahoo.com" }
@@ -32,10 +32,10 @@ classifiers = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/yourusername/kivy-androidwidgets"
-Documentation = "https://github.com/yourusername/kivy-androidwidgets"
-Source = "https://github.com/yourusername/kivy-androidwidgets"
-Tracker = "https://github.com/yourusername/kivy-androidwidgets/issues"
+Homepage = "https://github.com/Fector101/kivy-androidwidgets"
+Documentation = "https://github.com/Fector101/kivy-androidwidgets"
+Source = "https://github.com/Fector101/kivy-androidwidgets"
+Tracker = "https://github.com/Fector101/kivy-androidwidgets/issues"
 
 [tool.setuptools.packages.find]
 where = ["."]

android_widgets-0.1.0/android-widgets/__init__.py

@@ -1,5 +0,0 @@
-def hello():
-    """
-    Simple hello function for testing the package.
-    """
-    return "Hello from android-widgets!"

android_widgets-0.1.0/android_widgets.egg-info/SOURCES.txt

@@ -1,8 +0,0 @@
-README.md
-pyproject.toml
-android-widgets/__init__.py
-android_widgets.egg-info/PKG-INFO
-android_widgets.egg-info/SOURCES.txt
-android_widgets.egg-info/dependency_links.txt
-android_widgets.egg-info/requires.txt
-android_widgets.egg-info/top_level.txt

android_widgets-0.1.0/android_widgets.egg-info/top_level.txt

@@ -1,3 +0,0 @@
-android-widgets
-dist
-imgs