TestMapping

public class TestMapping
extends Object

java.lang.Object
↳	com.android.tradefed.util.testmapping.TestMapping

A class for loading a TEST_MAPPING file.

Summary

Fields
`public static final Pattern`	`MAINLINE_REGEX`
`public static final String`	`TEST_MAPPINGS_ZIP`
`public static final String`	`TEST_SOURCES`

Public constructors
`TestMapping()` Constructor to initialize an empty `TestMapping` object.
`TestMapping( testMappingRelativePaths, boolean ignoreTestMappingImports)` Constructor to create a `TestMapping` object.

Public methods
`static File`	`extractTestMappingsZip(File testMappingsZip)` Extract a zip file and return the directory that contains the content of unzipped files.
	`getAllTests(File testMappingsDir)` Helper to find all tests in the TEST_MAPPING files from a given directory.
`static Matcher`	`getMainlineTestModuleName(TestInfo info)` Helper to get the matcher for parameterized mainline tests.
	`getTests(IBuildInfo buildInfo, String testGroup, boolean hostOnly, keywords, ignoreKeywords)` Helper to find all tests in all TEST_MAPPING files based on an artifact in the device build.
	`getTests(IBuildInfo buildInfo, String testGroup, boolean hostOnly, keywords, ignoreKeywords, extraZipNames, matchedPatternPaths)` Helper to find all tests in all TEST_MAPPING files based on the given artifact.
`void`	`listTestMappingFiles(Path testMappingDir, Path testMappingsRootDir, filePaths)` Helper to list all test mapping files, look for all parent directories and related import paths.

Fields

MAINLINE_REGEX

public static final Pattern MAINLINE_REGEX

TEST_MAPPINGS_ZIP

public static final String TEST_MAPPINGS_ZIP

TEST_SOURCES

public static final String TEST_SOURCES

Public constructors

TestMapping

public TestMapping ()

Constructor to initialize an empty TestMapping object.

TestMapping

public TestMapping ( testMappingRelativePaths, 
                boolean ignoreTestMappingImports)

Constructor to create a TestMapping object.

Parameters
`testMappingRelativePaths`	: The `ERROR(/List)` to the TEST_MAPPING file paths.
`ignoreTestMappingImports`	`boolean`: The `ERROR(/boolean)` to ignore imports.

Public methods

extractTestMappingsZip

public static File extractTestMappingsZip (File testMappingsZip)

Extract a zip file and return the directory that contains the content of unzipped files.

Parameters
`testMappingsZip`	`File`: A `ERROR(/File)` of the test mappings zip to extract.

Returns
`File`	a `ERROR(/File)` pointing to the temp directory for test mappings zip.

getAllTests

public  getAllTests (File testMappingsDir)

Helper to find all tests in the TEST_MAPPING files from a given directory.

Parameters
`testMappingsDir`	`File`: the `ERROR(/File)` the directory containing all Test Mapping files.

Returns
	A `Map<String, Set<TestInfo>>` of tests in the given directory and its child directories.

getMainlineTestModuleName

public static Matcher getMainlineTestModuleName (TestInfo info)

Helper to get the matcher for parameterized mainline tests.

Parameters
`info`	`TestInfo`

Returns
`Matcher`	A `ERROR(/Matcher)` for parameterized mainline tests.

Throws
`ConfigurationException`

getTests

public  getTests (IBuildInfo buildInfo, 
                String testGroup, 
                boolean hostOnly, 
                 keywords, 
                 ignoreKeywords)

Helper to find all tests in all TEST_MAPPING files based on an artifact in the device build.

Parameters
`buildInfo`	`IBuildInfo`: the `IBuildInfo` describing the build.
`testGroup`	`String`: a `String` of the test group.
`hostOnly`	`boolean`: true if only tests running on host and don't require device should be returned. false to return tests that require device to run.
`keywords`	: A set of `String` to be matched when filtering tests to run in a Test Mapping suite.
`ignoreKeywords`	: A set of `String` of keywords to be ignored.

Returns
	A `Set<TestInfo>` of tests set in the build artifact, test_mappings.zip.

getTests

public  getTests (IBuildInfo buildInfo, 
                String testGroup, 
                boolean hostOnly, 
                 keywords, 
                 ignoreKeywords, 
                 extraZipNames, 
                 matchedPatternPaths)

Helper to find all tests in all TEST_MAPPING files based on the given artifact. This is needed when a suite run requires to run all tests in TEST_MAPPING files for a given group, e.g., presubmit.

Parameters
`buildInfo`	`IBuildInfo`: the `IBuildInfo` describing the build.
`testGroup`	`String`: a `String` of the test group.
`hostOnly`	`boolean`: true if only tests running on host and don't require device should be returned. false to return tests that require device to run.
`keywords`	: A set of `String` to be matched when filtering tests to run in a Test Mapping suite.
`ignoreKeywords`	: A set of `String` of keywords to be ignored.
`extraZipNames`	: A set of `String` for the name of additional test_mappings.zip that will be merged.
`matchedPatternPaths`	: The `ERROR(/Set)` to file paths matched patterns.

Returns
	A `Set<TestInfo>` of tests set in the build artifact, test_mappings.zip.

listTestMappingFiles

public void listTestMappingFiles (Path testMappingDir, 
                Path testMappingsRootDir, 
                 filePaths)

Helper to list all test mapping files, look for all parent directories and related import paths.

Parameters
`testMappingDir`	`Path`: The `ERROR(/Path)` to a TEST_MAPPING file parent directory.
`testMappingsRootDir`	`Path`: The `ERROR(/Path)` to the folder of all TEST_MAPPING files for a build.
`filePaths`	: A `ERROR(/Set)` to store all TEST_MAPPING paths.