codeserver

package
v0.6.5 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: May 13, 2026 License: MIT Imports: 23 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func ResolveBinary 

func ResolveBinary(stateDir string, stateRoot string) (string, error)

ResolveBinary resolves the selected code-server binary path for the current environment and validates that it is usable.

Types

type Instance 

type Instance struct {
	CodeSpaceID   string    `json:"code_space_id"`
	WorkspacePath string    `json:"workspace_path"`
	Port          int       `json:"port"`
	PID           int       `json:"pid"`
	StartedAt     time.Time `json:"started_at"`
	// contains filtered or unexported fields
}

type Runner 

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

func NewRunner 

func NewRunner(opts RunnerOptions) *Runner

func (*Runner) EnsureRunning 

func (r *Runner) EnsureRunning(codeSpaceID string, workspacePath string, desiredPort int) (*Instance, error)

func (*Runner) Get 

func (r *Runner) Get(codeSpaceID string) (*Instance, bool)

func (*Runner) Stop 

func (r *Runner) Stop(codeSpaceID string) error

func (*Runner) StopAll 

func (r *Runner) StopAll() error

type RunnerOptions 

type RunnerOptions struct {
	Logger    *slog.Logger
	StateDir  string
	StateRoot string

	PortMin int
	PortMax int

	// ReconnectionGrace controls VSCODE_RECONNECTION_GRACE_TIME for code-server.
	// When <= 0, code-server keeps its upstream default.
	ReconnectionGrace time.Duration
}

type RuntimeDetectionState 

type RuntimeDetectionState string
const (
	RuntimeDetectionReady    RuntimeDetectionState = "ready"
	RuntimeDetectionMissing  RuntimeDetectionState = "missing"
	RuntimeDetectionUnusable RuntimeDetectionState = "unusable"
)

type RuntimeInstalledVersionStatus 

type RuntimeInstalledVersionStatus struct {
	Version                    string                `json:"version"`
	BinaryPath                 string                `json:"binary_path,omitempty"`
	InstalledAtUnixMs          int64                 `json:"installed_at_unix_ms,omitempty"`
	SelectedByLocalEnvironment bool                  `json:"selected_by_local_environment,omitempty"`
	Removable                  bool                  `json:"removable,omitempty"`
	DetectionState             RuntimeDetectionState `json:"detection_state"`
	ErrorMessage               string                `json:"error_message,omitempty"`
}

type RuntimeManager 

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

func NewRuntimeManager 

func NewRuntimeManager(opts RuntimeManagerOptions) *RuntimeManager

func (*RuntimeManager) CancelOperation 

func (m *RuntimeManager) CancelOperation(ctx context.Context) RuntimeStatus

func (*RuntimeManager) RemoveLocalEnvironmentVersion 

func (m *RuntimeManager) RemoveLocalEnvironmentVersion(ctx context.Context, version string) (RuntimeStatus, error)

func (*RuntimeManager) SelectVersion 

func (m *RuntimeManager) SelectVersion(ctx context.Context, version string) (RuntimeStatus, error)

func (*RuntimeManager) StartInstall 

func (m *RuntimeManager) StartInstall(ctx context.Context) RuntimeStatus

func (*RuntimeManager) Status 

func (m *RuntimeManager) Status(ctx context.Context) RuntimeStatus

type RuntimeManagerOptions 

type RuntimeManagerOptions struct {
	Logger               *slog.Logger
	StateDir             string
	StateRoot            string
	InstallScriptURL     string
	InstallScriptContent []byte
	HTTPClient           *http.Client
	Now                  func() time.Time
}

type RuntimeOperationAction 

type RuntimeOperationAction string
const (
	RuntimeOperationActionInstall                       RuntimeOperationAction = "install"
	RuntimeOperationActionRemoveLocalEnvironmentVersion RuntimeOperationAction = "remove_local_environment_version"
)

type RuntimeOperationStage 

type RuntimeOperationStage string
const (
	RuntimeOperationStagePreparing   RuntimeOperationStage = "preparing"
	RuntimeOperationStageDownloading RuntimeOperationStage = "downloading"
	RuntimeOperationStageInstalling  RuntimeOperationStage = "installing"
	RuntimeOperationStageRemoving    RuntimeOperationStage = "removing"
	RuntimeOperationStageValidating  RuntimeOperationStage = "validating"
	RuntimeOperationStageFinalizing  RuntimeOperationStage = "finalizing"
)

type RuntimeOperationState 

type RuntimeOperationState string
const (
	RuntimeOperationStateIdle      RuntimeOperationState = "idle"
	RuntimeOperationStateRunning   RuntimeOperationState = "running"
	RuntimeOperationStateSucceeded RuntimeOperationState = "succeeded"
	RuntimeOperationStateFailed    RuntimeOperationState = "failed"
	RuntimeOperationStateCancelled RuntimeOperationState = "cancelled"
)

type RuntimeOperationStatus 

type RuntimeOperationStatus struct {
	Action           RuntimeOperationAction `json:"action,omitempty"`
	State            RuntimeOperationState  `json:"state"`
	Stage            RuntimeOperationStage  `json:"stage,omitempty"`
	TargetVersion    string                 `json:"target_version,omitempty"`
	LastError        string                 `json:"last_error,omitempty"`
	LastErrorCode    string                 `json:"last_error_code,omitempty"`
	StartedAtUnixMs  int64                  `json:"started_at_unix_ms,omitempty"`
	FinishedAtUnixMs int64                  `json:"finished_at_unix_ms,omitempty"`
	LogTail          []string               `json:"log_tail,omitempty"`
}

type RuntimeStatus 

type RuntimeStatus struct {
	ActiveRuntime         RuntimeTargetStatus             `json:"active_runtime"`
	ManagedRuntime        RuntimeTargetStatus             `json:"managed_runtime"`
	ManagedPrefix         string                          `json:"managed_prefix"`
	SharedRuntimeRoot     string                          `json:"shared_runtime_root"`
	ManagedRuntimeVersion string                          `json:"managed_runtime_version,omitempty"`
	ManagedRuntimeSource  string                          `json:"managed_runtime_source"`
	InstalledVersions     []RuntimeInstalledVersionStatus `json:"installed_versions,omitempty"`
	InstallerScriptURL    string                          `json:"installer_script_url"`
	Operation             RuntimeOperationStatus          `json:"operation"`
	UpdatedAtUnixMs       int64                           `json:"updated_at_unix_ms"`
}

type RuntimeTargetStatus 

type RuntimeTargetStatus struct {
	DetectionState RuntimeDetectionState `json:"detection_state"`
	Present        bool                  `json:"present"`
	Source         string                `json:"source"`
	BinaryPath     string                `json:"binary_path,omitempty"`
	Version        string                `json:"version,omitempty"`
	ErrorCode      string                `json:"error_code,omitempty"`
	ErrorMessage   string                `json:"error_message,omitempty"`
}

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.