Stanislav Erokhin
58 lines
1.1 KiB
Markdown
Vendored
58 lines
1.1 KiB
Markdown
Vendored
Several directives can be added in the beginning of a test file in the syntax:
|
|
|
|
`// !DIRECTIVE`
|
|
|
|
## Directives:
|
|
|
|
### 1. DIAGNOSTICS
|
|
|
|
Must be
|
|
|
|
'([ + - ! ] DIAGNOSTIC_FACTORY_NAME | ERROR | WARNING | INFO ) +'
|
|
|
|
where
|
|
|
|
* `'+'` means 'include';
|
|
* `'-'` means 'exclude';
|
|
* `'!'` means 'exclude everything but this'.
|
|
|
|
Directives are applied in the order of appearance,
|
|
i.e. `!FOO +BAR` means include only `FOO` and `BAR`.
|
|
|
|
#### Examples:
|
|
|
|
// !DIAGNOSTICS: -WARNING +CAST_NEVER_SUCCEEDS
|
|
|
|
// !DIAGNOSTICS: -UNUSED_EXPRESSION -UNUSED_PARAMETER -UNUSED_VARIABLE
|
|
|
|
|
|
### 2. CHECK_TYPE
|
|
|
|
The directive adds the following declarations to the file:
|
|
|
|
fun <T> checkSubtype(t: T) = t
|
|
|
|
class Inv<T>
|
|
fun <E> Inv<E>._() {}
|
|
infix fun <T> T.checkType(f: Inv<T>.() -> Unit) {}
|
|
|
|
With that, an exact type of an expression can be checked in the following way:
|
|
|
|
fun test(expr: A) {
|
|
expr checkType { _<A>() }
|
|
}
|
|
|
|
#### Usage:
|
|
|
|
// !CHECK_TYPE
|
|
|
|
### 3. FILE
|
|
|
|
The directive let you compose a test consisting of several files in one actual file.
|
|
|
|
#### Usage:
|
|
// FILE: A.java
|
|
/* Java code */
|
|
|
|
// FILE: B.kt
|
|
/* kotlin code */ |