bisection

Documentation

Overview

Package bisection performs bisection for test failures.

Index

• func CreateSnapshot(ctx context.Context, nsa *model.TestNthSectionAnalysis) (*nthsectionsnapshot.Snapshot, error)
• func CreateTestRerunModel(ctx context.Context, options CreateRerunModelOptions) (*model.TestSingleRerun, error)
• func GetProjectBisector(ctx context.Context, tfa *model.TestFailureAnalysis) (projectbisector.ProjectBisector, error)
• func IsEnabled(ctx context.Context, project string) (bool, error)
• func RegisterTaskClass(srv *server.Server, luciAnalysisProjectFunc func(luciProject string) string) error
• func Run(ctx context.Context, analysisID int64, luciAnalysis analysis.AnalysisClient, ...) (reterr error)
• func SaveNthSectionAnalysis(ctx context.Context, nsa *model.TestNthSectionAnalysis, ...) error
• func SaveSuspectAndTriggerCulpritVerification(ctx context.Context, tfa *model.TestFailureAnalysis, ...) error
• func Schedule(ctx context.Context, analysisID int64) error
• func TriggerRerunBuildForCommits(ctx context.Context, tfa *model.TestFailureAnalysis, ...) error
• type CreateRerunModelOptions

Functions

func CreateSnapshot

func CreateSnapshot(ctx context.Context, nsa *model.TestNthSectionAnalysis) (*nthsectionsnapshot.Snapshot, error)

func CreateTestRerunModel

func CreateTestRerunModel(ctx context.Context, options CreateRerunModelOptions) (*model.TestSingleRerun, error)

func GetProjectBisector

func GetProjectBisector(ctx context.Context, tfa *model.TestFailureAnalysis) (projectbisector.ProjectBisector, error)

func IsEnabled

func IsEnabled(ctx context.Context, project string) (bool, error)

func RegisterTaskClass

func RegisterTaskClass(srv *server.Server, luciAnalysisProjectFunc func(luciProject string) string) error

RegisterTaskClass registers the task class for tq dispatcher.

func Run

func Run(ctx context.Context, analysisID int64, luciAnalysis analysis.AnalysisClient, maxRerun int) (reterr error)

Run runs bisection for the given analysisID. maxRerun controls how many reruns we can do at once. maxRerun = 1 means bisection, maxRerun = 2 means trisection...

func SaveNthSectionAnalysis

func SaveNthSectionAnalysis(ctx context.Context, nsa *model.TestNthSectionAnalysis, updateFunc func(*model.TestNthSectionAnalysis)) error

SaveNthSectionAnalysis updates nthsection analysis in a way that avoid race condition if another thread also update the analysis.

func SaveSuspectAndTriggerCulpritVerification

func SaveSuspectAndTriggerCulpritVerification(ctx context.Context, tfa *model.TestFailureAnalysis, nsa *model.TestNthSectionAnalysis, commit *pb.BlameListSingleCommit) error

func Schedule

func Schedule(ctx context.Context, analysisID int64) error

Schedule enqueues a task to perform bisection.

func TriggerRerunBuildForCommits

func TriggerRerunBuildForCommits(ctx context.Context, tfa *model.TestFailureAnalysis, nsa *model.TestNthSectionAnalysis, projectBisector projectbisector.ProjectBisector, commitHashes []string, option projectbisector.RerunOption) error

Types

type CreateRerunModelOptions

type CreateRerunModelOptions struct {
	TestFailureAnalysis   *model.TestFailureAnalysis
	NthSectionAnalysisKey *datastore.Key
	SuspectKey            *datastore.Key
	TestFailures          []*model.TestFailure
	Build                 *bbpb.Build
	RerunType             model.RerunBuildType
}