1 /*
2 * Copyright (C) 2021 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 package com.android.bedstead.permissions.annotations
17
18 import com.android.bedstead.harrier.annotations.AnnotationPriorityRunPrecedence
19 import com.android.bedstead.harrier.annotations.FailureMode
20 import com.android.bedstead.harrier.annotations.UsesAnnotationExecutor
21 import com.google.auto.value.AutoAnnotation
22
23 /**
24 * Ensure that the given permission is denied before running the test.
25 *
26 *
27 * Note that use of this annotation implies [RequireNotInstantApp] as instant apps are not
28 * able to drop permissions.
29 */
30 @Target(
31 AnnotationTarget.FUNCTION,
32 AnnotationTarget.PROPERTY_GETTER,
33 AnnotationTarget.PROPERTY_SETTER,
34 AnnotationTarget.ANNOTATION_CLASS,
35 AnnotationTarget.CLASS
36 )
37 @Retention(AnnotationRetention.RUNTIME)
38 @UsesAnnotationExecutor(UsesAnnotationExecutor.PERMISSIONS)
39 annotation class EnsureDoesNotHavePermission(
40 vararg val value: String,
41
42 val failureMode: FailureMode = FailureMode.FAIL,
43 /**
44 * Priority sets the order that annotations will be resolved.
45 *
46 *
47 * Annotations with a lower priority will be resolved before annotations with a higher
48 * priority.
49 *
50 *
51 * If there is an order requirement between annotations, ensure that the priority of the
52 * annotation which must be resolved first is lower than the one which must be resolved later.
53 *
54 *
55 * Priority can be set to a [AnnotationPriorityRunPrecedence] constant, or to any [int].
56 */
57 val priority: Int = AnnotationPriorityRunPrecedence.MIDDLE
58 )
59
60 @AutoAnnotation
ensureDoesNotHavePermissionnull61 fun ensureDoesNotHavePermission(value: Array<String>): EnsureDoesNotHavePermission {
62 return AutoAnnotation_EnsureDoesNotHavePermissionKt_ensureDoesNotHavePermission(value)
63 }
64