devcontainer

Apr 22, 2026

Changes in this version

+ func ResolvedDockerfile(configDir string, config Config) string

+ func StandardizeJSONC(path string, data []byte) ([]byte, error)

type WorkspaceSpec

+ ComposeFiles []string

+ ComposeService string

+ Config Config

+ ConfigDir string

+ ConfigPath string

+ Merged MergedConfig

+ RemoteWorkspace string

+ SourceKind string

+ WorkspaceFolder string

+ WorkspaceMount string

+ func ResolveWorkspaceSpec(workspaceArg string, configArg string) (WorkspaceSpec, error)

Apr 14, 2026

Changes in this version

+ func FeaturesMetadata(features []ResolvedFeature) []spec.MetadataEntry

Apr 12, 2026

Changes in this version

type ResolvedConfig

+ func ResolveWorkspaceSpecWithOptions(ctx context.Context, workspaceSpec WorkspaceSpec, stateDir string, ...) (ResolvedConfig, error)

Apr 9, 2026

Changes in this version

type ResolveOptions

+ Warn func(string)

Apr 9, 2026

Changes in this version

+ func ResolveConfigPath(workspace string, configArg string) (string, error)

+ func ResolveWorkspacePath(workspaceArg string) (string, error)

+ type StateTransition = storefs.StateTransition

+ type WorkspaceSpec = spec.WorkspaceSpec

Apr 8, 2026

Changes in this version

+ const SSHAgentLabel

Apr 8, 2026

Changes in this version

+ func WorkspaceCacheDir(workspace string, configPath string) (string, error)

type FeatureResolveOptions

+ VerifyImage func(context.Context, string) security.VerificationResult

+ type OutputRoots struct

+ CacheRoot string

+ StateRoot string

+ func DefaultOutputRoots() (OutputRoots, error)

type ResolveOptions

+ CacheBaseDir string

+ ReadPlanCache bool

+ StateBaseDir string

+ VerifyImage func(context.Context, string) security.VerificationResult

+ WritePlanCache bool

type ResolvedConfig

+ CacheDir string

type ResolvedFeature

+ Verification security.VerificationResult

Apr 8, 2026

Changes in this version

type State

+ DotfilesInstall string

+ DotfilesReady bool

+ DotfilesRepo string

+ DotfilesTarget string

Apr 8, 2026

Changes in this version

+ func KeepAliveCommand() string

Apr 8, 2026

Changes in this version

+ type MountSpec struct

+ BindPropagation string

+ Consistency string

+ CreateHostPath *bool

+ NoCopy bool

+ Raw string

+ ReadOnly bool

+ SELinux string

+ Source string

+ Subpath string

+ Target string

+ Type string

+ func ParseMountSpec(raw string) (MountSpec, bool)

Apr 7, 2026

Changes in this version

type FeatureResolveOptions

+ HTTPTimeout time.Duration

type ResolveOptions

+ FeatureHTTPTimeout time.Duration

Apr 7, 2026

Changes in this version

+ const BridgeEnabledLabel

+ const ConfigFileLabel

+ const HostFolderLabel

+ const ImageMetadataLabel

+ const ManagedByLabel

+ const ManagedByValue

+ func ComposeOverrideFile(stateDir string) string

+ func ComposeProjectName(workspace string, configPath string) string

+ func ContainerCommand(config Config) []string

+ func ContainerName(workspace string, configPath string) string

+ func EffectiveContext(config Config) string

+ func EffectiveDockerfile(config Config) string

+ func FeatureLockFilePath(configPath string) string

+ func ImageName(workspace string, configPath string) string

+ func MetadataLabelValue(entries []MetadataEntry) (string, error)

+ func RemoteExecUser(config Config) string

+ func ResolveComposeFiles(configDir string, raw any) ([]string, error)

+ func ShellQuote(value string) string

+ func SortedMapKeys(values map[string]string) []string

+ func WorkspaceStateDir(workspace string, configPath string) (string, error)

+ func WriteFeatureLockFile(configPath string, features []ResolvedFeature) error

+ func WriteFeatureStateFile(stateDir string, features []ResolvedFeature) error

+ func WriteState(stateDir string, state State) error

+ type BuildConfig struct

+ Args map[string]string

+ CacheFrom any

+ Context string

+ Dockerfile string

+ Options []string

+ Target string

+ type Config struct

+ Build *BuildConfig

+ CapAdd []string

+ ContainerEnv map[string]string

+ ContainerUser string

+ Customizations map[string]any

+ DockerComposeFile any

+ DockerFile string

+ Features map[string]any

+ ForwardPorts ForwardPorts

+ Image string

+ Init *bool

+ InitializeCommand LifecycleCommand

+ Mounts []string

+ Name string

+ OnCreateCommand LifecycleCommand

+ OverrideCommand *bool

+ PostAttachCommand LifecycleCommand

+ PostCreateCommand LifecycleCommand

+ PostStartCommand LifecycleCommand

+ Privileged *bool

+ Raw map[string]any

+ RemoteEnv map[string]string

+ RemoteUser string

+ RunArgs []string

+ SecurityOpt []string

+ Service string

+ UpdateContentCommand LifecycleCommand

+ UpdateRemoteUserUID *bool

+ WaitFor string

+ WorkspaceFolder string

+ WorkspaceMount string

+ func Load(configPath string) (Config, error)

+ type FeatureLockEntry struct

+ Integrity string

+ Resolved string

+ Version string

+ type FeatureLockFile map[string]FeatureLockEntry

+ func ReadFeatureLockFile(configPath string) (FeatureLockFile, bool, error)

+ type FeatureLockfilePolicy string

+ const FeatureLockfilePolicyAuto

+ const FeatureLockfilePolicyFrozen

+ const FeatureLockfilePolicyUpdate

+ func ParseFeatureLockfilePolicy(value string) (FeatureLockfilePolicy, error)

+ type FeatureResolveOptions struct

+ AllowNetwork bool

+ LockfilePolicy FeatureLockfilePolicy

+ StateDir string

+ WriteLockFile bool

+ WriteStateFile bool

+ type FeatureStateEntry struct

+ ID string

+ Integrity string

+ Kind string

+ Options map[string]string

+ Path string

+ Resolved string

+ Source string

+ type FeatureStateFile struct

+ Features []FeatureStateEntry

+ type ForwardPorts []string

+ func MergeForwardPorts(entries ...ForwardPorts) ForwardPorts

+ func NormalizeForwardPorts(raw []any) (ForwardPorts, error)

+ func (p *ForwardPorts) UnmarshalJSON(data []byte) error

+ func (p ForwardPorts) MarshalJSON() ([]byte, error)

+ type LifecycleCommand struct

+ Args []string

+ Exists bool

+ Kind string

+ Steps map[string]LifecycleCommand

+ Value string

+ func (c *LifecycleCommand) UnmarshalJSON(data []byte) error

+ func (c LifecycleCommand) Empty() bool

+ func (c LifecycleCommand) MarshalJSON() ([]byte, error)

+ func (c LifecycleCommand) SortedSteps() []LifecycleStep

+ type LifecycleStep struct

+ Command LifecycleCommand

+ Name string

+ type MergedConfig struct

+ CapAdd []string

+ Config Config

+ ContainerEnv map[string]string

+ ContainerUser string

+ Customizations map[string][]any

+ ForwardPorts ForwardPorts

+ Init bool

+ Metadata []MetadataEntry

+ Mounts []string

+ OnCreateCommands []LifecycleCommand

+ OverrideCommand *bool

+ PostAttachCommands []LifecycleCommand

+ PostCreateCommands []LifecycleCommand

+ PostStartCommands []LifecycleCommand

+ Privileged bool

+ RemoteEnv map[string]string

+ RemoteUser string

+ SecurityOpt []string

+ UpdateContentCommands []LifecycleCommand

+ UpdateRemoteUserUID *bool

+ WaitFor string

+ func MergeMetadata(config Config, metadata []MetadataEntry) MergedConfig

+ type MetadataEntry struct

+ CapAdd []string

+ ContainerEnv map[string]string

+ ContainerUser string

+ Customizations map[string]any

+ ForwardPorts ForwardPorts

+ ID string

+ Init *bool

+ Mounts []string

+ OnCreateCommand LifecycleCommand

+ OverrideCommand *bool

+ PostAttachCommand LifecycleCommand

+ PostCreateCommand LifecycleCommand

+ PostStartCommand LifecycleCommand

+ Privileged *bool

+ RemoteEnv map[string]string

+ RemoteUser string

+ SecurityOpt []string

+ UpdateContentCommand LifecycleCommand

+ UpdateRemoteUserUID *bool

+ WaitFor string

+ func ConfigMetadata(config Config) MetadataEntry

+ func MetadataFromLabel(value string) ([]MetadataEntry, error)

+ func (m MetadataEntry) MarshalJSON() ([]byte, error)

+ type ResolveOptions struct

+ AllowNetwork bool

+ LockfilePolicy FeatureLockfilePolicy

+ WriteFeatureLock bool

+ WriteFeatureState bool

+ type ResolvedConfig struct

+ ComposeFiles []string

+ ComposeProject string

+ ComposeService string

+ Config Config

+ ConfigDir string

+ ConfigPath string

+ ContainerName string

+ Features []ResolvedFeature

+ ImageName string

+ Labels map[string]string

+ Merged MergedConfig

+ RemoteWorkspace string

+ SourceKind string

+ StateDir string

+ WorkspaceFolder string

+ WorkspaceMount string

+ func Resolve(ctx context.Context, workspaceArg string, configArg string) (ResolvedConfig, error)

+ func ResolveReadOnly(ctx context.Context, workspaceArg string, configArg string) (ResolvedConfig, error)

+ func ResolveReadOnlyWithOptions(ctx context.Context, workspaceArg string, configArg string, ...) (ResolvedConfig, error)

+ func ResolveWithOptions(ctx context.Context, workspaceArg string, configArg string, ...) (ResolvedConfig, error)

+ type ResolvedFeature struct

+ DependsOn []string

+ InstallsAfter []string

+ Integrity string

+ Metadata MetadataEntry

+ Options map[string]string

+ Path string

+ Resolved string

+ Source string

+ SourceKind string

+ Version string

+ func ResolveFeatures(ctx context.Context, configPath string, configDir string, cacheDir string, ...) ([]ResolvedFeature, error)

+ type State struct

+ BridgeEnabled bool

+ BridgeSessionID string

+ ContainerID string

+ LifecycleReady bool

+ func ReadState(stateDir string) (State, error)