Skip to content

Plugin SDK

QLens exposes a small public SDK at qlens.plugins.

from qlens.plugins import PluginContext, hook

class ExamplePlugin:
    id = "example"
    version = "1.0.0"

    def activate(self, context: PluginContext) -> None:
        print(context.root)

    @hook("validator")
    def validate(self, record):
        return []

Plugins are discovered through the qlens.plugins Python entry-point group. They may add validators, importers, exporters, renderers, and analysis commands. Plugins must not mutate canonical objects without using governed transactions.