Merge pull request #66 from zopefoundation/41-document-adapter-regist…

…ry-api Document API for adapter registry.
zopefoundation · Dec 6, 2016 · 310b71c · 310b71c
2 parents bad08b8 + 12371b9
commit 310b71c
Show file tree

Hide file tree

Showing 3 changed files with 25 additions and 0 deletions.
diff --git a/docs/adapter.rst b/docs/adapter.rst
@@ -1,3 +1,5 @@
+.. _adapter-registry:
+
 ================
 Adapter Registry
 ================

diff --git a/docs/api.rst b/docs/api.rst
@@ -1059,3 +1059,22 @@ For example:
 When registering an adapter or utility component, the registry looks for the
 ``__component_name__`` attribute and uses it, if no name was explicitly
 provided.
+
+
+:class:`zope.interface.adapter.AdapterRegistry`
+-----------------------------------------------
+
+API
++++
+
+The adapter registry's API is defined by
+:class:`zope.interface.interfaces.IAdapterRegistry`:
+
+.. autointerface:: zope.interface.adapter.IAdapterRegistry
+   :members:
+   :member-order: bysource
+
+Usage
++++++
+
+See :ref:`adapter-registry`.
diff --git a/src/zope/interface/adapter.py b/src/zope/interface/adapter.py
@@ -15,9 +15,11 @@
 """
 import weakref
 
+from zope.interface import implementer
 from zope.interface import providedBy
 from zope.interface import Interface
 from zope.interface import ro
+from zope.interface.interfaces import IAdapterRegistry
 
 from zope.interface._compat import _normalize_name
 
@@ -605,6 +607,7 @@ def subscribers(self, objects, provided):
 class AdapterLookup(AdapterLookupBase, LookupBase):
     pass
 
+@implementer(IAdapterRegistry)
 class AdapterRegistry(BaseAdapterRegistry):
 
     LookupClass = AdapterLookup
@@ -644,6 +647,7 @@ def changed(self, originally_changed):
 class VerifyingAdapterLookup(AdapterLookupBase, VerifyingBase):
     pass
 
+@implementer(IAdapterRegistry)
 class VerifyingAdapterRegistry(BaseAdapterRegistry):
 
     LookupClass = VerifyingAdapterLookup