@@ -183,13 +183,13 @@ one matching parameter of a variable length argument list.
183183Special patterns
184184^^^^^^^^^^^^^^^^
185185
186- Suboject pattern
187- """"""""""""""""
186+ Subobject pattern
187+ """""""""""""""""
188188
189189.. code :: C
190190
191191 verify_json(txt,
192- "suboject ={"
192+ "subobject ={"
193193 " key1=%s,"
194194 " key2=%s}",
195195 "value3", "value4");
@@ -206,7 +206,7 @@ The previous example would match something like:
206206 {
207207 "key1" : " value1" ,
208208 "key2" : " value2" ,
209- "suboject " : {
209+ "subobject " : {
210210 "key1" : " value3" ,
211211 "key2" : " value4"
212212 }
@@ -215,8 +215,8 @@ The previous example would match something like:
215215 Subobject patterns can be nested.
216216
217217
218- Suboject pattern
219- """"""""""""""""
218+ String subobject pattern
219+ """"""""""""""""""""""""
220220
221221.. code :: C
222222
@@ -226,7 +226,7 @@ Suboject pattern
226226 " key2=%s}",
227227 "value3", "value4");
228228
229- This pattern is similar to the suboject pattern,
229+ This pattern is similar to the subobject pattern,
230230but in this case
231231the preceding dot expression must point to a JSON string value
232232that contains a literal JSON object.
@@ -296,7 +296,7 @@ The full list of checks enabled is:
296296 fsanitize=vla-bound
297297
298298 More information about every specific option can be found in the
299- `Clang Undefined behavior sanitizer ` and `Clang Address sanitizer ` documentation.
299+ `` Clang Undefined behavior sanitizer `` and `` Clang Address sanitizer ` ` documentation.
300300More information about how this is done
301301can be found in :ref: `toolchain `.
302302
@@ -305,15 +305,58 @@ Code coverage
305305
306306The tests are designed to cover
307307as much code as possible
308- and the coverage level is measured using `llvm-cov `.
308+ and the coverage level is measured using `` llvm-cov ` `.
309309When the tests are compiled for the CI execution
310- they are instrumented to generate output `llvm-cov ` coverage information
310+ they are instrumented to generate output `` llvm-cov ` ` coverage information
311311that later is processed by some scripts and
312312reported to the CI
313313to ensure that the minimun coverage level is matched.
314314More information about how this is done
315315can be found in :ref: `toolchain `.
316316
317+ Execution
318+ *********
319+
320+ The tests must be compiled with ``unit-test-all-hubs-wasm.config ``.
321+
322+ .. code :: shell
323+
324+ make config KBUILD_DEFCONFIG=configs/unit-test-all-hubs-wasm.config
325+
326+ Tests can then be run with the single make target ``test ``.
327+
328+ .. code :: shell
329+
330+ make test KBUILD_DEFCONFIG=configs/unit-test-all-hubs-wasm.config
331+
332+ This target will build everything the tests require,
333+ create a virtual environment (``.venv ``),
334+ install the python sdk,
335+ and execute all tests in parallel inside
336+ the virtual environment.
337+
338+ The completed tests will be reported
339+ as ``PASS `` or ``FAIL `` upon completion,
340+ and a global summary will show the test results:
341+
342+ .. code :: shell
343+
344+ make test
345+ ...
346+ PASS EVP1 src/systest/test_instance_state.elf
347+ FAIL TB src/systest/test_python_mod_zombie.elf
348+ PASS EVP1 src/systest/test_capture_mode.elf
349+ PASS TB src/systest/test_capture_mode.elf
350+ PASS TB src/st-nohub/test_start_stop.elf
351+ FAIL TB src/evp2-tb/test_embed_backdoor.elf
352+ ----------- SUMMARY -----------
353+ RUN 203
354+ PASSED 201
355+ FAILED 2
356+ FAIL TB src/systest/test_python_mod_zombie.elf
357+ FAIL TB src/evp2-tb/test_embed_backdoor.elf
358+
359+
317360--------------
318361
319362.. _Cmocka : https://cmocka.org
0 commit comments