package org.testng;

import org.testng.xml.XmlTest;

import java.util.Collection;
import java.util.List;
import java.util.Map;

A factory for TestRunners to be used by SuiteRunners.
/**
 * A factory for TestRunners to be used by SuiteRunners.
 */
public interface ITestRunnerFactory {

  TestRunner newTestRunner(
      ISuite suite,
      XmlTest test,
      Collection<IInvokedMethodListener> listeners,
      List<IClassListener> classListeners);

  
Produces a new TestRunner 
Params:
suite – - The ISuite object that represents a particular <suite>.
test – - The XmlTest object that represents a particular <test>.
listeners – - A list of IInvokedMethodListener listeners.
classListeners – - A list of IClassListener listeners.
dataProviderListeners – - A Map of IDataProviderListener listeners.
Returns:
- A TestRunner object./**
   * Produces a new {@link TestRunner}
   *
   * @param suite - The {@link ISuite} object that represents a particular &lt;suite&gt;.
   * @param test - The {@link XmlTest} object that represents a particular &lt;test&gt;.
   * @param listeners - A list of {@link IInvokedMethodListener} listeners.
   * @param classListeners - A list of {@link IClassListener} listeners.
   * @param dataProviderListeners - A Map of {@link IDataProviderListener} listeners.
   * @return - A {@link TestRunner} object.
   */
  default TestRunner newTestRunner(
      ISuite suite,
      XmlTest test,
      Collection<IInvokedMethodListener> listeners,
      List<IClassListener> classListeners,
      Map<Class<? extends IDataProviderListener>, IDataProviderListener> dataProviderListeners) {
    return newTestRunner(suite, test, listeners, classListeners);
  }

  
Produces a new TestRunner 
Params:
suite – - The ISuite object that represents a particular <suite>.
test – - The XmlTest object that represents a particular <test>.
listeners – - A list of IInvokedMethodListener listeners.
classListeners – - A list of IClassListener listeners.
holder – - A DataProviderHolder holder object.
Returns:
- A TestRunner object./**
   * Produces a new {@link TestRunner}
   *
   * @param suite - The {@link ISuite} object that represents a particular &lt;suite&gt;.
   * @param test - The {@link XmlTest} object that represents a particular &lt;test&gt;.
   * @param listeners - A list of {@link IInvokedMethodListener} listeners.
   * @param classListeners - A list of {@link IClassListener} listeners.
   * @param holder - A {@link DataProviderHolder} holder object.
   * @return - A {@link TestRunner} object.
   */
  default TestRunner newTestRunner(
      ISuite suite,
      XmlTest test,
      Collection<IInvokedMethodListener> listeners,
      List<IClassListener> classListeners,
      DataProviderHolder holder) {
    return newTestRunner(suite, test, listeners, classListeners);
  }

}