# Treequel 1.0.0

**URL:** <https://www.ruby-forum.com/t/treequel-1-0-0/173742>\
**Category:** Ruby\
**Created:** [August 14, 2009, 2:40am UTC](https://www.ruby-forum.com/t/treequel-1-0-0/173742 "2009-08-14T02:40:19Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![mgreenly](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/m/85f322/32.png) [@mgreenly](https://www.ruby-forum.com/u/mgreenly)\
**Post date:** [August 14, 2009, 2:40am UTC](https://www.ruby-forum.com/t/treequel-1-0-0/173742/1 "2009-08-14T02:40:19Z")

</div>

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/](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:

[dev(E)iate](http://deveiate.org/projects/Treequel/browser/examples)

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

[treequel Manual — Introduction](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](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.