Running

The simplest way to run VHDLTest is:

> python -m VHDLTest --config <your-config.yaml>

Command Line Arguments

> python -m VHDLTest [options]

Options

-c --config your-config.yaml

Specify the YAML configuration file.

-l --log your-log-file

Specify a log file to create.

-j --junit your-junit.xml

Specify a JUnit report file to create.

-t --tests test1 test2 test3

Specify the test-benches to run (overrides configuration file).

-s --simulator simulator_name
Specify the simulator to use. Options are:
  • ActiveHDL
  • GHDL
-v --verbose

Produce verbose output from simulator.

--exit-0

Exit with code 0 even if tests fail. A non-zero error code will still be generated for compile or simulation errors.

--version

Print the version information.

Environment Variables

VHDLTest will look for simulators in the path environment variable. It also supports explicitly setting the simulator paths using environment variables:

  • VHDLTEST_ACTIVEHDL_PATH=<path-to-bin>
  • VHDLTEST_GHDL_PATH=<path-to-bin>