head	1.4;
access;
symbols;
locks; strict;
comment	@# @;


1.4
date	2001.08.03.23.42.10;	author dlr;	state Exp;
branches;
next	1.3;

1.3
date	2001.08.03.23.39.44;	author dlr;	state Exp;
branches;
next	1.2;

1.2
date	2001.08.03.23.39.09;	author dlr;	state Exp;
branches;
next	1.1;

1.1
date	2001.08.03.23.32.43;	author dlr;	state Exp;
branches;
next	;


desc
@@


1.4
log
@How to execute the tests.
@
text
@<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>
 <head>
  <title>Unit Testing</title>
  <!-- Changed by: Daniel L. Rall, 03-Aug-2001 -->
 </head>

<body>

<h1>Unit Testing</h1>

<p>Daniel Rall &lt;dlr at collab dot net&gt;<br>
Aug 3, 2001<br>
<small>$Id: unit_test.html,v 1.3 2001/08/03 23:39:44 dlr Exp $</small>

<p>Employing unit testing will enable us to cheaply and incrementally
build a test suite that will help measure progress, spot unintended
side effects, and focus development efforts (further explanation <a
href="http://junit.sourceforge.net/doc/testinfected/testing.htm">here</a>).
</p>

<h2>Writing Tests</h2>

<p>The <a href="http://junit.org">JUnit</a> unit testing framework has
been integrated into Helm's Ant build files.  Examples of writing test
cases can be found in the <a
href="http://junit.sourceforge.net/#Documentation">documentation</a>,
or by looking at an <a
href="/source/browse/helm/tests/org/tigris/helm/tool/cluster/ClusteredSingletonServiceTest.java?rev=1&content-type=text/x-cvsweb-markup">existing
test case</a>.</p>

<p>Tests should be placed in the Java package tree rooted at
<code>helm/tests/</code>, which mirrors the standard package tree.
Tests should be located in the package corresponding to the code which
they test, and have class names ending in <code>Test</code>.  As an
example, any test excercizing class <code>foo.Bar</code> would be
named <code>BarTest</code>, and reside in the package
<code>foo</code>.</p>

<p>To run all the tests in Helm's suite, excecute Ant from Helm's
<code>build/</code> directory like the following:</p>

<p><code>ant test</code></p>

<p>Correctly located and packaged tests will be compiled and run by
Ant.<p>

</body>
</html>
@


1.3
log
@and -> any
@
text
@d14 1
a14 1
<small>$Id: unit_test.html,v 1.2 2001/08/03 23:39:09 dlr Exp $</small>
d39 8
@


1.2
log
@Added more HOWTO doc.
@
text
@d14 1
a14 1
<small>$Id: unit_test.html,v 1.1 2001/08/03 23:32:43 dlr Exp $</small>
d36 1
a36 1
example, and test excercizing class <code>foo.Bar</code> would be
@


1.1
log
@Short HOWTO for writing test cases.
@
text
@d14 1
a14 1
<small>$Id: $</small>
d31 8
@

