processors

type Config struct {
	// The name of the processor.
	Name string

	// FileExtensions are the file extensions this processor should handle
	FileExtensions []string

	// FileNames are specific files this processor should handle
	FileNames []string

	// IsPreCodegenProcessor denotes whether or not the given processor should
	// be ran before codegen starts.
	IsPreCodegenProcessor bool

	// IsPostCodegenProcessor denotes whether or not the given processor
	// should be ran after the codegen stage of bootstrap. The main difference
	// between running a processor during the codegen stage and after the
	// codegen stage are the files each touches, respectively. The codegen
	// processors will only touch non-static files generated by bootstrap,
	// whereas post-codegen processors will touch every file of the repository,
	// regardless of whether or not it was generated by bootstrap or not.
	// Template does not get passed to Process function (see Processor
	// interface) when this bool is set to true.
	IsPostCodegenProcessor bool

	// RerunCodegen denotes that after all of the processors have ran post-codegen,
	// rerun codegen. This will only fire if IsPostCodegenProcessor is also true.
	RerunCodegen bool

	// VersionGate denotes the version at which the processor should be ran and
	// implies that any versions before this version should also be ran on. For
	// example, if VersionGate was 8.1.4, the processor would be ran on all
	// previous versions of bootstrap (what is found in bootstrap.lock before
	// codegen begins) <= 8.1.4. It would not be ran on versions > 8.1.4.
	//
	// This also implies that if the previous version (what is found in bootstrap.lock
	// before codegen begins) is nil (which is the case when a repository is freshly
	// bootstrapped), the processor will not run as it shouldn't have any anything to
	// migrate on a fresh repository.
	VersionGate *semver.Version
}

type File struct {
	io.Reader

	Name string
}

type Processor interface {
	// Register configures this processor.
	Register() *Config

	// Config returns the config set on the processor, usually set by Register.
	Config() *Config

	// Process process a file and returns it
	Process(*File, *File) (*File, error)
}

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