[Zope3-checkins] SVN: Zope3/trunk/src/zope/app/pas/ Added combined interfaces and design notes noting that components

[Jim Fulton]

Log message for revision 28103:
  Added combined interfaces and design notes noting that components
  often provide multiple plugins.
  

Changed:
  U   Zope3/trunk/src/zope/app/pas/README.txt
  U   Zope3/trunk/src/zope/app/pas/interfaces.py

-=-
Modified: Zope3/trunk/src/zope/app/pas/README.txt
===================================================================
--- Zope3/trunk/src/zope/app/pas/README.txt	2004-10-13 15:49:32 UTC (rev 28102)
+++ Zope3/trunk/src/zope/app/pas/README.txt	2004-10-13 15:50:29 UTC (rev 28103)
@@ -544,3 +544,12 @@
   >>> [queriable.__class__.__name__ 
   ...  for (id, queriable) in service.getQueriables()]
   ['Search42', 'IntSearch']
+
+Design Notes
+============
+
+- It is common for the same component to implement authentication and
+  search or extraction and challenge. See
+  `ISearchableAuthenticationPlugin` and
+  `IExtractionAndChallengePlugin`.
+ 

Modified: Zope3/trunk/src/zope/app/pas/interfaces.py
===================================================================
--- Zope3/trunk/src/zope/app/pas/interfaces.py	2004-10-13 15:49:32 UTC (rev 28102)
+++ Zope3/trunk/src/zope/app/pas/interfaces.py	2004-10-13 15:50:29 UTC (rev 28103)
@@ -168,12 +168,12 @@
 
     - Search for principal ids
 
-    The second function is a bit tricky, because there are many ways
-    that one might search for principals.
+      Searching is provided in one of two ways:
 
-    XXX Need to say more here.  We need to work out what to say. :)
-    XXX In the mean time, see IQuerySchemaSearch.  Initially, search
-    XXX plugins should provide IQuerySchemaSearch.
+      - by implementing `IQuerySchemaSearch`, or
+
+      - by providing user interface components that support searching.
+        (See README.txt.)
     """
 
     def get(principal_id):
@@ -207,3 +207,17 @@
         integer and no more than the given number of items should be
         returned.
         """
+
+class ISearchableAuthenticationPlugin(IAuthenticationPlugin,
+                                      IPrincipalSearchPlugin):
+    """Components that provide authentication ans searching
+
+    This interface exists to make component registration a little bit easier.
+    """
+
+class IExtractionAndChallengePlugin(IExtractionPlugin, IChallengePlugin):
+    """Components that provide credential extraction and challenge
+
+    This interface exists to make component registration a little bit easier.
+    """
+