blob c8524801b0605bfe2cfe5ca885a0a2e5e15d2485 2746 bytes (raw)
name: testing/README.org # note: path name is non-authoritative(*)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
| | #+Title: Org-mode Testing
#+Babel: results silent
The following instructions describe how to get started using the
Org-mode test framework.
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) The ERT testing library is included in Emacs 24. On Emacs prior to
version 24 it is required to install a recent version of ERT and
set up its load-path in your init file. A recent package can be
downloaded [[https://github.com/ohler/ert/archives/fb3c278d3c8ddc6a558779d2c5262acc7cea4204][here.]] Copy the files into testing/ert and follow the
installation instructions in README.txt
3) Load the [[file:org-test.el][org-test.el]] file
#+begin_src emacs-lisp
(load-file "org-test.el")
#+end_src
4) 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.
5) Ingest the library-of-babel.org file since some tests require this.
#+begin_src emacs-lisp
(org-babel-lob-ingest "../contrib/babel/library-of-babel.org")
#+end_src
6) [[info:ert#Top][Review the ERT documentation]]
7) A number of org-mode-specific functions and macros are provided in
=org-test.el= see the [[file:org-test.el::%3B%3B%3B%20Functions%20for%20writing%20tests][;;; Functions for Writing Tests]] subsection of
that file. Some of these functions make use of example org-mode
files located in the [[file:examples][examples/]] directory.
8) 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
9) Load and run all tests
#+begin_src emacs-lisp
(load-file "org-test.el")
(org-babel-lob-ingest "../contrib/babel/library-of-babel.org")
(org-test-load)
(org-test-run-all-tests)
#+end_src
|
debug log:
solving c852480 ...
found c852480 in https://yhetil.org/orgmode/87fwr5qrex.fsf@btinternet.com/
found c6c3eef in https://git.savannah.gnu.org/cgit/emacs/org-mode.git
preparing index
index prepared:
100644 c6c3eef939b1a9c773e0e9593bda13db66b983fd testing/README.org
applying [1/1] https://yhetil.org/orgmode/87fwr5qrex.fsf@btinternet.com/
diff --git a/testing/README.org b/testing/README.org
index c6c3eef..c852480 100644
1:36: trailing whitespace.
6) [[info:ert#Top][Review the ERT documentation]]
Checking patch testing/README.org...
Applied patch testing/README.org cleanly.
warning: 1 line adds whitespace errors.
index at:
100644 c8524801b0605bfe2cfe5ca885a0a2e5e15d2485 testing/README.org
(*) Git path names are given by the tree(s) the blob belongs to.
Blobs themselves have no identifier aside from the hash of its contents.^
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).