Test Generation

.gitignore

@@ -1,2 +1,3 @@
 covered-test-plan-ids.txt
-test-plan-coverage-report.txt
+test-plan-coverage-report.txt
+IFTClient/

README.md

@@ -26,3 +26,33 @@ make all
 To generate test and test plan coverage reports (test-coverage-report.txt and
 test-plan-coverage-report.txt) that specify which specification client
 conformance statements are not covered.
+
+## Generate Client Tests
+
+The test cases here are generated by the Python scripts in the generators directory.
+
+* `ClientTestCaseGenerator.py`
+
+The scripts are dependent on the following package:
+
+* FontTools https://github.com/behdad/fonttools
+
+To compile a particular test suite, simply run the relevant script:
+
+    >>> python ClientTestCaseGenerator.py
+
+To generate the subsetted fonts files needed for these tests, you can run the following command:
+
+For the fallback font:
+
+    >>>python makeSubsettedFont.py fallback
+
+(this will generate a font file that substitutes the `p` glyph with `fail` and the `f` glyph with `pass`)
+
+For the font that will be used as the source for the IFT:
+
+    >>>python makeSubsettedFont.py IFT
+
+(this will generate a font file that substitutes the `f` glyph with `fail` and the `p` glyph with `pass`)
+
+The fallback font can be used as-is and the IFT source font can be used with the IFT encoder (https://github.com/w3c/ift-encoder) to create an IFT font that is then modified by the conformance test generator scripts.  

generators/.gitignore

@@ -0,0 +1 @@
+subsettedFonts/