From patchwork Mon Nov 22 07:51:10 2021
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
X-Patchwork-Submitter: =?utf-8?b?5b6Q5rKb5paHIChBbGVlbik=?=
 <aleen42@vip.qq.com>
X-Patchwork-Id: 12631365
Return-Path: <git-owner@kernel.org>
X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on
	aws-us-west-2-korg-lkml-1.web.codeaurora.org
Received: from vger.kernel.org (vger.kernel.org [23.128.96.18])
	by smtp.lore.kernel.org (Postfix) with ESMTP id 2A4AAC433FE
	for <git@archiver.kernel.org>; Mon, 22 Nov 2021 07:51:21 +0000 (UTC)
Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand
        id S232786AbhKVHy0 (ORCPT <rfc822;git@archiver.kernel.org>);
        Mon, 22 Nov 2021 02:54:26 -0500
Received: from lindbergh.monkeyblade.net ([23.128.96.19]:40150 "EHLO
        lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org
        with ESMTP id S230487AbhKVHyV (ORCPT <rfc822;git@vger.kernel.org>);
        Mon, 22 Nov 2021 02:54:21 -0500
Received: from mail-wm1-x32a.google.com (mail-wm1-x32a.google.com
 [IPv6:2a00:1450:4864:20::32a])
        by lindbergh.monkeyblade.net (Postfix) with ESMTPS id CD5ECC061714
        for <git@vger.kernel.org>; Sun, 21 Nov 2021 23:51:14 -0800 (PST)
Received: by mail-wm1-x32a.google.com with SMTP id
 o19-20020a1c7513000000b0033a93202467so3883465wmc.2
        for <git@vger.kernel.org>; Sun, 21 Nov 2021 23:51:14 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=20210112;
        h=message-id:in-reply-to:references:from:date:subject:mime-version
         :content-transfer-encoding:fcc:to:cc;
        bh=U+7lZBAkso1pD4vo0mcR6XahjJ0cK3/FwsQtjNOLn+M=;
        b=aSeyWMmcC4GyUYmASrX6Cgt/B+TKdnyQ54zFTHDGB5Cinus3orLDW/fzy4p8TBKcLt
         vhLOmrp850G+RLH4TroZtfrSasDeOYf78ENa9jBYUAb861wNExu41ElWvTmhKwT37ny9
         sTU0nMUl2EDvxuqWeHeM82TMeAc0B8n3dZ2LAq/5XupioChqpUTar0UVcQL2sQuVaErP
         tXYtRKQQMlx10A9FtxGAG0zwlLM9NA6odiXJqUEd+rttGgAEkW90qF3DxP/3uvVCLVWx
         EsJIdd8nuLujcm24RO3aKLdmXTacWHB7SS6PxQPL6SUuo3pg+K7+IBjwW0UFgLd9ha9M
         ZhlA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=1e100.net; s=20210112;
        h=x-gm-message-state:message-id:in-reply-to:references:from:date
         :subject:mime-version:content-transfer-encoding:fcc:to:cc;
        bh=U+7lZBAkso1pD4vo0mcR6XahjJ0cK3/FwsQtjNOLn+M=;
        b=WWdCkHHDch/uE7BwiGl+EFkxjy4beZeF538P6kGTxSW0pl/BPVk460XdXuUqhWXNWD
         WZgBRkrfpYSKFzDtwBK7Z9myhq+ZC6dVg49bbLMyRrWOtWd1sVJ0dmKYEzQzXBLNQ7Hs
         VIOg37VnFSvobAoHGwtpLHKWGKS+OV5FsDN38EJkKJufX7HXZYF0hj3LAY2zrMS8L/LU
         r9U+Fa7+8LCQJUdwdgdoBn38hqMy0uhZRgaInXCQ9Rqs8MXOQ1+/qfRT3ie7A6CzP6eY
         etCy/GNwbXjNVNxfHUgywCR0kJ5GMT/2tVQ5c9kI+saSJXAJbnZhqiHB1EB/YNonYaMw
         4tUA==
X-Gm-Message-State: AOAM530Zz/QSSMeRBwaMaRkInLlFfVhdm7oqzMADNNXZx5Ul6Q0Ukrsp
        lD5McjcFGEr3P9zRUya9O6nFeXRsrf0=
X-Google-Smtp-Source: 
 ABdhPJzOms4tqS5ztXuCq5h1jm/SVmub6MR15J2IV59z13czg7gPS5lT/AHtjL8oGviV7jeZ9RiFbw==
X-Received: by 2002:a05:600c:3788:: with SMTP id
 o8mr26579454wmr.82.1637567473255;
        Sun, 21 Nov 2021 23:51:13 -0800 (PST)
Received: from [127.0.0.1] ([13.74.141.28])
        by smtp.gmail.com with ESMTPSA id
 ay21sm20885245wmb.7.2021.11.21.23.51.12
        (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
        Sun, 21 Nov 2021 23:51:12 -0800 (PST)
Message-Id: 
 <59bce7131dab858e8c87944ccb02eae8ba5fd459.1637567471.git.gitgitgadget@gmail.com>
In-Reply-To: <pull.1076.v10.git.1637567471.gitgitgadget@gmail.com>
References: <pull.1076.v9.git.1637564554.gitgitgadget@gmail.com>
        <pull.1076.v10.git.1637567471.gitgitgadget@gmail.com>
Date: Mon, 22 Nov 2021 07:51:10 +0000
Subject: [PATCH v10 1/2] doc: git-format-patch: describe the option --always
MIME-Version: 1.0
Fcc: Sent
To: git@vger.kernel.org
Cc: Aleen =?utf-8?b?5b6Q5rKb5paH?= <pwxu@coremail.cn>,
 Aleen <aleen42@vip.qq.com>, Aleen <aleen42@vip.qq.com>
Precedence: bulk
List-ID: <git.vger.kernel.org>
X-Mailing-List: git@vger.kernel.org
From: Aleen <aleen42@vip.qq.com>

From: Aleen <aleen42@vip.qq.com>

This commit has described how to use '--always' option in the command
'git-format-patch' to include patches for commits that emit no changes.

Signed-off-by: 徐沛文 (Aleen) <aleen42@vip.qq.com>
---
 Documentation/git-format-patch.txt | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/Documentation/git-format-patch.txt b/Documentation/git-format-patch.txt
index 113eabc107c..be797d7a28f 100644
--- a/Documentation/git-format-patch.txt
+++ b/Documentation/git-format-patch.txt
@@ -18,7 +18,7 @@ SYNOPSIS
 		   [-n | --numbered | -N | --no-numbered]
 		   [--start-number <n>] [--numbered-files]
 		   [--in-reply-to=<message id>] [--suffix=.<sfx>]
-		   [--ignore-if-in-upstream]
+		   [--ignore-if-in-upstream] [--always]
 		   [--cover-from-description=<mode>]
 		   [--rfc] [--subject-prefix=<subject prefix>]
 		   [(--reroll-count|-v) <n>]
@@ -192,6 +192,10 @@ will want to ensure that threading is disabled for `git send-email`.
 	patches being generated, and any patch that matches is
 	ignored.
 
+--always::
+	Include patches for commits that do not introduce any change,
+	which are omitted by default.
+
 --cover-from-description=<mode>::
 	Controls which parts of the cover letter will be automatically
 	populated using the branch's description.

From patchwork Mon Nov 22 07:51:11 2021
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
X-Patchwork-Submitter: =?utf-8?b?5b6Q5rKb5paHIChBbGVlbik=?=
 <aleen42@vip.qq.com>
X-Patchwork-Id: 12631367
Return-Path: <git-owner@kernel.org>
X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on
	aws-us-west-2-korg-lkml-1.web.codeaurora.org
Received: from vger.kernel.org (vger.kernel.org [23.128.96.18])
	by smtp.lore.kernel.org (Postfix) with ESMTP id B11C1C433F5
	for <git@archiver.kernel.org>; Mon, 22 Nov 2021 07:51:25 +0000 (UTC)
Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand
        id S238735AbhKVHy3 (ORCPT <rfc822;git@archiver.kernel.org>);
        Mon, 22 Nov 2021 02:54:29 -0500
Received: from lindbergh.monkeyblade.net ([23.128.96.19]:40154 "EHLO
        lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org
        with ESMTP id S232708AbhKVHyW (ORCPT <rfc822;git@vger.kernel.org>);
        Mon, 22 Nov 2021 02:54:22 -0500
Received: from mail-wm1-x32f.google.com (mail-wm1-x32f.google.com
 [IPv6:2a00:1450:4864:20::32f])
        by lindbergh.monkeyblade.net (Postfix) with ESMTPS id D90D9C06173E
        for <git@vger.kernel.org>; Sun, 21 Nov 2021 23:51:15 -0800 (PST)
Received: by mail-wm1-x32f.google.com with SMTP id
 n33-20020a05600c502100b0032fb900951eso15879137wmr.4
        for <git@vger.kernel.org>; Sun, 21 Nov 2021 23:51:15 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=20210112;
        h=message-id:in-reply-to:references:from:date:subject:mime-version
         :content-transfer-encoding:fcc:to:cc;
        bh=V5v3qNOOtZ06Bh81SeFv9iyIBuuU+MIyIN/ckezrzLU=;
        b=NwoCYdO4mHuu4tyEY5acNmP9LC3I+eFO4viVOFdoYMpVa1XNjJ2tm0/XnqtObbsRIS
         /uIOoZZwYQK8V9whWEIMIx+vJREH3KOyMPZHO1aT6mDM12xkJEg6nPZLsVw9M4HDqqrp
         JFB0cqjHW/TpNGdrG1R7e7RhAbPZISy+z4MoieTvrfnb2qXAZwrLwUnHUV8Byf3NocPh
         TuewhzH9dKwleQMS052vV/9PTuBMmDeCT5eT2D/FQHRSw1FS4J7t7Kzs0Gtf6a9wbe+i
         3zIuSrkiApBgz3BvQ+lL99XFYmYKxdJx9fBZNpC6a7O+6Yyx63zjyvGwmIdU9Vv6YgZC
         xSXw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=1e100.net; s=20210112;
        h=x-gm-message-state:message-id:in-reply-to:references:from:date
         :subject:mime-version:content-transfer-encoding:fcc:to:cc;
        bh=V5v3qNOOtZ06Bh81SeFv9iyIBuuU+MIyIN/ckezrzLU=;
        b=BWKZVVEwhvJXyEGFhiOU8ZmCOJMFVH60MZau4/ErHJKF2FsexOZvtHJLzd8alGcJ5B
         2fWqx7wvVrxiBSEY2ANKdrshkpTBommtUE2sjlSRQItZdBArGqJek4znL2kl2Irs17dl
         EXyy0zWjtkbpArMSXbCjykwaL3ht6ffHYHNIwj8M36Any/k7ghcCvj5N1SMkolXTz93a
         6RDnlu+xUkJnxhfv3fRO6IlfZhTjx3rxAe0yAbUn9jVNIHiXEGuZcqYFFGjFjODWyzOu
         X9VxHTuuJ4GlgBRaq0Q3ZMUdo4wjnG+rA56+1/G0izfXfGtc0cJBKm+isHQVyyd9grEe
         cnag==
X-Gm-Message-State: AOAM531wvwhY9hqs+frFb+N6W0PStK9cha0okRZGWzJukKYGnFsOYGwq
        VXFHss3vz3OiZYMSqTNDH5gRrWRt3Rs=
X-Google-Smtp-Source: 
 ABdhPJzR+zL7AZ/T188VsQmXwLCmdMwCThUEoB2PkVzRWS5wppMpkO6vWdjBeJkg2E0uTgDHtRFDFg==
X-Received: by 2002:a05:600c:4fc3:: with SMTP id
 o3mr26790552wmq.147.1637567474036;
        Sun, 21 Nov 2021 23:51:14 -0800 (PST)
Received: from [127.0.0.1] ([13.74.141.28])
        by smtp.gmail.com with ESMTPSA id
 n15sm22651204wmq.38.2021.11.21.23.51.13
        (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
        Sun, 21 Nov 2021 23:51:13 -0800 (PST)
Message-Id: 
 <5025ad30ba7e4ebdec8a961d3f040b2038f98153.1637567471.git.gitgitgadget@gmail.com>
In-Reply-To: <pull.1076.v10.git.1637567471.gitgitgadget@gmail.com>
References: <pull.1076.v9.git.1637564554.gitgitgadget@gmail.com>
        <pull.1076.v10.git.1637567471.gitgitgadget@gmail.com>
Date: Mon, 22 Nov 2021 07:51:11 +0000
Subject: [PATCH v10 2/2] am: support --empty=<option> to handle empty patches
MIME-Version: 1.0
Fcc: Sent
To: git@vger.kernel.org
Cc: Aleen =?utf-8?b?5b6Q5rKb5paH?= <pwxu@coremail.cn>,
 Aleen <aleen42@vip.qq.com>, Aleen <aleen42@vip.qq.com>
Precedence: bulk
List-ID: <git.vger.kernel.org>
X-Mailing-List: git@vger.kernel.org
From: Aleen <aleen42@vip.qq.com>

From: Aleen <aleen42@vip.qq.com>

Since that the command 'git-format-patch' can include patches of
commits that emit no changes, the 'git-am' command should also
support an option, named as '--empty', to specify how to handle
those empty patches. In this commit, we have implemented three
valid options ('die', 'drop' and 'keep').

Signed-off-by: 徐沛文 (Aleen) <aleen42@vip.qq.com>
---
 Documentation/git-am.txt |  8 ++++++
 builtin/am.c             | 55 ++++++++++++++++++++++++++++++++++++----
 t/t4150-am.sh            | 49 +++++++++++++++++++++++++++++++++++
 3 files changed, 107 insertions(+), 5 deletions(-)

diff --git a/Documentation/git-am.txt b/Documentation/git-am.txt
index 0a4a984dfde..ba17063f621 100644
--- a/Documentation/git-am.txt
+++ b/Documentation/git-am.txt
@@ -16,6 +16,7 @@ SYNOPSIS
 	 [--exclude=<path>] [--include=<path>] [--reject] [-q | --quiet]
 	 [--[no-]scissors] [-S[<keyid>]] [--patch-format=<format>]
 	 [--quoted-cr=<action>]
+	 [--empty=(die|drop|keep)]
 	 [(<mbox> | <Maildir>)...]
 'git am' (--continue | --skip | --abort | --quit | --show-current-patch[=(diff|raw)])
 
@@ -63,6 +64,13 @@ OPTIONS
 --quoted-cr=<action>::
 	This flag will be passed down to 'git mailinfo' (see linkgit:git-mailinfo[1]).
 
+--empty=(die|drop|keep)::
+	By default, or when the option is set to 'die', the command
+	errors out on an input e-mail message that lacks a patch. When
+	this option is set to 'drop', skip such an e-mail message instead.
+	When this option is set to 'keep', create an empty commit,
+	recording the contents of the e-mail message as its log.
+
 -m::
 --message-id::
 	Pass the `-m` flag to 'git mailinfo' (see linkgit:git-mailinfo[1]),
diff --git a/builtin/am.c b/builtin/am.c
index 8677ea2348a..cc6512275aa 100644
--- a/builtin/am.c
+++ b/builtin/am.c
@@ -87,6 +87,12 @@ enum show_patch_type {
 	SHOW_PATCH_DIFF = 1,
 };
 
+enum empty_action {
+	DIE_EMPTY_COMMIT = 0,  /* output errors */
+	DROP_EMPTY_COMMIT,     /* skip with a notice message, unless "--quiet" has been passed */
+	KEEP_EMPTY_COMMIT      /* keep recording as empty commits */
+};
+
 struct am_state {
 	/* state directory path */
 	char *dir;
@@ -118,6 +124,7 @@ struct am_state {
 	int message_id;
 	int scissors; /* enum scissors_type */
 	int quoted_cr; /* enum quoted_cr_action */
+	int empty_type; /* enum empty_action */
 	struct strvec git_apply_opts;
 	const char *resolvemsg;
 	int committer_date_is_author_date;
@@ -178,6 +185,25 @@ static int am_option_parse_quoted_cr(const struct option *opt,
 	return 0;
 }
 
+static int am_option_parse_empty(const struct option *opt,
+				     const char *arg, int unset)
+{
+	int *opt_value = opt->value;
+
+	BUG_ON_OPT_NEG(unset);
+
+	if (!strcmp(arg, "die"))
+		*opt_value = DIE_EMPTY_COMMIT;
+	else if (!strcmp(arg, "drop"))
+		*opt_value = DROP_EMPTY_COMMIT;
+	else if (!strcmp(arg, "keep"))
+		*opt_value = KEEP_EMPTY_COMMIT;
+	else
+		return error(_("Invalid value for --empty: %s"), arg);
+
+	return 0;
+}
+
 /**
  * Returns path relative to the am_state directory.
  */
@@ -1248,11 +1274,6 @@ static int parse_mail(struct am_state *state, const char *mail)
 		goto finish;
 	}
 
-	if (is_empty_or_missing_file(am_path(state, "patch"))) {
-		printf_ln(_("Patch is empty."));
-		die_user_resolve(state);
-	}
-
 	strbuf_addstr(&msg, "\n\n");
 	strbuf_addbuf(&msg, &mi.log_message);
 	strbuf_stripspace(&msg, 0);
@@ -1763,6 +1784,7 @@ static void am_run(struct am_state *state, int resume)
 	while (state->cur <= state->last) {
 		const char *mail = am_path(state, msgnum(state));
 		int apply_status;
+		int to_keep;
 
 		reset_ident_date();
 
@@ -1792,8 +1814,27 @@ static void am_run(struct am_state *state, int resume)
 		if (state->interactive && do_interactive(state))
 			goto next;
 
+		to_keep = 0;
+		if (is_empty_or_missing_file(am_path(state, "patch"))) {
+			switch (state->empty_type) {
+			case DROP_EMPTY_COMMIT:
+				say(state, stdout, _("Skipping: %.*s"), linelen(state->msg), state->msg);
+				goto next;
+				break;
+			case KEEP_EMPTY_COMMIT:
+				to_keep = 1;
+				break;
+			case DIE_EMPTY_COMMIT:
+				printf_ln(_("Patch is empty."));
+				die_user_resolve(state);
+				break;
+			}
+		}
+
 		if (run_applypatch_msg_hook(state))
 			exit(1);
+		if (to_keep)
+			goto commit;
 
 		say(state, stdout, _("Applying: %.*s"), linelen(state->msg), state->msg);
 
@@ -1827,6 +1868,7 @@ static void am_run(struct am_state *state, int resume)
 			die_user_resolve(state);
 		}
 
+commit:
 		do_commit(state);
 
 next:
@@ -2357,6 +2399,9 @@ int cmd_am(int argc, const char **argv, const char *prefix)
 		{ OPTION_STRING, 'S', "gpg-sign", &state.sign_commit, N_("key-id"),
 		  N_("GPG-sign commits"),
 		  PARSE_OPT_OPTARG, NULL, (intptr_t) "" },
+		OPT_CALLBACK_F(0, "empty", &state.empty_type, "{drop,keep,die}",
+		  N_("how to handle empty patches"),
+		  PARSE_OPT_NONEG, am_option_parse_empty),
 		OPT_HIDDEN_BOOL(0, "rebasing", &state.rebasing,
 			N_("(internal use for git-rebase)")),
 		OPT_END()
diff --git a/t/t4150-am.sh b/t/t4150-am.sh
index 2aaaa0d7ded..8c8bd4db220 100755
--- a/t/t4150-am.sh
+++ b/t/t4150-am.sh
@@ -196,6 +196,12 @@ test_expect_success setup '
 
 	git format-patch -M --stdout lorem^ >rename-add.patch &&
 
+	git checkout -b empty-commit &&
+	git commit -m "empty commit" --allow-empty &&
+
+	: >empty.patch &&
+	git format-patch --always --stdout empty-commit^ >empty-commit.patch &&
+
 	# reset time
 	sane_unset test_tick &&
 	test_tick
@@ -1152,4 +1158,47 @@ test_expect_success 'apply binary blob in partial clone' '
 	git -C client am ../patch
 '
 
+test_expect_success 'an empty input file is error regardless of --empty option' '
+	test_when_finished "git am --abort || :" &&
+	test_must_fail git am --empty=drop empty.patch 2>actual &&
+	echo "Patch format detection failed." >expected &&
+	test_cmp expected actual
+'
+
+test_expect_success 'invalid when passing the --empty option alone' '
+	test_when_finished "git am --abort || :" &&
+	git checkout empty-commit^ &&
+	test_must_fail git am --empty empty-commit.patch 2>err &&
+	echo "error: Invalid value for --empty: empty-commit.patch" >expected &&
+	test_cmp expected err
+'
+
+test_expect_success 'a message without a patch is an error (default)' '
+	test_when_finished "git am --abort || :" &&
+	test_must_fail git am empty-commit.patch >err &&
+	grep "Patch is empty" err
+'
+
+test_expect_success 'a message without a patch is an error where an explicit "--empty=die" is given' '
+	test_when_finished "git am --abort || :" &&
+	test_must_fail git am --empty=die empty-commit.patch >err &&
+	grep "Patch is empty." err
+'
+
+test_expect_success 'a message without a patch will be skipped when "--empty=drop" is given' '
+	git am --empty=drop empty-commit.patch >output &&
+	git rev-parse empty-commit^ >expected &&
+	git rev-parse HEAD >actual &&
+	test_cmp expected actual &&
+	grep "Skipping: empty commit" output
+'
+
+test_expect_success 'record as an empty commit when meeting e-mail message that lacks a patch' '
+	git am --empty=keep empty-commit.patch &&
+	test_path_is_missing .git/rebase-apply &&
+	git show empty-commit --format="%s" >expected &&
+	git show HEAD --format="%s" >actual &&
+	test_cmp actual expected
+'
+
 test_done