Test::OpenLDAP - Creates a temporary instance of OpenLDAP's slapd daemon to run tests against.

Version 0.72

my $slapd = Test::OpenLDAP->new(); # Test::OpenLDAP->new( suffix => 'dc=foobar,dc=com', 'debug' => '-1' );

my $ldap = Net::LDAP->new($slapd->uri()) or Carp::croak("Failed to connect:$@");

my $mesg = $ldap->bind($slapd->admin_user(), password => $slapd->admin_password());

... add / modify / search entries

$slapd->stop();

$slapd->start();

$slapd->DESTROY();

This module allows easy creation and tear down of a OpenLDAP slapd instance. When the variable goes out of scope, the slapd instance is torn down and the file system objects it relies on are removed.

This method initialises and starts an OpenLDAP slapd instance, listening on a unix socket. It then creates an admin user and password and returns the slapd instance to the user. The method accepts a hash of configuration options. The following keys are currently accepted;

• suffix - specifies the suffix that subsequent LDAP queries will be procesed under (e.g. 'dc=example,dc=org')
• debug - the debug level of the slapd instance. To see valid values for debug, execute the command "slapd -d '?'". slapd will list all the valid debug levels. It defaults to '0' or no logging.
• syslog - the debug level of the slapd instance for syslog. This parameter accepts the same values as the debug level. It defaults to '0' or no logging to syslog

This method allows the user to skip tests requiring Test::OpenLDAP by checking to see if the slapd binary exists AND that the OS uses fork for process control.

This methods starts the slapd process

This method stops the slapd process

This method gives the uri for the test code to connect to via a Net::LDAP->new() call.

This method gives the dn used as the suffix for the slapd database.

This method gives the admin user name for the slapd database.

This method gives the admin password for the slapd database.

This method gives the debug level that the slapd instance is reporting.

This method gives a handle to the slapd debug log.

This method sets the value for the "-c" argument to slapd. This can be used to force a reload for a replication consumer.

This method gets the value for the "-c" argument to slapd.

This method clears the value for the "-c" argument to slapd. This can be used to reset the cookie in between stopping and starting slapd

This method creates and returns a new database directory (for subsequent use with the olcDbDirectory attribute)

• slapd already started

  Each instance of Test::OpenLDAP may only start one instance of slapd at a time.

Test::OpenLDAP requires no configuration files or environment variables.

Test::OpenLDAP requires the following non-core Perl modules

• Data::UUID
• File::Temp
• URI::Escape
• Net::LDAP

None reported

David Dick, <ddick at cpan.org>

Please report any bugs or feature requests to bug-test-openldap at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Test-OpenLDAP. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

You can find documentation for this module with the perldoc command.

perldoc Test::OpenLDAP

You can also look for information at:

• RT: CPAN's request tracker (report bugs here)

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=Test-OpenLDAP

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/Test-OpenLDAP

• CPAN Ratings

  http://cpanratings.perl.org/d/Test-OpenLDAP

• Search CPAN

  http://search.cpan.org/dist/Test-OpenLDAP/

Copyright 2017 David Dick.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.