ldif3 3.0.2

generate and parse LDIF data (see RFC 2849).

ldif3 - generate and parse LDIF data (see RFC 2849).

This is a fork of the ldif module from python-ldap with python3/unicode support. See the first entry in CHANGES.rst for a more complete list of differences.

Usage

Parse LDIF from a file (or BytesIO):

from ldif3 import LDIFParser
from pprint import pprint

parser = LDIFParser(open('data.ldif', 'rb'))
for dn, changetype, record in parser.parse():
    if dn is not None:
        print('got entry record: %s' % dn)
    else:
        print('got change record: %s' % changetype)
    pprint(record)

Write LDIF to a file (or BytesIO):

from ldif3 import LDIFWriter

writer = LDIFWriter(open('data.ldif', 'wb'))
writer.unparse('mail=[e-mail]', {
    'cn': ['Alice Alison'],
    'mail': ['[e-mail]'],
    'objectclass': ['top', 'person'],
})

Unicode support

The stream object that is passed to parser or writer must be a byte stream. It must use UTF-8 encoding as described in the spec.

The parsed objects (dn, changetype and the keys and values of record) on the other hand are unicode strings.