Documentation: more examples.
[git/jrn.git] / git-parse-remote.sh
blob5f158c613f333026ed42eac1c059b01500ba5e53
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 # Not so fast. This could be the partial URL shorthand...
11 token=$(expr "$1" : '\([^/]*\)/')
12 remainder=$(expr "$1" : '[^/]*/\(.*\)')
13 if test -f "$GIT_DIR/branches/$token"
14 then
15 echo branches-partial
16 else
17 echo ''
21 if test -f "$GIT_DIR/remotes/$1"
22 then
23 echo remotes
24 elif test -f "$GIT_DIR/branches/$1"
25 then
26 echo branches
27 else
28 echo ''
29 fi ;;
30 esac
33 get_remote_url () {
34 data_source=$(get_data_source "$1")
35 case "$data_source" in
36 '')
37 echo "$1" ;;
38 remotes)
39 sed -ne '/^URL: */{
40 s///p
42 }' "$GIT_DIR/remotes/$1" ;;
43 branches)
44 sed -e 's/#.*//' "$GIT_DIR/branches/$1" ;;
45 branches-partial)
46 token=$(expr "$1" : '\([^/]*\)/')
47 remainder=$(expr "$1" : '[^/]*/\(.*\)')
48 url=$(sed -e 's/#.*//' "$GIT_DIR/branches/$token")
49 echo "$url/$remainder"
52 die "internal error: get-remote-url $1" ;;
53 esac
56 get_remote_default_refs_for_push () {
57 data_source=$(get_data_source "$1")
58 case "$data_source" in
59 '' | branches | branches-partial)
60 ;; # no default push mapping, just send matching refs.
61 remotes)
62 sed -ne '/^Push: */{
63 s///p
64 }' "$GIT_DIR/remotes/$1" ;;
66 die "internal error: get-remote-default-ref-for-push $1" ;;
67 esac
70 # Subroutine to canonicalize remote:local notation.
71 canon_refs_list_for_fetch () {
72 # Leave only the first one alone; add prefix . to the rest
73 # to prevent the secondary branches to be merged by default.
74 dot_prefix=
75 for ref
77 force=
78 case "$ref" in
79 +*)
80 ref=$(expr "$ref" : '\+\(.*\)')
81 force=+
83 esac
84 expr "$ref" : '.*:' >/dev/null || ref="${ref}:"
85 remote=$(expr "$ref" : '\([^:]*\):')
86 local=$(expr "$ref" : '[^:]*:\(.*\)')
87 case "$remote" in
88 '') remote=HEAD ;;
89 refs/heads/* | refs/tags/*) ;;
90 heads/* | tags/* ) remote="refs/$remote" ;;
91 *) remote="refs/heads/$remote" ;;
92 esac
93 case "$local" in
94 '') local= ;;
95 refs/heads/* | refs/tags/*) ;;
96 heads/* | tags/* ) local="refs/$local" ;;
97 *) local="refs/heads/$local" ;;
98 esac
100 if local_ref_name=$(expr "$local" : 'refs/\(.*\)')
101 then
102 git-check-ref-format "$local_ref_name" ||
103 die "* refusing to create funny ref '$local_ref_name' locally"
105 echo "${dot_prefix}${force}${remote}:${local}"
106 dot_prefix=.
107 done
110 # Returns list of src: (no store), or src:dst (store)
111 get_remote_default_refs_for_fetch () {
112 data_source=$(get_data_source "$1")
113 case "$data_source" in
114 '' | branches-partial)
115 echo "HEAD:" ;;
116 branches)
117 remote_branch=$(sed -ne '/#/s/.*#//p' "$GIT_DIR/branches/$1")
118 case "$remote_branch" in '') remote_branch=master ;; esac
119 echo "refs/heads/${remote_branch}:refs/heads/$1"
121 remotes)
122 # This prefixes the second and later default refspecs
123 # with a '.', to signal git-fetch to mark them
124 # not-for-merge.
125 canon_refs_list_for_fetch $(sed -ne '/^Pull: */{
126 s///p
127 }' "$GIT_DIR/remotes/$1")
130 die "internal error: get-remote-default-ref-for-push $1" ;;
131 esac
134 get_remote_refs_for_push () {
135 case "$#" in
136 0) die "internal error: get-remote-refs-for-push." ;;
137 1) get_remote_default_refs_for_push "$@" ;;
138 *) shift; echo "$@" ;;
139 esac
142 get_remote_refs_for_fetch () {
143 case "$#" in
145 die "internal error: get-remote-refs-for-fetch." ;;
147 get_remote_default_refs_for_fetch "$@" ;;
149 shift
150 tag_just_seen=
151 for ref
153 if test "$tag_just_seen"
154 then
155 echo "refs/tags/${ref}:refs/tags/${ref}"
156 tag_just_seen=
157 continue
158 else
159 case "$ref" in
160 tag)
161 tag_just_seen=yes
162 continue
164 esac
166 canon_refs_list_for_fetch "$ref"
167 done
169 esac
172 resolve_alternates () {
173 # original URL (xxx.git)
174 top_=`expr "$1" : '\([^:]*:/*[^/]*\)/'`
175 while read path
177 case "$path" in
178 \#* | '')
179 continue ;;
181 echo "$top_$path/" ;;
182 ../*)
183 # relative -- ugly but seems to work.
184 echo "$1/objects/$path/" ;;
186 # exit code may not be caught by the reader.
187 echo "bad alternate: $path"
188 exit 1 ;;
189 esac
190 done