Eric Schulte 6599e17654 babel: uncomment test-ob-lob.el test which seems to have stochastic failures 11 years ago
contrib 25c9d74352 ensure that the testing/contrib/lisp directory is created 11 years ago
ert @ 87b475f856 509ee52b53 adding ERT and jump.el as git submodules 11 years ago
examples e905dbe0f6 babel hashing now handles more complex types in params 11 years ago
jump @ 820bb7d81b a9f3c9fe11 now using newer version of jump.el -- run $ git submodule update 11 years ago
lisp 6599e17654 babel: uncomment test-ob-lob.el test which seems to have stochastic failures 11 years ago 462fc24cd3 typo in testing/, once again, thanks Nick Dokos 11 years ago
org-test-ob-consts.el e1b90eea45 ob-exp: fixed export when headings have links, with tests 11 years ago
org-test.el 3ab7f12792 org-test is now ready for the newyears 11 years ago

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

1) Install the ERT and jump.el testing dependencies which are included as git submodules 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) Review the ERT documentation, to do this run makeinfo in the testing/ert directory, #+begin_src sh cd ert makeinfo ert.texinfo #+end_src then browse the resulting info file.

5) 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.

    6) 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