Files
kotlin/libraries/kotlin.test/Module.md
2020-09-11 18:20:37 +03:00

32 lines
1.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Module kotlin.test
## kotlin.test
The `kotlin.test` library provides [annotations](kotlin.test/index.html#annotations) to mark test functions and a set of [utility functions](kotlin.test/index.html#functions) for performing assertions in tests,
independently of the test framework being used.
The test framework is abstracted through the [Asserter][kotlin.test.Asserter] class.
A basic `Asserter` implementation is provided out of the box.
Note that the class is not intended to be used directly from tests,
use instead the top-level assertion functions which delegate to the `Asserter`.
The library consists of the modules:
- `kotlin-test-common` assertions for use in common code;
- `kotlin-test-annotations-common` test annotations for use in common code;
- `kotlin-test` a JVM implementation of assertions from `kotlin-test-common`;
- `kotlin-test-junit` provides an implementation of [Asserter] on top of JUnit
and maps the test annotations from `kotlin-test-annotations-common` to JUnit test annotations;
- `kotlin-test-junit5` provides an implementation of [Asserter] on top of JUnit 5
and maps the test annotations from `kotlin-test-annotations-common` to JUnit 5 test annotations;
- `kotlin-test-testng` provides an implementation of [Asserter] on top of TestNG
and maps the test annotations from `kotlin-test-annotations-common` to TestNG test annotations;
- `kotlin-test-js` a JS implementation of common test assertions and annotations
with the out-of-the-box support for [Jasmine](https://jasmine.github.io/), [Mocha](https://mochajs.org/),
and [Jest](https://facebook.github.io/jest/) testing frameworks, and an experimental way to plug in
a custom unit testing framework.
# Package kotlin.test
Annotations to mark test functions and top-level functions for performing assertions in tests.