Treequel 1.0.0

Version 1.0.0 of Treequel has been released.

Treequel is an LDAP toolkit for Ruby. It is intended to allow quick,
access to LDAP directories in a manner consistent with LDAP’s
free-form nature.

It’s inspired by and modeled after Sequel (http://, 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 = ‘ldap://
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
directory in the distribution. You can also browse them in a web browser
via the project page:


We’re also working on a user manual that lives here:

treequel Manual — Introduction

== Installation

Via gems:

$ sudo gem install treequel

or from source:

$ wget
$ 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

You can submit bug reports, suggestions, and read more about future
plans at
the project page:

== Changes

First release.