Distributed test execution control for Common Test.
Distributed test execution control for Common Test
.
This module exports functions for running Common Test
nodes on
multiple hosts in parallel.
Functions
Stops all running tests.
Nodes = atom() | [atom()]
Stops tests on specified nodes.
Bool = true | false
If set to true
, the ct_master logs
are written on a
primitive HTML format, not using the Common Test
CSS style
sheet.
MasterEvMgrRef = atom()
Gets a reference to the Common Test
master event manager.
The reference can be used to, for example, add a user-specific
event handler while tests are running.
Example:
gen_event:add_handler(ct_master:get_event_mgr_ref(), my_ev_h, [])
Node = atom()
Status = finished_ok | ongoing | aborted | {error, Reason}
Reason = term()
Returns test progress. If Status
is ongoing
, tests
are running on the node and are not yet finished.
TestSpecs = string() | [SeparateOrMerged]
Equivalent to ct_master:run(TestSpecs,
false, [], [])
.
TestSpecs = string() | [SeparateOrMerged]
SeparateOrMerged = string() | [string()]
InclNodes = [atom()]
ExclNodes = [atom()]
Equivalent to ct_master:run(TestSpecs,
false, InclNodes, ExclNodes)
.
TestSpecs = string() | [SeparateOrMerged]
SeparateOrMerged = string() | [string()]
AllowUserTerms = bool()
InclNodes = [atom()]
ExclNodes = [atom()]
Tests are spawned on the nodes as specified in TestSpecs
.
Each specification in TestSpec
is handled separately.
However, it is also possible to specify a list of specifications to
be merged into one specification before the tests are executed. Any
test without a particular node specification is also executed on
the nodes in InclNodes
. Nodes in the ExclNodes
list
are excluded from the test.
TestSpecs = string() | [SeparateOrMerged]
SeparateOrMerged = string() | [string()]
Node = atom()
Equivalent to
ct_master:run_on_node(TestSpecs,
false, Node)
.
TestSpecs = string() | [SeparateOrMerged]
SeparateOrMerged = string() | [string()]
AllowUserTerms = bool()
Node = atom()
Tests are spawned on Node
according to TestSpecs
.
Node = atom()
Opts = [OptTuples]
OptTuples = {config, CfgFiles} | {dir, TestDirs} | {suite, Suites} | {testcase, Cases} | {spec, TestSpecs} | {allow_user_terms, Bool} | {logdir, LogDir} | {event_handler, EventHandlers} | {silent_connections, Conns} | {cover, CoverSpecFile} | {cover_stop, Bool} | {userconfig, UserCfgFiles}
CfgFiles = string() | [string()]
TestDirs = string() | [string()]
Suites = atom() | [atom()]
Cases = atom() | [atom()]
TestSpecs = string() | [string()]
LogDir = string()
EventHandlers = EH | [EH]
EH = atom() | {atom(), InitArgs} | {[atom()], InitArgs}
InitArgs = [term()]
Conns = all | [atom()]
Tests are spawned on Node
using
ct:run_test/1