]>
Commit | Line | Data |
---|---|---|
c74c7203 JN |
1 | # Performance testing framework. Each perf script starts much like |
2 | # a normal test script, except it sources this library instead of | |
3 | # test-lib.sh. See t/perf/README for documentation. | |
342e9ef2 TR |
4 | # |
5 | # Copyright (c) 2011 Thomas Rast | |
6 | # | |
7 | # This program is free software: you can redistribute it and/or modify | |
8 | # it under the terms of the GNU General Public License as published by | |
9 | # the Free Software Foundation, either version 2 of the License, or | |
10 | # (at your option) any later version. | |
11 | # | |
12 | # This program is distributed in the hope that it will be useful, | |
13 | # but WITHOUT ANY WARRANTY; without even the implied warranty of | |
14 | # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
15 | # GNU General Public License for more details. | |
16 | # | |
17 | # You should have received a copy of the GNU General Public License | |
18 | # along with this program. If not, see http://www.gnu.org/licenses/ . | |
19 | ||
0baf78e7 JK |
20 | # These variables must be set before the inclusion of test-lib.sh below, |
21 | # because it will change our working directory. | |
342e9ef2 TR |
22 | TEST_DIRECTORY=$(pwd)/.. |
23 | TEST_OUTPUT_DIRECTORY=$(pwd) | |
342e9ef2 TR |
24 | |
25 | TEST_NO_CREATE_REPO=t | |
ee1431bf | 26 | TEST_NO_MALLOC_CHECK=t |
342e9ef2 TR |
27 | |
28 | . ../test-lib.sh | |
29 | ||
be79131a RS |
30 | unset GIT_CONFIG_NOSYSTEM |
31 | GIT_CONFIG_SYSTEM="$TEST_DIRECTORY/perf/config" | |
32 | export GIT_CONFIG_SYSTEM | |
33 | ||
82b7eb23 ÆAB |
34 | if test -n "$GIT_TEST_INSTALLED" -a -z "$PERF_SET_GIT_TEST_INSTALLED" |
35 | then | |
36 | error "Do not use GIT_TEST_INSTALLED with the perf tests. | |
37 | ||
38 | Instead use: | |
39 | ||
40 | ./run <path-to-git> -- <tests> | |
41 | ||
42 | See t/perf/README for details." | |
43 | fi | |
44 | ||
561ae067 TR |
45 | # Variables from test-lib that are normally internal to the tests; we |
46 | # need to export them for test_perf subshells | |
47 | export TEST_DIRECTORY TRASH_DIRECTORY GIT_BUILD_DIR GIT_TEST_CMP | |
48 | ||
1a0962de JK |
49 | MODERN_GIT=$GIT_BUILD_DIR/bin-wrappers/git |
50 | export MODERN_GIT | |
51 | ||
3663e590 | 52 | perf_results_dir=$TEST_RESULTS_DIR |
5d445f34 | 53 | test -n "$GIT_PERF_SUBSECTION" && perf_results_dir="$perf_results_dir/$GIT_PERF_SUBSECTION" |
342e9ef2 TR |
54 | mkdir -p "$perf_results_dir" |
55 | rm -f "$perf_results_dir"/$(basename "$0" .sh).subtests | |
56 | ||
342e9ef2 TR |
57 | die_if_build_dir_not_repo () { |
58 | if ! ( cd "$TEST_DIRECTORY/.." && | |
59 | git rev-parse --build-dir >/dev/null 2>&1 ); then | |
60 | error "No $1 defined, and your build directory is not a repo" | |
61 | fi | |
62 | } | |
63 | ||
64 | if test -z "$GIT_PERF_REPO"; then | |
65 | die_if_build_dir_not_repo '$GIT_PERF_REPO' | |
66 | GIT_PERF_REPO=$TEST_DIRECTORY/.. | |
67 | fi | |
68 | if test -z "$GIT_PERF_LARGE_REPO"; then | |
69 | die_if_build_dir_not_repo '$GIT_PERF_LARGE_REPO' | |
70 | GIT_PERF_LARGE_REPO=$TEST_DIRECTORY/.. | |
71 | fi | |
72 | ||
91de27c5 ÆAB |
73 | test_perf_do_repo_symlink_config_ () { |
74 | test_have_prereq SYMLINKS || git config core.symlinks false | |
75 | } | |
76 | ||
85b87a53 JK |
77 | test_perf_copy_repo_contents () { |
78 | for stuff in "$1"/* | |
79 | do | |
80 | case "$stuff" in | |
36e834ab | 81 | */objects|*/hooks|*/config|*/commondir|*/gitdir|*/worktrees) |
85b87a53 JK |
82 | ;; |
83 | *) | |
84 | cp -R "$stuff" "$repo/.git/" || exit 1 | |
85 | ;; | |
86 | esac | |
87 | done | |
88 | } | |
89 | ||
342e9ef2 TR |
90 | test_perf_create_repo_from () { |
91 | test "$#" = 2 || | |
165293af | 92 | BUG "not 2 parameters to test-create-repo" |
342e9ef2 TR |
93 | repo="$1" |
94 | source="$2" | |
83d4a409 | 95 | source_git="$("$MODERN_GIT" -C "$source" rev-parse --git-dir)" |
1a0962de | 96 | objects_dir="$("$MODERN_GIT" -C "$source" rev-parse --git-path objects)" |
85b87a53 | 97 | common_dir="$("$MODERN_GIT" -C "$source" rev-parse --git-common-dir)" |
342e9ef2 TR |
98 | mkdir -p "$repo/.git" |
99 | ( | |
e2522f2a | 100 | cd "$source" && |
7501b592 JS |
101 | { cp -Rl "$objects_dir" "$repo/.git/" 2>/dev/null || |
102 | cp -R "$objects_dir" "$repo/.git/"; } && | |
85b87a53 JK |
103 | |
104 | # common_dir must come first here, since we want source_git to | |
105 | # take precedence and overwrite any overlapping files | |
106 | test_perf_copy_repo_contents "$common_dir" | |
107 | if test "$source_git" != "$common_dir" | |
108 | then | |
109 | test_perf_copy_repo_contents "$source_git" | |
110 | fi | |
e2522f2a RS |
111 | ) && |
112 | ( | |
7501b592 | 113 | cd "$repo" && |
91de27c5 ÆAB |
114 | "$MODERN_GIT" init -q && |
115 | test_perf_do_repo_symlink_config_ && | |
154ffeec ÆAB |
116 | mv .git/hooks .git/hooks-disabled 2>/dev/null && |
117 | if test -f .git/index.lock | |
118 | then | |
119 | # We may be copying a repo that can't run "git | |
120 | # status" due to a locked index. Since we have | |
121 | # a copy it's fine to remove the lock. | |
122 | rm .git/index.lock | |
123 | fi | |
342e9ef2 TR |
124 | ) || error "failed to copy repository '$source' to '$repo'" |
125 | } | |
126 | ||
127 | # call at least one of these to establish an appropriately-sized repository | |
91de27c5 ÆAB |
128 | test_perf_fresh_repo () { |
129 | repo="${1:-$TRASH_DIRECTORY}" | |
130 | "$MODERN_GIT" init -q "$repo" && | |
131 | ( | |
132 | cd "$repo" && | |
133 | test_perf_do_repo_symlink_config_ | |
134 | ) | |
135 | } | |
136 | ||
342e9ef2 TR |
137 | test_perf_default_repo () { |
138 | test_perf_create_repo_from "${1:-$TRASH_DIRECTORY}" "$GIT_PERF_REPO" | |
139 | } | |
140 | test_perf_large_repo () { | |
141 | if test "$GIT_PERF_LARGE_REPO" = "$GIT_BUILD_DIR"; then | |
142 | echo "warning: \$GIT_PERF_LARGE_REPO is \$GIT_BUILD_DIR." >&2 | |
143 | echo "warning: This will work, but may not be a sufficiently large repo" >&2 | |
144 | echo "warning: for representative measurements." >&2 | |
145 | fi | |
146 | test_perf_create_repo_from "${1:-$TRASH_DIRECTORY}" "$GIT_PERF_LARGE_REPO" | |
147 | } | |
148 | test_checkout_worktree () { | |
149 | git checkout-index -u -a || | |
150 | error "git checkout-index failed" | |
151 | } | |
152 | ||
153 | # Performance tests should never fail. If they do, stop immediately | |
154 | immediate=t | |
155 | ||
e3efa94b JS |
156 | # Perf tests require GNU time |
157 | case "$(uname -s)" in Darwin) GTIME="${GTIME:-gtime}";; esac | |
158 | GTIME="${GTIME:-/usr/bin/time}" | |
159 | ||
342e9ef2 TR |
160 | test_run_perf_ () { |
161 | test_cleanup=: | |
162 | test_export_="test_cleanup" | |
163 | export test_cleanup test_export_ | |
9ccab756 | 164 | "$GTIME" -f "%E %U %S" -o test_time.$i "$TEST_SHELL_PATH" -c ' |
1cbc3240 | 165 | . '"$TEST_DIRECTORY"/test-lib-functions.sh' |
342e9ef2 | 166 | test_export () { |
5bc12c11 | 167 | test_export_="$test_export_ $*" |
342e9ef2 TR |
168 | } |
169 | '"$1"' | |
170 | ret=$? | |
f4698738 ES |
171 | needles= |
172 | for v in $test_export_ | |
173 | do | |
174 | needles="$needles;s/^$v=/export $v=/p" | |
175 | done | |
176 | set | sed -n "s'"/'/'\\\\''/g"'$needles" >test_vars | |
342e9ef2 TR |
177 | exit $ret' >&3 2>&4 |
178 | eval_ret=$? | |
179 | ||
180 | if test $eval_ret = 0 || test -n "$expecting_failure" | |
181 | then | |
182 | test_eval_ "$test_cleanup" | |
183 | . ./test_vars || error "failed to load updated environment" | |
184 | fi | |
185 | if test "$verbose" = "t" && test -n "$HARNESS_ACTIVE"; then | |
186 | echo "" | |
187 | fi | |
188 | return "$eval_ret" | |
189 | } | |
190 | ||
968e77a5 JK |
191 | test_wrapper_ () { |
192 | test_wrapper_func_=$1; shift | |
62a23c9f | 193 | test_start_ |
342e9ef2 TR |
194 | test "$#" = 3 && { test_prereq=$1; shift; } || test_prereq= |
195 | test "$#" = 2 || | |
165293af | 196 | BUG "not 2 or 3 parameters to test-expect-success" |
342e9ef2 TR |
197 | export test_prereq |
198 | if ! test_skip "$@" | |
199 | then | |
200 | base=$(basename "$0" .sh) | |
201 | echo "$test_count" >>"$perf_results_dir"/$base.subtests | |
202 | echo "$1" >"$perf_results_dir"/$base.$test_count.descr | |
df0f5021 | 203 | base="$perf_results_dir"/"$PERF_RESULTS_PREFIX$(basename "$0" .sh)"."$test_count" |
968e77a5 JK |
204 | "$test_wrapper_func_" "$@" |
205 | fi | |
206 | ||
207 | test_finish_ | |
208 | } | |
209 | ||
210 | test_perf_ () { | |
211 | if test -z "$verbose"; then | |
212 | printf "%s" "perf $test_count - $1:" | |
213 | else | |
214 | echo "perf $test_count - $1:" | |
215 | fi | |
216 | for i in $(test_seq 1 $GIT_PERF_REPEAT_COUNT); do | |
217 | say >&3 "running: $2" | |
218 | if test_run_perf_ "$2" | |
219 | then | |
220 | if test -z "$verbose"; then | |
221 | printf " %s" "$i" | |
342e9ef2 | 222 | else |
968e77a5 | 223 | echo "* timing run $i/$GIT_PERF_REPEAT_COUNT:" |
342e9ef2 | 224 | fi |
342e9ef2 | 225 | else |
968e77a5 JK |
226 | test -z "$verbose" && echo |
227 | test_failure_ "$@" | |
228 | break | |
342e9ef2 | 229 | fi |
968e77a5 JK |
230 | done |
231 | if test -z "$verbose"; then | |
232 | echo " ok" | |
233 | else | |
234 | test_ok_ "$1" | |
342e9ef2 | 235 | fi |
b8dcc453 | 236 | "$TEST_DIRECTORY"/perf/min_time.perl test_time.* >"$base".result |
b9e4d848 | 237 | rm test_time.* |
968e77a5 JK |
238 | } |
239 | ||
240 | test_perf () { | |
241 | test_wrapper_ test_perf_ "$@" | |
342e9ef2 TR |
242 | } |
243 | ||
22bec79d JK |
244 | test_size_ () { |
245 | say >&3 "running: $2" | |
b8dcc453 | 246 | if test_eval_ "$2" 3>"$base".result; then |
22bec79d JK |
247 | test_ok_ "$1" |
248 | else | |
249 | test_failure_ "$@" | |
250 | fi | |
251 | } | |
252 | ||
253 | test_size () { | |
254 | test_wrapper_ test_size_ "$@" | |
255 | } | |
256 | ||
342e9ef2 TR |
257 | # We extend test_done to print timings at the end (./run disables this |
258 | # and does it after running everything) | |
259 | test_at_end_hook_ () { | |
260 | if test -z "$GIT_PERF_AGGREGATING_LATER"; then | |
3663e590 PS |
261 | ( |
262 | cd "$TEST_DIRECTORY"/perf && | |
263 | ./aggregate.perl --results-dir="$TEST_RESULTS_DIR" $(basename "$0") | |
264 | ) | |
342e9ef2 TR |
265 | fi |
266 | } | |
267 | ||
268 | test_export () { | |
269 | export "$@" | |
270 | } | |
47274251 JK |
271 | |
272 | test_lazy_prereq PERF_EXTRA 'test_bool_env GIT_PERF_EXTRA false' |