~budgester/irm/trunk

Si aucun nom de test n'est fourni au moment de la liaison avec le constructeur alors le nom de la classe sera utilisé. Il s'agit du nom qui sera affiché dans les résultats du test.

Les véritables tests sont ajoutés en tant que méthode dans le scénario de test dont le nom par défaut commence par la chaîne "test" et quand le scénario de test est appelé toutes les méthodes de ce type sont exécutées dans l'ordre utilisé par l'introspection de PHP pour les trouver. Peuvent être ajoutées autant de méthodes de test que nécessaires. Par exemple...

<pre>

require_once('../classes/writer.php');

class FileTestCase extends UnitTestCase {

function FileTestCase() {

$this->UnitTestCase('File test');

}

function setUp() {

@unlink('../temp/test.txt');

}

function tearDown() {

@unlink('../temp/test.txt');

}

function testCreation() {

$writer = &new FileWriter('../temp/test.txt');

$writer->write('Hello');

$this->assertTrue(file_exists('../temp/test.txt'), 'File created');

}

}

</pre>

Le constructeur est optionnel et souvent omis. Sans nom, le nom de la classe est utilisé comme nom pour le scénario de test.

Notre unique méthode de test pour le moment est testCreation() où nous vérifions qu'un fichier a bien été créé par notre objet Writer. Nous pourrions avoir mis le code unlink() dans cette méthode, mais en la plaçant dans setUp() et tearDown() nous pouvons l'utiliser pour nos autres méthodes de test que nous ajouterons.

La méthode setUp() est lancé juste avant chaque méthode de test. tearDown() est lancé après chaque méthode de test.

Vous pouvez placer une initialisation de scénario de test dans le constructeur afin qu'elle soit lancée pour toutes les méthodes dans le scénario de test mais dans un tel cas vous vous exposeriez à des interférences. Cette façon de faire est légèrement moins rapide, mais elle est plus sûre. Notez que si vous arrivez avec des notions de JUnit, il ne s'agit pas du comportement auquel vous êtes habitués. Bizarrement JUnit re-instancie le scénario de test pour chaque méthode de test pour se prévenir d'une telle interférence. SimpleTest demande à l'utilisateur final d'utiliser setUp(), mais fournit aux codeurs de bibliothèque d'autres crochets.

100

101

102

Pour rapporter les résultats de test, le passage par une classe d'affichage - notifiée par les différentes méthodes de type assert...() - est utilisée. En voici la liste complète pour la classe UnitTestCase, celle par défaut dans SimpleTest...

103

<table>

104

<tbody>

105

<tr>

106

<td>assertTrue($x)</td><td>Echoue si $x est faux</td>

107

</tr>

108

<tr>

109

<td>assertFalse($x)</td><td>Echoue si $x est vrai</td>

110

</tr>

111

<tr>

112

<td>assertNull($x)</td><td>Echoue si $x est initialisé</td>

113

</tr>

114

<tr>

115

<td>assertNotNull($x)</td><td>Echoue si $x n'est pas initialisé</td>

116

</tr>

117

<tr>

118

<td>assertIsA($x, $t)</td><td>Echoue si $x n'est pas de la classe ou du type $t</td>

119

</tr>

120

<tr>

121

<td>assertEqual($x, $y)</td><td>Echoue si $x == $y est faux</td>

122

</tr>

123

<tr>

124

<td>assertNotEqual($x, $y)</td><td>Echoue si $x == $y est vrai</td>

125

</tr>

126

<tr>

127

<td>assertIdentical($x, $y)</td><td>Echoue si $x === $y est faux</td>

128

</tr>

129

<tr>

130

<td>assertNotIdentical($x, $y)</td><td>Echoue si $x === $y est vrai</td>

131

</tr>

132

<tr>

133

<td>assertReference($x, $y)</td><td>Echoue sauf si $x et $y sont la même variable</td>

134

</tr>

135

<tr>

136

<td>assertCopy($x, $y)</td><td>Echoue si $x et $y sont la même variable</td>

137

</tr>

138

<tr>

139

<td>assertWantedPattern($p, $x)</td><td>Echoue sauf si l'expression rationnelle $p capture $x</td>

140

</tr>

141

<tr>

142

<td>assertNoUnwantedPattern($p, $x)</td><td>Echoue si l'expression rationnelle $p capture $x</td>

143

</tr>

144

<tr>

145

<td>assertNoErrors()</td><td>Echoue si une erreur PHP arrive</td>

146

</tr>

147

<tr>

148

<td>assertError($x)</td><td>Echoue si aucune erreur ou message incorrect de PHP n'arrive</td>

149

</tr>

150

</tbody>

151

</table>

152

Toutes les méthodes d'assertion peuvent recevoir une description optionnelle : cette description sert pour étiqueter le résultat.

153

Sans elle, une message par défaut est envoyée à la place : il est généralement suffisant. Ce message par défaut peut encore être encadré dans votre propre message si vous incluez "%s" dans la chaîne. Toutes les assertions renvoient vrai / true en cas de succès et faux / false en cas d'échec.

154

155

156

D'autres exemples...

157

<pre>

158

$variable = null;

159

$this->assertNull($variable, 'Should be cleared');

160

</pre>

161

...passera et normalement n'affichera aucun message. Si vous avez <a href="http://www.lastcraft.com/display_subclass_tutorial.php">configuré le testeur pour afficher aussi les succès</a> alors le message sera affiché comme tel.

162

<pre>

163

$this->assertIdentical(0, false, 'Zero is not false [%s]');

164

</pre>

165

Ceci échouera étant donné qu'il effectue une vérification sur le type en plus d'une comparaison sur les deux valeurs. La partie "%s" est remplacée par le message d'erreur par défaut qui aurait été affiché si nous n'avions pas fourni le nôtre. Cela nous permet d'emboîter les messages de test.

166

<pre>

167

$a = 1;

168

$b = $a;

169

$this->assertReference($a, $b);

170

</pre>

171

Échouera étant donné que la variable $b est une copie de $a.

172

<pre>

173

$this->assertWantedPattern('/hello/i', 'Hello world');

174

</pre>

175

Là, ça passe puisque la recherche est insensible à la casse et que donc hello est bien repérable dans Hello world.

176

<pre>

177

trigger_error('Disaster');

178

trigger_error('Catastrophe');

179

$this->assertError();

180

$this->assertError('Catastrophe');

181

$this->assertNoErrors();

182

</pre>

183

Ici, il y a besoin d'une petite explication : toutes passent !

184

185

186

Les erreurs PHP dans SimpleTest sont piégées et placées dans une queue. Ici la première vérification d'erreur attrape le message "Disaster" sans vérifier le texte et passe. Résultat : l'erreur est supprimée de la queue. La vérification suivante teste non seulement l'existence de l'erreur mais aussi le texte qui correspond : un autre succès. Désormais la queue est vide et le dernier test passe aussi. Si une autre erreur non vérifiée est encore dans la queue à la fin de notre méthode de test alors une exception sera rapportée dans le test. Notez que SimpleTest ne peut pas attraper les erreurs PHP à la compilation.

187

188

189

Les scénarios de test peuvent utiliser des méthodes bien pratiques pour déboguer le code ou pour étendre la suite...

190

<table>

191

<tbody>

192

<tr>

193

<td>setUp()</td><td>Est lancée avant chaque méthode de test</td>

194

</tr>

195

<tr>

196

<td>tearDown()</td><td>Est lancée après chaque méthode de test</td>

197

</tr>

198

<tr>

199

<td>pass()</td><td>Envoie un succès</td>

200

</tr>

201

<tr>

202

<td>fail()</td><td>Envoie un échec</td>

203

</tr>

204

<tr>

205

<td>error()</td><td>Envoi un évènement exception</td>

206

</tr>

207

<tr>

208

<td>sendMessage()</td><td>Envoie un message d'état aux systèmes d'affichage qui le supporte</td>

209

</tr>

210

<tr>

211

<td>signal($type, $payload)</td><td>Envoie un message défini par l'utilisateur au rapporteur du test</td>

212

</tr>

213

<tr>

214

<td>dump($var)</td><td>Effectue un print_r() formaté pour du déboguage rapide et grossier</td>

215

</tr>

216

<tr>

217

<td>swallowErrors()</td><td>Vide les erreurs de la queue</td>

218

</tr>

219

</tbody>

220

</table>

221

222

223

224

225

<h2>Etendre les scénarios de test</h2>

226

</a>

227

228

229

Bien sûr des méthodes supplémentaires de test peuvent être ajoutées pour créer d'autres types de scénario de test afin d'étendre le framework...

230

<pre>

231

require_once('simpletest/unit_tester.php');

232

233

class FileTester extends UnitTestCase {

234

function FileTester($name = false) {

235

$this->UnitTestCase($name);

236

}

237

238

function assertFileExists($filename, $message = '%s') {

239

$this->assertTrue(

240

file_exists($filename),

241

sprintf($message, 'File [$filename] existence check'));

242

}

243

}

244

</pre>

245

Ici la bibliothèque SimpleTest est localisée dans un répertoire local appelé simpletest. Pensez à le modifier pour votre propre environnement.

246

247

248

Ce nouveau scénario peut être hérité exactement comme un scénario de test classique...

249

<pre>

250

class FileTestCase extends FileTester {

251

252

function setUp() {

253

@unlink('../temp/test.txt');

254

}

255

256

function tearDown() {

257

@unlink('../temp/test.txt');

258

}

259

260

function testCreation() {

261

$writer = &new FileWriter('../temp/test.txt');

262

$writer->write('Hello');

263

$this->assertFileExists('../temp/test.txt');

264

}

265

}

266

</pre>

267

268

269

Si vous souhaitez un scénario de test sans toutes les assertions de UnitTestCase mais uniquement avec les vôtres propres, vous aurez besoin d'étendre la classe SimpleTestCase à la place. Elle se trouve dans simple_test.php en lieu et place de unit_tester.php. A consulter <a href="group_test_documentation.html">plus tard</a> si vous souhaitez incorporer les scénarios d'autres testeurs unitaires dans votre suite de test.

270

271

272

273

274

<h2>Lancer un unique scénario de test</h2>

275

</a>

276

277

278

Ce n'est pas souvent qu'il faille lancer des scénarios avec un unique test. Sauf lorsqu'il s'agit de s'arracher les cheveux sur un module à problème sans pour autant désorganiser la suite de test principale. Voici l'échafaudage nécessaire pour lancer un scénario de test solitaire...

279

<pre>

280

<?php

281

require_once('simpletest/unit_tester.php');

282

require_once('simpletest/reporter.php');

283

require_once('../classes/writer.php');

284

285

class FileTestCase extends UnitTestCase {

286

function FileTestCase() {

287

$this->UnitTestCase('File test');

288

}

289

}

290

291

$test = &new FileTestCase();

292

$test->run(new HtmlReporter());

293

294

</pre>

295

Ce script sera lancé tel que mais il n'y aura aucun succès ou échec avant que des méthodes de test soient ajoutées.

296

297

298

</div>

299

300

301

</div>

302

</body>

303

</html>

Older »