Version 1.0.0 of Treequel has been released.
Treequel is an LDAP toolkit for Ruby. It is intended to allow quick, easy
access to LDAP directories in a manner consistent with LDAP's hierarchical,
free-form nature.
It's inspired by and modeled after Sequel (http://sequel.rubyforge.org/), a
kick-ass database library.
== Examples
Here are a few short examples to whet your appetite:
# Connect to the directory at the specified URL
dir = Treequel.directory( 'ldap://ldap.company.com/dc=company,dc=com' )
# Get a list of email addresses of every person in the directory (as
# long as people are under ou=people)
dir.ou( :people ).filter( :mail ).map( :mail ).flatten
# Get a list of all IP addresses for all hosts in any ou=hosts group
# in the whole directory:
dir.filter( :ou => :hosts ).collection.filter( :ipHostNumber ).
map( :ipHostNumber ).flatten
# Get all people in the directory in the form of a hash of names
# keyed by email addresses
dir.ou( :people ).filter( :mail ).to_hash( :mail, :cn )
More elaborate examples of real-world usage can be found in the examples/
directory in the distribution. You can also browse them in a web browser
via the project page:
http://deveiate.org/projects/Treequel/browser/examples
We're also working on a user manual that lives here:
http://deveiate.org/code/Treequel
== Installation
Via gems:
$ sudo gem install treequel
or from source:
$ wget http://deveiate.org/code/treequel-1.0.0.tar.gz
$ tar -xzvf treequel-1.0.0.tar.gz
$ cd treequel-1.0.0
$ sudo rake install
== Contributing
You can check out the current development source with Mercurial:
hg clone http://repo.deveiate.org/Treequel
You can submit bug reports, suggestions, and read more about future plans at
the project page:
http://deveiate.org/projects/Treequel
== Changes
First release.
···
--
Michael Granger <ged@FaerieMUD.org>
Rubymage, Architect, Believer
The FaerieMUD Consortium <http://www.FaerieMUD.org/>