kalahari-plugin-system

What problem does it solves? Developing robust, extensible plugin systems that seamlessly integrate Python with C++ can be a significant architectural challenge, involving complex bindings, event handling, and lifecycle management. This Skill simplifies the creation and management of Python plugins for C++ applications, enabling rapid feature expansion and customization without deep expertise in inter-language communication.

Core Features & Use Cases

• Extension Point Implementation: Guide the creation of C++ Extension Points and their Python implementations using pybind11, bridging your core application with dynamic features.
• Event-Driven Architecture: Design and utilize the Event Bus for asynchronous, thread-safe communication between core and plugins, ensuring responsive and stable interactions.
• .kplugin Format Management: Structure, validate, and load plugins packaged in the .kplugin (ZIP) format with manifest.json, streamlining distribution and deployment.
• Use Case: Develop a new "Advanced Analytics" plugin in Python that integrates with Kalahari's core C++ data models, leveraging the Event Bus to react to document changes and pybind11 to expose custom analysis functions to the UI, all while maintaining a clean separation of concerns.

Quick Start

Example: Basic Python plugin entry point

from kalahari import IExporter, event_bus

class MyExporter(IExporter): def get_file_extension(self) -> str: return "txt" def get_format_name(self) -> str: return "Plain Text" def export_document(self, document, file_path: str) -> bool: with open(file_path, 'w') as f: f.write(document.get_content()) return True

def plugin_init(kalahari_api): exporter = MyExporter() kalahari_api.register_exporter(exporter) event_bus.subscribe("document.saved", lambda data: print(f"Doc saved: {data}"))