package org.testng;

import com.google.inject.Injector;
import com.google.inject.Module;

import org.testng.xml.XmlTest;

import java.util.Collection;
import java.util.Date;
import java.util.List;

This class defines a test context which contains all the information for a given test run. An
instance of this context is passed to the test listeners so they can query information about
their environment.
Author:
Cedric Beust, Aug 6, 2004/**
 * This class defines a test context which contains all the information for a given test run. An
 * instance of this context is passed to the test listeners so they can query information about
 * their environment.
 *
 * @author Cedric Beust, Aug 6, 2004
 */
public interface ITestContext extends IAttributes {

  
Returns:
The name of this test./** @return The name of this test. */
  String getName();

  
Returns:
When this test started running./** @return When this test started running. */
  Date getStartDate();

  
Returns:
When this test stopped running./** @return When this test stopped running. */
  Date getEndDate();

  
Returns:
A list of all the tests that run successfully./** @return A list of all the tests that run successfully. */
  IResultMap getPassedTests();

  
Returns:
A list of all the tests that were skipped/** @return A list of all the tests that were skipped */
  IResultMap getSkippedTests();

  
Returns:
A list of all the tests that failed but are being ignored because annotated with a
    successPercentage./**
   * @return A list of all the tests that failed but are being ignored because annotated with a
   *     successPercentage.
   */
  IResultMap getFailedButWithinSuccessPercentageTests();

  
See Also:
ITestNGMethod
Returns:
A map of all the tests that passed, indexed by their ITextMethor./**
   * @return A map of all the tests that passed, indexed by their ITextMethor.
   * @see org.testng.ITestNGMethod
   */
  IResultMap getFailedTests();

  
Returns:
All the groups that are included for this test run./** @return All the groups that are included for this test run. */
  String[] getIncludedGroups();

  
Returns:
All the groups that are excluded for this test run./** @return All the groups that are excluded for this test run. */
  String[] getExcludedGroups();

  
Returns:
Where the reports will be generated./** @return Where the reports will be generated. */
  String getOutputDirectory();

  
Returns:
The Suite object that was passed to the runner at start-up./** @return The Suite object that was passed to the runner at start-up. */
  ISuite getSuite();

  
Returns:
All the test methods that were run./** @return All the test methods that were run. */
  ITestNGMethod[] getAllTestMethods();

  
Returns:
The host where this test was run, or null if it was run locally. The returned string
    has the form: host:port/**
   * @return The host where this test was run, or null if it was run locally. The returned string
   *     has the form: host:port
   */
  String getHost();

  
Returns:
All the methods that were not included in this test run./** @return All the methods that were not included in this test run. */
  Collection<ITestNGMethod> getExcludedMethods();

  
Returns:
The information about the successful configuration method invocations./** @return The information about the successful configuration method invocations. */
  IResultMap getPassedConfigurations();

  
Returns:
The information about the skipped configuration method invocations./** @return The information about the skipped configuration method invocations. */
  IResultMap getSkippedConfigurations();

  
Returns:
The information about the failed configuration method invocations./** @return The information about the failed configuration method invocations. */
  IResultMap getFailedConfigurations();

  
Returns:
the current XmlTest./** @return the current XmlTest. */
  XmlTest getCurrentXmlTest();

  List<Module> getGuiceModules(Class<? extends Module> cls);

  Injector getInjector(List<Module> moduleInstances);

  Injector getInjector(IClass iClass);

  void addInjector(List<Module> moduleInstances, Injector injector);
}