org.apache.regexp

Class RETest

public class RETest extends Object

Data driven (and optionally interactive) testing harness to exercise regular expression compiler and matching engine.

Version: $Id: RETest.java 518156 2007-03-14 14:31:26Z vgritsenko $

Author: Jonathan Locke Jon S. Stevens Michael McCallum

Field Summary
REDebugCompiler	compiler
int	failures
static String	NEW_LINE
static boolean	showSuccesses
int	testCount

Constructor Summary
	RETest() Constructor

Method Summary
void	assertEquals(String message, String expected, String actual)
void	assertEquals(String message, int expected, int actual)
void	die(String s) Exit with a fatal error.
void	fail(StringBuffer log, String s) Fail with an error.
void	fail(String s) Fail with an error.
String	findNextTest(BufferedReader br) Finds next test description in a given script.
boolean	getExpectedResult(String yesno) Converts yesno string to boolean.
RETestCase	getNextTestCase(BufferedReader br) Creates testcase for the next test description in the script file.
static void	main(String[] args) Main program entrypoint.
void	runAutomatedTests(String testDocument) Run automated tests in RETest.txt file (from Perl 4.0 test battery)
void	runInteractiveTests(String expr) Compile and test matching against a single expression
void	say(String s) Say something to standard out
void	showParens(RE r) Dump parenthesized subexpressions found by a regular expression matcher object
static boolean	test(String[] args) Testing entrypoint.
void	testOther() Run automated unit test
void	testPrecompiledRE()
void	testSplitAndGrep()
void	testSubst()

Field Detail

compiler

final REDebugCompiler compiler

failures

int failures

NEW_LINE

static final String NEW_LINE

showSuccesses

static final boolean showSuccesses

testCount

int testCount

Constructor Detail

RETest

public RETest()

Constructor

Method Detail

assertEquals

public void assertEquals(String message, String expected, String actual)

assertEquals

public void assertEquals(String message, int expected, int actual)

die

void die(String s)

Exit with a fatal error.

Parameters: s Last famous words before exiting

fail

void fail(StringBuffer log, String s)

Fail with an error. Will print a big failure message to System.out.

Parameters: log Output before failure s Failure description

fail

void fail(String s)

Fail with an error. Will print a big failure message to System.out.

Parameters: s Failure description

findNextTest

private String findNextTest(BufferedReader br)

Finds next test description in a given script.

Parameters: br BufferedReader for a script file

Returns: strign tag for next test description

Throws: IOException if some io problems occured

getExpectedResult

private boolean getExpectedResult(String yesno)

Converts yesno string to boolean.

Parameters: yesno string representation of expected result

Returns: true if yesno is "YES", false if yesno is "NO" stops program otherwise.

getNextTestCase

private RETestCase getNextTestCase(BufferedReader br)

Creates testcase for the next test description in the script file.

Parameters: br BufferedReader for script file.

Returns: a new tescase or null.

Throws: IOException if some io problems occured

main

public static void main(String[] args)

Main program entrypoint. If an argument is given, it will be compiled and interactive matching will ensue. If no argument is given, the file RETest.txt will be used as automated testing input.

Parameters: args Command line arguments (optional regular expression)