utils

type CommandExecutor struct{}

type Executor interface {
	Run(combined bool, cmd string, arguments ...string) ([]byte, error)
	Pipe(stdin io.Reader, combined bool, cmd string, arguments ...string) ([]byte, error)
}

type ExecutorFunction = func(cmd string, arguments ...string) ([]byte, error)

type FileSystem interface {
	// ReadFile reads the file at the given path and returns its contents.
	// It returns an error if the file does not exist or cannot be read.
	ReadFile(path string) ([]byte, error)

	// WriteFile writes data to the file at the given path with the specified permissions.
	// It creates the file if it does not exist, or truncates it if it does.
	WriteFile(path string, data []byte, perm os.FileMode) error

	// Stat returns the FileInfo for the file at the given path.
	// It returns an error if the file does not exist or cannot be accessed.
	Stat(path string) (os.FileInfo, error)

	// Create creates or truncates the file at the given path.
	// It returns the opened file or an error if the operation fails.
	Create(path string) (afero.File, error)

	// Open opens the file at the given path for reading.
	// It returns an error if the file does not exist or cannot be opened.
	Open(path string) (afero.File, error)

	// OpenFile opens the file at the given path with the specified flags and permissions.
	// It returns the opened file or an error if the operation fails.
	OpenFile(path string, flag int, perm os.FileMode) (afero.File, error)

	// Remove deletes the file at the given path.
	// It returns an error if the file does not exist or cannot be deleted.
	Remove(path string) error

	// RemoveAll deletes the file or directory at the given path and all its contents.
	// It returns an error if the operation fails.
	RemoveAll(path string) error

	// MkdirAll creates a directory along with any necessary parent directories.
	// It does nothing if the directory already exists.
	MkdirAll(path string, perm os.FileMode) error

	// Symlink creates a symbolic link at newName pointing to oldName.
	// It returns an error if the operation fails or is not supported by the filesystem.
	Symlink(oldName, newName string) error

	// ReadDir reads the directory at the given path and returns a list of file entries.
	// It returns an error if the directory does not exist or cannot be read.
	ReadDir(dirname string) ([]os.FileInfo, error)

	// Exists checks if the file or directory at the given path exists.
	// It returns true if the path exists, false otherwise. An error is returned if the check fails.
	Exists(path string) (bool, error)

	// Pipe creates a script.Pipe for the file at the given path.
	// It returns the pipe for further processing or an error if the file cannot be opened.
	Pipe(path string) *script.Pipe

	// WritePipe writes the contents of the given script.Pipe to the file at the specified path.
	// It returns the number of bytes written and an error if the operation fails.
	WritePipe(path string, pipe *script.Pipe, flag int, perm os.FileMode) (int64, error)

	// DirExists checks if the directory at the given path exists.
	DirExists(path string) (bool, error)

	// MoveFile moves a file from oldPath to newPath.
	Rename(oldPath, newPath string) error
}