std

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

type Chmod struct {
	Path     string
	FileMode os.FileMode
}

type Chown struct {
	Path  string
	Owner string
	Group string
}

type Command struct {
	// Shell is the interpreter binary, e.g. "bash", "pwsh", "python".
	// Defaults to "sh", regardless of OS.
	//
	// This is intentional - defining the shell to depend on the OS is
	// error prone as POSIXly correct shells have vastly different
	// syntax than powershell. So in an environment with both Windows
	// and Unixoid machines would have to define both Shell and Command
	// depending on the OS anyway, unless e.g. sh/bash is also available
	// on Windows, in which case the Shell would have to be set for all
	// hosts anyway.
	// So to summarize - setting the shell per OS is nonsense and only
	// makes sense for homogeneous environments where you might as well
	// set the shell static if it diverges from the default.
	Shell string
	// Args are passed between interpreter and command.
	// Defaults are looked up by interpreter name.
	// Unknown interpreters require Args.
	Args []string
	// Command is passed as the final argument to the interpreter.
	Command string
	// Env is appended to the process environment as KEY=VALUE.
	Env map[string]string
	// Dir is the working directory. Empty means inherited.
	Dir string

	// Creates skips execution when the path exists.
	Creates string
	// Removes skips execution when the path is missing.
	Removes string

	// Unless skips execution when the command exits 0.
	// Executed with the same Shell, Args, Env and Dir as Command.
	Unless string
	// OnlyIf skips execution unless the command exits 0.
	// Executed with the same Shell, Args, Env and Dir as Command.
	OnlyIf string
	// contains filtered or unexported fields
}

type CommandOutput struct {
	// Output is the combined stdout and stderr of the executed
	// command, empty when the command was not executed.
	Output string
}

type Dir struct {
	Chmod
	Chown

	Path string
}

type Download struct {
	Chown
	Chmod

	// State is the desired existence.
	// Defaults to [tensile.Present].
	State tensile.State

	// URL is the remote file location.
	// Required.
	URL string
	// Output is the local destination.
	// May be a file path or a directory (ending in /).
	// Required.
	Output string

	// Checksum is the expected hash of the file.
	// Mutually exclusive with ChecksumURL.
	Checksum string
	// ChecksumURL is a URL to a hashsum file containing the expected hash.
	// Mutually exclusive with Checksum.
	ChecksumURL string
}

type Facts struct{}

type FactsData struct {
	// OS is the operating system, e.g. "linux", "darwin".
	OS string
	// Architecture is the CPU architecture, e.g. "amd64", "arm64".
	Architecture string
	Hostname     string
	// OSRelease is parsed from /etc/os-release, zero when unavailable.
	OSRelease OSRelease
	// UserID is the uid of the running process.
	UserID int
}

type File struct {
	Path string
	// State is the desired existence.
	// Defaults to [tensile.Present].
	// [tensile.Absent] ignores all fields but Path.
	// [tensile.ReadOnly] is not supported.
	State tensile.State

	// Content is the managed file content.
	// Empty means only existence is ensured, existing content is left alone.
	Content string

	// FileMode, Owner and Group are applied by the queue returned by [NewFile], not by the node itself.
	FileMode os.FileMode
	Owner    string
	Group    string
}

type FileContent struct {
	Path    string
	Content string
}

type FileContentOutput struct {
	Path string
	// SHA256 is the hex-encoded checksum of the content.
	SHA256 string
}

type Group struct {
	Name string
	// GID nil is unmanaged, allocated on creation.
	GID *int
	// State defaults to [tensile.Present].
	State tensile.State
	// contains filtered or unexported fields
}

type GroupData struct {
	shadow.Group

	Present bool
}

type GroupMembership struct {
	User  string
	Group string
	// State defaults to [tensile.Present].
	// [tensile.ReadOnly] is not supported.
	State tensile.State
	// contains filtered or unexported fields
}

type INIField[T INIValue] struct {
	// State is the desired state.
	// Defaults to [tensile.Present].
	State tensile.State

	Path string
	// Section is the INI section, empty for the default section.
	Section string
	Key     string
	Value   T

	// LoadOptions configures parsing, empty uses the ini defaults.
	LoadOptions ini.LoadOptions
}

type INIFieldOutput struct {
	Path    string
	Section string
	Key     string
	Present bool
	// Value is the current value, empty when absent.
	Value string
}

type INIValue interface {
	string | int | float64 | bool
}

type JSONField struct {
	// State is the desired state.
	// Defaults to [tensile.Present].
	State tensile.State

	Path  string
	Key   string
	Value any
}

type JSONFieldOutput struct {
	Path    string
	Key     string
	Present bool
	// Value is the current value, nil when absent.
	Value any
}

type LineInFile struct {
	Path string
	// Regexp locates the line to replace.
	// If multiple lines match the regex the last match is considered.
	// Empty matches Line verbatim.
	Regexp string
	Line   string
}

type Noop struct {
	Name string
}

type OSRelease struct {
	// Name is NAME, e.g. "Arch Linux".
	Name string
	// PrettyName is PRETTY_NAME, e.g. "Arch Linux".
	PrettyName string
	// ID is ID, e.g. "arch".
	ID string
	// IDLike is the space separated ID_LIKE, e.g. ["rhel", "fedora"].
	IDLike []string
	// Version is VERSION, e.g. "9.4 (Blue Onyx)".
	Version string
	// VersionID is VERSION_ID, e.g. "9.4".
	VersionID string
	// BuildID is BUILD_ID, e.g. "rolling".
	BuildID string
}

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

type Package struct {
	Name string
	// State is the desired presence.
	// Empty means [tensile.Present].
	// [tensile.ReadOnly] is not supported.
	State tensile.State
	// Manager selects a registered [PackageManager] by name.
	// Empty means detection.
	Manager string
}

type PackageManager interface {
	// Handles reports whether this manager handles the package.
	Handles(ctx context.Context, name string) (bool, error)
	// Update refreshes the package lists.
	// It does not upgrade packages.
	// A no-op when the manager is not available or has no way of updating package lists.
	Update(ctx context.Context) error
	// Installed returns whether the package is installed.
	Installed(ctx context.Context, name string) (bool, error)
	// Install installs the package.
	Install(ctx context.Context, name string) error
	// Remove removes the package.
	Remove(ctx context.Context, name string) error
}

type PackageManagerUpdate struct{}

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

type Print struct {
	Message string
	Args    []any
}

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

type PruneUnmanagedFiles struct {
	Dir string
}

type PruneUnmanagedGroupMemberships struct {
	// Group limits pruning to the named group.
	// Empty prunes all groups.
	Group string
	// IncludeSystem also prunes members of groups with a system GID.
	// If the group is a system group (e.g. wheel) this must be true.
	IncludeSystem bool
	// IDMin nil defaults to [shadow.DefaultIDMin].
	IDMin *int
	// IDMax nil defaults to [shadow.DefaultIDMax].
	IDMax *int
	// contains filtered or unexported fields
}

type PruneUnmanagedGroups struct {
	// IncludeSystem also prunes groups with a system GID.
	IncludeSystem bool
	// IDMin nil defaults to [shadow.DefaultIDMin].
	IDMin *int
	// IDMax nil defaults to [shadow.DefaultIDMax].
	IDMax *int
	// contains filtered or unexported fields
}

type PruneUnmanagedUsers struct {
	// IncludeSystem also prunes users with a system UID.
	IncludeSystem bool
	// IDMin nil defaults to [shadow.DefaultIDMin].
	IDMin *int
	// IDMax nil defaults to [shadow.DefaultIDMax].
	IDMax *int
	// contains filtered or unexported fields
}

type Service struct {
	Name    string
	Enabled *bool
	Running *bool
	// Manager selects a registered [ServiceManager] by name.
	// Empty means detection.
	Manager string
	// Timeout in seconds to wait for the [ServiceManager] to report the
	// desired running state after applying it.
	// Defaults to [DefaultServiceTimeout].
	Timeout time.Duration
}

type ServiceManager interface {
	// Handles reports whether this manager handles the service.
	Handles(ctx context.Context, name string) (bool, error)
	// Status returns the current state of the service.
	Status(ctx context.Context, name string) (ServiceStatus, error)
	// Apply transitions the service to the desired state.
	Apply(ctx context.Context, name string, desired ServiceStatus) error
	// Restart restarts the service.
	Restart(ctx context.Context, name string) error
}

type ServiceRestart struct {
	Name string
	// Manager selects a registered [ServiceManager] by name.
	// Empty means detection.
	Manager string
	// Timeout in seconds to wait for the [ServiceManager] to report the
	// desired running state after applying it.
	// Defaults to [DefaultServiceTimeout].
	Timeout time.Duration
}

type ServiceStatus struct {
	Enabled bool
	Active  bool
}

type Symlink struct {
	Path   string
	Target string
}

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

type User struct {
	Name string
	// UID nil is unmanaged, allocated on creation.
	UID *int
	// Group is the primary group.
	// Empty applies the tool default on creation and is unmanaged afterwards.
	Group string
	// Groups are the supplementary groups.
	// Nil is unmanaged.
	// Memberships claimed by other nodes, e.g. [GroupMembership], are kept.
	Groups []string
	// Home empty applies the tool default on creation and is unmanaged afterwards.
	Home string
	// Shell empty applies the tool default on creation and is unmanaged afterwards.
	Shell string
	// State defaults to [tensile.Present].
	State tensile.State
	// contains filtered or unexported fields
}

type UserData struct {
	shadow.User

	Present bool
}

type YAMLField struct {
	// State is the desired state.
	// Defaults to [tensile.Present].
	State tensile.State

	Path  string
	Key   string
	Value any
}

type YAMLFieldOutput struct {
	Path    string
	Key     string
	Present bool
	// Value is the current value, nil when absent.
	Value any
}