pluginregistry

type ModelPlugin struct {
	ModelPluginService
	// The ID is used to identify and index the plugin.
	// Since the final value (comprised of ModelInfoResponse.ModelInfo.Name and ModelInfoResponse.ModelInfo.Version)
	// is discovered only after the plugin has been loaded and
	// a temporary one is generated if the plugin fails to load.
	// The ID is then used to lookup the plugin when a gNMI Set request is received,
	// and it is learned via the gNMI Extension 101 and 102
	ID             string
	Endpoint       string
	Info           api.ModelInfo
	Client         api.ModelPluginServiceClient
	ReadOnlyPaths  path.ReadOnlyPathMap
	ReadWritePaths path.ReadWritePathMap
	// Status indicates whether a plugin was correctly loaded
	Status modelPluginStatus
	// Error is an optional field populated only if the plugin failed to be correctly discovered
	Error string
}

type ModelPluginService interface {
	// Capabilities returns the model plugin gNMI capabilities response
	Capabilities(ctx context.Context) *gnmi.CapabilityResponse

	// Validate validates the specified JSON configuration against the plugin's schema
	Validate(ctx context.Context, jsonData []byte) error

	// GetPathValues extracts typed path values from the specified configuration change JSON
	GetPathValues(ctx context.Context, pathPrefix string, jsonData []byte) ([]*configapi.PathValue, error)
}

type PluginRegistry interface {
	// Start the plugin registry
	Start()
	// Stop the plugin registry
	Stop()

	// GetPlugin returns the plugin with the specified ID
	GetPlugin(model configapi.TargetType, version configapi.TargetVersion) (*ModelPlugin, bool)

	// GetPlugins returns list of all registered plugins
	GetPlugins() []*ModelPlugin
}