fi.jumi.api.drivers.TestNotifier Maven / Gradle / Ivy

Go to download
// Copyright © 2011-2012, Esko Luontola 
// This software is released under the Apache License 2.0.
// The license text is at http://www.apache.org/licenses/LICENSE-2.0

package fi.jumi.api.drivers;

public interface TestNotifier {

    /**
     * May be called multiple times per test (although most testing frameworks will stop execution on the first
     * exception).
     */
    void fireFailure(Throwable cause);

    /**
     * Must be called last, exactly once. The test will fail if {@link #fireFailure} had been called at least once,
     * otherwise the test will pass. It is a runtime error to call {@link #fireFailure} or {@link #fireTestFinished}
     * after calling this method.
     */
    /* TODO: add javadoc after implemented:
       If the test started any threads, will wait for them to finish (except the AWT event thread and maybe some others).
       It is an error (or at least a warning) for a test to start threads without stopping them.
     */
    void fireTestFinished();
}