po(refreshpot): define the input charset before read()'ing
[ikiwiki] / IkiWiki / Plugin / mercurial.pm
1 #!/usr/bin/perl
2 package IkiWiki::Plugin::mercurial;
3
4 use warnings;
5 use strict;
6 use IkiWiki;
7 use Encode;
8 use open qw{:utf8 :std};
9
10 sub import { #{{{
11         hook(type => "checkconfig", id => "mercurial", call => \&checkconfig);
12         hook(type => "getsetup", id => "mercurial", call => \&getsetup);
13         hook(type => "rcs", id => "rcs_update", call => \&rcs_update);
14         hook(type => "rcs", id => "rcs_prepedit", call => \&rcs_prepedit);
15         hook(type => "rcs", id => "rcs_commit", call => \&rcs_commit);
16         hook(type => "rcs", id => "rcs_commit_staged", call => \&rcs_commit_staged);
17         hook(type => "rcs", id => "rcs_add", call => \&rcs_add);
18         hook(type => "rcs", id => "rcs_remove", call => \&rcs_remove);
19         hook(type => "rcs", id => "rcs_rename", call => \&rcs_rename);
20         hook(type => "rcs", id => "rcs_recentchanges", call => \&rcs_recentchanges);
21         hook(type => "rcs", id => "rcs_diff", call => \&rcs_diff);
22         hook(type => "rcs", id => "rcs_getctime", call => \&rcs_getctime);
23 } #}}}
24
25 sub checkconfig () { #{{{
26         if (exists $config{mercurial_wrapper} && length $config{mercurial_wrapper}) {
27                 push @{$config{wrappers}}, {
28                         wrapper => $config{mercurial_wrapper},
29                         wrappermode => (defined $config{mercurial_wrappermode} ? $config{mercurial_wrappermode} : "06755"),
30                 };
31         }
32 } #}}}
33
34 sub getsetup () { #{{{
35         return
36                 plugin => {
37                         safe => 0, # rcs plugin
38                         rebuild => undef,
39                 },
40                 mercurial_wrapper => {
41                         type => "string",
42                         #example => # FIXME add example
43                         description => "mercurial post-commit hook to generate",
44                         safe => 0, # file
45                         rebuild => 0,
46                 },
47                 mercurial_wrappermode => {
48                         type => "string",
49                         example => '06755',
50                         description => "mode for mercurial_wrapper (can safely be made suid)",
51                         safe => 0,
52                         rebuild => 0,
53                 },
54                 historyurl => {
55                         type => "string",
56                         example => "http://example.com:8000/log/tip/[[file]]",
57                         description => "url to hg serve'd repository, to show file history ([[file]] substituted)",
58                         safe => 1,
59                         rebuild => 1,
60                 },
61                 diffurl => {
62                         type => "string",
63                         example => "http://localhost:8000/?fd=[[r2]];file=[[file]]",
64                         description => "url to hg serve'd repository, to show diff ([[file]] and [[r2]] substituted)",
65                         safe => 1,
66                         rebuild => 1,
67                 },
68 } #}}}
69
70 sub mercurial_log ($) { #{{{
71         my $out = shift;
72         my @infos;
73
74         while (<$out>) {
75                 my $line = $_;
76                 my ($key, $value);
77
78                 if (/^description:/) {
79                         $key = "description";
80                         $value = "";
81
82                         # slurp everything as the description text 
83                         # until the next changeset
84                         while (<$out>) {
85                                 if (/^changeset: /) {
86                                         $line = $_;
87                                         last;
88                                 }
89
90                                 $value .= $_;
91                         }
92
93                         local $/ = "";
94                         chomp $value;
95                         $infos[$#infos]{$key} = $value;
96                 }
97
98                 chomp $line;
99                 ($key, $value) = split /: +/, $line, 2;
100
101                 if ($key eq "changeset") {
102                         push @infos, {};
103
104                         # remove the revision index, which is strictly 
105                         # local to the repository
106                         $value =~ s/^\d+://;
107                 }
108
109                 $infos[$#infos]{$key} = $value;
110         }
111         close $out;
112
113         return @infos;
114 } #}}}
115
116 sub rcs_update () { #{{{
117         my @cmdline = ("hg", "-q", "-R", "$config{srcdir}", "update");
118         if (system(@cmdline) != 0) {
119                 warn "'@cmdline' failed: $!";
120         }
121 } #}}}
122
123 sub rcs_prepedit ($) { #{{{
124         return "";
125 } #}}}
126
127 sub rcs_commit ($$$;$$) { #{{{
128         my ($file, $message, $rcstoken, $user, $ipaddr) = @_;
129
130         if (defined $user) {
131                 $user = IkiWiki::possibly_foolish_untaint($user);
132         }
133         elsif (defined $ipaddr) {
134                 $user = "Anonymous from ".IkiWiki::possibly_foolish_untaint($ipaddr);
135         }
136         else {
137                 $user = "Anonymous";
138         }
139
140         $message = IkiWiki::possibly_foolish_untaint($message);
141         if (! length $message) {
142                 $message = "no message given";
143         }
144
145         my @cmdline = ("hg", "-q", "-R", $config{srcdir}, "commit", 
146                        "-m", $message, "-u", $user);
147         if (system(@cmdline) != 0) {
148                 warn "'@cmdline' failed: $!";
149         }
150
151         return undef; # success
152 } #}}}
153
154 sub rcs_commit_staged ($$$) {
155         # Commits all staged changes. Changes can be staged using rcs_add,
156         # rcs_remove, and rcs_rename.
157         my ($message, $user, $ipaddr)=@_;
158         
159         error("rcs_commit_staged not implemented for mercurial"); # TODO
160 }
161
162 sub rcs_add ($) { # {{{
163         my ($file) = @_;
164
165         my @cmdline = ("hg", "-q", "-R", "$config{srcdir}", "add", "$config{srcdir}/$file");
166         if (system(@cmdline) != 0) {
167                 warn "'@cmdline' failed: $!";
168         }
169 } #}}}
170
171 sub rcs_remove ($) { # {{{
172         my ($file) = @_;
173
174         error("rcs_remove not implemented for mercurial"); # TODO
175 } #}}}
176
177 sub rcs_rename ($$) { # {{{
178         my ($src, $dest) = @_;
179
180         error("rcs_rename not implemented for mercurial"); # TODO
181 } #}}}
182
183 sub rcs_recentchanges ($) { #{{{
184         my ($num) = @_;
185
186         my @cmdline = ("hg", "-R", $config{srcdir}, "log", "-v", "-l", $num,
187                 "--style", "default");
188         open (my $out, "@cmdline |");
189
190         eval q{use Date::Parse};
191         error($@) if $@;
192
193         my @ret;
194         foreach my $info (mercurial_log($out)) {
195                 my @pages = ();
196                 my @message = ();
197         
198                 foreach my $msgline (split(/\n/, $info->{description})) {
199                         push @message, { line => $msgline };
200                 }
201
202                 foreach my $file (split / /,$info->{files}) {
203                         my $diffurl = defined $config{diffurl} ? $config{'diffurl'} : "";
204                         $diffurl =~ s/\[\[file\]\]/$file/go;
205                         $diffurl =~ s/\[\[r2\]\]/$info->{changeset}/go;
206
207                         push @pages, {
208                                 page => pagename($file),
209                                 diffurl => $diffurl,
210                         };
211                 }
212
213                 my $user = $info->{"user"};
214                 $user =~ s/\s*<.*>\s*$//;
215                 $user =~ s/^\s*//;
216
217                 push @ret, {
218                         rev        => $info->{"changeset"},
219                         user       => $user,
220                         committype => "mercurial",
221                         when       => str2time($info->{"date"}),
222                         message    => [@message],
223                         pages      => [@pages],
224                 };
225         }
226
227         return @ret;
228 } #}}}
229
230 sub rcs_diff ($) { #{{{
231         # TODO
232 } #}}}
233
234 sub rcs_getctime ($) { #{{{
235         my ($file) = @_;
236
237         # XXX filename passes through the shell here, should try to avoid
238         # that just in case
239         my @cmdline = ("hg", "-R", $config{srcdir}, "log", "-v", "-l", '1', 
240                 "--style", "default", "$config{srcdir}/$file");
241         open (my $out, "@cmdline |");
242
243         my @log = mercurial_log($out);
244
245         if (length @log < 1) {
246                 return 0;
247         }
248
249         eval q{use Date::Parse};
250         error($@) if $@;
251         
252         my $ctime = str2time($log[0]->{"date"});
253         return $ctime;
254 } #}}}
255
256 1