Documentation
¶
Index ¶
- Constants
- Variables
- func AssertBranchesDoNotExist(branches []ProjectBranch, workerCount int) error
- func BranchExists(branchPattern *regexp.Regexp, buildNumber string, branchType string, ...) (bool, error)
- func BranchType(release, factory, firmware, stabilize bool, custom string) (string, bool)
- func BumpForCreate(componentToBump chromeos_version.VersionComponent, release, push bool, ...) error
- func CheckIfAlreadyBranched(vinfo mv.VersionInfo, manifestInternal repo.Project, force bool, ...) error
- func CheckSelfGroupMembership(authedClient *http.Client, gerritUrl, expectedGroup string) (bool, error)
- func CreateRemoteBranches(branches []ProjectBranch, dryRun, force bool, workerCount int) error
- func CreateRemoteBranchesApi(authedClient *http.Client, branches []GerritProjectBranch, dryRun bool, ...) error
- func GetProjectCheckout(projectPath string, opts *CheckoutOptions) (string, error)
- func InitWorkingManifest(manifestUrl, br string) error
- func LogErr(format string, a ...interface{})
- func LogOut(format string, a ...interface{})
- func NewBranchName(vinfo mv.VersionInfo, custom, descriptor string, ...) string
- func ProjectFetchUrl(projectPath string) (string, error)
- func RepairManifestRepositories(branches []ProjectBranch, dryRun, force bool) error
- func WhichVersionShouldBump(vinfo mv.VersionInfo) (mv.VersionComponent, error)
- type CheckoutOptions
- type GerritProjectBranch
- type ManifestRepo
- type ProjectBranch
Constants ¶
const VersionFileProjectPath = "src/third_party/chromiumos-overlay"
Variables ¶
var ( StdoutLog *log.Logger StderrLog *log.Logger WorkingManifest repo.Manifest RepoToolPath string ManifestCheckout string )
var ( ManifestProjects = map[string]bool{ "chromiumos/manifest": true, "chromeos/manifest-internal": true, } // A Chrome OS branch name as a prefix to a string, starting with a dash. // e.g. -release-R77-12371.B BranchPrefix = regexp.MustCompile("^-.*[.]B") )
Functions ¶
func AssertBranchesDoNotExist ¶
func AssertBranchesDoNotExist(branches []ProjectBranch, workerCount int) error
AssertBranchesDoNotExist checks that branches do not already exist.
func BranchExists ¶
func BranchExists(branchPattern *regexp.Regexp, buildNumber string, branchType string, remoteBranches []string) (bool, error)
BranchExists checks that a branch matching the given pattern exists in a particular project.
func BranchType ¶
BranchType determines the type of branch to be created.
func BumpForCreate ¶
func BumpForCreate(componentToBump chromeos_version.VersionComponent, release, push bool, branchName, sourceUpstream string) error
BumpForCreate bumps the version in chromeos_version.sh, as needed, in the source branch for a branch creation command.
func CheckIfAlreadyBranched ¶
func CheckIfAlreadyBranched(vinfo mv.VersionInfo, manifestInternal repo.Project, force bool, branchType string) error
CheckIfAlreadyBranched checks if there's already a branch for the desired new branch to create on the manifest-internal repo.
func CheckSelfGroupMembership ¶
func CheckSelfGroupMembership(authedClient *http.Client, gerritUrl, expectedGroup string) (bool, error)
CheckSelfGroupMembership checks if the authenticated user is in the given group on the given Gerrit host. It returns a bool indicating whether or not that's the case, or an error if the lookup fails.
func CreateRemoteBranches ¶
func CreateRemoteBranches(branches []ProjectBranch, dryRun, force bool, workerCount int) error
CreateRemoteBranches makes the requested branches on the remote Gerrit hosts using git checkouts and pushes.
func CreateRemoteBranchesApi ¶
func CreateRemoteBranchesApi(authedClient *http.Client, branches []GerritProjectBranch, dryRun bool, gerritQps float64) error
CreateRemoteBranches creates a bunch of branches on remote Gerrit instances for the specified inputs using the Gerrit API.
func GetProjectCheckout ¶
func GetProjectCheckout(projectPath string, opts *CheckoutOptions) (string, error)
GetProjectCheckout gets a local checkout of a particular project.
func InitWorkingManifest ¶
InitWorkingManifest initializes a local working manifest (a.k.a. buildspec) from a Gerrit path.
func NewBranchName ¶
func NewBranchName(vinfo mv.VersionInfo, custom, descriptor string, release, factory, firmware, stabilize bool) string
Determine the name for a new branch. By convention, standard branch names must end with the stripped version string from which they were created, followed by '.B'.
For example:
- A branch created from 1.0.0 must end with -1.B
- A branch created from 1.2.0 must end with -1.2.B
Release branches have a slightly different naming scheme. They include
the milestone from which they were created. Example: release-R12-1.2.B
func ProjectFetchUrl ¶
ProjectFetchUrl returns the fetch URL for a remote Project.
func RepairManifestRepositories ¶
func RepairManifestRepositories(branches []ProjectBranch, dryRun, force bool) error
RepairManifestRepositories repairs all manifests in all manifest repositories on the current branch and commits the changes. It then pushes the state of the local git branches to remote.
func WhichVersionShouldBump ¶
func WhichVersionShouldBump(vinfo mv.VersionInfo) (mv.VersionComponent, error)
WhichVersionShouldBump returns which version is incremented by builds on a new branch.
Types ¶
type CheckoutOptions ¶
type CheckoutOptions struct {
// If set, will get only this Ref.
// If not set, will get the full repo.
Ref string
// To be used with the git clone --depth flag.
Depth int
}
CheckoutOptions describes how to check out a Git repo.
type GerritProjectBranch ¶
GerritProjectBranch contains all the details for creating a new Gerrit branch based on an existing one.
func GerritProjectBranches ¶
func GerritProjectBranches(pbs []ProjectBranch) ([]GerritProjectBranch, error)
GerritProjectBranches creates a slice of GerritProjectBranch objects, which are representations of ProjectBranches that are useful for API based branching.
func GetNonManifestBranches ¶
func GetNonManifestBranches(branches []GerritProjectBranch) []GerritProjectBranch
GetNonManifestBranches filters out non-Manifest branches.
type ManifestRepo ¶
func (*ManifestRepo) RepairManifestsOnDisk ¶
func (m *ManifestRepo) RepairManifestsOnDisk(branchesByPath map[string]string) error
RepairManifestsOnDisk repairs the revision and upstream attributes of manifest elements on disk for the given projects.
type ProjectBranch ¶
ProjectBranch is a project and a branch.
func ProjectBranches ¶
func ProjectBranches(br, original string) []ProjectBranch
ProjectBranches returns a list of ProjectBranch structs: one for each branchable project. The original parameter is the CrOS branch from which the current checkout stems.
Source Files