<!doctype html>
<html lang="en">
<head>
<link rel="icon" type="image/png" href="/favicon.png">
<meta charset="utf-8">
<meta name="generator" content="Pod::Simple::HTML">
<meta name="description" content="i3 Perl documentation">
<link rel="stylesheet" href="https://i3wm.org/css/style.css" type="text/css" />
<style type="text/css">
.pod pre {
background: #333;
border: 1px solid #555;
border-left: 5px solid #555;
padding: 0.5em;
padding-left: 0;
padding-right: 0.5em;
white-space: pre;
color: white;
}
.pod ul {
list-style-type: none;
}
.pod li {
margin-bottom: 0 !important;
}
tt {
font-family: 'Droid Sans Mono', sans-serif;
font-size: inherit;
}
.pod h1 a, .pod h2 a, .pod h3 a, .pod h4 a {
text-decoration: none;
color: white;
}
</style>
<title>
i3test</title>
</head>
<body>
<div id="main">
<a href="/"><h1 id="title">i3 - improved tiling WM</h1></a>
<ul id="nav">
<li><a style="border-bottom: 2px solid #fff" href="/docs">Docs</a></li>
<li><a href="/screenshots">Screens</a></li>
<li><a href="https://www.reddit.com/r/i3wm/">FAQ</a></li>
<li><a href="/contact">Contact</a></li>
<li><a href="https://bugs.i3wm.org/">Bugs</a></li>
</ul>
<br style="clear: both">
<div id="content" class="pod">
<h1>i3 Perl documentation</h1>
<a name='___top' class='dummyTopAnchor' ></a>
<div class='indexgroup'>
<ul class='indexList indexList1'>
<li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
<li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
<li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
<li class='indexItem indexItem1'><a href='#EXPORT'>EXPORT</a>
<ul class='indexList indexList2'>
<li class='indexItem indexItem2'><a href='#wait_for_event(%24timeout%2C_%24callback)'>wait_for_event($timeout, $callback)</a>
<li class='indexItem indexItem2'><a href='#wait_for_map(%24window)'>wait_for_map($window)</a>
<li class='indexItem indexItem2'><a href='#wait_for_unmap(%24window)'>wait_for_unmap($window)</a>
<li class='indexItem indexItem2'><a href='#open_window(%5B_%24args_%5D)'>open_window([ $args ])</a>
<li class='indexItem indexItem2'><a href='#open_floating_window(%5B_%24args_%5D)'>open_floating_window([ $args ])</a>
<li class='indexItem indexItem2'><a href='#get_workspace_names()'>get_workspace_names()</a>
<li class='indexItem indexItem2'><a href='#get_output_for_workspace()'>get_output_for_workspace()</a>
<li class='indexItem indexItem2'><a href='#get_unused_workspace'>get_unused_workspace</a>
<li class='indexItem indexItem2'><a href='#fresh_workspace(%5B_%24args_%5D)'>fresh_workspace([ $args ])</a>
<li class='indexItem indexItem2'><a href='#get_ws(%24workspace)'>get_ws($workspace)</a>
<li class='indexItem indexItem2'><a href='#get_ws_content(%24workspace)'>get_ws_content($workspace)</a>
<li class='indexItem indexItem2'><a href='#get_focused(%24workspace)'>get_focused($workspace)</a>
<li class='indexItem indexItem2'><a href='#get_dock_clients(%5B_%24dockarea_%5D)'>get_dock_clients([ $dockarea ])</a>
<li class='indexItem indexItem2'><a href='#cmd(%24command)'>cmd($command)</a>
<li class='indexItem indexItem2'><a href='#workspace_exists(%24workspace)'>workspace_exists($workspace)</a>
<li class='indexItem indexItem2'><a href='#focused_ws'>focused_ws</a>
<li class='indexItem indexItem2'><a href='#sync_with_i3(%5B_%24args_%5D)'>sync_with_i3([ $args ])</a>
<li class='indexItem indexItem2'><a href='#exit_gracefully(%24pid%2C_%5B_%24socketpath_%5D)'>exit_gracefully($pid, [ $socketpath ])</a>
<li class='indexItem indexItem2'><a href='#exit_forcefully(%24pid%2C_%5B_%24signal_%5D)'>exit_forcefully($pid, [ $signal ])</a>
<li class='indexItem indexItem2'><a href='#get_socket_path(%5B_%24cache_%5D)'>get_socket_path([ $cache ])</a>
<li class='indexItem indexItem2'><a href='#launch_with_config(%24config%2C_%5B_%24args_%5D)'>launch_with_config($config, [ $args ])</a>
<li class='indexItem indexItem2'><a href='#get_i3_log'>get_i3_log</a>
<li class='indexItem indexItem2'><a href='#kill_all_windows'>kill_all_windows</a>
<li class='indexItem indexItem2'><a href='#events_for(%24subscribecb%2C_%5B_%24rettype_%5D%2C_%5B_%24eventcbs_%5D)'>events_for($subscribecb, [ $rettype ], [ $eventcbs ])</a>
<li class='indexItem indexItem2'><a href='#listen_for_binding(%24cb)'>listen_for_binding($cb)</a>
<li class='indexItem indexItem2'><a href='#is_net_wm_state_focused'>is_net_wm_state_focused</a>
<li class='indexItem indexItem2'><a href='#cmp_tree(%5B_%24args_%5D)'>cmp_tree([ $args ])</a>
</ul>
<li class='indexItem indexItem1'><a href='#AUTHOR'>AUTHOR</a>
</ul>
</div>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="NAME"
>NAME</a></h1>
<p>i3test - Testcase setup module</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="SYNOPSIS"
>SYNOPSIS</a></h1>
<pre><tt> use i3test;
my $ws = fresh_workspace;
is_num_children($ws, 0, 'no containers on this workspace yet');
cmd 'open';
is_num_children($ws, 1, 'one container after "open"');
done_testing;</tt></pre>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="DESCRIPTION"
>DESCRIPTION</a></h1>
<p>This module is used in every i3 testcase and takes care of automatically starting i3 before any test instructions run. It also saves you typing of lots of boilerplate in every test file.</p>
<p>i3test automatically "use"s <code>Test::More</code>, <code>Data::Dumper</code>, <code>AnyEvent::I3</code>, <code>Time::HiRes</code>’s <code>sleep</code> and <code>i3test::Test</code> so that all of them are available to you in your testcase.</p>
<p>See also <code>i3test::Test</code> (<a href="https://build.i3wm.org/docs/lib-i3test-test.html" class="podlinkurl"
>https://build.i3wm.org/docs/lib-i3test-test.html</a>) which provides additional test instructions (like <code>ok</code> or <code>is</code>).</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="EXPORT"
>EXPORT</a></h1>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="wait_for_event($timeout,_$callback)"
>wait_for_event($timeout, $callback)</a></h2>
<p>Waits for the next event and calls the given callback for every event to determine if this is the event we are waiting for.</p>
<p>Can be used to wait until a window is mapped, until a ClientMessage is received, etc.</p>
<pre><tt> wait_for_event 0.25, sub { $_[0]->{response_type} == MAP_NOTIFY };</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="wait_for_map($window)"
>wait_for_map($window)</a></h2>
<p>Thin wrapper around wait_for_event which waits for MAP_NOTIFY. Make sure to include 'structure_notify' in the window’s event_mask attribute.</p>
<p>This function is called by <code>open_window</code>, so in most cases, you don’t need to call it on your own. If you need special setup of the window before mapping, you might have to map it on your own and use this function:</p>
<pre><tt> my $window = open_window(dont_map => 1);
# Do something special with the window first
# …
# Now map it and wait until it’s been mapped
$window->map;
wait_for_map($window);</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="wait_for_unmap($window)"
>wait_for_unmap($window)</a></h2>
<p>Wrapper around <code>wait_for_event</code> which waits for UNMAP_NOTIFY. Also calls <code>sync_with_i3</code> to make sure i3 also picked up and processed the UnmapNotify event.</p>
<pre><tt> my $ws = fresh_workspace;
my $window = open_window;
is_num_children($ws, 1, 'one window on workspace');
$window->unmap;
wait_for_unmap;
is_num_children($ws, 0, 'no more windows on this workspace');</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="open_window([_$args_])"
>open_window([ $args ])</a></h2>
<p>Opens a new window (see <code>X11::XCB::Window</code>), maps it, waits until it got mapped and synchronizes with i3.</p>
<p>The following arguments can be passed:</p>
<dl>
<dt><a name="class"
>class</a></dt>
<dd>
<p>The X11 window class (e.g. WINDOW_CLASS_INPUT_OUTPUT), not to be confused with the WM_CLASS!</p>
<dt><a name="rect"
>rect</a></dt>
<dd>
<p>An arrayref with 4 members specifying the initial geometry (position and size) of the window, e.g. <code>[ 0, 100, 70, 50 ]</code> for a window appearing at x=0, y=100 with width=70 and height=50.</p>
<p>Note that this is entirely irrelevant for tiling windows.</p>
<dt><a name="background_color"
>background_color</a></dt>
<dd>
<p>The background pixel color of the window, formatted as "#rrggbb", like HTML color codes (e.g. #c0c0c0). This is useful to tell windows apart when actually watching the testcases.</p>
<dt><a name="event_mask"
>event_mask</a></dt>
<dd>
<p>An arrayref containing strings which describe the X11 event mask we use for that window. The default is <code>[ 'structure_notify' ]</code>.</p>
<dt><a name="name"
>name</a></dt>
<dd>
<p>The window’s <code>_NET_WM_NAME</code> (UTF-8 window title). By default, this is "Window n" with n being replaced by a counter to keep windows apart.</p>
<dt><a name="dont_map"
>dont_map</a></dt>
<dd>
<p>Set to a true value to avoid mapping the window (making it visible).</p>
<dt><a name="before_map"
>before_map</a></dt>
<dd>
<p>A coderef which is called before the window is mapped (unless <code>dont_map</code> is true). The freshly created <code>$window</code> is passed as <code>$_</code> and as the first argument.</p>
</dd>
</dl>
<p>The default values are equivalent to this call:</p>
<pre><tt> open_window(
class => WINDOW_CLASS_INPUT_OUTPUT
rect => [ 0, 0, 30, 30 ]
background_color => '#c0c0c0'
event_mask => [ 'structure_notify' ]
name => 'Window <n>'
);</tt></pre>
<p>Usually, though, calls are simpler:</p>
<pre><tt> my $top_window = open_window;</tt></pre>
<p>To identify the resulting window object in i3 commands, use the id property:</p>
<pre><tt> my $top_window = open_window;
cmd '[id="' . $top_window->id . '"] kill';</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="open_floating_window([_$args_])"
>open_floating_window([ $args ])</a></h2>
<p>Thin wrapper around open_window which sets window_type to <code>_NET_WM_WINDOW_TYPE_UTILITY</code> to make the window floating.</p>
<p>The arguments are the same as those of <code>open_window</code>.</p>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="get_workspace_names()"
>get_workspace_names()</a></h2>
<p>Returns an arrayref containing the name of every workspace (regardless of its output) which currently exists.</p>
<pre><tt> my $workspace_names = get_workspace_names;
is(scalar @$workspace_names, 3, 'three workspaces exist currently');</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="get_output_for_workspace()"
>get_output_for_workspace()</a></h2>
<p>Returns the name of the output on which this workspace resides</p>
<pre><tt> cmd 'focus output fake-1';
cmd 'workspace 1';
is(get_output_for_workspace('1', 'fake-0', 'Workspace 1 in output fake-0');</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="get_unused_workspace"
>get_unused_workspace</a></h2>
<p>Returns a workspace name which has not yet been used. See also <code>fresh_workspace</code> which directly switches to an unused workspace.</p>
<pre><tt> my $ws = get_unused_workspace;
cmd "workspace $ws";</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="fresh_workspace([_$args_])"
>fresh_workspace([ $args ])</a></h2>
<p>Switches to an unused workspace and returns the name of that workspace.</p>
<p>Optionally switches to the specified output first.</p>
<pre><tt> my $ws = fresh_workspace;
# Get a fresh workspace on the second output.
my $ws = fresh_workspace(output => 1);</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="get_ws($workspace)"
>get_ws($workspace)</a></h2>
<p>Returns the container (from the i3 layout tree) which represents <code>$workspace</code>.</p>
<pre><tt> my $ws = fresh_workspace;
my $ws_con = get_ws($ws);
ok(!$ws_con->{urgent}, 'fresh workspace not marked urgent');</tt></pre>
<p>Here is an example which counts the number of urgent containers recursively, starting from the workspace container:</p>
<pre><tt> sub count_urgent {
my ($con) = @_;
my @children = (@{$con->{nodes}}, @{$con->{floating_nodes}});
my $urgent = grep { $_->{urgent} } @children;
$urgent += count_urgent($_) for @children;
return $urgent;
}
my $urgent = count_urgent(get_ws($ws));
is($urgent, 3, "three urgent windows on workspace $ws");</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="get_ws_content($workspace)"
>get_ws_content($workspace)</a></h2>
<p>Returns the content (== tree, starting from the node of a workspace) of a workspace. If called in array context, also includes the focus stack of the workspace.</p>
<pre><tt> my $nodes = get_ws_content($ws);
is(scalar @$nodes, 4, 'there are four containers at workspace-level');</tt></pre>
<p>Or, in array context:</p>
<pre><tt> my $window = open_window;
my ($nodes, $focus) = get_ws_content($ws);
is($focus->[0], $window->id, 'newly opened window focused');</tt></pre>
<p>Note that this function does not do recursion for you! It only returns the containers <b>on workspace level</b>. If you want to work with all containers (even nested ones) on a workspace, you have to use recursion:</p>
<pre><tt> # NB: This function does not count floating windows
sub count_urgent {
my ($nodes) = @_;
my $urgent = 0;
for my $con (@$nodes) {
$urgent++ if $con->{urgent};
$urgent += count_urgent($con->{nodes});
}
return $urgent;
}
my $nodes = get_ws_content($ws);
my $urgent = count_urgent($nodes);
is($urgent, 3, "three urgent windows on workspace $ws");</tt></pre>
<p>If you also want to deal with floating windows, you have to use <code>get_ws</code> instead and access <code>->{nodes}</code> and <code>->{floating_nodes}</code> on your own.</p>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="get_focused($workspace)"
>get_focused($workspace)</a></h2>
<p>Returns the container ID of the currently focused container on <code>$workspace</code>.</p>
<p>Note that the container ID is <b>not</b> the X11 window ID, so comparing the result of <code>get_focused</code> with a window's <code>->{id}</code> property does <b>not</b> work.</p>
<pre><tt> my $ws = fresh_workspace;
my $first_window = open_window;
my $first_id = get_focused();
my $second_window = open_window;
my $second_id = get_focused();
cmd 'focus left';
is(get_focused($ws), $first_id, 'second window focused');</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="get_dock_clients([_$dockarea_])"
>get_dock_clients([ $dockarea ])</a></h2>
<p>Returns an array of all dock containers in <code>$dockarea</code> (one of "top" or "bottom"). If <code>$dockarea</code> is not specified, returns an array of all dock containers in any dockarea.</p>
<pre><tt> my @docked = get_dock_clients;
is(scalar @docked, 0, 'no dock clients yet');</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="cmd($command)"
>cmd($command)</a></h2>
<p>Sends the specified command to i3 and returns the output.</p>
<pre><tt> my $ws = unused_workspace;
cmd "workspace $ws";
cmd 'focus right';</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="workspace_exists($workspace)"
>workspace_exists($workspace)</a></h2>
<p>Returns true if <code>$workspace</code> is the name of an existing workspace.</p>
<pre><tt> my $old_ws = focused_ws;
# switch away from where we currently are
fresh_workspace;
ok(workspace_exists($old_ws), 'old workspace still exists');</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="focused_ws"
>focused_ws</a></h2>
<p>Returns the name of the currently focused workspace.</p>
<pre><tt> my $ws = focused_ws;
is($ws, '1', 'i3 starts on workspace 1');</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="sync_with_i3([_$args_])"
>sync_with_i3([ $args ])</a></h2>
<p>Sends an I3_SYNC ClientMessage with a random value to the root window. i3 will reply with the same value, but, due to the order of events it processes, only after all other events are done.</p>
<p>This can be used to ensure the results of a cmd 'focus left' are pushed to X11 and that <code>$x->input_focus</code> returns the correct value afterwards.</p>
<p>See also <a href="https://build.i3wm.org/docs/testsuite.html" class="podlinkurl"
>https://build.i3wm.org/docs/testsuite.html</a> for a longer explanation.</p>
<pre><tt> my $window = open_window;
$window->add_hint('urgency');
# Ensure i3 picked up the change
sync_with_i3;</tt></pre>
<p>The only time when you need to use the <code>no_cache</code> argument is when you just killed your own X11 connection:</p>
<pre><tt> cmd 'kill client';
# We need to re-establish the X11 connection which we just killed :).
$x = i3test::X11->new;
sync_with_i3(no_cache => 1);</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="exit_gracefully($pid,_[_$socketpath_])"
>exit_gracefully($pid, [ $socketpath ])</a></h2>
<p>Tries to exit i3 gracefully (with the 'exit' cmd) or kills the PID if that fails.</p>
<p>If <code>$socketpath</code> is not specified, <code>get_socket_path()</code> will be called.</p>
<p>You only need to use this function if you have launched i3 on your own with <code>launch_with_config</code>. Otherwise, it will be automatically called when the testcase ends.</p>
<pre><tt> use i3test i3_autostart => 0;
my $pid = launch_with_config($config);
# …
exit_gracefully($pid);</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="exit_forcefully($pid,_[_$signal_])"
>exit_forcefully($pid, [ $signal ])</a></h2>
<p>Tries to exit i3 forcefully by sending a signal (defaults to SIGTERM).</p>
<p>You only need to use this function if you want to test signal handling (in which case you must have launched i3 on your own with <code>launch_with_config</code>).</p>
<pre><tt> use i3test i3_autostart => 0;
my $pid = launch_with_config($config);
# …
exit_forcefully($pid);</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="get_socket_path([_$cache_])"
>get_socket_path([ $cache ])</a></h2>
<p>Gets the socket path from the <code>I3_SOCKET_PATH</code> atom stored on the X11 root window. After the first call, this function will return a cached version of the socket path unless you specify a false value for <code>$cache</code>.</p>
<pre><tt> my $i3 = i3(get_socket_path());
$i3->command('nop test example')->recv;</tt></pre>
<p>To avoid caching:</p>
<pre><tt> my $i3 = i3(get_socket_path(0));</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="launch_with_config($config,_[_$args_])"
>launch_with_config($config, [ $args ])</a></h2>
<p>Launches a new i3 process with <code>$config</code> as configuration file. Useful for tests which test specific config file directives.</p>
<pre><tt> use i3test i3_autostart => 0;
my $config = <<EOT;
# i3 config file (v4)
for_window [class="borderless"] border none
for_window [title="special borderless title"] border none
EOT
my $pid = launch_with_config($config);
# …
exit_gracefully($pid);</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="get_i3_log"
>get_i3_log</a></h2>
<p>Returns the content of the log file for the current test.</p>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="kill_all_windows"
>kill_all_windows</a></h2>
<p>Kills all windows to clean up between tests.</p>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="events_for($subscribecb,_[_$rettype_],_[_$eventcbs_])"
>events_for($subscribecb, [ $rettype ], [ $eventcbs ])</a></h2>
<p>Helper function which returns an array containing all events of type $rettype which were generated by i3 while $subscribecb was running.</p>
<p>Set $eventcbs to subscribe to multiple event types and/or perform your own event aggregation.</p>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="listen_for_binding($cb)"
>listen_for_binding($cb)</a></h2>
<p>Helper function to evaluate whether sending KeyPress/KeyRelease events via XTEST triggers an i3 key binding or not. Expects key bindings to be configured in the form “bindsym <binding> nop <binding>”, e.g. “bindsym Mod4+Return nop Mod4+Return”.</p>
<pre><tt> is(listen_for_binding(
sub {
xtest_key_press(133); # Super_L
xtest_key_press(36); # Return
xtest_key_release(36); # Return
xtest_key_release(133); # Super_L
xtest_sync_with_i3;
},
),
'Mod4+Return',
'triggered the "Mod4+Return" keybinding');</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="is_net_wm_state_focused"
>is_net_wm_state_focused</a></h2>
<p>Returns true if the given window has the _NET_WM_STATE_FOCUSED atom.</p>
<pre><tt> ok(is_net_wm_state_focused($window), '_NET_WM_STATE_FOCUSED set');</tt></pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="cmp_tree([_$args_])"
>cmp_tree([ $args ])</a></h2>
<p>Compares the tree layout before and after an operation inside a subtest.</p>
<p>The following arguments can be passed:</p>
<dl>
<dt><a name="layout_before"
>layout_before</a></dt>
<dd>
<p>Required argument. The initial layout to be created. For example, 'H[ V[ a* S[ b c ] d ] e ]' or 'V[a b] T[c d*]'. The layout will be converted to a JSON file which will be passed to i3's append_layout command.</p>
<p>The syntax's rules, assertions and limitations are:</p>
<ol>
<li>Upper case letters H, V, S, T mean horizontal, vertical, stacked and tabbed layout respectively. They must be followed by an opening square bracket and must be closed with a closing square bracket. Each of the non-leaf containers is marked with their corresponding letter followed by a number indicating the position of the container relative to other containers of the same type. For example, 'H[V[xxx] V[xxx] H[xxx]]' will mark the non-leaf containers as H1, V1, V2, H2.</li>
<li>Spaces are ignored.</li>
<li>Other alphanumeric characters mean a new window which uses the provided character for its class and name. Eg 'H[a b]' will open windows with classes 'a' and 'b' inside a horizontal split. Windows use a single character for their class, eg 'H[xxx]' will open 3 windows with class 'x'.</li>
<li>Asterisks after a window mean that the window must be focused after the layout is loaded. Currently, focusing non-leaf containers must be done manually, in the callback (<code>cb</code>) function.</li>
</ol>
<dt><a name="cb"
>cb</a></dt>
<dd>
<p>Subroutine to be called after the layout provided by <code>layout_before</code> is created but before the resulting layout (<code>layout_after</code>) is checked.</p>
<dt><a name="layout_after"
>layout_after</a></dt>
<dd>
<p>Required argument. The final layout in which the tree is expected to be after the callback is called. Uses the same syntax with <code>layout_before</code>. For non-leaf containers, their layout (horizontal, vertical, stacked, tabbed) is compared with the corresponding letter (H, V, S, T). For leaf containers, their name is compared with the provided alphanumeric.</p>
<dt><a name="ws"
>ws</a></dt>
<dd>
<p>The workspace in which the layout will be created. Will switch focus to it. If not provided, a new one is created.</p>
<dt><a name="msg"
>msg</a></dt>
<dd>
<p>Message to prepend to the subtest's name. If not empty, it will be followed by ': '.</p>
<dt><a name="dont_kill"
>dont_kill</a></dt>
<dd>
<p>By default, all windows are killed before the <code>layout_before</code> layout is loaded. Set to 1 to avoid this.</p>
</dd>
</dl>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="AUTHOR"
>AUTHOR</a></h1>
<p>Michael Stapelberg <[email protected]></p>
<!-- end doc -->
</body></html>