\( \newcommand{\E}{\mathrm{E}} \) \( \newcommand{\A}{\mathrm{A}} \) \( \newcommand{\R}{\mathrm{R}} \) \( \newcommand{\N}{\mathrm{N}} \) \( \newcommand{\Q}{\mathrm{Q}} \) \( \newcommand{\Z}{\mathrm{Z}} \) \( \def\ccSum #1#2#3{ \sum_{#1}^{#2}{#3} } \def\ccProd #1#2#3{ \sum_{#1}^{#2}{#3} }\)

CGAL 4.8 - Manual

All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Groups Pages
Running a Testsuite Locally

Authors
  CGAL developers

# Running the Testsuite Locally of a Single Package

Before submitting a change for integration into CGAL it is good style to run the testsuite of the modified package and all packages that could be impacted. Here is what you need:

- A shell such as bash (install Cygwin, when you are on Windows)
- optional: put `Scripts/scripts` and `Scripts/developer_scripts` on your `PATH` environment variable or Alternatively, you can call the scripts mentioned below using their full path or a relative path
- define the environment variable `CGAL_DIR`. It should be the directory where you built CGAL.
- optional: define the environment variables for Boost, GMP, and any optional third party lib, e.g. Eigen.
- On Windows: define the environment variable `MAKE_CMD` (put the line `export MAKE_CMD=nmake` in your `$HOME/.bashrc` for VC++)
- On Windows: define the environment variable `CMAKE_GENERATOR` (put the line `export CMAKE_GENERATOR='-GNMake Makefiles'`in your`$HOME/.bashrc` for VC++)
- go in the directory you want to test
- Run `cgal_test_with_cmake` in the `test` and `examples` directories of the package. This should run CMake, compile and run, and you can see what happened in the generated file `error.txt`.

# Running the Whole Testsuite

We describe here how to proceed to the testing of a full copy of `master` or any branch by creating a flat release (that is having a layout similar to a release rather than a branch layout with header files gathered by packages).

The creation of the flat release is done using the script `create_internal_release` located in the directory `Scripts/developer_scripts`. Running the script with no argument will give the complete usage of this script. We only describe one way of using it.

The prerequisite is to have a checkout of the branch we want to test. In the example, it will be located in `~/Git/cgal/`.

First one goes into a directory where the flat release will be created:

> cd /tmp

Then the script `create_internal_release` is ran:

> create_internal_release -r CGAL-I-FOO -a ~/Git/cgal/

The directory `CGAL-I-FOO` now contains the flat release of the branch in `~/Git/cgal`. Then you need to compile this flat release and set `CGAL_DIR` accordingly as explained in the installation manual.

To run the test-suite simply do:

> cd CGAL-I-FOO/test
> ./run_testsuite_with_cmake

and wait for the results to be written in the file `error.txt`.