org.junit.gen5.launcher.main.LauncherFactory Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of junit-launcher Show documentation

Module "junit-launcher" of JUnit 5.

The newest version!

/*
 * Copyright 2015-2016 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 v1.0 which
 * accompanies this distribution and is available at
 *
 * http://www.eclipse.org/legal/epl-v10.html
 */

package org.junit.gen5.launcher.main;

import static org.junit.gen5.commons.meta.API.Usage.Experimental;

import org.junit.gen5.commons.meta.API;
import org.junit.gen5.launcher.Launcher;

/**
 * Factory for creating {@link Launcher} instances by invoking {@link #create()}.
 *
 * Test engines are registered at runtime using the
 * {@link java.util.ServiceLoader ServiceLoader} facility. For that purpose, a
 * text file named {@code META-INF/services/org.junit.gen5.engine.TestEngine}
 * has to be added to the engine's JAR file in which the fully qualified name
 * of the implementation class of the {@link org.junit.gen5.engine.TestEngine}
 * interface is stated.
 *
 * @since 5.0
 * @see Launcher
 */
@API(Experimental)
public class LauncherFactory {

	/**
	 * Factory method for creating a new instance of {@link Launcher} using dynamically
	 * registered test engines.
	 */
	public static Launcher create() {
		return new DefaultLauncher(new ServiceLoaderTestEngineRegistry().loadTestEngines());
	}

}