From: Michael Albinus Date: Thu, 24 Oct 2013 07:40:05 +0000 (+0200) Subject: * ert.texi (Running Tests Interactively): Adapt examle output. X-Git-Tag: emacs-24.3.90~173^2^2~42^2~45^2~387^2~1155 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=955ada112b25068c6756b9fa904c6701da9911b0;p=emacs.git * ert.texi (Running Tests Interactively): Adapt examle output. (Tests and Their Environment): Mention skip-unless. --- diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog index ad045fc6d5f..1396fc12f43 100644 --- a/doc/misc/ChangeLog +++ b/doc/misc/ChangeLog @@ -1,3 +1,8 @@ +2013-10-24 Michael Albinus + + * ert.texi (Running Tests Interactively): Adapt examle output. + (Tests and Their Environment): Mention skip-unless. + 2013-10-23 Glenn Morris * dired-x.texi, ebrowse.texi, ede.texi, eieio.texi, eshell.texi: 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