From 5b9d4cce23e56edfd88ba0a1b32693d0f382bd1d Mon Sep 17 00:00:00 2001
From: Burak Arslan <burak-github@arskom.com.tr>
Date: Tue, 28 Sep 2010 23:14:45 +0300
Subject: [PATCH] improve test documentation

---
 src/soaplib/test/README              | 103 +++++++++++++++++++++++++++
 src/soaplib/test/interop/test_wsi.py |   6 +-
 2 files changed, 106 insertions(+), 3 deletions(-)
 create mode 100644 src/soaplib/test/README

diff --git a/src/soaplib/test/README b/src/soaplib/test/README
new file mode 100644
index 000000000..652cd3337
--- /dev/null
+++ b/src/soaplib/test/README
@@ -0,0 +1,103 @@
+
+To run all of the tests, you must
+1) launch the interop.server.basic
+2) get wsi-interop-tools and unpack it next to test_wsi.py. Here's the
+directory tree from a working setup:
+
+|-- README.md
+|-- __init__.py
+|-- interop
+|   |-- __init__.py
+|   |-- config.xml
+|   |-- server
+|   |   |-- __init__.py
+|   |   |-- _service.py
+|   |   |-- basic.py
+|   |   `-- static.py
+|   |-- test_rpc.rb
+|   |-- test_suds.py
+|   |-- test_wsi.py
+|   |-- wsi-report-soaplib.xml
+|   `-- wsi-test-tools
+|       |-- License.htm
+|       |-- README.txt
+|       |-- common
+|       |   |-- docs
+|       |   |   |-- AnalyzerSpecification.pdf
+|       |   |   |-- MonitorSpecification.pdf
+|       |   |   `-- UserGuide.pdf
+|       |   |-- profiles
+|       |   |   |-- BasicProfileTestAssertions.xml
+|       |   |   |-- BasicProfile_1.1_TAD.xml
+|       |   |   `-- SSBP10_BP11_TAD.xml
+|       |   |-- schemas
+|       |   |   |-- XMLSchema.xsd
+|       |   |   |-- analyzerConfig.xsd
+|       |   |   |-- assertions.xsd
+|       |   |   |-- claim.xsd
+|       |   |   |-- common.xsd
+|       |   |   |-- log.xsd
+|       |   |   |-- monitorConfig.xsd
+|       |   |   |-- report.xsd
+|       |   |   |-- soapEncoding.xsd
+|       |   |   |-- soapEnvelope.xsd
+|       |   |   |-- wsdl11.xsd
+|       |   |   |-- wsdlSoap.xsd
+|       |   |   `-- xml.xsd
+|       |   `-- xsl
+|       |       |-- assertions.xsl
+|       |       |-- assertionsBigFont.xsl
+|       |       |-- common.xsl
+|       |       |-- log.xsl
+|       |       |-- logBigFont.xsl
+|       |       |-- monitorConfig.xsl
+|       |       |-- report.xsl
+|       |       `-- reportBigFont.xsl
+|       `-- java
+|           |-- ReleaseNotes.txt
+|           |-- about.html
+|           |-- bin
+|           |   |-- Analyzer.bat
+|           |   |-- Analyzer.sh
+|           |   |-- Monitor.bat
+|           |   |-- Monitor.sh
+|           |   |-- setenv.bat
+|           |   `-- setenv.sh
+|           |-- lib
+|           |   |-- axis.jar
+|           |   |-- comments.xml
+|           |   |-- commons-discovery.jar
+|           |   |-- commons-logging.jar
+|           |   |-- jaxrpc.jar
+|           |   |-- saaj.jar
+|           |   |-- uddi4j.jar
+|           |   |-- wsdl4j.jar
+|           |   |-- wsi-test-tools.jar
+|           |   |-- xercesImpl.jar
+|           |   `-- xmlParserAPIs.jar
+|           |-- licenses
+|           |   |-- axis-LICENSE.txt
+|           |   |-- eclipse-LICENSE.txt
+|           |   |-- uddi4j-LICENSE.html
+|           |   |-- wsdl4j-license.html
+|           |   `-- xerces-LICENSE.txt
+|           `-- samples
+|               |-- RetailerService.wsdl
+|               |-- analyzerConfig.xml
+|               |-- analyzerConfigServiceLocation.xml
+|               |-- analyzerConfigUDDI.xml
+|               |-- log.xml
+|               |-- monitorConfig.xml
+|               `-- report.xml
+|-- serializers
+|   |-- __init__.py
+|   |-- test_binary.py
+|   |-- test_clazz.py
+|   |-- test_enum.py
+|   |-- test_include.py
+|   |-- test_primitive.py
+|   `-- test_table.py
+|-- test_service.py
+|-- test_soap.py
+`-- wsdl.xml
+
diff --git a/src/soaplib/test/interop/test_wsi.py b/src/soaplib/test/interop/test_wsi.py
index 177ad3774..61a3ae713 100755
--- a/src/soaplib/test/interop/test_wsi.py
+++ b/src/soaplib/test/interop/test_wsi.py
@@ -3,10 +3,10 @@
 # WS-I interoperability test http://www.ws-i.org/deliverables/workinggroup.aspx?wg=testingtools
 # latest download: http://www.ws-i.org/Testing/Tools/2005/06/WSI_Test_Java_Final_1.1.zip
 #
-# before launching it, you should download the zip file and unpack it in this directory
-# this should create the wsi-test-tools directory
+# Before launching this test, you should download the zip file and unpack it in this
+# directory this should create the wsi-test-tools directory.
 #
-# adapted from http://thestewscope.wordpress.com/2008/08/19/ruby-wrapper-for-ws-i-analyzer-tools/
+# Adapted from http://thestewscope.wordpress.com/2008/08/19/ruby-wrapper-for-ws-i-analyzer-tools/
 # from Luca Dariz  <luca.dariz@unife.it>
 #