1adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project/* 2adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 3adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 4adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 5adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * you may not use this file except in compliance with the License. 6adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * You may obtain a copy of the License at 7adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 8adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 9adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 10adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Unless required by applicable law or agreed to in writing, software 11adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 12adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * See the License for the specific language governing permissions and 14adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * limitations under the License. 15adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 16adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 17adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectpackage dalvik.annotation; 18adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 19adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project/** 20adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Defines an enumeration of possible states a test case can be in. 21f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 22adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @hide 23adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 24adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectpublic enum TestLevel { 25f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes 26adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 27adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Indicates that a test method completely tests its target API method. 28f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes */ 29adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project COMPLETE, 30f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes 31adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 32adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Indicates that a test method partially tests its target API method and 33adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * that together with all other {@code PARTIAL_COMPLETE} tests for the same 34adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * method it is sufficient. 35adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 36adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project PARTIAL_COMPLETE, 37adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 38adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 39adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Just for compatibility purposes, will be removed later. 40adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 41adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project PARTIAL_OK, 42f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes 43adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 44adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Indicates that a test method partially tests its target API method. It 45adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * needs a second review phase to find out if the sum of all partial tests 46adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * is sufficient for completely testing the target API method. If yes, the 47adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * level has to be changed to {@code PARTIAL_COMPLETE}. 48adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 49f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes PARTIAL, 50f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes 51adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 52adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Indicates that a test method is known to not completely test an API 53adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * method but the missing test steps are too complex and costly to 54adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * implement. This level is positioned somewhere between {@code PARTIAL} 55adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * and {@code COMPLETE}. 56adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 57adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project SUFFICIENT, 58f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes 59adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 60adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Indicates that a test method provides additional testing for an API 61f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * method for which there already exists one {@code COMPLETE} or a set of 62adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@code PARTIAL_COMPLETE} tests. This level may also be used for test 63f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * methods that test a concept which can not be directly attributed to 64adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the specification of an API method or class. 65adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 66f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes ADDITIONAL, 67f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes 68adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 69adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Indicates that there is nothing to test in an API method, for example if 70adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the specification states that a method does nothing. 71adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 72adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project NOT_NECESSARY, 73f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes 74adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 75adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Indicates that it is very hard or impossible to test an API method. 76adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 77adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project NOT_FEASIBLE, 78f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes 79adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 80adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Indicates that the tests is either insufficient or wrong. Something needs 81adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * to be done about it. 82adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 83adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project TODO, 84f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes 85adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project} 86