File: ldap-resiter.rst

package info (click to toggle)
python-ldap 3.4.4-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 2,756 kB
  • sloc: python: 9,558; ansic: 3,052; makefile: 139; sh: 79
file content (49 lines) | stat: -rw-r--r-- 1,372 bytes parent folder | download | duplicates (4)
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
:py:mod:`ldap.resiter` Generator for stream-processing of large search results
==============================================================================

.. py:module:: ldap.resiter
   :synopsis: Generator for stream-processing of large search results.
.. moduleauthor:: python-ldap project (see https://www.python-ldap.org/)


.. _ldap.resiter-classes:

.. py:class:: ResultProcessor

This is a mix-in class to be used with class :py:class:`ldap.LDAPObject` or
derived classes which has these methods:

  .. automethod:: ldap.resiter.ResultProcessor.allresults


.. _ldap.resiter-example:


Examples
--------

.. _ldap.resiter.ResultProcessor-example:

Using ldap.resiter.ResultProcessor
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

This example demonstrates how to use mix-in class ldap.resiter.ResultProcessor for
retrieving results formerly requested with :py:meth:`ldap.LDAPObject.search()` and
processing them in a for-loop.

::

  import sys,ldap,ldap.resiter

  class MyLDAPObject(ldap.ldapobject.LDAPObject,ldap.resiter.ResultProcessor):
    pass

  l = MyLDAPObject('ldap://localhost')

  # Asynchronous search method
  msg_id = l.search('dc=stroeder,dc=com',ldap.SCOPE_SUBTREE,'(objectClass=*)')

  for res_type,res_data,res_msgid,res_controls in l.allresults(msg_id):
    for dn,entry in res_data:
      # process dn and entry
      print(dn,entry['objectClass'])