com.facebook.buck.test.selectors

Class PatternTestSelector

java.lang.Object

com.facebook.buck.test.selectors.PatternTestSelector

All Implemented Interfaces:

TestSelector

public class PatternTestSelector
extends Object
implements TestSelector

A TestDescription will match if this selector's class-part is a substring of the TestDescription's full class-name, or if this selector's class-name, when interpreted as a java.util.regex regular-expression, matches the TestDescription's full class-name.

(The same rules apply for the method-name as well. If this selector's class-part or method-part are null, all class-names or method-names will match.)

Method Summary

Modifier and Type	Method and Description
static TestSelector	buildFromSelectorString(String rawSelectorString) Build a PatternTestSelector from the given String.
boolean	containsClassPath(String classPath)
String	getExplanation()
String	getRawSelector()
boolean	isInclusive()
boolean	isMatchAnyClass()
boolean	isMatchAnyMethod()
boolean	matches(TestDescription description) Whether this TestSelector matches the given TestDescription.
boolean	matchesClassName(String className)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

buildFromSelectorString

public static TestSelector buildFromSelectorString(String rawSelectorString)

Build a PatternTestSelector from the given String. Selector strings should be of the form "[is-exclusive][class-part]#[method-part]". If "[is-exclusive]" is a "!" then this selector will exclude tests, otherwise it will include tests.

If the class-part (or method-part) are omitted, then all classes or methods will match. Consequently "#" means "include everything" and "!#" means "exclude everything".

If the selector string doesn't contain a "#" at all, it is interpreted as a class-part.

Parameters:

rawSelectorString - An unparsed selector string.

getRawSelector

public String getRawSelector()

Specified by:

getRawSelector in interface TestSelector

getExplanation

public String getExplanation()

Specified by:

getExplanation in interface TestSelector

isInclusive

public boolean isInclusive()

Specified by:

isInclusive in interface TestSelector

isMatchAnyClass

public boolean isMatchAnyClass()

Specified by:

isMatchAnyClass in interface TestSelector

isMatchAnyMethod

public boolean isMatchAnyMethod()

Specified by:

isMatchAnyMethod in interface TestSelector

matches

public boolean matches(TestDescription description)

Description copied from interface: TestSelector

Whether this TestSelector matches the given TestDescription. A class or method name being null in the TestDescription means that it will match anything.

Specified by:

matches in interface TestSelector

Parameters:

description - the TestDescription to match

Returns:

true if this selector matches the given TestDescription

matchesClassName

public boolean matchesClassName(String className)

Specified by:

matchesClassName in interface TestSelector

Returns:

true if the given className matches this selector

containsClassPath

public boolean containsClassPath(String classPath)

Specified by:

containsClassPath in interface TestSelector

Returns:

true if the given classpath may be required by any classes that matches this selector