This directory contains files for running Tramp related tests.

tramp-tests.el This file is a test suite. Interactively, you can run the test suite by “M-x tramp-test-all”. The environment variable $REMOTE_TEMPORARY_FILE_DIRECTORY can be set in order to run the tests on another remote host, see `tramp-test-temporary-file-directory’ for the default value.

The Makefile in this directory supports the following targets:

• make all -or- make check Run all tests declared in tramp-tests.el. If $REMOTE_TEMPORARY_FILE_DIRECTORY is set, only tramp-tests.el is used.

• make Run all tests declared in .el. is tramp-tests.

ERT offers selectors, which make it possible to filter out which test cases shall run. The make variable $(SELECTOR) gives you a simple mean to use your own selectors. The ERT manual describes how selectors are constructed, see (info “(ert)Test Selectors”) or https://www.gnu.org/software/emacs/manual/html_node/ert/Test-Selectors.html.

If your test file contains the tests “test-foo”, “test2-foo” and “test-foo-remote”, and you want to run only the former two tests, you could use a selector regexp.

make <filename> SELECTOR='"foo$$"'

If you want to run just the non-expensive tests, you might apply

make check SELECTOR='(not (tag :expensive-test))'

The tag `:unstable’ marks tests which do not run as expected, and are still under test by the developers. In order to exclude those tests from run, you might call

make check SELECTOR='(not (tag :unstable))'

The environment variable ${TRAMP_TEST_ARGS} allows to add further arguments to the Emacs test run.

make check TRAMP_TEST_ARGS="--eval 'some lisp code'"