mirror of
https://git.savannah.gnu.org/git/emacs.git
synced 2024-12-17 10:06:13 +00:00
5bdc344780
Before:
make -C test SELECTOR='\"foo\"'
make -C test SELECTOR='(quote (tag :some-tag))'
After:
make -C test SELECTOR='"foo"'
make -C test SELECTOR='(tag :some-tag)'
* test/Makefile.in: Use single quotes around the command line call to
ert, this means the user doesn't have to backslash escape double
quotes when writing lisp strings for the selector. Also wrap the
SELECTOR value in (quote ...) so the user won't have to type it
in (and not get tempted to use the '... reader syntax form which would
now fail to work due to using single quotes around the whole shell
arg).
* test/README: Update instructions accordingly.
80 lines
3.1 KiB
Plaintext
80 lines
3.1 KiB
Plaintext
Copyright (C) 2008-2018 Free Software Foundation, Inc.
|
||
See the end of the file for license conditions.
|
||
|
||
This directory contains files intended to test various aspects of
|
||
Emacs's functionality. Please help add tests!
|
||
|
||
See the file file-organization.org for the details of the directory
|
||
structure and file-naming conventions.
|
||
|
||
Emacs uses ERT, Emacs Lisp Regression Testing, for testing. See (info
|
||
"(ert)") or https://www.gnu.org/software/emacs/manual/html_node/ert/
|
||
for more information on writing and running tests.
|
||
|
||
The Makefile in this directory supports the following targets:
|
||
|
||
* make check
|
||
Run all tests as defined in the directory. Expensive tests are
|
||
suppressed. The result of the tests for <filename>.el is stored in
|
||
<filename>.log.
|
||
|
||
* make check-maybe
|
||
Like "make check", but run only the tests for files which have
|
||
unresolved prerequisites.
|
||
|
||
* make check-expensive
|
||
Like "make check", but run also the tests marked as expensive.
|
||
|
||
* make <filename> or make <filename>.log
|
||
Run all tests declared in <filename>.el. This includes expensive
|
||
tests. In the former case the output is shown on the terminal, in
|
||
the latter case the output is written to <filename>.log.
|
||
|
||
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
|
||
|
||
You could use predefined selectors of the Makefile. "make <filename>
|
||
SELECTOR='$(SELECTOR_DEFAULT)'" runs all tests for <filename>.el
|
||
except the tests tagged as expensive.
|
||
|
||
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 (note that the "$" needs to be doubled to
|
||
protect against "make" variable expansion):
|
||
|
||
make <filename> SELECTOR='"foo$$"'
|
||
|
||
Note that although the test files are always compiled (unless they set
|
||
no-byte-compile), the source files will be run by default, to give
|
||
nicer backtraces. To run the compiled version of a test use
|
||
|
||
make TEST_LOAD_EL=no ...
|
||
|
||
The tests are run in batch mode by default; sometimes it's useful to
|
||
get precisely the same environment but run in interactive mode for
|
||
debugging. To do that, use
|
||
|
||
make TEST_INTERACTIVE=yes ...
|
||
|
||
|
||
(Also, see etc/compilation.txt for compilation mode font lock tests.)
|
||
|
||
|
||
This file is part of GNU Emacs.
|
||
|
||
GNU Emacs is free software: you can redistribute it and/or modify
|
||
it under the terms of the GNU General Public License as published by
|
||
the Free Software Foundation, either version 3 of the License, or
|
||
(at your option) any later version.
|
||
|
||
GNU Emacs is distributed in the hope that it will be useful,
|
||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
GNU General Public License for more details.
|
||
|
||
You should have received a copy of the GNU General Public License
|
||
along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>.
|