mirrors/org-mode
0
0
Fork 1
mirror of https://git.savannah.gnu.org/git/emacs/org-mode.git synced 2024-09-22 06:10:43 +00:00
Code Releases Activity
org-mode/testing/README.org
Eric Schulte e1d0311dd4 greatly simplified the testing README
2012-01-28 15:38:03 -07:00

1.7 KiB
Raw Blame History

Org-mode Testing

dependencies

The only dependency is ERT the Emacs testing library which ships with Emacs24. If you are running an older version of Emacs and don't already have ERT installed it can be installed from its old git repository.

non-interactive batch testing from the command line

The simplest way to run the Org-mode test suite is from the command line with the following invocation. Note that the paths below are relative to the base of the Org-mode directory.

  emacs -Q --batch -l lisp/org.el -l testing/org-test.el \
      --eval "(progn (org-reload) (setq org-confirm-babel-evaluate nil))" \
      -f org-test-run-batch-tests

The options in the above command are explained below.

-Q ignores any personal configuration ensuring a vanilla Emacs instance is used
–batch runs Emacs in "batch" mode with no gui and termination after execution
-l loads Org-mode and the org mode test suite defined in testing/org-test.el
–eval reloads Org-mode and allows evaluation of code blocks by the tests
-f actually runs the tests using the `org-test-run-batch-tests' function

interactive testing from within Emacs

To run the Org-mode test suite from a current Emacs instance simply load and run the test suite with the following commands.

  1. First load the test suite.

      (add-to-list 'load-path (file-name-directory here))
  (require 'org-test)

  2. Then run the test suite.

      (org-test-run-all-tests)