inweb-bootstrap/docs/foundation-test/S-pc.html
2020-04-17 19:18:40 +01:00

119 lines
15 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Program Control</title>
<meta name="viewport" content="width=device-width initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="Content-Language" content="en-gb">
<link href="../inweb.css" rel="stylesheet" rev="stylesheet" type="text/css">
</head>
<body>
<nav role="navigation">
<h1><a href="../index.html">
<img src="../docs-src/Figures/Octagram184x184.png" width=72 height=72">
</a></h1>
<ul><li><a href="../inweb/index.html">inweb</a></li>
</ul><h2>Foundation Module</h2><ul>
<li><a href="../foundation-module/index.html">foundation</a></li>
<li><a href="index.html"><span class="selectedlink">foundation-test</span></a></li>
</ul><h2>Example Webs</h2><ul>
<li><a href="../goldbach/index.html">goldbach</a></li>
<li><a href="../twinprimes/twinprimes.html">twinprimes</a></li>
<li><a href="../eastertide/index.html">eastertide</a></li>
</ul><h2>Repository</h2><ul>
<li><a href="https://github.com/ganelson/inweb"><img src="../github.png" height=18> github</a></li>
</ul><h2>Related Projects</h2><ul>
<li><a href="../../../inform/docs/index.html">inform</a></li>
<li><a href="../../../intest/docs/index.html">intest</a></li>
</ul>
</nav>
<main role="main">
<!--Weave of 'Program Control' generated by Inweb-->
<ul class="crumbs"><li><a href="../index.html">Home</a></li><li><a href="index.html">foundation-test</a></li><li><b>Program Control</b></li></ul><p class="purpose">Choosing which unit test to run on the basis of the command-line arguments.</p>
<ul class="toc"><li><a href="S-pc.html#SP1">&#167;1. Main routine</a></li></ul><hr class="tocbar">
<p class="inwebparagraph"><a id="SP1"></a><b>&#167;1. Main routine. </b></p>
<pre class="definitions">
<span class="definitionkeyword">define</span> <span class="constant">PROGRAM_NAME</span><span class="plain"> </span><span class="string">"foundation-test"</span>
<span class="definitionkeyword">enum</span> <span class="constant">TEST_STRINGS_CLSW</span>
<span class="definitionkeyword">enum</span> <span class="constant">TEST_RE_CLSW</span>
<span class="definitionkeyword">enum</span> <span class="constant">TEST_DICT_CLSW</span>
<span class="definitionkeyword">enum</span> <span class="constant">TEST_LITERALS_CLSW</span>
<span class="definitionkeyword">enum</span> <span class="constant">TEST_REPLACEMENT_CLSW</span>
<span class="definitionkeyword">enum</span> <span class="constant">TEST_LISTS_CLSW</span>
<span class="definitionkeyword">enum</span> <span class="constant">TEST_STACKS_CLSW</span>
<span class="definitionkeyword">enum</span> <span class="constant">TEST_SEMVER_CLSW</span>
<span class="definitionkeyword">enum</span> <span class="constant">TEST_TREES_CLSW</span>
</pre>
<pre class="display">
<span class="reserved">int</span><span class="plain"> </span><span class="functiontext">main</span><span class="plain">(</span><span class="reserved">int</span><span class="plain"> </span><span class="identifier">argc</span><span class="plain">, </span><span class="reserved">char</span><span class="plain"> **</span><span class="identifier">argv</span><span class="plain">) {</span>
<span class="functiontext"><a href="../foundation-module/1-fm.html#SP8">Foundation::start</a></span><span class="plain">();</span>
<span class="functiontext"><a href="../foundation-module/3-cla.html#SP14">CommandLine::declare_heading</a></span><span class="plain">(</span><span class="identifier">L</span><span class="string">"inexample: a tool for testing foundation facilities\n"</span><span class="plain">);</span>
<span class="functiontext"><a href="../foundation-module/3-cla.html#SP5">CommandLine::declare_switch</a></span><span class="plain">(</span><span class="constant">TEST_STRINGS_CLSW</span><span class="plain">, </span><span class="identifier">L</span><span class="string">"test-strings"</span><span class="plain">, </span><span class="constant">2</span><span class="plain">,</span>
<span class="identifier">L</span><span class="string">"test string manipulation (X is ignored)"</span><span class="plain">);</span>
<span class="functiontext"><a href="../foundation-module/3-cla.html#SP5">CommandLine::declare_switch</a></span><span class="plain">(</span><span class="constant">TEST_RE_CLSW</span><span class="plain">, </span><span class="identifier">L</span><span class="string">"test-regexp"</span><span class="plain">, </span><span class="constant">2</span><span class="plain">,</span>
<span class="identifier">L</span><span class="string">"test regular expression matches on a list of cases in file X"</span><span class="plain">);</span>
<span class="functiontext"><a href="../foundation-module/3-cla.html#SP5">CommandLine::declare_switch</a></span><span class="plain">(</span><span class="constant">TEST_DICT_CLSW</span><span class="plain">, </span><span class="identifier">L</span><span class="string">"test-dictionaries"</span><span class="plain">, </span><span class="constant">2</span><span class="plain">,</span>
<span class="identifier">L</span><span class="string">"test dictionary building on a list of keys and values in file X"</span><span class="plain">);</span>
<span class="functiontext"><a href="../foundation-module/3-cla.html#SP5">CommandLine::declare_switch</a></span><span class="plain">(</span><span class="constant">TEST_LITERALS_CLSW</span><span class="plain">, </span><span class="identifier">L</span><span class="string">"test-literals"</span><span class="plain">, </span><span class="constant">2</span><span class="plain">,</span>
<span class="identifier">L</span><span class="string">"test string literals (X is ignored)"</span><span class="plain">);</span>
<span class="functiontext"><a href="../foundation-module/3-cla.html#SP5">CommandLine::declare_switch</a></span><span class="plain">(</span><span class="constant">TEST_REPLACEMENT_CLSW</span><span class="plain">, </span><span class="identifier">L</span><span class="string">"test-replacement"</span><span class="plain">, </span><span class="constant">2</span><span class="plain">,</span>
<span class="identifier">L</span><span class="string">"test regular expression replacements on a list of cases in file X"</span><span class="plain">);</span>
<span class="functiontext"><a href="../foundation-module/3-cla.html#SP5">CommandLine::declare_switch</a></span><span class="plain">(</span><span class="constant">TEST_LISTS_CLSW</span><span class="plain">, </span><span class="identifier">L</span><span class="string">"test-lists"</span><span class="plain">, </span><span class="constant">2</span><span class="plain">,</span>
<span class="identifier">L</span><span class="string">"test linked lists (X is ignored)"</span><span class="plain">);</span>
<span class="functiontext"><a href="../foundation-module/3-cla.html#SP5">CommandLine::declare_switch</a></span><span class="plain">(</span><span class="constant">TEST_STACKS_CLSW</span><span class="plain">, </span><span class="identifier">L</span><span class="string">"test-stacks"</span><span class="plain">, </span><span class="constant">2</span><span class="plain">,</span>
<span class="identifier">L</span><span class="string">"test LIFO stacks (X is ignored)"</span><span class="plain">);</span>
<span class="functiontext"><a href="../foundation-module/3-cla.html#SP5">CommandLine::declare_switch</a></span><span class="plain">(</span><span class="constant">TEST_SEMVER_CLSW</span><span class="plain">, </span><span class="identifier">L</span><span class="string">"test-semver"</span><span class="plain">, </span><span class="constant">2</span><span class="plain">,</span>
<span class="identifier">L</span><span class="string">"test semantic version numbers (X is ignored)"</span><span class="plain">);</span>
<span class="functiontext"><a href="../foundation-module/3-cla.html#SP5">CommandLine::declare_switch</a></span><span class="plain">(</span><span class="constant">TEST_TREES_CLSW</span><span class="plain">, </span><span class="identifier">L</span><span class="string">"test-trees"</span><span class="plain">, </span><span class="constant">2</span><span class="plain">,</span>
<span class="identifier">L</span><span class="string">"test heterogeneous trees (X is ignored)"</span><span class="plain">);</span>
<span class="functiontext"><a href="../foundation-module/3-cla.html#SP8">CommandLine::read</a></span><span class="plain">(</span><span class="identifier">argc</span><span class="plain">, </span><span class="identifier">argv</span><span class="plain">, </span><span class="identifier">NULL</span><span class="plain">, &amp;</span><span class="functiontext"><a href="S-pc.html#SP1">Main::respond</a></span><span class="plain">, &amp;</span><span class="functiontext"><a href="S-pc.html#SP1">Main::ignore</a></span><span class="plain">);</span>
<span class="functiontext"><a href="../foundation-module/1-fm.html#SP9">Foundation::end</a></span><span class="plain">();</span>
<span class="reserved">return</span><span class="plain"> </span><span class="constant">0</span><span class="plain">;</span>
<span class="plain">}</span>
<span class="reserved">void</span><span class="plain"> </span><span class="functiontext">Main::respond<button class="popup" onclick="togglePopup('usagePopup0')">...<span class="popuptext" id="usagePopup0">Usage of <b>Main::respond</b>:<br>none</span></button></span><span class="plain">(</span><span class="reserved">int</span><span class="plain"> </span><span class="identifier">id</span><span class="plain">, </span><span class="reserved">int</span><span class="plain"> </span><span class="identifier">val</span><span class="plain">, </span><span class="reserved">text_stream</span><span class="plain"> *</span><span class="identifier">arg</span><span class="plain">, </span><span class="reserved">void</span><span class="plain"> *</span><span class="identifier">state</span><span class="plain">) {</span>
<span class="reserved">switch</span><span class="plain"> (</span><span class="identifier">id</span><span class="plain">) {</span>
<span class="reserved">case</span><span class="plain"> </span><span class="identifier">TEST_STRINGS_CLSW:</span><span class="plain"> </span><span class="functiontext"><a href="S-ut.html#SP1">Unit::test_strings</a></span><span class="plain">(); </span><span class="reserved">break</span><span class="plain">;</span>
<span class="reserved">case</span><span class="plain"> </span><span class="identifier">TEST_RE_CLSW:</span><span class="plain"> </span><span class="functiontext"><a href="S-ut.html#SP4">Unit::test_regexp</a></span><span class="plain">(</span><span class="identifier">arg</span><span class="plain">); </span><span class="reserved">break</span><span class="plain">;</span>
<span class="reserved">case</span><span class="plain"> </span><span class="identifier">TEST_REPLACEMENT_CLSW:</span><span class="plain"> </span><span class="functiontext"><a href="S-ut.html#SP5">Unit::test_replacement</a></span><span class="plain">(</span><span class="identifier">arg</span><span class="plain">); </span><span class="reserved">break</span><span class="plain">;</span>
<span class="reserved">case</span><span class="plain"> </span><span class="identifier">TEST_DICT_CLSW:</span><span class="plain"> </span><span class="functiontext"><a href="S-ut.html#SP3">Unit::test_dictionaries</a></span><span class="plain">(</span><span class="identifier">arg</span><span class="plain">); </span><span class="reserved">break</span><span class="plain">;</span>
<span class="reserved">case</span><span class="plain"> </span><span class="identifier">TEST_LITERALS_CLSW:</span><span class="plain"> </span><span class="functiontext"><a href="S-ut.html#SP2">Unit::test_literals</a></span><span class="plain">(); </span><span class="reserved">break</span><span class="plain">;</span>
<span class="reserved">case</span><span class="plain"> </span><span class="identifier">TEST_LISTS_CLSW:</span><span class="plain"> </span><span class="functiontext"><a href="S-ut.html#SP6">Unit::test_linked_lists</a></span><span class="plain">(); </span><span class="reserved">break</span><span class="plain">;</span>
<span class="reserved">case</span><span class="plain"> </span><span class="identifier">TEST_STACKS_CLSW:</span><span class="plain"> </span><span class="functiontext"><a href="S-ut.html#SP7">Unit::test_stacks</a></span><span class="plain">(); </span><span class="reserved">break</span><span class="plain">;</span>
<span class="reserved">case</span><span class="plain"> </span><span class="identifier">TEST_SEMVER_CLSW:</span><span class="plain"> </span><span class="functiontext"><a href="S-ut.html#SP8">Unit::test_semver</a></span><span class="plain">(); </span><span class="reserved">break</span><span class="plain">;</span>
<span class="reserved">case</span><span class="plain"> </span><span class="identifier">TEST_TREES_CLSW:</span><span class="plain"> </span><span class="functiontext"><a href="S-ut.html#SP11">Unit::test_trees</a></span><span class="plain">(); </span><span class="reserved">break</span><span class="plain">;</span>
<span class="plain">}</span>
<span class="plain">}</span>
<span class="reserved">void</span><span class="plain"> </span><span class="functiontext">Main::ignore<button class="popup" onclick="togglePopup('usagePopup1')">...<span class="popuptext" id="usagePopup1">Usage of <b>Main::ignore</b>:<br>none</span></button></span><span class="plain">(</span><span class="reserved">int</span><span class="plain"> </span><span class="identifier">id</span><span class="plain">, </span><span class="reserved">text_stream</span><span class="plain"> *</span><span class="identifier">arg</span><span class="plain">, </span><span class="reserved">void</span><span class="plain"> *</span><span class="identifier">state</span><span class="plain">) {</span>
<span class="functiontext"><a href="../foundation-module/3-em.html#SP2">Errors::fatal</a></span><span class="plain">(</span><span class="string">"only switches may be used at the command line"</span><span class="plain">);</span>
<span class="plain">}</span>
</pre>
<p class="inwebparagraph"></p>
<hr class="tocbar">
<ul class="toc"><li><i>(This section begins Sections.)</i></li><li><a href="S-ut.html">Continue with 'Unit Tests'</a></li></ul><hr class="tocbar">
<!--End of weave-->
<script>
function togglePopup(material_id) {
var popup = document.getElementById(material_id);
popup.classList.toggle("show");
}
</script>
<link href="Popups.css" rel="stylesheet" rev="stylesheet" type="text/css">
</main>
</body>
</html>