1 /*
2  * Copyright (C) 2008 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 package android.test;
18 
19 import java.lang.annotation.Retention;
20 import java.lang.annotation.RetentionPolicy;
21 import java.lang.annotation.Target;
22 import java.lang.annotation.ElementType;
23 
24 /**
25  * This annotation can be used on an {@link android.test.InstrumentationTestCase}'s
26  * test methods. When the annotation is present, the test method is re-executed if
27  * the test fails. The total number of executions is specified by the tolerance and
28  * defaults to 1.
29  */
30 @Target(ElementType.METHOD)
31 @Retention(RetentionPolicy.RUNTIME)
32 public @interface FlakyTest {
33     /**
34      * Indicates how many times a test can run and fail before being reported
35      * as a failed test. If the tolerance factor is less than 1, the test runs
36      * only once.
37      *
38      * @return The total number of allowed run, the default is 1.
39      */
tolerance()40     int tolerance() default 1;
41 }
42