README 3.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293
  1. ---------------------------------------
  2. python-ldap: LDAP client API for Python
  3. ---------------------------------------
  4. What is python-ldap?
  5. python-ldap provides an object-oriented API to access LDAP
  6. directory servers from Python programs. Mainly it wraps the
  7. OpenLDAP client libs for that purpose.
  8. Additionally the package contains modules for other LDAP-related
  9. stuff (e.g. processing LDIF, LDAPURLs, LDAPv3 sub-schema, etc.).
  10. Not included: Direct BER support
  11. See INSTALL for version compability
  12. See TODO for planned features. Contributors welcome.
  13. For module documentation, see:
  14. http://www.python-ldap.org/
  15. Quick usage example:
  16. import ldap
  17. l = ldap.initialize("ldap://my_ldap_server.my_domain")
  18. l.simple_bind_s("","")
  19. l.search_s("o=My Organisation, c=AU", ldap.SCOPE_SUBTREE, "objectclass=*")
  20. See directory Demo/ of source distribution package for more
  21. example code.
  22. Author(s) contact:
  23. http://www.python-ldap.org/
  24. If you are looking for help, please try the mailing list archives
  25. first, then send a question to the mailing list.
  26. Be warned that questions will be ignored if they can be
  27. trivially answered by referring to the documentation.
  28. If you are interested in helping, please contact the mailing list.
  29. If you want new features or upgrades, please check the mailing list
  30. archives and then enquire about any progress.
  31. Acknowledgements:
  32. Thanks to Konstantin Chuguev <Konstantin.Chuguev at dante.org.uk>
  33. and Steffen Ries <steffen.ries at sympatico.ca> for working
  34. on support for OpenLDAP 2.0.x features.
  35. Thanks to Michael Stroeder <michael at stroeder.com> for the
  36. modules ldif, ldapurl, ldap/schema/*.py, ldap/*.py.
  37. Thanks to Hans Aschauer <Hans.Aschauer at Physik.uni-muenchen.de>
  38. for the C wrapper schema and SASL support.
  39. Thanks to Mauro Cicognini <mcicogni at siosistemi.it> for the
  40. WIN32/MSVC6 bits, and the pre-built WIN32 ldap.pyd.
  41. Thanks to Waldemar Osuch <waldemar.osuch at gmail.com> for contributing
  42. the new-style docs based on reStructuredText.
  43. Thanks to Torsten Kurbad <torsten at tk-webart.de> for the
  44. easy_install support.
  45. Thanks to James Andrewartha <jamesa at daa.com.au> for
  46. significant contribution to Doc/*.tex.
  47. These very kind people have supplied patches or suggested changes:
  48. Federico Di Gregorio <fog at mixadlive.com>
  49. John Benninghoff <johnb at netscape.com>
  50. Donn Cave <donn at u.washington.edu>
  51. Jason Gunthorpe <jgg at debian.org>
  52. gurney_j <gurney_j at 4j.lane.edu>
  53. Eric S. Johansson <esj at harvee.billerica.ma.us>
  54. David Margrave <davidma at premier1.net>
  55. Uche Ogbuji <uche.ogbuji at fourthought.com>
  56. Neale Pickett <neale at lanl.gov>
  57. Blake Weston <weston at platinum1.cambridge.scr.slb.com>
  58. Wido Depping <wido.depping at gmail.com>
  59. Deepak Giridharagopal <deepak at arlut.utexas.edu>
  60. Ingo Steuwer <steuwer at univention.de>
  61. Andreas Hasenack <ahasenack at terra.com.br>
  62. Matej Vela <vela at debian.org>
  63. Thanks to all the guys on the python-ldap-dev mailing list for
  64. their contributions and input into this package.
  65. Thanks! We may have missed someone: please mail us if we have omitted
  66. your name.
  67. $Id: README,v 1.19 2009/07/26 11:07:29 stroeder Exp $