ldapy is aimed to be command line LDAP explorer implemented in Python, with all the joys of GNU readline: history, completion and editing. Heavily inspired by shelldap.

Installation should be as easy as:

make install

This will try to execute python setup.py install --user to install it for the current user.

If there's missing dependencies (see the requirements.txt file), these can easily be resolved by using pip, conveniently wrapped as a make-target:

make requirements

The primary requirements are python-ldap and readline.

Usage information can be found by executing

ldapy --help

But for the impatient, here's an example:

ldapy --host=localhost --bind-dn cn=Admin,dc=nodomain --password=foobar

After a successful connection you'll see a prompt $, where you can use the familiar shell commands: ls, cd, pwd, cat. To modify the data the commands: modify, add and delete are available. All of these commands can be asked to be helpful: ls --help.

To make it easier to connect you can use previous connections:

ldapy                # will use the most recent connection
ldapy --previous     # lists the previous connections
ldapy --previous 2   # connect with the third most recent connection (zero-indexing)

You can also save your favorite connections:

ldapy --save 1 foo   # stores the second most recent connection as "foo"
ldapy --saved        # lists all saved connections
ldapy --saved foo    # connect using the save connection "foo"
ldapy --remove foo   # remove the saved connection "foo"

• Allow combinations of stored connections and specified connection data
• Rename and move DNs
• Wildcards
• Compatibility with Python3