Skip to content

Commit

Permalink
readme
Browse files Browse the repository at this point in the history
  • Loading branch information
cannatag committed Aug 8, 2020
1 parent 825a020 commit bb8ae01
Showing 1 changed file with 13 additions and 13 deletions.
26 changes: 13 additions & 13 deletions README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -17,11 +17,18 @@ LDAP3
ldap3 is a strictly RFC 4510 conforming **LDAP V3 pure Python client** library. The same codebase runs in Python 2, Python 3, PyPy and PyPy3.


A more pythonic LDAP
--------------------

LDAP operations look clumsy and hard-to-use because they reflect the old-age idea that time-consuming operations should be performed client-side
to not hog the server with heavy elaborations. To alleviate this ldap3 includes a fully functional **Abstraction Layer** that lets you
interact with the LDAP server in a modern and *pythonic* way. With the Abstraction Layer you don't need to directly issue any LDAP operation at all.


Version 2.8 note
-----------------

Version 2.8 of ldap3 introduced **SafeSync**, a new connection strategy that can be used in multithreaded programs. In previous version only the
ASYNC strategy was thread safe.
Version 2.8 of ldap3 introduced **SafeSync**, a new connection strategy that can be used in multithreaded programs. In previous version only the ASYNC strategy was thread safe.
Each LDAP operation with the SafeSync strategy returns a tuple of four elements: status, result, response and request.

* status: states if the operation was successful
Expand All @@ -41,18 +48,11 @@ Version 2.8 of ldap3 introduced **SafeSync**, a new connection strategy that can
status, result, response, _ = conn.search('o=test', '(objectclass=*)') # usually you don't need the original request (4th element of the return tuple)


A more pythonic LDAP
--------------------

LDAP operations look clumsy and hard-to-use because they reflect the old-age idea that time-consuming operations should be performed client-side
to not hog the server with heavy elaborations. To alleviate this ldap3 includes a fully functional **Abstraction Layer** that lets you
interact with the LDAP server in a modern and *pythonic* way. With the Abstraction Layer you don't need to directly issue any LDAP operation at all.


Home Page
---------

Project home page is https://github.com/cannatag/ldap3
The home page of the ldap3 project is https://github.com/cannatag/ldap3


Documentation
Expand All @@ -65,7 +65,7 @@ License
-------

The ldap3 project is open source software released under the **LGPL v3 license**.
Copyright 2013 - 2018 Giovanni Cannata
Copyright 2013 - 2020 Giovanni Cannata


PEP8 Compliance
Expand Down Expand Up @@ -98,8 +98,8 @@ Continuous integration
Continuous integration for testing is at https://travis-ci.org/cannatag/ldap3


Support
-------
Support & Development
---------------------

You can submit support tickets on https://github.com/cannatag/ldap3/issues/new
You can submit pull request on the **dev** branch at https://github.com/cannatag/ldap3/tree/dev
Expand Down

0 comments on commit bb8ae01

Please sign in to comment.