updater

type DefaultUpdateBranchNamer struct{}

type Dependency struct {
	// Path is the name of the dependency.
	Path    string
	Version string
	// Indirect indicates this dependency is only required by a dependency of the target project.
	Indirect bool
}

type ExistingUpdate struct {
	// Is this update still in a proposed state?
	Open bool
	// If not open, was this update accepted?
	Merged     bool
	BaseBranch string
	LastUpdate time.Time
	Group      UpdateGroup
}

type ExistingUpdates []ExistingUpdate

type Factory interface {
	NewUpdater(root string) Updater
}

type Group struct {
	// Identify the group and members:
	// Name labels unique groups
	Name string `yaml:"name"`
	// Pattern is a prefix for the dependency, or a regular expression enclosed by /'s
	Pattern string `yaml:"pattern"`

	// Parameters that apply to members:
	// Range is a comma separated list of allowed semver ranges
	Range      string `yaml:"range"`
	CoolDown   string `yaml:"cooldown"`
	PreScript  string `yaml:"pre-script"`
	PostScript string `yaml:"post-script"`
	// contains filtered or unexported fields
}

type Groups []*Group

type Repo interface {
	// Root returns the working tree root.
	// This should minimally contain go.{mod,sum}. Vendoring or major updates require the full tree.
	Root() string
	// SetBranch changes to an existing branch.
	SetBranch(branch string) error
	// NewBranch creates and changes to a new branch.
	NewBranch(base, branch string) error
	// Branch returns the current branch.
	Branch() string
	// Push snapshots the working tree after an update has been applied, and "publishes".
	// This is branch to commit. Publishing may mean push, create a PR, tweet the maintainer, whatever.
	Push(context.Context, UpdateGroup) error
	// Fetch loads a remote ref without updating the working copy.
	Fetch(ctx context.Context, branch string) error
	// ExistingUpdates returns the state of recent updates
	ExistingUpdates(ctx context.Context, baseBranch string) (ExistingUpdates, error)
}

type RepoUpdater struct {
	Updater Updater
	// contains filtered or unexported fields
}

type RepoUpdaterOpt func(*RepoUpdater)

type SignedUpdateGroup struct {
	Updates   UpdateGroup `json:"signed"`
	Signature []byte      `json:"signature"`
}

type Update struct {
	// Path of module being updated
	Path string `json:"path"`
	// Previous module version
	Previous string `json:"previous"`
	// Next module version
	Next string `json:"next"`
}

type UpdateBranchNamer interface {
	// Format generates branch name for an update
	Format(baseBranch string, update Update) string
	// Format generates branch name for batch of updates
	FormatBatch(baseBranch, batchName string) string
}

type UpdateGroup struct {
	Name    string   `json:"name,omitempty"`
	Updates []Update `json:"updates"`
}

type Updater interface {
	Name() string
	Dependencies(context.Context) ([]Dependency, error)
	Check(ctx context.Context, dep Dependency, filter func(string) bool) (*Update, error)
	ApplyUpdate(context.Context, Update) error
}