[an error occurred while processing this directive]
<h1>RPN Unit Test</h1>

<p>RPN Unit Test (rut)  started as a little hack to test some
number-theoretic code I was working on. I needed an easy test
framework for some vanilla C functions, and so a stack-based language
seemed the easiest choice. I wanted the ability to quickly define
regression tests for a function, so I added some syntactic sugar for that.
I needed memory leak checking, so I wrote it. Eventually,
I integrated my multiprecise integer code as a base type, and started using
the framework to test <em>other</em> code I was working on.
</p>

<p>
For example, a regression test might look like this:
</p>
<pre>
[5 1 3 modexp]
1 5
</pre>

<p>This example invokes the function modexp(5, 1, 3), expecting the
return values (1, 5) in return. All the magic of converting the
parameters to bignums, and parsing the return values is handled via
generic wrapper functions.</p>


<p>
 Currently, <em>rut</em> features:
</p>

<ul>
<li>Strings, multiprecision integers, and binary blobs as basic data types</li>
<li>Overloadable operators (functions)</li>
<li>Automatic conversion of data types (where possible)
<li>Debugging malloc library, capable of enumerating allocations
(chasing leaks), and locking memory records (trapping reallocs/frees)</li>
<li>Regression test framework, with automatic leak detection</li>
<li>Easy integration with gcov (coverage testing)</li>
</ul>

<h3>To Do</h3>
<ul>
<li>Fromstr needs to return a void pointer. The value part
should be moved to the value functions
</li>
<li>The dup wrappers should really be copies, since it's easy
to fake the former from the latter..</li>
</ul>

<h3>Wish List</h3>
<p>These are a little further away than the to-do.</p>
<ul>
<li>Infix notation</li>
<li>Wrapper functions need to be generic and automatic (see the mess
in int-types.c for why). Maybe I'll integrate with something like SWIG
for this part.</li>
</ul>

<h3>Download</h3>
<p>
You can download the latest version here:</p>
<ul>
<li><a href="/downloads/rut-1.4.tgz">rut-1.4.tgz</a> (20080205)</li>
</ul>

<h3>Compiling</h3>
<p>I <em>hate</em> autoconf, but until I replace it:</p>
<pre>
    $ ./autogunk && ./configure && make
</pre>
<p>The build is targeted for OpenBSD.
Compatability goo (things that you don't have, but OpenBSD does)
is in openbsd-compat.</p>

<p>Good Luck</p>

<h3>Documentation</h3>
<p>Have a look in <tt>docs/</tt>. Some of it is even up to date.</p>
<h2>Other Arbitrary Precision Math Packages</h2>
<dl>
<dt><a href="http://www.cs.dartmouth.edu/~sting/sw/imath/">Imath</a></dt>
<dd>(<a href="http://www.cs.dartmouth.edu/~sting/sw/imath/imath-current.tar.gz">Download</a>)(<a href="http://pintday.org/downloads/imath.tgz">local copy</a>)</dd>
<dt><a href="http://swox.com/gmp/">Gnu MP (GMP)</a></dt>
<dd></dd>
<dt><a href="http://www.openssl.org/">OpenSSL</a></dt>
<dd></dd>
<dt><a href="http://indigo.ie/~mscott/">MIRACL</a></dt>
<dd></dd>
<dt><a href="http://math.libtomcrypt.com/">LibTomMath</a></dt>
<dd></dd>
<dt><a href="http://www.di-mgt.com.au/bigdigits.html">BigDigits</a></dt>
<dd>(<a href="http://www.di-mgt.com.au/src/BigDigits20.zip">download</a>) Another basic MP library with free-ish (and hence, largely useless)
license</dd>
<dt><a href=""></a></dt>
<dd></dd>
</dl>
[an error occurred while processing this directive]