Skip to content

Commit 242dc79

Browse files
author
Brice Favre
committed
WIP Translation test-doubles, last line:146
1 parent e7b86f0 commit 242dc79

File tree

1 file changed

+24
-29
lines changed

1 file changed

+24
-29
lines changed

src/6.1/fr/test-doubles.xml

Lines changed: 24 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
<para>
1414
<indexterm><primary>Système à tester</primary></indexterm>
1515

16-
Parfois il est juste parfaitement difficile de tester un système en cours de test
16+
Parfois il est parfaitement difficile de juste tester un système en cours de test
1717
(SCT) parce qu'il dépend d'autres composants qui ne peuvent pas
1818
être utilisés dans l'environnement de test. Ceci peut provenir du fait
1919
qu'ils ne sont pas disponibles, qu'ils ne retournent pas les résultats
@@ -45,34 +45,32 @@
4545
</para>
4646

4747
<para>
48-
4948
La méthode <literal>createMock($type)</literal> retourne immédiatement une doublure de
5049
test pour le type spécifié (interface ou classe). La création de cette doublure est
5150
effectuée en suivant par défaut les bonne pratiques (les méthodes <literal>__construct()
5251
</literal> et <literal>__clone()</literal> de la classe originale ne sont pas executées
5352
et les arguments passés à une méthode de la doublure de tests ne sont pas clonés. Si ce
5453
comportement par défaut ne correspondent pas à ce don vous avez besoin vous pouvez
5554
alors utiliser la méthode <literal>getMockBuilder($type)</literal> pour personnaliser la
56-
génération de doublure de test en utilisant un chaînage de méthode (fluent interface).
55+
génération de doublure de test en utilisant un interface souple (fluent interface).
5756
</para>
5857

5958
<para>
60-
Par défaut, toutes les méthodes de la classe originelle sont remplacées
61-
par une implémentation fictive qui se contente de retourner
62-
<literal>NULL</literal> (sans appeler la méthode originelle).
63-
En utilisant la méthode <literal>will($this->returnValue())</literal>
59+
Par défaut, toutes les méthodes de la classe originelle sont remplacées par une
60+
implémentation fictive qui se contente de retourner <literal>NULL</literal> (sans
61+
appeler la méthode originelle). En utilisant la méthode <literal>will($this->returnValue())</literal>
6462
par exemple, vous pouvez configurer ces implémentations fictives pour
6563
retourner une valeur donnée quand elles sont appelées.
6664
</para>
6765

6866
<note>
69-
<title>Limitations</title>
67+
<title>Limitations: méthodes final, private et static</title>
7068

7169
<para>
7270
Merci de noter que les méthodes <literal>final</literal>, <literal>private</literal>
73-
et <literal>static</literal> ne peuvent pas être remplacées par un bouchon (stub) ou un simulacre (mock). Elles seront
74-
ignorées par la fonction de doublure de test de PHPUnit et conserveront leur comportement
75-
initial.
71+
et <literal>static</literal> ne peuvent pas être remplacées par un bouchon (stub) ou un simulacre (mock).
72+
Elles seront ignorées par la fonction de doublure de test de PHPUnit et conserveront
73+
leur comportement initial.
7674
</para>
7775
</note>
7876

@@ -96,12 +94,12 @@
9694

9795
<xref linkend="test-doubles.stubs.examples.StubTest.php" /> montre comment
9896
la méthode de bouchonnage appelle et configure des valeurs de retour. Nous utilisons
99-
d'abord la méthode <literal>getMock()</literal> qui est fournie par la classe
100-
<literal>PHPUnit_Framework_TestCase</literal> pour configurer un objet bouchon
101-
qui ressemble à un objet de <literal>UneClasse</literal>
97+
d'abord la méthode <literal>createMock()</literal> qui est fournie par la classe
98+
<literal>PHPUnit\Framework\TestCase</literal> pour configurer un objet bouchon
99+
qui ressemble à un objet de <literal>SomeClass</literal>
102100
(<xref linkend="test-doubles.stubs.examples.SomeClass.php" />). Ensuite nous
103101
utilisons <ulink url="http://martinfowler.com/bliki/FluentInterface.html">l'interface souple</ulink>
104-
que PHPUnit fournit pour indiquer le comportement de ce bouchon. En essence,
102+
que PHPUnit fournit pour indiquer le comportement de ce bouchon. En substance,
105103
cela signifie que vous n'avez pas besoin de créer plusieurs objets temporaires
106104
et les relier ensemble ensuite. Au lieu de cela, vous chaînez les appels de méthode
107105
comme montré dans l'exemple. Ceci amène à un code plus lisible et "souple".
@@ -110,9 +108,9 @@
110108
<example id="test-doubles.stubs.examples.SomeClass.php">
111109
<title>La classe que nous voulons bouchonner</title>
112110
<programlisting><![CDATA[<?php
113-
class UneClasse
111+
class SomeClass
114112
{
115-
public function faireQuelquechose()
113+
public function doSomething()
116114
{
117115
// Faire quelque chose.
118116
}
@@ -121,30 +119,27 @@ class UneClasse
121119
</example>
122120

123121
<example id="test-doubles.stubs.examples.StubTest.php">
124-
<indexterm><primary>getMock()</primary></indexterm>
125-
<indexterm><primary>expects()</primary></indexterm>
122+
<indexterm><primary>createMock()</primary></indexterm>
126123
<indexterm><primary>method()</primary></indexterm>
127-
<indexterm><primary>will()</primary></indexterm>
128-
<indexterm><primary>returnValue()</primary></indexterm>
124+
<indexterm><primary>willReturn()</primary></indexterm>
129125
<title>Bouchonner un appel de méthode pour retourner une valeur fixée</title>
130126
<programlisting><![CDATA[<?php
131-
require_once 'UneClasse.php';
127+
use PHPUnit\Framework\TestCase;
132128
133-
class BouchonTest extends PHPUnit_Framework_TestCase
129+
class StubTest extends TestCase
134130
{
135131
public function testBouchon()
136132
{
137133
// Créer un bouchon pour la classe UneClasse.
138-
$bouchon = $this->getMock('UneClasse');
134+
$stub = $this->createMock(SomeClass::class);
139135
140136
// Configurer le bouchon.
141-
$bouchon->expects($this->any())
142-
->method('faireQuelquechose')
143-
->will($this->returnValue('foo'));
137+
$stub->method('doSomething')
138+
->willReturn('foo');
144139
145-
// Appeler $bouchon->faireQuelquechose() va maintenant retourner
140+
// Appeler $stub->doSomething() va maintenant retourner
146141
// 'foo'.
147-
$this->assertEquals('foo', $bouchon->faireQuelquechose());
142+
$this->assertEquals('foo', $stub->doSomething());
148143
}
149144
}
150145
?>]]></programlisting>

0 commit comments

Comments
 (0)