Litvinov Sergey 6b6ab13810 Awk can be called with no in-file: and no :stdin 9 years ago
contrib 25c9d74352 ensure that the testing/contrib/lisp directory is created 10 years ago
examples 6b6ab13810 Awk can be called with no in-file: and no :stdin 9 years ago
jump @ 820bb7d81b a9f3c9fe11 now using newer version of jump.el -- run $ git submodule update 10 years ago
lisp 6b6ab13810 Awk can be called with no in-file: and no :stdin 9 years ago
.gitignore 750502e3bf ignore testing/ert, in case anyone wants to keep ert installed there 9 years ago 6b6ab13810 Awk can be called with no in-file: and no :stdin 9 years ago
org-test-ob-consts.el e1b90eea45 ob-exp: fixed export when headings have links, with tests 10 years ago
org-test.el 38bc761e21 Modified testing/ to include ERT installation information for Emacs version < 24. Added new tests 9 years ago

The following instructions describe how to get started using the Org-mode test framework.

To run the tests interactively

:PROPERTIES: :tangle: no :END: 1) Install the jump.el testing dependency which is included as a git submodule in the org-mode repository. To do so run the following git submodule commands from inside the base of the Org-mode directory (or just execute the following code block).

#+begin_src sh cd .. git submodule init git submodule update #+end_src

2) Load the org-test.el file #+begin_src emacs-lisp (load-file "org-test.el") #+end_src

3) The org-test-jump command is now bound to M-C-j in all emacs-lisp files. Call this command from any file in the lisp/= directory of the org-mode repository to jump to the related test file in the =testing/ directory. Call this functions with a prefix argument, and the corresponding test file will be stubbed out if it doesn't already exist.

4) Ingest the file since some tests require this. #+begin_src emacs-lisp (org-babel-lob-ingest "../contrib/babel/") #+end_src

5) Review the ERT documentation

6) A number of org-mode-specific functions and macros are provided in org-test.el see the subsection of that file. Some of these functions make use of example org-mode files located in the examples/ directory.

    7) Functions for loading and running the Org-mode tests are provided in the [[file:org-test.el::%3B%3B%3B%20Load%20and%20Run%20tests][;;; Load and Run Tests]] subsection, the most important of which are
  • org-test-load which loads the entire Org-mode test suite
  • org-test-current-defun which runs all tests for the current
  • function around point (should be called from inside of an Org-mode elisp file)
  • org-test-run-all-tests which runs the entire Org-mode test suite
  • also note that the ert command can also be used to run tests

8) Load and run all tests #+begin_src emacs-lisp (load-file "org-test.el") (org-babel-lob-ingest "../contrib/babel/") (org-test-load) (org-test-run-all-tests) #+end_src

To run the tests in batch mode

First tangle this file out to your desktop.

;; add to the load path (add-to-list 'load-path (concat org-dir "/lisp/")) (add-to-list 'load-path (concat org-dir "/lisp/testing/")) (add-to-list 'load-path (concat org-dir "/lisp/testing/ert/"))

;; load Org-mode (require 'org)

;; setup the ID locations used in tests (require 'org-id) (org-id-update-id-locations (list (concat org-dir "/testing/examples/") (concat org-dir "/testing/examples/") (concat org-dir "/testing/examples/") (concat org-dir "/testing/examples/") (concat org-dir "/testing/examples/") (concat org-dir "/testing/examples/")))

;; ensure that the latest Org-mode is loaded (org-reload)

;; load the test suite (load-file (concat org-dir "/testing/org-test.el"))

;; configure Babel (org-babel-lob-ingest (concat org-dir "/contrib/babel/")) (org-babel-do-load-languages 'org-babel-load-languages '((emacs-lisp . t) (sh . t))) (setq org-confirm-babel-evaluate nil)

;; run the test suite (org-test-run-all-tests)

;; print the results (with-current-buffer "*ert*" (print (buffer-string)))

Then run the test suite with the following command which could use any version of Emacs.

emacs --batch -Q -l ~/Desktop/run-org-tests.el