executor

Documentation

Index

• Constants
• type AuthError
  • func (e *AuthError) Error() string
  • func (e *AuthError) Unwrap() error
• type BackendType
  • func ParseBackendType(s string) BackendType
  • func (b BackendType) String() string
• type DockerExecutor
  • func NewDockerExecutor(dryRun, verbose, quiet bool) (*DockerExecutor, error)
  • func (e *DockerExecutor) Available() bool
  • func (e *DockerExecutor) Close() error
  • func (e *DockerExecutor) Name() string
  • func (e *DockerExecutor) Run(ctx context.Context, containerConfig *config.ContainerConfig) error
  • func (e *DockerExecutor) SetTimeout(d time.Duration)
• type ExecutionContext
• type Executor
• type PodmanExecutor
  • func NewPodmanExecutor(dryRun, verbose, quiet bool) (*PodmanExecutor, error)
  • func (e *PodmanExecutor) Available() bool
  • func (e *PodmanExecutor) Close() error
  • func (e *PodmanExecutor) Name() string
  • func (e *PodmanExecutor) Run(ctx context.Context, cfg *config.ContainerConfig) error
• type Selector
  • func NewSelector(dryRun, verbose, quiet bool) (*Selector, error)
  • func (s *Selector) Close() error
  • func (s *Selector) DockerAvailable() bool
  • func (s *Selector) GetDocker() *DockerExecutor
  • func (s *Selector) ListAvailableBackends() []BackendType
  • func (s *Selector) PodmanAvailable() bool
  • func (s *Selector) Select(toolName string, backend BackendType) (Executor, error)

Constants

const DefaultTimeout = 30 * time.Minute

DefaultTimeout is the default timeout for container execution (30 minutes)

Types

type AuthError

type AuthError struct {
	Registry string
	Image    string
	Err      error
}

AuthError represents an authentication failure when pulling images

func (*AuthError) Error

func (e *AuthError) Error() string

func (*AuthError) Unwrap

func (e *AuthError) Unwrap() error

type BackendType

type BackendType string

BackendType represents the executor backend type

const (
	BackendAuto       BackendType = "auto"
	BackendDocker     BackendType = "docker"
	BackendPodman     BackendType = "podman"
	BackendKubernetes BackendType = "kubernetes"
)

func ParseBackendType

func ParseBackendType(s string) BackendType

ParseBackendType converts a string to BackendType

func (BackendType) String

func (b BackendType) String() string

String returns the string representation of BackendType

type DockerExecutor

type DockerExecutor struct {
	// contains filtered or unexported fields
}

DockerExecutor executes tools using Docker

func NewDockerExecutor

func NewDockerExecutor(dryRun, verbose, quiet bool) (*DockerExecutor, error)

NewDockerExecutor creates a new Docker executor

func (*DockerExecutor) Available

func (e *DockerExecutor) Available() bool

Available checks if Docker daemon is running and accessible

func (*DockerExecutor) Close

func (e *DockerExecutor) Close() error

Close closes the Docker client

func (*DockerExecutor) Name

func (e *DockerExecutor) Name() string

Name returns the executor backend name

func (*DockerExecutor) Run

func (e *DockerExecutor) Run(ctx context.Context, containerConfig *config.ContainerConfig) error

Run executes a tool configuration

func (*DockerExecutor) SetTimeout

func (e *DockerExecutor) SetTimeout(d time.Duration)

SetTimeout sets the execution timeout for containers

type ExecutionContext

type ExecutionContext struct {
	DryRun    bool   // If true, show what would be executed without running
	Verbose   bool   // If true, show detailed output
	Workspace string // Project workspace path
}

ExecutionContext provides runtime context for executors

type Executor

type Executor interface {
	// Run executes a tool with the given configuration
	Run(ctx context.Context, config *config.ContainerConfig) error

	// Available checks if this executor backend is available
	// For Docker: checks if daemon is running
	// For Podman: checks if podman machine is running
	Available() bool

	// Name returns the executor backend name (docker, podman, kubernetes)
	Name() string

	// Close releases any resources held by the executor
	Close() error
}

Executor defines the interface for executing tools in containers Implementations include DockerExecutor, PodmanExecutor, KubernetesExecutor

type PodmanExecutor

type PodmanExecutor struct {
	// contains filtered or unexported fields
}

PodmanExecutor wraps DockerExecutor connected to Podman's Docker-compatible socket. Podman exposes a Docker-compatible API, so we reuse the Docker SDK.

func NewPodmanExecutor

func NewPodmanExecutor(dryRun, verbose, quiet bool) (*PodmanExecutor, error)

NewPodmanExecutor creates a Podman executor via Docker-compatible socket.

func (*PodmanExecutor) Available

func (e *PodmanExecutor) Available() bool

func (*PodmanExecutor) Close

func (e *PodmanExecutor) Close() error

func (*PodmanExecutor) Name

func (e *PodmanExecutor) Name() string

func (*PodmanExecutor) Run

func (e *PodmanExecutor) Run(ctx context.Context, cfg *config.ContainerConfig) error

type Selector

type Selector struct {
	// contains filtered or unexported fields
}

Selector manages executor selection based on availability and user preference

func NewSelector

func NewSelector(dryRun, verbose, quiet bool) (*Selector, error)

NewSelector creates a new executor selector

func (*Selector) Close

func (s *Selector) Close() error

Close releases resources held by all executors

func (*Selector) DockerAvailable

func (s *Selector) DockerAvailable() bool

DockerAvailable checks if Docker is available

func (*Selector) GetDocker

func (s *Selector) GetDocker() *DockerExecutor

GetDocker returns the Docker executor (may be nil)

func (*Selector) ListAvailableBackends

func (s *Selector) ListAvailableBackends() []BackendType

ListAvailableBackends returns which backends are currently available

func (*Selector) PodmanAvailable

func (s *Selector) PodmanAvailable() bool

PodmanAvailable checks if Podman is available

func (*Selector) Select

func (s *Selector) Select(toolName string, backend BackendType) (Executor, error)

Select chooses the appropriate executor for a tool based on backend preference