389-test framework
==================

389-test is a Ruby framework for testing 389 Directory Server. 

Features
--------

* Domain specific language for testsuite and testcase definition
* Parametrized testcases
* Parallel execution of testsuites
* Export of results into XML (multiple formats)
* .. and more (see DESIGN document)

Requirements
------------

* Run as root or user with sudo rights.

Running
-------

    bin/engage.sh

will run the tests. Type
    
    bin/engage.sh -h

to see available options.

Known issues
------------
Parallel execution of multiple testsuites does not work on Jenkins. See
https://wiki.jenkins-ci.org/display/JENKINS/Spawning+processes+from+build

Contributing
------------

The framework is under development right now. There are several ways how 
to contribute:
* open issues on GitHub for bugs or enhancements
* write new testsuites
* write wrapper functions for working with DS

Contributors
------------

* Jan Rusnacko <rusnackoj@gmail.com>
* Milan Kubik <admin@kubikmilan.sk>