first pass at converting bfg to pyramid namespace

1 files changed, 0 insertions, 903 deletions

diff --git a/repoze/bfg/zcml.py b/repoze/bfg/zcml.py
deleted file mode 100644
index 2bf394eb8..000000000
--- a/repoze/bfg/zcml.py
+++ /dev/null
@@ -1,903 +0,0 @@
-import os
-
-from zope.configuration import xmlconfig
-from zope.configuration.config import ConfigurationMachine
-from zope.configuration.fields import GlobalInterface
-from zope.configuration.fields import GlobalObject
-from zope.configuration.fields import Tokens
-
-from zope.interface.interfaces import IInterface
-from zope.interface import Interface
-from zope.interface import implementedBy
-from zope.interface import providedBy
-
-from zope.schema import ASCIILine
-from zope.schema import Bool
-from zope.schema import Int
-from zope.schema import TextLine
-
-from repoze.bfg.interfaces import IAuthenticationPolicy
-from repoze.bfg.interfaces import IAuthorizationPolicy
-from repoze.bfg.interfaces import IDefaultPermission
-from repoze.bfg.interfaces import IRendererFactory
-from repoze.bfg.interfaces import IRouteRequest
-from repoze.bfg.interfaces import IView
-
-from repoze.bfg.authentication import AuthTktAuthenticationPolicy
-from repoze.bfg.authentication import RemoteUserAuthenticationPolicy
-from repoze.bfg.authentication import RepozeWho1AuthenticationPolicy
-from repoze.bfg.authorization import ACLAuthorizationPolicy
-from repoze.bfg.configuration import Configurator
-from repoze.bfg.exceptions import ConfigurationError
-from repoze.bfg.exceptions import NotFound
-from repoze.bfg.exceptions import Forbidden
-from repoze.bfg.request import route_request_iface
-from repoze.bfg.resource import resource_spec_from_abspath
-from repoze.bfg.static import StaticURLInfo
-from repoze.bfg.threadlocal import get_current_registry
-
-###################### directives ##########################
-
-class IViewDirective(Interface):
-    context = GlobalObject(
-        title=u"The interface or class this view is for.",
-        required=False
-        )
-
-    for_ = GlobalObject(
-        title=(u"The interface or class this view is for (alternate spelling "
-               "of ``context``)."),
-        required=False
-        )
-
-    permission = TextLine(
-        title=u"Permission",
-        description=u"The permission needed to use the view.",
-        required=False
-        )
-
-    view = GlobalObject(
-        title=u"",
-        description=u"The view function",
-        required=False,
-        )
-
-    name = TextLine(
-        title=u"The name of the view",
-        description=u"""
-        The name shows up in URLs/paths. For example 'foo' or 'foo.html'.""",
-        required=False,
-        )
-
-    attr = TextLine(
-        title=u'The callable attribute of the view object(default is __call__)',
-        description=u'',
-        required=False)
-
-    renderer = TextLine(
-        title=u'The renderer asssociated with the view',
-        description=u'',
-        required=False)
-
-    wrapper = TextLine(
-        title = u'The *name* of the view that acts as a wrapper for this view.',
-        description = u'',
-        required=False)
-
-    request_type = TextLine(
-        title=u"The request type string or dotted name interface for the view",
-        description=(u"The view will be called if the interface represented by "
-                     u"'request_type' is implemented by the request.  The "
-                     u"default request type is repoze.bfg.interfaces.IRequest"),
-        required=False
-        )
-
-    route_name = TextLine(
-        title = u'The route that must match for this view to be used',
-        required = False)
-
-    containment = GlobalObject(
-        title = u'Dotted name of a containment class or interface',
-        required=False)
-
-    request_method = TextLine(
-        title = u'Request method name that must be matched (e.g. GET/POST)',
-        description = (u'The view will be called if and only if the request '
-                       'method (``request.method``) matches this string. This'
-                       'functionality replaces the older ``request_type`` '
-                       'functionality.'),
-        required=False)
-
-    request_param = TextLine(
-        title = (u'Request parameter name that must exist in '
-                 '``request.params`` for this view to match'),
-        description = (u'The view will be called if and only if the request '
-                       'parameter exists which matches this string.'),
-        required=False)
-
-    xhr = Bool(
-        title = (u'True if request has an X-Requested-With header with the '
-                 'value "XMLHttpRequest"'),
-        description=(u'Useful for detecting AJAX requests issued from '
-                     'jQuery, Protoype and other JavaScript libraries'),
-        required=False)
-
-    accept = TextLine(
-        title = (u'Mimetype(s) that must be present in "Accept" HTTP header '
-                 'for the view to match a request'),
-        description=(u'Accepts a mimetype match token in the form '
-                     '"text/plain", a wildcard mimetype match token in the '
-                     'form "text/*" or a match-all wildcard mimetype match '
-                     'token in the form "*/*".'),
-        required = False)
-
-    header = TextLine(
-        title=u'Header name/value pair in the form "name=<regex>"',
-        description=u'Regular expression matching for header values',
-        required = False)
-
-    path_info = TextLine(
-        title = (u'Regular expression which must match the ``PATH_INFO`` '
-                 'header for the view to match a request'),
-        description=(u'Accepts a regular expression.'),
-        required = False)
-
-    custom_predicates = Tokens(
-        title=u"One or more custom dotted names to custom predicate callables",
-        description=(u"A list of dotted name references to callables that "
-                     "will be used as predicates for this view configuration"),
-        required=False,
-        value_type=GlobalObject()
-        )
-
-
-def view(
-    _context,
-    permission=None,
-    for_=None,
-    view=None,
-    name="",
-    request_type=None,
-    route_name=None,
-    request_method=None,
-    request_param=None,
-    containment=None,
-    attr=None,
-    renderer=None,
-    wrapper=None,
-    xhr=False,
-    accept=None,
-    header=None,
-    path_info=None,
-    traverse=None,
-    custom_predicates=(),
-    context=None,
-    cacheable=True, # not used, here for b/w compat < 0.8
-    ):
-
-    reg = get_current_registry()
-
-    if request_type in ('GET', 'HEAD', 'PUT', 'POST', 'DELETE'):
-        # b/w compat for 1.0
-        request_method = request_type
-        request_type = None
-
-    if request_type is not None:
-        request_type = _context.resolve(request_type)
-        if not IInterface.providedBy(request_type):
-            raise ConfigurationError(
-                'request_type must be an interface, not %s' % request_type)
-
-    if renderer and '.' in renderer:
-        renderer = path_spec(_context, renderer)
-
-    context = context or for_
-
-    def register():
-        config = Configurator(reg, package=_context.package)
-        config.add_view(
-            permission=permission, context=context, view=view, name=name,
-            request_type=request_type, route_name=route_name,
-            request_method=request_method, request_param=request_param,
-            containment=containment, attr=attr, renderer=renderer,
-            wrapper=wrapper, xhr=xhr, accept=accept, header=header,
-            path_info=path_info, custom_predicates=custom_predicates,
-            _info=_context.info)
-
-    discriminator = ['view', context, name, request_type, IView, containment,
-                     request_param, request_method, route_name, attr,
-                     xhr, accept, header, path_info]
-
-    discriminator.extend(sorted(custom_predicates))
-    discriminator = tuple(discriminator)
-
-    _context.action(
-        discriminator = discriminator,
-        callable = register,
-        )
-
-_view = view # for directives that take a view arg
-
-class IRouteDirective(Interface):
-    """ The interface for the ``route`` ZCML directive
-    """
-    name = TextLine(title=u'name', required=True)
-    pattern = TextLine(title=u'pattern', required=False)
-    # alias for pattern
-    path = TextLine(title=u'path', required=False)
-    factory = GlobalObject(title=u'context factory', required=False)
-    view = GlobalObject(title=u'view', required=False)
-
-    view_context = GlobalObject(title=u'view_context', required=False)
-    # aliases for view_context
-    for_ = GlobalObject(title=u'for', required=False)
-    view_for = GlobalObject(title=u'view_for', required=False)
-
-    view_permission = TextLine(title=u'view_permission', required=False)
-    # alias for view_permission
-    permission = TextLine(title=u'permission', required=False)
-
-    view_renderer = TextLine(title=u'view_renderer', required=False)
-    # alias for view_renderer
-    renderer = TextLine(title=u'renderer', required=False)
-
-    view_attr = TextLine(title=u'view_attr', required=False)
-
-    request_method = TextLine(title=u'request_method', required=False)
-    request_param = TextLine(title=u'request_param', required=False)
-    header = TextLine(title=u'header', required=False)
-    accept = TextLine(title=u'accept', required=False)
-    xhr = Bool(title=u'xhr', required=False)
-    path_info = TextLine(title=u'path_info', required=False)
-
-    traverse = TextLine(
-        title=u'Traverse pattern"',
-        description=u'A pattern which will compose a traversal path',
-        required = False)
-
-    custom_predicates = Tokens(
-        title=u"One or more custom dotted names to custom predicate callables",
-        description=(u"A list of dotted name references to callables that "
-                     "will be used as predicates for this view configuration"),
-        required=False,
-        value_type=GlobalObject()
-        )
-    use_global_views = Bool(title=u'use_global_views', required=False)
-
-def route(_context,
-          name,
-          pattern=None,
-          view=None,
-          view_for=None,
-          permission=None,
-          factory=None,
-          for_=None,
-          header=None,
-          xhr=False,
-          accept=None,
-          path_info=None,
-          request_method=None,
-          request_param=None,
-          custom_predicates=(),
-          view_permission=None,
-          view_attr=None,
-          renderer=None,
-          view_renderer=None,
-          view_context=None,
-          traverse=None,
-          use_global_views=False,
-          path=None):
-    """ Handle ``route`` ZCML directives
-    """
-    # the strange ordering of the request kw args above is for b/w
-    # compatibility purposes.
-
-    # these are route predicates; if they do not match, the next route
-    # in the routelist will be tried
-    reg = get_current_registry()
-
-    if view_context is None:
-        view_context = view_for or for_
-
-    view_permission = view_permission or permission
-    view_renderer = view_renderer or renderer
-    if view_renderer and '.' in view_renderer:
-        view_renderer = path_spec(_context, view_renderer)
-
-    if pattern is None:
-        pattern = path
-
-    if pattern is None:
-        raise ConfigurationError('route directive must include a "pattern"')
-
-    def register():
-        config = Configurator(reg, package=_context.package)
-        config.add_route(
-            name,
-            pattern,
-            factory=factory,
-            header=header,
-            xhr=xhr,
-            accept=accept,
-            path_info=path_info,
-            request_method=request_method,
-            request_param=request_param,
-            custom_predicates=custom_predicates,
-            view=view,
-            view_context=view_context,
-            view_permission=view_permission,
-            view_renderer=view_renderer,
-            view_attr=view_attr,
-            use_global_views=use_global_views,
-            traverse=traverse,
-            _info=_context.info
-            )
-
-    discriminator = ['route', name, xhr, request_method, path_info,
-                     request_param, header, accept]
-    discriminator.extend(sorted(custom_predicates))
-    discriminator = tuple(discriminator)
-        
-    _context.action(
-        discriminator=discriminator,
-        callable = register,
-        )
-
-    if view:
-        request_iface = reg.queryUtility(IRouteRequest, name=name)
-        if request_iface is None:
-            request_iface = route_request_iface(name)
-            reg.registerUtility(request_iface, IRouteRequest, name=name)
-        _context.action(
-            discriminator = (
-                'view', view_context, '', None, IView, name, view_attr),
-            )
-
-class ISystemViewDirective(Interface):
-    view = GlobalObject(
-        title=u"",
-        description=u"The view function",
-        required=False,
-        )
-
-    attr = TextLine(
-        title=u'The callable attribute of the view object(default is __call__)',
-        description=u'',
-        required=False)
-
-    renderer = TextLine(
-        title=u'The renderer asssociated with the view',
-        description=u'',
-        required=False)
-
-    wrapper = TextLine(
-        title = u'The *name* of the view that acts as a wrapper for this view.',
-        description = u'',
-        required=False)
-
-def notfound(_context,
-             view=None,
-             attr=None,
-             renderer=None,
-             wrapper=None):
-
-    if renderer and '.' in renderer:
-        renderer = path_spec(_context, renderer)
-
-    def register():
-        reg = get_current_registry()
-        config = Configurator(reg, package=_context.package)
-        config.set_notfound_view(view=view, attr=attr, renderer=renderer,
-                                 wrapper=wrapper, _info=_context.info)
-
-    discriminator = ('view', NotFound, '', None, IView, None, None, None,
-                     None, attr, False, None, None, None)
-
-    _context.action(
-        discriminator = discriminator,
-        callable = register,
-        )
-
-def forbidden(_context,
-             view=None,
-             attr=None,
-             renderer=None,
-             wrapper=None):
-
-    if renderer and '.' in renderer:
-        renderer = path_spec(_context, renderer)
-
-    def register():
-        reg = get_current_registry()
-        config = Configurator(reg, package=_context.package)
-        config.set_forbidden_view(view=view, attr=attr, renderer=renderer,
-                                 wrapper=wrapper, _info=_context.info)
-
-    discriminator = ('view', Forbidden, '', None, IView, None, None, None,
-                     None, attr, False, None, None, None)
-
-    _context.action(
-        discriminator = discriminator,
-        callable = register,
-        )
-    
-class IResourceDirective(Interface):
-    """
-    Directive for specifying that one package may override resources from
-    another package.
-    """
-    to_override = TextLine(
-        title=u"Override spec",
-        description=u'The spec of the resource to override.',
-        required=True)
-    override_with = TextLine(
-        title=u"With spec",
-        description=u"The spec of the resource providing the override.",
-        required=True)
-
-def resource(_context, to_override, override_with):
-    reg = get_current_registry()
-    config = Configurator(reg, package=_context.package)
-
-    _context.action(
-        discriminator = None,
-        callable = config.override_resource,
-        args = (to_override, override_with, _context.info),
-        )
-
-class IRepozeWho1AuthenticationPolicyDirective(Interface):
-    identifier_name = TextLine(title=u'identitfier_name', required=False,
-                               default=u'auth_tkt')
-    callback = GlobalObject(title=u'callback', required=False)
-
-def repozewho1authenticationpolicy(_context, identifier_name='auth_tkt',
-                                   callback=None):
-    policy = RepozeWho1AuthenticationPolicy(identifier_name=identifier_name,
-                                            callback=callback)
-    # authentication policies must be registered eagerly so they can
-    # be found by the view registration machinery
-    reg = get_current_registry()
-    config = Configurator(reg, package=_context.package)
-    config._set_authentication_policy(policy, _info=_context.info)
-    _context.action(discriminator=IAuthenticationPolicy)
-
-class IRemoteUserAuthenticationPolicyDirective(Interface):
-    environ_key = TextLine(title=u'environ_key', required=False,
-                           default=u'REMOTE_USER')
-    callback = GlobalObject(title=u'callback', required=False)
-
-def remoteuserauthenticationpolicy(_context, environ_key='REMOTE_USER',
-                                   callback=None):
-    policy = RemoteUserAuthenticationPolicy(environ_key=environ_key,
-                                            callback=callback)
-    # authentication policies must be registered eagerly so they can
-    # be found by the view registration machinery
-    reg = get_current_registry()
-    config = Configurator(reg, package=_context.package)
-    config._set_authentication_policy(policy, _info=_context.info)
-    _context.action(discriminator=IAuthenticationPolicy)
-
-class IAuthTktAuthenticationPolicyDirective(Interface):
-    secret = TextLine(title=u'secret', required=True)
-    callback = GlobalObject(title=u'callback', required=False)
-    cookie_name = ASCIILine(title=u'cookie_name', required=False,
-                            default='repoze.bfg.auth_tkt')
-    secure = Bool(title=u"secure", required=False, default=False)
-    include_ip = Bool(title=u"include_ip", required=False, default=False)
-    timeout = Int(title=u"timeout", required=False, default=None)
-    reissue_time = Int(title=u"reissue_time", required=False, default=None)
-    max_age = Int(title=u"max_age", required=False, default=None)
-    path = ASCIILine(title=u"path", required=False, default='/')
-    http_only = Bool(title=u"http_only", required=False, default=False)
-
-def authtktauthenticationpolicy(_context,
-                                secret,
-                                callback=None,
-                                cookie_name='repoze.bfg.auth_tkt',
-                                secure=False,
-                                include_ip=False,
-                                timeout=None,
-                                reissue_time=None,
-                                max_age=None,
-                                http_only=False,
-                                path='/'):
-    try:
-        policy = AuthTktAuthenticationPolicy(secret,
-                                             callback=callback,
-                                             cookie_name=cookie_name,
-                                             secure=secure,
-                                             include_ip = include_ip,
-                                             timeout = timeout,
-                                             reissue_time = reissue_time,
-                                             max_age=max_age,
-                                             http_only=http_only,
-                                             path=path)
-    except ValueError, why:
-        raise ConfigurationError(str(why))
-    # authentication policies must be registered eagerly so they can
-    # be found by the view registration machinery
-    reg = get_current_registry()
-    config = Configurator(reg, package=_context.package)
-    config._set_authentication_policy(policy, _info=_context.info)
-    _context.action(discriminator=IAuthenticationPolicy)
-
-class IACLAuthorizationPolicyDirective(Interface):
-    pass
-
-def aclauthorizationpolicy(_context):
-    policy = ACLAuthorizationPolicy()
-    # authorization policies must be registered eagerly so they can be
-    # found by the view registration machinery
-    reg = get_current_registry()
-    config = Configurator(reg, package=_context.package)
-    config._set_authorization_policy(policy, _info=_context.info)
-    _context.action(discriminator=IAuthorizationPolicy)
-
-class IRendererDirective(Interface):
-    factory = GlobalObject(
-        title=u'IRendererFactory implementation',
-        required=True)
-
-    name = TextLine(
-        title=u'Token (e.g. ``json``) or filename extension (e.g. ".pt")',
-        required=False)
-
-def renderer(_context, factory, name=''):
-    # renderer factories must be registered eagerly so they can be
-    # found by the view machinery
-    reg = get_current_registry()
-    config = Configurator(reg, package=_context.package)
-    config.add_renderer(name, factory, _info=_context.info)
-    _context.action(discriminator=(IRendererFactory, name))
-
-class IStaticDirective(Interface):
-    name = TextLine(
-        title=u"The URL prefix of the static view",
-        description=u"""
-        The directory will be served up for the route that starts with
-        this prefix.""",
-        required=True)
-
-    path = TextLine(
-        title=u'Path to the directory which contains resources',
-        description=u'May be package-relative by using a colon to '
-        'seperate package name and path relative to the package directory.',
-        required=True)
-
-    cache_max_age = Int(
-        title=u"Cache maximum age in seconds",
-        required=False,
-        default=None)
-
-def static(_context, name, path, cache_max_age=3600):
-    """ Handle ``static`` ZCML directives
-    """
-    path = path_spec(_context, path)
-    reg = get_current_registry()
-    config = Configurator(reg, package=_context.package)
-
-    _context.action(
-        discriminator=('static', name),
-        callable=config.add_static_view,
-        args = (name, path),
-        kw = {'cache_max_age':cache_max_age, '_info':_context.info},
-        )
-
-    if not '/' in name:
-        _context.action(
-            discriminator = (
-                'view', StaticURLInfo, '', None, IView, None,  None, None,
-                name, None, None, None, None, None,
-                )
-            )
-
-class IScanDirective(Interface):
-    package = GlobalObject(
-        title=u"The package we'd like to scan.",
-        required=True,
-        )
-
-def scan(_context, package):
-    reg = get_current_registry()
-    config = Configurator(reg, package=_context.package)
-    _context.action(
-        discriminator=None,
-        callable=config.scan,
-        args=(package, None, _context.info)
-        )
-
-class ITranslationDirDirective(Interface):
-    dir = TextLine(
-        title=u"Add a translation directory",
-        description=(u"Add a translation directory"),
-        required=True,
-        )
-
-def translationdir(_context, dir):
-    path = path_spec(_context, dir)
-    reg = get_current_registry()
-    config = Configurator(reg, package=_context.package)
-
-    _context.action(
-        discriminator = ('tdir', path),
-        callable=config.add_translation_dirs,
-        args = (dir,),
-        )
-
-class ILocaleNegotiatorDirective(Interface):
-    negotiator = GlobalObject(
-        title=u"Configure a locale negotiator",
-        description=(u'Configure a locale negotiator'),
-        required=True,
-        )
-
-def localenegotiator(_context, negotiator):
-    reg = get_current_registry()
-    config = Configurator(reg, package=_context.package)
-
-    _context.action(
-        discriminator = 'lnegotiator',
-        callable=config.set_locale_negotiator,
-        args = (negotiator,)
-        )
-
-class IAdapterDirective(Interface):
-    """
-    Register an adapter
-    """
-
-    factory = Tokens(
-        title=u"Adapter factory/factories",
-        description=(u"A list of factories (usually just one) that create"
-                     " the adapter instance."),
-        required=True,
-        value_type=GlobalObject()
-        )
-
-    provides  = GlobalInterface(
-        title=u"Interface the component provides",
-        description=(u"This attribute specifies the interface the adapter"
-                     " instance must provide."),
-        required=False,
-        )
-
-    for_ = Tokens(
-        title=u"Specifications to be adapted",
-        description=u"This should be a list of interfaces or classes",
-        required=False,
-        value_type=GlobalObject(
-          missing_value=object(),
-          ),
-        )
-
-    name = TextLine(
-        title=u"Name",
-        description=(u"Adapters can have names.\n\n"
-                     "This attribute allows you to specify the name for"
-                     " this adapter."),
-        required=False,
-        )
-
-def adapter(_context, factory, provides=None, for_=None, name=''):
-    if for_ is None:
-        if len(factory) == 1:
-            for_ = getattr(factory[0], '__component_adapts__', None)
-
-        if for_ is None:
-            raise TypeError("No for argument was provided and can't "
-                            "determine what the factory adapts.")
-
-    for_ = tuple(for_)
-
-    if provides is None:
-        if len(factory) == 1:
-            p = list(implementedBy(factory[0]))
-            if len(p) == 1:
-                provides = p[0]
-
-        if provides is None:
-            raise TypeError("Missing 'provided' argument")
-
-    # Generate a single factory from multiple factories:
-    factories = factory
-    if len(factories) == 1:
-        factory = factories[0]
-    elif len(factories) < 1:
-        raise ValueError("No factory specified")
-    elif len(factories) > 1 and len(for_) != 1:
-        raise ValueError("Can't use multiple factories and multiple "
-                         "for")
-    else:
-        factory = _rolledUpFactory(factories)
-    
-    registry = get_current_registry()
-    _context.action(
-        discriminator = ('adapter', for_, provides, name),
-        callable = registry.registerAdapter,
-        args = (factory, for_, provides, name, _context.info),
-        )
-
-class ISubscriberDirective(Interface):
-    """
-    Register a subscriber
-    """
-
-    factory = GlobalObject(
-        title=u"Subscriber factory",
-        description=u"A factory used to create the subscriber instance.",
-        required=False,
-        )
-
-    handler = GlobalObject(
-        title=u"Handler",
-        description=u"A callable object that handles events.",
-        required=False,
-        )
-
-    provides = GlobalInterface(
-        title=u"Interface the component provides",
-        description=(u"This attribute specifies the interface the adapter"
-                     " instance must provide."),
-        required=False,
-        )
-
-    for_ = Tokens(
-        title=u"Interfaces or classes that this subscriber depends on",
-        description=u"This should be a list of interfaces or classes",
-        required=False,
-        value_type=GlobalObject(
-          missing_value = object(),
-          ),
-        )
-
-def subscriber(_context, for_=None, factory=None, handler=None, provides=None):
-    if factory is None:
-        if handler is None:
-            raise TypeError("No factory or handler provided")
-        if provides is not None:
-            raise TypeError("Cannot use handler with provides")
-        factory = handler
-    else:
-        if handler is not None:
-            raise TypeError("Cannot use handler with factory")
-        if provides is None:
-            raise TypeError(
-                "You must specify a provided interface when registering "
-                "a factory")
-
-    if for_ is None:
-        for_ = getattr(factory, '__component_adapts__', None)
-        if for_ is None:
-            raise TypeError("No for attribute was provided and can't "
-                            "determine what the factory (or handler) adapts.")
-
-    for_ = tuple(for_)
-
-    registry = get_current_registry()
-    config = Configurator(registry=registry, package=_context.package)
-
-    if handler is not None:
-        _context.action(
-            discriminator = None,
-            callable = config.add_subscriber,
-            args = (handler, for_, _context.info),
-            )
-    else:
-        _context.action(
-            discriminator = None,
-            callable = registry.registerSubscriptionAdapter,
-            args = (factory, for_, provides, None, _context.info),
-            )
-
-class IUtilityDirective(Interface):
-    """Register a utility."""
-
-    component = GlobalObject(
-        title=u"Component to use",
-        description=(u"Python name of the implementation object.  This"
-                     " must identify an object in a module using the"
-                     " full dotted name.  If specified, the"
-                     " ``factory`` field must be left blank."),
-        required=False,
-        )
-
-    factory = GlobalObject(
-        title=u"Factory",
-        description=(u"Python name of a factory which can create the"
-                     " implementation object.  This must identify an"
-                     " object in a module using the full dotted name."
-                     " If specified, the ``component`` field must"
-                     " be left blank."),
-        required=False,
-        )
-
-    provides = GlobalInterface(
-        title=u"Provided interface",
-        description=u"Interface provided by the utility.",
-        required=False,
-        )
-
-    name = TextLine(
-        title=u"Name",
-        description=(u"Name of the registration.  This is used by"
-                     " application code when locating a utility."),
-        required=False,
-        )
-
-def utility(_context, provides=None, component=None, factory=None, name=''):
-    if factory and component:
-        raise TypeError("Can't specify factory and component.")
-
-    if provides is None:
-        if factory:
-            provides = list(implementedBy(factory))
-        else:
-            provides = list(providedBy(component))
-        if len(provides) == 1:
-            provides = provides[0]
-        else:
-            raise TypeError("Missing 'provides' attribute")
-
-    if factory:
-        kw = dict(factory=factory)
-    else:
-        # older component registries don't accept factory as a kwarg,
-        # so if we don't need it, we don't pass it
-        kw = {}
-
-    registry = get_current_registry()
-    _context.action(
-        discriminator = ('utility', provides, name),
-        callable = registry.registerUtility,
-        args = (component, provides, name, _context.info),
-        kw = kw,
-        )
-
-class IDefaultPermissionDirective(Interface):
-    name = TextLine(title=u'name', required=True)
-
-def default_permission(_context, name):
-    """ Register a default permission name """
-    # the default permission must be registered eagerly so it can
-    # be found by the view registration machinery
-    reg = get_current_registry()
-    config = Configurator(reg, package=_context.package)
-    config.set_default_permission(name)
-    _context.action(discriminator=IDefaultPermission)
-
-def path_spec(context, path):
-    # we prefer registering resource specifications over absolute
-    # paths because these can be overridden by the resource directive.
-    if ':' in path and not os.path.isabs(path):
-        # it's already a resource specification
-        return path
-    abspath = context.path(path)
-    if hasattr(context, 'package') and context.package:
-        return resource_spec_from_abspath(abspath, context.package)
-    return abspath
-
-def zcml_configure(name, package):
-    """ Given a ZCML filename as ``name`` and a Python package as
-    ``package`` which the filename should be relative to, load the
-    ZCML into the current ZCML registry.
-
-    .. note:: This feature is new as of :mod:`repoze.bfg` 1.1.
-    """
-    context = ConfigurationMachine()
-    xmlconfig.registerCommonDirectives(context)
-    context.package = package
-    xmlconfig.include(context, name, package)
-    context.execute_actions(clear=False) # the raison d'etre
-    return context.actions
-
-file_configure = zcml_configure # backwards compat (>0.8.1)
-
-def _rolledUpFactory(factories):
-    def factory(ob):
-        for f in factories:
-            ob = f(ob)
-        return ob
-    # Store the original factory for documentation
-    factory.factory = factories[0]
-    return factory
-