Merge pull request '0.3.0' (#33) from 0.3.0 into main

Reviewed-on: https://gitea.com/Lerking/XtendR/pulls/33

example.py

@@ -1,5 +1,9 @@
+import time
 from xtendr.xtendrsystem import XtendRSystem
 
+def my_callback():
+    print("'example_plugin is finished pre-loading")
+    
 if __name__ == "__main__":
     """Example usage of the PluginSystem.
     
@@ -15,8 +19,11 @@ if __name__ == "__main__":
     Detached plugin 'example_plugin'.
     """
     system = XtendRSystem()
-    system.attach("example_plugin")  # Assuming 'example_plugin/plugin_info.json' exists
+    system.attach("example_plugin", my_callback)  # Assuming 'example_plugin/plugin_info.json' exists
-    system.run("example_plugin", "Hello!")
+    for i in range(3):
+        print(f"Main program is running iteration {i+1}...")
+        time.sleep(2)
+    system.run("example_plugin", test="Hello!")
     system.stop("example_plugin")
     system.run("example_plugin", 25)
     system.stop("example_plugin")

plugins/example_plugin/example_plugin.py

@@ -1,3 +1,5 @@
+import threading
+import time
 from xtendr.xtendrbase import XtendRBase
 
 class ExamplePlugin(XtendRBase):
@@ -13,12 +15,25 @@ class ExamplePlugin(XtendRBase):
     >>> plugin.stop()
     ExamplePlugin has stopped!
     """
-    def run(self, *args):
+    def run(self, *args, **kwargs):
-        print(f"Passed arguments {len(args)}:")
+        arglen = len(args)
-        for idx, a in enumerate(args):
+        keylen = len(kwargs)
-            print(f"Argument {idx}: {a}")
+        if arglen > 0:
+            print(f"Passed arguments {arglen}:")
+            for idx, a in enumerate(args):
+                print(f"Argument {idx}: {a}")
+        if keylen > 0:
+            print(f"Keyword arguments passed {keylen}")
+            if not "test" in kwargs:
+                raise ValueError("Didn't get expected 'test' keyword!")
+            for kw in kwargs:
+                print(f"Argument {kw}: {kwargs[kw]}")
 
         print("ExamplePlugin is running!")
     
     def stop(self):
         print("ExamplePlugin has stopped!")
+
+    def pre_load(self, callback):
+        time.sleep(5) # Indicate long running pre-load.
+        callback()

setup.py

@@ -3,7 +3,7 @@ if __name__ == "__main__":
     
     setup(
         name="XtendR",
-        version="0.2.0",
+        version="0.3.2",
         packages=find_packages(),
         install_requires=[],
         author="Jan Lerking",

xtendr/xtendrbase.py

@@ -17,9 +17,14 @@ class XtendRBase(ABC):
     Stopping TestPlugin
     """
     @abstractmethod
-    def run(self, *args):
+    def run(self, *args, **kwargs):
         pass
     
     @abstractmethod
     def stop(self):
         pass
+
+    @abstractmethod
+    def pre_load(self, *args):
+        pass
+        

xtendr/xtendrsystem.py

@@ -2,9 +2,10 @@ import importlib
 import sys
 import os
 import json
+import threading
 from xtendr.xtendrbase import XtendRBase
 
-__version__ = "0.1.3"
+__version__ = "0.3.2"
 
 class XtendRSystem:
     """Plugin system to manage plugins.
@@ -28,7 +29,7 @@ class XtendRSystem:
     def version(self) -> str:
         return "XtendR v" + __version__
     
-    def attach(self, name: str) -> None:
+    def attach(self, name: str, callback) -> None:
         """Dynamically load a plugin from its folder."""
         if name in self.plugins:
             print(f"Plugin '{name}' is already attached.")
@@ -67,6 +68,9 @@ class XtendRSystem:
                     'autorun': False
                 }
                 print(f"Attached plugin '{name}'.")
+                print(f"Running pre-load on '{name}'.")
+                thread = threading.Thread(target=self.plugins[name]['instance'].pre_load, args=(callback,))
+                thread.start()
         except (ModuleNotFoundError, json.JSONDecodeError, AttributeError) as e:
             print(f"Failed to attach plugin '{name}': {e}")