validator/misc/testsuite/lib Documentation.py,NONE,1.1 TestCase.py,1.3,1.4

Update of /sources/public/validator/misc/testsuite/lib
In directory hutz:/tmp/cvs-serv5910/lib

Modified Files:
	TestCase.py 
Added Files:
	Documentation.py 
Log Message:
finalizing routines and templates for the listing and generation of test cases documentation from the catalog - needs jinja2 template engine

Index: TestCase.py
===================================================================
RCS file: /sources/public/validator/misc/testsuite/lib/TestCase.py,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- TestCase.py	22 Jul 2008 17:23:23 -0000	1.3
+++ TestCase.py	28 Jul 2008 19:38:26 -0000	1.4
@@ -87,10 +87,13 @@
             raise v
         return ts_node
 
-    def readTestCollection(self, collection_node):
+    def readTestCollection(self, collection_node, level=None):
         """read a test collection from a given ElementTree collection node
         The collection can have test cases as children (which will be read and returned)"""
+        if level == None:
+            level = 0
         testcollection = ValidatorTestCollection()
+        testcollection.level = level
         if collection_node.attrib.has_key("id"):
             testcollection.collection_id = collection_node.attrib["id"]
         else:
@@ -110,7 +113,7 @@
             self.collections.append(testcollection)
         for child_node in collection_node.getchildren():
             if child_node.tag == "collection":
-                self.readTestCollection(child_node)
+                self.readTestCollection(child_node, level=level+1)
 
 
     def readTestCase(self, testcase_node):
@@ -137,6 +140,7 @@
     def __init__(self):
         super(ValidatorTestCollection, self).__init__()
         self.collection_id = None
+        self.level = None
         self.title = None
                     
 

--- NEW FILE: Documentation.py ---
#!/usr/bin/env python
# encoding: utf-8
"""
Documentation.py
Generate Link Test Suite index and documentation

Created by olivier Thereaux on 2008-01-30.
Copyright (c) 2008 W3C. Licensed under the W3C Software License
http://www.w3.org/Consortium/Legal/copyright-software
"""

import sys
import os
import unittest
import TestCase
import datetime

class Documentation:
    def __init__(self, type=None):
        ok_types = ['test', 'list', 'index']
        if type in ok_types:
            self.type = type
        else:
            self.type = 'index'
        self.test_suite = list()

    def addTestSuite(self, test_suite):
        if isinstance(test_suite, TestCase.ValidatorTestSuite) == 0:
            raise TypeError("not a proper test suite") 
        else:
            self.test_suite = test_suite
    
    def generate(self, template_path=None):
        """pass through template engine"""
        import jinja2,datetime
        if template_path == None:
            template_path= os.path.abspath('..')
            template_path=os.path.join(template_path, "templates")    
        template_engine = jinja2.Environment(loader=jinja2.FileSystemLoader(template_path))
        template = template_engine.get_template(os.path.join(self.type+'.html'))
        return template.render(test_suite=self.test_suite,
        year=str(datetime.date.today().year))

class DocumentationTests(unittest.TestCase):
    def test_has_jinja2(self):
        try:
            import jinja2
        except ImportError:
            self.fail("you need to install the jinja2 templating system -- http://jinja.pocoo.org/2/")

    def test_init(self):
        """initialize a Documentation Generator"""
        generator = Documentation()
        self.assertEquals(generator.type, 'index')
    
    def test_init_default_fallback(self):
        """initialize a Documentation Generator with a bogus type"""
        generator = Documentation(type="grut")
        self.assertEquals(generator.type, 'index')

    def test_addTestSuite(self):
        """add empty test suite"""
        generator = Documentation()
        test_suite = TestCase.ValidatorTestSuite()
        generator.addTestSuite(test_suite)
        self.assertEquals(len(generator.test_suite.collections), 0)
    
    def test_bogusSuite(self):
        """add bogus test collection and raise error"""
        generator = Documentation()
        test_suite = 5 
        self.assertRaises(TypeError, Documentation.addTestSuite, generator, test_suite)
    
    def test_generate_test(self):
        """generate collections index without any collection"""
        generator = Documentation('test')
        self.assertEqual(generator.generate(), str(datetime.date.today().year))


if __name__ == '__main__':
    unittest.main()

Received on Monday, 28 July 2008 19:39:06 UTC