build

type Cmd struct {
	// Exec описывает команду, которую нужно выполнить.
	Exec []string

	// Environ описывает переменные окружения, которые необходимы для работы команды из Exec.
	Environ []string

	// WorkingDirectory задаёт рабочую директорию для команды из Exec.
	WorkingDirectory string

	// CatTemplate задаёт шаблон строки, которую нужно записать в файл.
	CatTemplate string

	// CatOutput задаёт выходной файл для команды типа cat.
	CatOutput string
}

type Graph struct {
	SourceFiles map[ID]string

	Jobs []Job
}

type ID [sha1.Size]byte

type Job struct {
	// ID задаёт уникальный идентификатор джоба.
	//
	// ID вычисляется как хеш от всех входных файлов, команд запуска и хешей зависимых джобов.
	//
	// Выход джоба целиком определяется его ID. Это важное свойство позволяет кешировать
	// результаты сборки.
	ID ID

	// Name задаёт человекочитаемое имя джоба.
	//
	// Например:
	//   build gitlab.com/slon/disbuild/pkg/b
	//   vet gitlab.com/slon/disbuild/pkg/a
	//   test gitlab.com/slon/disbuild/pkg/test
	Name string

	// Inputs задаёт список файлов из директории с исходным кодом,
	// которые нужны для работы этого джоба.
	//
	// В типичном случае, тут будут перечислены все .go файлы одного пакета.
	Inputs []string

	// Deps задаёт список джобов, выходы которых нужны для работы этого джоба.
	Deps []ID

	// Cmds описывает список команд, которые нужно выполнить в рамках этого джоба.
	Cmds []Cmd
}

type JobContext struct {
	SourceDir string
	OutputDir string
	Deps      map[ID]string
}