Flush
[mono.git] / web / testing
index 4892a554077054ee230a5d317265e83ec085b73e..ab60d7fe4d3f88aef1074b23f49c955a094f9b45 100644 (file)
@@ -1,5 +1,7 @@
 * Testing
 
 * Testing
 
+       Daily <a href="http://www.go-mono.com/tests/index.php">test</a> results.
+
        Testing is an important part of the Mono project: every one of its
        three major components has a test suite tailored for its needs.  This
        is very helpful, because in the course of developing the software it
        Testing is an important part of the Mono project: every one of its
        three major components has a test suite tailored for its needs.  This
        is very helpful, because in the course of developing the software it
 
                <li><a href="#runtime"><b>Runtime tests</b></a>: Tests for 
                the virtual machine.
 
                <li><a href="#runtime"><b>Runtime tests</b></a>: Tests for 
                the virtual machine.
+
+               <li><a href="#aspnet"><b>ASP.NET tests</b></a>: ASP.NET tests.
+
+               <li><a href="#ws"><b>Web Services tests</b></a>: Web Services 
+               client/server tests.
        </ul>
 
 <a name="unit"></a>
        </ul>
 
 <a name="unit"></a>
        (For example, managed XSLT has standalone test which downloads and
        expands some megabytes of OASIS test suite.)
 
        (For example, managed XSLT has standalone test which downloads and
        expands some megabytes of OASIS test suite.)
 
+       Here I list them up as long as I know. If you are going to add another
+       standalone tests, please add one line here. It is also recommended that
+       you add some notes on how to build and run tests.
+
+       <ul>
+
+               * Mono.Data/test/
+               * System.Data/Test, and some individual ADO.NET libraries:
+                 there are some standalone tests. See the bottom of <a href="ado-net.html">
+                 ADO.NET page</a> for detail.
+               * System.Web/Test/TestMonoWeb : see README
+               * System.Web.Services/Test/standalone : see README
+               * System.Windows.Forms/SWFTest/
+               * System.XML/Test/System.Xml/standalone_tests : see README
+               * System.XML/Test/System.Xml.Schema/standalone_tests : see README
+               * System.XML/System.Xml.Serialization/standalone_tests/
+               * System.XML/Test/System.Xml.Xsl/standalone_tests : see README
+               * Commons.Xml.Relaxng/Test/standalone_tests : see README
+
+       </ul>
+
 ** Getting started
 
        If you are new to writing NUnit tests, there is a template you may use
 ** Getting started
 
        If you are new to writing NUnit tests, there is a template you may use
@@ -60,8 +88,8 @@
        testing.
        
        Once all of that is done, you can do a 'make test' from the top mcs
        testing.
        
        Once all of that is done, you can do a 'make test' from the top mcs
-       directory.  Your test class will be automagically included in the
-       build and the tests will be run along with all the others.
+       directory.  Your test class needs also to be listed in the
+       .sources file at the top of the Test directory.
 
 * Tips on writing Unit tests.
 
 
 * Tips on writing Unit tests.
 
        bug in their runtime or something is misleading or wrong in their
        documentation. In this case, please put a detailed description of the
        problem to mcs/class/doc/API-notes and do also report it to the 
        bug in their runtime or something is misleading or wrong in their
        documentation. In this case, please put a detailed description of the
        problem to mcs/class/doc/API-notes and do also report it to the 
-       <a href="mailing-lists">mailing list</a> - we'll forward this to the
+       <a href="mailing-lists.html">mailing list</a> - we'll forward this to the
        Microsoft people from time to time to help them fix their documentation
        and runtime.
 
        Microsoft people from time to time to help them fix their documentation
        and runtime.
 
 <pre>
        cd mono/mono/tests
        make test
 <pre>
        cd mono/mono/tests
        make test
-</pre>
\ No newline at end of file
+</pre>
+
+<a name="aspnet"></a>
+* ASP.NET tests
+
+       XSP, the Mono ASP.NET server has tests for ASP.NET pages. It uses
+       <a href="http://nunitasp.sourceforge.net">NUnitAsp</a>. Right now
+       it only has standalone tests, ie., tests that do not need their own
+       global.asax or web.config files.
+
+       If you want to run them, get the xsp CVS module and install it. Then:
+<pre>
+       cd xsp/nunit-tests
+       make
+       cd standalone
+       xsp
+</pre>
+
+       And from another terminal:
+<pre>
+       cd xsp/nunit-tests/standalone
+       nunit-console standalone-tests.dll
+</pre>
+
+<a name="ws"></a>
+* Web Services tests
+
+       The Test directory for the System.Web.Services assembly contains a
+       standalone test suite for testing web services. It tests:
+
+       <ul>
+       <li>Proxy generation using the wsdl tool</li>
+       <li>Access to web services using the generated client proxies</li>
+       <li>Execution of web services in the server</li>
+       </ul>
+
+       This suite not only tests web services running on XSP, but it can also test
+       services running on other platforms and that are available in internet. This
+       will help track down interoperability issues.
+
+       To build the test suite, just run:
+       
+<pre>
+       cd mcs/class/System.Web.Services/Test/standalone
+       xsp --root server
+</pre>
+       
+       And from another terminal:
+<pre>
+       cd mcs/class/System.Web.Services/Test/standalone
+       make
+       nunit-console testclient.dll
+</pre>
+       
+       This will download the wsdl documents, generate the proxies, build a dll with
+       the proxies, and build the nunit tests. Then you can use nunit-console or
+       gnunit to run the tests (the nunit dll is testclient.dll).
+
+       Read the README file in mcs/class/System.Web.Services/Test/standalone for
+       more info.