Code

git-archive: document --exec
[git.git] / git-remote.perl
1 #!/usr/bin/perl -w
3 use Git;
4 my $git = Git->repository();
6 sub add_remote_config {
7         my ($hash, $name, $what, $value) = @_;
8         if ($what eq 'url') {
9                 if (exists $hash->{$name}{'URL'}) {
10                         print STDERR "Warning: more than one remote.$name.url\n";
11                 }
12                 $hash->{$name}{'URL'} = $value;
13         }
14         elsif ($what eq 'fetch') {
15                 $hash->{$name}{'FETCH'} ||= [];
16                 push @{$hash->{$name}{'FETCH'}}, $value;
17         }
18         elsif ($what eq 'push') {
19                 $hash->{$name}{'PUSH'} ||= [];
20                 push @{$hash->{$name}{'PUSH'}}, $value;
21         }
22         if (!exists $hash->{$name}{'SOURCE'}) {
23                 $hash->{$name}{'SOURCE'} = 'config';
24         }
25 }
27 sub add_remote_remotes {
28         my ($hash, $file, $name) = @_;
30         if (exists $hash->{$name}) {
31                 $hash->{$name}{'WARNING'} = 'ignored due to config';
32                 return;
33         }
35         my $fh;
36         if (!open($fh, '<', $file)) {
37                 print STDERR "Warning: cannot open $file\n";
38                 return;
39         }
40         my $it = { 'SOURCE' => 'remotes' };
41         $hash->{$name} = $it;
42         while (<$fh>) {
43                 chomp;
44                 if (/^URL:\s*(.*)$/) {
45                         # Having more than one is Ok -- it is used for push.
46                         if (! exists $it->{'URL'}) {
47                                 $it->{'URL'} = $1;
48                         }
49                 }
50                 elsif (/^Push:\s*(.*)$/) {
51                         $it->{'PUSH'} ||= [];
52                         push @{$it->{'PUSH'}}, $1;
53                 }
54                 elsif (/^Pull:\s*(.*)$/) {
55                         $it->{'FETCH'} ||= [];
56                         push @{$it->{'FETCH'}}, $1;
57                 }
58                 elsif (/^\#/) {
59                         ; # ignore
60                 }
61                 else {
62                         print STDERR "Warning: funny line in $file: $_\n";
63                 }
64         }
65         close($fh);
66 }
68 sub list_remote {
69         my ($git) = @_;
70         my %seen = ();
71         my @remotes = eval {
72                 $git->command(qw(config --get-regexp), '^remote\.');
73         };
74         for (@remotes) {
75                 if (/^remote\.(\S+?)\.([^.\s]+)\s+(.*)$/) {
76                         add_remote_config(\%seen, $1, $2, $3);
77                 }
78         }
80         my $dir = $git->repo_path() . "/remotes";
81         if (opendir(my $dh, $dir)) {
82                 local $_;
83                 while ($_ = readdir($dh)) {
84                         chomp;
85                         next if (! -f "$dir/$_" || ! -r _);
86                         add_remote_remotes(\%seen, "$dir/$_", $_);
87                 }
88         }
90         return \%seen;
91 }
93 sub add_branch_config {
94         my ($hash, $name, $what, $value) = @_;
95         if ($what eq 'remote') {
96                 if (exists $hash->{$name}{'REMOTE'}) {
97                         print STDERR "Warning: more than one branch.$name.remote\n";
98                 }
99                 $hash->{$name}{'REMOTE'} = $value;
100         }
101         elsif ($what eq 'merge') {
102                 $hash->{$name}{'MERGE'} ||= [];
103                 push @{$hash->{$name}{'MERGE'}}, $value;
104         }
107 sub list_branch {
108         my ($git) = @_;
109         my %seen = ();
110         my @branches = eval {
111                 $git->command(qw(config --get-regexp), '^branch\.');
112         };
113         for (@branches) {
114                 if (/^branch\.([^.]*)\.(\S*)\s+(.*)$/) {
115                         add_branch_config(\%seen, $1, $2, $3);
116                 }
117         }
119         return \%seen;
122 my $remote = list_remote($git);
123 my $branch = list_branch($git);
125 sub update_ls_remote {
126         my ($harder, $info) = @_;
128         return if (($harder == 0) ||
129                    (($harder == 1) && exists $info->{'LS_REMOTE'}));
131         my @ref = map {
132                 s|^[0-9a-f]{40}\s+refs/heads/||;
133                 $_;
134         } $git->command(qw(ls-remote --heads), $info->{'URL'});
135         $info->{'LS_REMOTE'} = \@ref;
138 sub list_wildcard_mapping {
139         my ($forced, $ours, $ls) = @_;
140         my %refs;
141         for (@$ls) {
142                 $refs{$_} = 01; # bit #0 to say "they have"
143         }
144         for ($git->command('for-each-ref', "refs/remotes/$ours")) {
145                 chomp;
146                 next unless (s|^[0-9a-f]{40}\s[a-z]+\srefs/remotes/$ours/||);
147                 next if ($_ eq 'HEAD');
148                 $refs{$_} ||= 0;
149                 $refs{$_} |= 02; # bit #1 to say "we have"
150         }
151         my (@new, @stale, @tracked);
152         for (sort keys %refs) {
153                 my $have = $refs{$_};
154                 if ($have == 1) {
155                         push @new, $_;
156                 }
157                 elsif ($have == 2) {
158                         push @stale, $_;
159                 }
160                 elsif ($have == 3) {
161                         push @tracked, $_;
162                 }
163         }
164         return \@new, \@stale, \@tracked;
167 sub list_mapping {
168         my ($name, $info) = @_;
169         my $fetch = $info->{'FETCH'};
170         my $ls = $info->{'LS_REMOTE'};
171         my (@new, @stale, @tracked);
173         for (@$fetch) {
174                 next unless (/(\+)?([^:]+):(.*)/);
175                 my ($forced, $theirs, $ours) = ($1, $2, $3);
176                 if ($theirs eq 'refs/heads/*' &&
177                     $ours =~ /^refs\/remotes\/(.*)\/\*$/) {
178                         # wildcard mapping
179                         my ($w_new, $w_stale, $w_tracked)
180                                 = list_wildcard_mapping($forced, $1, $ls);
181                         push @new, @$w_new;
182                         push @stale, @$w_stale;
183                         push @tracked, @$w_tracked;
184                 }
185                 elsif ($theirs =~ /\*/ || $ours =~ /\*/) {
186                         print STDERR "Warning: unrecognized mapping in remotes.$name.fetch: $_\n";
187                 }
188                 elsif ($theirs =~ s|^refs/heads/||) {
189                         if (!grep { $_ eq $theirs } @$ls) {
190                                 push @stale, $theirs;
191                         }
192                         elsif ($ours ne '') {
193                                 push @tracked, $theirs;
194                         }
195                 }
196         }
197         return \@new, \@stale, \@tracked;
200 sub show_mapping {
201         my ($name, $info) = @_;
202         my ($new, $stale, $tracked) = list_mapping($name, $info);
203         if (@$new) {
204                 print "  New remote branches (next fetch will store in remotes/$name)\n";
205                 print "    @$new\n";
206         }
207         if (@$stale) {
208                 print "  Stale tracking branches in remotes/$name (use 'git remote prune')\n";
209                 print "    @$stale\n";
210         }
211         if (@$tracked) {
212                 print "  Tracked remote branches\n";
213                 print "    @$tracked\n";
214         }
217 sub prune_remote {
218         my ($name, $ls_remote) = @_;
219         if (!exists $remote->{$name}) {
220                 print STDERR "No such remote $name\n";
221                 return 1;
222         }
223         my $info = $remote->{$name};
224         update_ls_remote($ls_remote, $info);
226         my ($new, $stale, $tracked) = list_mapping($name, $info);
227         my $prefix = "refs/remotes/$name";
228         foreach my $to_prune (@$stale) {
229                 my @v = $git->command(qw(rev-parse --verify), "$prefix/$to_prune");
230                 $git->command(qw(update-ref -d), "$prefix/$to_prune", $v[0]);
231         }
232         return 0;
235 sub show_remote {
236         my ($name, $ls_remote) = @_;
237         if (!exists $remote->{$name}) {
238                 print STDERR "No such remote $name\n";
239                 return 1;
240         }
241         my $info = $remote->{$name};
242         update_ls_remote($ls_remote, $info);
244         print "* remote $name\n";
245         print "  URL: $info->{'URL'}\n";
246         for my $branchname (sort keys %$branch) {
247                 next if ($branch->{$branchname}{'REMOTE'} ne $name);
248                 my @merged = map {
249                         s|^refs/heads/||;
250                         $_;
251                 } split(' ',"@{$branch->{$branchname}{'MERGE'}}");
252                 next unless (@merged);
253                 print "  Remote branch(es) merged with 'git pull' while on branch $branchname\n";
254                 print "    @merged\n";
255         }
256         if ($info->{'LS_REMOTE'}) {
257                 show_mapping($name, $info);
258         }
259         if ($info->{'PUSH'}) {
260                 my @pushed = map {
261                         s|^refs/heads/||;
262                         s|^\+refs/heads/|+|;
263                         s|:refs/heads/|:|;
264                         $_;
265                 } @{$info->{'PUSH'}};
266                 print "  Local branch(es) pushed with 'git push'\n";
267                 print "    @pushed\n";
268         }
269         return 0;
272 sub add_remote {
273         my ($name, $url, $opts) = @_;
274         if (exists $remote->{$name}) {
275                 print STDERR "remote $name already exists.\n";
276                 exit(1);
277         }
278         $git->command('config', "remote.$name.url", $url);
279         my $track = $opts->{'track'} || ["*"];
281         for (@$track) {
282                 $git->command('config', '--add', "remote.$name.fetch",
283                               "+refs/heads/$_:refs/remotes/$name/$_");
284         }
285         if ($opts->{'fetch'}) {
286                 $git->command('fetch', $name);
287         }
288         if (exists $opts->{'master'}) {
289                 $git->command('symbolic-ref', "refs/remotes/$name/HEAD",
290                               "refs/remotes/$name/$opts->{'master'}");
291         }
294 sub update_remote {
295         my ($name) = @_;
297         my $conf = $git->config("remotes." . $name);
298         if (defined($conf)) {
299                 @remotes = split(' ', $conf);
300         } elsif ($name eq 'default') {
301                 undef @remotes;
302                 for (sort keys %$remote) {
303                         my $do_fetch = $git->config_bool("remote." . $_ .
304                                                     ".skipDefaultUpdate");
305                         unless ($do_fetch) {
306                                 push @remotes, $_;
307                         }
308                 }
309         } else {
310                 print STDERR "Remote group $name does not exists.\n";
311                 exit(1);
312         }
313         for (@remotes) {
314                 print "Updating $_\n";
315                 $git->command('fetch', "$_");
316         }
319 sub add_usage {
320         print STDERR "Usage: git remote add [-f] [-t track]* [-m master] <name> <url>\n";
321         exit(1);
324 local $VERBOSE = 0;
325 @ARGV = grep {
326         if ($_ eq '-v' or $_ eq '--verbose') {
327                 $VERBOSE=1;
328                 0
329         } else {
330                 1
331         }
332 } @ARGV;
334 if (!@ARGV) {
335         for (sort keys %$remote) {
336                 print "$_";
337                 print "\t$remote->{$_}->{URL}" if $VERBOSE;
338                 print "\n";
339         }
341 elsif ($ARGV[0] eq 'show') {
342         my $ls_remote = 1;
343         my $i;
344         for ($i = 1; $i < @ARGV; $i++) {
345                 if ($ARGV[$i] eq '-n') {
346                         $ls_remote = 0;
347                 }
348                 else {
349                         last;
350                 }
351         }
352         if ($i >= @ARGV) {
353                 print STDERR "Usage: git remote show <remote>\n";
354                 exit(1);
355         }
356         my $status = 0;
357         for (; $i < @ARGV; $i++) {
358                 $status |= show_remote($ARGV[$i], $ls_remote);
359         }
360         exit($status);
362 elsif ($ARGV[0] eq 'update') {
363         if (@ARGV <= 1) {
364                 update_remote("default");
365                 exit(1);
366         }
367         for ($i = 1; $i < @ARGV; $i++) {
368                 update_remote($ARGV[$i]);
369         }
371 elsif ($ARGV[0] eq 'prune') {
372         my $ls_remote = 1;
373         my $i;
374         for ($i = 1; $i < @ARGV; $i++) {
375                 if ($ARGV[$i] eq '-n') {
376                         $ls_remote = 0;
377                 }
378                 else {
379                         last;
380                 }
381         }
382         if ($i >= @ARGV) {
383                 print STDERR "Usage: git remote prune <remote>\n";
384                 exit(1);
385         }
386         my $status = 0;
387         for (; $i < @ARGV; $i++) {
388                 $status |= prune_remote($ARGV[$i], $ls_remote);
389         }
390         exit($status);
392 elsif ($ARGV[0] eq 'add') {
393         my %opts = ();
394         while (1 < @ARGV && $ARGV[1] =~ /^-/) {
395                 my $opt = $ARGV[1];
396                 shift @ARGV;
397                 if ($opt eq '-f' || $opt eq '--fetch') {
398                         $opts{'fetch'} = 1;
399                         next;
400                 }
401                 if ($opt eq '-t' || $opt eq '--track') {
402                         if (@ARGV < 1) {
403                                 add_usage();
404                         }
405                         $opts{'track'} ||= [];
406                         push @{$opts{'track'}}, $ARGV[1];
407                         shift @ARGV;
408                         next;
409                 }
410                 if ($opt eq '-m' || $opt eq '--master') {
411                         if ((@ARGV < 1) || exists $opts{'master'}) {
412                                 add_usage();
413                         }
414                         $opts{'master'} = $ARGV[1];
415                         shift @ARGV;
416                         next;
417                 }
418                 add_usage();
419         }
420         if (@ARGV != 3) {
421                 add_usage();
422         }
423         add_remote($ARGV[1], $ARGV[2], \%opts);
425 else {
426         print STDERR "Usage: git remote\n";
427         print STDERR "       git remote add <name> <url>\n";
428         print STDERR "       git remote show <name>\n";
429         print STDERR "       git remote prune <name>\n";
430         print STDERR "       git remote update [group]\n";
431         exit(1);