refspec: add support for negative refspecs
commitc0192df6306d4d9ad77f6015a053925b13155834
authorJacob Keller <jacob.keller@gmail.com>
Wed, 30 Sep 2020 21:25:29 +0000 (30 14:25 -0700)
committerJunio C Hamano <gitster@pobox.com>
Wed, 30 Sep 2020 21:52:00 +0000 (30 14:52 -0700)
treebf6240c3b988240c871ee132b0cc9ccdb883ac99
parent95e7c385393488cb20c29697d8655f94ce83c413
refspec: add support for negative refspecs

Both fetch and push support pattern refspecs which allow fetching or
pushing references that match a specific pattern. Because these patterns
are globs, they have somewhat limited ability to express more complex
situations.

For example, suppose you wish to fetch all branches from a remote except
for a specific one. To allow this, you must setup a set of refspecs
which match only the branches you want. Because refspecs are either
explicit name matches, or simple globs, many patterns cannot be
expressed.

Add support for a new type of refspec, referred to as "negative"
refspecs. These are prefixed with a '^' and mean "exclude any ref
matching this refspec". They can only have one "side" which always
refers to the source. During a fetch, this refers to the name of the ref
on the remote. During a push, this refers to the name of the ref on the
local side.

With negative refspecs, users can express more complex patterns. For
example:

 git fetch origin refs/heads/*:refs/remotes/origin/* ^refs/heads/dontwant

will fetch all branches on origin into remotes/origin, but will exclude
fetching the branch named dontwant.

Refspecs today are commutative, meaning that order doesn't expressly
matter. Rather than forcing an implied order, negative refspecs will
always be applied last. That is, in order to match, a ref must match at
least one positive refspec, and match none of the negative refspecs.
This is similar to how negative pathspecs work.

Signed-off-by: Jacob Keller <jacob.keller@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/pull-fetch-param.txt
builtin/fetch.c
refspec.c
refspec.h
remote.c
remote.h
t/t5582-fetch-negative-refspec.sh [new file with mode: 0755]