python-ldap / README

Full commit
python-ldap: LDAP client API for Python

What is python-ldap?

python-ldap provides an object-oriented API to access LDAP
directory servers from Python programs. Mainly it wraps the
OpenLDAP 2.x libs for that purpose.

Additionally the package contains modules for other LDAP-related
stuff (e.g. processing LDIF, LDAPURLs, LDAPv3 sub-schema, etc.).

Not included: Direct BER support

See TODO for planned features. Contributors welcome.

Most parts should still work with Python 1.5.x. See compability notes
in module headers.

For module documentation, see:

Quick usage example:
    import ldap
    l = ldap.initialize("ldap://my_ldap_server.my_domain")
    l.search_s("o=My Organisation, c=AU", ldap.SCOPE_SUBTREE, "objectclass=*")

See directory Demo/ of source distribution package for more
example code.

Author(s) contact:

   If you are looking for help, please try the mailing list archives
   first, then send a question to the mailing list.
   Be warned that questions will be ignored if they can be
   trivially answered by referring to the documentation.

   If you are interested in helping, please contact the mailing list.
   If you want new features or upgrades, please check the mailing list
   archives and then enquire about any progress.


   Thanks to Konstantin Chuguev <Konstantin.Chuguev at>
   and Steffen Ries <steffen.ries at> for working
   on support for OpenLDAP 2.0.x features.

   Thanks to Michael Stroeder <michael at> for the 
   modules ldif, ldapurl, ldap/schema/*.py, ldap/*.py.

   Thanks to Hans Aschauer <Hans.Aschauer at>
   for the C wrapper schema and SASL support.

   Thanks to Mauro Cicognini <mcicogni at> for the 
   WIN32/MSVC6 bits, and the pre-built WIN32 ldap.pyd.

   Thanks to James Andrewartha <jamesa at> for
   significant contribution to Doc/*.tex.
   These very kind people have supplied patches or suggested changes:

       Federico Di Gregorio <fog at>
       John Benninghoff <johnb at>
       Donn Cave <donn at>
       Jason Gunthorpe <jgg at>
       gurney_j <gurney_j at>
       Eric S. Johansson <esj at>
       David Margrave <davidma at>
       Uche Ogbuji <uche.ogbuji at>
       Neale Pickett <neale at>
       Blake Weston <weston at>
       Wido Depping <wido.depping at>
       Deepak Giridharagopal <deepak at>
       Ingo Steuwer <steuwer at>
       Andreas Hasenack <ahasenack at>
       Torsten Kurbad <torsten at>
       Matej Vela <vela at>

   Thanks to all the guys on the python-ldap-dev mailing list for
   their contributions and input into this package.

   Thanks! We may have missed someone: please mail us if we have omitted
   your name.