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