// Copyright © 2011-2013, Esko Luontola <www.orfjackal.net>
// 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 SuiteNotifier {

    // TODO: support navigation by providing a Class or Method instance to the fireTestFound method

    /**
     * Must be called before starting the test. Idempotent.
     */
    /* TODO: add javadoc after implemented:
       IDEs can use the Class or Method object to implement code navigation.
     */
    void fireTestFound(TestId testId, String name);

    /**
     * May be called multiple times, before a test is finished, to produce nested tests. The only limitation is that a
     * nested test must be finished before the surrounding tests. Everything printed to {@code System.out} and {@code
     * System.err} after the call to this method will be recorded from the current thread and threads which are started
     * by it (possibly together with timestamps and name of the thread which printed it).
     */
    TestNotifier fireTestStarted(TestId testId);

    /**
     * Notifies about an internal error e.g. in the Driver, not in a test.
     */
    void fireInternalError(String message, Throwable cause);
}

@@ -1169,13 +1169,8 @@
 rror
- e.g.
  in 
@@ -1183,23 +1183,46 @@
 iver
-, not in a test
+ (that is, not a regular test failure)
 .%0A  

make the first sentence show up better in the Javadoc method summary