Sync with 2.44.1
[git/gitster.git] / t / t7006-pager.sh
blobe56ca5b0fa8d472a06d0d504e29608bcec141087
1 #!/bin/sh
3 test_description='Test automatic use of a pager.'
5 . ./test-lib.sh
6 . "$TEST_DIRECTORY"/lib-pager.sh
7 . "$TEST_DIRECTORY"/lib-terminal.sh
9 test_expect_success 'setup' '
10 sane_unset GIT_PAGER GIT_PAGER_IN_USE &&
11 test_unconfig core.pager &&
13 PAGER="cat >paginated.out" &&
14 export PAGER &&
16 test_commit initial
19 test_expect_success TTY 'some commands use a pager' '
20 rm -f paginated.out &&
21 test_terminal git log &&
22 test_path_is_file paginated.out
25 test_expect_failure TTY 'pager runs from subdir' '
26 echo subdir/paginated.out >expected &&
27 mkdir -p subdir &&
28 rm -f paginated.out subdir/paginated.out &&
30 cd subdir &&
31 test_terminal git log
32 ) &&
34 ls paginated.out subdir/paginated.out ||
36 } >actual &&
37 test_cmp expected actual
40 test_expect_success TTY 'LESS and LV envvars are set for pagination' '
42 sane_unset LESS LV &&
43 PAGER="env >pager-env.out; wc" &&
44 export PAGER &&
46 test_terminal git log
47 ) &&
48 grep ^LESS= pager-env.out &&
49 grep ^LV= pager-env.out
52 test_expect_success !MINGW,TTY 'LESS and LV envvars set by git-sh-setup' '
54 sane_unset LESS LV &&
55 PAGER="env >pager-env.out; wc" &&
56 export PAGER &&
57 PATH="$(git --exec-path):$PATH" &&
58 export PATH &&
59 test_terminal sh -c ". git-sh-setup && git_pager"
60 ) &&
61 grep ^LESS= pager-env.out &&
62 grep ^LV= pager-env.out
65 test_expect_success TTY 'some commands do not use a pager' '
66 rm -f paginated.out &&
67 test_terminal git rev-list HEAD &&
68 test_path_is_missing paginated.out
71 test_expect_success 'no pager when stdout is a pipe' '
72 rm -f paginated.out &&
73 git log | cat &&
74 test_path_is_missing paginated.out
77 test_expect_success 'no pager when stdout is a regular file' '
78 rm -f paginated.out &&
79 git log >file &&
80 test_path_is_missing paginated.out
83 test_expect_success TTY 'git --paginate rev-list uses a pager' '
84 rm -f paginated.out &&
85 test_terminal git --paginate rev-list HEAD &&
86 test_path_is_file paginated.out
89 test_expect_success 'no pager even with --paginate when stdout is a pipe' '
90 rm -f file paginated.out &&
91 git --paginate log | cat &&
92 test_path_is_missing paginated.out
95 test_expect_success TTY 'no pager with --no-pager' '
96 rm -f paginated.out &&
97 test_terminal git --no-pager log &&
98 test_path_is_missing paginated.out
101 test_expect_success TTY 'configuration can disable pager' '
102 rm -f paginated.out &&
103 test_unconfig pager.grep &&
104 test_terminal git grep initial &&
105 test_path_is_file paginated.out &&
107 rm -f paginated.out &&
108 test_config pager.grep false &&
109 test_terminal git grep initial &&
110 test_path_is_missing paginated.out
113 test_expect_success TTY 'configuration can enable pager (from subdir)' '
114 rm -f paginated.out &&
115 mkdir -p subdir &&
116 test_config pager.bundle true &&
118 git bundle create test.bundle --all &&
119 rm -f paginated.out subdir/paginated.out &&
121 cd subdir &&
122 test_terminal git bundle unbundle ../test.bundle
123 ) &&
125 test_path_is_file paginated.out ||
126 test_path_is_file subdir/paginated.out
130 test_expect_success TTY 'git tag -l defaults to paging' '
131 rm -f paginated.out &&
132 test_terminal git tag -l &&
133 test_path_is_file paginated.out
136 test_expect_success TTY 'git tag -l respects pager.tag' '
137 rm -f paginated.out &&
138 test_terminal git -c pager.tag=false tag -l &&
139 test_path_is_missing paginated.out
142 test_expect_success TTY 'git tag -l respects --no-pager' '
143 rm -f paginated.out &&
144 test_terminal git -c pager.tag --no-pager tag -l &&
145 test_path_is_missing paginated.out
148 test_expect_success TTY 'git tag with no args defaults to paging' '
149 # no args implies -l so this should page like -l
150 rm -f paginated.out &&
151 test_terminal git tag &&
152 test_path_is_file paginated.out
155 test_expect_success TTY 'git tag with no args respects pager.tag' '
156 # no args implies -l so this should page like -l
157 rm -f paginated.out &&
158 test_terminal git -c pager.tag=false tag &&
159 test_path_is_missing paginated.out
162 test_expect_success TTY 'git tag --contains defaults to paging' '
163 # --contains implies -l so this should page like -l
164 rm -f paginated.out &&
165 test_terminal git tag --contains &&
166 test_path_is_file paginated.out
169 test_expect_success TTY 'git tag --contains respects pager.tag' '
170 # --contains implies -l so this should page like -l
171 rm -f paginated.out &&
172 test_terminal git -c pager.tag=false tag --contains &&
173 test_path_is_missing paginated.out
176 test_expect_success TTY 'git tag -a defaults to not paging' '
177 test_when_finished "git tag -d newtag" &&
178 rm -f paginated.out &&
179 test_terminal git tag -am message newtag &&
180 test_path_is_missing paginated.out
183 test_expect_success TTY 'git tag -a ignores pager.tag' '
184 test_when_finished "git tag -d newtag" &&
185 rm -f paginated.out &&
186 test_terminal git -c pager.tag tag -am message newtag &&
187 test_path_is_missing paginated.out
190 test_expect_success TTY 'git tag -a respects --paginate' '
191 test_when_finished "git tag -d newtag" &&
192 rm -f paginated.out &&
193 test_terminal git --paginate tag -am message newtag &&
194 test_path_is_file paginated.out
197 test_expect_success TTY 'git tag as alias ignores pager.tag with -a' '
198 test_when_finished "git tag -d newtag" &&
199 rm -f paginated.out &&
200 test_terminal git -c pager.tag -c alias.t=tag t -am message newtag &&
201 test_path_is_missing paginated.out
204 test_expect_success TTY 'git tag as alias respects pager.tag with -l' '
205 rm -f paginated.out &&
206 test_terminal git -c pager.tag=false -c alias.t=tag t -l &&
207 test_path_is_missing paginated.out
210 test_expect_success TTY 'git branch defaults to paging' '
211 rm -f paginated.out &&
212 test_terminal git branch &&
213 test_path_is_file paginated.out
216 test_expect_success TTY 'git branch respects pager.branch' '
217 rm -f paginated.out &&
218 test_terminal git -c pager.branch=false branch &&
219 test_path_is_missing paginated.out
222 test_expect_success TTY 'git branch respects --no-pager' '
223 rm -f paginated.out &&
224 test_terminal git --no-pager branch &&
225 test_path_is_missing paginated.out
228 test_expect_success TTY 'git branch --edit-description ignores pager.branch' '
229 rm -f paginated.out editor.used &&
230 write_script editor <<-\EOF &&
231 echo "New description" >"$1"
232 touch editor.used
234 EDITOR=./editor test_terminal git -c pager.branch branch --edit-description &&
235 test_path_is_missing paginated.out &&
236 test_path_is_file editor.used
239 test_expect_success TTY 'git branch --set-upstream-to ignores pager.branch' '
240 rm -f paginated.out &&
241 git branch other &&
242 test_when_finished "git branch -D other" &&
243 test_terminal git -c pager.branch branch --set-upstream-to=other &&
244 test_when_finished "git branch --unset-upstream" &&
245 test_path_is_missing paginated.out
248 test_expect_success TTY 'git config ignores pager.config when setting' '
249 rm -f paginated.out &&
250 test_terminal git -c pager.config config foo.bar bar &&
251 test_path_is_missing paginated.out
254 test_expect_success TTY 'git config --edit ignores pager.config' '
255 rm -f paginated.out editor.used &&
256 write_script editor <<-\EOF &&
257 touch editor.used
259 EDITOR=./editor test_terminal git -c pager.config config --edit &&
260 test_path_is_missing paginated.out &&
261 test_path_is_file editor.used
264 test_expect_success TTY 'git config --get ignores pager.config' '
265 rm -f paginated.out &&
266 test_terminal git -c pager.config config --get foo.bar &&
267 test_path_is_missing paginated.out
270 test_expect_success TTY 'git config --get-urlmatch defaults to paging' '
271 rm -f paginated.out &&
272 test_terminal git -c http."https://foo.com/".bar=foo \
273 config --get-urlmatch http https://foo.com &&
274 test_path_is_file paginated.out
277 test_expect_success TTY 'git config --get-all respects pager.config' '
278 rm -f paginated.out &&
279 test_terminal git -c pager.config=false config --get-all foo.bar &&
280 test_path_is_missing paginated.out
283 test_expect_success TTY 'git config --list defaults to paging' '
284 rm -f paginated.out &&
285 test_terminal git config --list &&
286 test_path_is_file paginated.out
290 # A colored commit log will begin with an appropriate ANSI escape
291 # for the first color; the text "commit" comes later.
292 colorful() {
293 read firstline <$1
294 ! expr "$firstline" : "[a-zA-Z]" >/dev/null
297 test_expect_success 'tests can detect color' '
298 rm -f colorful.log colorless.log &&
299 git log --no-color >colorless.log &&
300 git log --color >colorful.log &&
301 ! colorful colorless.log &&
302 colorful colorful.log
305 test_expect_success 'no color when stdout is a regular file' '
306 rm -f colorless.log &&
307 test_config color.ui auto &&
308 git log >colorless.log &&
309 ! colorful colorless.log
312 test_expect_success TTY 'color when writing to a pager' '
313 rm -f paginated.out &&
314 test_config color.ui auto &&
315 test_terminal git log &&
316 colorful paginated.out
319 test_expect_success TTY 'colors are suppressed by color.pager' '
320 rm -f paginated.out &&
321 test_config color.ui auto &&
322 test_config color.pager false &&
323 test_terminal git log &&
324 ! colorful paginated.out
327 test_expect_success 'color when writing to a file intended for a pager' '
328 rm -f colorful.log &&
329 test_config color.ui auto &&
331 TERM=vt100 &&
332 GIT_PAGER_IN_USE=true &&
333 export TERM GIT_PAGER_IN_USE &&
334 git log >colorful.log
335 ) &&
336 colorful colorful.log
339 test_expect_success TTY 'colors are sent to pager for external commands' '
340 test_config alias.externallog "!git log" &&
341 test_config color.ui auto &&
342 test_terminal git -p externallog &&
343 colorful paginated.out
346 # Use this helper to make it easy for the caller of your
347 # terminal-using function to specify whether it should fail.
348 # If you write
350 # your_test() {
351 # parse_args "$@"
353 # $test_expectation "$cmd - behaves well" "
354 # ...
355 # $full_command &&
356 # ...
360 # then your test can be used like this:
362 # your_test expect_(success|failure) [test_must_fail] 'git foo'
364 parse_args() {
365 test_expectation="test_$1"
366 shift
367 if test "$1" = test_must_fail
368 then
369 full_command="test_must_fail test_terminal "
370 shift
371 else
372 full_command="test_terminal "
374 cmd=$1
375 full_command="$full_command $1"
378 test_default_pager() {
379 parse_args "$@"
381 $test_expectation SIMPLEPAGER,TTY "$cmd - default pager is used by default" "
382 sane_unset PAGER GIT_PAGER &&
383 test_unconfig core.pager &&
384 rm -f default_pager_used &&
385 cat >\$less <<-\EOF &&
386 #!/bin/sh
387 wc >default_pager_used
389 chmod +x \$less &&
391 PATH=.:\$PATH &&
392 export PATH &&
393 $full_command
394 ) &&
395 test_path_is_file default_pager_used
399 test_PAGER_overrides() {
400 parse_args "$@"
402 $test_expectation TTY "$cmd - PAGER overrides default pager" "
403 sane_unset GIT_PAGER &&
404 test_unconfig core.pager &&
405 rm -f PAGER_used &&
406 PAGER='wc >PAGER_used' &&
407 export PAGER &&
408 $full_command &&
409 test_path_is_file PAGER_used
413 test_core_pager_overrides() {
414 if_local_config=
415 used_if_wanted='overrides PAGER'
416 test_core_pager "$@"
419 test_local_config_ignored() {
420 if_local_config='! '
421 used_if_wanted='is not used'
422 test_core_pager "$@"
425 test_core_pager() {
426 parse_args "$@"
428 $test_expectation TTY "$cmd - repository-local core.pager setting $used_if_wanted" "
429 sane_unset GIT_PAGER &&
430 rm -f core.pager_used &&
431 PAGER=wc &&
432 export PAGER &&
433 test_config core.pager 'wc >core.pager_used' &&
434 $full_command &&
435 ${if_local_config}test_path_is_file core.pager_used
439 test_core_pager_subdir() {
440 if_local_config=
441 used_if_wanted='overrides PAGER'
442 test_pager_subdir_helper "$@"
445 test_no_local_config_subdir() {
446 if_local_config='! '
447 used_if_wanted='is not used'
448 test_pager_subdir_helper "$@"
451 test_pager_subdir_helper() {
452 parse_args "$@"
454 $test_expectation TTY "$cmd - core.pager $used_if_wanted from subdirectory" "
455 sane_unset GIT_PAGER &&
456 rm -f core.pager_used &&
457 rm -fr sub &&
458 PAGER=wc &&
459 stampname=\$(pwd)/core.pager_used &&
460 export PAGER stampname &&
461 test_config core.pager 'wc >\"\$stampname\"' &&
462 mkdir sub &&
464 cd sub &&
465 $full_command
466 ) &&
467 ${if_local_config}test_path_is_file core.pager_used
471 test_GIT_PAGER_overrides() {
472 parse_args "$@"
474 $test_expectation TTY "$cmd - GIT_PAGER overrides core.pager" "
475 rm -f GIT_PAGER_used &&
476 test_config core.pager wc &&
477 GIT_PAGER='wc >GIT_PAGER_used' &&
478 export GIT_PAGER &&
479 $full_command &&
480 test_path_is_file GIT_PAGER_used
484 test_doesnt_paginate() {
485 parse_args "$@"
487 $test_expectation TTY "no pager for '$cmd'" "
488 rm -f GIT_PAGER_used &&
489 GIT_PAGER='wc >GIT_PAGER_used' &&
490 export GIT_PAGER &&
491 $full_command &&
492 test_path_is_missing GIT_PAGER_used
496 test_pager_choices() {
497 test_default_pager expect_success "$@"
498 test_PAGER_overrides expect_success "$@"
499 test_core_pager_overrides expect_success "$@"
500 test_core_pager_subdir expect_success "$@"
501 test_GIT_PAGER_overrides expect_success "$@"
504 test_expect_success 'setup: some aliases' '
505 git config alias.aliasedlog log &&
506 git config alias.true "!true"
509 test_pager_choices 'git log'
510 test_pager_choices 'git -p log'
511 test_pager_choices 'git aliasedlog'
513 test_default_pager expect_success 'git -p aliasedlog'
514 test_PAGER_overrides expect_success 'git -p aliasedlog'
515 test_core_pager_overrides expect_success 'git -p aliasedlog'
516 test_core_pager_subdir expect_success 'git -p aliasedlog'
517 test_GIT_PAGER_overrides expect_success 'git -p aliasedlog'
519 test_default_pager expect_success 'git -p true'
520 test_PAGER_overrides expect_success 'git -p true'
521 test_core_pager_overrides expect_success 'git -p true'
522 test_core_pager_subdir expect_success 'git -p true'
523 test_GIT_PAGER_overrides expect_success 'git -p true'
525 test_default_pager expect_success test_must_fail 'git -p request-pull'
526 test_PAGER_overrides expect_success test_must_fail 'git -p request-pull'
527 test_core_pager_overrides expect_success test_must_fail 'git -p request-pull'
528 test_core_pager_subdir expect_success test_must_fail 'git -p request-pull'
529 test_GIT_PAGER_overrides expect_success test_must_fail 'git -p request-pull'
531 test_default_pager expect_success test_must_fail 'git -p'
532 test_PAGER_overrides expect_success test_must_fail 'git -p'
533 test_local_config_ignored expect_failure test_must_fail 'git -p'
534 test_GIT_PAGER_overrides expect_success test_must_fail 'git -p'
536 test_expect_success TTY 'core.pager in repo config works and retains cwd' '
537 sane_unset GIT_PAGER &&
538 test_config core.pager "cat >cwd-retained" &&
540 cd sub &&
541 rm -f cwd-retained &&
542 test_terminal git -p rev-parse HEAD &&
543 test_path_is_file cwd-retained
547 test_expect_success TTY 'core.pager is found via alias in subdirectory' '
548 sane_unset GIT_PAGER &&
549 test_config core.pager "cat >via-alias" &&
551 cd sub &&
552 rm -f via-alias &&
553 test_terminal git -c alias.r="-p rev-parse" r HEAD &&
554 test_path_is_file via-alias
558 test_doesnt_paginate expect_failure test_must_fail 'git -p nonsense'
560 test_pager_choices 'git shortlog'
561 test_expect_success 'setup: configure shortlog not to paginate' '
562 git config pager.shortlog false
564 test_doesnt_paginate expect_success 'git shortlog'
565 test_no_local_config_subdir expect_success 'git shortlog'
566 test_default_pager expect_success 'git -p shortlog'
567 test_core_pager_subdir expect_success 'git -p shortlog'
569 test_core_pager_subdir expect_success test_must_fail \
570 'git -p apply </dev/null'
572 test_expect_success TTY 'command-specific pager' '
573 sane_unset PAGER GIT_PAGER &&
574 echo "foo:initial" >expect &&
575 >actual &&
576 test_unconfig core.pager &&
577 test_config pager.log "sed s/^/foo:/ >actual" &&
578 test_terminal git log --format=%s -1 &&
579 test_cmp expect actual
582 test_expect_success TTY 'command-specific pager overrides core.pager' '
583 sane_unset PAGER GIT_PAGER &&
584 echo "foo:initial" >expect &&
585 >actual &&
586 test_config core.pager "exit 1" &&
587 test_config pager.log "sed s/^/foo:/ >actual" &&
588 test_terminal git log --format=%s -1 &&
589 test_cmp expect actual
592 test_expect_success TTY 'command-specific pager overridden by environment' '
593 GIT_PAGER="sed s/^/foo:/ >actual" && export GIT_PAGER &&
594 >actual &&
595 echo "foo:initial" >expect &&
596 test_config pager.log "exit 1" &&
597 test_terminal git log --format=%s -1 &&
598 test_cmp expect actual
601 test_expect_success 'setup external command' '
602 cat >git-external <<-\EOF &&
603 #!/bin/sh
604 git "$@"
606 chmod +x git-external
609 test_expect_success TTY 'command-specific pager works for external commands' '
610 sane_unset PAGER GIT_PAGER &&
611 echo "foo:initial" >expect &&
612 >actual &&
613 test_config pager.external "sed s/^/foo:/ >actual" &&
614 test_terminal git --exec-path="$(pwd)" external log --format=%s -1 &&
615 test_cmp expect actual
618 test_expect_success TTY 'sub-commands of externals use their own pager' '
619 sane_unset PAGER GIT_PAGER &&
620 echo "foo:initial" >expect &&
621 >actual &&
622 test_config pager.log "sed s/^/foo:/ >actual" &&
623 test_terminal git --exec-path=. external log --format=%s -1 &&
624 test_cmp expect actual
627 test_expect_success TTY 'external command pagers override sub-commands' '
628 sane_unset PAGER GIT_PAGER &&
629 >actual &&
630 test_config pager.external false &&
631 test_config pager.log "sed s/^/log:/ >actual" &&
632 test_terminal git --exec-path=. external log --format=%s -1 &&
633 test_must_be_empty actual
636 test_expect_success 'command with underscores does not complain' '
637 write_script git-under_score <<-\EOF &&
638 echo ok
640 git --exec-path=. under_score >actual 2>&1 &&
641 echo ok >expect &&
642 test_cmp expect actual
645 test_expect_success TTY 'git tag with auto-columns ' '
646 test_commit one &&
647 test_commit two &&
648 test_commit three &&
649 test_commit four &&
650 test_commit five &&
651 cat >expect <<-\EOF &&
652 initial one two three four five
654 test_terminal env PAGER="cat >actual" COLUMNS=80 \
655 git -c column.ui=auto tag --sort=authordate &&
656 test_cmp expect actual
659 test_expect_success 'setup trace2' '
660 GIT_TRACE2_BRIEF=1 &&
661 export GIT_TRACE2_BRIEF
664 test_expect_success 'setup large log output' '
665 perl -e "
666 print \"this is a long commit message\" x 50000
667 " >commit-msg &&
668 git commit --allow-empty -F commit-msg
671 test_expect_success TTY 'git returns SIGPIPE on early pager exit' '
672 test_when_finished "rm pager-used trace.normal" &&
673 test_config core.pager ">pager-used; head -n 1; exit 0" &&
674 GIT_TRACE2="$(pwd)/trace.normal" &&
675 export GIT_TRACE2 &&
676 test_when_finished "unset GIT_TRACE2" &&
678 if test_have_prereq !MINGW
679 then
680 { test_terminal git log >/dev/null; OUT=$?; } &&
681 test_match_signal 13 "$OUT"
682 else
683 test_terminal git log
684 fi &&
686 grep child_exit trace.normal >child-exits &&
687 test_line_count = 1 child-exits &&
688 grep " code:0 " child-exits &&
689 test_path_is_file pager-used
692 test_expect_success TTY 'git returns SIGPIPE on early pager non-zero exit' '
693 test_when_finished "rm pager-used trace.normal" &&
694 test_config core.pager ">pager-used; head -n 1; exit 1" &&
695 GIT_TRACE2="$(pwd)/trace.normal" &&
696 export GIT_TRACE2 &&
697 test_when_finished "unset GIT_TRACE2" &&
699 if test_have_prereq !MINGW
700 then
701 { test_terminal git log >/dev/null; OUT=$?; } &&
702 test_match_signal 13 "$OUT"
703 else
704 test_terminal git log
705 fi &&
707 grep child_exit trace.normal >child-exits &&
708 test_line_count = 1 child-exits &&
709 grep " code:1 " child-exits &&
710 test_path_is_file pager-used
713 test_expect_success TTY 'git discards pager non-zero exit without SIGPIPE' '
714 test_when_finished "rm pager-used trace.normal" &&
715 test_config core.pager "wc >pager-used; exit 1" &&
716 GIT_TRACE2="$(pwd)/trace.normal" &&
717 export GIT_TRACE2 &&
718 test_when_finished "unset GIT_TRACE2" &&
720 test_terminal git log &&
722 grep child_exit trace.normal >child-exits &&
723 test_line_count = 1 child-exits &&
724 grep " code:1 " child-exits &&
725 test_path_is_file pager-used
728 test_expect_success TTY 'git skips paging nonexisting command' '
729 test_when_finished "rm trace.normal" &&
730 test_config core.pager "does-not-exist" &&
731 GIT_TRACE2="$(pwd)/trace.normal" &&
732 export GIT_TRACE2 &&
733 test_when_finished "unset GIT_TRACE2" &&
735 test_terminal git log &&
737 grep child_exit trace.normal >child-exits &&
738 test_line_count = 1 child-exits &&
739 grep " code:-1 " child-exits
742 test_expect_success TTY 'git returns SIGPIPE on propagated signals from pager' '
743 test_when_finished "rm pager-used trace.normal" &&
744 test_config core.pager ">pager-used; exec test-tool sigchain" &&
745 GIT_TRACE2="$(pwd)/trace.normal" &&
746 export GIT_TRACE2 &&
747 test_when_finished "unset GIT_TRACE2" &&
749 if test_have_prereq !MINGW
750 then
751 { test_terminal git log >/dev/null; OUT=$?; } &&
752 test_match_signal 13 "$OUT"
753 else
754 test_terminal git log
755 fi &&
757 grep child_exit trace.normal >child-exits &&
758 test_line_count = 1 child-exits &&
759 grep " code:143 " child-exits &&
760 test_path_is_file pager-used
763 test_expect_success TTY 'non-existent pager doesnt cause crash' '
764 test_config pager.show invalid-pager &&
765 test_terminal git show
768 test_done