nemo

type ActionRequest struct {
	// InstallationSpec names the installation and its stack; its name can
	// be left out when BundleSource is given. Its parameters and
	// credentials override the installation's, and its bundle reference is
	// recorded with it.
	storage.InstallationSpec
	// BundleSource is the bundle to run: a bundle.json, or where it was
	// pushed, docker://REFERENCE or oci:PATH. Install needs it; upgrade and
	// uninstall take the installation's when it is left out.
	BundleSource string
	// Target receives the deployment. Left empty, it is the installation's;
	// it can't change once installed.
	Target target.Target
	// Installer says where the invocation image runs. Left empty, it is the
	// installation's.
	Installer target.Installer
	// Progress receives the events of the action.
	Progress progress.Sink
	// Validate runs the bundle's validate action instead, with what the
	// action would run with: nothing changes, and nothing is recorded.
	Validate bool
}

type BundleVersion struct {
	Name    string `json:"name"`
	Version string `json:"version"`
}

type DownRequest struct {
	Name string
	// Purge also removes the volumes.
	Purge    bool
	Progress progress.Sink
}

type InstallationState struct {
	Name      string         `json:"name"`
	Version   string         `json:"version"`
	Installed bool           `json:"installed"`
	Action    string         `json:"action"`
	Result    string         `json:"result"`
	Modified  time.Time      `json:"modified"`
	Services  []ServiceState `json:"services,omitempty"`
}

type LogsRequest struct {
	Stack string
	// Installation and Service narrow the services; empty, every one.
	Installation string
	Service      string
	Follow       bool
	// Tail is how many lines of each service to start with: a number, or all.
	Tail string
	// Line receives each line with its service, from as many goroutines as
	// there are services.
	Line func(service, line string)
}

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

type Options struct {
	// Home is where nemo keeps its files. Empty, it is $NEMO_HOME, or ~/.nemo.
	Home string
}

type Run struct {
	Installation string            `json:"installation"`
	Revision     string            `json:"revision"`
	Action       string            `json:"action"`
	Bundle       BundleVersion     `json:"bundle"`
	Target       target.Target     `json:"target"`
	Driver       string            `json:"driver"`
	Parameters   map[string]any    `json:"parameters,omitempty"`
	Credentials  []string          `json:"credentials,omitempty"`
	Status       string            `json:"status"`
	Started      time.Time         `json:"started"`
	Ended        time.Time         `json:"ended"`
	Outputs      map[string]string `json:"outputs,omitempty"`
}

type ServiceState struct {
	Name    string `json:"name"`
	Running int    `json:"running"`
	Desired int    `json:"desired"`
	State   string `json:"state"`
}

type StackResult struct {
	Runs []Run `json:"runs"`
}

type StackStatus struct {
	Name          string              `json:"name"`
	Target        target.Target       `json:"target"`
	Installations []InstallationState `json:"installations"`
}

type UpRequest struct {
	Stack stack.Stack
	// Only names the installations to act on, with their dependencies not
	// installed yet; empty, all of the stack's.
	// Up then leaves alone the others, and what the stack no longer has.
	Only []string
	// Purge also removes the volumes of the bundles the stack no longer has.
	Purge bool
	// Progress receives the events of the actions: first each installation
	// pending, then what each action does.
	Progress progress.Sink
}