KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #ai-agent #developer-tools #claude-code #codex #deepseek-harness #ai-agents #react #mcp #rust

loom-unit

★ 41 Open GitHub ↗

A Junit5 Extension to check if virtual threads are pinning the carrier thread

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Loom-Unit

A Junit 5 extension capturing weather a virtual threads _pins_ the carrier thread during the execution of the test.

![GitHub Workflow Status](https://img.shields.io/github/workflow/status/cescoffier/loom-unit/Build?style=for-the-badge) ![Maven Central](https://img.shields.io/maven-central/v/me.escoffier.loom/loom-unit?style=for-the-badge)

## Usage

1. Add the following dependency to your project:

```xml
<dependency>    
  <groupId>me.escoffier.loom</groupId>
  <artifactId>loom-unit</artifactId>
  <version>VERSION</version>
  <scope>test</scope>  
</dependency>
```

**IMPORTANT**: You need to use Java 19+.

2. Extends your test class with the `me.escoffier.loom.loomunit.LoomUnitExtension` extension:

```java
@ExtendWith(LoomUnitExtension.class) 
public class LoomUnitExampleTest {
    // ...
}
```

3. Use the `me.escoffier.loom.loomunit.ShouldNotPin` or `me.escoffier.loom.loomunit.ShouldPin` annotation on your test.

## Complete example

```java
package me.escoffier.loom.loomunit.snippets;
import me.escoffier.loom.loomunit.LoomUnitExtension;
import me.escoffier.loom.loomunit.ThreadPinnedEvents;
import me.escoffier.loom.loomunit.ShouldNotPin;
import me.escoffier.loom.loomunit.ShouldPin;
import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;

import static org.awaitility.Awaitility.await;

@ExtendWith(LoomUnitExtension.class) // Use the extension
public class LoomUnitExampleTest {

CodeUnderTest codeUnderTest = new CodeUnderTest();

@Test
    @ShouldNotPin
    public void testThatShouldNotPin() {
        // ...
    }

@Test
    @ShouldPin(atMost = 1)
    public void testThatShouldPinAtMostOnce() {
        codeUnderTest.pin();
    }

@Test
    public void testThatShouldNotPin(ThreadPinnedEvents events) { // Inject an object to check the pin events
        Assertions.assertTrue(events.getEvents().isEmpty());
        codeUnderTest.pin();
        await().until(() -> events.getEvents().size() > 0);
        Assertions.assertEquals(events.getEvents().size(), 1);
    }

}
```

You can also use the `@ShouldPin` and `@ShouldNotPin` annotations on the class:

```java
@ExtendWith(LoomUnitExtension.class) // Use the extension
@ShouldNotPin // You can use @ShouldNotPin or @ShouldPin on the class itself, it's applied to each method.
public class LoomUnitExampleOnClassTest {

CodeUnderTest codeUnderTest = new CodeUnderTest();

@Test
	public void testThatShouldNotPin() {
		// ...
	}

@Test
	@ShouldPin(atMost = 1) // Method annotation overrides the class annotation
	public void testThatShouldPinAtMostOnce() {
		codeUnderTest.pin();
	}

}
```

loom-unit

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README