Source

Treequel /

Filename Size Date modified Message
bin
docs
examples
experiments
lib
misc
rake [22355069692a]
spec
172 B
980 B
46 B
46 B
282 B
2.9 KB
1.5 KB
1.9 KB
10.5 KB
1.5 KB
1.2 KB

Treequel - an honest LDAP library

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, 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.

Contributing

You can check out the current development source with Mercurial, or if you prefer Git, via the project's Github mirror.

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

License

See the included LICENSE file for licensing details.

Authors

  • Michael Granger
  • Mahlon E. Smith

Contributors

A special thanks to Ben Bleything, who was part of the initial brainstorm that led to the creation of this library.