pudl is an Active Directory client library and CLI
pudl is a python package (with an included CLI) that wraps python-ldap and provides a somewhat-oo interface to Active Directory user, group and computer objects, retreived via LDAP with TLS. While not necessarily a replacement for existing client libraries and the ldapsearch binary, the api and bundled cli are perhaps simpler to work with than alternatives, for many common queries.
For the full API reference and CLI usage with examples, please see the [full project documentation](http://pudl.readthedocs.org/en/latest/).
To get up and running, the following must be installed:
### The Easy Way `bash pip install pudl `
### Manual Installation + Create a virtual environment and activate + Clone this git repository + pip install .
Optionally for sphinx document generation, pip install the following
Optionally, it may be desirable to set a few envrionment variables, e.g.:
Retrieve JSON representations of two users
`bash pudl user bhodges jdupont ` Retrieve three groups, serialized to yaml
`bash pudl group HR Finance Technology --output-format=yaml `
Apache License, version 2.0. Please see LICENSE