generate

type Note struct {
	// Unit is the generated unit it concerns, empty for project-wide notes.
	Unit string
	// Message states what happened.
	Message string
	// Severity is `error`, `warning`, or `note`.
	Severity string
}

type Options struct {
	// Pod emits a single .pod unit that every container joins, instead of a
	// shared .network. Containers in a pod share a network namespace and
	// reach each other on localhost.
	Pod bool
	// Annotate writes explanatory comments into the generated units.
	// On by default; tests that compare exact bytes may turn it off.
	Annotate bool
}

type Result struct {
	Units []Unit
	// Notes are translation decisions worth reporting to the user, beyond
	// what is annotated in the files.
	Notes []Note
}

type Unit struct {
	// Name is the file name, e.g. `web.container`.
	Name string
	// Content is the file's text.
	Content string
}