Running the test suite

To run the Links test suite execute:

./run_tests

This will run all the tests defined in *.tests files inside tests directory, as well as all database tests defined inside tests/database directory. If you only want to run some of the tests you can do this by executing

./test-harness tests/foo.tests

where foo.tests is the name of the file with tests you want to run. If you want to skip tests requiring database access run

./run_tests no-db

If you want to run only those tests that require database access run

./run_tests db-only

To run the tests requiring database access you need to setup PostgreSQL database. Refer to Database setup for instructions how to compile Links with PostgreSQL support. You also need to create links database and have permissions to access it.

To run shredding tests, run

./run-tests db-only shredding

To configure tests to run using an alternate database configuration (user+password/host), edit the config files in tests/{database,shredding}/config. These are created from the respective sample files if they do not exists, but will not be overwritten if they are already there.