DocumentationTools/IndexGenerator.py

changeset 945
8cd4d08fa9f6
parent 791
9ec2ac20e54e
child 1509
c0b5e693b0eb
--- a/DocumentationTools/IndexGenerator.py	Fri Mar 11 08:55:14 2011 +0100
+++ b/DocumentationTools/IndexGenerator.py	Fri Mar 11 16:51:57 2011 +0100
@@ -15,11 +15,12 @@
 
 from Utilities import joinext
 
+
 class IndexGenerator(object):
     """
     Class implementing the index generator for the builtin documentation generator.
     """
-    def __init__(self, outputDir, colors, stylesheet = None):
+    def __init__(self, outputDir, colors, stylesheet=None):
         """
         Constructor
         
@@ -30,10 +31,10 @@
         """
         self.outputDir = outputDir
         self.packages = {
-            "00index" : {
-                "description" : "",
-                "subpackages" : {},
-                "modules" : {}
+            "00index": {
+                "description": "",
+                "subpackages": {},
+                "modules": {}
             }
         }
         self.remembered = False
@@ -66,7 +67,7 @@
         Public method to remember a documentation file.
         
         @param file The filename to be remembered. (string)
-        @param moduleDocument The ModuleDocument object containing the 
+        @param moduleDocument The ModuleDocument object containing the
             information for the file.
         @param basename The basename of the file hierarchy to be documented.
             The basename is stripped off the filename if it starts with
@@ -91,9 +92,9 @@
             elt["subpackages"][package] = moduleDocument.shortDescription()
                 
             self.packages[package] = {
-                "description" : moduleDocument.description(),
-                "subpackages" : {},
-                "modules" : {}
+                "description": moduleDocument.description(),
+                "subpackages": {},
+                "modules": {}
             }
             
             if moduleDocument.isEmpty():
@@ -107,7 +108,7 @@
         elt["modules"][moduleDocument.name()] = \
             moduleDocument.shortDescription()
     
-    def __writeIndex(self, packagename, package, newline = None):
+    def __writeIndex(self, packagename, package, newline=None):
         """
         Private method to generate an index file for a package.
         
@@ -136,12 +137,12 @@
             for name in names:
                 link = joinext("index-{0}".format(name), ".html")
                 lst.append(self.indexListEntryTemplate.format(**{
-                    "Description" : subpacks[name],
-                    "Name" : name.split(".")[-1],
-                    "Link" : link,
+                    "Description": subpacks[name],
+                    "Name": name.split(".")[-1],
+                    "Link": link,
                 }))
             subpackages = self.indexListPackagesTemplate.format(**{
-                "Entries" : "".join(lst),
+                "Entries": "".join(lst),
             })
             
         # 2) modules
@@ -155,32 +156,32 @@
                 if nam == "__init__":
                     nam = name.split(".")[-2]
                 lst.append(self.indexListEntryTemplate.format(**{
-                    "Description" : mods[name],
-                    "Name" : nam,
-                    "Link" : link,
+                    "Description": mods[name],
+                    "Name": nam,
+                    "Link": link,
                 }))
             modules = self.indexListModulesTemplate.format(**{
-                "Entries" : "".join(lst),
+                "Entries": "".join(lst),
             })
             
         doc = self.headerTemplate.format(**{ \
-                "Title" : title,
-                "Style" : self.stylesheet}) + \
+                "Title": title,
+                "Style": self.stylesheet}) + \
               self.indexBodyTemplate.format(**{ \
-                "Title" : title,
-                "Description" : package["description"],
-                "Subpackages" : subpackages,
-                "Modules" : modules,
+                "Title": title,
+                "Description": package["description"],
+                "Subpackages": subpackages,
+                "Modules": modules,
               }) + \
               self.footerTemplate
     
-        f = open(filename, "w", encoding = "utf-8", newline = newline)
+        f = open(filename, "w", encoding="utf-8", newline=newline)
         f.write(doc)
         f.close()
     
         return filename
     
-    def writeIndices(self, basename = "", newline = None):
+    def writeIndices(self, basename="", newline=None):
         """
         Public method to generate all index files.
         
@@ -200,7 +201,7 @@
         for package, element in list(self.packages.items()):
             try:
                 if basename:
-                    package = package.replace(basename,"")
+                    package = package.replace(basename, "")
                 out = self.__writeIndex(package, element, newline)
             except IOError as v:
                 sys.stderr.write("{0} error: {1}\n".format(package, v[1]))

eric ide

mercurial