package org.testng.annotations;

import java.lang.annotation.Documented;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;

@Retention(java.lang.annotation.RetentionPolicy.RUNTIME)
@Target(java.lang.annotation.ElementType.METHOD)
@Documented
public @interface AfterSuite {
  
Whether methods on this class/method are enabled.
Returns:
the value (default true)/**
   * Whether methods on this class/method are enabled.
   *
   * @return the value (default true)
   */
  boolean enabled() default true;

  
The list of groups this class/method belongs to.
Returns:
the value/**
   * The list of groups this class/method belongs to.
   *
   * @return the value
   */
  String[] groups() default {};

  
The list of groups this method depends on. Every method member of one of these groups is
guaranteed to have been invoked before this method. Furthermore, if any of these methods was
not a SUCCESS, this test method will not be run and will be flagged as a SKIP.
Returns:
the value/**
   * The list of groups this method depends on. Every method member of one of these groups is
   * guaranteed to have been invoked before this method. Furthermore, if any of these methods was
   * not a SUCCESS, this test method will not be run and will be flagged as a SKIP.
   *
   * @return the value
   */
  String[] dependsOnGroups() default {};

  
The list of methods this method depends on. There is no guarantee of the order in which the
methods depended upon will be run, but you are guaranteed that all these methods will be run
before the test method that contains this annotation is run. Furthermore, if any of these
methods was not a SUCCESS, this test method will not be run and will be flagged as a SKIP.
If some of these methods have been overloaded, all the overloaded versions will be run.
Returns:
the value/**
   * The list of methods this method depends on. There is no guarantee of the order in which the
   * methods depended upon will be run, but you are guaranteed that all these methods will be run
   * before the test method that contains this annotation is run. Furthermore, if any of these
   * methods was not a SUCCESS, this test method will not be run and will be flagged as a SKIP.
   *
   * <p>If some of these methods have been overloaded, all the overloaded versions will be run.
   *
   * @return the value
   */
  String[] dependsOnMethods() default {};

  
For before methods (beforeSuite, beforeTest, beforeTestClass and beforeTestMethod, but not
beforeGroups): if set to true, this configuration method will be run regardless of what groups
it belongs to. 

For after methods (afterSuite, afterClass, ...): if set to true, this configuration method will
be run even if one or more methods invoked previously failed or was skipped.
Returns:
the value (default false)/**
   * For before methods (beforeSuite, beforeTest, beforeTestClass and beforeTestMethod, but not
   * beforeGroups): if set to true, this configuration method will be run regardless of what groups
   * it belongs to. <br>
   * For after methods (afterSuite, afterClass, ...): if set to true, this configuration method will
   * be run even if one or more methods invoked previously failed or was skipped.
   *
   * @return the value (default false)
   */
  boolean alwaysRun() default false;

  
If true, this @Configuration method will belong to groups specified in the @Test
annotation on the class (if any).
Returns:
the value (default true)/**
   * If true, this &#64;Configuration method will belong to groups specified in the &#64;Test
   * annotation on the class (if any).
   *
   * @return the value (default true)
   */
  boolean inheritGroups() default true;

  
The description for this method. The string used will appear in the HTML report and also on
standard output if verbose > 2.
Returns:
the value (default empty)/**
   * The description for this method. The string used will appear in the HTML report and also on
   * standard output if verbose &gt; 2.
   *
   * @return the value (default empty)
   */
  String description() default "";

  
The maximum number of milliseconds this method should take. If it hasn't returned after this
time, this method will fail and it will cause test methods depending on it to be skipped.
Returns:
the valude (default 0)/**
   * The maximum number of milliseconds this method should take. If it hasn't returned after this
   * time, this method will fail and it will cause test methods depending on it to be skipped.
   *
   * @return the valude (default 0)
   */
  long timeOut() default 0;
}