diff --git a/Documentation/config/advice.txt b/Documentation/config/advice.txt index 0e35ae5240fa523039524b52aaeccd41e62820ac..0516a23b6ba0ad4ea313b11b197d759fa0c26a04 100644 --- a/Documentation/config/advice.txt +++ b/Documentation/config/advice.txt @@ -5,6 +5,11 @@ advice.*:: that you do not need the help message by setting these to `false`: + -- + all:: + Convenience option that allows all advice hints to be + disabled when set to false. When false, individual + advice hints can be enabled by setting them to true. + Setting this to true is a no-op. addEmbeddedRepo:: Shown when the user accidentally adds one git repo inside of another. diff --git a/advice.c b/advice.c index 75111191ad586d4cbae07e806f8b2bb6f7ebe83b..9f0860f1435707b2e03c592a22f60686e8c5f8eb 100644 --- a/advice.c +++ b/advice.c @@ -43,6 +43,7 @@ static struct { const char *key; enum advice_level level; } advice_setting[] = { + [ADVICE_ALL] = { "all" }, [ADVICE_ADD_EMBEDDED_REPO] = { "addEmbeddedRepo" }, [ADVICE_ADD_EMPTY_PATHSPEC] = { "addEmptyPathspec" }, [ADVICE_ADD_IGNORED_FILE] = { "addIgnoredFile" }, @@ -132,6 +133,13 @@ int advice_enabled(enum advice_type type) return enabled && advice_enabled(ADVICE_PUSH_UPDATE_REJECTED_ALIAS); + /* + * We still allow for specific advice hints to be enabled if + * advice.all == false. + */ + if (advice_setting[ADVICE_ALL].level == ADVICE_LEVEL_DISABLED) + return advice_setting[type].level == ADVICE_LEVEL_ENABLED; + return enabled; } diff --git a/advice.h b/advice.h index c8d29f97f39bef84062d541009a27bd35a47f9dd..b5ac99a645dc9b7718393dcf6c493cd163ebedce 100644 --- a/advice.h +++ b/advice.h @@ -11,6 +11,7 @@ struct string_list; * Call advise_if_enabled to print your advice. */ enum advice_type { + ADVICE_ALL, ADVICE_ADD_EMBEDDED_REPO, ADVICE_ADD_EMPTY_PATHSPEC, ADVICE_ADD_IGNORED_FILE, diff --git a/t/helper/test-advise.c b/t/helper/test-advise.c index 8a3fd0009a042c67019a3e89e5727dc4b7240600..c18b18e0596509dea1e4921c4887c909ae368fd5 100644 --- a/t/helper/test-advise.c +++ b/t/helper/test-advise.c @@ -5,18 +5,26 @@ int cmd__advise_if_enabled(int argc, const char **argv) { - if (argc != 2) - die("usage: %s ", argv[0]); + if (argc != 3) + die("usage: %s nestedTag|pushUpdateRejected ", argv[0]); setup_git_directory(); git_config(git_default_config, NULL); /* - * Any advice type can be used for testing, but NESTED_TAG was - * selected here and in t0018 where this command is being - * executed. + * Any advice type can be used for testing, but ADVICE_NESTED_TAG and + * ADVICE_PUSH_UPDATE_REJECTED were selected here and used in t0018 + * where this command is being executed. + * + * This allows test cases to exercise the normal and special branch + * within advice_enabled(). */ - advise_if_enabled(ADVICE_NESTED_TAG, "%s", argv[1]); + if (!strcmp(argv[1], "nestedTag")) + advise_if_enabled(ADVICE_NESTED_TAG, "%s", argv[2]); + else if (!strcmp(argv[1], "pushUpdateRejected")) + advise_if_enabled(ADVICE_PUSH_UPDATE_REJECTED, "%s", argv[2]); + else + die("advice type should be nestedTag|pushUpdateRejected"); return 0; } diff --git a/t/t0018-advice.sh b/t/t0018-advice.sh index 0dcfb760a2ba922570d12e17cc1ff6297bdab913..19318cc9bb9d1f5144d630a239104ee839a2ce22 100755 --- a/t/t0018-advice.sh +++ b/t/t0018-advice.sh @@ -10,7 +10,16 @@ test_expect_success 'advice should be printed when config variable is unset' ' hint: This is a piece of advice hint: Disable this message with "git config advice.nestedTag false" EOF - test-tool advise "This is a piece of advice" 2>actual && + test-tool advise nestedTag "This is a piece of advice" 2>actual && + test_cmp expect actual +' + +test_expect_success 'advice should be printed when advice.pushUpdateRejected and its alias are unset' ' + cat >expect <<-\EOF && + hint: This is a piece of advice + hint: Disable this message with "git config advice.pushUpdateRejected false" + EOF + test-tool advise pushUpdateRejected "This is a piece of advice" 2>actual && test_cmp expect actual ' @@ -19,14 +28,62 @@ test_expect_success 'advice should be printed when config variable is set to tru hint: This is a piece of advice EOF test_config advice.nestedTag true && - test-tool advise "This is a piece of advice" 2>actual && + test-tool advise nestedTag "This is a piece of advice" 2>actual && test_cmp expect actual ' test_expect_success 'advice should not be printed when config variable is set to false' ' test_config advice.nestedTag false && - test-tool advise "This is a piece of advice" 2>actual && + test-tool advise nestedTag "This is a piece of advice" 2>actual && + test_must_be_empty actual +' + +test_expect_success 'advice should not be printed when advice.pushUpdateRejected is unset but its alias is set to false' ' + test_config advice.pushNonFastForward false && + test-tool advise pushUpdateRejected "This is a piece of advice" 2>actual && + test_must_be_empty actual +' + +test_expect_success 'advice should be printed when advice.pushUpdateRejected is set to true and its alias is unset' ' + cat >expect <<-\EOF && + hint: This is a piece of advice + EOF + test_config advice.pushUpdateRejected true && + test-tool advise pushUpdateRejected "This is a piece of advice" 2>actual && + test_cmp expect actual +' + +test_expect_success 'advice should not be printed when advice.all is set to false' ' + test_config advice.all false && + test-tool advise nestedTag "This is a piece of advice" 2>actual && test_must_be_empty actual ' +test_expect_success 'advice should not be printed for pushUpdateRejected when advice.all is set to false' ' + test_config advice.all false && + test-tool advise pushUpdateRejected "This is a piece of advice" 2>actual && + test_must_be_empty actual +' + +test_expect_success 'advice should be printed when advice.all is set to false, but specific advice is set to true' ' + cat >expect <<-\EOF && + hint: This is a piece of advice + EOF + test_config advice.all false && + test_config advice.nestedTag true && + test-tool advise nestedTag "This is a piece of advice" 2>actual && + test_cmp expect actual +' + +test_expect_success 'advice should be printed when advice.all is set to false, but advice.pushUpdateRejected and its alias are set to true' ' + cat >expect <<-\EOF && + hint: This is a piece of advice + EOF + test_config advice.all false && + test_config advice.pushUpdateRejected true && + test_config advice.pushNonFastForward true && + test-tool advise pushUpdateRejected "This is a piece of advice" 2>actual && + test_cmp expect actual +' + test_done