Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

plugin

package

Go to main page

Versions in this module

v1

v1.4.0

Oct 11, 2025

v1.3.1

Sep 30, 2025

v1.3.0

Sep 23, 2025

v1.2.1

Sep 16, 2025

v1.2.0

Sep 16, 2025

v1.0.3

Aug 19, 2025

v1.0.2

Aug 19, 2025

v1.0.1

Aug 19, 2025

v1.0.0

Aug 19, 2025

Changes in this version

+ const AuthHook

+ const PostDownloadHook

+ const PostStoreHook

+ const PreDownloadHook

+ const PreStoreHook

+ const TransformHook

+ type AuthPlugin interface

+ Authenticate func(ctx context.Context, req *http.Request) error

+ type ConfigMigration struct

+ Description string

+ FromVersion int

+ Migrate func(config map[string]interface{}) (map[string]interface{}, error)

+ ToVersion int

+ func DefaultMigrations() []ConfigMigration

+ type ConfigMigrator struct

+ func NewConfigMigrator(currentVersion int, backupDir string) *ConfigMigrator

+ func (cm *ConfigMigrator) LoadConfig(path string) (map[string]interface{}, error)

+ func (cm *ConfigMigrator) MigrateConfig(config map[string]interface{}) (map[string]interface{}, error)

+ func (cm *ConfigMigrator) RegisterMigration(migration ConfigMigration)

+ func (cm *ConfigMigrator) SaveConfig(config map[string]interface{}, path string) error

+ func (cm *ConfigMigrator) ValidateConfig(config map[string]interface{}) error

+ type ConfigVersion struct

+ Schema string

+ Version int

+ type DependencyGraph struct

+ func NewDependencyGraph() *DependencyGraph

+ func (dg *DependencyGraph) AddNode(name string, version *Version, plugin Plugin, dependencies []string)

+ func (dg *DependencyGraph) GetLoadOrder() []string

+ func (dg *DependencyGraph) Resolve() ([]string, error)

+ func (dg *DependencyGraph) ValidateDependencies() error

+ type DependencyManager struct

+ func NewDependencyManager() *DependencyManager

+ func (dm *DependencyManager) CanUnload(pluginName string) (bool, []string)

+ func (dm *DependencyManager) GetDependents(pluginName string) []string

+ func (dm *DependencyManager) GetLoadOrder() ([]string, error)

+ func (dm *DependencyManager) GetPlugin(name string) (*VersionedPlugin, error)

+ func (dm *DependencyManager) RegisterPlugin(plugin *VersionedPlugin) error

+ func (dm *DependencyManager) ResolveDependencies() ([]string, error)

+ func (dm *DependencyManager) UnregisterPlugin(name string) error

+ type DependencyNode struct

+ Dependencies []string

+ Name string

+ Plugin Plugin

+ Version *Version

+ type DownloadPlugin interface

+ PostDownload func(ctx context.Context, resp *DownloadResponse) error

+ PreDownload func(ctx context.Context, req *DownloadRequest) error

+ type DownloadRequest struct

+ Options *types.DownloadOptions

+ URL string

+ type DownloadResponse struct

+ Error error

+ Stats *types.DownloadStats

+ type ErrorCollector struct

+ func NewErrorCollector() *ErrorCollector

+ func (ec *ErrorCollector) Add(err *PluginError)

+ func (ec *ErrorCollector) AddError(code PluginErrorCode, err error)

+ func (ec *ErrorCollector) Error() string

+ func (ec *ErrorCollector) GetCriticalErrors() []*PluginError

+ func (ec *ErrorCollector) GetErrors() []*PluginError

+ func (ec *ErrorCollector) HasErrors() bool

+ func (ec *ErrorCollector) Summary() map[string]int

+ type HookType = types.HookType

+ type HotReloadConfig struct

+ AutoRestart bool

+ CheckInterval time.Duration

+ Debounce time.Duration

+ Enabled bool

+ MaxRetries int

+ WatchDirectories []string

+ func DefaultHotReloadConfig() *HotReloadConfig

+ type HotReloadManager struct

+ func NewHotReloadManager(config *HotReloadConfig, manager *PluginManager, depManager *DependencyManager) (*HotReloadManager, error)

+ func (hrm *HotReloadManager) GetPluginInfo(name string) (PluginFileInfo, bool)

+ func (hrm *HotReloadManager) GetTrackedPlugins() []string

+ func (hrm *HotReloadManager) Start() error

+ func (hrm *HotReloadManager) Stop() error

+ type LoaderConfig struct

+ AllowedPaths []string

+ BlockedPaths []string

+ MaxPluginSize int64

+ SearchPaths []string

+ VerifyChecksum bool

+ type Plugin interface

+ Close func() error

+ Init func(config map[string]interface{}) error

+ Name func() string

+ ValidateAccess func(operation string, resource string) error

+ Version func() string

+ type PluginConfigManager struct

+ func NewPluginConfigManager(configDir string, currentVersion int) *PluginConfigManager

+ func (pcm *PluginConfigManager) LoadPluginConfig(pluginName string) (map[string]interface{}, error)

+ func (pcm *PluginConfigManager) ReloadAllConfigs() error

+ func (pcm *PluginConfigManager) SavePluginConfig(pluginName string, config map[string]interface{}) error

+ type PluginError struct

+ Cause error

+ Code PluginErrorCode

+ Details map[string]interface{}

+ Message string

+ PluginName string

+ PluginPath string

+ StackTrace []string

+ Suggestions []string

+ Timestamp time.Time

+ func ErrPluginAlreadyExists(name string) *PluginError

+ func ErrPluginInitError(name string, cause error) *PluginError

+ func ErrPluginLoadError(path string, cause error) *PluginError

+ func ErrPluginNotFoundError(name string) *PluginError

+ func ErrResourceLimitError(resource string, limit interface{}, actual interface{}) *PluginError

+ func ErrSecurityViolationError(operation string, details map[string]interface{}) *PluginError

+ func NewPluginError(code PluginErrorCode, message string) *PluginError

+ func NewPluginErrorWithCause(code PluginErrorCode, message string, cause error) *PluginError

+ func (pe *PluginError) Error() string

+ func (pe *PluginError) GetSeverity() string

+ func (pe *PluginError) IsRetryable() bool

+ func (pe *PluginError) Unwrap() error

+ func (pe *PluginError) WithDetails(details map[string]interface{}) *PluginError

+ func (pe *PluginError) WithPlugin(name, path string) *PluginError

+ func (pe *PluginError) WithStackTrace() *PluginError

+ func (pe *PluginError) WithSuggestions(suggestions ...string) *PluginError

+ type PluginErrorCode string

+ const ErrCircularDependency

+ const ErrConfigurationMissing

+ const ErrDependencyNotFound

+ const ErrHookExecutionFailed

+ const ErrHookNotFound

+ const ErrIncompatibleVersion

+ const ErrInvalidConfiguration

+ const ErrInvalidPlugin

+ const ErrPermissionDenied

+ const ErrPluginAlreadyRegistered

+ const ErrPluginCloseFailed

+ const ErrPluginExecutionFailed

+ const ErrPluginInUse

+ const ErrPluginInitFailed

+ const ErrPluginInvalidInterface

+ const ErrPluginLoadFailed

+ const ErrPluginNotFound

+ const ErrPluginSymbolNotFound

+ const ErrResourceLimitExceeded

+ const ErrSecurityViolation

+ type PluginFileInfo struct

+ Dependencies []string

+ Hash string

+ ModTime time.Time

+ Path string

+ PluginName string

+ Size int64

+ Version string

+ type PluginHook func(data interface{}) error

+ type PluginInfo struct

+ Checksum string

+ LoadTime time.Time

+ Name string

+ NativePlugin *plugin.Plugin

+ Path string

+ Plugin Plugin

+ Size int64

+ Type string

+ Version string

+ type PluginLoader struct

+ func NewPluginLoader(config *LoaderConfig) *PluginLoader

+ func (pl *PluginLoader) AddSearchPath(path string) error

+ func (pl *PluginLoader) DiscoverPlugins() ([]string, error)

+ func (pl *PluginLoader) GetLoadedPlugins() map[string]*PluginInfo

+ func (pl *PluginLoader) GetPluginByName(name string) (Plugin, error)

+ func (pl *PluginLoader) GetPluginsByType(pluginType string) []Plugin

+ func (pl *PluginLoader) GetSearchPaths() []string

+ func (pl *PluginLoader) Load(path string) (Plugin, error)

+ func (pl *PluginLoader) LoadAll() ([]Plugin, []error)

+ func (pl *PluginLoader) LoadFromSearchPath(filename string) (Plugin, error)

+ func (pl *PluginLoader) ReloadPlugin(path string) (Plugin, error)

+ func (pl *PluginLoader) RemoveSearchPath(path string)

+ func (pl *PluginLoader) UnloadAll() []error

+ func (pl *PluginLoader) UnloadPlugin(path string) error

+ func (pl *PluginLoader) VerifyPlugin(path string) error

+ type PluginManager struct

+ func NewPluginManager() *PluginManager

+ func (pm *PluginManager) AddHook(hookType HookType, hookFunc PluginHook)

+ func (pm *PluginManager) ClearErrors()

+ func (pm *PluginManager) Close() error

+ func (pm *PluginManager) ExecuteHook(hook HookType, data interface{}) error

+ func (pm *PluginManager) Get(name string) (Plugin, error)

+ func (pm *PluginManager) GetErrorCollector() *ErrorCollector

+ func (pm *PluginManager) GetPluginStats() map[string]interface{}

+ func (pm *PluginManager) ListPlugins() []string

+ func (pm *PluginManager) LoadFromDirectory(dir string) error

+ func (pm *PluginManager) Register(plugin Plugin) error

+ func (pm *PluginManager) RemoveHooks(hookType HookType)

+ func (pm *PluginManager) SetSecurity(security *PluginSecurity)

+ func (pm *PluginManager) Unregister(name string) error

+ type PluginSecurity struct

+ AllowNativeLibs bool

+ AllowedHosts []string

+ AllowedPaths []string

+ BlockedHosts []string

+ BlockedPaths []string

+ CodeSigning bool

+ EnvironmentAccess bool

+ FileSystemAccess bool

+ MaxExecutionTime time.Duration

+ MaxFileSize int64

+ MaxMemoryUsage int64

+ NetworkAccess bool

+ ReadOnlyMode bool

+ SystemCalls bool

+ TrustedSignature bool

+ func DefaultSecurity() *PluginSecurity

+ func StrictSecurity() *PluginSecurity

+ type ProtocolPlugin interface

+ Download func(ctx context.Context, url string, writer io.Writer) error

+ SupportedSchemes func() []string

+ type ResourceMonitor struct

+ func NewResourceMonitor(maxMemoryMB int64, maxExecTime time.Duration) *ResourceMonitor

+ func (rm *ResourceMonitor) CheckResources() error

+ type SecurePlugin struct

+ func NewSecurePlugin(plugin Plugin, security *PluginSecurity, basePath string) *SecurePlugin

+ func (sp *SecurePlugin) Close() error

+ func (sp *SecurePlugin) Init(config map[string]interface{}) error

+ func (sp *SecurePlugin) ValidateAccess(operation string, resource string) error

+ type SecurePluginExecutor struct

+ func NewSecurePluginExecutor(plugin Plugin, security *PluginSecurity, basePath string) *SecurePluginExecutor

+ func (spe *SecurePluginExecutor) Execute(ctx context.Context, method string, args ...interface{}) (interface{}, error)

+ func (spe *SecurePluginExecutor) GetMonitor() *ResourceMonitor

+ func (spe *SecurePluginExecutor) GetValidator() *SecurityValidator

+ type SecurityValidator struct

+ func NewSecurityValidator(policy *PluginSecurity, basePath string) *SecurityValidator

+ func (sv *SecurityValidator) ValidateFileOperation(operation string, path string) error

+ func (sv *SecurityValidator) ValidateFilePath(path string) error

+ func (sv *SecurityValidator) ValidateFileSize(size int64) error

+ func (sv *SecurityValidator) ValidateNetworkAccess(host string) error

+ type StoragePlugin interface

+ Retrieve func(ctx context.Context, key string) ([]byte, error)

+ Store func(ctx context.Context, data []byte, key string) error

+ type TransformPlugin interface

+ Transform func(data []byte) ([]byte, error)

+ type Version struct

+ BuildMetadata string

+ Major int

+ Minor int

+ Patch int

+ PreRelease string

+ func ParseVersion(versionStr string) (*Version, error)

+ func (v *Version) Compare(other *Version) int

+ func (v *Version) IsCompatible(requirement string) (bool, error)

+ func (v *Version) String() string

+ type VersionedPlugin struct

+ func NewVersionedPlugin(plugin Plugin, version string) (*VersionedPlugin, error)

+ func (vp *VersionedPlugin) AddDependency(pluginName string, versionRequirement string)

+ func (vp *VersionedPlugin) CheckDependencies(availablePlugins map[string]*Version) error

+ func (vp *VersionedPlugin) GetDependencies() map[string]string

+ func (vp *VersionedPlugin) GetVersion() *Version