# [PATCH] t0000: check whether the shell supports the "local" keyword 6 messages from 2017-10-26 to 2017-10-30. Participants: Michael Haggerty, Eric Sunshine, Jacob Keller, Junio C Hamano, Jeff King. Thread: https://gitlist.dev/t/47032 ## Michael Haggerty, 2017-10-26 08:18 Subject: [PATCH] t0000: check whether the shell supports the "local" keyword Message-ID: <6ecab31e7ed05f5e79ecd454b133a2bfa6ac9ab7.1509005669.git.mhagger@alum.mit.edu> URL: https://gitlist.dev/e/6ecab31e7ed05f5e79ecd454b133a2bfa6ac9ab7.1509005669.git.mhagger%40alum.mit.edu ``` Add a test balloon to see if we get complaints from anybody who is using a shell that doesn't support the "local" keyword. If so, this test can be reverted. If not, we might want to consider using "local" in shell code throughout the git code base. Signed-off-by: Michael Haggerty --- This has been discussed on the mailing list [1,2]. Michael [1] https://public-inbox.org/git/CAPig+cRLB=dGD=+Af=yYL3M709LRpeUrtvcDLo9iBKYy2HAW-w@mail.gmail.com/ [2] https://public-inbox.org/git/20160601163747.GA10721@sigill.intra.peff.net/ t/t0000-basic.sh | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/t/t0000-basic.sh b/t/t0000-basic.sh index 1aa5093f36..7fd87dd544 100755 --- a/t/t0000-basic.sh +++ b/t/t0000-basic.sh @@ -20,6 +20,31 @@ modification *should* take notice and update the test vectors here. . ./test-lib.sh +try_local_x () { + local x="local" && + echo "$x" +} + +# This test is an experiment to check whether any Git users are using +# Shells that don't support the "local" keyword. "local" is not +# POSIX-standard, but it is very widely supported by POSIX-compliant +# shells, and if it doesn't cause problems for people, we would like +# to be able to use it in Git code. +# +# For now, this is the only test that requires "local". If your shell +# fails this test, you can ignore the failure, but please report the +# problem to the Git mailing list , as it might +# convince us to continue avoiding the use of "local". +test_expect_success 'verify that the running shell supports "local"' ' + x="notlocal" && + echo "local" >expected1 && + try_local_x >actual1 && + test_cmp expected1 actual1 && + echo "notlocal" >expected2 && + echo "$x" >actual2 && + test_cmp expected2 actual2 +' + ################################################################ # git init has been done in an empty repository. # make sure it is empty. -- 2.14.1 ``` ## Eric Sunshine, 2017-10-26 08:28 Subject: Re: [PATCH] t0000: check whether the shell supports the "local" keyword Message-ID: URL: https://gitlist.dev/e/CAPig%2BcTv4YW0m0PLH%2BUucEHjgQkbCsOunPrkKVDrPQXNkd%3DGAg%40mail.gmail.com In-Reply-To: <6ecab31e7ed05f5e79ecd454b133a2bfa6ac9ab7.1509005669.git.mhagger@alum.mit.edu> ``` On Thu, Oct 26, 2017 at 4:18 AM, Michael Haggerty wrote: > Add a test balloon to see if we get complaints from anybody who is > using a shell that doesn't support the "local" keyword. If so, this > test can be reverted. If not, we might want to consider using "local" > in shell code throughout the git code base. I would guess that the number of people who actually run the Git test suite is microscopic compared to the number of people who use Git itself. It is not clear, therefore, that lack of reports of failure of the new test would imply that "local" can safely be used throughout the Git code base. At best, it might indicate that "local" can be used in the tests. Or, am I missing something? > Signed-off-by: Michael Haggerty > --- > This has been discussed on the mailing list [1,2]. > > Michael > > [1] https://public-inbox.org/git/CAPig+cRLB=dGD=+Af=yYL3M709LRpeUrtvcDLo9iBKYy2HAW-w@mail.gmail.com/ > [2] https://public-inbox.org/git/20160601163747.GA10721@sigill.intra.peff.net/ > > t/t0000-basic.sh | 25 +++++++++++++++++++++++++ > 1 file changed, 25 insertions(+) > > diff --git a/t/t0000-basic.sh b/t/t0000-basic.sh > index 1aa5093f36..7fd87dd544 100755 > --- a/t/t0000-basic.sh > +++ b/t/t0000-basic.sh > @@ -20,6 +20,31 @@ modification *should* take notice and update the test vectors here. > > . ./test-lib.sh > > +try_local_x () { > + local x="local" && > + echo "$x" > +} > + > +# This test is an experiment to check whether any Git users are using > +# Shells that don't support the "local" keyword. "local" is not > +# POSIX-standard, but it is very widely supported by POSIX-compliant > +# shells, and if it doesn't cause problems for people, we would like > +# to be able to use it in Git code. > +# > +# For now, this is the only test that requires "local". If your shell > +# fails this test, you can ignore the failure, but please report the > +# problem to the Git mailing list , as it might > +# convince us to continue avoiding the use of "local". > +test_expect_success 'verify that the running shell supports "local"' ' > + x="notlocal" && > + echo "local" >expected1 && > + try_local_x >actual1 && > + test_cmp expected1 actual1 && > + echo "notlocal" >expected2 && > + echo "$x" >actual2 && > + test_cmp expected2 actual2 > +' > + > ################################################################ > # git init has been done in an empty repository. > # make sure it is empty. > -- > 2.14.1 ``` ## Jacob Keller, 2017-10-26 08:40 Subject: Re: [PATCH] t0000: check whether the shell supports the "local" keyword Message-ID: URL: https://gitlist.dev/e/CA%2BP7%2BxoCKTaG9kV2T9YUHvagHVzD6v7A%3DneLzF3Qj1q8Fi0u-w%40mail.gmail.com In-Reply-To: ``` On Thu, Oct 26, 2017 at 1:28 AM, Eric Sunshine wrote: > On Thu, Oct 26, 2017 at 4:18 AM, Michael Haggerty wrote: >> Add a test balloon to see if we get complaints from anybody who is >> using a shell that doesn't support the "local" keyword. If so, this >> test can be reverted. If not, we might want to consider using "local" >> in shell code throughout the git code base. > > I would guess that the number of people who actually run the Git test > suite is microscopic compared to the number of people who use Git > itself. It is not clear, therefore, that lack of reports of failure of > the new test would imply that "local" can safely be used throughout > the Git code base. At best, it might indicate that "local" can be used > in the tests. > > Or, am I missing something? > I don't think you're missing anything. I think the idea here is: "do any users who actively run the test suite care if we start using local". I don't think the goal is to allow use of local in non-test suite code. At least, that's not how I interpreted it. Thus it's fine to be only as part of a test and see if anyone complains, since the only people affected would be those which actually run the test suite... Changing our requirement for regular shell scripts we ship seems a lot trickier to gauge. Thanks, Jake ``` ## Michael Haggerty, 2017-10-26 08:47 Subject: Re: [PATCH] t0000: check whether the shell supports the "local" keyword Message-ID: <9a900b29-0974-9ec8-d15b-73c22c197327@alum.mit.edu> URL: https://gitlist.dev/e/9a900b29-0974-9ec8-d15b-73c22c197327%40alum.mit.edu In-Reply-To: ``` On 10/26/2017 10:40 AM, Jacob Keller wrote: > On Thu, Oct 26, 2017 at 1:28 AM, Eric Sunshine wrote: >> On Thu, Oct 26, 2017 at 4:18 AM, Michael Haggerty wrote: >>> Add a test balloon to see if we get complaints from anybody who is >>> using a shell that doesn't support the "local" keyword. If so, this >>> test can be reverted. If not, we might want to consider using "local" >>> in shell code throughout the git code base. >> >> I would guess that the number of people who actually run the Git test >> suite is microscopic compared to the number of people who use Git >> itself. It is not clear, therefore, that lack of reports of failure of >> the new test would imply that "local" can safely be used throughout >> the Git code base. At best, it might indicate that "local" can be used >> in the tests. >> >> Or, am I missing something? >> > > I don't think you're missing anything. I think the idea here is: "do > any users who actively run the test suite care if we start using > local". I don't think the goal is to allow use of local in non-test > suite code. At least, that's not how I interpreted it. > > Thus it's fine to be only as part of a test and see if anyone > complains, since the only people affected would be those which > actually run the test suite... > > Changing our requirement for regular shell scripts we ship seems a lot > trickier to gauge. Actually, I would hope that if this experiment is successful that we can use "local" in production code, too. The proper question isn't "what fraction of Git users run the test suite?", because I agree with Eric that that is microscopic. The correct question is "on what fraction of platforms where Git will be run has the test suite been run by *somebody*?", and I think (I hope!) that that fraction is quite high. Really...if you are compiling Git on a platform that is so deviant or archaic that it doesn't have a reasonable Shell, and you don't even bother running the test suite, you kindof deserve your fate, don't you? Michael ``` ## Junio C Hamano, 2017-10-27 01:15 Subject: Re: [PATCH] t0000: check whether the shell supports the "local" keyword Message-ID: URL: https://gitlist.dev/e/xmqqd159e6go.fsf%40gitster.mtv.corp.google.com In-Reply-To: ``` Jacob Keller writes: > I don't think you're missing anything. I think the idea here is: "do > any users who actively run the test suite care if we start using > local". I don't think the goal is to allow use of local in non-test > suite code. At least, that's not how I interpreted it. > > Thus it's fine to be only as part of a test and see if anyone > complains, since the only people affected would be those which > actually run the test suite... > > Changing our requirement for regular shell scripts we ship seems a lot > trickier to gauge. Yup, that matches my expectations for what we would gain out of this change. ``` ## Jeff King, 2017-10-30 17:39 Subject: Re: [PATCH] t0000: check whether the shell supports the "local" keyword Message-ID: <20171030173941.bye4vyi3jmkzxfr5@sigill.intra.peff.net> URL: https://gitlist.dev/e/20171030173941.bye4vyi3jmkzxfr5%40sigill.intra.peff.net In-Reply-To: <6ecab31e7ed05f5e79ecd454b133a2bfa6ac9ab7.1509005669.git.mhagger@alum.mit.edu> ``` On Thu, Oct 26, 2017 at 10:18:53AM +0200, Michael Haggerty wrote: > Add a test balloon to see if we get complaints from anybody who is > using a shell that doesn't support the "local" keyword. If so, this > test can be reverted. If not, we might want to consider using "local" > in shell code throughout the git code base. > > Signed-off-by: Michael Haggerty > --- > This has been discussed on the mailing list [1,2]. Thanks for following up, this looks nice and thorough to me. -Peff ```