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 dalvik.annotation; 18 19 /** 20 * Defines an enumeration of possible states a test case can be in. 21 * 22 * @since Android 1.0 23 * @hide 24 */ 25 public enum TestLevel { 26 27 /** 28 * Indicates that a test method completely tests its target API method. 29 */ 30 COMPLETE, 31 32 /** 33 * Indicates that a test method partially tests its target API method and 34 * that together with all other {@code PARTIAL_COMPLETE} tests for the same 35 * method it is sufficient. 36 */ 37 PARTIAL_COMPLETE, 38 39 /** 40 * Just for compatibility purposes, will be removed later. 41 */ 42 PARTIAL_OK, 43 44 /** 45 * Indicates that a test method partially tests its target API method. It 46 * needs a second review phase to find out if the sum of all partial tests 47 * is sufficient for completely testing the target API method. If yes, the 48 * level has to be changed to {@code PARTIAL_COMPLETE}. 49 */ 50 PARTIAL, 51 52 /** 53 * Indicates that a test method is known to not completely test an API 54 * method but the missing test steps are too complex and costly to 55 * implement. This level is positioned somewhere between {@code PARTIAL} 56 * and {@code COMPLETE}. 57 */ 58 SUFFICIENT, 59 60 /** 61 * Indicates that a test method provides additional testing for an API 62 * method for which there already exists one {@code COMPLETE} or a set of 63 * {@code PARTIAL_COMPLETE} tests. This level may also be used for test 64 * methods that test a concept which can not be directly attributed to 65 * the specification of an API method or class. 66 */ 67 ADDITIONAL, 68 69 /** 70 * Indicates that there is nothing to test in an API method, for example if 71 * the specification states that a method does nothing. 72 */ 73 NOT_NECESSARY, 74 75 /** 76 * Indicates that it is very hard or impossible to test an API method. 77 */ 78 NOT_FEASIBLE, 79 80 /** 81 * Indicates that the tests is either insufficient or wrong. Something needs 82 * to be done about it. 83 */ 84 TODO, 85 86 } 87