From 99c062c028c7f4e94fb38cde50772cfd3ea5ad3b Mon Sep 17 00:00:00 2001 From: Derick Huth Date: Thu, 24 Sep 2015 11:34:04 -0600 Subject: v0.2.1 --- test-chill/README.md | 149 --------------------------------------------------- 1 file changed, 149 deletions(-) delete mode 100644 test-chill/README.md (limited to 'test-chill/README.md') diff --git a/test-chill/README.md b/test-chill/README.md deleted file mode 100644 index e35ff68..0000000 --- a/test-chill/README.md +++ /dev/null @@ -1,149 +0,0 @@ -# testchill - -## Description -TODO: better description -testchill is a Python module that runs a series of tests to aid in the development and maintence of CHiLL. -testchill tests that chill compiles successfully, that scripts can be run without error, and that they generate compilable code. -It can also optionally test optimized code for correctness and provide code coverage. - - -## Running testchill - -testchill is a Python module, and can be run like any other Python module: -`python -m testchill * *` - -The most basic subcommand that runs the testsuite is [`local`](#-local-chill-home-). `local` runs a set of tests -on the parent chill source directory. - -`python -m testchill [-O ] local [-C ]` If the environment variable $OMEGAHOME is set, the `-O` argument can be ommited. - -### Arguments common to all sub commands (with the exception of `local`): -- `-w , --working-dir ` - - Sets the working directory where testchill will compile and run test scripts. If not set, the current working directory will be used. - -- `-R , --rose-home ` - - Set ROSEHOME environment variable for building omega. If not set, the current ROSEHOME environment variable will be used. - -- `-C , --chill-home ` - - Set the path to chill. If not set, the current CHILLHOME environment variable will be used. - -- `-O , --omega-home ` - - Set the path to omega. If not set, the current OMEGAHOME environment variable will be used. - -- `-b , --binary-dir ` - - Set the directory were all chill binary files will be placed after being compiled. The chill directory will be used by default. - -### Subcommands for running individual tests: --

`build-chill-testcase ...` - - Build chill. It will fail if the build process returns non zero. - Optional arguments: - - `-v {release | dev}` or `--chill-branch {release | dev}` - - `release` will build the old release version, and `dev` will build the current development version. - `dev` is used by default. - - - `-u | -c` or `--target-cuda | --target-c` - - `-c` will build chill, and `-u` will build cuda-chill. - `-c` is used by default. - - - `-i {script | lua | python}` or `--interface-lang {script | lua | python}` - - Set the interface language chill will be build for. - `script` will build chill with the original chill script language. - `lua` will build chill with lua as the interface language. - `python` will build chill with python as the interface language. - By default, `script` is used for chill and `lua` is used for cuda-chill. - - - `--build-coverage | --no-build-coverage` - - `--build-coverage` will build chill to work with gcov. - `--no-build-coverage` will build chill normally. - It is on by default. - --

`chill-testcase ...` - - Run a chill test script. - Arguments: - - `chill-script` - - Path to the script file. - - - `chill-src` - - Path to the source file. - - Optional arguments: - - `-v {release | dev}` or `--chill-branch {release | dev}` - - `release` will run scripts as the old release version, and `dev` will run them as the current development version. - `dev` is used by default. - - - `-u | -c` or `--target-cuda | --target-c` - - `-c` will run chill, and `-u` will run cuda-chill. - `-c` is used by default. - - - `-i {script | lua | python}` or `--interface-lang {script | lua | python}` - - Set the interface language chill will be run with. - `script` will run chill with the original chill script language. - `lua` will run chill with lua as the interface language. - `python` will run chill with python as the interface language. - By default, `script` is used for chill and `lua` is used for cuda-chill. - - - `--compile-src | --no-compile-src` - - Turns source compilation test on or off. If on, the source file will be compiled prior to transormation. - On by default. - - - `--run-script | --no-run-script` - - If on, the script file will be run. - On by default. - - - `--compile-gensrc | --no-compile-gensrc` - - If on, the generated source file will be compiled. - On by default. - - - `--check-run-script | --no-check-run-script` - - If on, the generated object file will be run. If there are any validation tests, each one will be compiled and run. - On by default. - - - `--test-coverage | --no-test-coverage` - - If on, coverage data will be compiled during the run-script test. - On by default. - --

`batch ` - - Run a test case list (*.tclist) file. Each line constists of a subcommand to be passed to testchill (including additional `batch` commands). - Arguments: - - `` - - Path to a test case list file. - --

`local ...` - - Compile and test a local chill source directory. - Arguments: - - `` - - Path to chill. - - Optional arguments: - - `-v {release | dev}` or `--chill-branch {release | dev}` - - `release` will run scripts as the old release version, and `dev` will run them as the current development version. - `dev` is used by default. - - - -- cgit v1.2.3-70-g09d2