Update describe documentation.
[git/jnareb-git.git] / git-parse-remote.sh
blob7e87f2e06e6e491d7c518d332bfa036cca081ea2
1 #!/bin/sh
3 # git-ls-remote could be called from outside a git managed repository;
4 # this would fail in that case and would issue an error message.
5 GIT_DIR=$(git-rev-parse --git-dir 2>/dev/null) || :;
7 get_data_source () {
8 case "$1" in
9 */*)
10 echo ''
13 if test "$(git-repo-config --get "remote.$1.url")"
14 then
15 echo config
16 elif test -f "$GIT_DIR/remotes/$1"
17 then
18 echo remotes
19 elif test -f "$GIT_DIR/branches/$1"
20 then
21 echo branches
22 else
23 echo ''
24 fi ;;
25 esac
28 get_remote_url () {
29 data_source=$(get_data_source "$1")
30 case "$data_source" in
31 '')
32 echo "$1"
34 config)
35 git-repo-config --get "remote.$1.url"
37 remotes)
38 sed -ne '/^URL: */{
39 s///p
41 }' "$GIT_DIR/remotes/$1"
43 branches)
44 sed -e 's/#.*//' "$GIT_DIR/branches/$1"
47 die "internal error: get-remote-url $1" ;;
48 esac
51 get_default_remote () {
52 curr_branch=$(git-symbolic-ref -q HEAD | sed -e 's|^refs/heads/||')
53 origin=$(git-repo-config --get "branch.$curr_branch.remote")
54 echo ${origin:-origin}
57 get_remote_default_refs_for_push () {
58 data_source=$(get_data_source "$1")
59 case "$data_source" in
60 '' | branches)
61 ;; # no default push mapping, just send matching refs.
62 config)
63 git-repo-config --get-all "remote.$1.push" ;;
64 remotes)
65 sed -ne '/^Push: */{
66 s///p
67 }' "$GIT_DIR/remotes/$1" ;;
69 die "internal error: get-remote-default-ref-for-push $1" ;;
70 esac
73 # Called from canon_refs_list_for_fetch -d "$remote", which
74 # is called from get_remote_default_refs_for_fetch to grok
75 # refspecs that are retrieved from the configuration, but not
76 # from get_remote_refs_for_fetch when it deals with refspecs
77 # supplied on the command line. $ls_remote_result has the list
78 # of refs available at remote.
80 # The first token returned is either "explicit" or "glob"; this
81 # is to help prevent randomly "globbed" ref from being chosen as
82 # a merge candidate
83 expand_refs_wildcard () {
84 remote="$1"
85 shift
86 first_one=yes
87 if test "$#" = 0
88 then
89 echo empty
90 echo >&2 "Nothing specified for fetching with remote.$remote.fetch"
92 for ref
94 lref=${ref#'+'}
95 # a non glob pattern is given back as-is.
96 expr "z$lref" : 'zrefs/.*/\*:refs/.*/\*$' >/dev/null || {
97 if test -n "$first_one"
98 then
99 echo "explicit"
100 first_one=
102 echo "$ref"
103 continue
106 # glob
107 if test -n "$first_one"
108 then
109 echo "glob"
110 first_one=
112 from=`expr "z$lref" : 'z\(refs/.*/\)\*:refs/.*/\*$'`
113 to=`expr "z$lref" : 'zrefs/.*/\*:\(refs/.*/\)\*$'`
114 local_force=
115 test "z$lref" = "z$ref" || local_force='+'
116 echo "$ls_remote_result" |
117 sed -e '/\^{}$/d' |
119 IFS=' '
120 while read sha1 name
122 # ignore the ones that do not start with $from
123 mapped=${name#"$from"}
124 test "z$name" = "z$mapped" && continue
125 echo "${local_force}${name}:${to}${mapped}"
126 done
128 done
131 # Subroutine to canonicalize remote:local notation.
132 canon_refs_list_for_fetch () {
133 # If called from get_remote_default_refs_for_fetch
134 # leave the branches in branch.${curr_branch}.merge alone,
135 # or the first one otherwise; add prefix . to the rest
136 # to prevent the secondary branches to be merged by default.
137 merge_branches=
138 curr_branch=
139 if test "$1" = "-d"
140 then
141 shift ; remote="$1" ; shift
142 set $(expand_refs_wildcard "$remote" "$@")
143 is_explicit="$1"
144 shift
145 if test "$remote" = "$(get_default_remote)"
146 then
147 curr_branch=$(git-symbolic-ref -q HEAD | \
148 sed -e 's|^refs/heads/||')
149 merge_branches=$(git-repo-config \
150 --get-all "branch.${curr_branch}.merge")
152 if test -z "$merge_branches" && test $is_explicit != explicit
153 then
154 merge_branches=..this.will.never.match.any.ref..
157 for ref
159 force=
160 case "$ref" in
162 ref=$(expr "z$ref" : 'z+\(.*\)')
163 force=+
165 esac
166 expr "z$ref" : 'z.*:' >/dev/null || ref="${ref}:"
167 remote=$(expr "z$ref" : 'z\([^:]*\):')
168 local=$(expr "z$ref" : 'z[^:]*:\(.*\)')
169 dot_prefix=.
170 if test -z "$merge_branches"
171 then
172 merge_branches=$remote
173 dot_prefix=
174 else
175 for merge_branch in $merge_branches
177 if test "$remote" = "$merge_branch" ||
178 test "$local" = "$merge_branch"
179 then
180 dot_prefix=
181 break
183 done
185 case "$remote" in
186 '') remote=HEAD ;;
187 refs/heads/* | refs/tags/* | refs/remotes/*) ;;
188 heads/* | tags/* | remotes/* ) remote="refs/$remote" ;;
189 *) remote="refs/heads/$remote" ;;
190 esac
191 case "$local" in
192 '') local= ;;
193 refs/heads/* | refs/tags/* | refs/remotes/*) ;;
194 heads/* | tags/* | remotes/* ) local="refs/$local" ;;
195 *) local="refs/heads/$local" ;;
196 esac
198 if local_ref_name=$(expr "z$local" : 'zrefs/\(.*\)')
199 then
200 git-check-ref-format "$local_ref_name" ||
201 die "* refusing to create funny ref '$local_ref_name' locally"
203 echo "${dot_prefix}${force}${remote}:${local}"
204 done
207 # Returns list of src: (no store), or src:dst (store)
208 get_remote_default_refs_for_fetch () {
209 data_source=$(get_data_source "$1")
210 case "$data_source" in
212 echo "HEAD:" ;;
213 config)
214 canon_refs_list_for_fetch -d "$1" \
215 $(git-repo-config --get-all "remote.$1.fetch") ;;
216 branches)
217 remote_branch=$(sed -ne '/#/s/.*#//p' "$GIT_DIR/branches/$1")
218 case "$remote_branch" in '') remote_branch=master ;; esac
219 echo "refs/heads/${remote_branch}:refs/heads/$1"
221 remotes)
222 canon_refs_list_for_fetch -d "$1" $(sed -ne '/^Pull: */{
223 s///p
224 }' "$GIT_DIR/remotes/$1")
227 die "internal error: get-remote-default-ref-for-push $1" ;;
228 esac
231 get_remote_refs_for_push () {
232 case "$#" in
233 0) die "internal error: get-remote-refs-for-push." ;;
234 1) get_remote_default_refs_for_push "$@" ;;
235 *) shift; echo "$@" ;;
236 esac
239 get_remote_refs_for_fetch () {
240 case "$#" in
242 die "internal error: get-remote-refs-for-fetch." ;;
244 get_remote_default_refs_for_fetch "$@" ;;
246 shift
247 tag_just_seen=
248 for ref
250 if test "$tag_just_seen"
251 then
252 echo "refs/tags/${ref}:refs/tags/${ref}"
253 tag_just_seen=
254 continue
255 else
256 case "$ref" in
257 tag)
258 tag_just_seen=yes
259 continue
261 esac
263 canon_refs_list_for_fetch "$ref"
264 done
266 esac
269 resolve_alternates () {
270 # original URL (xxx.git)
271 top_=`expr "z$1" : 'z\([^:]*:/*[^/]*\)/'`
272 while read path
274 case "$path" in
275 \#* | '')
276 continue ;;
278 echo "$top_$path/" ;;
279 ../*)
280 # relative -- ugly but seems to work.
281 echo "$1/objects/$path/" ;;
283 # exit code may not be caught by the reader.
284 echo "bad alternate: $path"
285 exit 1 ;;
286 esac
287 done
290 get_uploadpack () {
291 data_source=$(get_data_source "$1")
292 case "$data_source" in
293 config)
294 uplp=$(git-repo-config --get "remote.$1.uploadpack")
295 echo ${uplp:-git-upload-pack}
298 echo "git-upload-pack"
300 esac