/
running-tests.texy
239 lines (161 loc) · 10.3 KB
/
running-tests.texy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
Executarea testelor
*******************
.[perex]
Partea cea mai vizibilă a Nette Tester este programul de execuție a testelor din linia de comandă. Acesta este extrem de rapid și robust, deoarece pornește automat toate testele ca procese separate, în paralel, în mai multe fire de execuție. De asemenea, poate rula singur în așa-numitul mod de supraveghere.
Executantul de teste Nette Tester este invocat din linia de comandă. Ca parametru, vom trece directorul de testare. Pentru directorul curent este suficient să introduceți un punct:
/--pre .[terminal]
vendor/bin/tester .
\--
Atunci când este invocat, Test Runner va scana directorul specificat și toate subdirectoarele și va căuta teste, care sunt fișierele `*.phpt` și `*Test.php`. De asemenea, citește și evaluează [adnotările |test-annotations] acestora pentru a ști care dintre ele și cum să le execute.
Apoi va executa testele. Pentru fiecare test efectuat, runner tipărește un caracter pentru a indica progresul:
- <code style="color: #CCC; background-color: #000">.</code>.. - test trecut
- <code style="color: #CCC; background-color: #000">s</code> - testul a fost sărit
- <code style="color: #FFF; background-color: #900">F</code> - testul a eșuat
Rezultatul poate arăta astfel:
/--pre .[terminal]
_____ ___ ___ _____ ___ ___
|_ _/ __)( __/_ _/ __)| _ )
|_| \___ /___) |_| \___ |_|_\ v2.5.2
Note: No php.ini is used.
PHP 8.3.2 (cli) | php -n | 8 threads
........s..........................
<span style="color: #FFF; background-color: #090">OK (35 tests, 1 skipped, 1.7 seconds)</span>
\--
Când îl rulați din nou, acesta rulează mai întâi testele care au eșuat în timpul rulării anterioare, astfel încât veți ști imediat dacă ați remediat eroarea.
Codul de ieșire al testerului este zero dacă niciunul nu dă greș. În caz contrar, este diferit de zero.
.[warning]
Tester rulează procesele PHP fără `php.ini`. Mai multe detalii în secțiunea [Own php.ini |#Own php.ini].
Opțiuni de linie de comandă .[#toc-command-line-options]
========================================================
Obținem prezentarea generală a opțiunilor din linia de comandă prin rularea Tester fără parametri sau cu opțiunea `-h`:
/--pre .[terminal]
_____ ___ ___ _____ ___ ___
|_ _/ __)( __/_ _/ __)| _ )
|_| \___ /___) |_| \___ |_|_\ v2.5.2
Usage:
tester [options] [<test file> | <directory>]...
Options:
-p <path> Specify PHP interpreter to run (default: php).
-c <path> Look for php.ini file (or look in directory) <path>.
-C Use system-wide php.ini.
-d <key=value>... Define INI entry 'key' with value 'value'.
-s Show information about skipped tests.
--stop-on-fail Stop execution upon the first failure.
-j <num> Run <num> jobs in parallel (default: 8).
-o <console|console-lines|tap|junit|log|none> (de exemplu, -o junit:output.xml)
Specifică unul sau mai multe formate de ieșire cu nume de fișier opțional.
-w | --watch <path> Watch directory.
-i | --info Show tests environment info and exit.
--setup <path> Script for runner setup.
--temp <path> Calea către directorul temporar. Predefinit de sys_get_temp_dir().
--colors [1|0] Enable or disable colors.
--coverage <path> Generate code coverage report to file.
--coverage-src <path> Path to source code.
-h | --help This help.
\--
-p <path> .[filter]
-------------------
Specifică binarul PHP care va fi utilizat pentru a rula testele. În mod implicit este `php`.
/--pre .[terminal]
tester -p /home/user/php-7.2.0-beta/php-cgi tests
\--
-c <path> .[filter]
-------------------
Specifică ce `php.ini` va fi utilizat la rularea testelor. În mod implicit, nu se utilizează niciun php.ini. Consultați [Own php.ini |#Own php.ini] pentru mai multe informații.
-C .[filter]
------------
Se utilizează un sistem la nivel de sistem `php.ini`. Deci, pe platforma UNIX, toate fișierele `/etc/php/{sapi}/conf.d/*.ini`. A se vedea secțiunea [Own php.ini |#Own php.ini].
-d <key=value> .[filter]
------------------------
Stabilește valoarea directivei de configurare PHP pentru teste. Parametrul poate fi utilizat de mai multe ori.
/--pre .[terminal]
tester -d max_execution_time=20
\--
-s
---
Vor fi afișate informații despre testele omise.
--stop-on-fail .[filter]
------------------------
Testerul oprește testarea la primul test eșuat.
-j <num> .[filter]
------------------
Testele se execută în `<num>` precesiuni paralele. Valoarea implicită este 8. Dacă dorim să rulăm testele în serie, folosim valoarea 1.
-o <console|console-lines|tap|junit|log|none> .[filter]
-------------------------------------------------------
Format de ieșire. Formatul implicit este cel de consolă. Puteți specifica numele fișierului în care va fi scrisă ieșirea (de exemplu, `-o junit:output.xml`). Opțiunea `-o` poate fi repetată de mai multe ori pentru a genera mai multe formate deodată.
- `console`: la fel ca în mod implicit, dar logo-ul ASCII nu este tipărit în acest caz.
- `console-lines`: similar cu consola, dar rezultatul fiecărui test este listat pe o linie separată cu mai multe informații
- `tap`: [format TAP |https://en.wikipedia.org/wiki/Test_Anything_Protocol] adecvat pentru procesarea pe mașină
- `junit`: format JUnit XML, adecvat și pentru procesarea pe mașină
- `log`: Afișează progresul testelor. Toate testele eșuate, sărite și, de asemenea, cele reușite
- `none`: nu se tipărește nimic
''-w | --watch <path>'' .[filter]
---------------------------------
Tester nu se termină după ce testele sunt finalizate, ci continuă să ruleze și să urmărească fișierele PHP din directorul dat. În cazul în care se modifică, testele se execută din nou. Parametrul poate fi utilizat de mai multe ori dacă dorim să monitorizăm mai multe directoare.
Este la îndemână în timpul refactorizării unei biblioteci sau a depanării testelor.
/--pre .[terminal]
tester --watch src tests
\--
''-i | --info''' .[filter]
--------------------------
Afișează informații despre un mediu de execuție a unui test. De exemplu:
/--pre .[terminal]
tester -p /usr/bin/php7.1 -c tests/php.ini --info
<span style="color: #0F0">PHP binary:</span>
/usr/bin/php7.1
<span style="color: #0F0">PHP version:</span>
7.1.7-1+0~20170711133844.5+jessie~1.gbp5284f4 (cli)
<span style="color: #0F0">Code coverage engines:</span>
(not available)
<span style="color: #0F0">Loaded php.ini files:</span>
/var/www/dev/demo/tests/php.ini
<span style="color: #0F0">PHP temporary directory:</span>
/tmp
<span style="color: #0F0">Loaded extensions:</span>
Core, ctype, date, dom, ereg, fileinfo, filter, hash, ...
\--
--setup <path> .[filter]
------------------------
Tester încarcă scriptul PHP dat la pornire. Variabila `Tester\Runner\Runner $runner` este disponibilă în acesta. Să presupunem că fișierul `tests/runner-setup.php`:
```php
$runner->outputHandlers[] = new MyOutputHandler;
```
și executăm Tester:
/--pre .[terminal]
tester --setup tests/runner-setup.php tests
\--
--temp <path> .[filter]
-----------------------
Stabilește o cale către directorul pentru fișierele temporare ale Tester. Valoarea implicită este returnată de `sys_get_temp_dir()`. Atunci când valoarea implicită nu este validă, veți fi anunțat.
Dacă nu suntem siguri ce director este utilizat, putem rula Tester cu parametrul `--info`.
--colors 1|0 .[filter]
----------------------
Tester detectează în mod implicit un terminal colorabil și își colorează ieșirea. Această opțiune se suprapune detecției automate. Putem seta colorarea la nivel global printr-o variabilă de mediu de sistem `NETTE_TESTER_COLORS`.
--coverage <path> .[filter]
---------------------------
Tester va genera un raport cu o imagine de ansamblu a gradului de acoperire a codului sursă de către teste. Această opțiune necesită activarea extensiei PHP [Xdebug |https://xdebug.org/] sau [PCOV |https://github.com/krakjoe/pcov] sau PHP 7 cu PHPDBG SAPI, care este mai rapid. Extensia fișierului de destinație determină formatul conținutului. HTML sau Clover XML.
/--pre .[terminal]
tester tests --coverage coverage.html # HTML report
tester tests --coverage coverage.xml # Clover XML report
\--
Prioritatea pentru alegerea mecanismului de colectare este următoarea:
1) PCOV
2) PHPDBG
3) Xdebug
Testele extinse pot eșua în timpul rulării de către PHPDBG din cauza epuizării memoriei. Colectarea datelor de acoperire este o operațiune consumatoare de memorie. În acest caz, apelarea `Tester\CodeCoverage\Collector::flush()` în cadrul unui test poate fi de ajutor. Aceasta va arunca datele colectate în fișier și va elibera memorie. Atunci când colectarea datelor nu este în curs de desfășurare sau când se utilizează Xdebug, apelarea nu are niciun efect.
"Un exemplu de raport HTML":https://files.nette.org/tester/coverage.html cu acoperire de cod.
--coverage-src <path> .[filter]
-------------------------------
O folosim simultan cu opțiunea `--coverage`. Opțiunea `<path>` este o cale către codul sursă pentru care generăm raportul. Poate fi utilizată în mod repetat.
Propriu php.ini .[#toc-own-php-ini]
===================================
Tester rulează procesele PHP cu opțiunea `-n`, ceea ce înseamnă că nu se încarcă `php.ini` (nici măcar cea de la `/etc/php/conf.d/*.ini` în UNIX). Aceasta asigură același mediu pentru testele rulate, dar dezactivează și toate extensiile PHP externe încărcate în mod obișnuit de PHP de sistem.
Dacă doriți să păstrați configurația sistemului, utilizați parametrul `-C`.
Dacă aveți nevoie de anumite extensii sau de anumite setări INI speciale, vă recomandăm să creați propriul fișier `php.ini` și să-l distribuiți între teste. Apoi executăm Tester cu opțiunea `-c`, de exemplu `tester -c tests/php.ini`. Fișierul INI poate arăta astfel:
```ini
[PHP]
extension=php_pdo_mysql.dll
extension=php_pdo_pgsql.dll
memory_limit=512M
```
Rularea Tester cu un sistem `php.ini` în UNIX, de exemplu `tester -c /etc/php/cgi/php.ini`, nu încarcă alte INI din `/etc/php/conf.d/*.ini`. Acesta este comportamentul PHP, nu al Testerului.