1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
|
ldappool
========
A simple connector pool for python-ldap.
The pool keeps LDAP connectors alive and let you reuse them,
drastically reducing the time spent to initiate a ldap connection.
The pool has useful features like:
- transparent reconnection on failures or server restarts
- configurable pool size and connectors timeouts
- configurable max lifetime for connectors
- a context manager to simplify acquiring and releasing a connector
**You need python-ldap in order to use this library**
Quickstart
::::::::::
To work with the pool, you just need to create it, then use it as a
context manager with the *connection* method::
from ldappool import ConnectionManager
cm = ConnectionManager('ldap://localhost')
with cm.connection('uid=adminuser,ou=logins,dc=mozilla', 'password') as conn:
.. do something with conn ..
The connector returned by *connection* is a LDAPObject, that's binded to the
server. See http://www.python-ldap.org/ for details on how to use a connector.
ConnectionManager options
:::::::::::::::::::::::::
Here are the options you can use when instanciating the pool:
- **uri**: ldap server uri **[mandatory]**
- **bind**: default bind that will be used to bind a connector.
**default: None**
- **passwd**: default password that will be used to bind a connector.
**default: None**
- **size**: pool size. **default: 10**
- **retry_max**: number of attempts when a server is down. **default: 3**
- **retry_delay**: delay in seconds before a retry. **default: .1**
- **use_tls**: activate TLS when connecting. **default: False**
- **timeout**: connector timeout. **default: -1**
- **use_pool**: activates the pool. If False, will recreate a connector
each time. **default: True**
The **connection** method takes two options:
- **bind**: bind used to connect. If None, uses the pool default's.
**default: None**
- **passwd**: password used to connect. If None, uses the pool default's.
**default: None**
|
