FPTest/pl: what changed

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

Old	New		Line
1	1		FPTest (Free Pascal Testing Framework) to framework do testów jednostkowych. Jest to rozwidlenie projektu DUnit2 stworzonego przez zmarłego Petera McNaba, ale poprawione specjalnie do użytku z kompilatorem Free Pascal.
2	2
3	3		Wiele z poniższych pozycji odnosi się do oryginalnego projektu DUnit2 (a teraz projektu FPTest) i tego, jak różni się on od projektu Delphi DUnit. Przedstawiono również informacje o migracji z [[fpcunit]].
4	4
5	5		## Właściwości
6	6
7	7		Cele projektowe stosowane podczas opracowywania projektu, niekoniecznie w określonej kolejności:
8	8
9	9		- Wprowadzenie do SetUpOnce i TearDownOnce dla TestCase i TestSuite.
10	10		- Poprawienie szybkość wykonywania testu.
11	11		- Wprowadzenie do wielu "projektów" i otwórzenie drogi do uruchamiania testów projektów w osobnych wątkach.
12	12		- Poprawienie łatwości korzystania z FPTest (częściowo poprzez dodanie więcej przykładowej dokumentacji).
13	13		- Upewnienie się, że TTestCase Constructors i Destructors wykonują się tylko raz, a nie dla każdej zawartej metody testowej.
14	14		- Zapewnienie nieglobalnych środków do udostępniania danych konfiguracji wysokiego poziomu między jednostkami testowymi.
15	15		- Bardziej dokładne wyniki testów i ulepszone informacje zwrotne.
16	16		- Zapewnienie wizualnej liczby wykrytych wycieków pamięci i testów bez funkcji Check().
17	17		- Zapewnia opcjonalną liczbę określającą, które wywołania funkcji Check() zakończyły się niepowodzeniem.
18	18		- Czyszczenie kodu poprzez usunięcie starszego kodu w FPTest, takiego jak Delphi Win32 i specyficzny kod .Net.
19	19		- Text Test Runner dla tych, którzy lubią konsole lub dla nienadzorowanych pakietów testów działających na serwerach.
20	20		- Nowy GUI Test Runner do [[fpGUI]] lub projektów opartych na LCL.
21	21		- Znacznie bardziej zaawansowany Test Decorator, który faktycznie działa (FPCUnit jest całkowicie zepsuty).
22	22		- Zarejestrowane testy można teraz organizować znacznie lepiej, budując hierarchię testów, ułatwiając zarządzanie (włączanie, wyłączanie, pomijanie testów itp.).
23	23
24	24		## Aktualny stan
25	25
26	26		- Nowy kod pozostaje zgodny z istniejącymi zestawami testów, które nie polegają na kodzie DUnit zmodyfikowanym przez użytkownika.
27	27		- Jeśli projekty testowe FPCUnit używają metod CheckXXX(), a nie metod AssertXXX(), przejście z FPCUnit do frameworka testowego FPTest powinno być dość bezbolesne.
28	28		- Nowy kod pozostaje kompatybilny z istniejącymi zestawami testów, które nie polegają na funkcjach TestFramework niskiego poziomu (np.TTestResult).
29	29		- Nowy kod wprowadza klasę Project i ProjectManager między GUI a TextTestRunners, aby pomóc w przyszłym wprowadzeniu wątkowych testów jednostkowych.
30	30		- Kod SetupOnce i TeardownOnce redukuje bałagan w węzłach i nazwach, w których wcześniej wymagane były dekoratory testów. Dekorator testów w FPCUnit ma te same wady projektowe i nie działa zgodnie z oczekiwaniami.
31	31		- Nowy kod dekoracji testów jest łatwiejszy do zrozumienia i rozszerzenia.
32	32		- Głębokość wywołań wykonania na procedurę TestCase została zmniejszona w celu poprawy wydajności testowania. (Ścieżka wykonania jest łatwiejsza do naśladowania, co ułatwia przyszłą zmianę kodu).
33	33		- Indywidualny czas procedury testowej jest teraz brany pod uwagę tylko dla metody testowej i nie obejmuje czasów SetUp i TearDown. Celem jest zapewnienie wyższej dokładności czasowej dla profilowania metod. Ogólny czas nadal obejmuje cały kod w nawiasach.
34	34		- Obsługiwane są wszystkie istniejące procedury sprawdzania. Dodano kilka nowych procedur sprawdzania, aby uzupełnić dostępny zakres.
35	35		- Utworzono nowe testy jednostkowe, aby zweryfikować, czy wszystkie procedury Check () wykrywają warunki powodzenia i niepowodzenia.
36	36		- Wszystkie testy przebiegają bez wycieków pamięci lub konieczności zezwalania na wycieki.
37	37		- Nowe testy jednostkowe autotestu są bardziej kompleksowe i obejmują sprawdzenie, czy warunki konfiguracji są prawidłowo spełnione przed wykonaniem wymaganych testów.
38	38		- Klasa Project obsługuje teraz rejestrację i wykonywanie zgrupowanych TestCases (TestSuites) i TestCases.
39	39		- Zliczanie testów można teraz wywoływać wewnątrz zagnieżdżonych dekoratorów testów, aby zapewnić 2 lub więcej danych wymiarowych.
40	40		- Niezoptymalizowane puste testy nadal kończą się niepowodzeniem.
41	41		- Testy, które nie wywołują funkcji Check(), mogą zostać uzbrojone globalnie, aby zakończyć się niepowodzeniem, tj. Z poziomu interfejsu GUI.
42	42		- Podobnie testy powodujące wycieki pamięci mogą opcjonalnie zostać uzbrojone globalnie, aby zakończyć się niepowodzeniem.
43	43		- Poszczególne testy mogą opcjonalnie zastąpić powyższe ustawienia GUI. (np. w przypadku znanego wycieku z komponentu strony trzeciej)
44	44		- Wszystkie testy, które zastępują ustawienia GUI, można opcjonalnie zidentyfikować po wykonaniu testu za pomocą dodatkowych kolorów węzłów.
45	45		- Liczba zastąpionych niepowodzeń testów jest uwzględniana na ekranie statusu wykonania.
46	46		- Przesłonięte testy (overridden), które w innym przypadku zakończyłyby się niepowodzeniem, generują osobną liczbę ostrzeżeń widoczną w zaktualizowanym interfejsie GUI i wynikach tekstowych.
47	47		- Nazwy metod testowych są oddzielone od procesu wykonywania, umożliwiając wyświetlanie informacji po kompilacji na poziomie GUI.
48	48		- Dodano generator raportów XML, uzupełniający zarówno GUITestRunner, jak i TextTestRunner.
49	49		- Dodano możliwość w GUITestRunner i TextTestRunner, aby pomijać (wykluczać) poszczególne testy niezależnie od włączonych/wyłączonych testów.
50	50		- Przyciski narzędzi do GUITestRunner ułatwiające sterowanie i pokazujące w czasie wykonywania, które opcje programowe zostały wybrane.
51	51
52	52		Aby ułatwić wczesne testowanie bez całkowitego ponownego opracowywania GUITestsRunner i TextTestRunner, pośredni moduł Proxy i zamiennik TTestResults zostały wstawione między GUI a nową TestFramework. Chociaż pierwotnym celem było całkowite przeprojektowanie GUI, klasy „Proxy” działają bardzo dobrze i mogą nie wymagać dalszej pracy.
53	53
54	54		## Pobieranie kodu źródłowego
55	55
56	56		Kod źródłowy jest bezpłatnie dostępny z GitHub za pomocą następującego polecenia:
57	57
58	58		``` bash
59	59		git clone git://github.com/graemeg/fptest.git
60	60		```
61	61
62	62		lub
63	63
64	64		``` bash
65	65		git clone https://github.com/graemeg/fptest.git
66	66		```
67	67
68	68		Jeśli nie masz zainstalowanego [Git](http://git-scm.com/), zawsze możesz pobrać paczkę z kodem źródłowym (archiwum), używając następującego adresu URL.
69	69
70		-	~~[`https://github.com/graemeg/fptest/tarball/master`](https://github.com/graemeg/fptest/tarball/master)~~
	70	+	```text
	71	+	https://github.com/graemeg/fptest/tarball/master
	72	+	```
71	73
72	74		Projekt FPTest jest w trakcie aktywnego rozwoju, więc kod i dokumentacja są stale ulepszane. Z tego powodu bardzo polecam pobieranie kodu źródłowego przez git, a nie jako archiwum.
73	75
74	76		## Dokumentacja
75	77
76	78		Dokumentację FPTest można znaleźć w katalogu docs jako pliki HTML.
77	79
78	80		## Przykład użycia Test
79	81
80	82		To jest przykładowy projekt testowania w konsoli
81	83
82	84		``` pascal
83	85		program project1;
84	86
85	87		{$mode objfpc}{$H+}
86	88
87	89		uses
88	90		Classes,
89	91		TextTestRunner,
90	92		sample_tests;
91	93
92	94		begin
93	95		// Rejestrowanie wszystkich testów
94	96		sample_tests.RegisterTests;
95	97
96	98		RunRegisteredTests;
97	99		end.
98	100		```
99	101
100	102		oraz moduł zawierający rzeczywiste testy...
101	103
102	104		``` pascal
103	105		unit sample_tests;
104	106
105	107		{$mode objfpc}{$H+}
106	108
107	109		interface
108	110
109	111		uses
110	112		TestFramework; // wymagane dla odwołania się do TTestCase i CheckXXX()
111	113
112	114		type
113	115		TTestCaseFirst = class(TTestCase)
114	116		published
115	117		procedure TestWarning;
116	118		procedure TestOne;
117	119		procedure TestNoError;
118	120		procedure TestThree;
119	121		procedure TestFour;
120	122		end;
121	123
122	124		procedure RegisterTests;
123	125
124	126		implementation
125	127
126	128		uses
127	129		SysUtils;
128	130
129	131		{ Tutaj rejestrujemy wszystkie nasze klasy testowe }
130	132		procedure RegisterTests;
131	133		begin
132	134		TestFramework.RegisterTest(TTestCaseFirst.Suite);
133	135		end;
134	136
135	137		{ TTestCaseFirst }
136	138
137	139		procedure TTestCaseFirst.TestWarning;
138	140		begin
139	141		// Nic tu nie rób - powinno wywołać ostrzeżenie
140	142		end;
141	143
142	144		procedure TTestCaseFirst.TestOne;
143	145		begin
144	146		Check(1 + 1 = 3, 'Katastrofalna porażka arytmetyczna!');
145	147		end;
146	148
147	149		procedure TTestCaseFirst.TestNoError;
148	150		begin
149	151		Check(1 + 1 = 2, 'Katastrofalna porażka arytmetyczna!');
150	152		end;
151	153
152	154		procedure TTestCaseFirst.TestThree;
153	155		var
154	156		s: string;
155	157		begin
156	158		s := 'cześć';
157	159		CheckEquals('Cześć', s, 'Niepowodzenie CheckEquals');
158	160		end;
159	161
160	162		procedure TTestCaseFirst.TestFour;
161	163		var
162	164		x, y: integer;
163	165		begin
164	166		x := 10;
165	167		y := 0;
166	168		Check(x / y = 0, 'Niepowodzenie dla 1');
167	169		end;
168	170
169	171		end.
170	172		```
171	173
172	174		## Zrzuty ekranu
173	175
174	176		Oto zrzut ekranu z wyjściem narzędzia Text Test Runner.
175	177
176	178		![](/wiki-images/8/80/Fptest_console.png)
177	179
178	180		To jest zrzut ekranu z GUI Test Runner (przy użyciu fpGUI Toolkit) do uruchomienia zestawu testów tiOPF.
179	181
180	182		![](/wiki-images/0/0a/Fptest_fpgui.png)
181	183
182	184		## Jak wypada to w porównaniu do FPCUnit?
183	185
184	186		Ja (Graeme Geldenhuys) przez długi czas byłem użytkownikiem FPCUnit. Współtworzyłem i pomogłem rozszerzyć projekt FPCUnit. Ale FPCUnit ma pewne wady projektowe, co sprawia, że jest przydatny głównie w mniejszych projektach i mniej skomplikowanych zestawach testowych. Dekoratory testów FPCUnit, jak Setup/Teardown itp. są poważnie uszkodzone. Framework testowy FPTest rozwiązuje wszystkie te problemy, dodaje o wiele więcej funkcji, jest łatwiejszy w zarządzaniu testami i wykonuje je szybciej niż równoważne projekty FPCUnit lub DUnit.
185	187
186	188		Dobra wiadomość jest taka, że nie jesteś zmuszony wybierać między żadnym z frameworków testowych. Lata temu dołączyłem interfejs zgodności DUnit/FPTest do FPCUnit. Daje to łatwiejszą drogę do przejścia z FPCUnit do FPTest. Jeśli więc projektujesz swoje zestawy testów przy użyciu wywołań CheckXXX() (zamiast wywołań AssertXXX()), możesz później łatwiej przełączyć się na framework FPTest bez konieczności zmiany kodu testowego.
187	189
188	190		## Zobacz także
189	191
190	192		- [[fpcunit/pl\|fpcunit]] Struktura testów jednostkowych dostarczana z FPC
191	193
192	194		---
193	195		From the Free Pascal wiki, page "FPTest/pl", as it stood on 2024-05-25 after a change by Slawek, 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