From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: X-Spam-Status: No, score=-4.3 required=3.0 tests=AWL,BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI,SPF_HELO_NONE,SPF_PASS shortcircuit=no autolearn=ham autolearn_force=no version=3.4.6 Received: from out1.vger.email (out1.vger.email [IPv6:2620:137:e000::1:20]) by dcvr.yhbt.net (Postfix) with ESMTP id 055251F428 for ; Fri, 24 Mar 2023 01:05:13 +0000 (UTC) Authentication-Results: dcvr.yhbt.net; dkim=pass (2048-bit key; unprotected) header.d=intel.com header.i=@intel.com header.a=rsa-sha256 header.s=Intel header.b=ggibGRQG; dkim-atps=neutral Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229849AbjCXBFJ (ORCPT ); Thu, 23 Mar 2023 21:05:09 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:60760 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229499AbjCXBFH (ORCPT ); Thu, 23 Mar 2023 21:05:07 -0400 Received: from mga12.intel.com (mga12.intel.com [192.55.52.136]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 664E13A8F for ; Thu, 23 Mar 2023 18:05:06 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1679619906; x=1711155906; h=from:to:cc:subject:date:message-id:mime-version: content-transfer-encoding; bh=VQlCDMCGJZqbX9xqGq8jvJghlP6VjwY4hDAPQArs1D0=; b=ggibGRQG3CPCWVP3NFA4Q3eDGNHG0yt07whBsJf21NHVw6xOFHD1WSKA m8Hu5zOOUZ5OHI36xVoHym22+5FRGHGTZVxmbZnEanvv1xQ7wasgTUhIl Ytaao01APzbXI1RBc29VDk+S5sz1e3JumdHWVH2FY0qctD4ginWfZhj5z 49j2laj4B3u66ME94Yvw9O2rw4MKtpxrYpGFe0zy/3rNCAzAEBsYUQeEi eLKOW+sCILFLumPrjrrhEdRgO+e5L0R/Ldc3qH5/vk7Ax3YrZ+ovEvCsk SFMPd5bcKgmux5Bce/tOZIYydO2EtCNq82wIZpO7FoKKhXzvmE/ZFfWA/ Q==; X-IronPort-AV: E=McAfee;i="6600,9927,10658"; a="319325228" X-IronPort-AV: E=Sophos;i="5.98,286,1673942400"; d="scan'208";a="319325228" Received: from orsmga002.jf.intel.com ([10.7.209.21]) by fmsmga106.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 23 Mar 2023 18:05:06 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10658"; a="682500964" X-IronPort-AV: E=Sophos;i="5.98,286,1673942400"; d="scan'208";a="682500964" Received: from jekeller-desk.amr.corp.intel.com (HELO jekeller-desk.jekeller.internal) ([10.166.241.1]) by orsmga002-auth.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 23 Mar 2023 18:05:04 -0700 From: Jacob Keller To: Junio C Hamano , git@vger.kernel.org Cc: Jacob Keller Subject: [PATCH] blame: allow --contents to work with non-HEAD commit Date: Thu, 23 Mar 2023 18:04:57 -0700 Message-Id: <20230324010457.275902-1-jacob.e.keller@intel.com> X-Mailer: git-send-email 2.40.0.131.g970374df36d8 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org From: Jacob Keller The --contents option can be used with git blame to blame the file as if it had the contents from the specified file. This is akin to copying the contents into the working tree and then running git blame. This option has been supported since 1cfe77333f27 ("git-blame: no rev means start from the working tree file.") The --contents option always blames the file as if it was based on the current HEAD commit. If you try to pass a revision while using --contents, you get the following error: fatal: cannot use --contents with final commit object name This is because the blame process generates a fake working tree commit which always uses the HEAD object. Fix fake_working_tree_commit to take the object ID to use for the parent instead of always using HEAD. If both a revision and --contents is provided, look up the object ID from the provided revision instead of using HEAD. This enables use of --contents with an arbitrary revision, rather than forcing the use of the local HEAD commit. This makes the --contents option significantly more flexible. Reword the documentation so that its clear that --contents can be used with . Add tests for the --contents option to the annotate-tests.sh test script. Signed-off-by: Jacob Keller --- I ran into this because I use --contents in a process I'm working on for comparing differences between two forks of a project. I use blame --contents where I point blame to the contents from the other repository. It is useful to be able to do with at arbitrary commits. Currently I have to switch the working tree to the commit rather than being able to target a commit by its oid. With this change I can more easily run this process without the need to actually check the contents out in the working tree. Its relatively simple to make --contents work with a revision, since I just need to generate the fake contents starting from that revision instead of starting from HEAD. This might make it possible for --contents to work with --reverse now as well, but I haven't investigated that. Documentation/blame-options.txt | 9 ++++----- blame.c | 27 ++++++++++++++++----------- t/annotate-tests.sh | 14 ++++++++++++++ 3 files changed, 34 insertions(+), 16 deletions(-) diff --git a/Documentation/blame-options.txt b/Documentation/blame-options.txt index 9a663535f443..6476dd327377 100644 --- a/Documentation/blame-options.txt +++ b/Documentation/blame-options.txt @@ -64,11 +64,10 @@ include::line-range-format.txt[] manual page. --contents :: - When is not specified, the command annotates the - changes starting backwards from the working tree copy. - This flag makes the command pretend as if the working - tree copy has the contents of the named file (specify - `-` to make the command read from the standard input). + Pretend the file being annotated has the contents from the named + file instead of using the contents of or the working tree + copy. You may specify '-' to make the command read from standard + input for the file contents. --date :: Specifies the format used to output dates. If --date is not diff --git a/blame.c b/blame.c index e45d8a3bf92a..52fca5a7f5b7 100644 --- a/blame.c +++ b/blame.c @@ -177,12 +177,12 @@ static void set_commit_buffer_from_strbuf(struct repository *r, static struct commit *fake_working_tree_commit(struct repository *r, struct diff_options *opt, const char *path, - const char *contents_from) + const char *contents_from, + struct object_id *oid) { struct commit *commit; struct blame_origin *origin; struct commit_list **parent_tail, *parent; - struct object_id head_oid; struct strbuf buf = STRBUF_INIT; const char *ident; time_t now; @@ -198,10 +198,7 @@ static struct commit *fake_working_tree_commit(struct repository *r, commit->date = now; parent_tail = &commit->parents; - if (!resolve_ref_unsafe("HEAD", RESOLVE_REF_READING, &head_oid, NULL)) - die("no such ref: HEAD"); - - parent_tail = append_parent(r, parent_tail, &head_oid); + parent_tail = append_parent(r, parent_tail, oid); append_merge_parents(r, parent_tail); verify_working_tree_path(r, commit, path); @@ -2772,22 +2769,30 @@ void setup_scoreboard(struct blame_scoreboard *sb, sb->commits.compare = compare_commits_by_reverse_commit_date; } - if (sb->final && sb->contents_from) - die(_("cannot use --contents with final commit object name")); - if (sb->reverse && sb->revs->first_parent_only) sb->revs->children.name = NULL; - if (!sb->final) { + if (sb->contents_from || !sb->final) { + struct object_id head_oid, *parent_oid; + /* * "--not A B -- path" without anything positive; * do not default to HEAD, but use the working tree * or "--contents". */ + if (sb->final) { + parent_oid = &sb->final->object.oid; + } else { + if (!resolve_ref_unsafe("HEAD", RESOLVE_REF_READING, &head_oid, NULL)) + die("no such ref: HEAD"); + parent_oid = &head_oid; + } + setup_work_tree(); sb->final = fake_working_tree_commit(sb->repo, &sb->revs->diffopt, - sb->path, sb->contents_from); + sb->path, sb->contents_from, + parent_oid); add_pending_object(sb->revs, &(sb->final->object), ":"); } diff --git a/t/annotate-tests.sh b/t/annotate-tests.sh index f1b9a6ce4dae..b35be20cf327 100644 --- a/t/annotate-tests.sh +++ b/t/annotate-tests.sh @@ -72,6 +72,16 @@ test_expect_success 'blame 1 author' ' check_count A 2 ' +test_expect_success 'blame with --contents' ' + check_count --contents=file A 2 +' + +test_expect_success 'blame with --contents changed' ' + echo "1A quick brown fox jumps over the" >contents && + echo "another lazy dog" >>contents && + check_count --contents=contents A 1 "Not Committed Yet" 1 +' + test_expect_success 'blame in a bare repo without starting commit' ' git clone --bare . bare.git && ( @@ -98,6 +108,10 @@ test_expect_success 'blame 2 authors' ' check_count A 2 B 2 ' +test_expect_success 'blame with --contents and revision' ' + check_count -h testTag --contents=file A 2 "Not Committed Yet" 2 +' + test_expect_success 'setup B1 lines (branch1)' ' git checkout -b branch1 main && echo "3A slow green fox jumps into the" >>file && -- 2.40.0.131.g970374df36d8