selftest: Add some more documentation. Rename env => target to avoid confusion.
authorJelmer Vernooij <jelmer@samba.org>
Wed, 16 Jan 2008 16:40:25 +0000 (17:40 +0100)
committerJelmer Vernooij <jelmer@samba.org>
Wed, 16 Jan 2008 16:58:50 +0000 (17:58 +0100)
source/selftest/README
source/selftest/selftest.pl
source/selftest/target/Samba3.pm [moved from source/selftest/env/Samba3.pm with 100% similarity]
source/selftest/target/Samba4.pm [moved from source/selftest/env/Samba4.pm with 100% similarity]
source/selftest/target/Windows.pm [moved from source/selftest/env/Windows.pm with 100% similarity]

index a0afda3d1966744d8aeee48bedcf9334a23750c6..3250f32ec7891073a48e5e5b7f60f5f476fe7aa9 100644 (file)
@@ -1,6 +1,23 @@
+# vim: ft=rst
+
 This directory contains test scripts that are useful for running a
 bunch of tests all at once. 
 
 This directory contains test scripts that are useful for running a
 bunch of tests all at once. 
 
+===============
+Available tests
+===============
+The available tests are obtained from a script, usually 
+selftest/samba{3,4}_tests.sh. This script should for each test output 
+the name of the test, the command to run and the environment that should be 
+provided.
+
+============
+Environments
+============
+Tests often need to run against a server with particular things set up, 
+a "environment". This environment is provided by the test "target": Samba 3, 
+Samba 4 or Windows.
+
 The following environments are currently available:
 
  - none: No server set up, no variables set.
 The following environments are currently available:
 
  - none: No server set up, no variables set.
index 96409558b186daf5c5203d1d4514688bcc7e4a8b..46c3846b544167a7fb7d6b5e70789089c00b1903 100755 (executable)
@@ -67,7 +67,7 @@ these tests will be counted as successes, successes will be counted as failures.
 
 The format for the file is, one entry per line:
 
 
 The format for the file is, one entry per line:
 
-TESTSUITE-NAME/TEST-NAME
+TESTSUITE-NAME.TEST-NAME
 
 The reason for a test can also be specified, by adding a hash sign (#) and the reason 
 after the test name.
 
 The reason for a test can also be specified, by adding a hash sign (#) and the reason 
 after the test name.
@@ -130,9 +130,6 @@ use POSIX;
 use Cwd qw(abs_path);
 use lib "$RealBin";
 use Subunit qw(parse_results);
 use Cwd qw(abs_path);
 use lib "$RealBin";
 use Subunit qw(parse_results);
-use env::Samba3;
-use env::Samba4;
-use env::Windows;
 use SocketWrapper;
 
 my $opt_help = 0;
 use SocketWrapper;
 
 my $opt_help = 0;
@@ -429,17 +426,20 @@ my $testenv_default = "none";
 
 if ($opt_target eq "samba4") {
        $testenv_default = "member";
 
 if ($opt_target eq "samba4") {
        $testenv_default = "member";
+       use target::Samba4;
        $target = new Samba4($opt_bindir or "$srcdir/bin", $ldap, "$srcdir/setup");
 } elsif ($opt_target eq "samba3") {
        if ($opt_socket_wrapper and `$opt_bindir/smbd -b | grep SOCKET_WRAPPER` eq "") {
                die("You must include --enable-socket-wrapper when compiling Samba in order to execute 'make test'.  Exiting....");
        }
        $testenv_default = "dc";
        $target = new Samba4($opt_bindir or "$srcdir/bin", $ldap, "$srcdir/setup");
 } elsif ($opt_target eq "samba3") {
        if ($opt_socket_wrapper and `$opt_bindir/smbd -b | grep SOCKET_WRAPPER` eq "") {
                die("You must include --enable-socket-wrapper when compiling Samba in order to execute 'make test'.  Exiting....");
        }
        $testenv_default = "dc";
+       use target::Samba3;
        $target = new Samba3($opt_bindir);
 } elsif ($opt_target eq "win") {
        die("Windows tests will not run with socket wrapper enabled.") 
                if ($opt_socket_wrapper);
        $testenv_default = "dc";
        $target = new Samba3($opt_bindir);
 } elsif ($opt_target eq "win") {
        die("Windows tests will not run with socket wrapper enabled.") 
                if ($opt_socket_wrapper);
        $testenv_default = "dc";
+       use target::Windows;
        $target = new Windows();
 }
 
        $target = new Windows();
 }
 
@@ -741,7 +741,6 @@ sub teardown_env($)
        delete $running_envs{$envname};
 }
 
        delete $running_envs{$envname};
 }
 
-
 if ($opt_no_lazy_setup) {
        setup_env($_) foreach (keys %required_envs);
 }
 if ($opt_no_lazy_setup) {
        setup_env($_) foreach (keys %required_envs);
 }