Subversion-Projekte lars-tiefland.php_share

Revision

Details | Letzte Änderung | Log anzeigen | RSS feed

Revision Autor Zeilennr. Zeile
1 lars 1
<?php
2
/**
3
 * PHPUnit
4
 *
5
 * Copyright (c) 2002-2010, Sebastian Bergmann <sb@sebastian-bergmann.de>.
6
 * All rights reserved.
7
 *
8
 * Redistribution and use in source and binary forms, with or without
9
 * modification, are permitted provided that the following conditions
10
 * are met:
11
 *
12
 *   * Redistributions of source code must retain the above copyright
13
 *     notice, this list of conditions and the following disclaimer.
14
 *
15
 *   * Redistributions in binary form must reproduce the above copyright
16
 *     notice, this list of conditions and the following disclaimer in
17
 *     the documentation and/or other materials provided with the
18
 *     distribution.
19
 *
20
 *   * Neither the name of Sebastian Bergmann nor the names of his
21
 *     contributors may be used to endorse or promote products derived
22
 *     from this software without specific prior written permission.
23
 *
24
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
25
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
26
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
27
 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
28
 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
29
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
30
 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
31
 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
32
 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
33
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
34
 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35
 * POSSIBILITY OF SUCH DAMAGE.
36
 *
37
 * @category   Testing
38
 * @package    PHPUnit
39
 * @author     Mattis Stordalen Flister <mattis@xait.no>
40
 * @author     Sebastian Bergmann <sb@sebastian-bergmann.de>
41
 * @copyright  2002-2010 Sebastian Bergmann <sb@sebastian-bergmann.de>
42
 * @license    http://www.opensource.org/licenses/bsd-license.php  BSD License
43
 * @link       http://www.phpunit.de/
44
 * @since      File available since Release 3.3.0
45
 */
46
 
47
require_once 'PHPUnit/Extensions/Story/Step.php';
48
require_once 'PHPUnit/Extensions/Story/Given.php';
49
require_once 'PHPUnit/Extensions/Story/When.php';
50
require_once 'PHPUnit/Extensions/Story/Then.php';
51
require_once 'PHPUnit/Util/Filter.php';
52
 
53
PHPUnit_Util_Filter::addFileToFilter(__FILE__, 'PHPUNIT');
54
 
55
/**
56
 * A scenario.
57
 *
58
 * @category   Testing
59
 * @package    PHPUnit
60
 * @author     Mattis Stordalen Flister <mattis@xait.no>
61
 * @author     Sebastian Bergmann <sb@sebastian-bergmann.de>
62
 * @copyright  2002-2010 Sebastian Bergmann <sb@sebastian-bergmann.de>
63
 * @license    http://www.opensource.org/licenses/bsd-license.php  BSD License
64
 * @version    Release: 3.4.15
65
 * @link       http://www.phpunit.de/
66
 * @since      Class available since Release 3.3.0
67
 */
68
class PHPUnit_Extensions_Story_Scenario
69
{
70
    /**
71
     * @var    PHPUnit_Extensions_Story_TestCase
72
     */
73
    protected $test;
74
 
75
    /**
76
     * @var    array
77
     */
78
    protected $steps = array();
79
 
80
    /**
81
     * @var    string
82
     */
83
    protected $lastCalledMethod;
84
 
85
    /**
86
     * Constructor.
87
     *
88
     * @param  PHPUnit_Extensions_Story_TestCase $caller
89
     */
90
    public function __construct($test)
91
    {
92
        if ($test instanceof PHPUnit_Extensions_Story_TestCase ||
93
            $test instanceof PHPUnit_Extensions_Story_SeleniumTestCase) {
94
            $this->test = $test;
95
        } else {
96
            throw new Exception('$test must either be PHPUnit_Extensions_Story_TestCase or PHPUnit_Extensions_Story_SeleniumTestCase');
97
        }
98
    }
99
 
100
    /**
101
     * Adds a "Given" step to the scenario.
102
     *
103
     * @param  array $arguments
104
     * @return PHPUnit_Extensions_Story_TestCase
105
     */
106
    public function given($arguments)
107
    {
108
        return $this->addStep(new PHPUnit_Extensions_Story_Given($arguments));
109
    }
110
 
111
    /**
112
     * Adds a "When" step to the scenario.
113
     *
114
     * @param  array $arguments
115
     * @return PHPUnit_Extensions_Story_TestCase
116
     */
117
    public function when($arguments)
118
    {
119
        return $this->addStep(new PHPUnit_Extensions_Story_When($arguments));
120
    }
121
 
122
    /**
123
     * Adds a "Then" step to the scenario.
124
     *
125
     * @param  array $arguments
126
     * @return PHPUnit_Extensions_Story_TestCase
127
     */
128
    public function then($arguments)
129
    {
130
        return $this->addStep(new PHPUnit_Extensions_Story_Then($arguments));
131
    }
132
 
133
    /**
134
     * Add another step of the same type as the step that was added before.
135
     *
136
     * @param  array $arguments
137
     * @return PHPUnit_Extensions_Story_TestCase
138
     */
139
    public function _and($arguments)
140
    {
141
        $lastCalledStepClass = get_class($this->steps[count($this->steps)-1]);
142
 
143
        return $this->addStep(new $lastCalledStepClass($arguments));
144
    }
145
 
146
    /**
147
     * Runs this scenario.
148
     *
149
     * @param  array $world
150
     */
151
    public function run(array &$world)
152
    {
153
        foreach ($this->steps as $step)
154
        {
155
            if ($step instanceof PHPUnit_Extensions_Story_Given) {
156
                $this->test->runGiven(
157
                  $world, $step->getAction(), $step->getArguments()
158
                );
159
            }
160
 
161
            else if ($step instanceof PHPUnit_Extensions_Story_When) {
162
                $this->test->runWhen(
163
                  $world, $step->getAction(), $step->getArguments()
164
                );
165
            }
166
 
167
            else {
168
                $this->test->runThen(
169
                  $world, $step->getAction(), $step->getArguments()
170
                );
171
            }
172
        }
173
    }
174
 
175
    /**
176
     * Adds a step to the scenario.
177
     *
178
     * @param  PHPUnit_Extensions_Story_Step $step
179
     * @return PHPUnit_Extensions_Story_TestCase
180
     */
181
    protected function addStep(PHPUnit_Extensions_Story_Step $step)
182
    {
183
        $this->steps[] = $step;
184
 
185
        return $this->test;
186
    }
187
 
188
    /**
189
     * Returns the steps of this scenario.
190
     *
191
     * @return array
192
     */
193
    public function getSteps()
194
    {
195
        return $this->steps;
196
    }
197
}
198
?>