From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: AS31976 209.132.180.0/23 X-Spam-Status: No, score=-4.1 required=3.0 tests=AWL,BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by dcvr.yhbt.net (Postfix) with ESMTP id 74E6220A1E for ; Fri, 14 Dec 2018 18:44:43 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1730648AbeLNSom convert rfc822-to-8bit (ORCPT ); Fri, 14 Dec 2018 13:44:42 -0500 Received: from wp156.webpack.hosteurope.de ([80.237.132.163]:37932 "EHLO wp156.webpack.hosteurope.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1730322AbeLNSom (ORCPT ); Fri, 14 Dec 2018 13:44:42 -0500 Received: from app13-neu.ox.hosteurope.de ([92.51.170.147]); authenticated by wp156.webpack.hosteurope.de running ExIM with esmtpsa (TLS1.0:ECDHE_RSA_AES_256_CBC_SHA1:256) id 1gXsRv-0000IY-OG; Fri, 14 Dec 2018 19:44:36 +0100 Date: Fri, 14 Dec 2018 19:44:35 +0100 (CET) From: Thomas Braun To: =?UTF-8?Q?=C3=86var_Arnfj=C3=B6r=C3=B0_Bjarmason?= Cc: git@vger.kernel.org, gitster@pobox.com, peff@peff.net, sbeller@google.com Message-ID: <448171361.95154.1544813075679@ox.hosteurope.de> In-Reply-To: <87a7ltz7jh.fsf@evledraar.gmail.com> References: <1535679074.141165.1542834055343@ox.hosteurope.de> <87a7ltz7jh.fsf@evledraar.gmail.com> Subject: Re: [PATCH v2] log -G: Ignore binary files MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8BIT X-Priority: 3 Importance: Medium X-Mailer: Open-Xchange Mailer v7.8.4-Rev47 X-Originating-Client: open-xchange-appsuite X-bounce-key: webpack.hosteurope.de;thomas.braun@virtuell-zuhause.de;1544813080;4b2eb13a; X-HE-SMSGID: 1gXsRv-0000IY-OG Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org > Ævar Arnfjörð Bjarmason hat am 28. November 2018 um 13:54 geschrieben: > > > > On Wed, Nov 28 2018, Thomas Braun wrote: > > Looks much better this time around. Thanks. > > The -G option of log looks for the differences whose patch text > > contains added/removed lines that match regex. > > > > As the concept of patch text only makes sense for text files, we need to > > ignore binary files when searching with -G as well. > > > > The -S option of log looks for differences that changes > > the number of occurrences of the specified block of text (i.e. > > addition/deletion) in a file. As we want to keep the current behaviour, > > add a test to ensure it. > > [...] > > diff --git a/Documentation/gitdiffcore.txt b/Documentation/gitdiffcore.txt > > index c0a60f3158..059ddd3431 100644 > > --- a/Documentation/gitdiffcore.txt > > +++ b/Documentation/gitdiffcore.txt > > @@ -242,7 +242,7 @@ textual diff has an added or a deleted line that matches the given > > regular expression. This means that it will detect in-file (or what > > rename-detection considers the same file) moves, which is noise. The > > implementation runs diff twice and greps, and this can be quite > > -expensive. > > +expensive. Binary files without textconv filter are ignored. > > Now that we support --text that should be documented. I tried to come up > with something on top: > > diff --git a/Documentation/diff-options.txt b/Documentation/diff-options.txt > index 0378cd574e..42ae65fb57 100644 > --- a/Documentation/diff-options.txt > +++ b/Documentation/diff-options.txt > @@ -524,6 +524,10 @@ struct), and want to know the history of that block since it first > came into being: use the feature iteratively to feed the interesting > block in the preimage back into `-S`, and keep going until you get the > very first version of the block. > ++ > +Unlike `-G` the `-S` option will always search through binary files > +without a textconv filter. [[TODO: Don't we want to support --no-text > +then as an optimization?]]. > > -G:: > Look for differences whose patch text contains added/removed > @@ -545,6 +549,15 @@ occurrences of that string did not change). > + > See the 'pickaxe' entry in linkgit:gitdiffcore[7] for more > information. > ++ > +Unless `--text` is supplied binary files without a textconv filter > +will be ignored. This was not the case before Git version 2.21.. > ++ > +With `--text`, instead of patch lines we +above diff showing what we actually do for binary files. [[TODO: How > +does that work?. Could just link to the "diffcore-pickaxe: For > +Detecting Addition/Deletion of Specified String" section in > +gitdiffcore(7) which could explain it]] > > --find-object=:: > Look for differences that change the number of occurrences of > diff --git a/Documentation/gitdiffcore.txt b/Documentation/gitdiffcore.txt > index c0a60f3158..26880b4149 100644 > --- a/Documentation/gitdiffcore.txt > +++ b/Documentation/gitdiffcore.txt > @@ -251,6 +251,10 @@ criterion in a changeset, the entire changeset is kept. This behavior > is designed to make reviewing changes in the context of the whole > changeset easier. > > +Both `-S' and `-G' will ignore binary files without a textconv filter > +by default, this can be overriden with `--text`. With `--text` the > +binary patch we look through is generated as [[TODO: ???]]. > + > diffcore-order: For Sorting the Output Based on Filenames > --------------------------------------------------------- > > But as you can see given the TODO comments I don't know how this works > exactly. I *could* dig, but that's my main outstanding problem with this > patch, the commit message / docs aren't being updated to reflect the new > behavior. v3 will have some more documentation which took inspiration by your sketches here. I've not included a reference to the git version 2.21 in which that patch will hopefully land as that seems to be not common in the documentation. I see tweaking the behaviour of -S outside of this patch series. > I.e. let's leave the docs in some state where the reader can as > unambiguously know what to expect with -G and these binary diffs we've > been implicitly supporting as with the textual diffs. Ideally with some > examples of how to generate them (re my question about the base85 output > in v1). > > Part of that's obviously behavior we've had all along, but it's much > more convincing to say: > > We are changing X which we've done for ages, it works exactly like > this, and here's a switch to get it back. > > Instead of: > > X doesn't make sense, let's turn it off. > > Also the diffcore docs already say stuff about how slow/fast things are, > and in a side-thread you said: > > My main motiviation is to speed up "log -G" as that takes a > considerable amount of time when it wades through MBs of binary > files which change often. > > Makes sense, but then let's say something about that in that section of > the docs. Done. > > When `-S` or `-G` are used without `--pickaxe-all`, only filepairs > > that match their respective criterion are kept in the output. When > > diff --git a/diffcore-pickaxe.c b/diffcore-pickaxe.c > > index 69fc55ea1e..4cea086f80 100644 > > --- a/diffcore-pickaxe.c > > +++ b/diffcore-pickaxe.c > > @@ -154,6 +154,12 @@ static int pickaxe_match(struct diff_filepair *p, struct diff_options *o, > > if (textconv_one == textconv_two && diff_unmodified_pair(p)) > > return 0; > > > > + if ((o->pickaxe_opts & DIFF_PICKAXE_KIND_G) && > > + !o->flags.text && > > + ((!textconv_one && diff_filespec_is_binary(o->repo, p->one)) || > > + (!textconv_two && diff_filespec_is_binary(o->repo, p->two)))) > > + return 0; > > + > > mf1.size = fill_textconv(o->repo, textconv_one, p->one, &mf1.ptr); > > mf2.size = fill_textconv(o->repo, textconv_two, p->two, &mf2.ptr); > > > > diff --git a/t/t4209-log-pickaxe.sh b/t/t4209-log-pickaxe.sh > > index 844df760f7..5c3e2a16b2 100755 > > --- a/t/t4209-log-pickaxe.sh > > +++ b/t/t4209-log-pickaxe.sh > > @@ -106,4 +106,44 @@ test_expect_success 'log -S --no-textconv (missing textconv tool)' ' > > rm .gitattributes > > ' > > > > +test_expect_success 'log -G ignores binary files' ' > > + git checkout --orphan orphan1 && > > + printf "a\0a" >data.bin && > > + git add data.bin && > > + git commit -m "message" && > > + git log -Ga >result && > > + test_must_be_empty result > > +' > > + > > +test_expect_success 'log -G looks into binary files with -a' ' > > + git checkout --orphan orphan2 && > > + printf "a\0a" >data.bin && > > + git add data.bin && > > + git commit -m "message" && > > + git log -a -Ga >actual && > > + git log >expected && > > + test_cmp actual expected > > +' > > A large part of the question(s) I have above & future readers would > presumably have would be answered by these tests using more realistic > test data. I.e. also with \n in there to see whether -G is also > line-based in this binary case. > > > +test_expect_success 'log -G looks into binary files with textconv filter' ' > > + git checkout --orphan orphan3 && > > + echo "* diff=bin" > .gitattributes && > > + printf "a\0a" >data.bin && > > + git add data.bin && > > + git commit -m "message" && > > + git -c diff.bin.textconv=cat log -Ga >actual && > > + git log >expected && > > + test_cmp actual expected > > +' > > + > > +test_expect_success 'log -S looks into binary files' ' > > + git checkout --orphan orphan4 && > > + printf "a\0a" >data.bin && > > + git add data.bin && > > + git commit -m "message" && > > + git log -Sa >actual && > > + git log >expected && > > + test_cmp actual expected > > +' > > + > > test_done Done. > These tests have way to much repeated boilerplate for no reason. This > could just be (as-is, without the better test data suggested above): > > diff --git a/t/t4209-log-pickaxe.sh b/t/t4209-log-pickaxe.sh > index 844df760f7..23ed6cc4b1 100755 > --- a/t/t4209-log-pickaxe.sh > +++ b/t/t4209-log-pickaxe.sh > @@ -106,4 +106,34 @@ test_expect_success 'log -S --no-textconv (missing textconv tool)' ' > rm .gitattributes > ' > > +test_expect_success 'setup log -[GS] binary & --text' ' > + git checkout --orphan GS-binary-and-text && > + printf "a\0a" >data.bin && > + git add data.bin && > + git commit -m "message" && > + git log >full-log > +' > + > +test_expect_success 'log -G ignores binary files' ' > + git log -Ga >result && > + test_must_be_empty result > +' > + > +test_expect_success 'log -G looks into binary files with -a' ' > + git log -a -Ga >actual && > + test_cmp actual full-log > +' > + > +test_expect_success 'log -G looks into binary files with textconv filter' ' > + echo "* diff=bin" >.gitattributes && > + git -c diff.bin.textconv=cat log -Ga >actual && > + test_cmp actual full-log > +' > + > +test_expect_success 'log -S looks into binary files' ' > + >.gitattributes && > + git log -Sa >actual && > + test_cmp actual full-log > +' > + > test_done Thanks for pointer. This is resolved in v3 as well. I'm not used to test cases which depend on each other but your are totally right. Thanks for the review.