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

v0

v0.8.0

Apr 7, 2026

Changes in this version

+ type BasePlugin struct

+ func (BasePlugin) PostContainerCreate(_ context.Context, _ *PostContainerCreateRequest) (*PostContainerCreateResponse, error)

+ func (BasePlugin) PreContainerRun(_ context.Context, _ *PreContainerRunRequest) (*PreContainerRunResponse, error)

+ type ExecFunc func(ctx context.Context, cmd []string, user string, workDir string) ([]byte, error)

type Manager

+ func (m *Manager) RunPostContainerCreate(ctx context.Context, req *PostContainerCreateRequest)

type Plugin

+ PostContainerCreate func(ctx context.Context, req *PostContainerCreateRequest) (*PostContainerCreateResponse, error)

+ type PostContainerCreateRequest struct

+ ContainerID string

+ Exec ExecFunc

+ RemoteUser string

+ StreamExec StreamExecFunc

+ WorkspaceDir string

+ WorkspaceFolder string

+ WorkspaceID string

+ type PostContainerCreateResponse struct

+ type StreamExecFunc func(ctx context.Context, cmd []string, user string, workDir string, ...) error

v0.7.1

Mar 25, 2026

Changes in this version

+ func ShellQuote(s string) string

+ func ShellQuoteJoin(args []string) string

v0.7.0

Mar 10, 2026

v0.6.3

Mar 9, 2026

v0.6.2

Mar 9, 2026

v0.6.1

Mar 8, 2026

v0.6.0

Mar 8, 2026

Changes in this version

type PreContainerRunResponse

+ PathPrepend []string

v0.5.0

Mar 5, 2026

Changes in this version

type Manager

+ func (m *Manager) SetProgress(fn func(string))

v0.4.1

Mar 3, 2026

v0.4.0

Mar 1, 2026

Changes in this version

+ func CopyFile(src, dst string, perm os.FileMode) error

+ func InferOwner(user string) string

+ func InferRemoteHome(user string) string

+ type FileCopy struct

+ IfNotExists bool

+ Mode string

+ Source string

+ Target string

+ User string

+ type Manager struct

+ func NewManager(logger *slog.Logger) *Manager

+ func (m *Manager) Register(p Plugin)

+ func (m *Manager) RunPreContainerRun(ctx context.Context, req *PreContainerRunRequest) (*PreContainerRunResponse, error)

+ type Plugin interface

+ Name func() string

+ PreContainerRun func(ctx context.Context, req *PreContainerRunRequest) (*PreContainerRunResponse, error)

+ type PreContainerRunRequest struct

+ ContainerName string

+ Customizations map[string]any

+ ImageName string

+ RemoteUser string

+ Runtime string

+ SourceDir string

+ WorkspaceDir string

+ WorkspaceFolder string

+ WorkspaceID string

+ type PreContainerRunResponse struct

+ Copies []FileCopy

+ Env map[string]string

+ Mounts []config.Mount

+ RunArgs []string