Ruby/ActiveLDAP -- ruby library for object-oriented LDAP interction
Copyright (C) 2004-2006 Will Drewry <will@alum.bu.edu>
Contributors:
 * Dick Davies <rasputnik@hellooperator.net>
 * Nathan Kinder <quicksilver02@mac.com>

DESCRIPTION
'Ruby/ActiveLDAP' is a ruby extension library which provides a clean objected
oriented interface to the Ruby/LDAP[0] library.  It was inspired by
ActivRecord[2]. This is not nearly as clean or as flexible as ActiveRecord, but
it is still trivial to define new objects and manipulate them with minimal
difficulty.

For example and usage - read the rdoc in doc/ from lib/activeldap.rb.
It is also available on the web at:

http://static.dataspill.org/projects/libraries/ruby/activeldap/rdoc/

PREREQUISITES

  * Ruby 1.8.x [1]
  * Ruby/LDAP [0]
  * Log4r [5]
  * (Optional) Ruby/LDAP+GSSAPI [3]
  * An LDAP server compatible with Ruby/LDAP: OpenLDAP, etc
  * Examples also require: Ruby/Password [4]


NOTES

  * Only GSSAPI SASL support exists due to Ruby/LDAP limitations
  * The API is subject to change as this package slowly approaches 1.0.0


INSTALL

  - Edit activeldap/configuration.rb with your LDAP preferences
  - Run -
    ruby setup.rb config
    ruby setup.rb setup
    (root) ruby setup.rb install


LICENCE

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.

Please see the file LICENSE for the terms of the licence.


REFERENCES

[0] - http://ruby-ldap.sourceforge.net
[1] - http://www.ruby-lang.org
[2] - http://activerecord.rubyonrails.org
[3] - http://caliban.org/files/redhat/RPMS/i386/ruby-ldap-0.8.2-4.i386.rpm
[4] - http://www.caliban.org/ruby/
[5] - http://log4r.sourceforge.net/



