/*
 * Copyright 2015-2026 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.vintage.engine;

import static org.apiguardian.api.API.Status.DEPRECATED;
import static org.apiguardian.api.API.Status.MAINTAINED;

import org.apiguardian.api.API;

/**
 * Collection of constants related to the {@link VintageTestEngine}.
 *
 * @deprecated Should only be used temporarily while migrating tests to JUnit
 * Jupiter or another testing framework with native JUnit Platform support
 */
@Deprecated(since = "6.0")
@API(status = DEPRECATED, since = "6.0")
public final class Constants {

	/**
	 * Property name used to indicate whether parallel execution is enabled for the JUnit Vintage engine: {@value}
	 *
	 * <p>Set this property to {@code true} to enable parallel execution of tests.
	 * Defaults to {@code false}.
	 *
	 * @since 5.12
	 */
	@API(status = MAINTAINED, since = "5.13.3")
	public static final String PARALLEL_EXECUTION_ENABLED = "junit.vintage.execution.parallel.enabled";

	/**
	 * Property name used to specify the size of the thread pool to be used for parallel execution: {@value}
	 *
	 * <p>Set this property to an integer value to specify the number of threads
	 * to be used for parallel execution. Defaults to the number of available
	 * processors.
	 *
	 * @since 5.12
	 */
	@API(status = MAINTAINED, since = "5.13.3")
	public static final String PARALLEL_POOL_SIZE = "junit.vintage.execution.parallel.pool-size";

	/**
	 * Property name used to indicate whether parallel execution is enabled for test classes in the
	 * JUnit Vintage engine: {@value}
	 *
	 * <p>Set this property to {@code true} to enable parallel execution of test
	 * classes. Defaults to {@code false}.
	 *
	 * @since 5.12
	 */
	@API(status = MAINTAINED, since = "5.13.3")
	public static final String PARALLEL_CLASS_EXECUTION = "junit.vintage.execution.parallel.classes";

	/**
	 * Property name used to indicate whether parallel execution is enabled for test methods in the
	 * JUnit Vintage engine: {@value}
	 *
	 * <p>Set this property to {@code true} to enable parallel execution of test
	 * methods. Defaults to {@code false}.
	 *
	 * @since 5.12
	 */
	@API(status = MAINTAINED, since = "5.13.3")
	public static final String PARALLEL_METHOD_EXECUTION = "junit.vintage.execution.parallel.methods";

	/**
	 * Property name used to configure whether the JUnit Vintage engine should
	 * report discovery issues such as deprecation notices: {@value}
	 *
	 * <p>Set this property to {@code false} to disable reporting of discovery
	 * issues. Defaults to {@code true}.
	 *
	 * @since 6.0.1
	 */
	@API(status = MAINTAINED, since = "6.0.1")
	public static final String DISCOVERY_ISSUE_REPORTING_ENABLED_PROPERTY_NAME = "junit.vintage.discovery.issue.reporting.enabled";

	private Constants() {
		/* no-op */
	}

}
