run-tests.sh File Reference

Backport of Drupal 7 run-tests.sh with modifications, see BACKPORT.txt. More...

Go to the source code of this file.

Enumerations
enum	SIMPLETEST_SCRIPT_COLOR_PASS
enum	SIMPLETEST_SCRIPT_COLOR_FAIL
enum	SIMPLETEST_SCRIPT_COLOR_EXCEPTION
Functions
	simpletest_script_help ()
	Print help text.
	simpletest_script_parse_args ()
	Parse execution argument and ensure that all are valid.
	simpletest_script_init ()
	Initialize script variables and perform general setup requirements.
	simpletest_script_execute_batch ()
	Execute a batch of tests.
	simpletest_script_run_one_test ($test_id, $test_class)
	Run a single test (assume a Drupal bootstrapped environment).
	simpletest_script_command ($concurrency, $test_id, $tests)
	Execute a command to run batch of tests in separate process.
	simpletest_script_get_test_list ()
	Get list of tests based on arguments.
	simpletest_script_reporter_init ()
	Initialize the reporter.
	simpletest_script_reporter_display_results ()
	Display test results.
	simpletest_script_format_result ($result)
	Format the result so that it fits within the default 80 character terminal size.
	simpletest_script_print_error ($message)
	Print error message prefixed with " ERROR: " and displayed in fail color if color output is enabled.
	simpletest_script_print ($message, $color_code)
	Print a message to the console, if color is enabled then the specified color code will be used.
	simpletest_script_color_code ($status)
	Get the color code associated with the specified status.
Variables
if(!module_exists('simpletest')) if($args['clean'])	$all_tests = simpletest_get_all_tests()
	$groups = simpletest_categorize_tests($all_tests)
	$test_list = array()
	$test_id = db_last_insert_id('simpletest_test_id', 'test_id')

---

Detailed Description

Backport of Drupal 7 run-tests.sh with modifications, see BACKPORT.txt.

This file must be placed in the Drupal scripts folder in order for it to work properly.

Copyright 2008-2009 by Jimmy Berry ("boombatower", http://drupal.org/user/214218)

Definition in file run-tests.sh.

---

Enumeration Type Documentation

enum SIMPLETEST_SCRIPT_COLOR_EXCEPTION

Definition at line 15 of file run-tests.sh.

enum SIMPLETEST_SCRIPT_COLOR_FAIL

Definition at line 14 of file run-tests.sh.

enum SIMPLETEST_SCRIPT_COLOR_PASS

Definition at line 13 of file run-tests.sh.

---

Function Documentation

simpletest_script_color_code

(

$

status

)

Get the color code associated with the specified status.

Parameters:

$status

The status string to get code for.

Returns:

Color code.

Definition at line 559 of file run-tests.sh.

                                               {
  switch ($status) {
    case 'pass':
      return SIMPLETEST_SCRIPT_COLOR_PASS;
    case 'fail':
      return SIMPLETEST_SCRIPT_COLOR_FAIL;
    case 'exception':
      return SIMPLETEST_SCRIPT_COLOR_EXCEPTION;
  }
  return 0; // Default formatting.
}

simpletest_script_command	(	$	concurrency,
		$	test_id,
		$	tests
	)

Execute a command to run batch of tests in separate process.

Definition at line 362 of file run-tests.sh.

                                                                   {
  global $args, $php;

  $command = "$php ./scripts/{$args['script']} --url {$args['url']}";
  if ($args['color']) {
    $command .= ' --color';
  }
  $command .= " --php " . escapeshellarg($php) . " --concurrency $concurrency --test-id $test_id --execute-batch $tests";
  passthru($command);
}

simpletest_script_execute_batch

(

)

Execute a batch of tests.

Definition at line 283 of file run-tests.sh.

References simpletest_script_command(), simpletest_script_print_error(), and simpletest_script_run_one_test().

                                           {
  global $args;

  if (is_null($args['test-id'])) {
    simpletest_script_print_error("--execute-batch should not be called interactively.");
    exit;
  }
  if ($args['concurrency'] == 1) {
    // Fallback to mono-threaded execution.
    if (count($args['test_names']) > 1) {
      foreach ($args['test_names'] as $test_class) {
        // Execute each test in its separate Drupal environment.
        simpletest_script_command(1, $args['test-id'], $test_class);
      }
      exit;
    }
    else {
      // Execute an individual test.
      $test_class = array_shift($args['test_names']);
      drupal_bootstrap(DRUPAL_BOOTSTRAP_FULL);
      simpletest_script_run_one_test($args['test-id'], $test_class);
      exit;
    }
  }
  else {
    // Multi-threaded execution.
    $children = array();
    while (!empty($args['test_names']) || !empty($children)) {
      // Fork children safely since Drupal is not bootstrapped yet.
      while (count($children) < $args['concurrency']) {
        if (empty($args['test_names'])) break;

        $child = array();
        $child['test_class'] = $test_class = array_shift($args['test_names']);
        $child['pid'] = pcntl_fork();
        if (!$child['pid']) {
          // This is the child process, bootstrap and execute the test.
          drupal_bootstrap(DRUPAL_BOOTSTRAP_FULL);
          simpletest_script_run_one_test($args['test-id'], $test_class);
          exit;
        }
        else {
          // Register our new child.
          $children[] = $child;
        }
      }

      // Wait for children every 200ms.
      usleep(200000);

      // Check if some children finished.
      foreach ($children as $cid => $child) {
        if (pcntl_waitpid($child['pid'], $status, WUNTRACED | WNOHANG)) {
          // This particular child exited.
          unset($children[$cid]);
        }
      }
    }
    exit;
  }
}

simpletest_script_format_result

(

$

result

)

Format the result so that it fits within the default 80 character terminal size.

Parameters:

$result

The result object to format.

Definition at line 512 of file run-tests.sh.

References simpletest_script_color_code(), and simpletest_script_print().

                                                  {
  global $results_map, $color;

  $summary = sprintf("%-10.10s %-10.10s %-30.30s %-5.5s %-20.20s\n",
    $results_map[$result->status], $result->message_group, basename($result->file), $result->line, $result->caller);

  simpletest_script_print($summary, simpletest_script_color_code($result->status));

  $lines = explode("\n", wordwrap(trim(strip_tags($result->message)), 76));
  foreach ($lines as $line) {
    echo "    $line\n";
  }
}

simpletest_script_get_test_list

(

)

Get list of tests based on arguments.

If --all specified then returns all available tests, otherwise reads list of tests.

Will print error and exit if no valid tests were found.

Returns:

List of tests.

Definition at line 381 of file run-tests.sh.

References $all_tests, $groups, $test_list, and simpletest_script_print_error().

                                           {
  global $args, $all_tests, $groups;

  $test_list = array();
  if ($args['all']) {
    $test_list = $all_tests;
  }
  else {
    if ($args['class']) {
      // Check for valid class names.
      foreach ($args['test_names'] as $class_name) {
        if (in_array($class_name, $all_tests)) {
          $test_list[] = $class_name;
        }
      }
    }
    elseif ($args['file']) {
      $files = array();
      foreach ($args['test_names'] as $file) {
        $files[realpath($file)] = 1;
      }

      // Check for valid class names.
      foreach ($all_tests as $class_name => $info) {
        $refclass = new ReflectionClass($class_name);
        $file = $refclass->getFileName();
        if (isset($files[$file])) {
          $test_list[] = $class_name;
        }
      }
    }
    else {
      // Check for valid group names and get all valid classes in group.
      foreach ($args['test_names'] as $group_name) {
        if (isset($groups[$group_name])) {
          foreach($groups[$group_name] as $class_name => $info) {
            $test_list[] = $class_name;
          }
        }
      }
    }
  }

  if (empty($test_list)) {
    simpletest_script_print_error('No valid tests were specified.');
    exit;
  }
  return $test_list;
}

simpletest_script_help

(

)

Print help text.

Definition at line 95 of file run-tests.sh.

                                  {
  global $args;

  echo <<<EOF

Run Drupal tests from the shell.

Usage:        {$args['script']} [OPTIONS] <tests>
Example:      {$args['script']} Profile

All arguments are long options.

  --help      Print this page.

  --list      Display all available test groups.

  --clean     Cleans up database tables or directories from previous, failed,
              tests and then exits (no tests are run).

  --url       Immediately preceeds a URL to set the host and path. You will
              need this parameter if Drupal is in a subdirectory on your
              localhost and you have not set \$base_url in settings.php.

  --php       The absolute path to the PHP executable. Usually not needed.

  --concurrency [num]

              Run tests in parallel, up to [num] tests at a time. This requires
              the Process Control Extension (PCNTL) to be compiled in PHP, not
              supported under Windows.

  --all       Run all available tests.

  --class     Run tests identified by specific class names, instead of group names.

  --file      Run tests identified by specific file names, instead of group names.
              Specify the path and the extension (i.e. 'modules/user/user.test').

  --color     Output the results with color highlighting.

  --verbose   Output detailed assertion messages in addition to summary.

  <test1>[,<test2>[,<test3> ...]]

              One or more tests to be run. By default, these are interpreted
              as the names of test groups as shown at ?q=admin/build/testing.
              These group names typically correspond to module names like "User"
              or "Profile" or "System", but there is also a group "XML-RPC".
              If --class is specified then these are interpreted as the names of
              specific test classes whose test methods will be run. Tests must
              be separated by commas. Ignored if --all is specified.

To run this script you will normally invoke it from the root directory of your
Drupal installation as the webserver user (differs per configuration), or root:

sudo -u [wwwrun|www-data|etc] php ./scripts/{$args['script']}
  --url http://example.com/ --all
sudo -u [wwwrun|www-data|etc] php ./scripts/{$args['script']}
  --url http://example.com/ --class UploadTestCase
\n
EOF;
}

simpletest_script_init

(

)

Initialize script variables and perform general setup requirements.

Definition at line 233 of file run-tests.sh.

References simpletest_script_help(), and simpletest_script_print_error().

                                  {
  global $args, $php;

  $host = 'localhost';
  $path = '';
  // Determine location of php command automatically, unless a command line argument is supplied.
  if (!empty($args['php'])) {
    $php = $args['php'];
  }
  elseif (!empty($_ENV['_'])) {
    // '_' is an environment variable set by the shell. It contains the command that was executed.
    $php = $_ENV['_'];
  }
  elseif (!empty($_ENV['SUDO_COMMAND'])) {
    // 'SUDO_COMMAND' is an environment variable set by the sudo program.
    // Extract only the PHP interpreter, not the rest of the command.
    list($php, ) = explode(' ', $_ENV['SUDO_COMMAND'], 2);
  }
  else {
    simpletest_script_print_error('Unable to automatically determine the path to the PHP interpreter. Please supply the --php command line argument.');
    simpletest_script_help();
    exit();
  }

  // Get url from arguments.
  if (!empty($args['url'])) {
    $parsed_url = parse_url($args['url']);
    $host = $parsed_url['host'] . (isset($parsed_url['port']) ? ':' . $parsed_url['port'] : '');
    $path = $parsed_url['path'];
  }

  $_SERVER['HTTP_HOST'] = $host;
  $_SERVER['REMOTE_ADDR'] = '127.0.0.1';
  $_SERVER['SERVER_ADDR'] = '127.0.0.1';
  $_SERVER['SERVER_SOFTWARE'] = 'Apache';
  $_SERVER['SERVER_NAME'] = 'localhost';
  $_SERVER['REQUEST_URI'] = $path .'/';
  $_SERVER['REQUEST_METHOD'] = 'GET';
  $_SERVER['SCRIPT_NAME'] = $path .'/index.php';
  $_SERVER['PHP_SELF'] = $path .'/index.php';
  $_SERVER['HTTP_USER_AGENT'] = 'Drupal command line';

  chdir(realpath(dirname(__FILE__) . '/..'));
  define('DRUPAL_ROOT', getcwd());
  require_once DRUPAL_ROOT . '/includes/bootstrap.inc';
}

simpletest_script_parse_args

(

)

Parse execution argument and ensure that all are valid.

Returns:

The list of arguments.

Definition at line 163 of file run-tests.sh.

References simpletest_script_print_error().

                                        {
  // Set default values.
  $args = array(
    'script' => '',
    'help' => FALSE,
    'list' => FALSE,
    'clean' => FALSE,
    'url' => '',
    'php' => '',
    'concurrency' => 1,
    'all' => FALSE,
    'class' => FALSE,
    'file' => FALSE,
    'color' => FALSE,
    'verbose' => FALSE,
    'test_names' => array(),
    // Used internally.
    'test-id' => NULL,
    'execute-batch' => FALSE
  );

  // Override with set values.
  $args['script'] = basename(array_shift($_SERVER['argv']));

  $count = 0;
  while ($arg = array_shift($_SERVER['argv'])) {
    if (preg_match('/--(\S+)/', $arg, $matches)) {
      // Argument found.
      if (array_key_exists($matches[1], $args)) {
        // Argument found in list.
        $previous_arg = $matches[1];
        if (is_bool($args[$previous_arg])) {
          $args[$matches[1]] = TRUE;
        }
        else {
          $args[$matches[1]] = array_shift($_SERVER['argv']);
        }
        // Clear extraneous values.
        $args['test_names'] = array();
        $count++;
      }
      else {
        // Argument not found in list.
        simpletest_script_print_error("Unknown argument '$arg'.");
        exit;
      }
    }
    else {
      // Values found without an argument should be test names.
      $args['test_names'] += explode(',', $arg);
      $count++;
    }
  }

  // Validate the concurrency argument
  if (!is_numeric($args['concurrency']) || $args['concurrency'] <= 0) {
    simpletest_script_print_error("--concurrency must be a strictly positive integer.");
    exit;
  }
  elseif ($args['concurrency'] > 1 && !function_exists('pcntl_fork')) {
    simpletest_script_print_error("Parallel test execution requires the Process Control extension to be compiled in PHP. Please see http://php.net/manual/en/intro.pcntl.php for more information.");
    exit;
  }

  return array($args, $count);
}

simpletest_script_print	(	$	message,
		$	color_code
	)

Print a message to the console, if color is enabled then the specified color code will be used.

Parameters:

	$message	The message to print.
	$color_code	The color code to use for coloring.

Definition at line 543 of file run-tests.sh.

                                                        {
  global $args;
  if ($args['color']) {
    echo "\033[" . $color_code . "m" . $message . "\033[0m";
  }
  else {
    echo $message;
  }
}

simpletest_script_print_error

(

$

message

)

Print error message prefixed with " ERROR: " and displayed in fail color if color output is enabled.

Parameters:

$message

The message to print.

Definition at line 532 of file run-tests.sh.

References simpletest_script_print().

                                                 {
  simpletest_script_print("  ERROR: $message\n", SIMPLETEST_SCRIPT_COLOR_FAIL);
}

simpletest_script_reporter_display_results

(

)

Display test results.

Definition at line 467 of file run-tests.sh.

References $test_id, and simpletest_script_format_result().

                                                      {
  global $args, $test_id, $results_map;

  echo "\n";
  $end = timer_stop('run-tests');
  echo "Test run duration: " . format_interval($end['time'] / 1000);
  echo "\n";

  if ($args['verbose']) {
    // Report results.
    echo "Detailed test results:\n";
    echo "----------------------\n";
    echo "\n";

    $results_map = array(
      'pass' => 'Pass',
      'fail' => 'Fail',
      'exception' => 'Exception'
    );

//    $results = db_query("SELECT * FROM {simpletest} WHERE test_id = :test_id ORDER BY test_class, message_id", array(':test_id' => $test_id));
    $results = db_query("SELECT * FROM {simpletest} WHERE test_id = %d ORDER BY test_class, message_id", $test_id);

    $test_class = '';
//    foreach ($results as $result) {
    while ($result = db_fetch_object($results)) {
      if (isset($results_map[$result->status])) {
        if ($result->test_class != $test_class) {
          // Display test class every time results are for new test class.
          echo "\n\n---- $result->test_class ----\n\n\n";
          $test_class = $result->test_class;
        }

        simpletest_script_format_result($result);
      }
    }
  }
}

simpletest_script_reporter_init

(

)

Initialize the reporter.

Definition at line 434 of file run-tests.sh.

References $all_tests, and $test_list.

                                           {
  global $args, $all_tests, $test_list;

  echo "\n";
  echo "Drupal test run\n";
  echo "---------------\n";
  echo "\n";

  // Tell the user about what tests are to be run.
  if ($args['all']) {
    echo "All tests will run.\n\n";
  }
  else {
    echo "Tests to be run:\n";
    foreach ($test_list as $class_name) {
      $info = call_user_func(array($class_name, 'getInfo'));
      echo " - " . $info['name'] . ' (' . $class_name . ')' . "\n";
    }
    echo "\n";
  }

  echo "Test run started: " . format_date($_SERVER['REQUEST_TIME'], 'long') . "\n";
  timer_start('run-tests');
  echo "\n";

  echo "Test summary:\n";
  echo "-------------\n";
  echo "\n";
}

simpletest_script_run_one_test	(	$	test_id,
		$	test_class
	)

Run a single test (assume a Drupal bootstrapped environment).

Definition at line 348 of file run-tests.sh.

References $test_id, _simpletest_format_summary_line(), simpletest_get_all_tests(), simpletest_script_color_code(), and simpletest_script_print().

                                                               {
  simpletest_get_all_tests();
  $test = new $test_class($test_id);
  $test->run();
  $info = $test->getInfo();

  $status = ((isset($test->results['#fail']) && $test->results['#fail'] > 0)
           || (isset($test->results['#exception']) && $test->results['#exception'] > 0) ? 'fail' : 'pass');
  simpletest_script_print($info['name'] . ' ' . _simpletest_format_summary_line($test->results) . "\n", simpletest_script_color_code($status));
}

---

Variable Documentation

if (!module_exists('simpletest')) if ($args['clean']) $all_tests = simpletest_get_all_tests()

Definition at line 52 of file run-tests.sh.

$groups = simpletest_categorize_tests($all_tests)

Definition at line 53 of file run-tests.sh.

$test_id = db_last_insert_id('simpletest_test_id', 'test_id')

Definition at line 81 of file run-tests.sh.

if ($args['list']) $test_list = array()

Definition at line 54 of file run-tests.sh.