Question 1

How to install Atrium in a Kotlin multiplatform project?

Accepted Answer

Add the dependency 'ch.tutteli.atrium:atrium-fluent:1.2.0' to your commonTest source set in build.gradle.kts, as shown in the README. For Kotlin 1.5+, it automatically targets platforms, but pre-1.5 requires platform-specific artifacts.

Question 2

Atrium vs Kotest assertions: which is better?

Accepted Answer

Atrium focuses on fluent, multiplatform expectations with detailed failure reporting, while Kotest offers a broader testing framework including property-based testing. Atrium is ideal if you need expressive assertions across JVM, JS, and Android.

Question 3

How to write a custom expectation function in Atrium?

Accepted Answer

Use the extensibility API to define functions based on boolean checks or throwables. The README provides examples under 'Write own Expectation Functions', such as using _logic.extractFeature for safe feature extraction.

Question 4

Does Atrium support soft assertions like AssertJ?

Accepted Answer

Yes, Atrium provides expectation groups via the 'expect' block syntax, evaluating multiple expectations together and reporting all failures, similar to AssertJ's soft assertions, as explained in the soft-expectations section.

Question 5

How to test exception throwing with Atrium?

Accepted Answer

Use the 'toThrow' function on a lambda, e.g., 'expect { ... }.toThrow<IllegalArgumentException>()'. You can add sub-expectations on exception properties like message, as shown in the exception expectations examples.

Question 6

What are the minimum Kotlin and JVM versions for Atrium?

Accepted Answer

Atrium requires Kotlin 1.4 or higher, JVM 11, and the JS IR backend. Support for legacy JS backend was dropped in version 1.2.0, so ensure your project meets these requirements.

Atrium

What is Atrium?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Open Source Alternative To

Frequently Asked Questions