mono/mcs/class/System.ServiceModel/Test/MetadataTests/README.txt

Metadata Tests
==============

These tests can be run either as part of System.ServiceModel_test_<profile>.dll
or as the stand-alone MetadataTests.dll, which bundles all the XML files as
embedded resources.

Generating and updating the XML Samples:
========================================

Mono's WsdlExporter is not yet capable of generating the wsdl files that
are used as test input here.

To generate the XML files, compile the ExportUtil.exe tool either by using the
ExportUtil.csproj or compiling it manually:

  mcs -r:System.ServiceModel -r:System.Web.Services ExportUtil.cs MetadataSamples.cs TestContext.cs 

Then copy the binary to a Windows machine and run it there.  This will generate a bunch of
.xml files.  Run dos2unix on them and copy them into the Resources/ subdirectory.

Adding new Tests:
=================

To add a new test, add a method with the [MetadataaSample] attribute to
MetadataSamples.cs, like this:

	[MetadataSample]
	public static MetadataSet MyXML ()
	{
		....
	}

You may also specify a name:

	[MetadataSample ("MyXML")]
	public static MetadataSet RandomMethodName ()	
	{
	}

Re-compile ExportUtil.exe and it will produce a new 'MyXML.xml' file.

Then write a new test case:

	[Test]
	public void MyXML ()
	{
		var doc = TestContext.GetMetadata ("MyXML");
		... test it here
	}

The idea behind the 'TestContext' class is to allow "self-hosting" at a
later time, ie. use Mono's WsdlExporter to generate the metadata instead
of loading the on-disk file without having to modify a bunch of tests.