[Zope-CVS] SVN: ldapadapter/trunk/interfaces.py Some fields are not required.

[Florent Guillaume]

Log message for revision 28073:
  Some fields are not required.
  Document better possible exceptions returned.
  

Changed:
  U   ldapadapter/trunk/interfaces.py

-=-
Modified: ldapadapter/trunk/interfaces.py
===================================================================
--- ldapadapter/trunk/interfaces.py	2004-10-13 12:47:49 UTC (rev 28072)
+++ ldapadapter/trunk/interfaces.py	2004-10-13 12:48:22 UTC (rev 28073)
@@ -46,16 +46,20 @@
     bindDN = TextLine(
         title=_("Bind DN"),
         default=u'',
+        required=False,
         )
     bindPassword = TextLine(
         title=_("Bind password"),
         default=u'',
+        required=False,
         )
 
     def connect(dn, password=None):
         """Connect to the server.
 
         Returns an ILDAPConnection.
+
+        May raise InvalidCredentials.
         """
 
 class ILDAPAdapterManagement(Interface):
@@ -72,10 +76,12 @@
     bindDN = TextLine(
         title=_("Bind DN"),
         default=u'',
+        required=False,
         )
     bindPassword = TextLine(
         title=_("Bind password"),
         default=u'',
+        required=False,
         )
 
 class IManageableLDAPAdapter(ILDAPAdapter,
@@ -106,6 +112,8 @@
         - dn is a unicode dn.
 
         - entry is the subset of attributes we want to modify.
+
+        May raise NoSuchObject.
         """
 
     def search(base, scope='one', filter='(objectClass=*)', attrs=None):
@@ -123,7 +131,7 @@
         Returns a sequence of (dn, entry), where dn is unicode and entry
         is a mapping whose values are lists of unicode strings.
 
-        May raise ldap exceptions.
+        May raise NoSuchObject.
         """
         # TODO: some values are binary and should not be converted to unicode