1#!/bin/sh
2
3test_description='Test automatic use of a pager.'
4
5. ./test-lib.sh
6. "$TEST_DIRECTORY"/lib-pager.sh
7
8cleanup_fail() {
9 echo >&2 cleanup failed
10 (exit 1)
11}
12
13test_expect_success 'set up terminal for tests' '
14 rm -f stdout_is_tty ||
15 cleanup_fail &&
16
17 if test -t 1
18 then
19 >stdout_is_tty
20 elif
21 test_have_prereq PERL &&
22 "$PERL_PATH" "$TEST_DIRECTORY"/t7006/test-terminal.perl \
23 sh -c "test -t 1"
24 then
25 >test_terminal_works
26 fi
27'
28
29if test -e stdout_is_tty
30then
31 test_terminal() { "$@"; }
32 test_set_prereq TTY
33elif test -e test_terminal_works
34then
35 test_terminal() {
36 "$PERL_PATH" "$TEST_DIRECTORY"/t7006/test-terminal.perl "$@"
37 }
38 test_set_prereq TTY
39else
40 say "# no usable terminal, so skipping some tests"
41fi
42
43test_expect_success 'setup' '
44 unset GIT_PAGER GIT_PAGER_IN_USE;
45 test_might_fail git config --unset core.pager &&
46
47 PAGER="cat >paginated.out" &&
48 export PAGER &&
49
50 test_commit initial
51'
52
53test_expect_success TTY 'some commands use a pager' '
54 rm -f paginated.out ||
55 cleanup_fail &&
56
57 test_terminal git log &&
58 test -e paginated.out
59'
60
61test_expect_success TTY 'some commands do not use a pager' '
62 rm -f paginated.out ||
63 cleanup_fail &&
64
65 test_terminal git rev-list HEAD &&
66 ! test -e paginated.out
67'
68
69test_expect_success 'no pager when stdout is a pipe' '
70 rm -f paginated.out ||
71 cleanup_fail &&
72
73 git log | cat &&
74 ! test -e paginated.out
75'
76
77test_expect_success 'no pager when stdout is a regular file' '
78 rm -f paginated.out ||
79 cleanup_fail &&
80
81 git log >file &&
82 ! test -e paginated.out
83'
84
85test_expect_success TTY 'git --paginate rev-list uses a pager' '
86 rm -f paginated.out ||
87 cleanup_fail &&
88
89 test_terminal git --paginate rev-list HEAD &&
90 test -e paginated.out
91'
92
93test_expect_success 'no pager even with --paginate when stdout is a pipe' '
94 rm -f file paginated.out ||
95 cleanup_fail &&
96
97 git --paginate log | cat &&
98 ! test -e paginated.out
99'
100
101test_expect_success TTY 'no pager with --no-pager' '
102 rm -f paginated.out ||
103 cleanup_fail &&
104
105 test_terminal git --no-pager log &&
106 ! test -e paginated.out
107'
108
109# A colored commit log will begin with an appropriate ANSI escape
110# for the first color; the text "commit" comes later.
111colorful() {
112 read firstline <$1
113 ! expr "$firstline" : "[a-zA-Z]" >/dev/null
114}
115
116test_expect_success 'tests can detect color' '
117 rm -f colorful.log colorless.log ||
118 cleanup_fail &&
119
120 git log --no-color >colorless.log &&
121 git log --color >colorful.log &&
122 ! colorful colorless.log &&
123 colorful colorful.log
124'
125
126test_expect_success 'no color when stdout is a regular file' '
127 rm -f colorless.log &&
128 git config color.ui auto ||
129 cleanup_fail &&
130
131 git log >colorless.log &&
132 ! colorful colorless.log
133'
134
135test_expect_success TTY 'color when writing to a pager' '
136 rm -f paginated.out &&
137 git config color.ui auto ||
138 cleanup_fail &&
139
140 (
141 TERM=vt100 &&
142 export TERM &&
143 test_terminal git log
144 ) &&
145 colorful paginated.out
146'
147
148test_expect_success 'color when writing to a file intended for a pager' '
149 rm -f colorful.log &&
150 git config color.ui auto ||
151 cleanup_fail &&
152
153 (
154 TERM=vt100 &&
155 GIT_PAGER_IN_USE=true &&
156 export TERM GIT_PAGER_IN_USE &&
157 git log >colorful.log
158 ) &&
159 colorful colorful.log
160'
161
162if test_have_prereq SIMPLEPAGER && test_have_prereq TTY
163then
164 test_set_prereq SIMPLEPAGERTTY
165fi
166
167# Use this helper to make it easy for the caller of your
168# terminal-using function to specify whether it should fail.
169# If you write
170#
171# your_test() {
172# parse_args "$@"
173#
174# $test_expectation "$cmd - behaves well" "
175# ...
176# $full_command &&
177# ...
178# "
179# }
180#
181# then your test can be used like this:
182#
183# your_test expect_(success|failure) [test_must_fail] 'git foo'
184#
185parse_args() {
186 test_expectation="test_$1"
187 shift
188 if test "$1" = test_must_fail
189 then
190 full_command="test_must_fail test_terminal "
191 shift
192 else
193 full_command="test_terminal "
194 fi
195 cmd=$1
196 full_command="$full_command $1"
197}
198
199test_default_pager() {
200 parse_args "$@"
201
202 $test_expectation SIMPLEPAGERTTY "$cmd - default pager is used by default" "
203 unset PAGER GIT_PAGER;
204 test_might_fail git config --unset core.pager &&
205 rm -f default_pager_used ||
206 cleanup_fail &&
207
208 cat >\$less <<-\EOF &&
209 #!/bin/sh
210 wc >default_pager_used
211 EOF
212 chmod +x \$less &&
213 (
214 PATH=.:\$PATH &&
215 export PATH &&
216 $full_command
217 ) &&
218 test -e default_pager_used
219 "
220}
221
222test_PAGER_overrides() {
223 parse_args "$@"
224
225 $test_expectation TTY "$cmd - PAGER overrides default pager" "
226 unset GIT_PAGER;
227 test_might_fail git config --unset core.pager &&
228 rm -f PAGER_used ||
229 cleanup_fail &&
230
231 PAGER='wc >PAGER_used' &&
232 export PAGER &&
233 $full_command &&
234 test -e PAGER_used
235 "
236}
237
238test_core_pager_overrides() {
239 if_local_config=
240 used_if_wanted='overrides PAGER'
241 test_core_pager "$@"
242}
243
244test_local_config_ignored() {
245 if_local_config='! '
246 used_if_wanted='is not used'
247 test_core_pager "$@"
248}
249
250test_core_pager() {
251 parse_args "$@"
252
253 $test_expectation TTY "$cmd - repository-local core.pager setting $used_if_wanted" "
254 unset GIT_PAGER;
255 rm -f core.pager_used ||
256 cleanup_fail &&
257
258 PAGER=wc &&
259 export PAGER &&
260 git config core.pager 'wc >core.pager_used' &&
261 $full_command &&
262 ${if_local_config}test -e core.pager_used
263 "
264}
265
266test_core_pager_subdir() {
267 if_local_config=
268 used_if_wanted='overrides PAGER'
269 test_pager_subdir_helper "$@"
270}
271
272test_no_local_config_subdir() {
273 if_local_config='! '
274 used_if_wanted='is not used'
275 test_pager_subdir_helper "$@"
276}
277
278test_pager_subdir_helper() {
279 parse_args "$@"
280
281 $test_expectation TTY "$cmd - core.pager $used_if_wanted from subdirectory" "
282 unset GIT_PAGER;
283 rm -f core.pager_used &&
284 rm -fr sub ||
285 cleanup_fail &&
286
287 PAGER=wc &&
288 stampname=\$(pwd)/core.pager_used &&
289 export PAGER stampname &&
290 git config core.pager 'wc >\"\$stampname\"' &&
291 mkdir sub &&
292 (
293 cd sub &&
294 $full_command
295 ) &&
296 ${if_local_config}test -e core.pager_used
297 "
298}
299
300test_GIT_PAGER_overrides() {
301 parse_args "$@"
302
303 $test_expectation TTY "$cmd - GIT_PAGER overrides core.pager" "
304 rm -f GIT_PAGER_used ||
305 cleanup_fail &&
306
307 git config core.pager wc &&
308 GIT_PAGER='wc >GIT_PAGER_used' &&
309 export GIT_PAGER &&
310 $full_command &&
311 test -e GIT_PAGER_used
312 "
313}
314
315test_doesnt_paginate() {
316 parse_args "$@"
317
318 $test_expectation TTY "no pager for '$cmd'" "
319 rm -f GIT_PAGER_used ||
320 cleanup_fail &&
321
322 GIT_PAGER='wc >GIT_PAGER_used' &&
323 export GIT_PAGER &&
324 $full_command &&
325 ! test -e GIT_PAGER_used
326 "
327}
328
329test_pager_choices() {
330 test_default_pager expect_success "$@"
331 test_PAGER_overrides expect_success "$@"
332 test_core_pager_overrides expect_success "$@"
333 test_core_pager_subdir expect_success "$@"
334 test_GIT_PAGER_overrides expect_success "$@"
335}
336
337test_expect_success 'setup: some aliases' '
338 git config alias.aliasedlog log &&
339 git config alias.true "!true"
340'
341
342test_pager_choices 'git log'
343test_pager_choices 'git -p log'
344test_pager_choices 'git aliasedlog'
345
346test_default_pager expect_success 'git -p aliasedlog'
347test_PAGER_overrides expect_success 'git -p aliasedlog'
348test_core_pager_overrides expect_success 'git -p aliasedlog'
349test_core_pager_subdir expect_failure 'git -p aliasedlog'
350test_GIT_PAGER_overrides expect_success 'git -p aliasedlog'
351
352test_default_pager expect_success 'git -p true'
353test_PAGER_overrides expect_success 'git -p true'
354test_core_pager_overrides expect_success 'git -p true'
355test_core_pager_subdir expect_failure 'git -p true'
356test_GIT_PAGER_overrides expect_success 'git -p true'
357
358test_default_pager expect_success test_must_fail 'git -p request-pull'
359test_PAGER_overrides expect_success test_must_fail 'git -p request-pull'
360test_core_pager_overrides expect_success test_must_fail 'git -p request-pull'
361test_core_pager_subdir expect_failure test_must_fail 'git -p request-pull'
362test_GIT_PAGER_overrides expect_success test_must_fail 'git -p request-pull'
363
364test_default_pager expect_success test_must_fail 'git -p'
365test_PAGER_overrides expect_success test_must_fail 'git -p'
366test_local_config_ignored expect_failure test_must_fail 'git -p'
367test_no_local_config_subdir expect_success test_must_fail 'git -p'
368test_GIT_PAGER_overrides expect_success test_must_fail 'git -p'
369
370test_doesnt_paginate expect_failure test_must_fail 'git -p nonsense'
371
372test_done