FPTest/fr: what changed

Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		FPTest (Free Pascal Testing Framework) est un framework de test d'unité. C'est une branche (fork) du projet DUnit2 créé par feu Peter McNab, mais adapté spécialement pour l'utilisation avec le compilateur Free Pascal.
2	2
3	3		La plupart des articles listés ci-dessous sont relatifs au projet DUnit2 original (et maintenant le projet FPTest) et comment il diffère du projet DUnit. L'information sur la migration depuis [[fpcunit/fr\|fpcunit]] est aussi présentée.
4	4
5	5		# Caractéristiques
6	6
7	7		Objectifs de conception utilisés lors du développement du projet, pas nécessairement dans un ordre particulier :
8	8
9	9		- Introduire SetUpOnce et TearDownOnce par TestCase et TestSuite.
10	10		- Améliore la vitesse d'exécutiojn des tests
11	11		- Introduit les projets multiples et ouvre la voie à l'exécution de projet de test dans des threads séparés.
12	12		- Améliore la facilité d'utilisation de FPTest (en partie en ajoutant plus d'exemples dans la documentation).
13	13		- Garantit que les Constructeurs et Destructeurs de TTestCase s'exécutent une seule fois, pas pour chaque méthode de test contenue.
14	14		- Fournir un moyen non global var pour partager des données de configuration de haut niveau entre les unités de test.
15	15		- Des résultats de test plus précis et des retours améliorés.
16	16		- Fournit un décompte visuel des fuites de mémoire détectées et des tests sans Check().
17	17		- Fournit un décompte facultatif pour identifier quels appels Check() ont échoué.
18	18		- Nettoyage du code, en supprimant dans FPTest le code "légataire" (legacy), tel que le code spécifique Delphi Win32 et .Net.
19	19		- Test Runner en mode texte pour ceux qui aiment les consoles ou pour la suite de tests sans assistance qui s'exécute sur les serveurs.
20	20		- Une nouvelle IHM du Test Runner pour [[fpGUI/fr\|fpGUI]] ou les projet basés sur la LCL.
21	21		- Un décorateur de test encore plus avancé qui tourne actuellement (celui de FPCUnit est totalement délabré).
22	22		- Les tests enregistrés peuvent être bien mieux organisés, en construisant une hiérarchie de tests, les rendant plkus faciles à gérer (activer, désactiver, sauter les tests etc.)
23	23
24	24		# Etat actuel
25	25
26	26		- Le nouveau code reste compatible avec les suites de test existantes ne s'appuyant pas sur le code DUnit modifié par l'utilisateur.
27	27		- Si vos projets de test FPCUnit utilise les méthodes CheckXXX() et non pas les méthodes AssertXXX(), il sera plutôt facile de basculer de FPCUnit vers le framework de test FPTest.
28	28		- Le nouveau code reste compatible avec les suites de test existantes ne s'appuyant pas sur les fonctions TestFramework de bas niveau (p.ex. TTestResult).
29	29		- Le nouveau code introduit les classes Project et ProjectManager entre l'IHM et les TextTestRunners pour assister la future introduction du test d'unité avec des threads.
30	30		- Le code de SetupOnce et TeardownOnce réduit le désordre de noeud et de nom où les décorateurs aurait été requis avant. !e décorateur de test dans FPCUnit a des défauts de conception, et ne marche pas comme attendu.
31	31		- Le nouveau code de décoration de test est plus facile à comprendre et étendre.
32	32		- La profondeur d'appel à l'exécution par TestCase a été réduite dans un effort pour améliorer l'efficacité du test. (le chemin d'exécution est plus facile à suivre et facilite les futurs changements dans le code).
33	33		- Le chronométrage de la procédure de test est maintenant pris seulement sur la méthode de test et exclut les temps de SetUp et TearDown. L'intention étant de fournir une pkus haute précision du chronométrage pour le profilage de méthode. Le temps global englobe encore tout le code.
34	34		- Toutes les procédures Check existantes sont supportées. Plusieurs nouvelles procédures Check ont été ajoutées pour compléter l'éventail disponible.
35	35		- De nouvelles unités ont été créées pour vérifier que toutes les procédures Check() détectent les conditions passer et échouer.
36	36		- Tous les tests s'exécutent sans fuite de mémoire ou besoin de permettre des fuites.
37	37		- De nouveaux tests d'unités auto-test sont plus compréhensible en incluant des contrôles pour assurer les conditions de configuration sont proprement satisfaites avant d'exécuter les tests requis.
38	38		- Une classe Project gère maintenant l'enregistrement et l'exécution des TestCases groupés (TestSuites) et des TestCases.
39	39		- Les tests comptés peuvent maintenant être invoqués dans les décorateurs de test pour fournir des données de test à 2 dimensions ou plus.
40	40		- Les tests vides non optimisés échouent toujours.
41	41		- Les tests qui n'appellent pas Check() peuvent être globalement armés pour échouer, i.e. depuis l'IHM.
42	42		- Similairement les tests provoquant des fuites de mémoire peuvent être globalement armés pour échouer.
43	43		- Des test individuels peuvent optionnellement surcharger les réglages IHM (i.e. où un composant tierce partie a une fuite connue).
44	44		- Tous les tests qui surchargent les réglages IHM peuvent optionnellement être identifiés après l'exécution du test par des couleurs de noeud additionnelles.
45	45		- Un décompte des échecs des tests surchargés est inclus dans l'affichage du status d'exécution.
46	46		- Les tests surchargés qui auraient autrement échoué génèrent un décompte d'avertissements séparé dans l'IHM et la sortie texte mise à jour.
47	47		- Les noms de méthodes de test sont découplées du processus d'exécution, permettant aux informations post-compilation d'être affichées au niveau IHM.
48	48		- Générateur de rapport XML ajouté, complétant à la fois GUITestRunner et TextTestRunner.
49	49		- Ajoutée la capacité de GUITestRunner et TextTestRunner ensemble, de sauter (exclure) des tests individuels séparée de l'activation/désactivation de test.
50	50		- Des boutons d'outil à GUITestRunner pour faciliter le contrôle et montrer à l'exécution quelles options ont été sélectionnées.
51	51
52	52		Pour faciliter les tests précoces sans reconstruire complètement GUITestsRunner et TextTestRunner, une unité proxy intermédiaire et un remplacement des TTestResults ont été intercalés entre l'interface graphique et le nouveau framework de test. Bien que l'objectif initial était éventuellement de repenser complètement l'interface graphique, les classes "Proxy" fonctionnent très bien et peuvent ne pas nécessiter de travail supplémentaire.
53	53
54	54		# Obtenir le code source
55	55
56	56		Le code source est librement accessible depuis GitHub en utilisant la commande suivante :
57	57
58	58		``` bash
59	59		git clone git://github.com/graemeg/fptest.git
60	60		```
61	61
62	62		ou
63	63
64	64		``` bash
65	65		git clone https://github.com/graemeg/fptest.git
66	66		```
67	67
68	68		Si vous n'avez pas installé [Git](http://git-scm.com/), vous pouvez aussi récupérer une archive tarball du code source, en utilisant l'URL suivante.
69	69
70	70		[`https://github.com/graemeg/fptest/tarball/master`](https://github.com/graemeg/fptest/tarball/master)
71	71
72	72		Le projet FPTest est en développement actif, ainsi le code et la documentation sont constamment améliorés. Pour cette raison, je vous recommande hautement de récupérer le code source via Git au lieu de l'archive tarball.
73	73
74	74		# Documentation
75	75
76	76		La documentation eut être trouvée dans le répertoire docs en fichiers HTML.
77	77
78	78		# Exemple de test
79	79
80	80		Voici un échantillon de projet de test en console.
81	81
82	82		``` pascal
83	83		program project1;
84	84
85	85		{$mode objfpc}{$H+}
86	86
87	87		uses
88	88		Classes,
89	89		TextTestRunner,
90	90		sample_tests;
91	91
92	92		begin
93	93		// Register all tests
94	94		sample_tests.RegisterTests;
95	95
96	96		RunRegisteredTests;
97	97		end.
98	98		```
99	99
100	100		et l'unité contenant les tests actuels ...
101	101
102	102		``` pascal
103	103		unit sample_tests;
104	104
105	105		{$mode objfpc}{$H+}
106	106
107	107		interface
108	108
109	109		uses
110	110		TestFramework; // required for TTestCase and CheckXXX() references
111	111
112	112		type
113	113		TTestCaseFirst = class(TTestCase)
114	114		published
115	115		procedure TestWarning;
116	116		procedure TestOne;
117	117		procedure TestNoError;
118	118		procedure TestThree;
119	119		procedure TestFour;
120	120		end;
121	121
122	122		procedure RegisterTests;
123	123
124	124		implementation
125	125
126	126		uses
127	127		SysUtils;
128	128
129	129		{ here we register all our test classes }
130	130		procedure RegisterTests;
131	131		begin
132	132		TestFramework.RegisterTest(TTestCaseFirst.Suite);
133	133		end;
134	134
135	135		{ TTestCaseFirst }
136	136
137	137		procedure TTestCaseFirst.TestWarning;
138	138		begin
139	139		// Do nothing here - should cause a Warning
140	140		end;
141	141
142	142		procedure TTestCaseFirst.TestOne;
143	143		begin
144	144		Check(1 + 1 = 3, 'Catastrophic arithmetic failure!');
145	145		end;
146	146
147	147		procedure TTestCaseFirst.TestNoError;
148	148		begin
149	149		Check(1 + 1 = 2, 'Catastrophic arithmetic failure!');
150	150		end;
151	151
152	152		procedure TTestCaseFirst.TestThree;
153	153		var
154	154		s: string;
155	155		begin
156	156		s := 'hello';
157	157		CheckEquals('Hello', s, 'Failed CheckEquals');
158	158		end;
159	159
160	160		procedure TTestCaseFirst.TestFour;
161	161		var
162	162		x, y: integer;
163	163		begin
164	164		x := 10;
165	165		y := 0;
166	166		Check(x / y = 0, 'Failed on 1');
167	167		end;
168	168
169	169		end.
170	170		```
171	171
172	172		# Captures d'écran
173	173
174	174		Voici une captuire d'écran d'une sortie du Test Runner en mode texte.
175	175
176		-	~~<figure>~~
177		-	~~<img src="fptest_console.png" title="échantillon de sortie de la console Test Runner en mode texte." />~~
178		-	~~<figcaption>échantillon de sortie de la console Test Runner en mode texte.</figcaption>~~
179		-	~~</figure>~~
	176	+	![](/wiki-images/8/80/Fptest_console.png)
180	177
181	178		Voici une capture d'écran du Test Runner avec IHM (utilisant le Toolkit fpGUI) pour exécuter la suite de tests tiOPF.
182	179
183		-	~~<figure>~~
184		-	~~<img src="fptest_fpgui.png" title="Une capture d'écran de l'IHM Test Runner utilisant le toolkit fpGUI." />~~
185		-	~~<figcaption>Une capture d'écran de l'IHM Test Runner utilisant le toolkit fpGUI.</figcaption>~~
186		-	~~</figure>~~
	180	+	![](/wiki-images/0/0a/Fptest_fpgui.png)
187	181
188	182		# Comment le comparer à FPCUnit?
189	183
190	184		J'ai (Graeme Geldenhuys) été un utilisateur de longue date de FPCUnit. J'ai contribué à l'extension du projet FPCUnit. Mais FPCUnit a quelques défauts de conception qui le rendent plus utiles pour les projets plus petits et des suites de tests moins compliquées. Les décorateurs de test de FPCUnit, Setup/Teardown etc sont sévèrement délabrés. Le framework de test surmonte tous ces problèmes, ajoute de nouvelles fonctionnalités, il est plus facile de gérer vos tests, et les exécute plus rapidement que des projets équivalents FPCUnit ou Dunit.
191	185
192	186		La bonne nouvelle est vous n'êtes pas forcés de choisir entre les frameworks de test. Il y plusieurs années, j'ai inclus une interface de compatibilité DUnit/FPTest à FPCUnit. Ce qui vous donne un bon chemin de mise à jour de FPCUnit vers FPTest. Donc si vous concevez votre suite de test en utilisant des appels CheckXXX() (au lieu des appels AssertXXX()), vous pourrez plus tard basculer facilement vers le framework FPTest sans avoir besoin de changer votre code de test.
193	187
194	188		# Voir aussi
195	189
196	190		- [[fpcunit/fr\|fpcunit]] Framework de test d'unité fourni avec FPC
197	191		- <https://www.freepascal.org/~michael/articles/unittesting/unittesting.pdf> Article sur le test d'unité (DUnit).
198	192
199	193		---
200	194		From the Free Pascal wiki, page "FPTest/fr", as it stood on 2020-02-16 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).

Back to history