1<?php
2/*
3 * This file is part of PHPUnit.
4 *
5 * (c) Sebastian Bergmann <sebastian@phpunit.de>
6 *
7 * For the full copyright and license information, please view the LICENSE
8 * file that was distributed with this source code.
9 */
10
11/**
12 * A Listener for test progress.
13 */
14interface PHPUnit_Framework_TestListener
15{
16    /**
17     * An error occurred.
18     *
19     * @param PHPUnit_Framework_Test $test
20     * @param Exception              $e
21     * @param float                  $time
22     */
23    public function addError(PHPUnit_Framework_Test $test, Exception $e, $time);
24
25    /**
26     * A warning occurred.
27     *
28     * @param PHPUnit_Framework_Test    $test
29     * @param PHPUnit_Framework_Warning $e
30     * @param float                     $time
31     *
32     * @todo  Uncomment in time for PHPUnit 6.0.0
33     *
34     * @see   https://github.com/sebastianbergmann/phpunit/pull/1840#issuecomment-162535997
35     */
36//  public function addWarning(PHPUnit_Framework_Test $test, PHPUnit_Framework_Warning $e, $time);
37
38    /**
39     * A failure occurred.
40     *
41     * @param PHPUnit_Framework_Test                 $test
42     * @param PHPUnit_Framework_AssertionFailedError $e
43     * @param float                                  $time
44     */
45    public function addFailure(PHPUnit_Framework_Test $test, PHPUnit_Framework_AssertionFailedError $e, $time);
46
47    /**
48     * Incomplete test.
49     *
50     * @param PHPUnit_Framework_Test $test
51     * @param Exception              $e
52     * @param float                  $time
53     */
54    public function addIncompleteTest(PHPUnit_Framework_Test $test, Exception $e, $time);
55
56    /**
57     * Risky test.
58     *
59     * @param PHPUnit_Framework_Test $test
60     * @param Exception              $e
61     * @param float                  $time
62     */
63    public function addRiskyTest(PHPUnit_Framework_Test $test, Exception $e, $time);
64
65    /**
66     * Skipped test.
67     *
68     * @param PHPUnit_Framework_Test $test
69     * @param Exception              $e
70     * @param float                  $time
71     */
72    public function addSkippedTest(PHPUnit_Framework_Test $test, Exception $e, $time);
73
74    /**
75     * A test suite started.
76     *
77     * @param PHPUnit_Framework_TestSuite $suite
78     */
79    public function startTestSuite(PHPUnit_Framework_TestSuite $suite);
80
81    /**
82     * A test suite ended.
83     *
84     * @param PHPUnit_Framework_TestSuite $suite
85     */
86    public function endTestSuite(PHPUnit_Framework_TestSuite $suite);
87
88    /**
89     * A test started.
90     *
91     * @param PHPUnit_Framework_Test $test
92     */
93    public function startTest(PHPUnit_Framework_Test $test);
94
95    /**
96     * A test ended.
97     *
98     * @param PHPUnit_Framework_Test $test
99     * @param float                  $time
100     */
101    public function endTest(PHPUnit_Framework_Test $test, $time);
102}
103