bootstrap

package
v1.234.0-rc.1 Latest Latest
Warning

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

Go to latest
Published: Nov 5, 2026 License: Apache-2.0 Imports: 39 Imported by: 0

Documentation

Overview

Package bootstrap composes plugin descriptors, runtimes, and existing Atmos registries.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func DescribePackage

func DescribePackage(directory string, definition *manifest.Config, bindings []extension.Binding) (*pluginv1.DescribeResponse, error)

DescribePackage derives the required runtime handshake from validated package metadata.

func Descriptors

func Descriptors() (*extension.Registry, error)

Descriptors declares supported extension types. Lifecycle code receives this registry rather than switching over a closed list of capability names.

func Prepare

func Prepare(ctx context.Context, atmos *schema.AtmosConfiguration, options ...Option) (func(), error)

Prepare restores the project packages the configuration needs (see neededPackages) and registers their exports before auth initialization. Native binaries launch lazily when their services run.

func PrepareAvailable

func PrepareAvailable(ctx context.Context, atmos *schema.AtmosConfiguration, options ...Option) (func(), error)

PrepareAvailable temporarily registers verified local auth plugins needed by configured registry identities. It never restores packages or contacts a registry.

func ProjectDirectory

func ProjectDirectory(config *schema.AtmosConfiguration) string

ProjectDirectory locates project-local plugin state using resolved config provenance.

func Run

func Run(ctx context.Context, atmos *schema.AtmosConfiguration, alias string, arguments []string, output Output) error

Run executes the selected command export of an installed package.

Types

type ConstructorSet

type ConstructorSet struct {
	Batch       authregistry.Registration
	Services    adapter.Services
	Credentials *credential.Registry
	Commands    map[string]*extension.Activation
}

ConstructorSet accumulates all package exports before atomically installing them.

type Option

type Option func(*adapter.Services)

Option configures Atmos-owned runtime dependencies at the composition root.

func WithInteraction

func WithInteraction(browser api.Browser, available func() bool) Option

WithInteraction supplies browser and interactivity services for embedders and tests. Plugin package settings cannot override this decision.

type Output

type Output struct {
	Stdout, Stderr io.Writer
	// OnStart identifies the selected command before invoking the plugin.
	OnStart func(alias, name, description string)
}

Output selects command data and diagnostic streams.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL