def action(self, discriminator, callable=None, args=(), kw=None, order=0):
""" Register an action which will be executed when
:meth:`pyramid.config.Configurator.commit` is called (or executed
immediately if ``autocommit`` is ``True``).
.. warning:: This method is typically only used by :app:`Pyramid`
framework extension authors, not by :app:`Pyramid` application
developers.
The ``discriminator`` uniquely identifies the action. It must be
given, but it can be ``None``, to indicate that the action never
conflicts. It must be a hashable value.
The ``callable`` is a callable object which performs the action. It
is optional. ``args`` and ``kw`` are tuple and dict objects
respectively, which are passed to ``callable`` when this action is
executed.
``order`` is a crude order control mechanism, only rarely used (has
no effect when autocommit is ``True``).
"""
if kw is None:
kw = {}
context = self._ctx
if context is None:
autocommit = self.autocommit
else:
autocommit = context.autocommit
if autocommit:
if callable is not None:
callable(*args, **kw)
else:
if context is None: # defer expensive creation of context
context = self._ctx = self._make_context(self.autocommit)
if not context.info:
# Try to provide more accurate info for conflict reports by
# wrapping the context in a decorator and attaching caller info
# to it, unless the context already has info (if it already has
# info, it's likely a context generated by a ZCML directive).
context = GroupingContextDecorator(context)
if self._ainfo:
info = self._ainfo[0]
else:
info = ''
context.info = info
context.action(discriminator, callable, args, kw, order)
