SLF4J Test

A test implementation of SLF4J that stores log messages in memory and provides methods for retrieving them. This implementation supports all versions of SLF4J including 1.8.X which have a new binding mechanism.

Installation

The easiest way is to include it in your project(s) by ways of a Maven dependency. Binary, Sources and Javadocs are all available from Maven Central.

<dependency>
    <groupId>com.github.valfirst</groupId>
    <artifactId>slf4j-test</artifactId>
    <version>3.0.1</version>
</dependency>

Compatibility Matrix

`org.slf4j:slf4j-api`	`com.github.valfirst:slf4j-test`
`1.8.0-beta0` - `2.0.0-alpha2`	`1.3.0` - `2.3.0`
`2.0.0-alpha3` - `2.0.0-alpha5`	`2.4.0` - `2.4.1`
`2.0.0-alpha6` - `2.0.16`	`2.5.0` - `3.0.1`

JUnit 5 Support

Declarative Extension Registration

SLF4J Test provides JUnit Platform extension which can registered via annotation:

import org.junit.jupiter.api.extension.ExtendWith;
import com.github.valfirst.slf4jtest.TestLoggerFactoryExtension;

@ExtendWith(TestLoggerFactoryExtension.class)
class BasicJUnit5Test {
   ...
}

Automatic Extension Registration

SLF4J Test supports automatic extension registration via ServiceLoader mechanism. This feature is considered advanced in JUnit Platform and it requires explicit enabling.

Documentation

See https://valfirst.github.io/slf4j-test/ for details.

Credits

This project is based on the original implementation by Robert Elliot, located at https://github.com/Mahoney/slf4j-test which worked with SLF4J prior to version 1.8.X.

valfirst / slf4j-test

readme