diff options
| author | Michael Albinus <michael.albinus@gmx.de> | 2013-10-24 09:40:05 +0200 |
|---|---|---|
| committer | Michael Albinus <michael.albinus@gmx.de> | 2013-10-24 09:40:05 +0200 |
| commit | 955ada112b25068c6756b9fa904c6701da9911b0 (patch) | |
| tree | a95680413a23b0a095bb403a485d6861f569400e /doc/misc/ert.texi | |
| parent | 4ddbf128362dcb0a0a8abe42348ff20d3d511ab6 (diff) | |
| download | emacs-955ada112b25068c6756b9fa904c6701da9911b0.tar.gz emacs-955ada112b25068c6756b9fa904c6701da9911b0.tar.bz2 emacs-955ada112b25068c6756b9fa904c6701da9911b0.zip | |
* ert.texi (Running Tests Interactively): Adapt examle output.
(Tests and Their Environment): Mention skip-unless.
Diffstat (limited to 'doc/misc/ert.texi')
| -rw-r--r-- | doc/misc/ert.texi | 20 |
1 files changed, 17 insertions, 3 deletions
diff --git a/doc/misc/ert.texi b/doc/misc/ert.texi index 8728d53ea27..ac87b98eae9 100644 --- a/doc/misc/ert.texi +++ b/doc/misc/ert.texi @@ -183,9 +183,10 @@ tests run. It looks like this: @example Selector: t -Passed: 31 -Failed: 2 (2 unexpected) -Total: 33/33 +Passed: 31 +Skipped: 0 +Failed: 2 (2 unexpected) +Total: 33/33 Started at: 2008-09-11 08:39:25-0700 Finished. @@ -454,6 +455,19 @@ versions, specific architectures, etc.: @node Tests and Their Environment @section Tests and Their Environment +Sometimes, it doesn't make sense to run a test due to missing +preconditions. A required Emacs feature might not be compiled in, the +function to be tested could call an external binary which might not be +available on the test machine, you name it. In this case, the macro +@code{skip-unless} could be used to skip the test: + +@lisp +(ert-deftest test-dbus () + "A test that checks D-BUS functionality." + (skip-unless (featurep 'dbusbind)) + ...) +@end lisp + The outcome of running a test should not depend on the current state of the environment, and each test should leave its environment in the same state it found it in. In particular, a test should not depend on |