package tezt
Install
Dune Dependency
Authors
Maintainers
Sources
md5=643f48378265ae18b7aab4675a1e836e
sha512=f399d4d8b935fc3dcb4354596c2b7fa26a019f99c83cb4c1d48b0e26c5bc6da13b2cad9792dd50420a88b777d3b8a1d67c7ddd0457322e65d311b859be03879f
doc/tezt.core/Tezt_core/Log/index.html
Module Tezt_core.Log
Source
Tezt logs.
Quote or escape a string using shell syntax.
Quote or escape a command with arguments using shell syntax.
Colors
Logging
val log :
level:Cli.Logs.level ->
?color:Color.t ->
?prefix:string ->
('a, Format.formatter, unit, unit) format4 ->
'a
Log a message if the log level requested on the command-line allows it.
See the documentation of Cli
for a description of each log level and when to use them.
In tests, you should mostly use function info
.
val debug :
?color:Color.t ->
?prefix:string ->
('a, Format.formatter, unit, unit) format4 ->
'a
Same as log ~level:Debug
.
val info :
?color:Color.t ->
?prefix:string ->
('a, Format.formatter, unit, unit) format4 ->
'a
Same as log ~level:Info
.
val report :
?color:Color.t ->
?prefix:string ->
('a, Format.formatter, unit, unit) format4 ->
'a
Same as log ~level:Report
.
Same as log ~level:Warn ~color:red ~prefix:"warn"
.
Same as log ~level:Error ~color:red ~prefix:"error"
.
Whether a test succeeded, failed or was aborted by the user.
Failed
comes with the error message, which is a string version of the exception that was raised (usually with Test.fail
). This message is unused by the Log
module itself.
val test_result :
test_index:int ->
test_count:int ->
failure_count:int ->
iteration:int ->
test_result ->
string ->
unit
Log the result of a test.
test_index
is the index of the test, starting from 1. test_count
is the total number of tests. failure_count
is the total number of failures so far.
iteration
is the index of the iteration count to display in --loop
mode.
The string
argument is the name of the test.
Log a command which will be run.
Log it with level Debug
, and print it unconditionally with no timestamp if Cli.options.commands
is true
.
Set the worker id to print if --log-worker-ids
is set.
Close the current log file, if any, and open another one.
By default, logs are output to Cli.Logs.file
, if it is specified (with --log-file
). One can use set_file
to change this. This is in particular done automatically when using -j
: each child process calls set_file
to write to its own file.
Flush current log file, if any.