src/pyams_template/metaconfigure.py
changeset 15 c3d0112a61f6
parent 0 31ded33115d7
--- a/src/pyams_template/metaconfigure.py	Mon Nov 25 15:46:23 2019 +0100
+++ b/src/pyams_template/metaconfigure.py	Tue Nov 26 10:01:36 2019 +0100
@@ -10,36 +10,41 @@
 # FOR A PARTICULAR PURPOSE.
 #
 
-__docformat__ = 'restructuredtext'
+"""PyAMS_template.metadirectives module
 
+Is module allows to handle <template /> and <layout > directives in ZCML files.
 
-# import standard library
+"""
+
 import os
 
-# import interfaces
-from pyams_template.interfaces import ILayoutTemplate, IContentTemplate
+from pyramid.exceptions import ConfigurationError
 from pyramid.interfaces import IRequest
+from zope.component import zcml
+from zope.interface import Interface, directlyProvides
 
-# import packages
+from pyams_template.interfaces import IContentTemplate, ILayoutTemplate
 from pyams_template.template import TemplateFactory
-from pyramid.exceptions import ConfigurationError
-from zope.component import zcml
-from zope.interface import directlyProvides, Interface
+
+
+__docformat__ = 'restructuredtext'
 
 
 def template_directive(_context, template, name=u'',
                        for_=Interface,
                        layer=IRequest,
                        provides=IContentTemplate,
-                       contentType='text/html',
+                       content_type='text/html',
                        macro=None,
                        context=None):
+    # pylint: disable=too-many-arguments
+    """ZCML <template /> directive handler"""
     # Make sure that the template exists
     template = os.path.abspath(str(_context.path(template)))
     if not os.path.isfile(template):
         raise ConfigurationError("No such file", template)
 
-    factory = TemplateFactory(template, contentType, macro)
+    factory = TemplateFactory(template, content_type, macro)
     directlyProvides(factory, provides)
 
     if context is not None:
@@ -58,8 +63,10 @@
                               for_=Interface,
                               layer=IRequest,
                               provides=ILayoutTemplate,
-                              contentType='text/html',
+                              content_type='text/html',
                               macro=None,
                               context=None):
+    # pylint: disable=too-many-arguments
+    """ZCML <layout /> directive handler"""
     template_directive(_context, template, name, for_, layer, provides,
-                       contentType, macro, context)
+                       content_type, macro, context)