templating: rename precompileTemplates to precompile

Author: techtonik

roundup/cgi/engine_jinja2.py

@@ -25,7 +25,7 @@
 [ ] figure out what to do with autoescaping - it is disabled
     by default in Jinja2
 
-[ ] precompileTemplates is a stub
+[ ] precompile() is a stub
 
 [ ] add {{ debug() }} dumper to inspect available variables
     https://github.com/mitsuhiko/jinja2/issues/174
@@ -59,7 +59,7 @@ def load(self, tplname):
         #src, filename = self.check(tplname)
         return Jinja2ProxyPageTemplate(self._env.get_template(tplname + '.html'))
 
-    def precompileTemplates(self):
+    def precompile(self):
         pass
 
 class Jinja2ProxyPageTemplate(TemplateBase):

roundup/cgi/templating.py

@@ -84,9 +84,11 @@ def __init__(self, dir):
         # loaders are given the template directory as a first argument
         pass
 
-    def precompileTemplates(self):
-        """ Go through a directory and precompile all the templates therein
+    def precompile(self):
+        """ This method may be called when tracker is loaded to precompile
+            templates that support this ability.
         """
+        # [ ] move implementation out of API
         for filename in os.listdir(self.dir):
             # skip subdirs
             if os.path.isdir(filename):
@@ -120,6 +122,7 @@ def check(self, name):
 
     def __getitem__(self, name):
         """Special method to access templates by loader['name']"""
+        # [ ] not sure if it is needed for anything except TAL templates
         try:
             return self.load(name)
         except NoTemplate, message:

roundup/instance.py

@@ -66,7 +66,7 @@ def __init__(self, tracker_home, optimize=0):
         self.backend = backends.get_backend(self.get_backend_name())
 
         if self.optimize:
-            self.templates.precompileTemplates()
+            self.templates.precompile()
             # initialize tracker extensions
             for extension in self.get_extensions('extensions'):
                 extension(self)
@@ -290,7 +290,7 @@ def open(self, tracker_home, optimize=0):
         tracker.optimize = optimize
         tracker.templates = templating.get_loader(tracker.config["TEMPLATES"])
         if optimize:
-            tracker.templates.precompileTemplates()
+            tracker.templates.precompile()
 
         return tracker