xref: /freebsd/contrib/kyua/doc/results-files-report-example.mdoc (revision 5ca8e32633c4ffbbcd6762e5888b6a4ba0708c6c)
1.Ss Workflow with results files
2If one runs the following command twice in a row:
3.Bd -literal -offset indent
4kyua test -k /usr/tests/Kyuafile
5.Ed
6.Pp
7the two executions will generate two different files with names like:
8.Bd -literal -offset indent
9~/.kyua/store/results.usr_tests.20140731-150500-196784.db
10~/.kyua/store/results.usr_tests.20140731-151730-997451.db
11.Ed
12.Pp
13Taking advantage of the default naming scheme, the following commands would all
14generate a report for the results of the
15.Em latest
16execution of the test suite:
17.Bd -literal -offset indent
18cd /usr/tests && kyua __REPORT_COMMAND__
19cd /usr/tests && kyua __REPORT_COMMAND__ --results-file=LATEST
20kyua __REPORT_COMMAND__ --results-file=/usr/tests
21kyua __REPORT_COMMAND__ --results-file=usr_tests
22kyua __REPORT_COMMAND__ --results-file=usr_tests.20140731-151730-997451
23.Ed
24.Pp
25But it is also possible to explicitly load data for older runs or from
26explicitly-named files:
27.Bd -literal -offset indent
28kyua __REPORT_COMMAND__ \\
29    --results-file=usr_tests.20140731-150500-196784
30kyua __REPORT_COMMAND__ \\
31    --results-file=~/.kyua/store/results.usr_tests.20140731-150500-196784.db
32.Ed
33