[Checkins] SVN: grokcore.component/branches/sylvain-subscribers/src/grokcore/component/subscription.py for purposes of symetry with getAdapter/getMultiAdapter have querySubscriptions and queryMultiSubscriptions

[Jan-Wijbrand Kolman]

Log message for revision 120018:
  for purposes of symetry with getAdapter/getMultiAdapter have querySubscriptions and queryMultiSubscriptions

Changed:
  A   grokcore.component/branches/sylvain-subscribers/src/grokcore/component/subscription.py

-=-
Added: grokcore.component/branches/sylvain-subscribers/src/grokcore/component/subscription.py
===================================================================
--- grokcore.component/branches/sylvain-subscribers/src/grokcore/component/subscription.py	                        (rev 0)
+++ grokcore.component/branches/sylvain-subscribers/src/grokcore/component/subscription.py	2011-01-31 10:53:07 UTC (rev 120018)
@@ -0,0 +1,41 @@
+##############################################################################
+#
+# Copyright (c) 2006-2007 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.
+#
+##############################################################################
+"""Grok subscriptions functions.
+"""
+from zope import component
+from grokcore.component import util
+
+def queryOrderedMultiSubscriptions(components, interface):
+    return util.sort_components(component.subscribers(components, interface))
+
+def queryOrderedSubscriptions(component, interface):
+    return queryOrderedMultiSubscriptions((component, ), interface)
+
+def queryMultiSubscriptions(components, interface):
+    """Query for subscriptions on the `components` providing `interface`.
+
+    :parameter components: tuple of components to lookup the subscription for.
+    :parameter interface: interface that the subscriptions should provide.
+    :return: a list of subscriptions.
+    """
+    return component.subscribers(components, interface)
+
+def querySubscriptions(component, interface):
+    """Query for subscriptions on `component` providing `interface`.
+
+    :parameter component: a component to lookup the subscriptions for.
+    :parameter interface: interface that the subscriptions should provide.
+    :return: a list of subscription.
+    """
+    return queryMultiSubscriptions((component,), interface)