workspace

func AddProvider ¶

func AddProvider(
	devsyConfig *config.Config,
	providerName, providerSourceRaw string,
) (*provider.ProviderConfig, error)

func AddProviderRaw ¶

func AddProviderRaw(p ProviderParams) (*provider.ProviderConfig, error)

func CheckProviderUpdate ¶

func CheckProviderUpdate(
	devsyConfig *config.Config,
	proInstance *provider2.ProInstance,
) error

CheckProviderUpdate currently only ensures the local provider is in sync with the remote for Devsy Pro instances. Potentially auto-upgrade other providers in the future.

func Delete ¶

func Delete(ctx context.Context, opts DeleteOptions) (string, error)

Delete deletes a workspace, handling imported workspaces, single-machine cleanup, and force-deletion of broken workspaces.

func Exists ¶

func Exists(
	ctx context.Context,
	devsyConfig *config.Config,
	args []string,
	workspaceID string,
	owner platform.OwnerFilter,
) string

Exists checks if the given workspace already exists.

func FindProviderProInstance ¶

func FindProviderProInstance(
	proInstances []*provider2.ProInstance,
	providerName string,
) (*provider2.ProInstance, bool)

func Get ¶

func Get(ctx context.Context, opts GetOptions) (client.BaseWorkspaceClient, error)

Get tries to retrieve an already existing workspace.

func GetMachine ¶

func GetMachine(
	devsyConfig *config.Config,
	args []string,
) (client.MachineClient, error)

GetMachine creates a machine client.

func GetProInstance ¶

func GetProInstance(
	devsyConfig *config.Config,
	providerName string,
) *provider2.ProInstance

GetProInstance returns the ProInstance associated with the given provider name, or nil if not found.

func List ¶

func List(
	ctx context.Context,
	devsyConfig *config.Config,
	skipPro bool,
	owner platform.OwnerFilter,
) ([]*providerpkg.Workspace, error)

func ListLocalWorkspaces ¶

func ListLocalWorkspaces(
	contextName string,
	skipPro bool,
) ([]*providerpkg.Workspace, error)

func ListMachines ¶

func ListMachines(devsyConfig *config.Config) ([]*providerpkg.Machine, error)

ListMachines returns all machines configured in the given Devsy context.

func ListProInstances ¶

func ListProInstances(
	devsyConfig *config.Config,
) ([]*provider2.ProInstance, error)

func LoadAllProviders ¶

func LoadAllProviders(
	devsyConfig *config.Config,
) (map[string]*ProviderWithOptions, error)

func MachineExists ¶

func MachineExists(devsyConfig *config.Config, args []string) string

MachineExists checks if the given workspace already exists.

func MoveProvider ¶

func MoveProvider(devsyConfig *config.Config, oldName, newName string) error

MoveProvider renames a provider's directory on disk and migrates its state in config.json. This preserves all options, initialized flag, and other state that CloneProvider would lose.

func ProviderFromHost ¶

func ProviderFromHost(
	ctx context.Context,
	devsyConfig *config.Config,
	proHost string,
) (*provider.ProviderConfig, error)

func Rename ¶ added in v1.3.0

func Rename(ctx context.Context, opts RenameOptions) error

Rename performs the workspace rename: auto-stops if running, moves the workspace directory, updates the config ID, and removes the old SSH config entry. If any step after the directory move fails, the entire operation is rolled back.

func Resolve ¶

func Resolve(
	ctx context.Context,
	devsyConfig *config.Config,
	params ResolveParams,
) (client.BaseWorkspaceClient, error)

func ResolveMachine ¶

func ResolveMachine(
	devsyConfig *config.Config,
	args []string,
	userOptions []string,
) (client.Client, error)

func ResolveProvider ¶

func ResolveProvider(
	providerSource string,
) ([]byte, *provider.ProviderSource, error)

func ResolveProviderSource ¶

func ResolveProviderSource(
	devsyConfig *config.Config,
	providerName string,
) (string, error)

func SingleMachineName ¶

func SingleMachineName(devsyConfig *config.Config, provider string) string

func SwitchProvider ¶

func SwitchProvider(
	ctx context.Context,
	devsyConfig *config.Config,
	workspace *provider.Workspace,
	newProviderName string,
) error

SwitchProvider updates the provider name for the given workspace with client locking. It persists the new provider name before resolving the client so that FindProvider can locate the already-renamed provider directory.

func ToID ¶

func ToID(str string) string

func UpdateProvider ¶

func UpdateProvider(
	devsyConfig *config.Config,
	providerName, providerSourceRaw string,
) (*provider.ProviderConfig, error)