Reenable Doxygen ingroup test

This commit is contained in:
Nyall Dawson 2016-07-05 10:53:49 +10:00
parent 5cf733b5ca
commit cfb1895fff
2 changed files with 14 additions and 2 deletions

View File

@ -51,7 +51,7 @@ class TestQgsDocCoverage(unittest.TestCase):
assert len(parser.undocumented_string) == 0, 'FAIL: new undocumented members have been introduced, please add documentation for these members'
#self.assertTrue(len(parser.classes_missing_group) == 0, 'FAIL: {} classes have been added without Doxygen group tags ("/ingroup"):\n{}'.format(len(parser.classes_missing_group), '\n'.join(parser.classes_missing_group)))
self.assertTrue(len(parser.classes_missing_group) == 0, 'FAIL: {} classes have been added without Doxygen group tags ("\ingroup"):\n{}'.format(len(parser.classes_missing_group), '\n'.join(parser.classes_missing_group)))
self.assertTrue(len(parser.classes_missing_version_added) == 0, 'FAIL: {} classes have been added without a version added doxygen note ("@note added in QGIS x.xx"):\n{}'.format(len(parser.classes_missing_version_added), '\n'.join(parser.classes_missing_version_added)))

View File

@ -363,6 +363,18 @@ class DoxygenParser():
self.groups = {}
self.classes_missing_group = []
self.classes_missing_version_added = []
# for some reason the Doxygen generation on Travis refuses to assign these classes to groups
self.acceptable_missing_group = ['QgsOgcUtils::LayerProperties',
'QgsSQLStatement::Node',
'QgsSQLStatement::NodeBinaryOperator',
'QgsSQLStatement::NodeColumnRef',
'QgsSQLStatement::NodeFunction',
'QgsSQLStatement::NodeInOperator',
'QgsSQLStatement::NodeList',
'QgsSQLStatement::NodeLiteral',
'QgsSQLStatement::NodeUnaryOperator',
'QgsRuleBasedLabeling::Rule',
'QgsSQLStatement::Visitor']
self.parseFiles(path)
def parseFiles(self, path):
@ -426,7 +438,7 @@ class DoxygenParser():
class_name = elem.find('compoundname').text
acceptable_missing = self.acceptable_missing.get(class_name, [])
if not self.hasGroup(class_name):
if not self.hasGroup(class_name) and not class_name in self.acceptable_missing_group:
self.classes_missing_group.append(class_name)
if not class_name in self.acceptable_missing_added_note and not found_version_added:
self.classes_missing_version_added.append(class_name)