Issue 2180 - [cms] Add support for custom Jinja2 functions

cms/converters.py

 # coding: utf-8
 
 # This file is part of the Adblock Plus web scripts,
 # Copyright (C) 2006-2015 Eyeo GmbH
 #
 # Adblock Plus is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License version 3 as
 # published by the Free Software Foundation.
 #
 # Adblock Plus is distributed in the hope that it will be useful,
@@ skipping 265 matching lines @@
 
         path = "%s/%s" % (dirname, filename)
         code = self._params["source"].read_file(path)
         module = imp.new_module(root.replace("/", "."))
         exec code in module.__dict__
 
         name = os.path.basename(root)
         if not hasattr(module, name):
           raise Exception("Expected symbol %s not found in %s file %s" % (name, dirname, filename))
         dictionary[name] = getattr(module, name)
+
+        # HACK: The module we created here can be garbage collected because it
+        # isn't added to sys.modules. If a function is called and its module is
+        # gone it might cause weird errors (imports and module variables
+        # unavailable). We avoid this situation by explicitly referencing the
+        # module from the function so they can only be garbage collected
+        # together.
         if callable(dictionary[name]):
-          dictionary[name].module_ref = module  # Prevent garbage collection
+          dictionary[name].module_ref = module
 
     self._env = jinja2.Environment(loader=self._SourceLoader(self._params["source"]), autoescape=True)
     self._env.filters.update(filters)
     self._env.globals.update(globals)
 
   def get_html(self, source):
     template = self._env.from_string(source)
     module = template.make_module(self._params)
     for key, value in module.__dict__.iteritems():
       if not key.startswith("_"):
@@ skipping 40 matching lines @@
         stack.pop()
       stack[-1]["subitems"].append(item)
       stack.append(item)
     return structured
 
 converters = {
   "html": RawConverter,
   "md": MarkdownConverter,
   "tmpl": TemplateConverter,
 }