package org.testng;

import org.testng.xml.XmlTest;


/**
 * This interface allows to modify the strategy used by TestRunner
 * to find its test methods.  At the time of this writing, TestNG
 * supports two different strategies:  TestNG (using annotations to
 * locate these methods) and JUnit (setUp()/tearDown() and all
 * methods that start with "test" or have a suite() method). 
 *
 * @author Cedric Beust, May 3, 2004
 * 
 */
public interface ITestMethodFinder {
  
  /**
   * @return All the applicable test methods.
   */
  ITestNGMethod[] getTestMethods(Class cls, XmlTest xmlTest);
  
  /**
   * @return All the methods that should be invoked
   * before a test method is invoked.
   */
  ITestNGMethod[] getBeforeTestMethods(Class cls);

  /**
   * @return All the methods that should be invoked
   * after a test method completes.
   */
  ITestNGMethod[] getAfterTestMethods(Class cls);
  
  /**
   * @return All the methods that should be invoked
   * after the test class has been created and before
   * any of its test methods is invoked.
   */
  ITestNGMethod[] getBeforeClassMethods(Class cls);

  /**
   * @return All the methods that should be invoked
   * after the test class has been created and after
   * all its test methods have completed.
   */
  ITestNGMethod[] getAfterClassMethods(Class cls);
    
  /**
   * @return All the methods that should be invoked
   * before the suite starts running.
   */
  ITestNGMethod[] getBeforeSuiteMethods(Class cls);
  
  /**
   * @return All the methods that should be invoked
   * after the suite has run all its tests.
   */
  ITestNGMethod[] getAfterSuiteMethods(Class cls);

  ITestNGMethod[] getBeforeTestConfigurationMethods(Class testClass);

  ITestNGMethod[] getAfterTestConfigurationMethods(Class testClass);

  ITestNGMethod[] getBeforeGroupsConfigurationMethods(Class testClass);

  ITestNGMethod[] getAfterGroupsConfigurationMethods(Class testClass);
  
  
}