Provide mechanism for managing resources across engines and executions

junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/ExtensionContext.java

@@ -418,6 +418,28 @@ default void publishReportEntry(String value) {
 	 */
 	Store getStore(Namespace namespace);
 
+	/**
+	 * Returns the store for session-level data.
+	 *
+	 * <p>This store is used to store data that is scoped to the session level.
+	 * The data stored in this store will be available throughout the entire session.
+	 *
+	 * @return the store for session-level data
+	 * @since 5.13
+	 */
+	Store getSessionLevelStore();
+
+	/**
+	 * Returns the store for request-level data.
+	 *
+	 * <p>This store is used to store data that is scoped to the request level.
+	 * The data stored in this store will be available only for the duration of the current request.
+	 *
+	 * @return the store for request-level data
+	 * @since 5.13
+	 */
+	Store getRequestLevelStore();
+
 	/**
 	 * Get the {@link ExecutionMode} associated with the current test or container.
 	 *

junit-jupiter-engine/src/main/java/org/junit/jupiter/engine/descriptor/AbstractExtensionContext.java

@@ -192,6 +192,16 @@ public Store getStore(Namespace namespace) {
 		return new NamespaceAwareStore(this.valuesStore, namespace);
 	}
 
+	@Override
+	public Store getSessionLevelStore() {
+		return getStore(Namespace.create("session"));
+	}
+
+	@Override
+	public Store getRequestLevelStore() {
+		return getStore(Namespace.create("request"));
+	}
+
 	@Override
 	public Set<String> getTags() {
 		// return modifiable copy

junit-platform-engine/src/main/java/org/junit/platform/engine/Namespace.java

@@ -0,0 +1,85 @@
+/*
+ * Copyright 2015-2025 the original author or authors.
+ *
+ * All rights reserved. This program and the accompanying materials are
+ * made available under the terms of the Eclipse Public License v2.0 which
+ * accompanies this distribution and is available at
+ *
+ * https://www.eclipse.org/legal/epl-v20.html
+ */
+
+package org.junit.platform.engine;
+
+import static org.apiguardian.api.API.Status.STABLE;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import org.apiguardian.api.API;
+import org.junit.platform.commons.util.Preconditions;
+
+@API(status = STABLE, since = "5.13")
+public class Namespace {
+
+	/**
+	 * The default, global namespace which allows access to stored data from
+	 * all extensions.
+	 */
+	public static final Namespace GLOBAL = Namespace.create(new Object());
+
+	/**
+	 * Create a namespace which restricts access to data to all extensions
+	 * which use the same sequence of {@code parts} for creating a namespace.
+	 *
+	 * <p>The order of the {@code parts} is significant.
+	 *
+	 * <p>Internally the {@code parts} are compared using {@link Object#equals(Object)}.
+	 */
+	public static Namespace create(Object... parts) {
+		Preconditions.notEmpty(parts, "parts array must not be null or empty");
+		Preconditions.containsNoNullElements(parts, "individual parts must not be null");
+		return new Namespace(new ArrayList<>(Arrays.asList(parts)));
+	}
+
+	private final List<Object> parts;
+
+	private Namespace(List<Object> parts) {
+		this.parts = parts;
+	}
+
+	@Override
+	public boolean equals(Object o) {
+		if (this == o) {
+			return true;
+		}
+		if (o == null || getClass() != o.getClass()) {
+			return false;
+		}
+		Namespace that = (Namespace) o;
+		return this.parts.equals(that.parts);
+	}
+
+	@Override
+	public int hashCode() {
+		return this.parts.hashCode();
+	}
+
+	/**
+	 * Create a new namespace by appending the supplied {@code parts} to the
+	 * existing sequence of parts in this namespace.
+	 *
+	 * @return new namespace; never {@code null}
+	 * @since 5.8
+	 */
+	@API(status = STABLE, since = "5.13")
+	public Namespace append(Object... parts) {
+		Preconditions.notEmpty(parts, "parts array must not be null or empty");
+		Preconditions.containsNoNullElements(parts, "individual parts must not be null");
+		ArrayList<Object> newParts = new ArrayList<>(this.parts.size() + parts.length);
+		newParts.addAll(this.parts);
+		Collections.addAll(newParts, parts);
+		return new Namespace(newParts);
+	}
+}

junit-platform-engine/src/main/java/org/junit/platform/engine/support/store/NamespacedHierarchicalStore.java

@@ -17,6 +17,7 @@
 
 import java.util.Comparator;
 import java.util.Objects;
+import java.util.Optional;
 import java.util.concurrent.ConcurrentHashMap;
 import java.util.concurrent.ConcurrentMap;
 import java.util.concurrent.atomic.AtomicInteger;
@@ -85,6 +86,18 @@ public NamespacedHierarchicalStore<N> newChild() {
 		return new NamespacedHierarchicalStore<>(this, this.closeAction);
 	}
 
+	/**
+	 * Returns the parent store of this {@code NamespacedHierarchicalStore}.
+	 *
+	 * <p>If this store does not have a parent, an empty {@code Optional} is returned.
+	 *
+	 * @return an {@code Optional} containing the parent store, or an empty {@code Optional} if there is no parent
+	 * @since 5.13
+	 */
+	public Optional<NamespacedHierarchicalStore<N>> getParent() {
+		return Optional.ofNullable(this.parentStore);
+	}
+
 	/**
 	 * Determine if this store has been {@linkplain #close() closed}.
 	 *

junit-platform-launcher/src/main/java/org/junit/platform/launcher/Launcher.java

@@ -13,6 +13,8 @@
 import static org.apiguardian.api.API.Status.STABLE;
 
 import org.apiguardian.api.API;
+import org.junit.platform.engine.Namespace;
+import org.junit.platform.engine.support.store.NamespacedHierarchicalStore;
 
 /**
  * The {@code Launcher} API is the main entry point for client code that
@@ -127,4 +129,5 @@ public interface Launcher {
 	@API(status = STABLE, since = "1.4")
 	void execute(TestPlan testPlan, TestExecutionListener... listeners);
 
+	NamespacedHierarchicalStore<Namespace> getStore(LauncherDiscoveryRequest launcherDiscoveryRequest);
 }

junit-platform-launcher/src/main/java/org/junit/platform/launcher/LauncherSession.java

@@ -13,6 +13,8 @@
 import static org.apiguardian.api.API.Status.STABLE;
 
 import org.apiguardian.api.API;
+import org.junit.platform.engine.Namespace;
+import org.junit.platform.engine.support.store.NamespacedHierarchicalStore;
 import org.junit.platform.launcher.core.LauncherFactory;
 
 /**
@@ -47,4 +49,6 @@ public interface LauncherSession extends AutoCloseable {
 	@Override
 	void close();
 
+	NamespacedHierarchicalStore<Namespace> getStore();
+
 }

junit-platform-launcher/src/main/java/org/junit/platform/launcher/core/DefaultLauncher.java

@@ -17,10 +17,13 @@
 import java.util.Collection;
 
 import org.junit.platform.commons.util.Preconditions;
+import org.junit.platform.engine.Namespace;
 import org.junit.platform.engine.TestEngine;
+import org.junit.platform.engine.support.store.NamespacedHierarchicalStore;
 import org.junit.platform.launcher.Launcher;
 import org.junit.platform.launcher.LauncherDiscoveryListener;
 import org.junit.platform.launcher.LauncherDiscoveryRequest;
+import org.junit.platform.launcher.LauncherSession;
 import org.junit.platform.launcher.PostDiscoveryFilter;
 import org.junit.platform.launcher.TestExecutionListener;
 import org.junit.platform.launcher.TestPlan;
@@ -41,6 +44,8 @@ class DefaultLauncher implements Launcher {
 	private final EngineExecutionOrchestrator executionOrchestrator = new EngineExecutionOrchestrator(
 		listenerRegistry.testExecutionListeners);
 	private final EngineDiscoveryOrchestrator discoveryOrchestrator;
+	private final LauncherSession launcherSession;
+	private final NamespacedHierarchicalStore<Namespace> sessionStore;
 
 	/**
 	 * Construct a new {@code DefaultLauncher} with the supplied test engines.
@@ -50,7 +55,8 @@ class DefaultLauncher implements Launcher {
 	 * @param postDiscoveryFilters the additional post discovery filters for
 	 * discovery requests; never {@code null}
 	 */
-	DefaultLauncher(Iterable<TestEngine> testEngines, Collection<PostDiscoveryFilter> postDiscoveryFilters) {
+	DefaultLauncher(Iterable<TestEngine> testEngines, Collection<PostDiscoveryFilter> postDiscoveryFilters,
+			LauncherConfig config) {
 		Preconditions.condition(testEngines != null && testEngines.iterator().hasNext(),
 			() -> "Cannot create Launcher without at least one TestEngine; "
 					+ "consider adding an engine implementation JAR to the classpath");
@@ -59,6 +65,8 @@ class DefaultLauncher implements Launcher {
 			"PostDiscoveryFilter array must not contain null elements");
 		this.discoveryOrchestrator = new EngineDiscoveryOrchestrator(testEngines,
 			unmodifiableCollection(postDiscoveryFilters), listenerRegistry.launcherDiscoveryListeners);
+		this.launcherSession = LauncherFactory.openSession(config);
+		this.sessionStore = launcherSession.getStore();
 	}
 
 	@Override
@@ -94,6 +102,11 @@ public void execute(TestPlan testPlan, TestExecutionListener... listeners) {
 		execute((InternalTestPlan) testPlan, listeners);
 	}
 
+	@Override
+	public NamespacedHierarchicalStore<Namespace> getStore(LauncherDiscoveryRequest launcherDiscoveryRequest) {
+		return new NamespacedHierarchicalStore<>(this.sessionStore);
+	}
+
 	private LauncherDiscoveryResult discover(LauncherDiscoveryRequest discoveryRequest,
 			EngineDiscoveryOrchestrator.Phase phase) {
 		return discoveryOrchestrator.discover(discoveryRequest, phase);

junit-platform-launcher/src/main/java/org/junit/platform/launcher/core/DefaultLauncherSession.java

@@ -14,6 +14,8 @@
 import java.util.function.Supplier;
 
 import org.junit.platform.commons.PreconditionViolationException;
+import org.junit.platform.engine.Namespace;
+import org.junit.platform.engine.support.store.NamespacedHierarchicalStore;
 import org.junit.platform.launcher.Launcher;
 import org.junit.platform.launcher.LauncherDiscoveryListener;
 import org.junit.platform.launcher.LauncherDiscoveryRequest;
@@ -43,6 +45,7 @@ public void close() {
 	private final LauncherInterceptor interceptor;
 	private final LauncherSessionListener listener;
 	private final DelegatingLauncher launcher;
+	private final NamespacedHierarchicalStore<Namespace> store;
 
 	DefaultLauncherSession(List<LauncherInterceptor> interceptors, Supplier<LauncherSessionListener> listenerSupplier,
 			Supplier<Launcher> launcherSupplier) {
@@ -58,6 +61,7 @@ public void close() {
 		}
 		this.launcher = new DelegatingLauncher(launcher);
 		listener.launcherSessionOpened(this);
+		this.store = new NamespacedHierarchicalStore<>(null);
 	}
 
 	@Override
@@ -78,6 +82,11 @@ public void close() {
 		}
 	}
 
+	@Override
+	public NamespacedHierarchicalStore<Namespace> getStore() {
+		return store;
+	}
+
 	private static class ClosedLauncher implements Launcher {
 
 		static final ClosedLauncher INSTANCE = new ClosedLauncher();
@@ -109,6 +118,11 @@ public void execute(LauncherDiscoveryRequest launcherDiscoveryRequest, TestExecu
 		public void execute(TestPlan testPlan, TestExecutionListener... listeners) {
 			throw new PreconditionViolationException("Launcher session has already been closed");
 		}
+
+		@Override
+		public NamespacedHierarchicalStore<Namespace> getStore(LauncherDiscoveryRequest launcherDiscoveryRequest) {
+			throw new PreconditionViolationException("Launcher session has already been closed");
+		}
 	}
 
 	private static LauncherInterceptor composite(List<LauncherInterceptor> interceptors) {

junit-platform-launcher/src/main/java/org/junit/platform/launcher/core/DelegatingLauncher.java

@@ -10,6 +10,8 @@
 
 package org.junit.platform.launcher.core;
 
+import org.junit.platform.engine.Namespace;
+import org.junit.platform.engine.support.store.NamespacedHierarchicalStore;
 import org.junit.platform.launcher.Launcher;
 import org.junit.platform.launcher.LauncherDiscoveryListener;
 import org.junit.platform.launcher.LauncherDiscoveryRequest;
@@ -52,4 +54,9 @@ public void execute(TestPlan testPlan, TestExecutionListener... listeners) {
 		delegate.execute(testPlan, listeners);
 	}
 
+	@Override
+	public NamespacedHierarchicalStore<Namespace> getStore(LauncherDiscoveryRequest launcherDiscoveryRequest) {
+		return delegate.getStore(launcherDiscoveryRequest);
+	}
+
 }

junit-platform-launcher/src/main/java/org/junit/platform/launcher/core/LauncherFactory.java

@@ -134,7 +134,7 @@ private static DefaultLauncher createDefaultLauncher(LauncherConfig config,
 		Set<TestEngine> engines = collectTestEngines(config);
 		List<PostDiscoveryFilter> filters = collectPostDiscoveryFilters(config);
 
-		DefaultLauncher launcher = new DefaultLauncher(engines, filters);
+		DefaultLauncher launcher = new DefaultLauncher(engines, filters, config);
 
 		registerLauncherDiscoveryListeners(config, launcher);
 		registerTestExecutionListeners(config, launcher, configurationParameters);

junit-platform-launcher/src/main/java/org/junit/platform/launcher/core/SessionPerRequestLauncher.java

@@ -13,6 +13,8 @@
 import java.util.List;
 import java.util.function.Supplier;
 
+import org.junit.platform.engine.Namespace;
+import org.junit.platform.engine.support.store.NamespacedHierarchicalStore;
 import org.junit.platform.launcher.Launcher;
 import org.junit.platform.launcher.LauncherDiscoveryListener;
 import org.junit.platform.launcher.LauncherDiscoveryRequest;
@@ -71,6 +73,13 @@ public void execute(TestPlan testPlan, TestExecutionListener... listeners) {
 		}
 	}
 
+	@Override
+	public NamespacedHierarchicalStore<Namespace> getStore(LauncherDiscoveryRequest launcherDiscoveryRequest) {
+		try (LauncherSession session = createSession()) {
+			return session.getLauncher().getStore(launcherDiscoveryRequest);
+		}
+	}
+
 	private LauncherSession createSession() {
 		LauncherSession session = new DefaultLauncherSession(interceptorFactory.get(), sessionListenerSupplier,
 			launcherSupplier);