88 lines
		
	
	
	
		
			2.3 KiB
		
	
	
	
		
			Bash
		
	
	
		
			Executable file
		
	
	
	
	
			
		
		
	
	
			88 lines
		
	
	
	
		
			2.3 KiB
		
	
	
	
		
			Bash
		
	
	
		
			Executable file
		
	
	
	
	
| #!/bin/sh
 | |
| 
 | |
| test_description='help'
 | |
| 
 | |
| . ./test-lib.sh
 | |
| 
 | |
| configure_help () {
 | |
| 	test_config help.format html &&
 | |
| 
 | |
| 	# Unless the path has "://" in it, Git tries to make sure
 | |
| 	# the documentation directory locally exists. Avoid it as
 | |
| 	# we are only interested in seeing an attempt to correctly
 | |
| 	# invoke a help browser in this test.
 | |
| 	test_config help.htmlpath test://html &&
 | |
| 
 | |
| 	# Name a custom browser
 | |
| 	test_config browser.test.cmd ./test-browser &&
 | |
| 	test_config help.browser test
 | |
| }
 | |
| 
 | |
| test_expect_success "setup" '
 | |
| 	# Just write out which page gets requested
 | |
| 	write_script test-browser <<-\EOF
 | |
| 	echo "$*" >test-browser.log
 | |
| 	EOF
 | |
| '
 | |
| 
 | |
| # make sure to exercise these code paths, the output is a bit tricky
 | |
| # to verify
 | |
| test_expect_success 'basic help commands' '
 | |
| 	git help >/dev/null &&
 | |
| 	git help -a --no-verbose >/dev/null &&
 | |
| 	git help -g >/dev/null &&
 | |
| 	git help -a >/dev/null
 | |
| '
 | |
| 
 | |
| test_expect_success "works for commands and guides by default" '
 | |
| 	configure_help &&
 | |
| 	git help status &&
 | |
| 	echo "test://html/git-status.html" >expect &&
 | |
| 	test_cmp expect test-browser.log &&
 | |
| 	git help revisions &&
 | |
| 	echo "test://html/gitrevisions.html" >expect &&
 | |
| 	test_cmp expect test-browser.log
 | |
| '
 | |
| 
 | |
| test_expect_success "--exclude-guides does not work for guides" '
 | |
| 	>test-browser.log &&
 | |
| 	test_must_fail git help --exclude-guides revisions &&
 | |
| 	test_must_be_empty test-browser.log
 | |
| '
 | |
| 
 | |
| test_expect_success "--help does not work for guides" "
 | |
| 	cat <<-EOF >expect &&
 | |
| 		git: 'revisions' is not a git command. See 'git --help'.
 | |
| 	EOF
 | |
| 	test_must_fail git revisions --help 2>actual &&
 | |
| 	test_i18ncmp expect actual
 | |
| "
 | |
| 
 | |
| test_expect_success 'git help' '
 | |
| 	git help >help.output &&
 | |
| 	test_i18ngrep "^   clone  " help.output &&
 | |
| 	test_i18ngrep "^   add    " help.output &&
 | |
| 	test_i18ngrep "^   log    " help.output &&
 | |
| 	test_i18ngrep "^   commit " help.output &&
 | |
| 	test_i18ngrep "^   fetch  " help.output
 | |
| '
 | |
| test_expect_success 'git help -g' '
 | |
| 	git help -g >help.output &&
 | |
| 	test_i18ngrep "^   attributes " help.output &&
 | |
| 	test_i18ngrep "^   everyday   " help.output &&
 | |
| 	test_i18ngrep "^   tutorial   " help.output
 | |
| '
 | |
| 
 | |
| test_expect_success 'generate builtin list' '
 | |
| 	git --list-cmds=builtins >builtins
 | |
| '
 | |
| 
 | |
| while read builtin
 | |
| do
 | |
| 	test_expect_success "$builtin can handle -h" '
 | |
| 		test_expect_code 129 git $builtin -h >output 2>&1 &&
 | |
| 		test_i18ngrep usage output
 | |
| 	'
 | |
| done <builtins
 | |
| 
 | |
| test_done
 |