REDROOM

Preview: interface.py Size: 4.25 KB

/proc/thread-self/root/lib/python3.6/site-packages/zope/component/interface.py

##############################################################################
#
# Copyright (c) 2001, 2002 Zope Foundation and Contributors.
# All Rights Reserved.
#
# This software is subject to the provisions of the Zope Public License,
# Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
# FOR A PARTICULAR PURPOSE.
#
##############################################################################
"""Interface utility functions
"""
from zope.interface import alsoProvides
from zope.interface.interfaces import IInterface

from zope.component.globalregistry import getGlobalSiteManager
from zope.component.interfaces import ComponentLookupError
from zope.component._api import queryUtility
from zope.component._compat import CLASS_TYPES

def provideInterface(id, interface, iface_type=None, info=''):
    """ Mark 'interface' as a named utilty providing 'iface_type'.
    """
    if not id:
        id = "%s.%s" % (interface.__module__, interface.__name__)

    if not IInterface.providedBy(interface):
        if not isinstance(interface, CLASS_TYPES):
            raise TypeError(id, "is not an interface or class")
        return

    if iface_type is not None:
        if not iface_type.extends(IInterface):
            raise TypeError(iface_type, "is not an interface type")
        alsoProvides(interface, iface_type)
    else:
        iface_type = IInterface

    gsm = getGlobalSiteManager()
    gsm.registerUtility(interface, iface_type, id, info)


def getInterface(context, id):
    """Return interface or raise ComponentLookupError
    """
    iface = queryInterface(id, None)
    if iface is None:
        raise ComponentLookupError(id)
    return iface


def queryInterface(id, default=None):
    """Return an interface or ``None``
    """
    return queryUtility(IInterface, id, default)


def searchInterface(context, search_string=None, base=None):
    """Interfaces search
    """
    return [iface_util[1] for iface_util in
            searchInterfaceUtilities(context, search_string, base)]


def searchInterfaceIds(context, search_string=None, base=None):
    """Interfaces search
    """
    return [iface_util[0] for iface_util in
            searchInterfaceUtilities(context, search_string, base)]


def searchInterfaceUtilities(context, search_string=None, base=None):
    gsm = getGlobalSiteManager()
    iface_utilities = gsm.getUtilitiesFor(IInterface)

    if search_string:
        search_string = search_string.lower()
        iface_utilities = [iface_util for iface_util in iface_utilities
                           if (getInterfaceAllDocs(iface_util[1]).\
                               find(search_string) >= 0)]
    if base:
        res = [iface_util for iface_util in iface_utilities
               if iface_util[1].isOrExtends(base)]
    else:
        res = [iface_util for iface_util in iface_utilities]
    return res


def getInterfaceAllDocs(interface):
    iface_id = '%s.%s' %(interface.__module__, interface.__name__)
    docs = [str(iface_id).lower(),
            str(interface.__doc__).lower()]

    if IInterface.providedBy(interface):
        for name in sorted(interface):
            docs.append(
                str(interface.getDescriptionFor(name).__doc__).lower())

    return '\n'.join(docs)


def nameToInterface(context, id):
    if id == 'None':
        return None
    iface = getInterface(context, id)
    return iface

def interfaceToName(context, interface):
    if interface is None:
        return 'None'
    # XXX this search is pointless:  we are always going to return the
    #     same value whether or not we find anything.
    items = searchInterface(context, base=interface)
    ids = [('%s.%s' %(iface.__module__, iface.__name__))
           for iface in items
           if iface == interface]

    if not ids:
        # Do not fail badly, instead resort to the standard
        # way of getting the interface name, cause not all interfaces
        # may be registered as utilities.
        return interface.__module__ + '.' + interface.__name__

    assert len(ids) == 1, "Ambiguous interface names: %s" % ids
    return ids[0]

Name	Size	Perms	Modified	Actions
testfiles DIR	-	drwxr-xr-x	2025-04-13 08:21:05	Edit Download recursive recursive
tests DIR	-	drwxr-xr-x	2025-04-13 08:21:05	Edit Download recursive recursive
__pycache__ DIR	-	drwxr-xr-x	2025-04-13 08:21:05	Edit Download recursive recursive
configure.zcml	444 B	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive
event.py	1.20 KB	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive
eventtesting.py	2.04 KB	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive
factory.py	1.71 KB	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive
globalregistry.py	2.67 KB	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive
hookable.py	1.29 KB	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive
hooks.py	4.18 KB	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive
interface.py	4.25 KB	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive
interfaces.py	16.28 KB	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive
meta.zcml	1.12 KB	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive
persistentregistry.py	2.05 KB	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive
registry.py	2.14 KB	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive
security.py	3.54 KB	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive
standalonetests.py	1.18 KB	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive
testing.py	1.23 KB	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive
testlayer.py	4.09 KB	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive
zcml.py	19.94 KB	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive
_api.py	8.83 KB	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive
_compat.py	962 B	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive
_declaration.py	1.87 KB	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive
__init__.py	2.68 KB	lrw-r--r--	2016-08-26 07:39:24	Edit Download recursive recursive

Directory Contents