annotate scripts/testfun/runtests.m @ 17148:fa14aa77b514

Allow relative directory name for rundemos/runtests. * scripts/testfun/rundemos.m: Use canonicalize_file_name if directory is relative. Use readdir() rather than dir() for performance. *scripts/testfun/runtests.m: Use canonicalize_file_name if directory is relative. Use readdir() rather than dir() for performance. Add %!error blocks.
author Rik <rik@octave.org>
date Fri, 02 Aug 2013 09:01:55 -0700
parents b7667fcb9fbc
children 2c2a6801cb57
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
14138
72c96de7a403 maint: update copyright notices for 2012
John W. Eaton <jwe@octave.org>
parents: 12673
diff changeset
1 ## Copyright (C) 2010-2012 John W. Eaton
10496
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
2 ##
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
3 ## This file is part of Octave.
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
4 ##
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
5 ## Octave is free software; you can redistribute it and/or modify it
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
6 ## under the terms of the GNU General Public License as published by
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
7 ## the Free Software Foundation; either version 3 of the License, or (at
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
8 ## your option) any later version.
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
9 ##
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
10 ## Octave is distributed in the hope that it will be useful, but
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
11 ## WITHOUT ANY WARRANTY; without even the implied warranty of
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
12 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
13 ## General Public License for more details.
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
14 ##
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
15 ## You should have received a copy of the GNU General Public License
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
16 ## along with Octave; see the file COPYING. If not, see
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
17 ## <http://www.gnu.org/licenses/>.
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
18
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
19 ## -*- texinfo -*-
12668
e3dc23f7dd54 doc: Improve a few docstrings related to test functions and directories.
Rik <octave@nomad.inbox5.com>
parents: 12469
diff changeset
20 ## @deftypefn {Function File} {} runtests ()
e3dc23f7dd54 doc: Improve a few docstrings related to test functions and directories.
Rik <octave@nomad.inbox5.com>
parents: 12469
diff changeset
21 ## @deftypefnx {Function File} {} runtests (@var{directory})
11024
fa56fd98c0c5 Remove requirement for PCRE in Octave. (Bug #31025)
Rik <octave@nomad.inbox5.com>
parents: 10635
diff changeset
22 ## Execute built-in tests for all function files in the specified directory.
17148
fa14aa77b514 Allow relative directory name for rundemos/runtests.
Rik <rik@octave.org>
parents: 16724
diff changeset
23 ##
12668
e3dc23f7dd54 doc: Improve a few docstrings related to test functions and directories.
Rik <octave@nomad.inbox5.com>
parents: 12469
diff changeset
24 ## If no directory is specified, operate on all directories in Octave's
e3dc23f7dd54 doc: Improve a few docstrings related to test functions and directories.
Rik <octave@nomad.inbox5.com>
parents: 12469
diff changeset
25 ## search path for functions.
e3dc23f7dd54 doc: Improve a few docstrings related to test functions and directories.
Rik <octave@nomad.inbox5.com>
parents: 12469
diff changeset
26 ## @seealso{rundemos, path}
10496
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
27 ## @end deftypefn
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
28
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
29 ## Author: jwe
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
30
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
31 function runtests (directory)
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
32
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
33 if (nargin == 0)
16724
b7667fcb9fbc Substitute ostrsplit() for strsplit().
Ben Abbott <bpabbott@mac.com>
parents: 16403
diff changeset
34 dirs = ostrsplit (path (), pathsep ());
10496
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
35 elseif (nargin == 1)
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
36 if (is_absolute_filename (directory))
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
37 dirs = {directory};
17148
fa14aa77b514 Allow relative directory name for rundemos/runtests.
Rik <rik@octave.org>
parents: 16724
diff changeset
38 elseif (is_rooted_relative_filename (directory))
fa14aa77b514 Allow relative directory name for rundemos/runtests.
Rik <rik@octave.org>
parents: 16724
diff changeset
39 dirs = {canonicalize_file_name(directory)};
10496
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
40 else
17148
fa14aa77b514 Allow relative directory name for rundemos/runtests.
Rik <rik@octave.org>
parents: 16724
diff changeset
41 if (directory(end) == filesep ())
fa14aa77b514 Allow relative directory name for rundemos/runtests.
Rik <rik@octave.org>
parents: 16724
diff changeset
42 directory = directory(1:end-1);
fa14aa77b514 Allow relative directory name for rundemos/runtests.
Rik <rik@octave.org>
parents: 16724
diff changeset
43 endif
10496
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
44 fullname = find_dir_in_path (directory);
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
45 if (! isempty (fullname))
10549
95c3e38098bf Untabify .m scripts
Rik <code@nomad.inbox5.com>
parents: 10496
diff changeset
46 dirs = {fullname};
10496
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
47 else
11472
1740012184f9 Use uppercase for variable names in error() strings to match Info documentation. Only m-files done.
Rik <octave@nomad.inbox5.com>
parents: 11032
diff changeset
48 error ("runtests: DIRECTORY argument must be a valid pathname");
10496
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
49 endif
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
50 endif
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
51 else
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
52 print_usage ();
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
53 endif
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
54
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
55 for i = 1:numel (dirs)
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
56 d = dirs{i};
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
57 run_all_tests (d);
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
58 endfor
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
59
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
60 endfunction
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
61
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
62 function run_all_tests (directory)
17148
fa14aa77b514 Allow relative directory name for rundemos/runtests.
Rik <rik@octave.org>
parents: 16724
diff changeset
63 flist = readdir (directory);
10496
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
64 no_tests = {};
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
65 printf ("Processing files in %s:\n\n", directory);
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
66 fflush (stdout);
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
67 for i = 1:numel (flist)
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
68 f = flist{i};
17148
fa14aa77b514 Allow relative directory name for rundemos/runtests.
Rik <rik@octave.org>
parents: 16724
diff changeset
69 if (length (f) > 2 && strcmpi (f((end-1):end), ".m"))
10496
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
70 ff = fullfile (directory, f);
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
71 if (has_tests (ff))
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
72 print_test_file_name (f);
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
73 [p, n, xf, sk] = test (ff, "quiet");
11589
b0084095098e missing semicolons in script files
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
74 print_pass_fail (n, p);
10496
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
75 fflush (stdout);
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
76 else
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
77 no_tests{end+1} = f;
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
78 endif
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
79 endif
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
80 endfor
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
81 if (! isempty (no_tests))
11024
fa56fd98c0c5 Remove requirement for PCRE in Octave. (Bug #31025)
Rik <octave@nomad.inbox5.com>
parents: 10635
diff changeset
82 printf ("\nThe following files in %s have no tests:\n\n", directory);
10496
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
83 printf ("%s", list_in_columns (no_tests));
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
84 endif
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
85 endfunction
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
86
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
87 function retval = has_tests (f)
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
88 fid = fopen (f);
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
89 if (fid >= 0)
17148
fa14aa77b514 Allow relative directory name for rundemos/runtests.
Rik <rik@octave.org>
parents: 16724
diff changeset
90 str = fread (fid, "*char").';
10496
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
91 fclose (fid);
17148
fa14aa77b514 Allow relative directory name for rundemos/runtests.
Rik <rik@octave.org>
parents: 16724
diff changeset
92 retval = ! isempty (regexp (str, '^%!(?:test|assert|error|warning)',
fa14aa77b514 Allow relative directory name for rundemos/runtests.
Rik <rik@octave.org>
parents: 16724
diff changeset
93 "lineanchors", "once"));
10496
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
94 else
10635
d1978e7364ad Print name of function in error() string messages.
Rik <octave@nomad.inbox5.com>
parents: 10549
diff changeset
95 error ("runtests: fopen failed: %s", f);
10496
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
96 endif
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
97 endfunction
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
98
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
99 function print_pass_fail (n, p)
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
100 if (n > 0)
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
101 printf (" PASS %4d/%-4d", p, n);
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
102 nfail = n - p;
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
103 if (nfail > 0)
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
104 printf (" FAIL %d", nfail);
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
105 endif
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
106 endif
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
107 puts ("\n");
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
108 endfunction
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
109
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
110 function print_test_file_name (nm)
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
111 filler = repmat (".", 1, 55-length (nm));
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
112 printf (" %s %s", nm, filler);
3b77db443cc0 scripts/testfun/runtests.m: new function
John W. Eaton <jwe@octave.org>
parents:
diff changeset
113 endfunction
17148
fa14aa77b514 Allow relative directory name for rundemos/runtests.
Rik <rik@octave.org>
parents: 16724
diff changeset
114
fa14aa77b514 Allow relative directory name for rundemos/runtests.
Rik <rik@octave.org>
parents: 16724
diff changeset
115
fa14aa77b514 Allow relative directory name for rundemos/runtests.
Rik <rik@octave.org>
parents: 16724
diff changeset
116 %!error runtests ("foo", 1)
fa14aa77b514 Allow relative directory name for rundemos/runtests.
Rik <rik@octave.org>
parents: 16724
diff changeset
117 %!error <DIRECTORY argument> runtests ("#_TOTALLY_/_INVALID_/_PATHNAME_#")
fa14aa77b514 Allow relative directory name for rundemos/runtests.
Rik <rik@octave.org>
parents: 16724
diff changeset
118