Method Tools.Shoot.run_sub()

Method run_sub

void run_sub(Test test, int maximum_seconds, __deprecated__(float)|void overhead)

Description

Run a single benchmark test in the current process and return the result as JSON on stdout.

Parameter test

Benchmark to run.

Parameter maximum_seconds

Number of seconds to run the test before terminating it.

Parameter overhead

Ignored, obsolete.

Returns

Writes a JSON-encoded mapping with the following fields on success:

"time" : float	Actual number of seconds that the test ran.
"loops" : int	Number of times that the test ran.
"n" : int	Number of sub tests that were run.
"readable" : string	Description of the test result.
"n_over_time" : int	Number of sub tests per second.

On benchmark failure a JSON-encoded mapping with the single entry "readable" set to "FAIL" is written to stdout.

Note

This is the funcction that is called in a sub-process by run().

See also

run(), tests()