zjgcjy/pykd
1
0
Fork 0
mirror of https://github.com/ivellioscolin/pykd.git synced 2025-04-20 03:23:23 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

added markdown formatter for auto created documentation

Browse Source
This commit is contained in:
ussrhero 2017-12-28 12:01:03 +03:00
parent e44c85414d
commit 34c9190bdb
1 changed files with 59 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

68
snippets/pytowiki.py
View File

@ -38,6 +38,46 @@ class CodeplexFormatter:
def anchor( self, link ):
return "{anchor:" + link + "}" + self.endl()
class MarkdownFormatter:
def endl( self ):
return "\n"
def header1( self, s ):
return "# " + s + self.endl()
def header2( self, s ):
return "## " + s + self.endl()
def header3( self, s ):
return "### " + s + self.endl()
def header4( self, s ):
return "#### " + s + self.endl()
def bulletItem( self, s ):
return "* " + s + self.endl()
def escapeMarkup( self, s ):
return self.endl() + "```" + self.endl() + s + self.endl() + "```" + self.endl()
def link( self, text, link ):
return "[" + text + "](#" + link + ")"
def anchor( self, link ):
return "<a name=\"" + link + "\"></a>" + self.endl()
def escapeSymbols(self, text):
output = ""
escapeSyms = ['_']
for s in text:
if s in escapeSyms:
output += "\\" + s
else:
output += s
return output
class ModuleInfo:
@ -59,11 +99,14 @@ def buildDoc( ioStream, formatter, apiInfo ):
for func in apiInfo.funcs:
ioStream.write( formatter.bulletItem( formatter.link( func.__name__, func.__name__ ) ) )
ioStream.write( formatter.endl() )
ioStream.write( formatter.header2( "Classes" ) )
for cls in apiInfo.classes:
ioStream.write( formatter.bulletItem( formatter.link( cls.__name__, cls.__name__ ) ) )
ioStream.write( formatter.endl() )
for func in apiInfo.funcs:
ioStream.write( formatter.anchor( func.__name__ ) )
@ -89,33 +132,35 @@ def buildDoc( ioStream, formatter, apiInfo ):
ioStream.write( formatter.header4( "Properties:") )
for p in cls.properties:
ioStream.write( formatter.bulletItem( formatter.link( p[0], cls.__name__ + "." + p[0]) ) )
ioStream.write( formatter.endl() )
if cls.methods:
methods = filter( lambda m: m.__doc__ != None, cls.methods )
if methods:
ioStream.write( formatter.header4( "Methods:") )
for m in cls.methods:
if m.__doc__ != None:
ioStream.write( formatter.bulletItem( formatter.link( m.__name__, cls.__name__ + "." + m.__name__) ) )
for m in methods:
ioStream.write( formatter.bulletItem( formatter.link( formatter.escapeSymbols(m.__name__), cls.__name__ + "." + m.__name__)) )
ioStream.write( formatter.endl() )
if cls.enum:
ioStream.write( formatter.header4( "Values:") )
for v in cls.enum.items():
ioStream.write( formatter.bulletItem( "%s: %d" % v ) )
ioStream.write( formatter.endl() )
if cls.properties:
for p in cls.properties:
if p[1].__doc__ != None:
ioStream.write( formatter.anchor( cls.__name__ + "." + p[0] ) )
ioStream.write( formatter.header4( formatter.escapeMarkup( "Property " + cls.__name__ + "." + p[0] ) ) )
ioStream.write( formatter.header4( "Property " + cls.__name__ + "." + p[0] ) )
ioStream.write( formatter.escapeMarkup( p[1].__doc__ ) + formatter.endl() )
if cls.methods:
for m in cls.methods:
if m.__doc__ != None:
if methods:
for m in methods:
ioStream.write( formatter.anchor( cls.__name__ + "." + m.__name__ ) )
ioStream.write( formatter.header4( formatter.escapeMarkup( "Method " + cls.__name__ + "." + m.__name__ ) ) )
ioStream.write( formatter.header4( formatter.escapeSymbols("Method " + cls.__name__ + "." + m.__name__ )) )
ioStream.write( formatter.escapeMarkup( m.__doc__ ) + formatter.endl() )
def main():
if len(sys.argv) < 3:
@ -133,7 +178,8 @@ def main():
apiInfo = ModuleInfo( module )
formatter = CodeplexFormatter()
#formatter = CodeplexFormatter()
formatter = MarkdownFormatter()
buildDoc( wikiIo, formatter, apiInfo )