External/libvirt
1
0
Fork 0
mirror of https://gitlab.com/libvirt/libvirt.git synced 2024-07-11 12:25:52 +00:00
Code Issues Packages Projects Releases Wiki Activity

apibuild: Simplify parseTypeComment()

Browse Source 
Improve readability and reduce complexity the method
parseTypeComment().

Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
Signed-off-by: Radostin Stoyanov <rstoyanov1@gmail.com>
This commit is contained in:
Radostin Stoyanov 2018-03-20 06:49:02 +00:00 committed by Daniel P. Berrangé
parent c57b56756a
commit 06462d7927
1 changed files with 16 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
docs/apibuild.py
View File

@ -756,48 +756,38 @@ class CParser:
#
# Parse a comment block associate to a typedef
#
def parseTypeComment(self, name, quiet=0):
def parseTypeComment(self, name, quiet=False):
if name[0:2] == '__':
quiet = 1
args = []
desc = ""
quiet = True
if self.comment is None:
if not quiet:
self.warning("Missing comment for type %s" % (name))
return((args, desc))
if self.comment[0] != '*':
return None
if not self.comment.startswith('*'):
if not quiet:
self.warning("Missing * in type comment for %s" % (name))
return((args, desc))
return None
lines = self.comment.split('\n')
if lines[0] == '*':
del lines[0]
# Remove lines that contain only single asterisk
lines[:] = [line for line in lines if line.strip() != '*']
if lines[0] != "* %s:" % (name):
if not quiet:
self.warning("Misformatted type comment for %s" % (name))
self.warning(" Expecting '* %s:' got '%s'" % (name, lines[0]))
return((args, desc))
return None
del lines[0]
while len(lines) > 0 and lines[0] == '*':
del lines[0]
desc = ""
while len(lines) > 0:
l = lines[0]
while len(l) > 0 and l[0] == '*':
l = l[1:]
l = l.strip()
desc = desc + " " + l
del lines[0]
desc = desc.strip()
# Concatenate all remaining lines by striping leading asterisks
desc = " ".join([line.lstrip("*").strip() for line in lines]).strip()
if quiet == 0:
if desc == "":
self.warning("Type comment for %s lack description of the macro" % (name))
if not (quiet or desc):
self.warning("Type comment for %s lack description of the macro"
% (name))
return(desc)
return desc
#
# Parse a comment block associate to a macro
#