testplan

Documentation

Overview

Package testplan contains the main application code for the testplan tool.

Copyright 2023 The Chromium Authors Use of this source code is governed by a BSD-style license that can be found in the LICENSE file.

Index

• func FindRelevantPlans(ctx context.Context, changeRevs []*gerrit.ChangeRev, ...) ([]*plan.SourceTestPlan, error)
• func Generate(ctx context.Context, planFilenames []string, ...) ([]*test_api_v1.HWTestPlan, []*test_api_v1.VMTestPlan, error)
• func NewValidator(gerritClient gerrit.Client, bbClient bbpb.BuildsClient, gsClient gs.Client, ...) *validator

Functions

func FindRelevantPlans

func FindRelevantPlans(
	ctx context.Context,
	changeRevs []*gerrit.ChangeRev,
	workdirFn computemapping.WorkdirCreation,
	cloneDepth time.Duration,
) ([]*plan.SourceTestPlan, error)

func Generate

func Generate(
	ctx context.Context,
	planFilenames []string,
	buildMetadataList *buildpb.SystemImage_BuildMetadataList,
	dutAttributeList *testpb.DutAttributeList,
	configBundleList *payload.ConfigBundleList,
	planToTemplateParametersList map[string][]*plan.SourceTestPlan_TestPlanStarlarkFile_TemplateParameters,
) ([]*test_api_v1.HWTestPlan, []*test_api_v1.VMTestPlan, error)

Generate evals the Starlark files in planFilenames to produce a list of HWTestPlans and VMTestPlans.

planFilenames must be non-empty. buildMetadataList, dutAttributeList, and configBundleList must be non-nil.

All keys in planToTemplateParametersList must be in planFilenames. If a plan does have a list of TemplateParameters, the plan will be evaluated once for each of the TemplateParameters.

func NewValidator

func NewValidator(gerritClient gerrit.Client, bbClient bbpb.BuildsClient, gsClient gs.Client, cmdRunner cmd.CommandRunner) *validator

NewValidator returns a validator with default configuration, which can be used to validate ChromeOS test configs in dirmd.Mappings.