mirror of
https://github.com/git/git
synced 2024-08-27 11:39:22 +00:00
![Elijah Newren](/assets/img/avatar_default.png)
do_match_pathspec() started life as match_pathspec_depth_1() and for correctness was only supposed to be called from match_pathspec_depth(). match_pathspec_depth() was later renamed to match_pathspec(), so the invariant we expect today is that do_match_pathspec() has no direct callers outside of match_pathspec(). Unfortunately, this intention was lost with the renames of the two functions, and additional calls to do_match_pathspec() were added in commits75a6315f74
("ls-files: add pathspec matching for submodules", 2016-10-07) and89a1f4aaf7
("dir: if our pathspec might match files under a dir, recurse into it", 2019-09-17). Of course, do_match_pathspec() had an important advantge over match_pathspec() -- match_pathspec() would hardcode flags to one of two values, and these new callers needed to pass some other value for flags. Also, although calling do_match_pathspec() directly was incorrect, there likely wasn't any difference in the observable end output, because the bug just meant that fill_diretory() would recurse into unneeded directories. Since subsequent does-this-path-match checks on individual paths under the directory would cause those extra paths to be filtered out, the only difference from using the wrong function was unnecessary computation. The second of those bad calls to do_match_pathspec() was involved -- via either direct movement or via copying+editing -- into a number of later refactors. See commits777b420347
("dir: synchronize treat_leading_path() and read_directory_recursive()", 2019-12-19),8d92fb2927
("dir: replace exponential algorithm with a linear one", 2020-04-01), and95c11ecc73
("Fix error-prone fill_directory() API; make it only return matches", 2020-04-01). The last of those introduced the usage of do_match_pathspec() on an individual file, and thus resulted in individual paths being returned that shouldn't be. The problem with calling do_match_pathspec() instead of match_pathspec() is that any negated patterns such as ':!unwanted_path` will be ignored. Add a new match_pathspec_with_flags() function to fulfill the needs of specifying special flags while still correctly checking negated patterns, add a big comment above do_match_pathspec() to prevent others from misusing it, and correct current callers of do_match_pathspec() to instead use either match_pathspec() or match_pathspec_with_flags(). One final note is that DO_MATCH_LEADING_PATHSPEC needs special consideration when working with DO_MATCH_EXCLUDE. The point of DO_MATCH_LEADING_PATHSPEC is that if we have a pathspec like */Makefile and we are checking a directory path like src/module/component that we want to consider it a match so that we recurse into the directory because it _might_ have a file named Makefile somewhere below. However, when we are using an exclusion pattern, i.e. we have a pathspec like :(exclude)*/Makefile we do NOT want to say that a directory path like src/module/component is a (negative) match. While there *might* be a file named 'Makefile' somewhere below that directory, there could also be other files and we cannot pre-emptively rule all the files under that directory out; we need to recurse and then check individual files. Adjust the DO_MATCH_LEADING_PATHSPEC logic to only get activated for positive pathspecs. Reported-by: John Millikin <jmillikin@stripe.com> Signed-off-by: Elijah Newren <newren@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
248 lines
4.8 KiB
Bash
Executable file
248 lines
4.8 KiB
Bash
Executable file
#!/bin/sh
|
|
|
|
test_description='test case exclude pathspec'
|
|
|
|
. ./test-lib.sh
|
|
|
|
test_expect_success 'setup' '
|
|
for p in file sub/file sub/sub/file sub/file2 sub/sub/sub/file sub2/file; do
|
|
if echo $p | grep /; then
|
|
mkdir -p $(dirname $p)
|
|
fi &&
|
|
: >$p &&
|
|
git add $p &&
|
|
git commit -m $p
|
|
done &&
|
|
git log --oneline --format=%s >actual &&
|
|
cat <<EOF >expect &&
|
|
sub2/file
|
|
sub/sub/sub/file
|
|
sub/file2
|
|
sub/sub/file
|
|
sub/file
|
|
file
|
|
EOF
|
|
test_cmp expect actual
|
|
'
|
|
|
|
test_expect_success 'exclude only pathspec uses default implicit pathspec' '
|
|
git log --oneline --format=%s -- . ":(exclude)sub" >expect &&
|
|
git log --oneline --format=%s -- ":(exclude)sub" >actual &&
|
|
test_cmp expect actual
|
|
'
|
|
|
|
test_expect_success 't_e_i() exclude sub' '
|
|
git log --oneline --format=%s -- . ":(exclude)sub" >actual &&
|
|
cat <<EOF >expect &&
|
|
sub2/file
|
|
file
|
|
EOF
|
|
test_cmp expect actual
|
|
'
|
|
|
|
test_expect_success 't_e_i() exclude sub/sub/file' '
|
|
git log --oneline --format=%s -- . ":(exclude)sub/sub/file" >actual &&
|
|
cat <<EOF >expect &&
|
|
sub2/file
|
|
sub/sub/sub/file
|
|
sub/file2
|
|
sub/file
|
|
file
|
|
EOF
|
|
test_cmp expect actual
|
|
'
|
|
|
|
test_expect_success 't_e_i() exclude sub using mnemonic' '
|
|
git log --oneline --format=%s -- . ":!sub" >actual &&
|
|
cat <<EOF >expect &&
|
|
sub2/file
|
|
file
|
|
EOF
|
|
test_cmp expect actual
|
|
'
|
|
|
|
test_expect_success 't_e_i() exclude :(icase)SUB' '
|
|
git log --oneline --format=%s -- . ":(exclude,icase)SUB" >actual &&
|
|
cat <<EOF >expect &&
|
|
sub2/file
|
|
file
|
|
EOF
|
|
test_cmp expect actual
|
|
'
|
|
|
|
test_expect_success 't_e_i() exclude sub2 from sub' '
|
|
(
|
|
cd sub &&
|
|
git log --oneline --format=%s -- :/ ":/!sub2" >actual &&
|
|
cat <<EOF >expect &&
|
|
sub/sub/sub/file
|
|
sub/file2
|
|
sub/sub/file
|
|
sub/file
|
|
file
|
|
EOF
|
|
test_cmp expect actual
|
|
)
|
|
'
|
|
|
|
test_expect_success 't_e_i() exclude sub/*file' '
|
|
git log --oneline --format=%s -- . ":(exclude)sub/*file" >actual &&
|
|
cat <<EOF >expect &&
|
|
sub2/file
|
|
sub/file2
|
|
file
|
|
EOF
|
|
test_cmp expect actual
|
|
'
|
|
|
|
test_expect_success 't_e_i() exclude :(glob)sub/*/file' '
|
|
git log --oneline --format=%s -- . ":(exclude,glob)sub/*/file" >actual &&
|
|
cat <<EOF >expect &&
|
|
sub2/file
|
|
sub/sub/sub/file
|
|
sub/file2
|
|
sub/file
|
|
file
|
|
EOF
|
|
test_cmp expect actual
|
|
'
|
|
|
|
test_expect_success 'm_p_d() exclude sub' '
|
|
git ls-files -- . ":(exclude)sub" >actual &&
|
|
cat <<EOF >expect &&
|
|
file
|
|
sub2/file
|
|
EOF
|
|
test_cmp expect actual
|
|
'
|
|
|
|
test_expect_success 'm_p_d() exclude sub/sub/file' '
|
|
git ls-files -- . ":(exclude)sub/sub/file" >actual &&
|
|
cat <<EOF >expect &&
|
|
file
|
|
sub/file
|
|
sub/file2
|
|
sub/sub/sub/file
|
|
sub2/file
|
|
EOF
|
|
test_cmp expect actual
|
|
'
|
|
|
|
test_expect_success 'm_p_d() exclude sub using mnemonic' '
|
|
git ls-files -- . ":!sub" >actual &&
|
|
cat <<EOF >expect &&
|
|
file
|
|
sub2/file
|
|
EOF
|
|
test_cmp expect actual
|
|
'
|
|
|
|
test_expect_success 'm_p_d() exclude :(icase)SUB' '
|
|
git ls-files -- . ":(exclude,icase)SUB" >actual &&
|
|
cat <<EOF >expect &&
|
|
file
|
|
sub2/file
|
|
EOF
|
|
test_cmp expect actual
|
|
'
|
|
|
|
test_expect_success 'm_p_d() exclude sub2 from sub' '
|
|
(
|
|
cd sub &&
|
|
git ls-files -- :/ ":/!sub2" >actual &&
|
|
cat <<EOF >expect &&
|
|
../file
|
|
file
|
|
file2
|
|
sub/file
|
|
sub/sub/file
|
|
EOF
|
|
test_cmp expect actual
|
|
)
|
|
'
|
|
|
|
test_expect_success 'm_p_d() exclude sub/*file' '
|
|
git ls-files -- . ":(exclude)sub/*file" >actual &&
|
|
cat <<EOF >expect &&
|
|
file
|
|
sub/file2
|
|
sub2/file
|
|
EOF
|
|
test_cmp expect actual
|
|
'
|
|
|
|
test_expect_success 'm_p_d() exclude :(glob)sub/*/file' '
|
|
git ls-files -- . ":(exclude,glob)sub/*/file" >actual &&
|
|
cat <<EOF >expect &&
|
|
file
|
|
sub/file
|
|
sub/file2
|
|
sub/sub/sub/file
|
|
sub2/file
|
|
EOF
|
|
test_cmp expect actual
|
|
'
|
|
|
|
test_expect_success 'multiple exclusions' '
|
|
git ls-files -- ":^*/file2" ":^sub2" >actual &&
|
|
cat <<-\EOF >expect &&
|
|
file
|
|
sub/file
|
|
sub/sub/file
|
|
sub/sub/sub/file
|
|
EOF
|
|
test_cmp expect actual
|
|
'
|
|
|
|
test_expect_success 't_e_i() exclude case #8' '
|
|
git init case8 &&
|
|
(
|
|
cd case8 &&
|
|
echo file >file1 &&
|
|
echo file >file2 &&
|
|
git add file1 file2 &&
|
|
git commit -m twofiles &&
|
|
git grep -l file HEAD :^file2 >actual &&
|
|
echo HEAD:file1 >expected &&
|
|
test_cmp expected actual &&
|
|
git grep -l file HEAD :^file1 >actual &&
|
|
echo HEAD:file2 >expected &&
|
|
test_cmp expected actual
|
|
)
|
|
'
|
|
|
|
test_expect_success 'grep --untracked PATTERN' '
|
|
# This test is not an actual test of exclude patterns, rather it
|
|
# is here solely to ensure that if any tests are inserted, deleted, or
|
|
# changed above, that we still have untracked files with the expected
|
|
# contents for the NEXT two tests.
|
|
cat <<-\EOF >expect-grep &&
|
|
actual
|
|
expect
|
|
sub/actual
|
|
sub/expect
|
|
EOF
|
|
git grep -l --untracked file -- >actual-grep &&
|
|
test_cmp expect-grep actual-grep
|
|
'
|
|
|
|
test_expect_success 'grep --untracked PATTERN :(exclude)DIR' '
|
|
cat <<-\EOF >expect-grep &&
|
|
actual
|
|
expect
|
|
EOF
|
|
git grep -l --untracked file -- ":(exclude)sub" >actual-grep &&
|
|
test_cmp expect-grep actual-grep
|
|
'
|
|
|
|
test_expect_success 'grep --untracked PATTERN :(exclude)*FILE' '
|
|
cat <<-\EOF >expect-grep &&
|
|
actual
|
|
sub/actual
|
|
EOF
|
|
git grep -l --untracked file -- ":(exclude)*expect" >actual-grep &&
|
|
test_cmp expect-grep actual-grep
|
|
'
|
|
|
|
test_done
|