ref-filter: Do not abruptly die when using the 'lstrip=<N>' option
[git.git] / gitweb / gitweb.perl
blob7cf68f07b773f7e520c1e6ba680bff65e5bc7f3a
1 #!/usr/bin/perl
3 # gitweb - simple web interface to track changes in git repositories
5 # (C) 2005-2006, Kay Sievers <kay.sievers@vrfy.org>
6 # (C) 2005, Christian Gierke
8 # This program is licensed under the GPLv2
10 use 5.008;
11 use strict;
12 use warnings;
13 use CGI qw(:standard :escapeHTML -nosticky);
14 use CGI::Util qw(unescape);
15 use CGI::Carp qw(fatalsToBrowser set_message);
16 use Encode;
17 use Fcntl ':mode';
18 use File::Find qw();
19 use File::Basename qw(basename);
20 use Time::HiRes qw(gettimeofday tv_interval);
21 binmode STDOUT, ':utf8';
23 if (!defined($CGI::VERSION) || $CGI::VERSION < 4.08) {
24 eval 'sub CGI::multi_param { CGI::param(@_) }'
27 our $t0 = [ gettimeofday() ];
28 our $number_of_git_cmds = 0;
30 BEGIN {
31 CGI->compile() if $ENV{'MOD_PERL'};
34 our $version = "++GIT_VERSION++";
36 our ($my_url, $my_uri, $base_url, $path_info, $home_link);
37 sub evaluate_uri {
38 our $cgi;
40 our $my_url = $cgi->url();
41 our $my_uri = $cgi->url(-absolute => 1);
43 # Base URL for relative URLs in gitweb ($logo, $favicon, ...),
44 # needed and used only for URLs with nonempty PATH_INFO
45 our $base_url = $my_url;
47 # When the script is used as DirectoryIndex, the URL does not contain the name
48 # of the script file itself, and $cgi->url() fails to strip PATH_INFO, so we
49 # have to do it ourselves. We make $path_info global because it's also used
50 # later on.
52 # Another issue with the script being the DirectoryIndex is that the resulting
53 # $my_url data is not the full script URL: this is good, because we want
54 # generated links to keep implying the script name if it wasn't explicitly
55 # indicated in the URL we're handling, but it means that $my_url cannot be used
56 # as base URL.
57 # Therefore, if we needed to strip PATH_INFO, then we know that we have
58 # to build the base URL ourselves:
59 our $path_info = decode_utf8($ENV{"PATH_INFO"});
60 if ($path_info) {
61 # $path_info has already been URL-decoded by the web server, but
62 # $my_url and $my_uri have not. URL-decode them so we can properly
63 # strip $path_info.
64 $my_url = unescape($my_url);
65 $my_uri = unescape($my_uri);
66 if ($my_url =~ s,\Q$path_info\E$,, &&
67 $my_uri =~ s,\Q$path_info\E$,, &&
68 defined $ENV{'SCRIPT_NAME'}) {
69 $base_url = $cgi->url(-base => 1) . $ENV{'SCRIPT_NAME'};
73 # target of the home link on top of all pages
74 our $home_link = $my_uri || "/";
77 # core git executable to use
78 # this can just be "git" if your webserver has a sensible PATH
79 our $GIT = "++GIT_BINDIR++/git";
81 # absolute fs-path which will be prepended to the project path
82 #our $projectroot = "/pub/scm";
83 our $projectroot = "++GITWEB_PROJECTROOT++";
85 # fs traversing limit for getting project list
86 # the number is relative to the projectroot
87 our $project_maxdepth = "++GITWEB_PROJECT_MAXDEPTH++";
89 # string of the home link on top of all pages
90 our $home_link_str = "++GITWEB_HOME_LINK_STR++";
92 # extra breadcrumbs preceding the home link
93 our @extra_breadcrumbs = ();
95 # name of your site or organization to appear in page titles
96 # replace this with something more descriptive for clearer bookmarks
97 our $site_name = "++GITWEB_SITENAME++"
98 || ($ENV{'SERVER_NAME'} || "Untitled") . " Git";
100 # html snippet to include in the <head> section of each page
101 our $site_html_head_string = "++GITWEB_SITE_HTML_HEAD_STRING++";
102 # filename of html text to include at top of each page
103 our $site_header = "++GITWEB_SITE_HEADER++";
104 # html text to include at home page
105 our $home_text = "++GITWEB_HOMETEXT++";
106 # filename of html text to include at bottom of each page
107 our $site_footer = "++GITWEB_SITE_FOOTER++";
109 # URI of stylesheets
110 our @stylesheets = ("++GITWEB_CSS++");
111 # URI of a single stylesheet, which can be overridden in GITWEB_CONFIG.
112 our $stylesheet = undef;
113 # URI of GIT logo (72x27 size)
114 our $logo = "++GITWEB_LOGO++";
115 # URI of GIT favicon, assumed to be image/png type
116 our $favicon = "++GITWEB_FAVICON++";
117 # URI of gitweb.js (JavaScript code for gitweb)
118 our $javascript = "++GITWEB_JS++";
120 # URI and label (title) of GIT logo link
121 #our $logo_url = "http://www.kernel.org/pub/software/scm/git/docs/";
122 #our $logo_label = "git documentation";
123 our $logo_url = "http://git-scm.com/";
124 our $logo_label = "git homepage";
126 # source of projects list
127 our $projects_list = "++GITWEB_LIST++";
129 # the width (in characters) of the projects list "Description" column
130 our $projects_list_description_width = 25;
132 # group projects by category on the projects list
133 # (enabled if this variable evaluates to true)
134 our $projects_list_group_categories = 0;
136 # default category if none specified
137 # (leave the empty string for no category)
138 our $project_list_default_category = "";
140 # default order of projects list
141 # valid values are none, project, descr, owner, and age
142 our $default_projects_order = "project";
144 # show repository only if this file exists
145 # (only effective if this variable evaluates to true)
146 our $export_ok = "++GITWEB_EXPORT_OK++";
148 # don't generate age column on the projects list page
149 our $omit_age_column = 0;
151 # don't generate information about owners of repositories
152 our $omit_owner=0;
154 # show repository only if this subroutine returns true
155 # when given the path to the project, for example:
156 # sub { return -e "$_[0]/git-daemon-export-ok"; }
157 our $export_auth_hook = undef;
159 # only allow viewing of repositories also shown on the overview page
160 our $strict_export = "++GITWEB_STRICT_EXPORT++";
162 # list of git base URLs used for URL to where fetch project from,
163 # i.e. full URL is "$git_base_url/$project"
164 our @git_base_url_list = grep { $_ ne '' } ("++GITWEB_BASE_URL++");
166 # default blob_plain mimetype and default charset for text/plain blob
167 our $default_blob_plain_mimetype = 'text/plain';
168 our $default_text_plain_charset = undef;
170 # file to use for guessing MIME types before trying /etc/mime.types
171 # (relative to the current git repository)
172 our $mimetypes_file = undef;
174 # assume this charset if line contains non-UTF-8 characters;
175 # it should be valid encoding (see Encoding::Supported(3pm) for list),
176 # for which encoding all byte sequences are valid, for example
177 # 'iso-8859-1' aka 'latin1' (it is decoded without checking, so it
178 # could be even 'utf-8' for the old behavior)
179 our $fallback_encoding = 'latin1';
181 # rename detection options for git-diff and git-diff-tree
182 # - default is '-M', with the cost proportional to
183 # (number of removed files) * (number of new files).
184 # - more costly is '-C' (which implies '-M'), with the cost proportional to
185 # (number of changed files + number of removed files) * (number of new files)
186 # - even more costly is '-C', '--find-copies-harder' with cost
187 # (number of files in the original tree) * (number of new files)
188 # - one might want to include '-B' option, e.g. '-B', '-M'
189 our @diff_opts = ('-M'); # taken from git_commit
191 # Disables features that would allow repository owners to inject script into
192 # the gitweb domain.
193 our $prevent_xss = 0;
195 # Path to the highlight executable to use (must be the one from
196 # http://www.andre-simon.de due to assumptions about parameters and output).
197 # Useful if highlight is not installed on your webserver's PATH.
198 # [Default: highlight]
199 our $highlight_bin = "++HIGHLIGHT_BIN++";
201 # information about snapshot formats that gitweb is capable of serving
202 our %known_snapshot_formats = (
203 # name => {
204 # 'display' => display name,
205 # 'type' => mime type,
206 # 'suffix' => filename suffix,
207 # 'format' => --format for git-archive,
208 # 'compressor' => [compressor command and arguments]
209 # (array reference, optional)
210 # 'disabled' => boolean (optional)}
212 'tgz' => {
213 'display' => 'tar.gz',
214 'type' => 'application/x-gzip',
215 'suffix' => '.tar.gz',
216 'format' => 'tar',
217 'compressor' => ['gzip', '-n']},
219 'tbz2' => {
220 'display' => 'tar.bz2',
221 'type' => 'application/x-bzip2',
222 'suffix' => '.tar.bz2',
223 'format' => 'tar',
224 'compressor' => ['bzip2']},
226 'txz' => {
227 'display' => 'tar.xz',
228 'type' => 'application/x-xz',
229 'suffix' => '.tar.xz',
230 'format' => 'tar',
231 'compressor' => ['xz'],
232 'disabled' => 1},
234 'zip' => {
235 'display' => 'zip',
236 'type' => 'application/x-zip',
237 'suffix' => '.zip',
238 'format' => 'zip'},
241 # Aliases so we understand old gitweb.snapshot values in repository
242 # configuration.
243 our %known_snapshot_format_aliases = (
244 'gzip' => 'tgz',
245 'bzip2' => 'tbz2',
246 'xz' => 'txz',
248 # backward compatibility: legacy gitweb config support
249 'x-gzip' => undef, 'gz' => undef,
250 'x-bzip2' => undef, 'bz2' => undef,
251 'x-zip' => undef, '' => undef,
254 # Pixel sizes for icons and avatars. If the default font sizes or lineheights
255 # are changed, it may be appropriate to change these values too via
256 # $GITWEB_CONFIG.
257 our %avatar_size = (
258 'default' => 16,
259 'double' => 32
262 # Used to set the maximum load that we will still respond to gitweb queries.
263 # If server load exceed this value then return "503 server busy" error.
264 # If gitweb cannot determined server load, it is taken to be 0.
265 # Leave it undefined (or set to 'undef') to turn off load checking.
266 our $maxload = 300;
268 # configuration for 'highlight' (http://www.andre-simon.de/)
269 # match by basename
270 our %highlight_basename = (
271 #'Program' => 'py',
272 #'Library' => 'py',
273 'SConstruct' => 'py', # SCons equivalent of Makefile
274 'Makefile' => 'make',
276 # match by extension
277 our %highlight_ext = (
278 # main extensions, defining name of syntax;
279 # see files in /usr/share/highlight/langDefs/ directory
280 (map { $_ => $_ } qw(py rb java css js tex bib xml awk bat ini spec tcl sql)),
281 # alternate extensions, see /etc/highlight/filetypes.conf
282 (map { $_ => 'c' } qw(c h)),
283 (map { $_ => 'sh' } qw(sh bash zsh ksh)),
284 (map { $_ => 'cpp' } qw(cpp cxx c++ cc)),
285 (map { $_ => 'php' } qw(php php3 php4 php5 phps)),
286 (map { $_ => 'pl' } qw(pl perl pm)), # perhaps also 'cgi'
287 (map { $_ => 'make'} qw(make mak mk)),
288 (map { $_ => 'xml' } qw(xml xhtml html htm)),
291 # You define site-wide feature defaults here; override them with
292 # $GITWEB_CONFIG as necessary.
293 our %feature = (
294 # feature => {
295 # 'sub' => feature-sub (subroutine),
296 # 'override' => allow-override (boolean),
297 # 'default' => [ default options...] (array reference)}
299 # if feature is overridable (it means that allow-override has true value),
300 # then feature-sub will be called with default options as parameters;
301 # return value of feature-sub indicates if to enable specified feature
303 # if there is no 'sub' key (no feature-sub), then feature cannot be
304 # overridden
306 # use gitweb_get_feature(<feature>) to retrieve the <feature> value
307 # (an array) or gitweb_check_feature(<feature>) to check if <feature>
308 # is enabled
310 # Enable the 'blame' blob view, showing the last commit that modified
311 # each line in the file. This can be very CPU-intensive.
313 # To enable system wide have in $GITWEB_CONFIG
314 # $feature{'blame'}{'default'} = [1];
315 # To have project specific config enable override in $GITWEB_CONFIG
316 # $feature{'blame'}{'override'} = 1;
317 # and in project config gitweb.blame = 0|1;
318 'blame' => {
319 'sub' => sub { feature_bool('blame', @_) },
320 'override' => 0,
321 'default' => [0]},
323 # Enable the 'snapshot' link, providing a compressed archive of any
324 # tree. This can potentially generate high traffic if you have large
325 # project.
327 # Value is a list of formats defined in %known_snapshot_formats that
328 # you wish to offer.
329 # To disable system wide have in $GITWEB_CONFIG
330 # $feature{'snapshot'}{'default'} = [];
331 # To have project specific config enable override in $GITWEB_CONFIG
332 # $feature{'snapshot'}{'override'} = 1;
333 # and in project config, a comma-separated list of formats or "none"
334 # to disable. Example: gitweb.snapshot = tbz2,zip;
335 'snapshot' => {
336 'sub' => \&feature_snapshot,
337 'override' => 0,
338 'default' => ['tgz']},
340 # Enable text search, which will list the commits which match author,
341 # committer or commit text to a given string. Enabled by default.
342 # Project specific override is not supported.
344 # Note that this controls all search features, which means that if
345 # it is disabled, then 'grep' and 'pickaxe' search would also be
346 # disabled.
347 'search' => {
348 'override' => 0,
349 'default' => [1]},
351 # Enable grep search, which will list the files in currently selected
352 # tree containing the given string. Enabled by default. This can be
353 # potentially CPU-intensive, of course.
354 # Note that you need to have 'search' feature enabled too.
356 # To enable system wide have in $GITWEB_CONFIG
357 # $feature{'grep'}{'default'} = [1];
358 # To have project specific config enable override in $GITWEB_CONFIG
359 # $feature{'grep'}{'override'} = 1;
360 # and in project config gitweb.grep = 0|1;
361 'grep' => {
362 'sub' => sub { feature_bool('grep', @_) },
363 'override' => 0,
364 'default' => [1]},
366 # Enable the pickaxe search, which will list the commits that modified
367 # a given string in a file. This can be practical and quite faster
368 # alternative to 'blame', but still potentially CPU-intensive.
369 # Note that you need to have 'search' feature enabled too.
371 # To enable system wide have in $GITWEB_CONFIG
372 # $feature{'pickaxe'}{'default'} = [1];
373 # To have project specific config enable override in $GITWEB_CONFIG
374 # $feature{'pickaxe'}{'override'} = 1;
375 # and in project config gitweb.pickaxe = 0|1;
376 'pickaxe' => {
377 'sub' => sub { feature_bool('pickaxe', @_) },
378 'override' => 0,
379 'default' => [1]},
381 # Enable showing size of blobs in a 'tree' view, in a separate
382 # column, similar to what 'ls -l' does. This cost a bit of IO.
384 # To disable system wide have in $GITWEB_CONFIG
385 # $feature{'show-sizes'}{'default'} = [0];
386 # To have project specific config enable override in $GITWEB_CONFIG
387 # $feature{'show-sizes'}{'override'} = 1;
388 # and in project config gitweb.showsizes = 0|1;
389 'show-sizes' => {
390 'sub' => sub { feature_bool('showsizes', @_) },
391 'override' => 0,
392 'default' => [1]},
394 # Make gitweb use an alternative format of the URLs which can be
395 # more readable and natural-looking: project name is embedded
396 # directly in the path and the query string contains other
397 # auxiliary information. All gitweb installations recognize
398 # URL in either format; this configures in which formats gitweb
399 # generates links.
401 # To enable system wide have in $GITWEB_CONFIG
402 # $feature{'pathinfo'}{'default'} = [1];
403 # Project specific override is not supported.
405 # Note that you will need to change the default location of CSS,
406 # favicon, logo and possibly other files to an absolute URL. Also,
407 # if gitweb.cgi serves as your indexfile, you will need to force
408 # $my_uri to contain the script name in your $GITWEB_CONFIG.
409 'pathinfo' => {
410 'override' => 0,
411 'default' => [0]},
413 # Make gitweb consider projects in project root subdirectories
414 # to be forks of existing projects. Given project $projname.git,
415 # projects matching $projname/*.git will not be shown in the main
416 # projects list, instead a '+' mark will be added to $projname
417 # there and a 'forks' view will be enabled for the project, listing
418 # all the forks. If project list is taken from a file, forks have
419 # to be listed after the main project.
421 # To enable system wide have in $GITWEB_CONFIG
422 # $feature{'forks'}{'default'} = [1];
423 # Project specific override is not supported.
424 'forks' => {
425 'override' => 0,
426 'default' => [0]},
428 # Insert custom links to the action bar of all project pages.
429 # This enables you mainly to link to third-party scripts integrating
430 # into gitweb; e.g. git-browser for graphical history representation
431 # or custom web-based repository administration interface.
433 # The 'default' value consists of a list of triplets in the form
434 # (label, link, position) where position is the label after which
435 # to insert the link and link is a format string where %n expands
436 # to the project name, %f to the project path within the filesystem,
437 # %h to the current hash (h gitweb parameter) and %b to the current
438 # hash base (hb gitweb parameter); %% expands to %.
440 # To enable system wide have in $GITWEB_CONFIG e.g.
441 # $feature{'actions'}{'default'} = [('graphiclog',
442 # '/git-browser/by-commit.html?r=%n', 'summary')];
443 # Project specific override is not supported.
444 'actions' => {
445 'override' => 0,
446 'default' => []},
448 # Allow gitweb scan project content tags of project repository,
449 # and display the popular Web 2.0-ish "tag cloud" near the projects
450 # list. Note that this is something COMPLETELY different from the
451 # normal Git tags.
453 # gitweb by itself can show existing tags, but it does not handle
454 # tagging itself; you need to do it externally, outside gitweb.
455 # The format is described in git_get_project_ctags() subroutine.
456 # You may want to install the HTML::TagCloud Perl module to get
457 # a pretty tag cloud instead of just a list of tags.
459 # To enable system wide have in $GITWEB_CONFIG
460 # $feature{'ctags'}{'default'} = [1];
461 # Project specific override is not supported.
463 # In the future whether ctags editing is enabled might depend
464 # on the value, but using 1 should always mean no editing of ctags.
465 'ctags' => {
466 'override' => 0,
467 'default' => [0]},
469 # The maximum number of patches in a patchset generated in patch
470 # view. Set this to 0 or undef to disable patch view, or to a
471 # negative number to remove any limit.
473 # To disable system wide have in $GITWEB_CONFIG
474 # $feature{'patches'}{'default'} = [0];
475 # To have project specific config enable override in $GITWEB_CONFIG
476 # $feature{'patches'}{'override'} = 1;
477 # and in project config gitweb.patches = 0|n;
478 # where n is the maximum number of patches allowed in a patchset.
479 'patches' => {
480 'sub' => \&feature_patches,
481 'override' => 0,
482 'default' => [16]},
484 # Avatar support. When this feature is enabled, views such as
485 # shortlog or commit will display an avatar associated with
486 # the email of the committer(s) and/or author(s).
488 # Currently available providers are gravatar and picon.
489 # If an unknown provider is specified, the feature is disabled.
491 # Gravatar depends on Digest::MD5.
492 # Picon currently relies on the indiana.edu database.
494 # To enable system wide have in $GITWEB_CONFIG
495 # $feature{'avatar'}{'default'} = ['<provider>'];
496 # where <provider> is either gravatar or picon.
497 # To have project specific config enable override in $GITWEB_CONFIG
498 # $feature{'avatar'}{'override'} = 1;
499 # and in project config gitweb.avatar = <provider>;
500 'avatar' => {
501 'sub' => \&feature_avatar,
502 'override' => 0,
503 'default' => ['']},
505 # Enable displaying how much time and how many git commands
506 # it took to generate and display page. Disabled by default.
507 # Project specific override is not supported.
508 'timed' => {
509 'override' => 0,
510 'default' => [0]},
512 # Enable turning some links into links to actions which require
513 # JavaScript to run (like 'blame_incremental'). Not enabled by
514 # default. Project specific override is currently not supported.
515 'javascript-actions' => {
516 'override' => 0,
517 'default' => [0]},
519 # Enable and configure ability to change common timezone for dates
520 # in gitweb output via JavaScript. Enabled by default.
521 # Project specific override is not supported.
522 'javascript-timezone' => {
523 'override' => 0,
524 'default' => [
525 'local', # default timezone: 'utc', 'local', or '(-|+)HHMM' format,
526 # or undef to turn off this feature
527 'gitweb_tz', # name of cookie where to store selected timezone
528 'datetime', # CSS class used to mark up dates for manipulation
531 # Syntax highlighting support. This is based on Daniel Svensson's
532 # and Sham Chukoury's work in gitweb-xmms2.git.
533 # It requires the 'highlight' program present in $PATH,
534 # and therefore is disabled by default.
536 # To enable system wide have in $GITWEB_CONFIG
537 # $feature{'highlight'}{'default'} = [1];
539 'highlight' => {
540 'sub' => sub { feature_bool('highlight', @_) },
541 'override' => 0,
542 'default' => [0]},
544 # Enable displaying of remote heads in the heads list
546 # To enable system wide have in $GITWEB_CONFIG
547 # $feature{'remote_heads'}{'default'} = [1];
548 # To have project specific config enable override in $GITWEB_CONFIG
549 # $feature{'remote_heads'}{'override'} = 1;
550 # and in project config gitweb.remoteheads = 0|1;
551 'remote_heads' => {
552 'sub' => sub { feature_bool('remote_heads', @_) },
553 'override' => 0,
554 'default' => [0]},
556 # Enable showing branches under other refs in addition to heads
558 # To set system wide extra branch refs have in $GITWEB_CONFIG
559 # $feature{'extra-branch-refs'}{'default'} = ['dirs', 'of', 'choice'];
560 # To have project specific config enable override in $GITWEB_CONFIG
561 # $feature{'extra-branch-refs'}{'override'} = 1;
562 # and in project config gitweb.extrabranchrefs = dirs of choice
563 # Every directory is separated with whitespace.
565 'extra-branch-refs' => {
566 'sub' => \&feature_extra_branch_refs,
567 'override' => 0,
568 'default' => []},
571 sub gitweb_get_feature {
572 my ($name) = @_;
573 return unless exists $feature{$name};
574 my ($sub, $override, @defaults) = (
575 $feature{$name}{'sub'},
576 $feature{$name}{'override'},
577 @{$feature{$name}{'default'}});
578 # project specific override is possible only if we have project
579 our $git_dir; # global variable, declared later
580 if (!$override || !defined $git_dir) {
581 return @defaults;
583 if (!defined $sub) {
584 warn "feature $name is not overridable";
585 return @defaults;
587 return $sub->(@defaults);
590 # A wrapper to check if a given feature is enabled.
591 # With this, you can say
593 # my $bool_feat = gitweb_check_feature('bool_feat');
594 # gitweb_check_feature('bool_feat') or somecode;
596 # instead of
598 # my ($bool_feat) = gitweb_get_feature('bool_feat');
599 # (gitweb_get_feature('bool_feat'))[0] or somecode;
601 sub gitweb_check_feature {
602 return (gitweb_get_feature(@_))[0];
606 sub feature_bool {
607 my $key = shift;
608 my ($val) = git_get_project_config($key, '--bool');
610 if (!defined $val) {
611 return ($_[0]);
612 } elsif ($val eq 'true') {
613 return (1);
614 } elsif ($val eq 'false') {
615 return (0);
619 sub feature_snapshot {
620 my (@fmts) = @_;
622 my ($val) = git_get_project_config('snapshot');
624 if ($val) {
625 @fmts = ($val eq 'none' ? () : split /\s*[,\s]\s*/, $val);
628 return @fmts;
631 sub feature_patches {
632 my @val = (git_get_project_config('patches', '--int'));
634 if (@val) {
635 return @val;
638 return ($_[0]);
641 sub feature_avatar {
642 my @val = (git_get_project_config('avatar'));
644 return @val ? @val : @_;
647 sub feature_extra_branch_refs {
648 my (@branch_refs) = @_;
649 my $values = git_get_project_config('extrabranchrefs');
651 if ($values) {
652 $values = config_to_multi ($values);
653 @branch_refs = ();
654 foreach my $value (@{$values}) {
655 push @branch_refs, split /\s+/, $value;
659 return @branch_refs;
662 # checking HEAD file with -e is fragile if the repository was
663 # initialized long time ago (i.e. symlink HEAD) and was pack-ref'ed
664 # and then pruned.
665 sub check_head_link {
666 my ($dir) = @_;
667 my $headfile = "$dir/HEAD";
668 return ((-e $headfile) ||
669 (-l $headfile && readlink($headfile) =~ /^refs\/heads\//));
672 sub check_export_ok {
673 my ($dir) = @_;
674 return (check_head_link($dir) &&
675 (!$export_ok || -e "$dir/$export_ok") &&
676 (!$export_auth_hook || $export_auth_hook->($dir)));
679 # process alternate names for backward compatibility
680 # filter out unsupported (unknown) snapshot formats
681 sub filter_snapshot_fmts {
682 my @fmts = @_;
684 @fmts = map {
685 exists $known_snapshot_format_aliases{$_} ?
686 $known_snapshot_format_aliases{$_} : $_} @fmts;
687 @fmts = grep {
688 exists $known_snapshot_formats{$_} &&
689 !$known_snapshot_formats{$_}{'disabled'}} @fmts;
692 sub filter_and_validate_refs {
693 my @refs = @_;
694 my %unique_refs = ();
696 foreach my $ref (@refs) {
697 die_error(500, "Invalid ref '$ref' in 'extra-branch-refs' feature") unless (is_valid_ref_format($ref));
698 # 'heads' are added implicitly in get_branch_refs().
699 $unique_refs{$ref} = 1 if ($ref ne 'heads');
701 return sort keys %unique_refs;
704 # If it is set to code reference, it is code that it is to be run once per
705 # request, allowing updating configurations that change with each request,
706 # while running other code in config file only once.
708 # Otherwise, if it is false then gitweb would process config file only once;
709 # if it is true then gitweb config would be run for each request.
710 our $per_request_config = 1;
712 # read and parse gitweb config file given by its parameter.
713 # returns true on success, false on recoverable error, allowing
714 # to chain this subroutine, using first file that exists.
715 # dies on errors during parsing config file, as it is unrecoverable.
716 sub read_config_file {
717 my $filename = shift;
718 return unless defined $filename;
719 # die if there are errors parsing config file
720 if (-e $filename) {
721 do $filename;
722 die $@ if $@;
723 return 1;
725 return;
728 our ($GITWEB_CONFIG, $GITWEB_CONFIG_SYSTEM, $GITWEB_CONFIG_COMMON);
729 sub evaluate_gitweb_config {
730 our $GITWEB_CONFIG = $ENV{'GITWEB_CONFIG'} || "++GITWEB_CONFIG++";
731 our $GITWEB_CONFIG_SYSTEM = $ENV{'GITWEB_CONFIG_SYSTEM'} || "++GITWEB_CONFIG_SYSTEM++";
732 our $GITWEB_CONFIG_COMMON = $ENV{'GITWEB_CONFIG_COMMON'} || "++GITWEB_CONFIG_COMMON++";
734 # Protect against duplications of file names, to not read config twice.
735 # Only one of $GITWEB_CONFIG and $GITWEB_CONFIG_SYSTEM is used, so
736 # there possibility of duplication of filename there doesn't matter.
737 $GITWEB_CONFIG = "" if ($GITWEB_CONFIG eq $GITWEB_CONFIG_COMMON);
738 $GITWEB_CONFIG_SYSTEM = "" if ($GITWEB_CONFIG_SYSTEM eq $GITWEB_CONFIG_COMMON);
740 # Common system-wide settings for convenience.
741 # Those settings can be ovverriden by GITWEB_CONFIG or GITWEB_CONFIG_SYSTEM.
742 read_config_file($GITWEB_CONFIG_COMMON);
744 # Use first config file that exists. This means use the per-instance
745 # GITWEB_CONFIG if exists, otherwise use GITWEB_SYSTEM_CONFIG.
746 read_config_file($GITWEB_CONFIG) and return;
747 read_config_file($GITWEB_CONFIG_SYSTEM);
750 # Get loadavg of system, to compare against $maxload.
751 # Currently it requires '/proc/loadavg' present to get loadavg;
752 # if it is not present it returns 0, which means no load checking.
753 sub get_loadavg {
754 if( -e '/proc/loadavg' ){
755 open my $fd, '<', '/proc/loadavg'
756 or return 0;
757 my @load = split(/\s+/, scalar <$fd>);
758 close $fd;
760 # The first three columns measure CPU and IO utilization of the last one,
761 # five, and 10 minute periods. The fourth column shows the number of
762 # currently running processes and the total number of processes in the m/n
763 # format. The last column displays the last process ID used.
764 return $load[0] || 0;
766 # additional checks for load average should go here for things that don't export
767 # /proc/loadavg
769 return 0;
772 # version of the core git binary
773 our $git_version;
774 sub evaluate_git_version {
775 our $git_version = qx("$GIT" --version) =~ m/git version (.*)$/ ? $1 : "unknown";
776 $number_of_git_cmds++;
779 sub check_loadavg {
780 if (defined $maxload && get_loadavg() > $maxload) {
781 die_error(503, "The load average on the server is too high");
785 # ======================================================================
786 # input validation and dispatch
788 # input parameters can be collected from a variety of sources (presently, CGI
789 # and PATH_INFO), so we define an %input_params hash that collects them all
790 # together during validation: this allows subsequent uses (e.g. href()) to be
791 # agnostic of the parameter origin
793 our %input_params = ();
795 # input parameters are stored with the long parameter name as key. This will
796 # also be used in the href subroutine to convert parameters to their CGI
797 # equivalent, and since the href() usage is the most frequent one, we store
798 # the name -> CGI key mapping here, instead of the reverse.
800 # XXX: Warning: If you touch this, check the search form for updating,
801 # too.
803 our @cgi_param_mapping = (
804 project => "p",
805 action => "a",
806 file_name => "f",
807 file_parent => "fp",
808 hash => "h",
809 hash_parent => "hp",
810 hash_base => "hb",
811 hash_parent_base => "hpb",
812 page => "pg",
813 order => "o",
814 searchtext => "s",
815 searchtype => "st",
816 snapshot_format => "sf",
817 extra_options => "opt",
818 search_use_regexp => "sr",
819 ctag => "by_tag",
820 diff_style => "ds",
821 project_filter => "pf",
822 # this must be last entry (for manipulation from JavaScript)
823 javascript => "js"
825 our %cgi_param_mapping = @cgi_param_mapping;
827 # we will also need to know the possible actions, for validation
828 our %actions = (
829 "blame" => \&git_blame,
830 "blame_incremental" => \&git_blame_incremental,
831 "blame_data" => \&git_blame_data,
832 "blobdiff" => \&git_blobdiff,
833 "blobdiff_plain" => \&git_blobdiff_plain,
834 "blob" => \&git_blob,
835 "blob_plain" => \&git_blob_plain,
836 "commitdiff" => \&git_commitdiff,
837 "commitdiff_plain" => \&git_commitdiff_plain,
838 "commit" => \&git_commit,
839 "forks" => \&git_forks,
840 "heads" => \&git_heads,
841 "history" => \&git_history,
842 "log" => \&git_log,
843 "patch" => \&git_patch,
844 "patches" => \&git_patches,
845 "remotes" => \&git_remotes,
846 "rss" => \&git_rss,
847 "atom" => \&git_atom,
848 "search" => \&git_search,
849 "search_help" => \&git_search_help,
850 "shortlog" => \&git_shortlog,
851 "summary" => \&git_summary,
852 "tag" => \&git_tag,
853 "tags" => \&git_tags,
854 "tree" => \&git_tree,
855 "snapshot" => \&git_snapshot,
856 "object" => \&git_object,
857 # those below don't need $project
858 "opml" => \&git_opml,
859 "project_list" => \&git_project_list,
860 "project_index" => \&git_project_index,
863 # finally, we have the hash of allowed extra_options for the commands that
864 # allow them
865 our %allowed_options = (
866 "--no-merges" => [ qw(rss atom log shortlog history) ],
869 # fill %input_params with the CGI parameters. All values except for 'opt'
870 # should be single values, but opt can be an array. We should probably
871 # build an array of parameters that can be multi-valued, but since for the time
872 # being it's only this one, we just single it out
873 sub evaluate_query_params {
874 our $cgi;
876 while (my ($name, $symbol) = each %cgi_param_mapping) {
877 if ($symbol eq 'opt') {
878 $input_params{$name} = [ map { decode_utf8($_) } $cgi->multi_param($symbol) ];
879 } else {
880 $input_params{$name} = decode_utf8($cgi->param($symbol));
885 # now read PATH_INFO and update the parameter list for missing parameters
886 sub evaluate_path_info {
887 return if defined $input_params{'project'};
888 return if !$path_info;
889 $path_info =~ s,^/+,,;
890 return if !$path_info;
892 # find which part of PATH_INFO is project
893 my $project = $path_info;
894 $project =~ s,/+$,,;
895 while ($project && !check_head_link("$projectroot/$project")) {
896 $project =~ s,/*[^/]*$,,;
898 return unless $project;
899 $input_params{'project'} = $project;
901 # do not change any parameters if an action is given using the query string
902 return if $input_params{'action'};
903 $path_info =~ s,^\Q$project\E/*,,;
905 # next, check if we have an action
906 my $action = $path_info;
907 $action =~ s,/.*$,,;
908 if (exists $actions{$action}) {
909 $path_info =~ s,^$action/*,,;
910 $input_params{'action'} = $action;
913 # list of actions that want hash_base instead of hash, but can have no
914 # pathname (f) parameter
915 my @wants_base = (
916 'tree',
917 'history',
920 # we want to catch, among others
921 # [$hash_parent_base[:$file_parent]..]$hash_parent[:$file_name]
922 my ($parentrefname, $parentpathname, $refname, $pathname) =
923 ($path_info =~ /^(?:(.+?)(?::(.+))?\.\.)?([^:]+?)?(?::(.+))?$/);
925 # first, analyze the 'current' part
926 if (defined $pathname) {
927 # we got "branch:filename" or "branch:dir/"
928 # we could use git_get_type(branch:pathname), but:
929 # - it needs $git_dir
930 # - it does a git() call
931 # - the convention of terminating directories with a slash
932 # makes it superfluous
933 # - embedding the action in the PATH_INFO would make it even
934 # more superfluous
935 $pathname =~ s,^/+,,;
936 if (!$pathname || substr($pathname, -1) eq "/") {
937 $input_params{'action'} ||= "tree";
938 $pathname =~ s,/$,,;
939 } else {
940 # the default action depends on whether we had parent info
941 # or not
942 if ($parentrefname) {
943 $input_params{'action'} ||= "blobdiff_plain";
944 } else {
945 $input_params{'action'} ||= "blob_plain";
948 $input_params{'hash_base'} ||= $refname;
949 $input_params{'file_name'} ||= $pathname;
950 } elsif (defined $refname) {
951 # we got "branch". In this case we have to choose if we have to
952 # set hash or hash_base.
954 # Most of the actions without a pathname only want hash to be
955 # set, except for the ones specified in @wants_base that want
956 # hash_base instead. It should also be noted that hand-crafted
957 # links having 'history' as an action and no pathname or hash
958 # set will fail, but that happens regardless of PATH_INFO.
959 if (defined $parentrefname) {
960 # if there is parent let the default be 'shortlog' action
961 # (for http://git.example.com/repo.git/A..B links); if there
962 # is no parent, dispatch will detect type of object and set
963 # action appropriately if required (if action is not set)
964 $input_params{'action'} ||= "shortlog";
966 if ($input_params{'action'} &&
967 grep { $_ eq $input_params{'action'} } @wants_base) {
968 $input_params{'hash_base'} ||= $refname;
969 } else {
970 $input_params{'hash'} ||= $refname;
974 # next, handle the 'parent' part, if present
975 if (defined $parentrefname) {
976 # a missing pathspec defaults to the 'current' filename, allowing e.g.
977 # someproject/blobdiff/oldrev..newrev:/filename
978 if ($parentpathname) {
979 $parentpathname =~ s,^/+,,;
980 $parentpathname =~ s,/$,,;
981 $input_params{'file_parent'} ||= $parentpathname;
982 } else {
983 $input_params{'file_parent'} ||= $input_params{'file_name'};
985 # we assume that hash_parent_base is wanted if a path was specified,
986 # or if the action wants hash_base instead of hash
987 if (defined $input_params{'file_parent'} ||
988 grep { $_ eq $input_params{'action'} } @wants_base) {
989 $input_params{'hash_parent_base'} ||= $parentrefname;
990 } else {
991 $input_params{'hash_parent'} ||= $parentrefname;
995 # for the snapshot action, we allow URLs in the form
996 # $project/snapshot/$hash.ext
997 # where .ext determines the snapshot and gets removed from the
998 # passed $refname to provide the $hash.
1000 # To be able to tell that $refname includes the format extension, we
1001 # require the following two conditions to be satisfied:
1002 # - the hash input parameter MUST have been set from the $refname part
1003 # of the URL (i.e. they must be equal)
1004 # - the snapshot format MUST NOT have been defined already (e.g. from
1005 # CGI parameter sf)
1006 # It's also useless to try any matching unless $refname has a dot,
1007 # so we check for that too
1008 if (defined $input_params{'action'} &&
1009 $input_params{'action'} eq 'snapshot' &&
1010 defined $refname && index($refname, '.') != -1 &&
1011 $refname eq $input_params{'hash'} &&
1012 !defined $input_params{'snapshot_format'}) {
1013 # We loop over the known snapshot formats, checking for
1014 # extensions. Allowed extensions are both the defined suffix
1015 # (which includes the initial dot already) and the snapshot
1016 # format key itself, with a prepended dot
1017 while (my ($fmt, $opt) = each %known_snapshot_formats) {
1018 my $hash = $refname;
1019 unless ($hash =~ s/(\Q$opt->{'suffix'}\E|\Q.$fmt\E)$//) {
1020 next;
1022 my $sfx = $1;
1023 # a valid suffix was found, so set the snapshot format
1024 # and reset the hash parameter
1025 $input_params{'snapshot_format'} = $fmt;
1026 $input_params{'hash'} = $hash;
1027 # we also set the format suffix to the one requested
1028 # in the URL: this way a request for e.g. .tgz returns
1029 # a .tgz instead of a .tar.gz
1030 $known_snapshot_formats{$fmt}{'suffix'} = $sfx;
1031 last;
1036 our ($action, $project, $file_name, $file_parent, $hash, $hash_parent, $hash_base,
1037 $hash_parent_base, @extra_options, $page, $searchtype, $search_use_regexp,
1038 $searchtext, $search_regexp, $project_filter);
1039 sub evaluate_and_validate_params {
1040 our $action = $input_params{'action'};
1041 if (defined $action) {
1042 if (!is_valid_action($action)) {
1043 die_error(400, "Invalid action parameter");
1047 # parameters which are pathnames
1048 our $project = $input_params{'project'};
1049 if (defined $project) {
1050 if (!is_valid_project($project)) {
1051 undef $project;
1052 die_error(404, "No such project");
1056 our $project_filter = $input_params{'project_filter'};
1057 if (defined $project_filter) {
1058 if (!is_valid_pathname($project_filter)) {
1059 die_error(404, "Invalid project_filter parameter");
1063 our $file_name = $input_params{'file_name'};
1064 if (defined $file_name) {
1065 if (!is_valid_pathname($file_name)) {
1066 die_error(400, "Invalid file parameter");
1070 our $file_parent = $input_params{'file_parent'};
1071 if (defined $file_parent) {
1072 if (!is_valid_pathname($file_parent)) {
1073 die_error(400, "Invalid file parent parameter");
1077 # parameters which are refnames
1078 our $hash = $input_params{'hash'};
1079 if (defined $hash) {
1080 if (!is_valid_refname($hash)) {
1081 die_error(400, "Invalid hash parameter");
1085 our $hash_parent = $input_params{'hash_parent'};
1086 if (defined $hash_parent) {
1087 if (!is_valid_refname($hash_parent)) {
1088 die_error(400, "Invalid hash parent parameter");
1092 our $hash_base = $input_params{'hash_base'};
1093 if (defined $hash_base) {
1094 if (!is_valid_refname($hash_base)) {
1095 die_error(400, "Invalid hash base parameter");
1099 our @extra_options = @{$input_params{'extra_options'}};
1100 # @extra_options is always defined, since it can only be (currently) set from
1101 # CGI, and $cgi->param() returns the empty array in array context if the param
1102 # is not set
1103 foreach my $opt (@extra_options) {
1104 if (not exists $allowed_options{$opt}) {
1105 die_error(400, "Invalid option parameter");
1107 if (not grep(/^$action$/, @{$allowed_options{$opt}})) {
1108 die_error(400, "Invalid option parameter for this action");
1112 our $hash_parent_base = $input_params{'hash_parent_base'};
1113 if (defined $hash_parent_base) {
1114 if (!is_valid_refname($hash_parent_base)) {
1115 die_error(400, "Invalid hash parent base parameter");
1119 # other parameters
1120 our $page = $input_params{'page'};
1121 if (defined $page) {
1122 if ($page =~ m/[^0-9]/) {
1123 die_error(400, "Invalid page parameter");
1127 our $searchtype = $input_params{'searchtype'};
1128 if (defined $searchtype) {
1129 if ($searchtype =~ m/[^a-z]/) {
1130 die_error(400, "Invalid searchtype parameter");
1134 our $search_use_regexp = $input_params{'search_use_regexp'};
1136 our $searchtext = $input_params{'searchtext'};
1137 our $search_regexp = undef;
1138 if (defined $searchtext) {
1139 if (length($searchtext) < 2) {
1140 die_error(403, "At least two characters are required for search parameter");
1142 if ($search_use_regexp) {
1143 $search_regexp = $searchtext;
1144 if (!eval { qr/$search_regexp/; 1; }) {
1145 (my $error = $@) =~ s/ at \S+ line \d+.*\n?//;
1146 die_error(400, "Invalid search regexp '$search_regexp'",
1147 esc_html($error));
1149 } else {
1150 $search_regexp = quotemeta $searchtext;
1155 # path to the current git repository
1156 our $git_dir;
1157 sub evaluate_git_dir {
1158 our $git_dir = "$projectroot/$project" if $project;
1161 our (@snapshot_fmts, $git_avatar, @extra_branch_refs);
1162 sub configure_gitweb_features {
1163 # list of supported snapshot formats
1164 our @snapshot_fmts = gitweb_get_feature('snapshot');
1165 @snapshot_fmts = filter_snapshot_fmts(@snapshot_fmts);
1167 # check that the avatar feature is set to a known provider name,
1168 # and for each provider check if the dependencies are satisfied.
1169 # if the provider name is invalid or the dependencies are not met,
1170 # reset $git_avatar to the empty string.
1171 our ($git_avatar) = gitweb_get_feature('avatar');
1172 if ($git_avatar eq 'gravatar') {
1173 $git_avatar = '' unless (eval { require Digest::MD5; 1; });
1174 } elsif ($git_avatar eq 'picon') {
1175 # no dependencies
1176 } else {
1177 $git_avatar = '';
1180 our @extra_branch_refs = gitweb_get_feature('extra-branch-refs');
1181 @extra_branch_refs = filter_and_validate_refs (@extra_branch_refs);
1184 sub get_branch_refs {
1185 return ('heads', @extra_branch_refs);
1188 # custom error handler: 'die <message>' is Internal Server Error
1189 sub handle_errors_html {
1190 my $msg = shift; # it is already HTML escaped
1192 # to avoid infinite loop where error occurs in die_error,
1193 # change handler to default handler, disabling handle_errors_html
1194 set_message("Error occurred when inside die_error:\n$msg");
1196 # you cannot jump out of die_error when called as error handler;
1197 # the subroutine set via CGI::Carp::set_message is called _after_
1198 # HTTP headers are already written, so it cannot write them itself
1199 die_error(undef, undef, $msg, -error_handler => 1, -no_http_header => 1);
1201 set_message(\&handle_errors_html);
1203 # dispatch
1204 sub dispatch {
1205 if (!defined $action) {
1206 if (defined $hash) {
1207 $action = git_get_type($hash);
1208 $action or die_error(404, "Object does not exist");
1209 } elsif (defined $hash_base && defined $file_name) {
1210 $action = git_get_type("$hash_base:$file_name");
1211 $action or die_error(404, "File or directory does not exist");
1212 } elsif (defined $project) {
1213 $action = 'summary';
1214 } else {
1215 $action = 'project_list';
1218 if (!defined($actions{$action})) {
1219 die_error(400, "Unknown action");
1221 if ($action !~ m/^(?:opml|project_list|project_index)$/ &&
1222 !$project) {
1223 die_error(400, "Project needed");
1225 $actions{$action}->();
1228 sub reset_timer {
1229 our $t0 = [ gettimeofday() ]
1230 if defined $t0;
1231 our $number_of_git_cmds = 0;
1234 our $first_request = 1;
1235 sub run_request {
1236 reset_timer();
1238 evaluate_uri();
1239 if ($first_request) {
1240 evaluate_gitweb_config();
1241 evaluate_git_version();
1243 if ($per_request_config) {
1244 if (ref($per_request_config) eq 'CODE') {
1245 $per_request_config->();
1246 } elsif (!$first_request) {
1247 evaluate_gitweb_config();
1250 check_loadavg();
1252 # $projectroot and $projects_list might be set in gitweb config file
1253 $projects_list ||= $projectroot;
1255 evaluate_query_params();
1256 evaluate_path_info();
1257 evaluate_and_validate_params();
1258 evaluate_git_dir();
1260 configure_gitweb_features();
1262 dispatch();
1265 our $is_last_request = sub { 1 };
1266 our ($pre_dispatch_hook, $post_dispatch_hook, $pre_listen_hook);
1267 our $CGI = 'CGI';
1268 our $cgi;
1269 sub configure_as_fcgi {
1270 require CGI::Fast;
1271 our $CGI = 'CGI::Fast';
1273 my $request_number = 0;
1274 # let each child service 100 requests
1275 our $is_last_request = sub { ++$request_number > 100 };
1277 sub evaluate_argv {
1278 my $script_name = $ENV{'SCRIPT_NAME'} || $ENV{'SCRIPT_FILENAME'} || __FILE__;
1279 configure_as_fcgi()
1280 if $script_name =~ /\.fcgi$/;
1282 return unless (@ARGV);
1284 require Getopt::Long;
1285 Getopt::Long::GetOptions(
1286 'fastcgi|fcgi|f' => \&configure_as_fcgi,
1287 'nproc|n=i' => sub {
1288 my ($arg, $val) = @_;
1289 return unless eval { require FCGI::ProcManager; 1; };
1290 my $proc_manager = FCGI::ProcManager->new({
1291 n_processes => $val,
1293 our $pre_listen_hook = sub { $proc_manager->pm_manage() };
1294 our $pre_dispatch_hook = sub { $proc_manager->pm_pre_dispatch() };
1295 our $post_dispatch_hook = sub { $proc_manager->pm_post_dispatch() };
1300 sub run {
1301 evaluate_argv();
1303 $first_request = 1;
1304 $pre_listen_hook->()
1305 if $pre_listen_hook;
1307 REQUEST:
1308 while ($cgi = $CGI->new()) {
1309 $pre_dispatch_hook->()
1310 if $pre_dispatch_hook;
1312 run_request();
1314 $post_dispatch_hook->()
1315 if $post_dispatch_hook;
1316 $first_request = 0;
1318 last REQUEST if ($is_last_request->());
1321 DONE_GITWEB:
1325 run();
1327 if (defined caller) {
1328 # wrapped in a subroutine processing requests,
1329 # e.g. mod_perl with ModPerl::Registry, or PSGI with Plack::App::WrapCGI
1330 return;
1331 } else {
1332 # pure CGI script, serving single request
1333 exit;
1336 ## ======================================================================
1337 ## action links
1339 # possible values of extra options
1340 # -full => 0|1 - use absolute/full URL ($my_uri/$my_url as base)
1341 # -replay => 1 - start from a current view (replay with modifications)
1342 # -path_info => 0|1 - don't use/use path_info URL (if possible)
1343 # -anchor => ANCHOR - add #ANCHOR to end of URL, implies -replay if used alone
1344 sub href {
1345 my %params = @_;
1346 # default is to use -absolute url() i.e. $my_uri
1347 my $href = $params{-full} ? $my_url : $my_uri;
1349 # implicit -replay, must be first of implicit params
1350 $params{-replay} = 1 if (keys %params == 1 && $params{-anchor});
1352 $params{'project'} = $project unless exists $params{'project'};
1354 if ($params{-replay}) {
1355 while (my ($name, $symbol) = each %cgi_param_mapping) {
1356 if (!exists $params{$name}) {
1357 $params{$name} = $input_params{$name};
1362 my $use_pathinfo = gitweb_check_feature('pathinfo');
1363 if (defined $params{'project'} &&
1364 (exists $params{-path_info} ? $params{-path_info} : $use_pathinfo)) {
1365 # try to put as many parameters as possible in PATH_INFO:
1366 # - project name
1367 # - action
1368 # - hash_parent or hash_parent_base:/file_parent
1369 # - hash or hash_base:/filename
1370 # - the snapshot_format as an appropriate suffix
1372 # When the script is the root DirectoryIndex for the domain,
1373 # $href here would be something like http://gitweb.example.com/
1374 # Thus, we strip any trailing / from $href, to spare us double
1375 # slashes in the final URL
1376 $href =~ s,/$,,;
1378 # Then add the project name, if present
1379 $href .= "/".esc_path_info($params{'project'});
1380 delete $params{'project'};
1382 # since we destructively absorb parameters, we keep this
1383 # boolean that remembers if we're handling a snapshot
1384 my $is_snapshot = $params{'action'} eq 'snapshot';
1386 # Summary just uses the project path URL, any other action is
1387 # added to the URL
1388 if (defined $params{'action'}) {
1389 $href .= "/".esc_path_info($params{'action'})
1390 unless $params{'action'} eq 'summary';
1391 delete $params{'action'};
1394 # Next, we put hash_parent_base:/file_parent..hash_base:/file_name,
1395 # stripping nonexistent or useless pieces
1396 $href .= "/" if ($params{'hash_base'} || $params{'hash_parent_base'}
1397 || $params{'hash_parent'} || $params{'hash'});
1398 if (defined $params{'hash_base'}) {
1399 if (defined $params{'hash_parent_base'}) {
1400 $href .= esc_path_info($params{'hash_parent_base'});
1401 # skip the file_parent if it's the same as the file_name
1402 if (defined $params{'file_parent'}) {
1403 if (defined $params{'file_name'} && $params{'file_parent'} eq $params{'file_name'}) {
1404 delete $params{'file_parent'};
1405 } elsif ($params{'file_parent'} !~ /\.\./) {
1406 $href .= ":/".esc_path_info($params{'file_parent'});
1407 delete $params{'file_parent'};
1410 $href .= "..";
1411 delete $params{'hash_parent'};
1412 delete $params{'hash_parent_base'};
1413 } elsif (defined $params{'hash_parent'}) {
1414 $href .= esc_path_info($params{'hash_parent'}). "..";
1415 delete $params{'hash_parent'};
1418 $href .= esc_path_info($params{'hash_base'});
1419 if (defined $params{'file_name'} && $params{'file_name'} !~ /\.\./) {
1420 $href .= ":/".esc_path_info($params{'file_name'});
1421 delete $params{'file_name'};
1423 delete $params{'hash'};
1424 delete $params{'hash_base'};
1425 } elsif (defined $params{'hash'}) {
1426 $href .= esc_path_info($params{'hash'});
1427 delete $params{'hash'};
1430 # If the action was a snapshot, we can absorb the
1431 # snapshot_format parameter too
1432 if ($is_snapshot) {
1433 my $fmt = $params{'snapshot_format'};
1434 # snapshot_format should always be defined when href()
1435 # is called, but just in case some code forgets, we
1436 # fall back to the default
1437 $fmt ||= $snapshot_fmts[0];
1438 $href .= $known_snapshot_formats{$fmt}{'suffix'};
1439 delete $params{'snapshot_format'};
1443 # now encode the parameters explicitly
1444 my @result = ();
1445 for (my $i = 0; $i < @cgi_param_mapping; $i += 2) {
1446 my ($name, $symbol) = ($cgi_param_mapping[$i], $cgi_param_mapping[$i+1]);
1447 if (defined $params{$name}) {
1448 if (ref($params{$name}) eq "ARRAY") {
1449 foreach my $par (@{$params{$name}}) {
1450 push @result, $symbol . "=" . esc_param($par);
1452 } else {
1453 push @result, $symbol . "=" . esc_param($params{$name});
1457 $href .= "?" . join(';', @result) if scalar @result;
1459 # final transformation: trailing spaces must be escaped (URI-encoded)
1460 $href =~ s/(\s+)$/CGI::escape($1)/e;
1462 if ($params{-anchor}) {
1463 $href .= "#".esc_param($params{-anchor});
1466 return $href;
1470 ## ======================================================================
1471 ## validation, quoting/unquoting and escaping
1473 sub is_valid_action {
1474 my $input = shift;
1475 return undef unless exists $actions{$input};
1476 return 1;
1479 sub is_valid_project {
1480 my $input = shift;
1482 return unless defined $input;
1483 if (!is_valid_pathname($input) ||
1484 !(-d "$projectroot/$input") ||
1485 !check_export_ok("$projectroot/$input") ||
1486 ($strict_export && !project_in_list($input))) {
1487 return undef;
1488 } else {
1489 return 1;
1493 sub is_valid_pathname {
1494 my $input = shift;
1496 return undef unless defined $input;
1497 # no '.' or '..' as elements of path, i.e. no '.' or '..'
1498 # at the beginning, at the end, and between slashes.
1499 # also this catches doubled slashes
1500 if ($input =~ m!(^|/)(|\.|\.\.)(/|$)!) {
1501 return undef;
1503 # no null characters
1504 if ($input =~ m!\0!) {
1505 return undef;
1507 return 1;
1510 sub is_valid_ref_format {
1511 my $input = shift;
1513 return undef unless defined $input;
1514 # restrictions on ref name according to git-check-ref-format
1515 if ($input =~ m!(/\.|\.\.|[\000-\040\177 ~^:?*\[]|/$)!) {
1516 return undef;
1518 return 1;
1521 sub is_valid_refname {
1522 my $input = shift;
1524 return undef unless defined $input;
1525 # textual hashes are O.K.
1526 if ($input =~ m/^[0-9a-fA-F]{40}$/) {
1527 return 1;
1529 # it must be correct pathname
1530 is_valid_pathname($input) or return undef;
1531 # check git-check-ref-format restrictions
1532 is_valid_ref_format($input) or return undef;
1533 return 1;
1536 # decode sequences of octets in utf8 into Perl's internal form,
1537 # which is utf-8 with utf8 flag set if needed. gitweb writes out
1538 # in utf-8 thanks to "binmode STDOUT, ':utf8'" at beginning
1539 sub to_utf8 {
1540 my $str = shift;
1541 return undef unless defined $str;
1543 if (utf8::is_utf8($str) || utf8::decode($str)) {
1544 return $str;
1545 } else {
1546 return decode($fallback_encoding, $str, Encode::FB_DEFAULT);
1550 # quote unsafe chars, but keep the slash, even when it's not
1551 # correct, but quoted slashes look too horrible in bookmarks
1552 sub esc_param {
1553 my $str = shift;
1554 return undef unless defined $str;
1555 $str =~ s/([^A-Za-z0-9\-_.~()\/:@ ]+)/CGI::escape($1)/eg;
1556 $str =~ s/ /\+/g;
1557 return $str;
1560 # the quoting rules for path_info fragment are slightly different
1561 sub esc_path_info {
1562 my $str = shift;
1563 return undef unless defined $str;
1565 # path_info doesn't treat '+' as space (specially), but '?' must be escaped
1566 $str =~ s/([^A-Za-z0-9\-_.~();\/;:@&= +]+)/CGI::escape($1)/eg;
1568 return $str;
1571 # quote unsafe chars in whole URL, so some characters cannot be quoted
1572 sub esc_url {
1573 my $str = shift;
1574 return undef unless defined $str;
1575 $str =~ s/([^A-Za-z0-9\-_.~();\/;?:@&= ]+)/CGI::escape($1)/eg;
1576 $str =~ s/ /\+/g;
1577 return $str;
1580 # quote unsafe characters in HTML attributes
1581 sub esc_attr {
1583 # for XHTML conformance escaping '"' to '&quot;' is not enough
1584 return esc_html(@_);
1587 # replace invalid utf8 character with SUBSTITUTION sequence
1588 sub esc_html {
1589 my $str = shift;
1590 my %opts = @_;
1592 return undef unless defined $str;
1594 $str = to_utf8($str);
1595 $str = $cgi->escapeHTML($str);
1596 if ($opts{'-nbsp'}) {
1597 $str =~ s/ /&nbsp;/g;
1599 $str =~ s|([[:cntrl:]])|(($1 ne "\t") ? quot_cec($1) : $1)|eg;
1600 return $str;
1603 # quote control characters and escape filename to HTML
1604 sub esc_path {
1605 my $str = shift;
1606 my %opts = @_;
1608 return undef unless defined $str;
1610 $str = to_utf8($str);
1611 $str = $cgi->escapeHTML($str);
1612 if ($opts{'-nbsp'}) {
1613 $str =~ s/ /&nbsp;/g;
1615 $str =~ s|([[:cntrl:]])|quot_cec($1)|eg;
1616 return $str;
1619 # Sanitize for use in XHTML + application/xml+xhtml (valid XML 1.0)
1620 sub sanitize {
1621 my $str = shift;
1623 return undef unless defined $str;
1625 $str = to_utf8($str);
1626 $str =~ s|([[:cntrl:]])|(index("\t\n\r", $1) != -1 ? $1 : quot_cec($1))|eg;
1627 return $str;
1630 # Make control characters "printable", using character escape codes (CEC)
1631 sub quot_cec {
1632 my $cntrl = shift;
1633 my %opts = @_;
1634 my %es = ( # character escape codes, aka escape sequences
1635 "\t" => '\t', # tab (HT)
1636 "\n" => '\n', # line feed (LF)
1637 "\r" => '\r', # carrige return (CR)
1638 "\f" => '\f', # form feed (FF)
1639 "\b" => '\b', # backspace (BS)
1640 "\a" => '\a', # alarm (bell) (BEL)
1641 "\e" => '\e', # escape (ESC)
1642 "\013" => '\v', # vertical tab (VT)
1643 "\000" => '\0', # nul character (NUL)
1645 my $chr = ( (exists $es{$cntrl})
1646 ? $es{$cntrl}
1647 : sprintf('\%2x', ord($cntrl)) );
1648 if ($opts{-nohtml}) {
1649 return $chr;
1650 } else {
1651 return "<span class=\"cntrl\">$chr</span>";
1655 # Alternatively use unicode control pictures codepoints,
1656 # Unicode "printable representation" (PR)
1657 sub quot_upr {
1658 my $cntrl = shift;
1659 my %opts = @_;
1661 my $chr = sprintf('&#%04d;', 0x2400+ord($cntrl));
1662 if ($opts{-nohtml}) {
1663 return $chr;
1664 } else {
1665 return "<span class=\"cntrl\">$chr</span>";
1669 # git may return quoted and escaped filenames
1670 sub unquote {
1671 my $str = shift;
1673 sub unq {
1674 my $seq = shift;
1675 my %es = ( # character escape codes, aka escape sequences
1676 't' => "\t", # tab (HT, TAB)
1677 'n' => "\n", # newline (NL)
1678 'r' => "\r", # return (CR)
1679 'f' => "\f", # form feed (FF)
1680 'b' => "\b", # backspace (BS)
1681 'a' => "\a", # alarm (bell) (BEL)
1682 'e' => "\e", # escape (ESC)
1683 'v' => "\013", # vertical tab (VT)
1686 if ($seq =~ m/^[0-7]{1,3}$/) {
1687 # octal char sequence
1688 return chr(oct($seq));
1689 } elsif (exists $es{$seq}) {
1690 # C escape sequence, aka character escape code
1691 return $es{$seq};
1693 # quoted ordinary character
1694 return $seq;
1697 if ($str =~ m/^"(.*)"$/) {
1698 # needs unquoting
1699 $str = $1;
1700 $str =~ s/\\([^0-7]|[0-7]{1,3})/unq($1)/eg;
1702 return $str;
1705 # escape tabs (convert tabs to spaces)
1706 sub untabify {
1707 my $line = shift;
1709 while ((my $pos = index($line, "\t")) != -1) {
1710 if (my $count = (8 - ($pos % 8))) {
1711 my $spaces = ' ' x $count;
1712 $line =~ s/\t/$spaces/;
1716 return $line;
1719 sub project_in_list {
1720 my $project = shift;
1721 my @list = git_get_projects_list();
1722 return @list && scalar(grep { $_->{'path'} eq $project } @list);
1725 ## ----------------------------------------------------------------------
1726 ## HTML aware string manipulation
1728 # Try to chop given string on a word boundary between position
1729 # $len and $len+$add_len. If there is no word boundary there,
1730 # chop at $len+$add_len. Do not chop if chopped part plus ellipsis
1731 # (marking chopped part) would be longer than given string.
1732 sub chop_str {
1733 my $str = shift;
1734 my $len = shift;
1735 my $add_len = shift || 10;
1736 my $where = shift || 'right'; # 'left' | 'center' | 'right'
1738 # Make sure perl knows it is utf8 encoded so we don't
1739 # cut in the middle of a utf8 multibyte char.
1740 $str = to_utf8($str);
1742 # allow only $len chars, but don't cut a word if it would fit in $add_len
1743 # if it doesn't fit, cut it if it's still longer than the dots we would add
1744 # remove chopped character entities entirely
1746 # when chopping in the middle, distribute $len into left and right part
1747 # return early if chopping wouldn't make string shorter
1748 if ($where eq 'center') {
1749 return $str if ($len + 5 >= length($str)); # filler is length 5
1750 $len = int($len/2);
1751 } else {
1752 return $str if ($len + 4 >= length($str)); # filler is length 4
1755 # regexps: ending and beginning with word part up to $add_len
1756 my $endre = qr/.{$len}\w{0,$add_len}/;
1757 my $begre = qr/\w{0,$add_len}.{$len}/;
1759 if ($where eq 'left') {
1760 $str =~ m/^(.*?)($begre)$/;
1761 my ($lead, $body) = ($1, $2);
1762 if (length($lead) > 4) {
1763 $lead = " ...";
1765 return "$lead$body";
1767 } elsif ($where eq 'center') {
1768 $str =~ m/^($endre)(.*)$/;
1769 my ($left, $str) = ($1, $2);
1770 $str =~ m/^(.*?)($begre)$/;
1771 my ($mid, $right) = ($1, $2);
1772 if (length($mid) > 5) {
1773 $mid = " ... ";
1775 return "$left$mid$right";
1777 } else {
1778 $str =~ m/^($endre)(.*)$/;
1779 my $body = $1;
1780 my $tail = $2;
1781 if (length($tail) > 4) {
1782 $tail = "... ";
1784 return "$body$tail";
1788 # takes the same arguments as chop_str, but also wraps a <span> around the
1789 # result with a title attribute if it does get chopped. Additionally, the
1790 # string is HTML-escaped.
1791 sub chop_and_escape_str {
1792 my ($str) = @_;
1794 my $chopped = chop_str(@_);
1795 $str = to_utf8($str);
1796 if ($chopped eq $str) {
1797 return esc_html($chopped);
1798 } else {
1799 $str =~ s/[[:cntrl:]]/?/g;
1800 return $cgi->span({-title=>$str}, esc_html($chopped));
1804 # Highlight selected fragments of string, using given CSS class,
1805 # and escape HTML. It is assumed that fragments do not overlap.
1806 # Regions are passed as list of pairs (array references).
1808 # Example: esc_html_hl_regions("foobar", "mark", [ 0, 3 ]) returns
1809 # '<span class="mark">foo</span>bar'
1810 sub esc_html_hl_regions {
1811 my ($str, $css_class, @sel) = @_;
1812 my %opts = grep { ref($_) ne 'ARRAY' } @sel;
1813 @sel = grep { ref($_) eq 'ARRAY' } @sel;
1814 return esc_html($str, %opts) unless @sel;
1816 my $out = '';
1817 my $pos = 0;
1819 for my $s (@sel) {
1820 my ($begin, $end) = @$s;
1822 # Don't create empty <span> elements.
1823 next if $end <= $begin;
1825 my $escaped = esc_html(substr($str, $begin, $end - $begin),
1826 %opts);
1828 $out .= esc_html(substr($str, $pos, $begin - $pos), %opts)
1829 if ($begin - $pos > 0);
1830 $out .= $cgi->span({-class => $css_class}, $escaped);
1832 $pos = $end;
1834 $out .= esc_html(substr($str, $pos), %opts)
1835 if ($pos < length($str));
1837 return $out;
1840 # return positions of beginning and end of each match
1841 sub matchpos_list {
1842 my ($str, $regexp) = @_;
1843 return unless (defined $str && defined $regexp);
1845 my @matches;
1846 while ($str =~ /$regexp/g) {
1847 push @matches, [$-[0], $+[0]];
1849 return @matches;
1852 # highlight match (if any), and escape HTML
1853 sub esc_html_match_hl {
1854 my ($str, $regexp) = @_;
1855 return esc_html($str) unless defined $regexp;
1857 my @matches = matchpos_list($str, $regexp);
1858 return esc_html($str) unless @matches;
1860 return esc_html_hl_regions($str, 'match', @matches);
1864 # highlight match (if any) of shortened string, and escape HTML
1865 sub esc_html_match_hl_chopped {
1866 my ($str, $chopped, $regexp) = @_;
1867 return esc_html_match_hl($str, $regexp) unless defined $chopped;
1869 my @matches = matchpos_list($str, $regexp);
1870 return esc_html($chopped) unless @matches;
1872 # filter matches so that we mark chopped string
1873 my $tail = "... "; # see chop_str
1874 unless ($chopped =~ s/\Q$tail\E$//) {
1875 $tail = '';
1877 my $chop_len = length($chopped);
1878 my $tail_len = length($tail);
1879 my @filtered;
1881 for my $m (@matches) {
1882 if ($m->[0] > $chop_len) {
1883 push @filtered, [ $chop_len, $chop_len + $tail_len ] if ($tail_len > 0);
1884 last;
1885 } elsif ($m->[1] > $chop_len) {
1886 push @filtered, [ $m->[0], $chop_len + $tail_len ];
1887 last;
1889 push @filtered, $m;
1892 return esc_html_hl_regions($chopped . $tail, 'match', @filtered);
1895 ## ----------------------------------------------------------------------
1896 ## functions returning short strings
1898 # CSS class for given age value (in seconds)
1899 sub age_class {
1900 my $age = shift;
1902 if (!defined $age) {
1903 return "noage";
1904 } elsif ($age < 60*60*2) {
1905 return "age0";
1906 } elsif ($age < 60*60*24*2) {
1907 return "age1";
1908 } else {
1909 return "age2";
1913 # convert age in seconds to "nn units ago" string
1914 sub age_string {
1915 my $age = shift;
1916 my $age_str;
1918 if ($age > 60*60*24*365*2) {
1919 $age_str = (int $age/60/60/24/365);
1920 $age_str .= " years ago";
1921 } elsif ($age > 60*60*24*(365/12)*2) {
1922 $age_str = int $age/60/60/24/(365/12);
1923 $age_str .= " months ago";
1924 } elsif ($age > 60*60*24*7*2) {
1925 $age_str = int $age/60/60/24/7;
1926 $age_str .= " weeks ago";
1927 } elsif ($age > 60*60*24*2) {
1928 $age_str = int $age/60/60/24;
1929 $age_str .= " days ago";
1930 } elsif ($age > 60*60*2) {
1931 $age_str = int $age/60/60;
1932 $age_str .= " hours ago";
1933 } elsif ($age > 60*2) {
1934 $age_str = int $age/60;
1935 $age_str .= " min ago";
1936 } elsif ($age > 2) {
1937 $age_str = int $age;
1938 $age_str .= " sec ago";
1939 } else {
1940 $age_str .= " right now";
1942 return $age_str;
1945 use constant {
1946 S_IFINVALID => 0030000,
1947 S_IFGITLINK => 0160000,
1950 # submodule/subproject, a commit object reference
1951 sub S_ISGITLINK {
1952 my $mode = shift;
1954 return (($mode & S_IFMT) == S_IFGITLINK)
1957 # convert file mode in octal to symbolic file mode string
1958 sub mode_str {
1959 my $mode = oct shift;
1961 if (S_ISGITLINK($mode)) {
1962 return 'm---------';
1963 } elsif (S_ISDIR($mode & S_IFMT)) {
1964 return 'drwxr-xr-x';
1965 } elsif (S_ISLNK($mode)) {
1966 return 'lrwxrwxrwx';
1967 } elsif (S_ISREG($mode)) {
1968 # git cares only about the executable bit
1969 if ($mode & S_IXUSR) {
1970 return '-rwxr-xr-x';
1971 } else {
1972 return '-rw-r--r--';
1974 } else {
1975 return '----------';
1979 # convert file mode in octal to file type string
1980 sub file_type {
1981 my $mode = shift;
1983 if ($mode !~ m/^[0-7]+$/) {
1984 return $mode;
1985 } else {
1986 $mode = oct $mode;
1989 if (S_ISGITLINK($mode)) {
1990 return "submodule";
1991 } elsif (S_ISDIR($mode & S_IFMT)) {
1992 return "directory";
1993 } elsif (S_ISLNK($mode)) {
1994 return "symlink";
1995 } elsif (S_ISREG($mode)) {
1996 return "file";
1997 } else {
1998 return "unknown";
2002 # convert file mode in octal to file type description string
2003 sub file_type_long {
2004 my $mode = shift;
2006 if ($mode !~ m/^[0-7]+$/) {
2007 return $mode;
2008 } else {
2009 $mode = oct $mode;
2012 if (S_ISGITLINK($mode)) {
2013 return "submodule";
2014 } elsif (S_ISDIR($mode & S_IFMT)) {
2015 return "directory";
2016 } elsif (S_ISLNK($mode)) {
2017 return "symlink";
2018 } elsif (S_ISREG($mode)) {
2019 if ($mode & S_IXUSR) {
2020 return "executable";
2021 } else {
2022 return "file";
2024 } else {
2025 return "unknown";
2030 ## ----------------------------------------------------------------------
2031 ## functions returning short HTML fragments, or transforming HTML fragments
2032 ## which don't belong to other sections
2034 # format line of commit message.
2035 sub format_log_line_html {
2036 my $line = shift;
2038 $line = esc_html($line, -nbsp=>1);
2039 $line =~ s{
2042 # The output of "git describe", e.g. v2.10.0-297-gf6727b0
2043 # or hadoop-20160921-113441-20-g094fb7d
2044 (?<!-) # see strbuf_check_tag_ref(). Tags can't start with -
2045 [A-Za-z0-9.-]+
2046 (?!\.) # refs can't end with ".", see check_refname_format()
2047 -g[0-9a-fA-F]{7,40}
2049 # Just a normal looking Git SHA1
2050 [0-9a-fA-F]{7,40}
2054 $cgi->a({-href => href(action=>"object", hash=>$1),
2055 -class => "text"}, $1);
2056 }egx;
2058 return $line;
2061 # format marker of refs pointing to given object
2063 # the destination action is chosen based on object type and current context:
2064 # - for annotated tags, we choose the tag view unless it's the current view
2065 # already, in which case we go to shortlog view
2066 # - for other refs, we keep the current view if we're in history, shortlog or
2067 # log view, and select shortlog otherwise
2068 sub format_ref_marker {
2069 my ($refs, $id) = @_;
2070 my $markers = '';
2072 if (defined $refs->{$id}) {
2073 foreach my $ref (@{$refs->{$id}}) {
2074 # this code exploits the fact that non-lightweight tags are the
2075 # only indirect objects, and that they are the only objects for which
2076 # we want to use tag instead of shortlog as action
2077 my ($type, $name) = qw();
2078 my $indirect = ($ref =~ s/\^\{\}$//);
2079 # e.g. tags/v2.6.11 or heads/next
2080 if ($ref =~ m!^(.*?)s?/(.*)$!) {
2081 $type = $1;
2082 $name = $2;
2083 } else {
2084 $type = "ref";
2085 $name = $ref;
2088 my $class = $type;
2089 $class .= " indirect" if $indirect;
2091 my $dest_action = "shortlog";
2093 if ($indirect) {
2094 $dest_action = "tag" unless $action eq "tag";
2095 } elsif ($action =~ /^(history|(short)?log)$/) {
2096 $dest_action = $action;
2099 my $dest = "";
2100 $dest .= "refs/" unless $ref =~ m!^refs/!;
2101 $dest .= $ref;
2103 my $link = $cgi->a({
2104 -href => href(
2105 action=>$dest_action,
2106 hash=>$dest
2107 )}, esc_html($name));
2109 $markers .= " <span class=\"".esc_attr($class)."\" title=\"".esc_attr($ref)."\">" .
2110 $link . "</span>";
2114 if ($markers) {
2115 return ' <span class="refs">'. $markers . '</span>';
2116 } else {
2117 return "";
2121 # format, perhaps shortened and with markers, title line
2122 sub format_subject_html {
2123 my ($long, $short, $href, $extra) = @_;
2124 $extra = '' unless defined($extra);
2126 if (length($short) < length($long)) {
2127 $long =~ s/[[:cntrl:]]/?/g;
2128 return $cgi->a({-href => $href, -class => "list subject",
2129 -title => to_utf8($long)},
2130 esc_html($short)) . $extra;
2131 } else {
2132 return $cgi->a({-href => $href, -class => "list subject"},
2133 esc_html($long)) . $extra;
2137 # Rather than recomputing the url for an email multiple times, we cache it
2138 # after the first hit. This gives a visible benefit in views where the avatar
2139 # for the same email is used repeatedly (e.g. shortlog).
2140 # The cache is shared by all avatar engines (currently gravatar only), which
2141 # are free to use it as preferred. Since only one avatar engine is used for any
2142 # given page, there's no risk for cache conflicts.
2143 our %avatar_cache = ();
2145 # Compute the picon url for a given email, by using the picon search service over at
2146 # http://www.cs.indiana.edu/picons/search.html
2147 sub picon_url {
2148 my $email = lc shift;
2149 if (!$avatar_cache{$email}) {
2150 my ($user, $domain) = split('@', $email);
2151 $avatar_cache{$email} =
2152 "//www.cs.indiana.edu/cgi-pub/kinzler/piconsearch.cgi/" .
2153 "$domain/$user/" .
2154 "users+domains+unknown/up/single";
2156 return $avatar_cache{$email};
2159 # Compute the gravatar url for a given email, if it's not in the cache already.
2160 # Gravatar stores only the part of the URL before the size, since that's the
2161 # one computationally more expensive. This also allows reuse of the cache for
2162 # different sizes (for this particular engine).
2163 sub gravatar_url {
2164 my $email = lc shift;
2165 my $size = shift;
2166 $avatar_cache{$email} ||=
2167 "//www.gravatar.com/avatar/" .
2168 Digest::MD5::md5_hex($email) . "?s=";
2169 return $avatar_cache{$email} . $size;
2172 # Insert an avatar for the given $email at the given $size if the feature
2173 # is enabled.
2174 sub git_get_avatar {
2175 my ($email, %opts) = @_;
2176 my $pre_white = ($opts{-pad_before} ? "&nbsp;" : "");
2177 my $post_white = ($opts{-pad_after} ? "&nbsp;" : "");
2178 $opts{-size} ||= 'default';
2179 my $size = $avatar_size{$opts{-size}} || $avatar_size{'default'};
2180 my $url = "";
2181 if ($git_avatar eq 'gravatar') {
2182 $url = gravatar_url($email, $size);
2183 } elsif ($git_avatar eq 'picon') {
2184 $url = picon_url($email);
2186 # Other providers can be added by extending the if chain, defining $url
2187 # as needed. If no variant puts something in $url, we assume avatars
2188 # are completely disabled/unavailable.
2189 if ($url) {
2190 return $pre_white .
2191 "<img width=\"$size\" " .
2192 "class=\"avatar\" " .
2193 "src=\"".esc_url($url)."\" " .
2194 "alt=\"\" " .
2195 "/>" . $post_white;
2196 } else {
2197 return "";
2201 sub format_search_author {
2202 my ($author, $searchtype, $displaytext) = @_;
2203 my $have_search = gitweb_check_feature('search');
2205 if ($have_search) {
2206 my $performed = "";
2207 if ($searchtype eq 'author') {
2208 $performed = "authored";
2209 } elsif ($searchtype eq 'committer') {
2210 $performed = "committed";
2213 return $cgi->a({-href => href(action=>"search", hash=>$hash,
2214 searchtext=>$author,
2215 searchtype=>$searchtype), class=>"list",
2216 title=>"Search for commits $performed by $author"},
2217 $displaytext);
2219 } else {
2220 return $displaytext;
2224 # format the author name of the given commit with the given tag
2225 # the author name is chopped and escaped according to the other
2226 # optional parameters (see chop_str).
2227 sub format_author_html {
2228 my $tag = shift;
2229 my $co = shift;
2230 my $author = chop_and_escape_str($co->{'author_name'}, @_);
2231 return "<$tag class=\"author\">" .
2232 format_search_author($co->{'author_name'}, "author",
2233 git_get_avatar($co->{'author_email'}, -pad_after => 1) .
2234 $author) .
2235 "</$tag>";
2238 # format git diff header line, i.e. "diff --(git|combined|cc) ..."
2239 sub format_git_diff_header_line {
2240 my $line = shift;
2241 my $diffinfo = shift;
2242 my ($from, $to) = @_;
2244 if ($diffinfo->{'nparents'}) {
2245 # combined diff
2246 $line =~ s!^(diff (.*?) )"?.*$!$1!;
2247 if ($to->{'href'}) {
2248 $line .= $cgi->a({-href => $to->{'href'}, -class => "path"},
2249 esc_path($to->{'file'}));
2250 } else { # file was deleted (no href)
2251 $line .= esc_path($to->{'file'});
2253 } else {
2254 # "ordinary" diff
2255 $line =~ s!^(diff (.*?) )"?a/.*$!$1!;
2256 if ($from->{'href'}) {
2257 $line .= $cgi->a({-href => $from->{'href'}, -class => "path"},
2258 'a/' . esc_path($from->{'file'}));
2259 } else { # file was added (no href)
2260 $line .= 'a/' . esc_path($from->{'file'});
2262 $line .= ' ';
2263 if ($to->{'href'}) {
2264 $line .= $cgi->a({-href => $to->{'href'}, -class => "path"},
2265 'b/' . esc_path($to->{'file'}));
2266 } else { # file was deleted
2267 $line .= 'b/' . esc_path($to->{'file'});
2271 return "<div class=\"diff header\">$line</div>\n";
2274 # format extended diff header line, before patch itself
2275 sub format_extended_diff_header_line {
2276 my $line = shift;
2277 my $diffinfo = shift;
2278 my ($from, $to) = @_;
2280 # match <path>
2281 if ($line =~ s!^((copy|rename) from ).*$!$1! && $from->{'href'}) {
2282 $line .= $cgi->a({-href=>$from->{'href'}, -class=>"path"},
2283 esc_path($from->{'file'}));
2285 if ($line =~ s!^((copy|rename) to ).*$!$1! && $to->{'href'}) {
2286 $line .= $cgi->a({-href=>$to->{'href'}, -class=>"path"},
2287 esc_path($to->{'file'}));
2289 # match single <mode>
2290 if ($line =~ m/\s(\d{6})$/) {
2291 $line .= '<span class="info"> (' .
2292 file_type_long($1) .
2293 ')</span>';
2295 # match <hash>
2296 if ($line =~ m/^index [0-9a-fA-F]{40},[0-9a-fA-F]{40}/) {
2297 # can match only for combined diff
2298 $line = 'index ';
2299 for (my $i = 0; $i < $diffinfo->{'nparents'}; $i++) {
2300 if ($from->{'href'}[$i]) {
2301 $line .= $cgi->a({-href=>$from->{'href'}[$i],
2302 -class=>"hash"},
2303 substr($diffinfo->{'from_id'}[$i],0,7));
2304 } else {
2305 $line .= '0' x 7;
2307 # separator
2308 $line .= ',' if ($i < $diffinfo->{'nparents'} - 1);
2310 $line .= '..';
2311 if ($to->{'href'}) {
2312 $line .= $cgi->a({-href=>$to->{'href'}, -class=>"hash"},
2313 substr($diffinfo->{'to_id'},0,7));
2314 } else {
2315 $line .= '0' x 7;
2318 } elsif ($line =~ m/^index [0-9a-fA-F]{40}..[0-9a-fA-F]{40}/) {
2319 # can match only for ordinary diff
2320 my ($from_link, $to_link);
2321 if ($from->{'href'}) {
2322 $from_link = $cgi->a({-href=>$from->{'href'}, -class=>"hash"},
2323 substr($diffinfo->{'from_id'},0,7));
2324 } else {
2325 $from_link = '0' x 7;
2327 if ($to->{'href'}) {
2328 $to_link = $cgi->a({-href=>$to->{'href'}, -class=>"hash"},
2329 substr($diffinfo->{'to_id'},0,7));
2330 } else {
2331 $to_link = '0' x 7;
2333 my ($from_id, $to_id) = ($diffinfo->{'from_id'}, $diffinfo->{'to_id'});
2334 $line =~ s!$from_id\.\.$to_id!$from_link..$to_link!;
2337 return $line . "<br/>\n";
2340 # format from-file/to-file diff header
2341 sub format_diff_from_to_header {
2342 my ($from_line, $to_line, $diffinfo, $from, $to, @parents) = @_;
2343 my $line;
2344 my $result = '';
2346 $line = $from_line;
2347 #assert($line =~ m/^---/) if DEBUG;
2348 # no extra formatting for "^--- /dev/null"
2349 if (! $diffinfo->{'nparents'}) {
2350 # ordinary (single parent) diff
2351 if ($line =~ m!^--- "?a/!) {
2352 if ($from->{'href'}) {
2353 $line = '--- a/' .
2354 $cgi->a({-href=>$from->{'href'}, -class=>"path"},
2355 esc_path($from->{'file'}));
2356 } else {
2357 $line = '--- a/' .
2358 esc_path($from->{'file'});
2361 $result .= qq!<div class="diff from_file">$line</div>\n!;
2363 } else {
2364 # combined diff (merge commit)
2365 for (my $i = 0; $i < $diffinfo->{'nparents'}; $i++) {
2366 if ($from->{'href'}[$i]) {
2367 $line = '--- ' .
2368 $cgi->a({-href=>href(action=>"blobdiff",
2369 hash_parent=>$diffinfo->{'from_id'}[$i],
2370 hash_parent_base=>$parents[$i],
2371 file_parent=>$from->{'file'}[$i],
2372 hash=>$diffinfo->{'to_id'},
2373 hash_base=>$hash,
2374 file_name=>$to->{'file'}),
2375 -class=>"path",
2376 -title=>"diff" . ($i+1)},
2377 $i+1) .
2378 '/' .
2379 $cgi->a({-href=>$from->{'href'}[$i], -class=>"path"},
2380 esc_path($from->{'file'}[$i]));
2381 } else {
2382 $line = '--- /dev/null';
2384 $result .= qq!<div class="diff from_file">$line</div>\n!;
2388 $line = $to_line;
2389 #assert($line =~ m/^\+\+\+/) if DEBUG;
2390 # no extra formatting for "^+++ /dev/null"
2391 if ($line =~ m!^\+\+\+ "?b/!) {
2392 if ($to->{'href'}) {
2393 $line = '+++ b/' .
2394 $cgi->a({-href=>$to->{'href'}, -class=>"path"},
2395 esc_path($to->{'file'}));
2396 } else {
2397 $line = '+++ b/' .
2398 esc_path($to->{'file'});
2401 $result .= qq!<div class="diff to_file">$line</div>\n!;
2403 return $result;
2406 # create note for patch simplified by combined diff
2407 sub format_diff_cc_simplified {
2408 my ($diffinfo, @parents) = @_;
2409 my $result = '';
2411 $result .= "<div class=\"diff header\">" .
2412 "diff --cc ";
2413 if (!is_deleted($diffinfo)) {
2414 $result .= $cgi->a({-href => href(action=>"blob",
2415 hash_base=>$hash,
2416 hash=>$diffinfo->{'to_id'},
2417 file_name=>$diffinfo->{'to_file'}),
2418 -class => "path"},
2419 esc_path($diffinfo->{'to_file'}));
2420 } else {
2421 $result .= esc_path($diffinfo->{'to_file'});
2423 $result .= "</div>\n" . # class="diff header"
2424 "<div class=\"diff nodifferences\">" .
2425 "Simple merge" .
2426 "</div>\n"; # class="diff nodifferences"
2428 return $result;
2431 sub diff_line_class {
2432 my ($line, $from, $to) = @_;
2434 # ordinary diff
2435 my $num_sign = 1;
2436 # combined diff
2437 if ($from && $to && ref($from->{'href'}) eq "ARRAY") {
2438 $num_sign = scalar @{$from->{'href'}};
2441 my @diff_line_classifier = (
2442 { regexp => qr/^\@\@{$num_sign} /, class => "chunk_header"},
2443 { regexp => qr/^\\/, class => "incomplete" },
2444 { regexp => qr/^ {$num_sign}/, class => "ctx" },
2445 # classifier for context must come before classifier add/rem,
2446 # or we would have to use more complicated regexp, for example
2447 # qr/(?= {0,$m}\+)[+ ]{$num_sign}/, where $m = $num_sign - 1;
2448 { regexp => qr/^[+ ]{$num_sign}/, class => "add" },
2449 { regexp => qr/^[- ]{$num_sign}/, class => "rem" },
2451 for my $clsfy (@diff_line_classifier) {
2452 return $clsfy->{'class'}
2453 if ($line =~ $clsfy->{'regexp'});
2456 # fallback
2457 return "";
2460 # assumes that $from and $to are defined and correctly filled,
2461 # and that $line holds a line of chunk header for unified diff
2462 sub format_unidiff_chunk_header {
2463 my ($line, $from, $to) = @_;
2465 my ($from_text, $from_start, $from_lines, $to_text, $to_start, $to_lines, $section) =
2466 $line =~ m/^\@{2} (-(\d+)(?:,(\d+))?) (\+(\d+)(?:,(\d+))?) \@{2}(.*)$/;
2468 $from_lines = 0 unless defined $from_lines;
2469 $to_lines = 0 unless defined $to_lines;
2471 if ($from->{'href'}) {
2472 $from_text = $cgi->a({-href=>"$from->{'href'}#l$from_start",
2473 -class=>"list"}, $from_text);
2475 if ($to->{'href'}) {
2476 $to_text = $cgi->a({-href=>"$to->{'href'}#l$to_start",
2477 -class=>"list"}, $to_text);
2479 $line = "<span class=\"chunk_info\">@@ $from_text $to_text @@</span>" .
2480 "<span class=\"section\">" . esc_html($section, -nbsp=>1) . "</span>";
2481 return $line;
2484 # assumes that $from and $to are defined and correctly filled,
2485 # and that $line holds a line of chunk header for combined diff
2486 sub format_cc_diff_chunk_header {
2487 my ($line, $from, $to) = @_;
2489 my ($prefix, $ranges, $section) = $line =~ m/^(\@+) (.*?) \@+(.*)$/;
2490 my (@from_text, @from_start, @from_nlines, $to_text, $to_start, $to_nlines);
2492 @from_text = split(' ', $ranges);
2493 for (my $i = 0; $i < @from_text; ++$i) {
2494 ($from_start[$i], $from_nlines[$i]) =
2495 (split(',', substr($from_text[$i], 1)), 0);
2498 $to_text = pop @from_text;
2499 $to_start = pop @from_start;
2500 $to_nlines = pop @from_nlines;
2502 $line = "<span class=\"chunk_info\">$prefix ";
2503 for (my $i = 0; $i < @from_text; ++$i) {
2504 if ($from->{'href'}[$i]) {
2505 $line .= $cgi->a({-href=>"$from->{'href'}[$i]#l$from_start[$i]",
2506 -class=>"list"}, $from_text[$i]);
2507 } else {
2508 $line .= $from_text[$i];
2510 $line .= " ";
2512 if ($to->{'href'}) {
2513 $line .= $cgi->a({-href=>"$to->{'href'}#l$to_start",
2514 -class=>"list"}, $to_text);
2515 } else {
2516 $line .= $to_text;
2518 $line .= " $prefix</span>" .
2519 "<span class=\"section\">" . esc_html($section, -nbsp=>1) . "</span>";
2520 return $line;
2523 # process patch (diff) line (not to be used for diff headers),
2524 # returning HTML-formatted (but not wrapped) line.
2525 # If the line is passed as a reference, it is treated as HTML and not
2526 # esc_html()'ed.
2527 sub format_diff_line {
2528 my ($line, $diff_class, $from, $to) = @_;
2530 if (ref($line)) {
2531 $line = $$line;
2532 } else {
2533 chomp $line;
2534 $line = untabify($line);
2536 if ($from && $to && $line =~ m/^\@{2} /) {
2537 $line = format_unidiff_chunk_header($line, $from, $to);
2538 } elsif ($from && $to && $line =~ m/^\@{3}/) {
2539 $line = format_cc_diff_chunk_header($line, $from, $to);
2540 } else {
2541 $line = esc_html($line, -nbsp=>1);
2545 my $diff_classes = "diff";
2546 $diff_classes .= " $diff_class" if ($diff_class);
2547 $line = "<div class=\"$diff_classes\">$line</div>\n";
2549 return $line;
2552 # Generates undef or something like "_snapshot_" or "snapshot (_tbz2_ _zip_)",
2553 # linked. Pass the hash of the tree/commit to snapshot.
2554 sub format_snapshot_links {
2555 my ($hash) = @_;
2556 my $num_fmts = @snapshot_fmts;
2557 if ($num_fmts > 1) {
2558 # A parenthesized list of links bearing format names.
2559 # e.g. "snapshot (_tar.gz_ _zip_)"
2560 return "snapshot (" . join(' ', map
2561 $cgi->a({
2562 -href => href(
2563 action=>"snapshot",
2564 hash=>$hash,
2565 snapshot_format=>$_
2567 }, $known_snapshot_formats{$_}{'display'})
2568 , @snapshot_fmts) . ")";
2569 } elsif ($num_fmts == 1) {
2570 # A single "snapshot" link whose tooltip bears the format name.
2571 # i.e. "_snapshot_"
2572 my ($fmt) = @snapshot_fmts;
2573 return
2574 $cgi->a({
2575 -href => href(
2576 action=>"snapshot",
2577 hash=>$hash,
2578 snapshot_format=>$fmt
2580 -title => "in format: $known_snapshot_formats{$fmt}{'display'}"
2581 }, "snapshot");
2582 } else { # $num_fmts == 0
2583 return undef;
2587 ## ......................................................................
2588 ## functions returning values to be passed, perhaps after some
2589 ## transformation, to other functions; e.g. returning arguments to href()
2591 # returns hash to be passed to href to generate gitweb URL
2592 # in -title key it returns description of link
2593 sub get_feed_info {
2594 my $format = shift || 'Atom';
2595 my %res = (action => lc($format));
2596 my $matched_ref = 0;
2598 # feed links are possible only for project views
2599 return unless (defined $project);
2600 # some views should link to OPML, or to generic project feed,
2601 # or don't have specific feed yet (so they should use generic)
2602 return if (!$action || $action =~ /^(?:tags|heads|forks|tag|search)$/x);
2604 my $branch = undef;
2605 # branches refs uses 'refs/' + $get_branch_refs()[x] + '/' prefix
2606 # (fullname) to differentiate from tag links; this also makes
2607 # possible to detect branch links
2608 for my $ref (get_branch_refs()) {
2609 if ((defined $hash_base && $hash_base =~ m!^refs/\Q$ref\E/(.*)$!) ||
2610 (defined $hash && $hash =~ m!^refs/\Q$ref\E/(.*)$!)) {
2611 $branch = $1;
2612 $matched_ref = $ref;
2613 last;
2616 # find log type for feed description (title)
2617 my $type = 'log';
2618 if (defined $file_name) {
2619 $type = "history of $file_name";
2620 $type .= "/" if ($action eq 'tree');
2621 $type .= " on '$branch'" if (defined $branch);
2622 } else {
2623 $type = "log of $branch" if (defined $branch);
2626 $res{-title} = $type;
2627 $res{'hash'} = (defined $branch ? "refs/$matched_ref/$branch" : undef);
2628 $res{'file_name'} = $file_name;
2630 return %res;
2633 ## ----------------------------------------------------------------------
2634 ## git utility subroutines, invoking git commands
2636 # returns path to the core git executable and the --git-dir parameter as list
2637 sub git_cmd {
2638 $number_of_git_cmds++;
2639 return $GIT, '--git-dir='.$git_dir;
2642 # quote the given arguments for passing them to the shell
2643 # quote_command("command", "arg 1", "arg with ' and ! characters")
2644 # => "'command' 'arg 1' 'arg with '\'' and '\!' characters'"
2645 # Try to avoid using this function wherever possible.
2646 sub quote_command {
2647 return join(' ',
2648 map { my $a = $_; $a =~ s/(['!])/'\\$1'/g; "'$a'" } @_ );
2651 # get HEAD ref of given project as hash
2652 sub git_get_head_hash {
2653 return git_get_full_hash(shift, 'HEAD');
2656 sub git_get_full_hash {
2657 return git_get_hash(@_);
2660 sub git_get_short_hash {
2661 return git_get_hash(@_, '--short=7');
2664 sub git_get_hash {
2665 my ($project, $hash, @options) = @_;
2666 my $o_git_dir = $git_dir;
2667 my $retval = undef;
2668 $git_dir = "$projectroot/$project";
2669 if (open my $fd, '-|', git_cmd(), 'rev-parse',
2670 '--verify', '-q', @options, $hash) {
2671 $retval = <$fd>;
2672 chomp $retval if defined $retval;
2673 close $fd;
2675 if (defined $o_git_dir) {
2676 $git_dir = $o_git_dir;
2678 return $retval;
2681 # get type of given object
2682 sub git_get_type {
2683 my $hash = shift;
2685 open my $fd, "-|", git_cmd(), "cat-file", '-t', $hash or return;
2686 my $type = <$fd>;
2687 close $fd or return;
2688 chomp $type;
2689 return $type;
2692 # repository configuration
2693 our $config_file = '';
2694 our %config;
2696 # store multiple values for single key as anonymous array reference
2697 # single values stored directly in the hash, not as [ <value> ]
2698 sub hash_set_multi {
2699 my ($hash, $key, $value) = @_;
2701 if (!exists $hash->{$key}) {
2702 $hash->{$key} = $value;
2703 } elsif (!ref $hash->{$key}) {
2704 $hash->{$key} = [ $hash->{$key}, $value ];
2705 } else {
2706 push @{$hash->{$key}}, $value;
2710 # return hash of git project configuration
2711 # optionally limited to some section, e.g. 'gitweb'
2712 sub git_parse_project_config {
2713 my $section_regexp = shift;
2714 my %config;
2716 local $/ = "\0";
2718 open my $fh, "-|", git_cmd(), "config", '-z', '-l',
2719 or return;
2721 while (my $keyval = <$fh>) {
2722 chomp $keyval;
2723 my ($key, $value) = split(/\n/, $keyval, 2);
2725 hash_set_multi(\%config, $key, $value)
2726 if (!defined $section_regexp || $key =~ /^(?:$section_regexp)\./o);
2728 close $fh;
2730 return %config;
2733 # convert config value to boolean: 'true' or 'false'
2734 # no value, number > 0, 'true' and 'yes' values are true
2735 # rest of values are treated as false (never as error)
2736 sub config_to_bool {
2737 my $val = shift;
2739 return 1 if !defined $val; # section.key
2741 # strip leading and trailing whitespace
2742 $val =~ s/^\s+//;
2743 $val =~ s/\s+$//;
2745 return (($val =~ /^\d+$/ && $val) || # section.key = 1
2746 ($val =~ /^(?:true|yes)$/i)); # section.key = true
2749 # convert config value to simple decimal number
2750 # an optional value suffix of 'k', 'm', or 'g' will cause the value
2751 # to be multiplied by 1024, 1048576, or 1073741824
2752 sub config_to_int {
2753 my $val = shift;
2755 # strip leading and trailing whitespace
2756 $val =~ s/^\s+//;
2757 $val =~ s/\s+$//;
2759 if (my ($num, $unit) = ($val =~ /^([0-9]*)([kmg])$/i)) {
2760 $unit = lc($unit);
2761 # unknown unit is treated as 1
2762 return $num * ($unit eq 'g' ? 1073741824 :
2763 $unit eq 'm' ? 1048576 :
2764 $unit eq 'k' ? 1024 : 1);
2766 return $val;
2769 # convert config value to array reference, if needed
2770 sub config_to_multi {
2771 my $val = shift;
2773 return ref($val) ? $val : (defined($val) ? [ $val ] : []);
2776 sub git_get_project_config {
2777 my ($key, $type) = @_;
2779 return unless defined $git_dir;
2781 # key sanity check
2782 return unless ($key);
2783 # only subsection, if exists, is case sensitive,
2784 # and not lowercased by 'git config -z -l'
2785 if (my ($hi, $mi, $lo) = ($key =~ /^([^.]*)\.(.*)\.([^.]*)$/)) {
2786 $lo =~ s/_//g;
2787 $key = join(".", lc($hi), $mi, lc($lo));
2788 return if ($lo =~ /\W/ || $hi =~ /\W/);
2789 } else {
2790 $key = lc($key);
2791 $key =~ s/_//g;
2792 return if ($key =~ /\W/);
2794 $key =~ s/^gitweb\.//;
2796 # type sanity check
2797 if (defined $type) {
2798 $type =~ s/^--//;
2799 $type = undef
2800 unless ($type eq 'bool' || $type eq 'int');
2803 # get config
2804 if (!defined $config_file ||
2805 $config_file ne "$git_dir/config") {
2806 %config = git_parse_project_config('gitweb');
2807 $config_file = "$git_dir/config";
2810 # check if config variable (key) exists
2811 return unless exists $config{"gitweb.$key"};
2813 # ensure given type
2814 if (!defined $type) {
2815 return $config{"gitweb.$key"};
2816 } elsif ($type eq 'bool') {
2817 # backward compatibility: 'git config --bool' returns true/false
2818 return config_to_bool($config{"gitweb.$key"}) ? 'true' : 'false';
2819 } elsif ($type eq 'int') {
2820 return config_to_int($config{"gitweb.$key"});
2822 return $config{"gitweb.$key"};
2825 # get hash of given path at given ref
2826 sub git_get_hash_by_path {
2827 my $base = shift;
2828 my $path = shift || return undef;
2829 my $type = shift;
2831 $path =~ s,/+$,,;
2833 open my $fd, "-|", git_cmd(), "ls-tree", $base, "--", $path
2834 or die_error(500, "Open git-ls-tree failed");
2835 my $line = <$fd>;
2836 close $fd or return undef;
2838 if (!defined $line) {
2839 # there is no tree or hash given by $path at $base
2840 return undef;
2843 #'100644 blob 0fa3f3a66fb6a137f6ec2c19351ed4d807070ffa panic.c'
2844 $line =~ m/^([0-9]+) (.+) ([0-9a-fA-F]{40})\t/;
2845 if (defined $type && $type ne $2) {
2846 # type doesn't match
2847 return undef;
2849 return $3;
2852 # get path of entry with given hash at given tree-ish (ref)
2853 # used to get 'from' filename for combined diff (merge commit) for renames
2854 sub git_get_path_by_hash {
2855 my $base = shift || return;
2856 my $hash = shift || return;
2858 local $/ = "\0";
2860 open my $fd, "-|", git_cmd(), "ls-tree", '-r', '-t', '-z', $base
2861 or return undef;
2862 while (my $line = <$fd>) {
2863 chomp $line;
2865 #'040000 tree 595596a6a9117ddba9fe379b6b012b558bac8423 gitweb'
2866 #'100644 blob e02e90f0429be0d2a69b76571101f20b8f75530f gitweb/README'
2867 if ($line =~ m/(?:[0-9]+) (?:.+) $hash\t(.+)$/) {
2868 close $fd;
2869 return $1;
2872 close $fd;
2873 return undef;
2876 ## ......................................................................
2877 ## git utility functions, directly accessing git repository
2879 # get the value of config variable either from file named as the variable
2880 # itself in the repository ($GIT_DIR/$name file), or from gitweb.$name
2881 # configuration variable in the repository config file.
2882 sub git_get_file_or_project_config {
2883 my ($path, $name) = @_;
2885 $git_dir = "$projectroot/$path";
2886 open my $fd, '<', "$git_dir/$name"
2887 or return git_get_project_config($name);
2888 my $conf = <$fd>;
2889 close $fd;
2890 if (defined $conf) {
2891 chomp $conf;
2893 return $conf;
2896 sub git_get_project_description {
2897 my $path = shift;
2898 return git_get_file_or_project_config($path, 'description');
2901 sub git_get_project_category {
2902 my $path = shift;
2903 return git_get_file_or_project_config($path, 'category');
2907 # supported formats:
2908 # * $GIT_DIR/ctags/<tagname> file (in 'ctags' subdirectory)
2909 # - if its contents is a number, use it as tag weight,
2910 # - otherwise add a tag with weight 1
2911 # * $GIT_DIR/ctags file, each line is a tag (with weight 1)
2912 # the same value multiple times increases tag weight
2913 # * `gitweb.ctag' multi-valued repo config variable
2914 sub git_get_project_ctags {
2915 my $project = shift;
2916 my $ctags = {};
2918 $git_dir = "$projectroot/$project";
2919 if (opendir my $dh, "$git_dir/ctags") {
2920 my @files = grep { -f $_ } map { "$git_dir/ctags/$_" } readdir($dh);
2921 foreach my $tagfile (@files) {
2922 open my $ct, '<', $tagfile
2923 or next;
2924 my $val = <$ct>;
2925 chomp $val if $val;
2926 close $ct;
2928 (my $ctag = $tagfile) =~ s#.*/##;
2929 if ($val =~ /^\d+$/) {
2930 $ctags->{$ctag} = $val;
2931 } else {
2932 $ctags->{$ctag} = 1;
2935 closedir $dh;
2937 } elsif (open my $fh, '<', "$git_dir/ctags") {
2938 while (my $line = <$fh>) {
2939 chomp $line;
2940 $ctags->{$line}++ if $line;
2942 close $fh;
2944 } else {
2945 my $taglist = config_to_multi(git_get_project_config('ctag'));
2946 foreach my $tag (@$taglist) {
2947 $ctags->{$tag}++;
2951 return $ctags;
2954 # return hash, where keys are content tags ('ctags'),
2955 # and values are sum of weights of given tag in every project
2956 sub git_gather_all_ctags {
2957 my $projects = shift;
2958 my $ctags = {};
2960 foreach my $p (@$projects) {
2961 foreach my $ct (keys %{$p->{'ctags'}}) {
2962 $ctags->{$ct} += $p->{'ctags'}->{$ct};
2966 return $ctags;
2969 sub git_populate_project_tagcloud {
2970 my $ctags = shift;
2972 # First, merge different-cased tags; tags vote on casing
2973 my %ctags_lc;
2974 foreach (keys %$ctags) {
2975 $ctags_lc{lc $_}->{count} += $ctags->{$_};
2976 if (not $ctags_lc{lc $_}->{topcount}
2977 or $ctags_lc{lc $_}->{topcount} < $ctags->{$_}) {
2978 $ctags_lc{lc $_}->{topcount} = $ctags->{$_};
2979 $ctags_lc{lc $_}->{topname} = $_;
2983 my $cloud;
2984 my $matched = $input_params{'ctag'};
2985 if (eval { require HTML::TagCloud; 1; }) {
2986 $cloud = HTML::TagCloud->new;
2987 foreach my $ctag (sort keys %ctags_lc) {
2988 # Pad the title with spaces so that the cloud looks
2989 # less crammed.
2990 my $title = esc_html($ctags_lc{$ctag}->{topname});
2991 $title =~ s/ /&nbsp;/g;
2992 $title =~ s/^/&nbsp;/g;
2993 $title =~ s/$/&nbsp;/g;
2994 if (defined $matched && $matched eq $ctag) {
2995 $title = qq(<span class="match">$title</span>);
2997 $cloud->add($title, href(project=>undef, ctag=>$ctag),
2998 $ctags_lc{$ctag}->{count});
3000 } else {
3001 $cloud = {};
3002 foreach my $ctag (keys %ctags_lc) {
3003 my $title = esc_html($ctags_lc{$ctag}->{topname}, -nbsp=>1);
3004 if (defined $matched && $matched eq $ctag) {
3005 $title = qq(<span class="match">$title</span>);
3007 $cloud->{$ctag}{count} = $ctags_lc{$ctag}->{count};
3008 $cloud->{$ctag}{ctag} =
3009 $cgi->a({-href=>href(project=>undef, ctag=>$ctag)}, $title);
3012 return $cloud;
3015 sub git_show_project_tagcloud {
3016 my ($cloud, $count) = @_;
3017 if (ref $cloud eq 'HTML::TagCloud') {
3018 return $cloud->html_and_css($count);
3019 } else {
3020 my @tags = sort { $cloud->{$a}->{'count'} <=> $cloud->{$b}->{'count'} } keys %$cloud;
3021 return
3022 '<div id="htmltagcloud"'.($project ? '' : ' align="center"').'>' .
3023 join (', ', map {
3024 $cloud->{$_}->{'ctag'}
3025 } splice(@tags, 0, $count)) .
3026 '</div>';
3030 sub git_get_project_url_list {
3031 my $path = shift;
3033 $git_dir = "$projectroot/$path";
3034 open my $fd, '<', "$git_dir/cloneurl"
3035 or return wantarray ?
3036 @{ config_to_multi(git_get_project_config('url')) } :
3037 config_to_multi(git_get_project_config('url'));
3038 my @git_project_url_list = map { chomp; $_ } <$fd>;
3039 close $fd;
3041 return wantarray ? @git_project_url_list : \@git_project_url_list;
3044 sub git_get_projects_list {
3045 my $filter = shift || '';
3046 my $paranoid = shift;
3047 my @list;
3049 if (-d $projects_list) {
3050 # search in directory
3051 my $dir = $projects_list;
3052 # remove the trailing "/"
3053 $dir =~ s!/+$!!;
3054 my $pfxlen = length("$dir");
3055 my $pfxdepth = ($dir =~ tr!/!!);
3056 # when filtering, search only given subdirectory
3057 if ($filter && !$paranoid) {
3058 $dir .= "/$filter";
3059 $dir =~ s!/+$!!;
3062 File::Find::find({
3063 follow_fast => 1, # follow symbolic links
3064 follow_skip => 2, # ignore duplicates
3065 dangling_symlinks => 0, # ignore dangling symlinks, silently
3066 wanted => sub {
3067 # global variables
3068 our $project_maxdepth;
3069 our $projectroot;
3070 # skip project-list toplevel, if we get it.
3071 return if (m!^[/.]$!);
3072 # only directories can be git repositories
3073 return unless (-d $_);
3074 # don't traverse too deep (Find is super slow on os x)
3075 # $project_maxdepth excludes depth of $projectroot
3076 if (($File::Find::name =~ tr!/!!) - $pfxdepth > $project_maxdepth) {
3077 $File::Find::prune = 1;
3078 return;
3081 my $path = substr($File::Find::name, $pfxlen + 1);
3082 # paranoidly only filter here
3083 if ($paranoid && $filter && $path !~ m!^\Q$filter\E/!) {
3084 next;
3086 # we check related file in $projectroot
3087 if (check_export_ok("$projectroot/$path")) {
3088 push @list, { path => $path };
3089 $File::Find::prune = 1;
3092 }, "$dir");
3094 } elsif (-f $projects_list) {
3095 # read from file(url-encoded):
3096 # 'git%2Fgit.git Linus+Torvalds'
3097 # 'libs%2Fklibc%2Fklibc.git H.+Peter+Anvin'
3098 # 'linux%2Fhotplug%2Fudev.git Greg+Kroah-Hartman'
3099 open my $fd, '<', $projects_list or return;
3100 PROJECT:
3101 while (my $line = <$fd>) {
3102 chomp $line;
3103 my ($path, $owner) = split ' ', $line;
3104 $path = unescape($path);
3105 $owner = unescape($owner);
3106 if (!defined $path) {
3107 next;
3109 # if $filter is rpovided, check if $path begins with $filter
3110 if ($filter && $path !~ m!^\Q$filter\E/!) {
3111 next;
3113 if (check_export_ok("$projectroot/$path")) {
3114 my $pr = {
3115 path => $path
3117 if ($owner) {
3118 $pr->{'owner'} = to_utf8($owner);
3120 push @list, $pr;
3123 close $fd;
3125 return @list;
3128 # written with help of Tree::Trie module (Perl Artistic License, GPL compatibile)
3129 # as side effects it sets 'forks' field to list of forks for forked projects
3130 sub filter_forks_from_projects_list {
3131 my $projects = shift;
3133 my %trie; # prefix tree of directories (path components)
3134 # generate trie out of those directories that might contain forks
3135 foreach my $pr (@$projects) {
3136 my $path = $pr->{'path'};
3137 $path =~ s/\.git$//; # forks of 'repo.git' are in 'repo/' directory
3138 next if ($path =~ m!/$!); # skip non-bare repositories, e.g. 'repo/.git'
3139 next unless ($path); # skip '.git' repository: tests, git-instaweb
3140 next unless (-d "$projectroot/$path"); # containing directory exists
3141 $pr->{'forks'} = []; # there can be 0 or more forks of project
3143 # add to trie
3144 my @dirs = split('/', $path);
3145 # walk the trie, until either runs out of components or out of trie
3146 my $ref = \%trie;
3147 while (scalar @dirs &&
3148 exists($ref->{$dirs[0]})) {
3149 $ref = $ref->{shift @dirs};
3151 # create rest of trie structure from rest of components
3152 foreach my $dir (@dirs) {
3153 $ref = $ref->{$dir} = {};
3155 # create end marker, store $pr as a data
3156 $ref->{''} = $pr if (!exists $ref->{''});
3159 # filter out forks, by finding shortest prefix match for paths
3160 my @filtered;
3161 PROJECT:
3162 foreach my $pr (@$projects) {
3163 # trie lookup
3164 my $ref = \%trie;
3165 DIR:
3166 foreach my $dir (split('/', $pr->{'path'})) {
3167 if (exists $ref->{''}) {
3168 # found [shortest] prefix, is a fork - skip it
3169 push @{$ref->{''}{'forks'}}, $pr;
3170 next PROJECT;
3172 if (!exists $ref->{$dir}) {
3173 # not in trie, cannot have prefix, not a fork
3174 push @filtered, $pr;
3175 next PROJECT;
3177 # If the dir is there, we just walk one step down the trie.
3178 $ref = $ref->{$dir};
3180 # we ran out of trie
3181 # (shouldn't happen: it's either no match, or end marker)
3182 push @filtered, $pr;
3185 return @filtered;
3188 # note: fill_project_list_info must be run first,
3189 # for 'descr_long' and 'ctags' to be filled
3190 sub search_projects_list {
3191 my ($projlist, %opts) = @_;
3192 my $tagfilter = $opts{'tagfilter'};
3193 my $search_re = $opts{'search_regexp'};
3195 return @$projlist
3196 unless ($tagfilter || $search_re);
3198 # searching projects require filling to be run before it;
3199 fill_project_list_info($projlist,
3200 $tagfilter ? 'ctags' : (),
3201 $search_re ? ('path', 'descr') : ());
3202 my @projects;
3203 PROJECT:
3204 foreach my $pr (@$projlist) {
3206 if ($tagfilter) {
3207 next unless ref($pr->{'ctags'}) eq 'HASH';
3208 next unless
3209 grep { lc($_) eq lc($tagfilter) } keys %{$pr->{'ctags'}};
3212 if ($search_re) {
3213 next unless
3214 $pr->{'path'} =~ /$search_re/ ||
3215 $pr->{'descr_long'} =~ /$search_re/;
3218 push @projects, $pr;
3221 return @projects;
3224 our $gitweb_project_owner = undef;
3225 sub git_get_project_list_from_file {
3227 return if (defined $gitweb_project_owner);
3229 $gitweb_project_owner = {};
3230 # read from file (url-encoded):
3231 # 'git%2Fgit.git Linus+Torvalds'
3232 # 'libs%2Fklibc%2Fklibc.git H.+Peter+Anvin'
3233 # 'linux%2Fhotplug%2Fudev.git Greg+Kroah-Hartman'
3234 if (-f $projects_list) {
3235 open(my $fd, '<', $projects_list);
3236 while (my $line = <$fd>) {
3237 chomp $line;
3238 my ($pr, $ow) = split ' ', $line;
3239 $pr = unescape($pr);
3240 $ow = unescape($ow);
3241 $gitweb_project_owner->{$pr} = to_utf8($ow);
3243 close $fd;
3247 sub git_get_project_owner {
3248 my $project = shift;
3249 my $owner;
3251 return undef unless $project;
3252 $git_dir = "$projectroot/$project";
3254 if (!defined $gitweb_project_owner) {
3255 git_get_project_list_from_file();
3258 if (exists $gitweb_project_owner->{$project}) {
3259 $owner = $gitweb_project_owner->{$project};
3261 if (!defined $owner){
3262 $owner = git_get_project_config('owner');
3264 if (!defined $owner) {
3265 $owner = get_file_owner("$git_dir");
3268 return $owner;
3271 sub git_get_last_activity {
3272 my ($path) = @_;
3273 my $fd;
3275 $git_dir = "$projectroot/$path";
3276 open($fd, "-|", git_cmd(), 'for-each-ref',
3277 '--format=%(committer)',
3278 '--sort=-committerdate',
3279 '--count=1',
3280 map { "refs/$_" } get_branch_refs ()) or return;
3281 my $most_recent = <$fd>;
3282 close $fd or return;
3283 if (defined $most_recent &&
3284 $most_recent =~ / (\d+) [-+][01]\d\d\d$/) {
3285 my $timestamp = $1;
3286 my $age = time - $timestamp;
3287 return ($age, age_string($age));
3289 return (undef, undef);
3292 # Implementation note: when a single remote is wanted, we cannot use 'git
3293 # remote show -n' because that command always work (assuming it's a remote URL
3294 # if it's not defined), and we cannot use 'git remote show' because that would
3295 # try to make a network roundtrip. So the only way to find if that particular
3296 # remote is defined is to walk the list provided by 'git remote -v' and stop if
3297 # and when we find what we want.
3298 sub git_get_remotes_list {
3299 my $wanted = shift;
3300 my %remotes = ();
3302 open my $fd, '-|' , git_cmd(), 'remote', '-v';
3303 return unless $fd;
3304 while (my $remote = <$fd>) {
3305 chomp $remote;
3306 $remote =~ s!\t(.*?)\s+\((\w+)\)$!!;
3307 next if $wanted and not $remote eq $wanted;
3308 my ($url, $key) = ($1, $2);
3310 $remotes{$remote} ||= { 'heads' => () };
3311 $remotes{$remote}{$key} = $url;
3313 close $fd or return;
3314 return wantarray ? %remotes : \%remotes;
3317 # Takes a hash of remotes as first parameter and fills it by adding the
3318 # available remote heads for each of the indicated remotes.
3319 sub fill_remote_heads {
3320 my $remotes = shift;
3321 my @heads = map { "remotes/$_" } keys %$remotes;
3322 my @remoteheads = git_get_heads_list(undef, @heads);
3323 foreach my $remote (keys %$remotes) {
3324 $remotes->{$remote}{'heads'} = [ grep {
3325 $_->{'name'} =~ s!^$remote/!!
3326 } @remoteheads ];
3330 sub git_get_references {
3331 my $type = shift || "";
3332 my %refs;
3333 # 5dc01c595e6c6ec9ccda4f6f69c131c0dd945f8c refs/tags/v2.6.11
3334 # c39ae07f393806ccf406ef966e9a15afc43cc36a refs/tags/v2.6.11^{}
3335 open my $fd, "-|", git_cmd(), "show-ref", "--dereference",
3336 ($type ? ("--", "refs/$type") : ()) # use -- <pattern> if $type
3337 or return;
3339 while (my $line = <$fd>) {
3340 chomp $line;
3341 if ($line =~ m!^([0-9a-fA-F]{40})\srefs/($type.*)$!) {
3342 if (defined $refs{$1}) {
3343 push @{$refs{$1}}, $2;
3344 } else {
3345 $refs{$1} = [ $2 ];
3349 close $fd or return;
3350 return \%refs;
3353 sub git_get_rev_name_tags {
3354 my $hash = shift || return undef;
3356 open my $fd, "-|", git_cmd(), "name-rev", "--tags", $hash
3357 or return;
3358 my $name_rev = <$fd>;
3359 close $fd;
3361 if ($name_rev =~ m|^$hash tags/(.*)$|) {
3362 return $1;
3363 } else {
3364 # catches also '$hash undefined' output
3365 return undef;
3369 ## ----------------------------------------------------------------------
3370 ## parse to hash functions
3372 sub parse_date {
3373 my $epoch = shift;
3374 my $tz = shift || "-0000";
3376 my %date;
3377 my @months = ("Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec");
3378 my @days = ("Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat");
3379 my ($sec, $min, $hour, $mday, $mon, $year, $wday, $yday) = gmtime($epoch);
3380 $date{'hour'} = $hour;
3381 $date{'minute'} = $min;
3382 $date{'mday'} = $mday;
3383 $date{'day'} = $days[$wday];
3384 $date{'month'} = $months[$mon];
3385 $date{'rfc2822'} = sprintf "%s, %d %s %4d %02d:%02d:%02d +0000",
3386 $days[$wday], $mday, $months[$mon], 1900+$year, $hour ,$min, $sec;
3387 $date{'mday-time'} = sprintf "%d %s %02d:%02d",
3388 $mday, $months[$mon], $hour ,$min;
3389 $date{'iso-8601'} = sprintf "%04d-%02d-%02dT%02d:%02d:%02dZ",
3390 1900+$year, 1+$mon, $mday, $hour ,$min, $sec;
3392 my ($tz_sign, $tz_hour, $tz_min) =
3393 ($tz =~ m/^([-+])(\d\d)(\d\d)$/);
3394 $tz_sign = ($tz_sign eq '-' ? -1 : +1);
3395 my $local = $epoch + $tz_sign*((($tz_hour*60) + $tz_min)*60);
3396 ($sec, $min, $hour, $mday, $mon, $year, $wday, $yday) = gmtime($local);
3397 $date{'hour_local'} = $hour;
3398 $date{'minute_local'} = $min;
3399 $date{'tz_local'} = $tz;
3400 $date{'iso-tz'} = sprintf("%04d-%02d-%02d %02d:%02d:%02d %s",
3401 1900+$year, $mon+1, $mday,
3402 $hour, $min, $sec, $tz);
3403 return %date;
3406 sub parse_tag {
3407 my $tag_id = shift;
3408 my %tag;
3409 my @comment;
3411 open my $fd, "-|", git_cmd(), "cat-file", "tag", $tag_id or return;
3412 $tag{'id'} = $tag_id;
3413 while (my $line = <$fd>) {
3414 chomp $line;
3415 if ($line =~ m/^object ([0-9a-fA-F]{40})$/) {
3416 $tag{'object'} = $1;
3417 } elsif ($line =~ m/^type (.+)$/) {
3418 $tag{'type'} = $1;
3419 } elsif ($line =~ m/^tag (.+)$/) {
3420 $tag{'name'} = $1;
3421 } elsif ($line =~ m/^tagger (.*) ([0-9]+) (.*)$/) {
3422 $tag{'author'} = $1;
3423 $tag{'author_epoch'} = $2;
3424 $tag{'author_tz'} = $3;
3425 if ($tag{'author'} =~ m/^([^<]+) <([^>]*)>/) {
3426 $tag{'author_name'} = $1;
3427 $tag{'author_email'} = $2;
3428 } else {
3429 $tag{'author_name'} = $tag{'author'};
3431 } elsif ($line =~ m/--BEGIN/) {
3432 push @comment, $line;
3433 last;
3434 } elsif ($line eq "") {
3435 last;
3438 push @comment, <$fd>;
3439 $tag{'comment'} = \@comment;
3440 close $fd or return;
3441 if (!defined $tag{'name'}) {
3442 return
3444 return %tag
3447 sub parse_commit_text {
3448 my ($commit_text, $withparents) = @_;
3449 my @commit_lines = split '\n', $commit_text;
3450 my %co;
3452 pop @commit_lines; # Remove '\0'
3454 if (! @commit_lines) {
3455 return;
3458 my $header = shift @commit_lines;
3459 if ($header !~ m/^[0-9a-fA-F]{40}/) {
3460 return;
3462 ($co{'id'}, my @parents) = split ' ', $header;
3463 while (my $line = shift @commit_lines) {
3464 last if $line eq "\n";
3465 if ($line =~ m/^tree ([0-9a-fA-F]{40})$/) {
3466 $co{'tree'} = $1;
3467 } elsif ((!defined $withparents) && ($line =~ m/^parent ([0-9a-fA-F]{40})$/)) {
3468 push @parents, $1;
3469 } elsif ($line =~ m/^author (.*) ([0-9]+) (.*)$/) {
3470 $co{'author'} = to_utf8($1);
3471 $co{'author_epoch'} = $2;
3472 $co{'author_tz'} = $3;
3473 if ($co{'author'} =~ m/^([^<]+) <([^>]*)>/) {
3474 $co{'author_name'} = $1;
3475 $co{'author_email'} = $2;
3476 } else {
3477 $co{'author_name'} = $co{'author'};
3479 } elsif ($line =~ m/^committer (.*) ([0-9]+) (.*)$/) {
3480 $co{'committer'} = to_utf8($1);
3481 $co{'committer_epoch'} = $2;
3482 $co{'committer_tz'} = $3;
3483 if ($co{'committer'} =~ m/^([^<]+) <([^>]*)>/) {
3484 $co{'committer_name'} = $1;
3485 $co{'committer_email'} = $2;
3486 } else {
3487 $co{'committer_name'} = $co{'committer'};
3491 if (!defined $co{'tree'}) {
3492 return;
3494 $co{'parents'} = \@parents;
3495 $co{'parent'} = $parents[0];
3497 foreach my $title (@commit_lines) {
3498 $title =~ s/^ //;
3499 if ($title ne "") {
3500 $co{'title'} = chop_str($title, 80, 5);
3501 # remove leading stuff of merges to make the interesting part visible
3502 if (length($title) > 50) {
3503 $title =~ s/^Automatic //;
3504 $title =~ s/^merge (of|with) /Merge ... /i;
3505 if (length($title) > 50) {
3506 $title =~ s/(http|rsync):\/\///;
3508 if (length($title) > 50) {
3509 $title =~ s/(master|www|rsync)\.//;
3511 if (length($title) > 50) {
3512 $title =~ s/kernel.org:?//;
3514 if (length($title) > 50) {
3515 $title =~ s/\/pub\/scm//;
3518 $co{'title_short'} = chop_str($title, 50, 5);
3519 last;
3522 if (! defined $co{'title'} || $co{'title'} eq "") {
3523 $co{'title'} = $co{'title_short'} = '(no commit message)';
3525 # remove added spaces
3526 foreach my $line (@commit_lines) {
3527 $line =~ s/^ //;
3529 $co{'comment'} = \@commit_lines;
3531 my $age = time - $co{'committer_epoch'};
3532 $co{'age'} = $age;
3533 $co{'age_string'} = age_string($age);
3534 my ($sec, $min, $hour, $mday, $mon, $year, $wday, $yday) = gmtime($co{'committer_epoch'});
3535 if ($age > 60*60*24*7*2) {
3536 $co{'age_string_date'} = sprintf "%4i-%02u-%02i", 1900 + $year, $mon+1, $mday;
3537 $co{'age_string_age'} = $co{'age_string'};
3538 } else {
3539 $co{'age_string_date'} = $co{'age_string'};
3540 $co{'age_string_age'} = sprintf "%4i-%02u-%02i", 1900 + $year, $mon+1, $mday;
3542 return %co;
3545 sub parse_commit {
3546 my ($commit_id) = @_;
3547 my %co;
3549 local $/ = "\0";
3551 open my $fd, "-|", git_cmd(), "rev-list",
3552 "--parents",
3553 "--header",
3554 "--max-count=1",
3555 $commit_id,
3556 "--",
3557 or die_error(500, "Open git-rev-list failed");
3558 %co = parse_commit_text(<$fd>, 1);
3559 close $fd;
3561 return %co;
3564 sub parse_commits {
3565 my ($commit_id, $maxcount, $skip, $filename, @args) = @_;
3566 my @cos;
3568 $maxcount ||= 1;
3569 $skip ||= 0;
3571 local $/ = "\0";
3573 open my $fd, "-|", git_cmd(), "rev-list",
3574 "--header",
3575 @args,
3576 ("--max-count=" . $maxcount),
3577 ("--skip=" . $skip),
3578 @extra_options,
3579 $commit_id,
3580 "--",
3581 ($filename ? ($filename) : ())
3582 or die_error(500, "Open git-rev-list failed");
3583 while (my $line = <$fd>) {
3584 my %co = parse_commit_text($line);
3585 push @cos, \%co;
3587 close $fd;
3589 return wantarray ? @cos : \@cos;
3592 # parse line of git-diff-tree "raw" output
3593 sub parse_difftree_raw_line {
3594 my $line = shift;
3595 my %res;
3597 # ':100644 100644 03b218260e99b78c6df0ed378e59ed9205ccc96d 3b93d5e7cc7f7dd4ebed13a5cc1a4ad976fc94d8 M ls-files.c'
3598 # ':100644 100644 7f9281985086971d3877aca27704f2aaf9c448ce bc190ebc71bbd923f2b728e505408f5e54bd073a M rev-tree.c'
3599 if ($line =~ m/^:([0-7]{6}) ([0-7]{6}) ([0-9a-fA-F]{40}) ([0-9a-fA-F]{40}) (.)([0-9]{0,3})\t(.*)$/) {
3600 $res{'from_mode'} = $1;
3601 $res{'to_mode'} = $2;
3602 $res{'from_id'} = $3;
3603 $res{'to_id'} = $4;
3604 $res{'status'} = $5;
3605 $res{'similarity'} = $6;
3606 if ($res{'status'} eq 'R' || $res{'status'} eq 'C') { # renamed or copied
3607 ($res{'from_file'}, $res{'to_file'}) = map { unquote($_) } split("\t", $7);
3608 } else {
3609 $res{'from_file'} = $res{'to_file'} = $res{'file'} = unquote($7);
3612 # '::100755 100755 100755 60e79ca1b01bc8b057abe17ddab484699a7f5fdb 94067cc5f73388f33722d52ae02f44692bc07490 94067cc5f73388f33722d52ae02f44692bc07490 MR git-gui/git-gui.sh'
3613 # combined diff (for merge commit)
3614 elsif ($line =~ s/^(::+)((?:[0-7]{6} )+)((?:[0-9a-fA-F]{40} )+)([a-zA-Z]+)\t(.*)$//) {
3615 $res{'nparents'} = length($1);
3616 $res{'from_mode'} = [ split(' ', $2) ];
3617 $res{'to_mode'} = pop @{$res{'from_mode'}};
3618 $res{'from_id'} = [ split(' ', $3) ];
3619 $res{'to_id'} = pop @{$res{'from_id'}};
3620 $res{'status'} = [ split('', $4) ];
3621 $res{'to_file'} = unquote($5);
3623 # 'c512b523472485aef4fff9e57b229d9d243c967f'
3624 elsif ($line =~ m/^([0-9a-fA-F]{40})$/) {
3625 $res{'commit'} = $1;
3628 return wantarray ? %res : \%res;
3631 # wrapper: return parsed line of git-diff-tree "raw" output
3632 # (the argument might be raw line, or parsed info)
3633 sub parsed_difftree_line {
3634 my $line_or_ref = shift;
3636 if (ref($line_or_ref) eq "HASH") {
3637 # pre-parsed (or generated by hand)
3638 return $line_or_ref;
3639 } else {
3640 return parse_difftree_raw_line($line_or_ref);
3644 # parse line of git-ls-tree output
3645 sub parse_ls_tree_line {
3646 my $line = shift;
3647 my %opts = @_;
3648 my %res;
3650 if ($opts{'-l'}) {
3651 #'100644 blob 0fa3f3a66fb6a137f6ec2c19351ed4d807070ffa 16717 panic.c'
3652 $line =~ m/^([0-9]+) (.+) ([0-9a-fA-F]{40}) +(-|[0-9]+)\t(.+)$/s;
3654 $res{'mode'} = $1;
3655 $res{'type'} = $2;
3656 $res{'hash'} = $3;
3657 $res{'size'} = $4;
3658 if ($opts{'-z'}) {
3659 $res{'name'} = $5;
3660 } else {
3661 $res{'name'} = unquote($5);
3663 } else {
3664 #'100644 blob 0fa3f3a66fb6a137f6ec2c19351ed4d807070ffa panic.c'
3665 $line =~ m/^([0-9]+) (.+) ([0-9a-fA-F]{40})\t(.+)$/s;
3667 $res{'mode'} = $1;
3668 $res{'type'} = $2;
3669 $res{'hash'} = $3;
3670 if ($opts{'-z'}) {
3671 $res{'name'} = $4;
3672 } else {
3673 $res{'name'} = unquote($4);
3677 return wantarray ? %res : \%res;
3680 # generates _two_ hashes, references to which are passed as 2 and 3 argument
3681 sub parse_from_to_diffinfo {
3682 my ($diffinfo, $from, $to, @parents) = @_;
3684 if ($diffinfo->{'nparents'}) {
3685 # combined diff
3686 $from->{'file'} = [];
3687 $from->{'href'} = [];
3688 fill_from_file_info($diffinfo, @parents)
3689 unless exists $diffinfo->{'from_file'};
3690 for (my $i = 0; $i < $diffinfo->{'nparents'}; $i++) {
3691 $from->{'file'}[$i] =
3692 defined $diffinfo->{'from_file'}[$i] ?
3693 $diffinfo->{'from_file'}[$i] :
3694 $diffinfo->{'to_file'};
3695 if ($diffinfo->{'status'}[$i] ne "A") { # not new (added) file
3696 $from->{'href'}[$i] = href(action=>"blob",
3697 hash_base=>$parents[$i],
3698 hash=>$diffinfo->{'from_id'}[$i],
3699 file_name=>$from->{'file'}[$i]);
3700 } else {
3701 $from->{'href'}[$i] = undef;
3704 } else {
3705 # ordinary (not combined) diff
3706 $from->{'file'} = $diffinfo->{'from_file'};
3707 if ($diffinfo->{'status'} ne "A") { # not new (added) file
3708 $from->{'href'} = href(action=>"blob", hash_base=>$hash_parent,
3709 hash=>$diffinfo->{'from_id'},
3710 file_name=>$from->{'file'});
3711 } else {
3712 delete $from->{'href'};
3716 $to->{'file'} = $diffinfo->{'to_file'};
3717 if (!is_deleted($diffinfo)) { # file exists in result
3718 $to->{'href'} = href(action=>"blob", hash_base=>$hash,
3719 hash=>$diffinfo->{'to_id'},
3720 file_name=>$to->{'file'});
3721 } else {
3722 delete $to->{'href'};
3726 ## ......................................................................
3727 ## parse to array of hashes functions
3729 sub git_get_heads_list {
3730 my ($limit, @classes) = @_;
3731 @classes = get_branch_refs() unless @classes;
3732 my @patterns = map { "refs/$_" } @classes;
3733 my @headslist;
3735 open my $fd, '-|', git_cmd(), 'for-each-ref',
3736 ($limit ? '--count='.($limit+1) : ()), '--sort=-committerdate',
3737 '--format=%(objectname) %(refname) %(subject)%00%(committer)',
3738 @patterns
3739 or return;
3740 while (my $line = <$fd>) {
3741 my %ref_item;
3743 chomp $line;
3744 my ($refinfo, $committerinfo) = split(/\0/, $line);
3745 my ($hash, $name, $title) = split(' ', $refinfo, 3);
3746 my ($committer, $epoch, $tz) =
3747 ($committerinfo =~ /^(.*) ([0-9]+) (.*)$/);
3748 $ref_item{'fullname'} = $name;
3749 my $strip_refs = join '|', map { quotemeta } get_branch_refs();
3750 $name =~ s!^refs/($strip_refs|remotes)/!!;
3751 $ref_item{'name'} = $name;
3752 # for refs neither in 'heads' nor 'remotes' we want to
3753 # show their ref dir
3754 my $ref_dir = (defined $1) ? $1 : '';
3755 if ($ref_dir ne '' and $ref_dir ne 'heads' and $ref_dir ne 'remotes') {
3756 $ref_item{'name'} .= ' (' . $ref_dir . ')';
3759 $ref_item{'id'} = $hash;
3760 $ref_item{'title'} = $title || '(no commit message)';
3761 $ref_item{'epoch'} = $epoch;
3762 if ($epoch) {
3763 $ref_item{'age'} = age_string(time - $ref_item{'epoch'});
3764 } else {
3765 $ref_item{'age'} = "unknown";
3768 push @headslist, \%ref_item;
3770 close $fd;
3772 return wantarray ? @headslist : \@headslist;
3775 sub git_get_tags_list {
3776 my $limit = shift;
3777 my @tagslist;
3779 open my $fd, '-|', git_cmd(), 'for-each-ref',
3780 ($limit ? '--count='.($limit+1) : ()), '--sort=-creatordate',
3781 '--format=%(objectname) %(objecttype) %(refname) '.
3782 '%(*objectname) %(*objecttype) %(subject)%00%(creator)',
3783 'refs/tags'
3784 or return;
3785 while (my $line = <$fd>) {
3786 my %ref_item;
3788 chomp $line;
3789 my ($refinfo, $creatorinfo) = split(/\0/, $line);
3790 my ($id, $type, $name, $refid, $reftype, $title) = split(' ', $refinfo, 6);
3791 my ($creator, $epoch, $tz) =
3792 ($creatorinfo =~ /^(.*) ([0-9]+) (.*)$/);
3793 $ref_item{'fullname'} = $name;
3794 $name =~ s!^refs/tags/!!;
3796 $ref_item{'type'} = $type;
3797 $ref_item{'id'} = $id;
3798 $ref_item{'name'} = $name;
3799 if ($type eq "tag") {
3800 $ref_item{'subject'} = $title;
3801 $ref_item{'reftype'} = $reftype;
3802 $ref_item{'refid'} = $refid;
3803 } else {
3804 $ref_item{'reftype'} = $type;
3805 $ref_item{'refid'} = $id;
3808 if ($type eq "tag" || $type eq "commit") {
3809 $ref_item{'epoch'} = $epoch;
3810 if ($epoch) {
3811 $ref_item{'age'} = age_string(time - $ref_item{'epoch'});
3812 } else {
3813 $ref_item{'age'} = "unknown";
3817 push @tagslist, \%ref_item;
3819 close $fd;
3821 return wantarray ? @tagslist : \@tagslist;
3824 ## ----------------------------------------------------------------------
3825 ## filesystem-related functions
3827 sub get_file_owner {
3828 my $path = shift;
3830 my ($dev, $ino, $mode, $nlink, $st_uid, $st_gid, $rdev, $size) = stat($path);
3831 my ($name, $passwd, $uid, $gid, $quota, $comment, $gcos, $dir, $shell) = getpwuid($st_uid);
3832 if (!defined $gcos) {
3833 return undef;
3835 my $owner = $gcos;
3836 $owner =~ s/[,;].*$//;
3837 return to_utf8($owner);
3840 # assume that file exists
3841 sub insert_file {
3842 my $filename = shift;
3844 open my $fd, '<', $filename;
3845 print map { to_utf8($_) } <$fd>;
3846 close $fd;
3849 ## ......................................................................
3850 ## mimetype related functions
3852 sub mimetype_guess_file {
3853 my $filename = shift;
3854 my $mimemap = shift;
3855 -r $mimemap or return undef;
3857 my %mimemap;
3858 open(my $mh, '<', $mimemap) or return undef;
3859 while (<$mh>) {
3860 next if m/^#/; # skip comments
3861 my ($mimetype, @exts) = split(/\s+/);
3862 foreach my $ext (@exts) {
3863 $mimemap{$ext} = $mimetype;
3866 close($mh);
3868 $filename =~ /\.([^.]*)$/;
3869 return $mimemap{$1};
3872 sub mimetype_guess {
3873 my $filename = shift;
3874 my $mime;
3875 $filename =~ /\./ or return undef;
3877 if ($mimetypes_file) {
3878 my $file = $mimetypes_file;
3879 if ($file !~ m!^/!) { # if it is relative path
3880 # it is relative to project
3881 $file = "$projectroot/$project/$file";
3883 $mime = mimetype_guess_file($filename, $file);
3885 $mime ||= mimetype_guess_file($filename, '/etc/mime.types');
3886 return $mime;
3889 sub blob_mimetype {
3890 my $fd = shift;
3891 my $filename = shift;
3893 if ($filename) {
3894 my $mime = mimetype_guess($filename);
3895 $mime and return $mime;
3898 # just in case
3899 return $default_blob_plain_mimetype unless $fd;
3901 if (-T $fd) {
3902 return 'text/plain';
3903 } elsif (! $filename) {
3904 return 'application/octet-stream';
3905 } elsif ($filename =~ m/\.png$/i) {
3906 return 'image/png';
3907 } elsif ($filename =~ m/\.gif$/i) {
3908 return 'image/gif';
3909 } elsif ($filename =~ m/\.jpe?g$/i) {
3910 return 'image/jpeg';
3911 } else {
3912 return 'application/octet-stream';
3916 sub blob_contenttype {
3917 my ($fd, $file_name, $type) = @_;
3919 $type ||= blob_mimetype($fd, $file_name);
3920 if ($type eq 'text/plain' && defined $default_text_plain_charset) {
3921 $type .= "; charset=$default_text_plain_charset";
3924 return $type;
3927 # guess file syntax for syntax highlighting; return undef if no highlighting
3928 # the name of syntax can (in the future) depend on syntax highlighter used
3929 sub guess_file_syntax {
3930 my ($highlight, $file_name) = @_;
3931 return undef unless ($highlight && defined $file_name);
3932 my $basename = basename($file_name, '.in');
3933 return $highlight_basename{$basename}
3934 if exists $highlight_basename{$basename};
3936 $basename =~ /\.([^.]*)$/;
3937 my $ext = $1 or return undef;
3938 return $highlight_ext{$ext}
3939 if exists $highlight_ext{$ext};
3941 return undef;
3944 # run highlighter and return FD of its output,
3945 # or return original FD if no highlighting
3946 sub run_highlighter {
3947 my ($fd, $highlight, $syntax) = @_;
3948 return $fd unless ($highlight);
3950 close $fd;
3951 my $syntax_arg = (defined $syntax) ? "--syntax $syntax" : "--force";
3952 open $fd, quote_command(git_cmd(), "cat-file", "blob", $hash)." | ".
3953 quote_command($^X, '-CO', '-MEncode=decode,FB_DEFAULT', '-pse',
3954 '$_ = decode($fe, $_, FB_DEFAULT) if !utf8::decode($_);',
3955 '--', "-fe=$fallback_encoding")." | ".
3956 quote_command($highlight_bin).
3957 " --replace-tabs=8 --fragment $syntax_arg |"
3958 or die_error(500, "Couldn't open file or run syntax highlighter");
3959 return $fd;
3962 ## ======================================================================
3963 ## functions printing HTML: header, footer, error page
3965 sub get_page_title {
3966 my $title = to_utf8($site_name);
3968 unless (defined $project) {
3969 if (defined $project_filter) {
3970 $title .= " - projects in '" . esc_path($project_filter) . "'";
3972 return $title;
3974 $title .= " - " . to_utf8($project);
3976 return $title unless (defined $action);
3977 $title .= "/$action"; # $action is US-ASCII (7bit ASCII)
3979 return $title unless (defined $file_name);
3980 $title .= " - " . esc_path($file_name);
3981 if ($action eq "tree" && $file_name !~ m|/$|) {
3982 $title .= "/";
3985 return $title;
3988 sub get_content_type_html {
3989 # require explicit support from the UA if we are to send the page as
3990 # 'application/xhtml+xml', otherwise send it as plain old 'text/html'.
3991 # we have to do this because MSIE sometimes globs '*/*', pretending to
3992 # support xhtml+xml but choking when it gets what it asked for.
3993 if (defined $cgi->http('HTTP_ACCEPT') &&
3994 $cgi->http('HTTP_ACCEPT') =~ m/(,|;|\s|^)application\/xhtml\+xml(,|;|\s|$)/ &&
3995 $cgi->Accept('application/xhtml+xml') != 0) {
3996 return 'application/xhtml+xml';
3997 } else {
3998 return 'text/html';
4002 sub print_feed_meta {
4003 if (defined $project) {
4004 my %href_params = get_feed_info();
4005 if (!exists $href_params{'-title'}) {
4006 $href_params{'-title'} = 'log';
4009 foreach my $format (qw(RSS Atom)) {
4010 my $type = lc($format);
4011 my %link_attr = (
4012 '-rel' => 'alternate',
4013 '-title' => esc_attr("$project - $href_params{'-title'} - $format feed"),
4014 '-type' => "application/$type+xml"
4017 $href_params{'extra_options'} = undef;
4018 $href_params{'action'} = $type;
4019 $link_attr{'-href'} = href(%href_params);
4020 print "<link ".
4021 "rel=\"$link_attr{'-rel'}\" ".
4022 "title=\"$link_attr{'-title'}\" ".
4023 "href=\"$link_attr{'-href'}\" ".
4024 "type=\"$link_attr{'-type'}\" ".
4025 "/>\n";
4027 $href_params{'extra_options'} = '--no-merges';
4028 $link_attr{'-href'} = href(%href_params);
4029 $link_attr{'-title'} .= ' (no merges)';
4030 print "<link ".
4031 "rel=\"$link_attr{'-rel'}\" ".
4032 "title=\"$link_attr{'-title'}\" ".
4033 "href=\"$link_attr{'-href'}\" ".
4034 "type=\"$link_attr{'-type'}\" ".
4035 "/>\n";
4038 } else {
4039 printf('<link rel="alternate" title="%s projects list" '.
4040 'href="%s" type="text/plain; charset=utf-8" />'."\n",
4041 esc_attr($site_name), href(project=>undef, action=>"project_index"));
4042 printf('<link rel="alternate" title="%s projects feeds" '.
4043 'href="%s" type="text/x-opml" />'."\n",
4044 esc_attr($site_name), href(project=>undef, action=>"opml"));
4048 sub print_header_links {
4049 my $status = shift;
4051 # print out each stylesheet that exist, providing backwards capability
4052 # for those people who defined $stylesheet in a config file
4053 if (defined $stylesheet) {
4054 print '<link rel="stylesheet" type="text/css" href="'.esc_url($stylesheet).'"/>'."\n";
4055 } else {
4056 foreach my $stylesheet (@stylesheets) {
4057 next unless $stylesheet;
4058 print '<link rel="stylesheet" type="text/css" href="'.esc_url($stylesheet).'"/>'."\n";
4061 print_feed_meta()
4062 if ($status eq '200 OK');
4063 if (defined $favicon) {
4064 print qq(<link rel="shortcut icon" href=").esc_url($favicon).qq(" type="image/png" />\n);
4068 sub print_nav_breadcrumbs_path {
4069 my $dirprefix = undef;
4070 while (my $part = shift) {
4071 $dirprefix .= "/" if defined $dirprefix;
4072 $dirprefix .= $part;
4073 print $cgi->a({-href => href(project => undef,
4074 project_filter => $dirprefix,
4075 action => "project_list")},
4076 esc_html($part)) . " / ";
4080 sub print_nav_breadcrumbs {
4081 my %opts = @_;
4083 for my $crumb (@extra_breadcrumbs, [ $home_link_str => $home_link ]) {
4084 print $cgi->a({-href => esc_url($crumb->[1])}, $crumb->[0]) . " / ";
4086 if (defined $project) {
4087 my @dirname = split '/', $project;
4088 my $projectbasename = pop @dirname;
4089 print_nav_breadcrumbs_path(@dirname);
4090 print $cgi->a({-href => href(action=>"summary")}, esc_html($projectbasename));
4091 if (defined $action) {
4092 my $action_print = $action ;
4093 if (defined $opts{-action_extra}) {
4094 $action_print = $cgi->a({-href => href(action=>$action)},
4095 $action);
4097 print " / $action_print";
4099 if (defined $opts{-action_extra}) {
4100 print " / $opts{-action_extra}";
4102 print "\n";
4103 } elsif (defined $project_filter) {
4104 print_nav_breadcrumbs_path(split '/', $project_filter);
4108 sub print_search_form {
4109 if (!defined $searchtext) {
4110 $searchtext = "";
4112 my $search_hash;
4113 if (defined $hash_base) {
4114 $search_hash = $hash_base;
4115 } elsif (defined $hash) {
4116 $search_hash = $hash;
4117 } else {
4118 $search_hash = "HEAD";
4120 my $action = $my_uri;
4121 my $use_pathinfo = gitweb_check_feature('pathinfo');
4122 if ($use_pathinfo) {
4123 $action .= "/".esc_url($project);
4125 print $cgi->start_form(-method => "get", -action => $action) .
4126 "<div class=\"search\">\n" .
4127 (!$use_pathinfo &&
4128 $cgi->input({-name=>"p", -value=>$project, -type=>"hidden"}) . "\n") .
4129 $cgi->input({-name=>"a", -value=>"search", -type=>"hidden"}) . "\n" .
4130 $cgi->input({-name=>"h", -value=>$search_hash, -type=>"hidden"}) . "\n" .
4131 $cgi->popup_menu(-name => 'st', -default => 'commit',
4132 -values => ['commit', 'grep', 'author', 'committer', 'pickaxe']) .
4133 " " . $cgi->a({-href => href(action=>"search_help"),
4134 -title => "search help" }, "?") . " search:\n",
4135 $cgi->textfield(-name => "s", -value => $searchtext, -override => 1) . "\n" .
4136 "<span title=\"Extended regular expression\">" .
4137 $cgi->checkbox(-name => 'sr', -value => 1, -label => 're',
4138 -checked => $search_use_regexp) .
4139 "</span>" .
4140 "</div>" .
4141 $cgi->end_form() . "\n";
4144 sub git_header_html {
4145 my $status = shift || "200 OK";
4146 my $expires = shift;
4147 my %opts = @_;
4149 my $title = get_page_title();
4150 my $content_type = get_content_type_html();
4151 print $cgi->header(-type=>$content_type, -charset => 'utf-8',
4152 -status=> $status, -expires => $expires)
4153 unless ($opts{'-no_http_header'});
4154 my $mod_perl_version = $ENV{'MOD_PERL'} ? " $ENV{'MOD_PERL'}" : '';
4155 print <<EOF;
4156 <?xml version="1.0" encoding="utf-8"?>
4157 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4158 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US" lang="en-US">
4159 <!-- git web interface version $version, (C) 2005-2006, Kay Sievers <kay.sievers\@vrfy.org>, Christian Gierke -->
4160 <!-- git core binaries version $git_version -->
4161 <head>
4162 <meta http-equiv="content-type" content="$content_type; charset=utf-8"/>
4163 <meta name="generator" content="gitweb/$version git/$git_version$mod_perl_version"/>
4164 <meta name="robots" content="index, nofollow"/>
4165 <title>$title</title>
4167 # the stylesheet, favicon etc urls won't work correctly with path_info
4168 # unless we set the appropriate base URL
4169 if ($ENV{'PATH_INFO'}) {
4170 print "<base href=\"".esc_url($base_url)."\" />\n";
4172 print_header_links($status);
4174 if (defined $site_html_head_string) {
4175 print to_utf8($site_html_head_string);
4178 print "</head>\n" .
4179 "<body>\n";
4181 if (defined $site_header && -f $site_header) {
4182 insert_file($site_header);
4185 print "<div class=\"page_header\">\n";
4186 if (defined $logo) {
4187 print $cgi->a({-href => esc_url($logo_url),
4188 -title => $logo_label},
4189 $cgi->img({-src => esc_url($logo),
4190 -width => 72, -height => 27,
4191 -alt => "git",
4192 -class => "logo"}));
4194 print_nav_breadcrumbs(%opts);
4195 print "</div>\n";
4197 my $have_search = gitweb_check_feature('search');
4198 if (defined $project && $have_search) {
4199 print_search_form();
4203 sub git_footer_html {
4204 my $feed_class = 'rss_logo';
4206 print "<div class=\"page_footer\">\n";
4207 if (defined $project) {
4208 my $descr = git_get_project_description($project);
4209 if (defined $descr) {
4210 print "<div class=\"page_footer_text\">" . esc_html($descr) . "</div>\n";
4213 my %href_params = get_feed_info();
4214 if (!%href_params) {
4215 $feed_class .= ' generic';
4217 $href_params{'-title'} ||= 'log';
4219 foreach my $format (qw(RSS Atom)) {
4220 $href_params{'action'} = lc($format);
4221 print $cgi->a({-href => href(%href_params),
4222 -title => "$href_params{'-title'} $format feed",
4223 -class => $feed_class}, $format)."\n";
4226 } else {
4227 print $cgi->a({-href => href(project=>undef, action=>"opml",
4228 project_filter => $project_filter),
4229 -class => $feed_class}, "OPML") . " ";
4230 print $cgi->a({-href => href(project=>undef, action=>"project_index",
4231 project_filter => $project_filter),
4232 -class => $feed_class}, "TXT") . "\n";
4234 print "</div>\n"; # class="page_footer"
4236 if (defined $t0 && gitweb_check_feature('timed')) {
4237 print "<div id=\"generating_info\">\n";
4238 print 'This page took '.
4239 '<span id="generating_time" class="time_span">'.
4240 tv_interval($t0, [ gettimeofday() ]).
4241 ' seconds </span>'.
4242 ' and '.
4243 '<span id="generating_cmd">'.
4244 $number_of_git_cmds.
4245 '</span> git commands '.
4246 " to generate.\n";
4247 print "</div>\n"; # class="page_footer"
4250 if (defined $site_footer && -f $site_footer) {
4251 insert_file($site_footer);
4254 print qq!<script type="text/javascript" src="!.esc_url($javascript).qq!"></script>\n!;
4255 if (defined $action &&
4256 $action eq 'blame_incremental') {
4257 print qq!<script type="text/javascript">\n!.
4258 qq!startBlame("!. href(action=>"blame_data", -replay=>1) .qq!",\n!.
4259 qq! "!. href() .qq!");\n!.
4260 qq!</script>\n!;
4261 } else {
4262 my ($jstimezone, $tz_cookie, $datetime_class) =
4263 gitweb_get_feature('javascript-timezone');
4265 print qq!<script type="text/javascript">\n!.
4266 qq!window.onload = function () {\n!;
4267 if (gitweb_check_feature('javascript-actions')) {
4268 print qq! fixLinks();\n!;
4270 if ($jstimezone && $tz_cookie && $datetime_class) {
4271 print qq! var tz_cookie = { name: '$tz_cookie', expires: 14, path: '/' };\n!. # in days
4272 qq! onloadTZSetup('$jstimezone', tz_cookie, '$datetime_class');\n!;
4274 print qq!};\n!.
4275 qq!</script>\n!;
4278 print "</body>\n" .
4279 "</html>";
4282 # die_error(<http_status_code>, <error_message>[, <detailed_html_description>])
4283 # Example: die_error(404, 'Hash not found')
4284 # By convention, use the following status codes (as defined in RFC 2616):
4285 # 400: Invalid or missing CGI parameters, or
4286 # requested object exists but has wrong type.
4287 # 403: Requested feature (like "pickaxe" or "snapshot") not enabled on
4288 # this server or project.
4289 # 404: Requested object/revision/project doesn't exist.
4290 # 500: The server isn't configured properly, or
4291 # an internal error occurred (e.g. failed assertions caused by bugs), or
4292 # an unknown error occurred (e.g. the git binary died unexpectedly).
4293 # 503: The server is currently unavailable (because it is overloaded,
4294 # or down for maintenance). Generally, this is a temporary state.
4295 sub die_error {
4296 my $status = shift || 500;
4297 my $error = esc_html(shift) || "Internal Server Error";
4298 my $extra = shift;
4299 my %opts = @_;
4301 my %http_responses = (
4302 400 => '400 Bad Request',
4303 403 => '403 Forbidden',
4304 404 => '404 Not Found',
4305 500 => '500 Internal Server Error',
4306 503 => '503 Service Unavailable',
4308 git_header_html($http_responses{$status}, undef, %opts);
4309 print <<EOF;
4310 <div class="page_body">
4311 <br /><br />
4312 $status - $error
4313 <br />
4315 if (defined $extra) {
4316 print "<hr />\n" .
4317 "$extra\n";
4319 print "</div>\n";
4321 git_footer_html();
4322 goto DONE_GITWEB
4323 unless ($opts{'-error_handler'});
4326 ## ----------------------------------------------------------------------
4327 ## functions printing or outputting HTML: navigation
4329 sub git_print_page_nav {
4330 my ($current, $suppress, $head, $treehead, $treebase, $extra) = @_;
4331 $extra = '' if !defined $extra; # pager or formats
4333 my @navs = qw(summary shortlog log commit commitdiff tree);
4334 if ($suppress) {
4335 @navs = grep { $_ ne $suppress } @navs;
4338 my %arg = map { $_ => {action=>$_} } @navs;
4339 if (defined $head) {
4340 for (qw(commit commitdiff)) {
4341 $arg{$_}{'hash'} = $head;
4343 if ($current =~ m/^(tree | log | shortlog | commit | commitdiff | search)$/x) {
4344 for (qw(shortlog log)) {
4345 $arg{$_}{'hash'} = $head;
4350 $arg{'tree'}{'hash'} = $treehead if defined $treehead;
4351 $arg{'tree'}{'hash_base'} = $treebase if defined $treebase;
4353 my @actions = gitweb_get_feature('actions');
4354 my %repl = (
4355 '%' => '%',
4356 'n' => $project, # project name
4357 'f' => $git_dir, # project path within filesystem
4358 'h' => $treehead || '', # current hash ('h' parameter)
4359 'b' => $treebase || '', # hash base ('hb' parameter)
4361 while (@actions) {
4362 my ($label, $link, $pos) = splice(@actions,0,3);
4363 # insert
4364 @navs = map { $_ eq $pos ? ($_, $label) : $_ } @navs;
4365 # munch munch
4366 $link =~ s/%([%nfhb])/$repl{$1}/g;
4367 $arg{$label}{'_href'} = $link;
4370 print "<div class=\"page_nav\">\n" .
4371 (join " | ",
4372 map { $_ eq $current ?
4373 $_ : $cgi->a({-href => ($arg{$_}{_href} ? $arg{$_}{_href} : href(%{$arg{$_}}))}, "$_")
4374 } @navs);
4375 print "<br/>\n$extra<br/>\n" .
4376 "</div>\n";
4379 # returns a submenu for the nagivation of the refs views (tags, heads,
4380 # remotes) with the current view disabled and the remotes view only
4381 # available if the feature is enabled
4382 sub format_ref_views {
4383 my ($current) = @_;
4384 my @ref_views = qw{tags heads};
4385 push @ref_views, 'remotes' if gitweb_check_feature('remote_heads');
4386 return join " | ", map {
4387 $_ eq $current ? $_ :
4388 $cgi->a({-href => href(action=>$_)}, $_)
4389 } @ref_views
4392 sub format_paging_nav {
4393 my ($action, $page, $has_next_link) = @_;
4394 my $paging_nav;
4397 if ($page > 0) {
4398 $paging_nav .=
4399 $cgi->a({-href => href(-replay=>1, page=>undef)}, "first") .
4400 " &sdot; " .
4401 $cgi->a({-href => href(-replay=>1, page=>$page-1),
4402 -accesskey => "p", -title => "Alt-p"}, "prev");
4403 } else {
4404 $paging_nav .= "first &sdot; prev";
4407 if ($has_next_link) {
4408 $paging_nav .= " &sdot; " .
4409 $cgi->a({-href => href(-replay=>1, page=>$page+1),
4410 -accesskey => "n", -title => "Alt-n"}, "next");
4411 } else {
4412 $paging_nav .= " &sdot; next";
4415 return $paging_nav;
4418 ## ......................................................................
4419 ## functions printing or outputting HTML: div
4421 sub git_print_header_div {
4422 my ($action, $title, $hash, $hash_base) = @_;
4423 my %args = ();
4425 $args{'action'} = $action;
4426 $args{'hash'} = $hash if $hash;
4427 $args{'hash_base'} = $hash_base if $hash_base;
4429 print "<div class=\"header\">\n" .
4430 $cgi->a({-href => href(%args), -class => "title"},
4431 $title ? $title : $action) .
4432 "\n</div>\n";
4435 sub format_repo_url {
4436 my ($name, $url) = @_;
4437 return "<tr class=\"metadata_url\"><td>$name</td><td>$url</td></tr>\n";
4440 # Group output by placing it in a DIV element and adding a header.
4441 # Options for start_div() can be provided by passing a hash reference as the
4442 # first parameter to the function.
4443 # Options to git_print_header_div() can be provided by passing an array
4444 # reference. This must follow the options to start_div if they are present.
4445 # The content can be a scalar, which is output as-is, a scalar reference, which
4446 # is output after html escaping, an IO handle passed either as *handle or
4447 # *handle{IO}, or a function reference. In the latter case all following
4448 # parameters will be taken as argument to the content function call.
4449 sub git_print_section {
4450 my ($div_args, $header_args, $content);
4451 my $arg = shift;
4452 if (ref($arg) eq 'HASH') {
4453 $div_args = $arg;
4454 $arg = shift;
4456 if (ref($arg) eq 'ARRAY') {
4457 $header_args = $arg;
4458 $arg = shift;
4460 $content = $arg;
4462 print $cgi->start_div($div_args);
4463 git_print_header_div(@$header_args);
4465 if (ref($content) eq 'CODE') {
4466 $content->(@_);
4467 } elsif (ref($content) eq 'SCALAR') {
4468 print esc_html($$content);
4469 } elsif (ref($content) eq 'GLOB' or ref($content) eq 'IO::Handle') {
4470 print <$content>;
4471 } elsif (!ref($content) && defined($content)) {
4472 print $content;
4475 print $cgi->end_div;
4478 sub format_timestamp_html {
4479 my $date = shift;
4480 my $strtime = $date->{'rfc2822'};
4482 my (undef, undef, $datetime_class) =
4483 gitweb_get_feature('javascript-timezone');
4484 if ($datetime_class) {
4485 $strtime = qq!<span class="$datetime_class">$strtime</span>!;
4488 my $localtime_format = '(%02d:%02d %s)';
4489 if ($date->{'hour_local'} < 6) {
4490 $localtime_format = '(<span class="atnight">%02d:%02d</span> %s)';
4492 $strtime .= ' ' .
4493 sprintf($localtime_format,
4494 $date->{'hour_local'}, $date->{'minute_local'}, $date->{'tz_local'});
4496 return $strtime;
4499 # Outputs the author name and date in long form
4500 sub git_print_authorship {
4501 my $co = shift;
4502 my %opts = @_;
4503 my $tag = $opts{-tag} || 'div';
4504 my $author = $co->{'author_name'};
4506 my %ad = parse_date($co->{'author_epoch'}, $co->{'author_tz'});
4507 print "<$tag class=\"author_date\">" .
4508 format_search_author($author, "author", esc_html($author)) .
4509 " [".format_timestamp_html(\%ad)."]".
4510 git_get_avatar($co->{'author_email'}, -pad_before => 1) .
4511 "</$tag>\n";
4514 # Outputs table rows containing the full author or committer information,
4515 # in the format expected for 'commit' view (& similar).
4516 # Parameters are a commit hash reference, followed by the list of people
4517 # to output information for. If the list is empty it defaults to both
4518 # author and committer.
4519 sub git_print_authorship_rows {
4520 my $co = shift;
4521 # too bad we can't use @people = @_ || ('author', 'committer')
4522 my @people = @_;
4523 @people = ('author', 'committer') unless @people;
4524 foreach my $who (@people) {
4525 my %wd = parse_date($co->{"${who}_epoch"}, $co->{"${who}_tz"});
4526 print "<tr><td>$who</td><td>" .
4527 format_search_author($co->{"${who}_name"}, $who,
4528 esc_html($co->{"${who}_name"})) . " " .
4529 format_search_author($co->{"${who}_email"}, $who,
4530 esc_html("<" . $co->{"${who}_email"} . ">")) .
4531 "</td><td rowspan=\"2\">" .
4532 git_get_avatar($co->{"${who}_email"}, -size => 'double') .
4533 "</td></tr>\n" .
4534 "<tr>" .
4535 "<td></td><td>" .
4536 format_timestamp_html(\%wd) .
4537 "</td>" .
4538 "</tr>\n";
4542 sub git_print_page_path {
4543 my $name = shift;
4544 my $type = shift;
4545 my $hb = shift;
4548 print "<div class=\"page_path\">";
4549 print $cgi->a({-href => href(action=>"tree", hash_base=>$hb),
4550 -title => 'tree root'}, to_utf8("[$project]"));
4551 print " / ";
4552 if (defined $name) {
4553 my @dirname = split '/', $name;
4554 my $basename = pop @dirname;
4555 my $fullname = '';
4557 foreach my $dir (@dirname) {
4558 $fullname .= ($fullname ? '/' : '') . $dir;
4559 print $cgi->a({-href => href(action=>"tree", file_name=>$fullname,
4560 hash_base=>$hb),
4561 -title => $fullname}, esc_path($dir));
4562 print " / ";
4564 if (defined $type && $type eq 'blob') {
4565 print $cgi->a({-href => href(action=>"blob_plain", file_name=>$file_name,
4566 hash_base=>$hb),
4567 -title => $name}, esc_path($basename));
4568 } elsif (defined $type && $type eq 'tree') {
4569 print $cgi->a({-href => href(action=>"tree", file_name=>$file_name,
4570 hash_base=>$hb),
4571 -title => $name}, esc_path($basename));
4572 print " / ";
4573 } else {
4574 print esc_path($basename);
4577 print "<br/></div>\n";
4580 sub git_print_log {
4581 my $log = shift;
4582 my %opts = @_;
4584 if ($opts{'-remove_title'}) {
4585 # remove title, i.e. first line of log
4586 shift @$log;
4588 # remove leading empty lines
4589 while (defined $log->[0] && $log->[0] eq "") {
4590 shift @$log;
4593 # print log
4594 my $skip_blank_line = 0;
4595 foreach my $line (@$log) {
4596 if ($line =~ m/^\s*([A-Z][-A-Za-z]*-[Bb]y|C[Cc]): /) {
4597 if (! $opts{'-remove_signoff'}) {
4598 print "<span class=\"signoff\">" . esc_html($line) . "</span><br/>\n";
4599 $skip_blank_line = 1;
4601 next;
4604 if ($line =~ m,\s*([a-z]*link): (https?://\S+),i) {
4605 if (! $opts{'-remove_signoff'}) {
4606 print "<span class=\"signoff\">" . esc_html($1) . ": " .
4607 "<a href=\"" . esc_html($2) . "\">" . esc_html($2) . "</a>" .
4608 "</span><br/>\n";
4609 $skip_blank_line = 1;
4611 next;
4614 # print only one empty line
4615 # do not print empty line after signoff
4616 if ($line eq "") {
4617 next if ($skip_blank_line);
4618 $skip_blank_line = 1;
4619 } else {
4620 $skip_blank_line = 0;
4623 print format_log_line_html($line) . "<br/>\n";
4626 if ($opts{'-final_empty_line'}) {
4627 # end with single empty line
4628 print "<br/>\n" unless $skip_blank_line;
4632 # return link target (what link points to)
4633 sub git_get_link_target {
4634 my $hash = shift;
4635 my $link_target;
4637 # read link
4638 open my $fd, "-|", git_cmd(), "cat-file", "blob", $hash
4639 or return;
4641 local $/ = undef;
4642 $link_target = <$fd>;
4644 close $fd
4645 or return;
4647 return $link_target;
4650 # given link target, and the directory (basedir) the link is in,
4651 # return target of link relative to top directory (top tree);
4652 # return undef if it is not possible (including absolute links).
4653 sub normalize_link_target {
4654 my ($link_target, $basedir) = @_;
4656 # absolute symlinks (beginning with '/') cannot be normalized
4657 return if (substr($link_target, 0, 1) eq '/');
4659 # normalize link target to path from top (root) tree (dir)
4660 my $path;
4661 if ($basedir) {
4662 $path = $basedir . '/' . $link_target;
4663 } else {
4664 # we are in top (root) tree (dir)
4665 $path = $link_target;
4668 # remove //, /./, and /../
4669 my @path_parts;
4670 foreach my $part (split('/', $path)) {
4671 # discard '.' and ''
4672 next if (!$part || $part eq '.');
4673 # handle '..'
4674 if ($part eq '..') {
4675 if (@path_parts) {
4676 pop @path_parts;
4677 } else {
4678 # link leads outside repository (outside top dir)
4679 return;
4681 } else {
4682 push @path_parts, $part;
4685 $path = join('/', @path_parts);
4687 return $path;
4690 # print tree entry (row of git_tree), but without encompassing <tr> element
4691 sub git_print_tree_entry {
4692 my ($t, $basedir, $hash_base, $have_blame) = @_;
4694 my %base_key = ();
4695 $base_key{'hash_base'} = $hash_base if defined $hash_base;
4697 # The format of a table row is: mode list link. Where mode is
4698 # the mode of the entry, list is the name of the entry, an href,
4699 # and link is the action links of the entry.
4701 print "<td class=\"mode\">" . mode_str($t->{'mode'}) . "</td>\n";
4702 if (exists $t->{'size'}) {
4703 print "<td class=\"size\">$t->{'size'}</td>\n";
4705 if ($t->{'type'} eq "blob") {
4706 print "<td class=\"list\">" .
4707 $cgi->a({-href => href(action=>"blob", hash=>$t->{'hash'},
4708 file_name=>"$basedir$t->{'name'}", %base_key),
4709 -class => "list"}, esc_path($t->{'name'}));
4710 if (S_ISLNK(oct $t->{'mode'})) {
4711 my $link_target = git_get_link_target($t->{'hash'});
4712 if ($link_target) {
4713 my $norm_target = normalize_link_target($link_target, $basedir);
4714 if (defined $norm_target) {
4715 print " -> " .
4716 $cgi->a({-href => href(action=>"object", hash_base=>$hash_base,
4717 file_name=>$norm_target),
4718 -title => $norm_target}, esc_path($link_target));
4719 } else {
4720 print " -> " . esc_path($link_target);
4724 print "</td>\n";
4725 print "<td class=\"link\">";
4726 print $cgi->a({-href => href(action=>"blob", hash=>$t->{'hash'},
4727 file_name=>"$basedir$t->{'name'}", %base_key)},
4728 "blob");
4729 if ($have_blame) {
4730 print " | " .
4731 $cgi->a({-href => href(action=>"blame", hash=>$t->{'hash'},
4732 file_name=>"$basedir$t->{'name'}", %base_key)},
4733 "blame");
4735 if (defined $hash_base) {
4736 print " | " .
4737 $cgi->a({-href => href(action=>"history", hash_base=>$hash_base,
4738 hash=>$t->{'hash'}, file_name=>"$basedir$t->{'name'}")},
4739 "history");
4741 print " | " .
4742 $cgi->a({-href => href(action=>"blob_plain", hash_base=>$hash_base,
4743 file_name=>"$basedir$t->{'name'}")},
4744 "raw");
4745 print "</td>\n";
4747 } elsif ($t->{'type'} eq "tree") {
4748 print "<td class=\"list\">";
4749 print $cgi->a({-href => href(action=>"tree", hash=>$t->{'hash'},
4750 file_name=>"$basedir$t->{'name'}",
4751 %base_key)},
4752 esc_path($t->{'name'}));
4753 print "</td>\n";
4754 print "<td class=\"link\">";
4755 print $cgi->a({-href => href(action=>"tree", hash=>$t->{'hash'},
4756 file_name=>"$basedir$t->{'name'}",
4757 %base_key)},
4758 "tree");
4759 if (defined $hash_base) {
4760 print " | " .
4761 $cgi->a({-href => href(action=>"history", hash_base=>$hash_base,
4762 file_name=>"$basedir$t->{'name'}")},
4763 "history");
4765 print "</td>\n";
4766 } else {
4767 # unknown object: we can only present history for it
4768 # (this includes 'commit' object, i.e. submodule support)
4769 print "<td class=\"list\">" .
4770 esc_path($t->{'name'}) .
4771 "</td>\n";
4772 print "<td class=\"link\">";
4773 if (defined $hash_base) {
4774 print $cgi->a({-href => href(action=>"history",
4775 hash_base=>$hash_base,
4776 file_name=>"$basedir$t->{'name'}")},
4777 "history");
4779 print "</td>\n";
4783 ## ......................................................................
4784 ## functions printing large fragments of HTML
4786 # get pre-image filenames for merge (combined) diff
4787 sub fill_from_file_info {
4788 my ($diff, @parents) = @_;
4790 $diff->{'from_file'} = [ ];
4791 $diff->{'from_file'}[$diff->{'nparents'} - 1] = undef;
4792 for (my $i = 0; $i < $diff->{'nparents'}; $i++) {
4793 if ($diff->{'status'}[$i] eq 'R' ||
4794 $diff->{'status'}[$i] eq 'C') {
4795 $diff->{'from_file'}[$i] =
4796 git_get_path_by_hash($parents[$i], $diff->{'from_id'}[$i]);
4800 return $diff;
4803 # is current raw difftree line of file deletion
4804 sub is_deleted {
4805 my $diffinfo = shift;
4807 return $diffinfo->{'to_id'} eq ('0' x 40);
4810 # does patch correspond to [previous] difftree raw line
4811 # $diffinfo - hashref of parsed raw diff format
4812 # $patchinfo - hashref of parsed patch diff format
4813 # (the same keys as in $diffinfo)
4814 sub is_patch_split {
4815 my ($diffinfo, $patchinfo) = @_;
4817 return defined $diffinfo && defined $patchinfo
4818 && $diffinfo->{'to_file'} eq $patchinfo->{'to_file'};
4822 sub git_difftree_body {
4823 my ($difftree, $hash, @parents) = @_;
4824 my ($parent) = $parents[0];
4825 my $have_blame = gitweb_check_feature('blame');
4826 print "<div class=\"list_head\">\n";
4827 if ($#{$difftree} > 10) {
4828 print(($#{$difftree} + 1) . " files changed:\n");
4830 print "</div>\n";
4832 print "<table class=\"" .
4833 (@parents > 1 ? "combined " : "") .
4834 "diff_tree\">\n";
4836 # header only for combined diff in 'commitdiff' view
4837 my $has_header = @$difftree && @parents > 1 && $action eq 'commitdiff';
4838 if ($has_header) {
4839 # table header
4840 print "<thead><tr>\n" .
4841 "<th></th><th></th>\n"; # filename, patchN link
4842 for (my $i = 0; $i < @parents; $i++) {
4843 my $par = $parents[$i];
4844 print "<th>" .
4845 $cgi->a({-href => href(action=>"commitdiff",
4846 hash=>$hash, hash_parent=>$par),
4847 -title => 'commitdiff to parent number ' .
4848 ($i+1) . ': ' . substr($par,0,7)},
4849 $i+1) .
4850 "&nbsp;</th>\n";
4852 print "</tr></thead>\n<tbody>\n";
4855 my $alternate = 1;
4856 my $patchno = 0;
4857 foreach my $line (@{$difftree}) {
4858 my $diff = parsed_difftree_line($line);
4860 if ($alternate) {
4861 print "<tr class=\"dark\">\n";
4862 } else {
4863 print "<tr class=\"light\">\n";
4865 $alternate ^= 1;
4867 if (exists $diff->{'nparents'}) { # combined diff
4869 fill_from_file_info($diff, @parents)
4870 unless exists $diff->{'from_file'};
4872 if (!is_deleted($diff)) {
4873 # file exists in the result (child) commit
4874 print "<td>" .
4875 $cgi->a({-href => href(action=>"blob", hash=>$diff->{'to_id'},
4876 file_name=>$diff->{'to_file'},
4877 hash_base=>$hash),
4878 -class => "list"}, esc_path($diff->{'to_file'})) .
4879 "</td>\n";
4880 } else {
4881 print "<td>" .
4882 esc_path($diff->{'to_file'}) .
4883 "</td>\n";
4886 if ($action eq 'commitdiff') {
4887 # link to patch
4888 $patchno++;
4889 print "<td class=\"link\">" .
4890 $cgi->a({-href => href(-anchor=>"patch$patchno")},
4891 "patch") .
4892 " | " .
4893 "</td>\n";
4896 my $has_history = 0;
4897 my $not_deleted = 0;
4898 for (my $i = 0; $i < $diff->{'nparents'}; $i++) {
4899 my $hash_parent = $parents[$i];
4900 my $from_hash = $diff->{'from_id'}[$i];
4901 my $from_path = $diff->{'from_file'}[$i];
4902 my $status = $diff->{'status'}[$i];
4904 $has_history ||= ($status ne 'A');
4905 $not_deleted ||= ($status ne 'D');
4907 if ($status eq 'A') {
4908 print "<td class=\"link\" align=\"right\"> | </td>\n";
4909 } elsif ($status eq 'D') {
4910 print "<td class=\"link\">" .
4911 $cgi->a({-href => href(action=>"blob",
4912 hash_base=>$hash,
4913 hash=>$from_hash,
4914 file_name=>$from_path)},
4915 "blob" . ($i+1)) .
4916 " | </td>\n";
4917 } else {
4918 if ($diff->{'to_id'} eq $from_hash) {
4919 print "<td class=\"link nochange\">";
4920 } else {
4921 print "<td class=\"link\">";
4923 print $cgi->a({-href => href(action=>"blobdiff",
4924 hash=>$diff->{'to_id'},
4925 hash_parent=>$from_hash,
4926 hash_base=>$hash,
4927 hash_parent_base=>$hash_parent,
4928 file_name=>$diff->{'to_file'},
4929 file_parent=>$from_path)},
4930 "diff" . ($i+1)) .
4931 " | </td>\n";
4935 print "<td class=\"link\">";
4936 if ($not_deleted) {
4937 print $cgi->a({-href => href(action=>"blob",
4938 hash=>$diff->{'to_id'},
4939 file_name=>$diff->{'to_file'},
4940 hash_base=>$hash)},
4941 "blob");
4942 print " | " if ($has_history);
4944 if ($has_history) {
4945 print $cgi->a({-href => href(action=>"history",
4946 file_name=>$diff->{'to_file'},
4947 hash_base=>$hash)},
4948 "history");
4950 print "</td>\n";
4952 print "</tr>\n";
4953 next; # instead of 'else' clause, to avoid extra indent
4955 # else ordinary diff
4957 my ($to_mode_oct, $to_mode_str, $to_file_type);
4958 my ($from_mode_oct, $from_mode_str, $from_file_type);
4959 if ($diff->{'to_mode'} ne ('0' x 6)) {
4960 $to_mode_oct = oct $diff->{'to_mode'};
4961 if (S_ISREG($to_mode_oct)) { # only for regular file
4962 $to_mode_str = sprintf("%04o", $to_mode_oct & 0777); # permission bits
4964 $to_file_type = file_type($diff->{'to_mode'});
4966 if ($diff->{'from_mode'} ne ('0' x 6)) {
4967 $from_mode_oct = oct $diff->{'from_mode'};
4968 if (S_ISREG($from_mode_oct)) { # only for regular file
4969 $from_mode_str = sprintf("%04o", $from_mode_oct & 0777); # permission bits
4971 $from_file_type = file_type($diff->{'from_mode'});
4974 if ($diff->{'status'} eq "A") { # created
4975 my $mode_chng = "<span class=\"file_status new\">[new $to_file_type";
4976 $mode_chng .= " with mode: $to_mode_str" if $to_mode_str;
4977 $mode_chng .= "]</span>";
4978 print "<td>";
4979 print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'to_id'},
4980 hash_base=>$hash, file_name=>$diff->{'file'}),
4981 -class => "list"}, esc_path($diff->{'file'}));
4982 print "</td>\n";
4983 print "<td>$mode_chng</td>\n";
4984 print "<td class=\"link\">";
4985 if ($action eq 'commitdiff') {
4986 # link to patch
4987 $patchno++;
4988 print $cgi->a({-href => href(-anchor=>"patch$patchno")},
4989 "patch") .
4990 " | ";
4992 print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'to_id'},
4993 hash_base=>$hash, file_name=>$diff->{'file'})},
4994 "blob");
4995 print "</td>\n";
4997 } elsif ($diff->{'status'} eq "D") { # deleted
4998 my $mode_chng = "<span class=\"file_status deleted\">[deleted $from_file_type]</span>";
4999 print "<td>";
5000 print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'from_id'},
5001 hash_base=>$parent, file_name=>$diff->{'file'}),
5002 -class => "list"}, esc_path($diff->{'file'}));
5003 print "</td>\n";
5004 print "<td>$mode_chng</td>\n";
5005 print "<td class=\"link\">";
5006 if ($action eq 'commitdiff') {
5007 # link to patch
5008 $patchno++;
5009 print $cgi->a({-href => href(-anchor=>"patch$patchno")},
5010 "patch") .
5011 " | ";
5013 print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'from_id'},
5014 hash_base=>$parent, file_name=>$diff->{'file'})},
5015 "blob") . " | ";
5016 if ($have_blame) {
5017 print $cgi->a({-href => href(action=>"blame", hash_base=>$parent,
5018 file_name=>$diff->{'file'})},
5019 "blame") . " | ";
5021 print $cgi->a({-href => href(action=>"history", hash_base=>$parent,
5022 file_name=>$diff->{'file'})},
5023 "history");
5024 print "</td>\n";
5026 } elsif ($diff->{'status'} eq "M" || $diff->{'status'} eq "T") { # modified, or type changed
5027 my $mode_chnge = "";
5028 if ($diff->{'from_mode'} != $diff->{'to_mode'}) {
5029 $mode_chnge = "<span class=\"file_status mode_chnge\">[changed";
5030 if ($from_file_type ne $to_file_type) {
5031 $mode_chnge .= " from $from_file_type to $to_file_type";
5033 if (($from_mode_oct & 0777) != ($to_mode_oct & 0777)) {
5034 if ($from_mode_str && $to_mode_str) {
5035 $mode_chnge .= " mode: $from_mode_str->$to_mode_str";
5036 } elsif ($to_mode_str) {
5037 $mode_chnge .= " mode: $to_mode_str";
5040 $mode_chnge .= "]</span>\n";
5042 print "<td>";
5043 print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'to_id'},
5044 hash_base=>$hash, file_name=>$diff->{'file'}),
5045 -class => "list"}, esc_path($diff->{'file'}));
5046 print "</td>\n";
5047 print "<td>$mode_chnge</td>\n";
5048 print "<td class=\"link\">";
5049 if ($action eq 'commitdiff') {
5050 # link to patch
5051 $patchno++;
5052 print $cgi->a({-href => href(-anchor=>"patch$patchno")},
5053 "patch") .
5054 " | ";
5055 } elsif ($diff->{'to_id'} ne $diff->{'from_id'}) {
5056 # "commit" view and modified file (not onlu mode changed)
5057 print $cgi->a({-href => href(action=>"blobdiff",
5058 hash=>$diff->{'to_id'}, hash_parent=>$diff->{'from_id'},
5059 hash_base=>$hash, hash_parent_base=>$parent,
5060 file_name=>$diff->{'file'})},
5061 "diff") .
5062 " | ";
5064 print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'to_id'},
5065 hash_base=>$hash, file_name=>$diff->{'file'})},
5066 "blob") . " | ";
5067 if ($have_blame) {
5068 print $cgi->a({-href => href(action=>"blame", hash_base=>$hash,
5069 file_name=>$diff->{'file'})},
5070 "blame") . " | ";
5072 print $cgi->a({-href => href(action=>"history", hash_base=>$hash,
5073 file_name=>$diff->{'file'})},
5074 "history");
5075 print "</td>\n";
5077 } elsif ($diff->{'status'} eq "R" || $diff->{'status'} eq "C") { # renamed or copied
5078 my %status_name = ('R' => 'moved', 'C' => 'copied');
5079 my $nstatus = $status_name{$diff->{'status'}};
5080 my $mode_chng = "";
5081 if ($diff->{'from_mode'} != $diff->{'to_mode'}) {
5082 # mode also for directories, so we cannot use $to_mode_str
5083 $mode_chng = sprintf(", mode: %04o", $to_mode_oct & 0777);
5085 print "<td>" .
5086 $cgi->a({-href => href(action=>"blob", hash_base=>$hash,
5087 hash=>$diff->{'to_id'}, file_name=>$diff->{'to_file'}),
5088 -class => "list"}, esc_path($diff->{'to_file'})) . "</td>\n" .
5089 "<td><span class=\"file_status $nstatus\">[$nstatus from " .
5090 $cgi->a({-href => href(action=>"blob", hash_base=>$parent,
5091 hash=>$diff->{'from_id'}, file_name=>$diff->{'from_file'}),
5092 -class => "list"}, esc_path($diff->{'from_file'})) .
5093 " with " . (int $diff->{'similarity'}) . "% similarity$mode_chng]</span></td>\n" .
5094 "<td class=\"link\">";
5095 if ($action eq 'commitdiff') {
5096 # link to patch
5097 $patchno++;
5098 print $cgi->a({-href => href(-anchor=>"patch$patchno")},
5099 "patch") .
5100 " | ";
5101 } elsif ($diff->{'to_id'} ne $diff->{'from_id'}) {
5102 # "commit" view and modified file (not only pure rename or copy)
5103 print $cgi->a({-href => href(action=>"blobdiff",
5104 hash=>$diff->{'to_id'}, hash_parent=>$diff->{'from_id'},
5105 hash_base=>$hash, hash_parent_base=>$parent,
5106 file_name=>$diff->{'to_file'}, file_parent=>$diff->{'from_file'})},
5107 "diff") .
5108 " | ";
5110 print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'to_id'},
5111 hash_base=>$parent, file_name=>$diff->{'to_file'})},
5112 "blob") . " | ";
5113 if ($have_blame) {
5114 print $cgi->a({-href => href(action=>"blame", hash_base=>$hash,
5115 file_name=>$diff->{'to_file'})},
5116 "blame") . " | ";
5118 print $cgi->a({-href => href(action=>"history", hash_base=>$hash,
5119 file_name=>$diff->{'to_file'})},
5120 "history");
5121 print "</td>\n";
5123 } # we should not encounter Unmerged (U) or Unknown (X) status
5124 print "</tr>\n";
5126 print "</tbody>" if $has_header;
5127 print "</table>\n";
5130 # Print context lines and then rem/add lines in a side-by-side manner.
5131 sub print_sidebyside_diff_lines {
5132 my ($ctx, $rem, $add) = @_;
5134 # print context block before add/rem block
5135 if (@$ctx) {
5136 print join '',
5137 '<div class="chunk_block ctx">',
5138 '<div class="old">',
5139 @$ctx,
5140 '</div>',
5141 '<div class="new">',
5142 @$ctx,
5143 '</div>',
5144 '</div>';
5147 if (!@$add) {
5148 # pure removal
5149 print join '',
5150 '<div class="chunk_block rem">',
5151 '<div class="old">',
5152 @$rem,
5153 '</div>',
5154 '</div>';
5155 } elsif (!@$rem) {
5156 # pure addition
5157 print join '',
5158 '<div class="chunk_block add">',
5159 '<div class="new">',
5160 @$add,
5161 '</div>',
5162 '</div>';
5163 } else {
5164 print join '',
5165 '<div class="chunk_block chg">',
5166 '<div class="old">',
5167 @$rem,
5168 '</div>',
5169 '<div class="new">',
5170 @$add,
5171 '</div>',
5172 '</div>';
5176 # Print context lines and then rem/add lines in inline manner.
5177 sub print_inline_diff_lines {
5178 my ($ctx, $rem, $add) = @_;
5180 print @$ctx, @$rem, @$add;
5183 # Format removed and added line, mark changed part and HTML-format them.
5184 # Implementation is based on contrib/diff-highlight
5185 sub format_rem_add_lines_pair {
5186 my ($rem, $add, $num_parents) = @_;
5188 # We need to untabify lines before split()'ing them;
5189 # otherwise offsets would be invalid.
5190 chomp $rem;
5191 chomp $add;
5192 $rem = untabify($rem);
5193 $add = untabify($add);
5195 my @rem = split(//, $rem);
5196 my @add = split(//, $add);
5197 my ($esc_rem, $esc_add);
5198 # Ignore leading +/- characters for each parent.
5199 my ($prefix_len, $suffix_len) = ($num_parents, 0);
5200 my ($prefix_has_nonspace, $suffix_has_nonspace);
5202 my $shorter = (@rem < @add) ? @rem : @add;
5203 while ($prefix_len < $shorter) {
5204 last if ($rem[$prefix_len] ne $add[$prefix_len]);
5206 $prefix_has_nonspace = 1 if ($rem[$prefix_len] !~ /\s/);
5207 $prefix_len++;
5210 while ($prefix_len + $suffix_len < $shorter) {
5211 last if ($rem[-1 - $suffix_len] ne $add[-1 - $suffix_len]);
5213 $suffix_has_nonspace = 1 if ($rem[-1 - $suffix_len] !~ /\s/);
5214 $suffix_len++;
5217 # Mark lines that are different from each other, but have some common
5218 # part that isn't whitespace. If lines are completely different, don't
5219 # mark them because that would make output unreadable, especially if
5220 # diff consists of multiple lines.
5221 if ($prefix_has_nonspace || $suffix_has_nonspace) {
5222 $esc_rem = esc_html_hl_regions($rem, 'marked',
5223 [$prefix_len, @rem - $suffix_len], -nbsp=>1);
5224 $esc_add = esc_html_hl_regions($add, 'marked',
5225 [$prefix_len, @add - $suffix_len], -nbsp=>1);
5226 } else {
5227 $esc_rem = esc_html($rem, -nbsp=>1);
5228 $esc_add = esc_html($add, -nbsp=>1);
5231 return format_diff_line(\$esc_rem, 'rem'),
5232 format_diff_line(\$esc_add, 'add');
5235 # HTML-format diff context, removed and added lines.
5236 sub format_ctx_rem_add_lines {
5237 my ($ctx, $rem, $add, $num_parents) = @_;
5238 my (@new_ctx, @new_rem, @new_add);
5239 my $can_highlight = 0;
5240 my $is_combined = ($num_parents > 1);
5242 # Highlight if every removed line has a corresponding added line.
5243 if (@$add > 0 && @$add == @$rem) {
5244 $can_highlight = 1;
5246 # Highlight lines in combined diff only if the chunk contains
5247 # diff between the same version, e.g.
5249 # - a
5250 # - b
5251 # + c
5252 # + d
5254 # Otherwise the highlightling would be confusing.
5255 if ($is_combined) {
5256 for (my $i = 0; $i < @$add; $i++) {
5257 my $prefix_rem = substr($rem->[$i], 0, $num_parents);
5258 my $prefix_add = substr($add->[$i], 0, $num_parents);
5260 $prefix_rem =~ s/-/+/g;
5262 if ($prefix_rem ne $prefix_add) {
5263 $can_highlight = 0;
5264 last;
5270 if ($can_highlight) {
5271 for (my $i = 0; $i < @$add; $i++) {
5272 my ($line_rem, $line_add) = format_rem_add_lines_pair(
5273 $rem->[$i], $add->[$i], $num_parents);
5274 push @new_rem, $line_rem;
5275 push @new_add, $line_add;
5277 } else {
5278 @new_rem = map { format_diff_line($_, 'rem') } @$rem;
5279 @new_add = map { format_diff_line($_, 'add') } @$add;
5282 @new_ctx = map { format_diff_line($_, 'ctx') } @$ctx;
5284 return (\@new_ctx, \@new_rem, \@new_add);
5287 # Print context lines and then rem/add lines.
5288 sub print_diff_lines {
5289 my ($ctx, $rem, $add, $diff_style, $num_parents) = @_;
5290 my $is_combined = $num_parents > 1;
5292 ($ctx, $rem, $add) = format_ctx_rem_add_lines($ctx, $rem, $add,
5293 $num_parents);
5295 if ($diff_style eq 'sidebyside' && !$is_combined) {
5296 print_sidebyside_diff_lines($ctx, $rem, $add);
5297 } else {
5298 # default 'inline' style and unknown styles
5299 print_inline_diff_lines($ctx, $rem, $add);
5303 sub print_diff_chunk {
5304 my ($diff_style, $num_parents, $from, $to, @chunk) = @_;
5305 my (@ctx, @rem, @add);
5307 # The class of the previous line.
5308 my $prev_class = '';
5310 return unless @chunk;
5312 # incomplete last line might be among removed or added lines,
5313 # or both, or among context lines: find which
5314 for (my $i = 1; $i < @chunk; $i++) {
5315 if ($chunk[$i][0] eq 'incomplete') {
5316 $chunk[$i][0] = $chunk[$i-1][0];
5320 # guardian
5321 push @chunk, ["", ""];
5323 foreach my $line_info (@chunk) {
5324 my ($class, $line) = @$line_info;
5326 # print chunk headers
5327 if ($class && $class eq 'chunk_header') {
5328 print format_diff_line($line, $class, $from, $to);
5329 next;
5332 ## print from accumulator when have some add/rem lines or end
5333 # of chunk (flush context lines), or when have add and rem
5334 # lines and new block is reached (otherwise add/rem lines could
5335 # be reordered)
5336 if (!$class || ((@rem || @add) && $class eq 'ctx') ||
5337 (@rem && @add && $class ne $prev_class)) {
5338 print_diff_lines(\@ctx, \@rem, \@add,
5339 $diff_style, $num_parents);
5340 @ctx = @rem = @add = ();
5343 ## adding lines to accumulator
5344 # guardian value
5345 last unless $line;
5346 # rem, add or change
5347 if ($class eq 'rem') {
5348 push @rem, $line;
5349 } elsif ($class eq 'add') {
5350 push @add, $line;
5352 # context line
5353 if ($class eq 'ctx') {
5354 push @ctx, $line;
5357 $prev_class = $class;
5361 sub git_patchset_body {
5362 my ($fd, $diff_style, $difftree, $hash, @hash_parents) = @_;
5363 my ($hash_parent) = $hash_parents[0];
5365 my $is_combined = (@hash_parents > 1);
5366 my $patch_idx = 0;
5367 my $patch_number = 0;
5368 my $patch_line;
5369 my $diffinfo;
5370 my $to_name;
5371 my (%from, %to);
5372 my @chunk; # for side-by-side diff
5374 print "<div class=\"patchset\">\n";
5376 # skip to first patch
5377 while ($patch_line = <$fd>) {
5378 chomp $patch_line;
5380 last if ($patch_line =~ m/^diff /);
5383 PATCH:
5384 while ($patch_line) {
5386 # parse "git diff" header line
5387 if ($patch_line =~ m/^diff --git (\"(?:[^\\\"]*(?:\\.[^\\\"]*)*)\"|[^ "]*) (.*)$/) {
5388 # $1 is from_name, which we do not use
5389 $to_name = unquote($2);
5390 $to_name =~ s!^b/!!;
5391 } elsif ($patch_line =~ m/^diff --(cc|combined) ("?.*"?)$/) {
5392 # $1 is 'cc' or 'combined', which we do not use
5393 $to_name = unquote($2);
5394 } else {
5395 $to_name = undef;
5398 # check if current patch belong to current raw line
5399 # and parse raw git-diff line if needed
5400 if (is_patch_split($diffinfo, { 'to_file' => $to_name })) {
5401 # this is continuation of a split patch
5402 print "<div class=\"patch cont\">\n";
5403 } else {
5404 # advance raw git-diff output if needed
5405 $patch_idx++ if defined $diffinfo;
5407 # read and prepare patch information
5408 $diffinfo = parsed_difftree_line($difftree->[$patch_idx]);
5410 # compact combined diff output can have some patches skipped
5411 # find which patch (using pathname of result) we are at now;
5412 if ($is_combined) {
5413 while ($to_name ne $diffinfo->{'to_file'}) {
5414 print "<div class=\"patch\" id=\"patch". ($patch_idx+1) ."\">\n" .
5415 format_diff_cc_simplified($diffinfo, @hash_parents) .
5416 "</div>\n"; # class="patch"
5418 $patch_idx++;
5419 $patch_number++;
5421 last if $patch_idx > $#$difftree;
5422 $diffinfo = parsed_difftree_line($difftree->[$patch_idx]);
5426 # modifies %from, %to hashes
5427 parse_from_to_diffinfo($diffinfo, \%from, \%to, @hash_parents);
5429 # this is first patch for raw difftree line with $patch_idx index
5430 # we index @$difftree array from 0, but number patches from 1
5431 print "<div class=\"patch\" id=\"patch". ($patch_idx+1) ."\">\n";
5434 # git diff header
5435 #assert($patch_line =~ m/^diff /) if DEBUG;
5436 #assert($patch_line !~ m!$/$!) if DEBUG; # is chomp-ed
5437 $patch_number++;
5438 # print "git diff" header
5439 print format_git_diff_header_line($patch_line, $diffinfo,
5440 \%from, \%to);
5442 # print extended diff header
5443 print "<div class=\"diff extended_header\">\n";
5444 EXTENDED_HEADER:
5445 while ($patch_line = <$fd>) {
5446 chomp $patch_line;
5448 last EXTENDED_HEADER if ($patch_line =~ m/^--- |^diff /);
5450 print format_extended_diff_header_line($patch_line, $diffinfo,
5451 \%from, \%to);
5453 print "</div>\n"; # class="diff extended_header"
5455 # from-file/to-file diff header
5456 if (! $patch_line) {
5457 print "</div>\n"; # class="patch"
5458 last PATCH;
5460 next PATCH if ($patch_line =~ m/^diff /);
5461 #assert($patch_line =~ m/^---/) if DEBUG;
5463 my $last_patch_line = $patch_line;
5464 $patch_line = <$fd>;
5465 chomp $patch_line;
5466 #assert($patch_line =~ m/^\+\+\+/) if DEBUG;
5468 print format_diff_from_to_header($last_patch_line, $patch_line,
5469 $diffinfo, \%from, \%to,
5470 @hash_parents);
5472 # the patch itself
5473 LINE:
5474 while ($patch_line = <$fd>) {
5475 chomp $patch_line;
5477 next PATCH if ($patch_line =~ m/^diff /);
5479 my $class = diff_line_class($patch_line, \%from, \%to);
5481 if ($class eq 'chunk_header') {
5482 print_diff_chunk($diff_style, scalar @hash_parents, \%from, \%to, @chunk);
5483 @chunk = ();
5486 push @chunk, [ $class, $patch_line ];
5489 } continue {
5490 if (@chunk) {
5491 print_diff_chunk($diff_style, scalar @hash_parents, \%from, \%to, @chunk);
5492 @chunk = ();
5494 print "</div>\n"; # class="patch"
5497 # for compact combined (--cc) format, with chunk and patch simplification
5498 # the patchset might be empty, but there might be unprocessed raw lines
5499 for (++$patch_idx if $patch_number > 0;
5500 $patch_idx < @$difftree;
5501 ++$patch_idx) {
5502 # read and prepare patch information
5503 $diffinfo = parsed_difftree_line($difftree->[$patch_idx]);
5505 # generate anchor for "patch" links in difftree / whatchanged part
5506 print "<div class=\"patch\" id=\"patch". ($patch_idx+1) ."\">\n" .
5507 format_diff_cc_simplified($diffinfo, @hash_parents) .
5508 "</div>\n"; # class="patch"
5510 $patch_number++;
5513 if ($patch_number == 0) {
5514 if (@hash_parents > 1) {
5515 print "<div class=\"diff nodifferences\">Trivial merge</div>\n";
5516 } else {
5517 print "<div class=\"diff nodifferences\">No differences found</div>\n";
5521 print "</div>\n"; # class="patchset"
5524 # . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5526 sub git_project_search_form {
5527 my ($searchtext, $search_use_regexp) = @_;
5529 my $limit = '';
5530 if ($project_filter) {
5531 $limit = " in '$project_filter/'";
5534 print "<div class=\"projsearch\">\n";
5535 print $cgi->start_form(-method => 'get', -action => $my_uri) .
5536 $cgi->hidden(-name => 'a', -value => 'project_list') . "\n";
5537 print $cgi->hidden(-name => 'pf', -value => $project_filter). "\n"
5538 if (defined $project_filter);
5539 print $cgi->textfield(-name => 's', -value => $searchtext,
5540 -title => "Search project by name and description$limit",
5541 -size => 60) . "\n" .
5542 "<span title=\"Extended regular expression\">" .
5543 $cgi->checkbox(-name => 'sr', -value => 1, -label => 're',
5544 -checked => $search_use_regexp) .
5545 "</span>\n" .
5546 $cgi->submit(-name => 'btnS', -value => 'Search') .
5547 $cgi->end_form() . "\n" .
5548 $cgi->a({-href => href(project => undef, searchtext => undef,
5549 project_filter => $project_filter)},
5550 esc_html("List all projects$limit")) . "<br />\n";
5551 print "</div>\n";
5554 # entry for given @keys needs filling if at least one of keys in list
5555 # is not present in %$project_info
5556 sub project_info_needs_filling {
5557 my ($project_info, @keys) = @_;
5559 # return List::MoreUtils::any { !exists $project_info->{$_} } @keys;
5560 foreach my $key (@keys) {
5561 if (!exists $project_info->{$key}) {
5562 return 1;
5565 return;
5568 # fills project list info (age, description, owner, category, forks, etc.)
5569 # for each project in the list, removing invalid projects from
5570 # returned list, or fill only specified info.
5572 # Invalid projects are removed from the returned list if and only if you
5573 # ask 'age' or 'age_string' to be filled, because they are the only fields
5574 # that run unconditionally git command that requires repository, and
5575 # therefore do always check if project repository is invalid.
5577 # USAGE:
5578 # * fill_project_list_info(\@project_list, 'descr_long', 'ctags')
5579 # ensures that 'descr_long' and 'ctags' fields are filled
5580 # * @project_list = fill_project_list_info(\@project_list)
5581 # ensures that all fields are filled (and invalid projects removed)
5583 # NOTE: modifies $projlist, but does not remove entries from it
5584 sub fill_project_list_info {
5585 my ($projlist, @wanted_keys) = @_;
5586 my @projects;
5587 my $filter_set = sub { return @_; };
5588 if (@wanted_keys) {
5589 my %wanted_keys = map { $_ => 1 } @wanted_keys;
5590 $filter_set = sub { return grep { $wanted_keys{$_} } @_; };
5593 my $show_ctags = gitweb_check_feature('ctags');
5594 PROJECT:
5595 foreach my $pr (@$projlist) {
5596 if (project_info_needs_filling($pr, $filter_set->('age', 'age_string'))) {
5597 my (@activity) = git_get_last_activity($pr->{'path'});
5598 unless (@activity) {
5599 next PROJECT;
5601 ($pr->{'age'}, $pr->{'age_string'}) = @activity;
5603 if (project_info_needs_filling($pr, $filter_set->('descr', 'descr_long'))) {
5604 my $descr = git_get_project_description($pr->{'path'}) || "";
5605 $descr = to_utf8($descr);
5606 $pr->{'descr_long'} = $descr;
5607 $pr->{'descr'} = chop_str($descr, $projects_list_description_width, 5);
5609 if (project_info_needs_filling($pr, $filter_set->('owner'))) {
5610 $pr->{'owner'} = git_get_project_owner("$pr->{'path'}") || "";
5612 if ($show_ctags &&
5613 project_info_needs_filling($pr, $filter_set->('ctags'))) {
5614 $pr->{'ctags'} = git_get_project_ctags($pr->{'path'});
5616 if ($projects_list_group_categories &&
5617 project_info_needs_filling($pr, $filter_set->('category'))) {
5618 my $cat = git_get_project_category($pr->{'path'}) ||
5619 $project_list_default_category;
5620 $pr->{'category'} = to_utf8($cat);
5623 push @projects, $pr;
5626 return @projects;
5629 sub sort_projects_list {
5630 my ($projlist, $order) = @_;
5632 sub order_str {
5633 my $key = shift;
5634 return sub { $a->{$key} cmp $b->{$key} };
5637 sub order_num_then_undef {
5638 my $key = shift;
5639 return sub {
5640 defined $a->{$key} ?
5641 (defined $b->{$key} ? $a->{$key} <=> $b->{$key} : -1) :
5642 (defined $b->{$key} ? 1 : 0)
5646 my %orderings = (
5647 project => order_str('path'),
5648 descr => order_str('descr_long'),
5649 owner => order_str('owner'),
5650 age => order_num_then_undef('age'),
5653 my $ordering = $orderings{$order};
5654 return defined $ordering ? sort $ordering @$projlist : @$projlist;
5657 # returns a hash of categories, containing the list of project
5658 # belonging to each category
5659 sub build_projlist_by_category {
5660 my ($projlist, $from, $to) = @_;
5661 my %categories;
5663 $from = 0 unless defined $from;
5664 $to = $#$projlist if (!defined $to || $#$projlist < $to);
5666 for (my $i = $from; $i <= $to; $i++) {
5667 my $pr = $projlist->[$i];
5668 push @{$categories{ $pr->{'category'} }}, $pr;
5671 return wantarray ? %categories : \%categories;
5674 # print 'sort by' <th> element, generating 'sort by $name' replay link
5675 # if that order is not selected
5676 sub print_sort_th {
5677 print format_sort_th(@_);
5680 sub format_sort_th {
5681 my ($name, $order, $header) = @_;
5682 my $sort_th = "";
5683 $header ||= ucfirst($name);
5685 if ($order eq $name) {
5686 $sort_th .= "<th>$header</th>\n";
5687 } else {
5688 $sort_th .= "<th>" .
5689 $cgi->a({-href => href(-replay=>1, order=>$name),
5690 -class => "header"}, $header) .
5691 "</th>\n";
5694 return $sort_th;
5697 sub git_project_list_rows {
5698 my ($projlist, $from, $to, $check_forks) = @_;
5700 $from = 0 unless defined $from;
5701 $to = $#$projlist if (!defined $to || $#$projlist < $to);
5703 my $alternate = 1;
5704 for (my $i = $from; $i <= $to; $i++) {
5705 my $pr = $projlist->[$i];
5707 if ($alternate) {
5708 print "<tr class=\"dark\">\n";
5709 } else {
5710 print "<tr class=\"light\">\n";
5712 $alternate ^= 1;
5714 if ($check_forks) {
5715 print "<td>";
5716 if ($pr->{'forks'}) {
5717 my $nforks = scalar @{$pr->{'forks'}};
5718 if ($nforks > 0) {
5719 print $cgi->a({-href => href(project=>$pr->{'path'}, action=>"forks"),
5720 -title => "$nforks forks"}, "+");
5721 } else {
5722 print $cgi->span({-title => "$nforks forks"}, "+");
5725 print "</td>\n";
5727 print "<td>" . $cgi->a({-href => href(project=>$pr->{'path'}, action=>"summary"),
5728 -class => "list"},
5729 esc_html_match_hl($pr->{'path'}, $search_regexp)) .
5730 "</td>\n" .
5731 "<td>" . $cgi->a({-href => href(project=>$pr->{'path'}, action=>"summary"),
5732 -class => "list",
5733 -title => $pr->{'descr_long'}},
5734 $search_regexp
5735 ? esc_html_match_hl_chopped($pr->{'descr_long'},
5736 $pr->{'descr'}, $search_regexp)
5737 : esc_html($pr->{'descr'})) .
5738 "</td>\n";
5739 unless ($omit_owner) {
5740 print "<td><i>" . chop_and_escape_str($pr->{'owner'}, 15) . "</i></td>\n";
5742 unless ($omit_age_column) {
5743 print "<td class=\"". age_class($pr->{'age'}) . "\">" .
5744 (defined $pr->{'age_string'} ? $pr->{'age_string'} : "No commits") . "</td>\n";
5746 print"<td class=\"link\">" .
5747 $cgi->a({-href => href(project=>$pr->{'path'}, action=>"summary")}, "summary") . " | " .
5748 $cgi->a({-href => href(project=>$pr->{'path'}, action=>"shortlog")}, "shortlog") . " | " .
5749 $cgi->a({-href => href(project=>$pr->{'path'}, action=>"log")}, "log") . " | " .
5750 $cgi->a({-href => href(project=>$pr->{'path'}, action=>"tree")}, "tree") .
5751 ($pr->{'forks'} ? " | " . $cgi->a({-href => href(project=>$pr->{'path'}, action=>"forks")}, "forks") : '') .
5752 "</td>\n" .
5753 "</tr>\n";
5757 sub git_project_list_body {
5758 # actually uses global variable $project
5759 my ($projlist, $order, $from, $to, $extra, $no_header) = @_;
5760 my @projects = @$projlist;
5762 my $check_forks = gitweb_check_feature('forks');
5763 my $show_ctags = gitweb_check_feature('ctags');
5764 my $tagfilter = $show_ctags ? $input_params{'ctag'} : undef;
5765 $check_forks = undef
5766 if ($tagfilter || $search_regexp);
5768 # filtering out forks before filling info allows to do less work
5769 @projects = filter_forks_from_projects_list(\@projects)
5770 if ($check_forks);
5771 # search_projects_list pre-fills required info
5772 @projects = search_projects_list(\@projects,
5773 'search_regexp' => $search_regexp,
5774 'tagfilter' => $tagfilter)
5775 if ($tagfilter || $search_regexp);
5776 # fill the rest
5777 my @all_fields = ('descr', 'descr_long', 'ctags', 'category');
5778 push @all_fields, ('age', 'age_string') unless($omit_age_column);
5779 push @all_fields, 'owner' unless($omit_owner);
5780 @projects = fill_project_list_info(\@projects, @all_fields);
5782 $order ||= $default_projects_order;
5783 $from = 0 unless defined $from;
5784 $to = $#projects if (!defined $to || $#projects < $to);
5786 # short circuit
5787 if ($from > $to) {
5788 print "<center>\n".
5789 "<b>No such projects found</b><br />\n".
5790 "Click ".$cgi->a({-href=>href(project=>undef)},"here")." to view all projects<br />\n".
5791 "</center>\n<br />\n";
5792 return;
5795 @projects = sort_projects_list(\@projects, $order);
5797 if ($show_ctags) {
5798 my $ctags = git_gather_all_ctags(\@projects);
5799 my $cloud = git_populate_project_tagcloud($ctags);
5800 print git_show_project_tagcloud($cloud, 64);
5803 print "<table class=\"project_list\">\n";
5804 unless ($no_header) {
5805 print "<tr>\n";
5806 if ($check_forks) {
5807 print "<th></th>\n";
5809 print_sort_th('project', $order, 'Project');
5810 print_sort_th('descr', $order, 'Description');
5811 print_sort_th('owner', $order, 'Owner') unless $omit_owner;
5812 print_sort_th('age', $order, 'Last Change') unless $omit_age_column;
5813 print "<th></th>\n" . # for links
5814 "</tr>\n";
5817 if ($projects_list_group_categories) {
5818 # only display categories with projects in the $from-$to window
5819 @projects = sort {$a->{'category'} cmp $b->{'category'}} @projects[$from..$to];
5820 my %categories = build_projlist_by_category(\@projects, $from, $to);
5821 foreach my $cat (sort keys %categories) {
5822 unless ($cat eq "") {
5823 print "<tr>\n";
5824 if ($check_forks) {
5825 print "<td></td>\n";
5827 print "<td class=\"category\" colspan=\"5\">".esc_html($cat)."</td>\n";
5828 print "</tr>\n";
5831 git_project_list_rows($categories{$cat}, undef, undef, $check_forks);
5833 } else {
5834 git_project_list_rows(\@projects, $from, $to, $check_forks);
5837 if (defined $extra) {
5838 print "<tr>\n";
5839 if ($check_forks) {
5840 print "<td></td>\n";
5842 print "<td colspan=\"5\">$extra</td>\n" .
5843 "</tr>\n";
5845 print "</table>\n";
5848 sub git_log_body {
5849 # uses global variable $project
5850 my ($commitlist, $from, $to, $refs, $extra) = @_;
5852 $from = 0 unless defined $from;
5853 $to = $#{$commitlist} if (!defined $to || $#{$commitlist} < $to);
5855 for (my $i = 0; $i <= $to; $i++) {
5856 my %co = %{$commitlist->[$i]};
5857 next if !%co;
5858 my $commit = $co{'id'};
5859 my $ref = format_ref_marker($refs, $commit);
5860 git_print_header_div('commit',
5861 "<span class=\"age\">$co{'age_string'}</span>" .
5862 esc_html($co{'title'}) . $ref,
5863 $commit);
5864 print "<div class=\"title_text\">\n" .
5865 "<div class=\"log_link\">\n" .
5866 $cgi->a({-href => href(action=>"commit", hash=>$commit)}, "commit") .
5867 " | " .
5868 $cgi->a({-href => href(action=>"commitdiff", hash=>$commit)}, "commitdiff") .
5869 " | " .
5870 $cgi->a({-href => href(action=>"tree", hash=>$commit, hash_base=>$commit)}, "tree") .
5871 "<br/>\n" .
5872 "</div>\n";
5873 git_print_authorship(\%co, -tag => 'span');
5874 print "<br/>\n</div>\n";
5876 print "<div class=\"log_body\">\n";
5877 git_print_log($co{'comment'}, -final_empty_line=> 1);
5878 print "</div>\n";
5880 if ($extra) {
5881 print "<div class=\"page_nav\">\n";
5882 print "$extra\n";
5883 print "</div>\n";
5887 sub git_shortlog_body {
5888 # uses global variable $project
5889 my ($commitlist, $from, $to, $refs, $extra) = @_;
5891 $from = 0 unless defined $from;
5892 $to = $#{$commitlist} if (!defined $to || $#{$commitlist} < $to);
5894 print "<table class=\"shortlog\">\n";
5895 my $alternate = 1;
5896 for (my $i = $from; $i <= $to; $i++) {
5897 my %co = %{$commitlist->[$i]};
5898 my $commit = $co{'id'};
5899 my $ref = format_ref_marker($refs, $commit);
5900 if ($alternate) {
5901 print "<tr class=\"dark\">\n";
5902 } else {
5903 print "<tr class=\"light\">\n";
5905 $alternate ^= 1;
5906 # git_summary() used print "<td><i>$co{'age_string'}</i></td>\n" .
5907 print "<td title=\"$co{'age_string_age'}\"><i>$co{'age_string_date'}</i></td>\n" .
5908 format_author_html('td', \%co, 10) . "<td>";
5909 print format_subject_html($co{'title'}, $co{'title_short'},
5910 href(action=>"commit", hash=>$commit), $ref);
5911 print "</td>\n" .
5912 "<td class=\"link\">" .
5913 $cgi->a({-href => href(action=>"commit", hash=>$commit)}, "commit") . " | " .
5914 $cgi->a({-href => href(action=>"commitdiff", hash=>$commit)}, "commitdiff") . " | " .
5915 $cgi->a({-href => href(action=>"tree", hash=>$commit, hash_base=>$commit)}, "tree");
5916 my $snapshot_links = format_snapshot_links($commit);
5917 if (defined $snapshot_links) {
5918 print " | " . $snapshot_links;
5920 print "</td>\n" .
5921 "</tr>\n";
5923 if (defined $extra) {
5924 print "<tr>\n" .
5925 "<td colspan=\"4\">$extra</td>\n" .
5926 "</tr>\n";
5928 print "</table>\n";
5931 sub git_history_body {
5932 # Warning: assumes constant type (blob or tree) during history
5933 my ($commitlist, $from, $to, $refs, $extra,
5934 $file_name, $file_hash, $ftype) = @_;
5936 $from = 0 unless defined $from;
5937 $to = $#{$commitlist} unless (defined $to && $to <= $#{$commitlist});
5939 print "<table class=\"history\">\n";
5940 my $alternate = 1;
5941 for (my $i = $from; $i <= $to; $i++) {
5942 my %co = %{$commitlist->[$i]};
5943 if (!%co) {
5944 next;
5946 my $commit = $co{'id'};
5948 my $ref = format_ref_marker($refs, $commit);
5950 if ($alternate) {
5951 print "<tr class=\"dark\">\n";
5952 } else {
5953 print "<tr class=\"light\">\n";
5955 $alternate ^= 1;
5956 print "<td title=\"$co{'age_string_age'}\"><i>$co{'age_string_date'}</i></td>\n" .
5957 # shortlog: format_author_html('td', \%co, 10)
5958 format_author_html('td', \%co, 15, 3) . "<td>";
5959 # originally git_history used chop_str($co{'title'}, 50)
5960 print format_subject_html($co{'title'}, $co{'title_short'},
5961 href(action=>"commit", hash=>$commit), $ref);
5962 print "</td>\n" .
5963 "<td class=\"link\">" .
5964 $cgi->a({-href => href(action=>$ftype, hash_base=>$commit, file_name=>$file_name)}, $ftype) . " | " .
5965 $cgi->a({-href => href(action=>"commitdiff", hash=>$commit)}, "commitdiff");
5967 if ($ftype eq 'blob') {
5968 my $blob_current = $file_hash;
5969 my $blob_parent = git_get_hash_by_path($commit, $file_name);
5970 if (defined $blob_current && defined $blob_parent &&
5971 $blob_current ne $blob_parent) {
5972 print " | " .
5973 $cgi->a({-href => href(action=>"blobdiff",
5974 hash=>$blob_current, hash_parent=>$blob_parent,
5975 hash_base=>$hash_base, hash_parent_base=>$commit,
5976 file_name=>$file_name)},
5977 "diff to current");
5980 print "</td>\n" .
5981 "</tr>\n";
5983 if (defined $extra) {
5984 print "<tr>\n" .
5985 "<td colspan=\"4\">$extra</td>\n" .
5986 "</tr>\n";
5988 print "</table>\n";
5991 sub git_tags_body {
5992 # uses global variable $project
5993 my ($taglist, $from, $to, $extra) = @_;
5994 $from = 0 unless defined $from;
5995 $to = $#{$taglist} if (!defined $to || $#{$taglist} < $to);
5997 print "<table class=\"tags\">\n";
5998 my $alternate = 1;
5999 for (my $i = $from; $i <= $to; $i++) {
6000 my $entry = $taglist->[$i];
6001 my %tag = %$entry;
6002 my $comment = $tag{'subject'};
6003 my $comment_short;
6004 if (defined $comment) {
6005 $comment_short = chop_str($comment, 30, 5);
6007 if ($alternate) {
6008 print "<tr class=\"dark\">\n";
6009 } else {
6010 print "<tr class=\"light\">\n";
6012 $alternate ^= 1;
6013 if (defined $tag{'age'}) {
6014 print "<td><i>$tag{'age'}</i></td>\n";
6015 } else {
6016 print "<td></td>\n";
6018 print "<td>" .
6019 $cgi->a({-href => href(action=>$tag{'reftype'}, hash=>$tag{'refid'}),
6020 -class => "list name"}, esc_html($tag{'name'})) .
6021 "</td>\n" .
6022 "<td>";
6023 if (defined $comment) {
6024 print format_subject_html($comment, $comment_short,
6025 href(action=>"tag", hash=>$tag{'id'}));
6027 print "</td>\n" .
6028 "<td class=\"selflink\">";
6029 if ($tag{'type'} eq "tag") {
6030 print $cgi->a({-href => href(action=>"tag", hash=>$tag{'id'})}, "tag");
6031 } else {
6032 print "&nbsp;";
6034 print "</td>\n" .
6035 "<td class=\"link\">" . " | " .
6036 $cgi->a({-href => href(action=>$tag{'reftype'}, hash=>$tag{'refid'})}, $tag{'reftype'});
6037 if ($tag{'reftype'} eq "commit") {
6038 print " | " . $cgi->a({-href => href(action=>"shortlog", hash=>$tag{'fullname'})}, "shortlog") .
6039 " | " . $cgi->a({-href => href(action=>"log", hash=>$tag{'fullname'})}, "log");
6040 } elsif ($tag{'reftype'} eq "blob") {
6041 print " | " . $cgi->a({-href => href(action=>"blob_plain", hash=>$tag{'refid'})}, "raw");
6043 print "</td>\n" .
6044 "</tr>";
6046 if (defined $extra) {
6047 print "<tr>\n" .
6048 "<td colspan=\"5\">$extra</td>\n" .
6049 "</tr>\n";
6051 print "</table>\n";
6054 sub git_heads_body {
6055 # uses global variable $project
6056 my ($headlist, $head_at, $from, $to, $extra) = @_;
6057 $from = 0 unless defined $from;
6058 $to = $#{$headlist} if (!defined $to || $#{$headlist} < $to);
6060 print "<table class=\"heads\">\n";
6061 my $alternate = 1;
6062 for (my $i = $from; $i <= $to; $i++) {
6063 my $entry = $headlist->[$i];
6064 my %ref = %$entry;
6065 my $curr = defined $head_at && $ref{'id'} eq $head_at;
6066 if ($alternate) {
6067 print "<tr class=\"dark\">\n";
6068 } else {
6069 print "<tr class=\"light\">\n";
6071 $alternate ^= 1;
6072 print "<td><i>$ref{'age'}</i></td>\n" .
6073 ($curr ? "<td class=\"current_head\">" : "<td>") .
6074 $cgi->a({-href => href(action=>"shortlog", hash=>$ref{'fullname'}),
6075 -class => "list name"},esc_html($ref{'name'})) .
6076 "</td>\n" .
6077 "<td class=\"link\">" .
6078 $cgi->a({-href => href(action=>"shortlog", hash=>$ref{'fullname'})}, "shortlog") . " | " .
6079 $cgi->a({-href => href(action=>"log", hash=>$ref{'fullname'})}, "log") . " | " .
6080 $cgi->a({-href => href(action=>"tree", hash=>$ref{'fullname'}, hash_base=>$ref{'fullname'})}, "tree") .
6081 "</td>\n" .
6082 "</tr>";
6084 if (defined $extra) {
6085 print "<tr>\n" .
6086 "<td colspan=\"3\">$extra</td>\n" .
6087 "</tr>\n";
6089 print "</table>\n";
6092 # Display a single remote block
6093 sub git_remote_block {
6094 my ($remote, $rdata, $limit, $head) = @_;
6096 my $heads = $rdata->{'heads'};
6097 my $fetch = $rdata->{'fetch'};
6098 my $push = $rdata->{'push'};
6100 my $urls_table = "<table class=\"projects_list\">\n" ;
6102 if (defined $fetch) {
6103 if ($fetch eq $push) {
6104 $urls_table .= format_repo_url("URL", $fetch);
6105 } else {
6106 $urls_table .= format_repo_url("Fetch URL", $fetch);
6107 $urls_table .= format_repo_url("Push URL", $push) if defined $push;
6109 } elsif (defined $push) {
6110 $urls_table .= format_repo_url("Push URL", $push);
6111 } else {
6112 $urls_table .= format_repo_url("", "No remote URL");
6115 $urls_table .= "</table>\n";
6117 my $dots;
6118 if (defined $limit && $limit < @$heads) {
6119 $dots = $cgi->a({-href => href(action=>"remotes", hash=>$remote)}, "...");
6122 print $urls_table;
6123 git_heads_body($heads, $head, 0, $limit, $dots);
6126 # Display a list of remote names with the respective fetch and push URLs
6127 sub git_remotes_list {
6128 my ($remotedata, $limit) = @_;
6129 print "<table class=\"heads\">\n";
6130 my $alternate = 1;
6131 my @remotes = sort keys %$remotedata;
6133 my $limited = $limit && $limit < @remotes;
6135 $#remotes = $limit - 1 if $limited;
6137 while (my $remote = shift @remotes) {
6138 my $rdata = $remotedata->{$remote};
6139 my $fetch = $rdata->{'fetch'};
6140 my $push = $rdata->{'push'};
6141 if ($alternate) {
6142 print "<tr class=\"dark\">\n";
6143 } else {
6144 print "<tr class=\"light\">\n";
6146 $alternate ^= 1;
6147 print "<td>" .
6148 $cgi->a({-href=> href(action=>'remotes', hash=>$remote),
6149 -class=> "list name"},esc_html($remote)) .
6150 "</td>";
6151 print "<td class=\"link\">" .
6152 (defined $fetch ? $cgi->a({-href=> $fetch}, "fetch") : "fetch") .
6153 " | " .
6154 (defined $push ? $cgi->a({-href=> $push}, "push") : "push") .
6155 "</td>";
6157 print "</tr>\n";
6160 if ($limited) {
6161 print "<tr>\n" .
6162 "<td colspan=\"3\">" .
6163 $cgi->a({-href => href(action=>"remotes")}, "...") .
6164 "</td>\n" . "</tr>\n";
6167 print "</table>";
6170 # Display remote heads grouped by remote, unless there are too many
6171 # remotes, in which case we only display the remote names
6172 sub git_remotes_body {
6173 my ($remotedata, $limit, $head) = @_;
6174 if ($limit and $limit < keys %$remotedata) {
6175 git_remotes_list($remotedata, $limit);
6176 } else {
6177 fill_remote_heads($remotedata);
6178 while (my ($remote, $rdata) = each %$remotedata) {
6179 git_print_section({-class=>"remote", -id=>$remote},
6180 ["remotes", $remote, $remote], sub {
6181 git_remote_block($remote, $rdata, $limit, $head);
6187 sub git_search_message {
6188 my %co = @_;
6190 my $greptype;
6191 if ($searchtype eq 'commit') {
6192 $greptype = "--grep=";
6193 } elsif ($searchtype eq 'author') {
6194 $greptype = "--author=";
6195 } elsif ($searchtype eq 'committer') {
6196 $greptype = "--committer=";
6198 $greptype .= $searchtext;
6199 my @commitlist = parse_commits($hash, 101, (100 * $page), undef,
6200 $greptype, '--regexp-ignore-case',
6201 $search_use_regexp ? '--extended-regexp' : '--fixed-strings');
6203 my $paging_nav = '';
6204 if ($page > 0) {
6205 $paging_nav .=
6206 $cgi->a({-href => href(-replay=>1, page=>undef)},
6207 "first") .
6208 " &sdot; " .
6209 $cgi->a({-href => href(-replay=>1, page=>$page-1),
6210 -accesskey => "p", -title => "Alt-p"}, "prev");
6211 } else {
6212 $paging_nav .= "first &sdot; prev";
6214 my $next_link = '';
6215 if ($#commitlist >= 100) {
6216 $next_link =
6217 $cgi->a({-href => href(-replay=>1, page=>$page+1),
6218 -accesskey => "n", -title => "Alt-n"}, "next");
6219 $paging_nav .= " &sdot; $next_link";
6220 } else {
6221 $paging_nav .= " &sdot; next";
6224 git_header_html();
6226 git_print_page_nav('','', $hash,$co{'tree'},$hash, $paging_nav);
6227 git_print_header_div('commit', esc_html($co{'title'}), $hash);
6228 if ($page == 0 && !@commitlist) {
6229 print "<p>No match.</p>\n";
6230 } else {
6231 git_search_grep_body(\@commitlist, 0, 99, $next_link);
6234 git_footer_html();
6237 sub git_search_changes {
6238 my %co = @_;
6240 local $/ = "\n";
6241 open my $fd, '-|', git_cmd(), '--no-pager', 'log', @diff_opts,
6242 '--pretty=format:%H', '--no-abbrev', '--raw', "-S$searchtext",
6243 ($search_use_regexp ? '--pickaxe-regex' : ())
6244 or die_error(500, "Open git-log failed");
6246 git_header_html();
6248 git_print_page_nav('','', $hash,$co{'tree'},$hash);
6249 git_print_header_div('commit', esc_html($co{'title'}), $hash);
6251 print "<table class=\"pickaxe search\">\n";
6252 my $alternate = 1;
6253 undef %co;
6254 my @files;
6255 while (my $line = <$fd>) {
6256 chomp $line;
6257 next unless $line;
6259 my %set = parse_difftree_raw_line($line);
6260 if (defined $set{'commit'}) {
6261 # finish previous commit
6262 if (%co) {
6263 print "</td>\n" .
6264 "<td class=\"link\">" .
6265 $cgi->a({-href => href(action=>"commit", hash=>$co{'id'})},
6266 "commit") .
6267 " | " .
6268 $cgi->a({-href => href(action=>"tree", hash=>$co{'tree'},
6269 hash_base=>$co{'id'})},
6270 "tree") .
6271 "</td>\n" .
6272 "</tr>\n";
6275 if ($alternate) {
6276 print "<tr class=\"dark\">\n";
6277 } else {
6278 print "<tr class=\"light\">\n";
6280 $alternate ^= 1;
6281 %co = parse_commit($set{'commit'});
6282 my $author = chop_and_escape_str($co{'author_name'}, 15, 5);
6283 print "<td title=\"$co{'age_string_age'}\"><i>$co{'age_string_date'}</i></td>\n" .
6284 "<td><i>$author</i></td>\n" .
6285 "<td>" .
6286 $cgi->a({-href => href(action=>"commit", hash=>$co{'id'}),
6287 -class => "list subject"},
6288 chop_and_escape_str($co{'title'}, 50) . "<br/>");
6289 } elsif (defined $set{'to_id'}) {
6290 next if ($set{'to_id'} =~ m/^0{40}$/);
6292 print $cgi->a({-href => href(action=>"blob", hash_base=>$co{'id'},
6293 hash=>$set{'to_id'}, file_name=>$set{'to_file'}),
6294 -class => "list"},
6295 "<span class=\"match\">" . esc_path($set{'file'}) . "</span>") .
6296 "<br/>\n";
6299 close $fd;
6301 # finish last commit (warning: repetition!)
6302 if (%co) {
6303 print "</td>\n" .
6304 "<td class=\"link\">" .
6305 $cgi->a({-href => href(action=>"commit", hash=>$co{'id'})},
6306 "commit") .
6307 " | " .
6308 $cgi->a({-href => href(action=>"tree", hash=>$co{'tree'},
6309 hash_base=>$co{'id'})},
6310 "tree") .
6311 "</td>\n" .
6312 "</tr>\n";
6315 print "</table>\n";
6317 git_footer_html();
6320 sub git_search_files {
6321 my %co = @_;
6323 local $/ = "\n";
6324 open my $fd, "-|", git_cmd(), 'grep', '-n', '-z',
6325 $search_use_regexp ? ('-E', '-i') : '-F',
6326 $searchtext, $co{'tree'}
6327 or die_error(500, "Open git-grep failed");
6329 git_header_html();
6331 git_print_page_nav('','', $hash,$co{'tree'},$hash);
6332 git_print_header_div('commit', esc_html($co{'title'}), $hash);
6334 print "<table class=\"grep_search\">\n";
6335 my $alternate = 1;
6336 my $matches = 0;
6337 my $lastfile = '';
6338 my $file_href;
6339 while (my $line = <$fd>) {
6340 chomp $line;
6341 my ($file, $lno, $ltext, $binary);
6342 last if ($matches++ > 1000);
6343 if ($line =~ /^Binary file (.+) matches$/) {
6344 $file = $1;
6345 $binary = 1;
6346 } else {
6347 ($file, $lno, $ltext) = split(/\0/, $line, 3);
6348 $file =~ s/^$co{'tree'}://;
6350 if ($file ne $lastfile) {
6351 $lastfile and print "</td></tr>\n";
6352 if ($alternate++) {
6353 print "<tr class=\"dark\">\n";
6354 } else {
6355 print "<tr class=\"light\">\n";
6357 $file_href = href(action=>"blob", hash_base=>$co{'id'},
6358 file_name=>$file);
6359 print "<td class=\"list\">".
6360 $cgi->a({-href => $file_href, -class => "list"}, esc_path($file));
6361 print "</td><td>\n";
6362 $lastfile = $file;
6364 if ($binary) {
6365 print "<div class=\"binary\">Binary file</div>\n";
6366 } else {
6367 $ltext = untabify($ltext);
6368 if ($ltext =~ m/^(.*)($search_regexp)(.*)$/i) {
6369 $ltext = esc_html($1, -nbsp=>1);
6370 $ltext .= '<span class="match">';
6371 $ltext .= esc_html($2, -nbsp=>1);
6372 $ltext .= '</span>';
6373 $ltext .= esc_html($3, -nbsp=>1);
6374 } else {
6375 $ltext = esc_html($ltext, -nbsp=>1);
6377 print "<div class=\"pre\">" .
6378 $cgi->a({-href => $file_href.'#l'.$lno,
6379 -class => "linenr"}, sprintf('%4i', $lno)) .
6380 ' ' . $ltext . "</div>\n";
6383 if ($lastfile) {
6384 print "</td></tr>\n";
6385 if ($matches > 1000) {
6386 print "<div class=\"diff nodifferences\">Too many matches, listing trimmed</div>\n";
6388 } else {
6389 print "<div class=\"diff nodifferences\">No matches found</div>\n";
6391 close $fd;
6393 print "</table>\n";
6395 git_footer_html();
6398 sub git_search_grep_body {
6399 my ($commitlist, $from, $to, $extra) = @_;
6400 $from = 0 unless defined $from;
6401 $to = $#{$commitlist} if (!defined $to || $#{$commitlist} < $to);
6403 print "<table class=\"commit_search\">\n";
6404 my $alternate = 1;
6405 for (my $i = $from; $i <= $to; $i++) {
6406 my %co = %{$commitlist->[$i]};
6407 if (!%co) {
6408 next;
6410 my $commit = $co{'id'};
6411 if ($alternate) {
6412 print "<tr class=\"dark\">\n";
6413 } else {
6414 print "<tr class=\"light\">\n";
6416 $alternate ^= 1;
6417 print "<td title=\"$co{'age_string_age'}\"><i>$co{'age_string_date'}</i></td>\n" .
6418 format_author_html('td', \%co, 15, 5) .
6419 "<td>" .
6420 $cgi->a({-href => href(action=>"commit", hash=>$co{'id'}),
6421 -class => "list subject"},
6422 chop_and_escape_str($co{'title'}, 50) . "<br/>");
6423 my $comment = $co{'comment'};
6424 foreach my $line (@$comment) {
6425 if ($line =~ m/^(.*?)($search_regexp)(.*)$/i) {
6426 my ($lead, $match, $trail) = ($1, $2, $3);
6427 $match = chop_str($match, 70, 5, 'center');
6428 my $contextlen = int((80 - length($match))/2);
6429 $contextlen = 30 if ($contextlen > 30);
6430 $lead = chop_str($lead, $contextlen, 10, 'left');
6431 $trail = chop_str($trail, $contextlen, 10, 'right');
6433 $lead = esc_html($lead);
6434 $match = esc_html($match);
6435 $trail = esc_html($trail);
6437 print "$lead<span class=\"match\">$match</span>$trail<br />";
6440 print "</td>\n" .
6441 "<td class=\"link\">" .
6442 $cgi->a({-href => href(action=>"commit", hash=>$co{'id'})}, "commit") .
6443 " | " .
6444 $cgi->a({-href => href(action=>"commitdiff", hash=>$co{'id'})}, "commitdiff") .
6445 " | " .
6446 $cgi->a({-href => href(action=>"tree", hash=>$co{'tree'}, hash_base=>$co{'id'})}, "tree");
6447 print "</td>\n" .
6448 "</tr>\n";
6450 if (defined $extra) {
6451 print "<tr>\n" .
6452 "<td colspan=\"3\">$extra</td>\n" .
6453 "</tr>\n";
6455 print "</table>\n";
6458 ## ======================================================================
6459 ## ======================================================================
6460 ## actions
6462 sub git_project_list {
6463 my $order = $input_params{'order'};
6464 if (defined $order && $order !~ m/none|project|descr|owner|age/) {
6465 die_error(400, "Unknown order parameter");
6468 my @list = git_get_projects_list($project_filter, $strict_export);
6469 if (!@list) {
6470 die_error(404, "No projects found");
6473 git_header_html();
6474 if (defined $home_text && -f $home_text) {
6475 print "<div class=\"index_include\">\n";
6476 insert_file($home_text);
6477 print "</div>\n";
6480 git_project_search_form($searchtext, $search_use_regexp);
6481 git_project_list_body(\@list, $order);
6482 git_footer_html();
6485 sub git_forks {
6486 my $order = $input_params{'order'};
6487 if (defined $order && $order !~ m/none|project|descr|owner|age/) {
6488 die_error(400, "Unknown order parameter");
6491 my $filter = $project;
6492 $filter =~ s/\.git$//;
6493 my @list = git_get_projects_list($filter);
6494 if (!@list) {
6495 die_error(404, "No forks found");
6498 git_header_html();
6499 git_print_page_nav('','');
6500 git_print_header_div('summary', "$project forks");
6501 git_project_list_body(\@list, $order);
6502 git_footer_html();
6505 sub git_project_index {
6506 my @projects = git_get_projects_list($project_filter, $strict_export);
6507 if (!@projects) {
6508 die_error(404, "No projects found");
6511 print $cgi->header(
6512 -type => 'text/plain',
6513 -charset => 'utf-8',
6514 -content_disposition => 'inline; filename="index.aux"');
6516 foreach my $pr (@projects) {
6517 if (!exists $pr->{'owner'}) {
6518 $pr->{'owner'} = git_get_project_owner("$pr->{'path'}");
6521 my ($path, $owner) = ($pr->{'path'}, $pr->{'owner'});
6522 # quote as in CGI::Util::encode, but keep the slash, and use '+' for ' '
6523 $path =~ s/([^a-zA-Z0-9_.\-\/ ])/sprintf("%%%02X", ord($1))/eg;
6524 $owner =~ s/([^a-zA-Z0-9_.\-\/ ])/sprintf("%%%02X", ord($1))/eg;
6525 $path =~ s/ /\+/g;
6526 $owner =~ s/ /\+/g;
6528 print "$path $owner\n";
6532 sub git_summary {
6533 my $descr = git_get_project_description($project) || "none";
6534 my %co = parse_commit("HEAD");
6535 my %cd = %co ? parse_date($co{'committer_epoch'}, $co{'committer_tz'}) : ();
6536 my $head = $co{'id'};
6537 my $remote_heads = gitweb_check_feature('remote_heads');
6539 my $owner = git_get_project_owner($project);
6541 my $refs = git_get_references();
6542 # These get_*_list functions return one more to allow us to see if
6543 # there are more ...
6544 my @taglist = git_get_tags_list(16);
6545 my @headlist = git_get_heads_list(16);
6546 my %remotedata = $remote_heads ? git_get_remotes_list() : ();
6547 my @forklist;
6548 my $check_forks = gitweb_check_feature('forks');
6550 if ($check_forks) {
6551 # find forks of a project
6552 my $filter = $project;
6553 $filter =~ s/\.git$//;
6554 @forklist = git_get_projects_list($filter);
6555 # filter out forks of forks
6556 @forklist = filter_forks_from_projects_list(\@forklist)
6557 if (@forklist);
6560 git_header_html();
6561 git_print_page_nav('summary','', $head);
6563 print "<div class=\"title\">&nbsp;</div>\n";
6564 print "<table class=\"projects_list\">\n" .
6565 "<tr id=\"metadata_desc\"><td>description</td><td>" . esc_html($descr) . "</td></tr>\n";
6566 if ($owner and not $omit_owner) {
6567 print "<tr id=\"metadata_owner\"><td>owner</td><td>" . esc_html($owner) . "</td></tr>\n";
6569 if (defined $cd{'rfc2822'}) {
6570 print "<tr id=\"metadata_lchange\"><td>last change</td>" .
6571 "<td>".format_timestamp_html(\%cd)."</td></tr>\n";
6574 # use per project git URL list in $projectroot/$project/cloneurl
6575 # or make project git URL from git base URL and project name
6576 my $url_tag = "URL";
6577 my @url_list = git_get_project_url_list($project);
6578 @url_list = map { "$_/$project" } @git_base_url_list unless @url_list;
6579 foreach my $git_url (@url_list) {
6580 next unless $git_url;
6581 print format_repo_url($url_tag, $git_url);
6582 $url_tag = "";
6585 # Tag cloud
6586 my $show_ctags = gitweb_check_feature('ctags');
6587 if ($show_ctags) {
6588 my $ctags = git_get_project_ctags($project);
6589 if (%$ctags) {
6590 # without ability to add tags, don't show if there are none
6591 my $cloud = git_populate_project_tagcloud($ctags);
6592 print "<tr id=\"metadata_ctags\">" .
6593 "<td>content tags</td>" .
6594 "<td>".git_show_project_tagcloud($cloud, 48)."</td>" .
6595 "</tr>\n";
6599 print "</table>\n";
6601 # If XSS prevention is on, we don't include README.html.
6602 # TODO: Allow a readme in some safe format.
6603 if (!$prevent_xss && -s "$projectroot/$project/README.html") {
6604 print "<div class=\"title\">readme</div>\n" .
6605 "<div class=\"readme\">\n";
6606 insert_file("$projectroot/$project/README.html");
6607 print "\n</div>\n"; # class="readme"
6610 # we need to request one more than 16 (0..15) to check if
6611 # those 16 are all
6612 my @commitlist = $head ? parse_commits($head, 17) : ();
6613 if (@commitlist) {
6614 git_print_header_div('shortlog');
6615 git_shortlog_body(\@commitlist, 0, 15, $refs,
6616 $#commitlist <= 15 ? undef :
6617 $cgi->a({-href => href(action=>"shortlog")}, "..."));
6620 if (@taglist) {
6621 git_print_header_div('tags');
6622 git_tags_body(\@taglist, 0, 15,
6623 $#taglist <= 15 ? undef :
6624 $cgi->a({-href => href(action=>"tags")}, "..."));
6627 if (@headlist) {
6628 git_print_header_div('heads');
6629 git_heads_body(\@headlist, $head, 0, 15,
6630 $#headlist <= 15 ? undef :
6631 $cgi->a({-href => href(action=>"heads")}, "..."));
6634 if (%remotedata) {
6635 git_print_header_div('remotes');
6636 git_remotes_body(\%remotedata, 15, $head);
6639 if (@forklist) {
6640 git_print_header_div('forks');
6641 git_project_list_body(\@forklist, 'age', 0, 15,
6642 $#forklist <= 15 ? undef :
6643 $cgi->a({-href => href(action=>"forks")}, "..."),
6644 'no_header');
6647 git_footer_html();
6650 sub git_tag {
6651 my %tag = parse_tag($hash);
6653 if (! %tag) {
6654 die_error(404, "Unknown tag object");
6657 my $head = git_get_head_hash($project);
6658 git_header_html();
6659 git_print_page_nav('','', $head,undef,$head);
6660 git_print_header_div('commit', esc_html($tag{'name'}), $hash);
6661 print "<div class=\"title_text\">\n" .
6662 "<table class=\"object_header\">\n" .
6663 "<tr>\n" .
6664 "<td>object</td>\n" .
6665 "<td>" . $cgi->a({-class => "list", -href => href(action=>$tag{'type'}, hash=>$tag{'object'})},
6666 $tag{'object'}) . "</td>\n" .
6667 "<td class=\"link\">" . $cgi->a({-href => href(action=>$tag{'type'}, hash=>$tag{'object'})},
6668 $tag{'type'}) . "</td>\n" .
6669 "</tr>\n";
6670 if (defined($tag{'author'})) {
6671 git_print_authorship_rows(\%tag, 'author');
6673 print "</table>\n\n" .
6674 "</div>\n";
6675 print "<div class=\"page_body\">";
6676 my $comment = $tag{'comment'};
6677 foreach my $line (@$comment) {
6678 chomp $line;
6679 print esc_html($line, -nbsp=>1) . "<br/>\n";
6681 print "</div>\n";
6682 git_footer_html();
6685 sub git_blame_common {
6686 my $format = shift || 'porcelain';
6687 if ($format eq 'porcelain' && $input_params{'javascript'}) {
6688 $format = 'incremental';
6689 $action = 'blame_incremental'; # for page title etc
6692 # permissions
6693 gitweb_check_feature('blame')
6694 or die_error(403, "Blame view not allowed");
6696 # error checking
6697 die_error(400, "No file name given") unless $file_name;
6698 $hash_base ||= git_get_head_hash($project);
6699 die_error(404, "Couldn't find base commit") unless $hash_base;
6700 my %co = parse_commit($hash_base)
6701 or die_error(404, "Commit not found");
6702 my $ftype = "blob";
6703 if (!defined $hash) {
6704 $hash = git_get_hash_by_path($hash_base, $file_name, "blob")
6705 or die_error(404, "Error looking up file");
6706 } else {
6707 $ftype = git_get_type($hash);
6708 if ($ftype !~ "blob") {
6709 die_error(400, "Object is not a blob");
6713 my $fd;
6714 if ($format eq 'incremental') {
6715 # get file contents (as base)
6716 open $fd, "-|", git_cmd(), 'cat-file', 'blob', $hash
6717 or die_error(500, "Open git-cat-file failed");
6718 } elsif ($format eq 'data') {
6719 # run git-blame --incremental
6720 open $fd, "-|", git_cmd(), "blame", "--incremental",
6721 $hash_base, "--", $file_name
6722 or die_error(500, "Open git-blame --incremental failed");
6723 } else {
6724 # run git-blame --porcelain
6725 open $fd, "-|", git_cmd(), "blame", '-p',
6726 $hash_base, '--', $file_name
6727 or die_error(500, "Open git-blame --porcelain failed");
6729 binmode $fd, ':utf8';
6731 # incremental blame data returns early
6732 if ($format eq 'data') {
6733 print $cgi->header(
6734 -type=>"text/plain", -charset => "utf-8",
6735 -status=> "200 OK");
6736 local $| = 1; # output autoflush
6737 while (my $line = <$fd>) {
6738 print to_utf8($line);
6740 close $fd
6741 or print "ERROR $!\n";
6743 print 'END';
6744 if (defined $t0 && gitweb_check_feature('timed')) {
6745 print ' '.
6746 tv_interval($t0, [ gettimeofday() ]).
6747 ' '.$number_of_git_cmds;
6749 print "\n";
6751 return;
6754 # page header
6755 git_header_html();
6756 my $formats_nav =
6757 $cgi->a({-href => href(action=>"blob", -replay=>1)},
6758 "blob") .
6759 " | ";
6760 if ($format eq 'incremental') {
6761 $formats_nav .=
6762 $cgi->a({-href => href(action=>"blame", javascript=>0, -replay=>1)},
6763 "blame") . " (non-incremental)";
6764 } else {
6765 $formats_nav .=
6766 $cgi->a({-href => href(action=>"blame_incremental", -replay=>1)},
6767 "blame") . " (incremental)";
6769 $formats_nav .=
6770 " | " .
6771 $cgi->a({-href => href(action=>"history", -replay=>1)},
6772 "history") .
6773 " | " .
6774 $cgi->a({-href => href(action=>$action, file_name=>$file_name)},
6775 "HEAD");
6776 git_print_page_nav('','', $hash_base,$co{'tree'},$hash_base, $formats_nav);
6777 git_print_header_div('commit', esc_html($co{'title'}), $hash_base);
6778 git_print_page_path($file_name, $ftype, $hash_base);
6780 # page body
6781 if ($format eq 'incremental') {
6782 print "<noscript>\n<div class=\"error\"><center><b>\n".
6783 "This page requires JavaScript to run.\n Use ".
6784 $cgi->a({-href => href(action=>'blame',javascript=>0,-replay=>1)},
6785 'this page').
6786 " instead.\n".
6787 "</b></center></div>\n</noscript>\n";
6789 print qq!<div id="progress_bar" style="width: 100%; background-color: yellow"></div>\n!;
6792 print qq!<div class="page_body">\n!;
6793 print qq!<div id="progress_info">... / ...</div>\n!
6794 if ($format eq 'incremental');
6795 print qq!<table id="blame_table" class="blame" width="100%">\n!.
6796 #qq!<col width="5.5em" /><col width="2.5em" /><col width="*" />\n!.
6797 qq!<thead>\n!.
6798 qq!<tr><th>Commit</th><th>Line</th><th>Data</th></tr>\n!.
6799 qq!</thead>\n!.
6800 qq!<tbody>\n!;
6802 my @rev_color = qw(light dark);
6803 my $num_colors = scalar(@rev_color);
6804 my $current_color = 0;
6806 if ($format eq 'incremental') {
6807 my $color_class = $rev_color[$current_color];
6809 #contents of a file
6810 my $linenr = 0;
6811 LINE:
6812 while (my $line = <$fd>) {
6813 chomp $line;
6814 $linenr++;
6816 print qq!<tr id="l$linenr" class="$color_class">!.
6817 qq!<td class="sha1"><a href=""> </a></td>!.
6818 qq!<td class="linenr">!.
6819 qq!<a class="linenr" href="">$linenr</a></td>!;
6820 print qq!<td class="pre">! . esc_html($line) . "</td>\n";
6821 print qq!</tr>\n!;
6824 } else { # porcelain, i.e. ordinary blame
6825 my %metainfo = (); # saves information about commits
6827 # blame data
6828 LINE:
6829 while (my $line = <$fd>) {
6830 chomp $line;
6831 # the header: <SHA-1> <src lineno> <dst lineno> [<lines in group>]
6832 # no <lines in group> for subsequent lines in group of lines
6833 my ($full_rev, $orig_lineno, $lineno, $group_size) =
6834 ($line =~ /^([0-9a-f]{40}) (\d+) (\d+)(?: (\d+))?$/);
6835 if (!exists $metainfo{$full_rev}) {
6836 $metainfo{$full_rev} = { 'nprevious' => 0 };
6838 my $meta = $metainfo{$full_rev};
6839 my $data;
6840 while ($data = <$fd>) {
6841 chomp $data;
6842 last if ($data =~ s/^\t//); # contents of line
6843 if ($data =~ /^(\S+)(?: (.*))?$/) {
6844 $meta->{$1} = $2 unless exists $meta->{$1};
6846 if ($data =~ /^previous /) {
6847 $meta->{'nprevious'}++;
6850 my $short_rev = substr($full_rev, 0, 8);
6851 my $author = $meta->{'author'};
6852 my %date =
6853 parse_date($meta->{'author-time'}, $meta->{'author-tz'});
6854 my $date = $date{'iso-tz'};
6855 if ($group_size) {
6856 $current_color = ($current_color + 1) % $num_colors;
6858 my $tr_class = $rev_color[$current_color];
6859 $tr_class .= ' boundary' if (exists $meta->{'boundary'});
6860 $tr_class .= ' no-previous' if ($meta->{'nprevious'} == 0);
6861 $tr_class .= ' multiple-previous' if ($meta->{'nprevious'} > 1);
6862 print "<tr id=\"l$lineno\" class=\"$tr_class\">\n";
6863 if ($group_size) {
6864 print "<td class=\"sha1\"";
6865 print " title=\"". esc_html($author) . ", $date\"";
6866 print " rowspan=\"$group_size\"" if ($group_size > 1);
6867 print ">";
6868 print $cgi->a({-href => href(action=>"commit",
6869 hash=>$full_rev,
6870 file_name=>$file_name)},
6871 esc_html($short_rev));
6872 if ($group_size >= 2) {
6873 my @author_initials = ($author =~ /\b([[:upper:]])\B/g);
6874 if (@author_initials) {
6875 print "<br />" .
6876 esc_html(join('', @author_initials));
6877 # or join('.', ...)
6880 print "</td>\n";
6882 # 'previous' <sha1 of parent commit> <filename at commit>
6883 if (exists $meta->{'previous'} &&
6884 $meta->{'previous'} =~ /^([a-fA-F0-9]{40}) (.*)$/) {
6885 $meta->{'parent'} = $1;
6886 $meta->{'file_parent'} = unquote($2);
6888 my $linenr_commit =
6889 exists($meta->{'parent'}) ?
6890 $meta->{'parent'} : $full_rev;
6891 my $linenr_filename =
6892 exists($meta->{'file_parent'}) ?
6893 $meta->{'file_parent'} : unquote($meta->{'filename'});
6894 my $blamed = href(action => 'blame',
6895 file_name => $linenr_filename,
6896 hash_base => $linenr_commit);
6897 print "<td class=\"linenr\">";
6898 print $cgi->a({ -href => "$blamed#l$orig_lineno",
6899 -class => "linenr" },
6900 esc_html($lineno));
6901 print "</td>";
6902 print "<td class=\"pre\">" . esc_html($data) . "</td>\n";
6903 print "</tr>\n";
6904 } # end while
6908 # footer
6909 print "</tbody>\n".
6910 "</table>\n"; # class="blame"
6911 print "</div>\n"; # class="blame_body"
6912 close $fd
6913 or print "Reading blob failed\n";
6915 git_footer_html();
6918 sub git_blame {
6919 git_blame_common();
6922 sub git_blame_incremental {
6923 git_blame_common('incremental');
6926 sub git_blame_data {
6927 git_blame_common('data');
6930 sub git_tags {
6931 my $head = git_get_head_hash($project);
6932 git_header_html();
6933 git_print_page_nav('','', $head,undef,$head,format_ref_views('tags'));
6934 git_print_header_div('summary', $project);
6936 my @tagslist = git_get_tags_list();
6937 if (@tagslist) {
6938 git_tags_body(\@tagslist);
6940 git_footer_html();
6943 sub git_heads {
6944 my $head = git_get_head_hash($project);
6945 git_header_html();
6946 git_print_page_nav('','', $head,undef,$head,format_ref_views('heads'));
6947 git_print_header_div('summary', $project);
6949 my @headslist = git_get_heads_list();
6950 if (@headslist) {
6951 git_heads_body(\@headslist, $head);
6953 git_footer_html();
6956 # used both for single remote view and for list of all the remotes
6957 sub git_remotes {
6958 gitweb_check_feature('remote_heads')
6959 or die_error(403, "Remote heads view is disabled");
6961 my $head = git_get_head_hash($project);
6962 my $remote = $input_params{'hash'};
6964 my $remotedata = git_get_remotes_list($remote);
6965 die_error(500, "Unable to get remote information") unless defined $remotedata;
6967 unless (%$remotedata) {
6968 die_error(404, defined $remote ?
6969 "Remote $remote not found" :
6970 "No remotes found");
6973 git_header_html(undef, undef, -action_extra => $remote);
6974 git_print_page_nav('', '', $head, undef, $head,
6975 format_ref_views($remote ? '' : 'remotes'));
6977 fill_remote_heads($remotedata);
6978 if (defined $remote) {
6979 git_print_header_div('remotes', "$remote remote for $project");
6980 git_remote_block($remote, $remotedata->{$remote}, undef, $head);
6981 } else {
6982 git_print_header_div('summary', "$project remotes");
6983 git_remotes_body($remotedata, undef, $head);
6986 git_footer_html();
6989 sub git_blob_plain {
6990 my $type = shift;
6991 my $expires;
6993 if (!defined $hash) {
6994 if (defined $file_name) {
6995 my $base = $hash_base || git_get_head_hash($project);
6996 $hash = git_get_hash_by_path($base, $file_name, "blob")
6997 or die_error(404, "Cannot find file");
6998 } else {
6999 die_error(400, "No file name defined");
7001 } elsif ($hash =~ m/^[0-9a-fA-F]{40}$/) {
7002 # blobs defined by non-textual hash id's can be cached
7003 $expires = "+1d";
7006 open my $fd, "-|", git_cmd(), "cat-file", "blob", $hash
7007 or die_error(500, "Open git-cat-file blob '$hash' failed");
7009 # content-type (can include charset)
7010 $type = blob_contenttype($fd, $file_name, $type);
7012 # "save as" filename, even when no $file_name is given
7013 my $save_as = "$hash";
7014 if (defined $file_name) {
7015 $save_as = $file_name;
7016 } elsif ($type =~ m/^text\//) {
7017 $save_as .= '.txt';
7020 # With XSS prevention on, blobs of all types except a few known safe
7021 # ones are served with "Content-Disposition: attachment" to make sure
7022 # they don't run in our security domain. For certain image types,
7023 # blob view writes an <img> tag referring to blob_plain view, and we
7024 # want to be sure not to break that by serving the image as an
7025 # attachment (though Firefox 3 doesn't seem to care).
7026 my $sandbox = $prevent_xss &&
7027 $type !~ m!^(?:text/[a-z]+|image/(?:gif|png|jpeg))(?:[ ;]|$)!;
7029 # serve text/* as text/plain
7030 if ($prevent_xss &&
7031 ($type =~ m!^text/[a-z]+\b(.*)$! ||
7032 ($type =~ m!^[a-z]+/[a-z]\+xml\b(.*)$! && -T $fd))) {
7033 my $rest = $1;
7034 $rest = defined $rest ? $rest : '';
7035 $type = "text/plain$rest";
7038 print $cgi->header(
7039 -type => $type,
7040 -expires => $expires,
7041 -content_disposition =>
7042 ($sandbox ? 'attachment' : 'inline')
7043 . '; filename="' . $save_as . '"');
7044 local $/ = undef;
7045 binmode STDOUT, ':raw';
7046 print <$fd>;
7047 binmode STDOUT, ':utf8'; # as set at the beginning of gitweb.cgi
7048 close $fd;
7051 sub git_blob {
7052 my $expires;
7054 if (!defined $hash) {
7055 if (defined $file_name) {
7056 my $base = $hash_base || git_get_head_hash($project);
7057 $hash = git_get_hash_by_path($base, $file_name, "blob")
7058 or die_error(404, "Cannot find file");
7059 } else {
7060 die_error(400, "No file name defined");
7062 } elsif ($hash =~ m/^[0-9a-fA-F]{40}$/) {
7063 # blobs defined by non-textual hash id's can be cached
7064 $expires = "+1d";
7067 my $have_blame = gitweb_check_feature('blame');
7068 open my $fd, "-|", git_cmd(), "cat-file", "blob", $hash
7069 or die_error(500, "Couldn't cat $file_name, $hash");
7070 my $mimetype = blob_mimetype($fd, $file_name);
7071 # use 'blob_plain' (aka 'raw') view for files that cannot be displayed
7072 if ($mimetype !~ m!^(?:text/|image/(?:gif|png|jpeg)$)! && -B $fd) {
7073 close $fd;
7074 return git_blob_plain($mimetype);
7076 # we can have blame only for text/* mimetype
7077 $have_blame &&= ($mimetype =~ m!^text/!);
7079 my $highlight = gitweb_check_feature('highlight');
7080 my $syntax = guess_file_syntax($highlight, $file_name);
7081 $fd = run_highlighter($fd, $highlight, $syntax);
7083 git_header_html(undef, $expires);
7084 my $formats_nav = '';
7085 if (defined $hash_base && (my %co = parse_commit($hash_base))) {
7086 if (defined $file_name) {
7087 if ($have_blame) {
7088 $formats_nav .=
7089 $cgi->a({-href => href(action=>"blame", -replay=>1)},
7090 "blame") .
7091 " | ";
7093 $formats_nav .=
7094 $cgi->a({-href => href(action=>"history", -replay=>1)},
7095 "history") .
7096 " | " .
7097 $cgi->a({-href => href(action=>"blob_plain", -replay=>1)},
7098 "raw") .
7099 " | " .
7100 $cgi->a({-href => href(action=>"blob",
7101 hash_base=>"HEAD", file_name=>$file_name)},
7102 "HEAD");
7103 } else {
7104 $formats_nav .=
7105 $cgi->a({-href => href(action=>"blob_plain", -replay=>1)},
7106 "raw");
7108 git_print_page_nav('','', $hash_base,$co{'tree'},$hash_base, $formats_nav);
7109 git_print_header_div('commit', esc_html($co{'title'}), $hash_base);
7110 } else {
7111 print "<div class=\"page_nav\">\n" .
7112 "<br/><br/></div>\n" .
7113 "<div class=\"title\">".esc_html($hash)."</div>\n";
7115 git_print_page_path($file_name, "blob", $hash_base);
7116 print "<div class=\"page_body\">\n";
7117 if ($mimetype =~ m!^image/!) {
7118 print qq!<img class="blob" type="!.esc_attr($mimetype).qq!"!;
7119 if ($file_name) {
7120 print qq! alt="!.esc_attr($file_name).qq!" title="!.esc_attr($file_name).qq!"!;
7122 print qq! src="! .
7123 href(action=>"blob_plain", hash=>$hash,
7124 hash_base=>$hash_base, file_name=>$file_name) .
7125 qq!" />\n!;
7126 } else {
7127 my $nr;
7128 while (my $line = <$fd>) {
7129 chomp $line;
7130 $nr++;
7131 $line = untabify($line);
7132 printf qq!<div class="pre"><a id="l%i" href="%s#l%i" class="linenr">%4i</a> %s</div>\n!,
7133 $nr, esc_attr(href(-replay => 1)), $nr, $nr,
7134 $highlight ? sanitize($line) : esc_html($line, -nbsp=>1);
7137 close $fd
7138 or print "Reading blob failed.\n";
7139 print "</div>";
7140 git_footer_html();
7143 sub git_tree {
7144 if (!defined $hash_base) {
7145 $hash_base = "HEAD";
7147 if (!defined $hash) {
7148 if (defined $file_name) {
7149 $hash = git_get_hash_by_path($hash_base, $file_name, "tree");
7150 } else {
7151 $hash = $hash_base;
7154 die_error(404, "No such tree") unless defined($hash);
7156 my $show_sizes = gitweb_check_feature('show-sizes');
7157 my $have_blame = gitweb_check_feature('blame');
7159 my @entries = ();
7161 local $/ = "\0";
7162 open my $fd, "-|", git_cmd(), "ls-tree", '-z',
7163 ($show_sizes ? '-l' : ()), @extra_options, $hash
7164 or die_error(500, "Open git-ls-tree failed");
7165 @entries = map { chomp; $_ } <$fd>;
7166 close $fd
7167 or die_error(404, "Reading tree failed");
7170 my $refs = git_get_references();
7171 my $ref = format_ref_marker($refs, $hash_base);
7172 git_header_html();
7173 my $basedir = '';
7174 if (defined $hash_base && (my %co = parse_commit($hash_base))) {
7175 my @views_nav = ();
7176 if (defined $file_name) {
7177 push @views_nav,
7178 $cgi->a({-href => href(action=>"history", -replay=>1)},
7179 "history"),
7180 $cgi->a({-href => href(action=>"tree",
7181 hash_base=>"HEAD", file_name=>$file_name)},
7182 "HEAD"),
7184 my $snapshot_links = format_snapshot_links($hash);
7185 if (defined $snapshot_links) {
7186 # FIXME: Should be available when we have no hash base as well.
7187 push @views_nav, $snapshot_links;
7189 git_print_page_nav('tree','', $hash_base, undef, undef,
7190 join(' | ', @views_nav));
7191 git_print_header_div('commit', esc_html($co{'title'}) . $ref, $hash_base);
7192 } else {
7193 undef $hash_base;
7194 print "<div class=\"page_nav\">\n";
7195 print "<br/><br/></div>\n";
7196 print "<div class=\"title\">".esc_html($hash)."</div>\n";
7198 if (defined $file_name) {
7199 $basedir = $file_name;
7200 if ($basedir ne '' && substr($basedir, -1) ne '/') {
7201 $basedir .= '/';
7203 git_print_page_path($file_name, 'tree', $hash_base);
7205 print "<div class=\"page_body\">\n";
7206 print "<table class=\"tree\">\n";
7207 my $alternate = 1;
7208 # '..' (top directory) link if possible
7209 if (defined $hash_base &&
7210 defined $file_name && $file_name =~ m![^/]+$!) {
7211 if ($alternate) {
7212 print "<tr class=\"dark\">\n";
7213 } else {
7214 print "<tr class=\"light\">\n";
7216 $alternate ^= 1;
7218 my $up = $file_name;
7219 $up =~ s!/?[^/]+$!!;
7220 undef $up unless $up;
7221 # based on git_print_tree_entry
7222 print '<td class="mode">' . mode_str('040000') . "</td>\n";
7223 print '<td class="size">&nbsp;</td>'."\n" if $show_sizes;
7224 print '<td class="list">';
7225 print $cgi->a({-href => href(action=>"tree",
7226 hash_base=>$hash_base,
7227 file_name=>$up)},
7228 "..");
7229 print "</td>\n";
7230 print "<td class=\"link\"></td>\n";
7232 print "</tr>\n";
7234 foreach my $line (@entries) {
7235 my %t = parse_ls_tree_line($line, -z => 1, -l => $show_sizes);
7237 if ($alternate) {
7238 print "<tr class=\"dark\">\n";
7239 } else {
7240 print "<tr class=\"light\">\n";
7242 $alternate ^= 1;
7244 git_print_tree_entry(\%t, $basedir, $hash_base, $have_blame);
7246 print "</tr>\n";
7248 print "</table>\n" .
7249 "</div>";
7250 git_footer_html();
7253 sub sanitize_for_filename {
7254 my $name = shift;
7256 $name =~ s!/!-!g;
7257 $name =~ s/[^[:alnum:]_.-]//g;
7259 return $name;
7262 sub snapshot_name {
7263 my ($project, $hash) = @_;
7265 # path/to/project.git -> project
7266 # path/to/project/.git -> project
7267 my $name = to_utf8($project);
7268 $name =~ s,([^/])/*\.git$,$1,;
7269 $name = sanitize_for_filename(basename($name));
7271 my $ver = $hash;
7272 if ($hash =~ /^[0-9a-fA-F]+$/) {
7273 # shorten SHA-1 hash
7274 my $full_hash = git_get_full_hash($project, $hash);
7275 if ($full_hash =~ /^$hash/ && length($hash) > 7) {
7276 $ver = git_get_short_hash($project, $hash);
7278 } elsif ($hash =~ m!^refs/tags/(.*)$!) {
7279 # tags don't need shortened SHA-1 hash
7280 $ver = $1;
7281 } else {
7282 # branches and other need shortened SHA-1 hash
7283 my $strip_refs = join '|', map { quotemeta } get_branch_refs();
7284 if ($hash =~ m!^refs/($strip_refs|remotes)/(.*)$!) {
7285 my $ref_dir = (defined $1) ? $1 : '';
7286 $ver = $2;
7288 $ref_dir = sanitize_for_filename($ref_dir);
7289 # for refs neither in heads nor remotes we want to
7290 # add a ref dir to archive name
7291 if ($ref_dir ne '' and $ref_dir ne 'heads' and $ref_dir ne 'remotes') {
7292 $ver = $ref_dir . '-' . $ver;
7295 $ver .= '-' . git_get_short_hash($project, $hash);
7297 # special case of sanitization for filename - we change
7298 # slashes to dots instead of dashes
7299 # in case of hierarchical branch names
7300 $ver =~ s!/!.!g;
7301 $ver =~ s/[^[:alnum:]_.-]//g;
7303 # name = project-version_string
7304 $name = "$name-$ver";
7306 return wantarray ? ($name, $name) : $name;
7309 sub exit_if_unmodified_since {
7310 my ($latest_epoch) = @_;
7311 our $cgi;
7313 my $if_modified = $cgi->http('IF_MODIFIED_SINCE');
7314 if (defined $if_modified) {
7315 my $since;
7316 if (eval { require HTTP::Date; 1; }) {
7317 $since = HTTP::Date::str2time($if_modified);
7318 } elsif (eval { require Time::ParseDate; 1; }) {
7319 $since = Time::ParseDate::parsedate($if_modified, GMT => 1);
7321 if (defined $since && $latest_epoch <= $since) {
7322 my %latest_date = parse_date($latest_epoch);
7323 print $cgi->header(
7324 -last_modified => $latest_date{'rfc2822'},
7325 -status => '304 Not Modified');
7326 goto DONE_GITWEB;
7331 sub git_snapshot {
7332 my $format = $input_params{'snapshot_format'};
7333 if (!@snapshot_fmts) {
7334 die_error(403, "Snapshots not allowed");
7336 # default to first supported snapshot format
7337 $format ||= $snapshot_fmts[0];
7338 if ($format !~ m/^[a-z0-9]+$/) {
7339 die_error(400, "Invalid snapshot format parameter");
7340 } elsif (!exists($known_snapshot_formats{$format})) {
7341 die_error(400, "Unknown snapshot format");
7342 } elsif ($known_snapshot_formats{$format}{'disabled'}) {
7343 die_error(403, "Snapshot format not allowed");
7344 } elsif (!grep($_ eq $format, @snapshot_fmts)) {
7345 die_error(403, "Unsupported snapshot format");
7348 my $type = git_get_type("$hash^{}");
7349 if (!$type) {
7350 die_error(404, 'Object does not exist');
7351 } elsif ($type eq 'blob') {
7352 die_error(400, 'Object is not a tree-ish');
7355 my ($name, $prefix) = snapshot_name($project, $hash);
7356 my $filename = "$name$known_snapshot_formats{$format}{'suffix'}";
7358 my %co = parse_commit($hash);
7359 exit_if_unmodified_since($co{'committer_epoch'}) if %co;
7361 my $cmd = quote_command(
7362 git_cmd(), 'archive',
7363 "--format=$known_snapshot_formats{$format}{'format'}",
7364 "--prefix=$prefix/", $hash);
7365 if (exists $known_snapshot_formats{$format}{'compressor'}) {
7366 $cmd .= ' | ' . quote_command(@{$known_snapshot_formats{$format}{'compressor'}});
7369 $filename =~ s/(["\\])/\\$1/g;
7370 my %latest_date;
7371 if (%co) {
7372 %latest_date = parse_date($co{'committer_epoch'}, $co{'committer_tz'});
7375 print $cgi->header(
7376 -type => $known_snapshot_formats{$format}{'type'},
7377 -content_disposition => 'inline; filename="' . $filename . '"',
7378 %co ? (-last_modified => $latest_date{'rfc2822'}) : (),
7379 -status => '200 OK');
7381 open my $fd, "-|", $cmd
7382 or die_error(500, "Execute git-archive failed");
7383 binmode STDOUT, ':raw';
7384 print <$fd>;
7385 binmode STDOUT, ':utf8'; # as set at the beginning of gitweb.cgi
7386 close $fd;
7389 sub git_log_generic {
7390 my ($fmt_name, $body_subr, $base, $parent, $file_name, $file_hash) = @_;
7392 my $head = git_get_head_hash($project);
7393 if (!defined $base) {
7394 $base = $head;
7396 if (!defined $page) {
7397 $page = 0;
7399 my $refs = git_get_references();
7401 my $commit_hash = $base;
7402 if (defined $parent) {
7403 $commit_hash = "$parent..$base";
7405 my @commitlist =
7406 parse_commits($commit_hash, 101, (100 * $page),
7407 defined $file_name ? ($file_name, "--full-history") : ());
7409 my $ftype;
7410 if (!defined $file_hash && defined $file_name) {
7411 # some commits could have deleted file in question,
7412 # and not have it in tree, but one of them has to have it
7413 for (my $i = 0; $i < @commitlist; $i++) {
7414 $file_hash = git_get_hash_by_path($commitlist[$i]{'id'}, $file_name);
7415 last if defined $file_hash;
7418 if (defined $file_hash) {
7419 $ftype = git_get_type($file_hash);
7421 if (defined $file_name && !defined $ftype) {
7422 die_error(500, "Unknown type of object");
7424 my %co;
7425 if (defined $file_name) {
7426 %co = parse_commit($base)
7427 or die_error(404, "Unknown commit object");
7431 my $paging_nav = format_paging_nav($fmt_name, $page, $#commitlist >= 100);
7432 my $next_link = '';
7433 if ($#commitlist >= 100) {
7434 $next_link =
7435 $cgi->a({-href => href(-replay=>1, page=>$page+1),
7436 -accesskey => "n", -title => "Alt-n"}, "next");
7438 my $patch_max = gitweb_get_feature('patches');
7439 if ($patch_max && !defined $file_name) {
7440 if ($patch_max < 0 || @commitlist <= $patch_max) {
7441 $paging_nav .= " &sdot; " .
7442 $cgi->a({-href => href(action=>"patches", -replay=>1)},
7443 "patches");
7447 git_header_html();
7448 git_print_page_nav($fmt_name,'', $hash,$hash,$hash, $paging_nav);
7449 if (defined $file_name) {
7450 git_print_header_div('commit', esc_html($co{'title'}), $base);
7451 } else {
7452 git_print_header_div('summary', $project)
7454 git_print_page_path($file_name, $ftype, $hash_base)
7455 if (defined $file_name);
7457 $body_subr->(\@commitlist, 0, 99, $refs, $next_link,
7458 $file_name, $file_hash, $ftype);
7460 git_footer_html();
7463 sub git_log {
7464 git_log_generic('log', \&git_log_body,
7465 $hash, $hash_parent);
7468 sub git_commit {
7469 $hash ||= $hash_base || "HEAD";
7470 my %co = parse_commit($hash)
7471 or die_error(404, "Unknown commit object");
7473 my $parent = $co{'parent'};
7474 my $parents = $co{'parents'}; # listref
7476 # we need to prepare $formats_nav before any parameter munging
7477 my $formats_nav;
7478 if (!defined $parent) {
7479 # --root commitdiff
7480 $formats_nav .= '(initial)';
7481 } elsif (@$parents == 1) {
7482 # single parent commit
7483 $formats_nav .=
7484 '(parent: ' .
7485 $cgi->a({-href => href(action=>"commit",
7486 hash=>$parent)},
7487 esc_html(substr($parent, 0, 7))) .
7488 ')';
7489 } else {
7490 # merge commit
7491 $formats_nav .=
7492 '(merge: ' .
7493 join(' ', map {
7494 $cgi->a({-href => href(action=>"commit",
7495 hash=>$_)},
7496 esc_html(substr($_, 0, 7)));
7497 } @$parents ) .
7498 ')';
7500 if (gitweb_check_feature('patches') && @$parents <= 1) {
7501 $formats_nav .= " | " .
7502 $cgi->a({-href => href(action=>"patch", -replay=>1)},
7503 "patch");
7506 if (!defined $parent) {
7507 $parent = "--root";
7509 my @difftree;
7510 open my $fd, "-|", git_cmd(), "diff-tree", '-r', "--no-commit-id",
7511 @diff_opts,
7512 (@$parents <= 1 ? $parent : '-c'),
7513 $hash, "--"
7514 or die_error(500, "Open git-diff-tree failed");
7515 @difftree = map { chomp; $_ } <$fd>;
7516 close $fd or die_error(404, "Reading git-diff-tree failed");
7518 # non-textual hash id's can be cached
7519 my $expires;
7520 if ($hash =~ m/^[0-9a-fA-F]{40}$/) {
7521 $expires = "+1d";
7523 my $refs = git_get_references();
7524 my $ref = format_ref_marker($refs, $co{'id'});
7526 git_header_html(undef, $expires);
7527 git_print_page_nav('commit', '',
7528 $hash, $co{'tree'}, $hash,
7529 $formats_nav);
7531 if (defined $co{'parent'}) {
7532 git_print_header_div('commitdiff', esc_html($co{'title'}) . $ref, $hash);
7533 } else {
7534 git_print_header_div('tree', esc_html($co{'title'}) . $ref, $co{'tree'}, $hash);
7536 print "<div class=\"title_text\">\n" .
7537 "<table class=\"object_header\">\n";
7538 git_print_authorship_rows(\%co);
7539 print "<tr><td>commit</td><td class=\"sha1\">$co{'id'}</td></tr>\n";
7540 print "<tr>" .
7541 "<td>tree</td>" .
7542 "<td class=\"sha1\">" .
7543 $cgi->a({-href => href(action=>"tree", hash=>$co{'tree'}, hash_base=>$hash),
7544 class => "list"}, $co{'tree'}) .
7545 "</td>" .
7546 "<td class=\"link\">" .
7547 $cgi->a({-href => href(action=>"tree", hash=>$co{'tree'}, hash_base=>$hash)},
7548 "tree");
7549 my $snapshot_links = format_snapshot_links($hash);
7550 if (defined $snapshot_links) {
7551 print " | " . $snapshot_links;
7553 print "</td>" .
7554 "</tr>\n";
7556 foreach my $par (@$parents) {
7557 print "<tr>" .
7558 "<td>parent</td>" .
7559 "<td class=\"sha1\">" .
7560 $cgi->a({-href => href(action=>"commit", hash=>$par),
7561 class => "list"}, $par) .
7562 "</td>" .
7563 "<td class=\"link\">" .
7564 $cgi->a({-href => href(action=>"commit", hash=>$par)}, "commit") .
7565 " | " .
7566 $cgi->a({-href => href(action=>"commitdiff", hash=>$hash, hash_parent=>$par)}, "diff") .
7567 "</td>" .
7568 "</tr>\n";
7570 print "</table>".
7571 "</div>\n";
7573 print "<div class=\"page_body\">\n";
7574 git_print_log($co{'comment'});
7575 print "</div>\n";
7577 git_difftree_body(\@difftree, $hash, @$parents);
7579 git_footer_html();
7582 sub git_object {
7583 # object is defined by:
7584 # - hash or hash_base alone
7585 # - hash_base and file_name
7586 my $type;
7588 # - hash or hash_base alone
7589 if ($hash || ($hash_base && !defined $file_name)) {
7590 my $object_id = $hash || $hash_base;
7592 open my $fd, "-|", quote_command(
7593 git_cmd(), 'cat-file', '-t', $object_id) . ' 2> /dev/null'
7594 or die_error(404, "Object does not exist");
7595 $type = <$fd>;
7596 defined $type && chomp $type;
7597 close $fd
7598 or die_error(404, "Object does not exist");
7600 # - hash_base and file_name
7601 } elsif ($hash_base && defined $file_name) {
7602 $file_name =~ s,/+$,,;
7604 system(git_cmd(), "cat-file", '-e', $hash_base) == 0
7605 or die_error(404, "Base object does not exist");
7607 # here errors should not happen
7608 open my $fd, "-|", git_cmd(), "ls-tree", $hash_base, "--", $file_name
7609 or die_error(500, "Open git-ls-tree failed");
7610 my $line = <$fd>;
7611 close $fd;
7613 #'100644 blob 0fa3f3a66fb6a137f6ec2c19351ed4d807070ffa panic.c'
7614 unless ($line && $line =~ m/^([0-9]+) (.+) ([0-9a-fA-F]{40})\t/) {
7615 die_error(404, "File or directory for given base does not exist");
7617 $type = $2;
7618 $hash = $3;
7619 } else {
7620 die_error(400, "Not enough information to find object");
7623 print $cgi->redirect(-uri => href(action=>$type, -full=>1,
7624 hash=>$hash, hash_base=>$hash_base,
7625 file_name=>$file_name),
7626 -status => '302 Found');
7629 sub git_blobdiff {
7630 my $format = shift || 'html';
7631 my $diff_style = $input_params{'diff_style'} || 'inline';
7633 my $fd;
7634 my @difftree;
7635 my %diffinfo;
7636 my $expires;
7638 # preparing $fd and %diffinfo for git_patchset_body
7639 # new style URI
7640 if (defined $hash_base && defined $hash_parent_base) {
7641 if (defined $file_name) {
7642 # read raw output
7643 open $fd, "-|", git_cmd(), "diff-tree", '-r', @diff_opts,
7644 $hash_parent_base, $hash_base,
7645 "--", (defined $file_parent ? $file_parent : ()), $file_name
7646 or die_error(500, "Open git-diff-tree failed");
7647 @difftree = map { chomp; $_ } <$fd>;
7648 close $fd
7649 or die_error(404, "Reading git-diff-tree failed");
7650 @difftree
7651 or die_error(404, "Blob diff not found");
7653 } elsif (defined $hash &&
7654 $hash =~ /[0-9a-fA-F]{40}/) {
7655 # try to find filename from $hash
7657 # read filtered raw output
7658 open $fd, "-|", git_cmd(), "diff-tree", '-r', @diff_opts,
7659 $hash_parent_base, $hash_base, "--"
7660 or die_error(500, "Open git-diff-tree failed");
7661 @difftree =
7662 # ':100644 100644 03b21826... 3b93d5e7... M ls-files.c'
7663 # $hash == to_id
7664 grep { /^:[0-7]{6} [0-7]{6} [0-9a-fA-F]{40} $hash/ }
7665 map { chomp; $_ } <$fd>;
7666 close $fd
7667 or die_error(404, "Reading git-diff-tree failed");
7668 @difftree
7669 or die_error(404, "Blob diff not found");
7671 } else {
7672 die_error(400, "Missing one of the blob diff parameters");
7675 if (@difftree > 1) {
7676 die_error(400, "Ambiguous blob diff specification");
7679 %diffinfo = parse_difftree_raw_line($difftree[0]);
7680 $file_parent ||= $diffinfo{'from_file'} || $file_name;
7681 $file_name ||= $diffinfo{'to_file'};
7683 $hash_parent ||= $diffinfo{'from_id'};
7684 $hash ||= $diffinfo{'to_id'};
7686 # non-textual hash id's can be cached
7687 if ($hash_base =~ m/^[0-9a-fA-F]{40}$/ &&
7688 $hash_parent_base =~ m/^[0-9a-fA-F]{40}$/) {
7689 $expires = '+1d';
7692 # open patch output
7693 open $fd, "-|", git_cmd(), "diff-tree", '-r', @diff_opts,
7694 '-p', ($format eq 'html' ? "--full-index" : ()),
7695 $hash_parent_base, $hash_base,
7696 "--", (defined $file_parent ? $file_parent : ()), $file_name
7697 or die_error(500, "Open git-diff-tree failed");
7700 # old/legacy style URI -- not generated anymore since 1.4.3.
7701 if (!%diffinfo) {
7702 die_error('404 Not Found', "Missing one of the blob diff parameters")
7705 # header
7706 if ($format eq 'html') {
7707 my $formats_nav =
7708 $cgi->a({-href => href(action=>"blobdiff_plain", -replay=>1)},
7709 "raw");
7710 $formats_nav .= diff_style_nav($diff_style);
7711 git_header_html(undef, $expires);
7712 if (defined $hash_base && (my %co = parse_commit($hash_base))) {
7713 git_print_page_nav('','', $hash_base,$co{'tree'},$hash_base, $formats_nav);
7714 git_print_header_div('commit', esc_html($co{'title'}), $hash_base);
7715 } else {
7716 print "<div class=\"page_nav\"><br/>$formats_nav<br/></div>\n";
7717 print "<div class=\"title\">".esc_html("$hash vs $hash_parent")."</div>\n";
7719 if (defined $file_name) {
7720 git_print_page_path($file_name, "blob", $hash_base);
7721 } else {
7722 print "<div class=\"page_path\"></div>\n";
7725 } elsif ($format eq 'plain') {
7726 print $cgi->header(
7727 -type => 'text/plain',
7728 -charset => 'utf-8',
7729 -expires => $expires,
7730 -content_disposition => 'inline; filename="' . "$file_name" . '.patch"');
7732 print "X-Git-Url: " . $cgi->self_url() . "\n\n";
7734 } else {
7735 die_error(400, "Unknown blobdiff format");
7738 # patch
7739 if ($format eq 'html') {
7740 print "<div class=\"page_body\">\n";
7742 git_patchset_body($fd, $diff_style,
7743 [ \%diffinfo ], $hash_base, $hash_parent_base);
7744 close $fd;
7746 print "</div>\n"; # class="page_body"
7747 git_footer_html();
7749 } else {
7750 while (my $line = <$fd>) {
7751 $line =~ s!a/($hash|$hash_parent)!'a/'.esc_path($diffinfo{'from_file'})!eg;
7752 $line =~ s!b/($hash|$hash_parent)!'b/'.esc_path($diffinfo{'to_file'})!eg;
7754 print $line;
7756 last if $line =~ m!^\+\+\+!;
7758 local $/ = undef;
7759 print <$fd>;
7760 close $fd;
7764 sub git_blobdiff_plain {
7765 git_blobdiff('plain');
7768 # assumes that it is added as later part of already existing navigation,
7769 # so it returns "| foo | bar" rather than just "foo | bar"
7770 sub diff_style_nav {
7771 my ($diff_style, $is_combined) = @_;
7772 $diff_style ||= 'inline';
7774 return "" if ($is_combined);
7776 my @styles = (inline => 'inline', 'sidebyside' => 'side by side');
7777 my %styles = @styles;
7778 @styles =
7779 @styles[ map { $_ * 2 } 0..$#styles/2 ];
7781 return join '',
7782 map { " | ".$_ }
7783 map {
7784 $_ eq $diff_style ? $styles{$_} :
7785 $cgi->a({-href => href(-replay=>1, diff_style => $_)}, $styles{$_})
7786 } @styles;
7789 sub git_commitdiff {
7790 my %params = @_;
7791 my $format = $params{-format} || 'html';
7792 my $diff_style = $input_params{'diff_style'} || 'inline';
7794 my ($patch_max) = gitweb_get_feature('patches');
7795 if ($format eq 'patch') {
7796 die_error(403, "Patch view not allowed") unless $patch_max;
7799 $hash ||= $hash_base || "HEAD";
7800 my %co = parse_commit($hash)
7801 or die_error(404, "Unknown commit object");
7803 # choose format for commitdiff for merge
7804 if (! defined $hash_parent && @{$co{'parents'}} > 1) {
7805 $hash_parent = '--cc';
7807 # we need to prepare $formats_nav before almost any parameter munging
7808 my $formats_nav;
7809 if ($format eq 'html') {
7810 $formats_nav =
7811 $cgi->a({-href => href(action=>"commitdiff_plain", -replay=>1)},
7812 "raw");
7813 if ($patch_max && @{$co{'parents'}} <= 1) {
7814 $formats_nav .= " | " .
7815 $cgi->a({-href => href(action=>"patch", -replay=>1)},
7816 "patch");
7818 $formats_nav .= diff_style_nav($diff_style, @{$co{'parents'}} > 1);
7820 if (defined $hash_parent &&
7821 $hash_parent ne '-c' && $hash_parent ne '--cc') {
7822 # commitdiff with two commits given
7823 my $hash_parent_short = $hash_parent;
7824 if ($hash_parent =~ m/^[0-9a-fA-F]{40}$/) {
7825 $hash_parent_short = substr($hash_parent, 0, 7);
7827 $formats_nav .=
7828 ' (from';
7829 for (my $i = 0; $i < @{$co{'parents'}}; $i++) {
7830 if ($co{'parents'}[$i] eq $hash_parent) {
7831 $formats_nav .= ' parent ' . ($i+1);
7832 last;
7835 $formats_nav .= ': ' .
7836 $cgi->a({-href => href(-replay=>1,
7837 hash=>$hash_parent, hash_base=>undef)},
7838 esc_html($hash_parent_short)) .
7839 ')';
7840 } elsif (!$co{'parent'}) {
7841 # --root commitdiff
7842 $formats_nav .= ' (initial)';
7843 } elsif (scalar @{$co{'parents'}} == 1) {
7844 # single parent commit
7845 $formats_nav .=
7846 ' (parent: ' .
7847 $cgi->a({-href => href(-replay=>1,
7848 hash=>$co{'parent'}, hash_base=>undef)},
7849 esc_html(substr($co{'parent'}, 0, 7))) .
7850 ')';
7851 } else {
7852 # merge commit
7853 if ($hash_parent eq '--cc') {
7854 $formats_nav .= ' | ' .
7855 $cgi->a({-href => href(-replay=>1,
7856 hash=>$hash, hash_parent=>'-c')},
7857 'combined');
7858 } else { # $hash_parent eq '-c'
7859 $formats_nav .= ' | ' .
7860 $cgi->a({-href => href(-replay=>1,
7861 hash=>$hash, hash_parent=>'--cc')},
7862 'compact');
7864 $formats_nav .=
7865 ' (merge: ' .
7866 join(' ', map {
7867 $cgi->a({-href => href(-replay=>1,
7868 hash=>$_, hash_base=>undef)},
7869 esc_html(substr($_, 0, 7)));
7870 } @{$co{'parents'}} ) .
7871 ')';
7875 my $hash_parent_param = $hash_parent;
7876 if (!defined $hash_parent_param) {
7877 # --cc for multiple parents, --root for parentless
7878 $hash_parent_param =
7879 @{$co{'parents'}} > 1 ? '--cc' : $co{'parent'} || '--root';
7882 # read commitdiff
7883 my $fd;
7884 my @difftree;
7885 if ($format eq 'html') {
7886 open $fd, "-|", git_cmd(), "diff-tree", '-r', @diff_opts,
7887 "--no-commit-id", "--patch-with-raw", "--full-index",
7888 $hash_parent_param, $hash, "--"
7889 or die_error(500, "Open git-diff-tree failed");
7891 while (my $line = <$fd>) {
7892 chomp $line;
7893 # empty line ends raw part of diff-tree output
7894 last unless $line;
7895 push @difftree, scalar parse_difftree_raw_line($line);
7898 } elsif ($format eq 'plain') {
7899 open $fd, "-|", git_cmd(), "diff-tree", '-r', @diff_opts,
7900 '-p', $hash_parent_param, $hash, "--"
7901 or die_error(500, "Open git-diff-tree failed");
7902 } elsif ($format eq 'patch') {
7903 # For commit ranges, we limit the output to the number of
7904 # patches specified in the 'patches' feature.
7905 # For single commits, we limit the output to a single patch,
7906 # diverging from the git-format-patch default.
7907 my @commit_spec = ();
7908 if ($hash_parent) {
7909 if ($patch_max > 0) {
7910 push @commit_spec, "-$patch_max";
7912 push @commit_spec, '-n', "$hash_parent..$hash";
7913 } else {
7914 if ($params{-single}) {
7915 push @commit_spec, '-1';
7916 } else {
7917 if ($patch_max > 0) {
7918 push @commit_spec, "-$patch_max";
7920 push @commit_spec, "-n";
7922 push @commit_spec, '--root', $hash;
7924 open $fd, "-|", git_cmd(), "format-patch", @diff_opts,
7925 '--encoding=utf8', '--stdout', @commit_spec
7926 or die_error(500, "Open git-format-patch failed");
7927 } else {
7928 die_error(400, "Unknown commitdiff format");
7931 # non-textual hash id's can be cached
7932 my $expires;
7933 if ($hash =~ m/^[0-9a-fA-F]{40}$/) {
7934 $expires = "+1d";
7937 # write commit message
7938 if ($format eq 'html') {
7939 my $refs = git_get_references();
7940 my $ref = format_ref_marker($refs, $co{'id'});
7942 git_header_html(undef, $expires);
7943 git_print_page_nav('commitdiff','', $hash,$co{'tree'},$hash, $formats_nav);
7944 git_print_header_div('commit', esc_html($co{'title'}) . $ref, $hash);
7945 print "<div class=\"title_text\">\n" .
7946 "<table class=\"object_header\">\n";
7947 git_print_authorship_rows(\%co);
7948 print "</table>".
7949 "</div>\n";
7950 print "<div class=\"page_body\">\n";
7951 if (@{$co{'comment'}} > 1) {
7952 print "<div class=\"log\">\n";
7953 git_print_log($co{'comment'}, -final_empty_line=> 1, -remove_title => 1);
7954 print "</div>\n"; # class="log"
7957 } elsif ($format eq 'plain') {
7958 my $refs = git_get_references("tags");
7959 my $tagname = git_get_rev_name_tags($hash);
7960 my $filename = basename($project) . "-$hash.patch";
7962 print $cgi->header(
7963 -type => 'text/plain',
7964 -charset => 'utf-8',
7965 -expires => $expires,
7966 -content_disposition => 'inline; filename="' . "$filename" . '"');
7967 my %ad = parse_date($co{'author_epoch'}, $co{'author_tz'});
7968 print "From: " . to_utf8($co{'author'}) . "\n";
7969 print "Date: $ad{'rfc2822'} ($ad{'tz_local'})\n";
7970 print "Subject: " . to_utf8($co{'title'}) . "\n";
7972 print "X-Git-Tag: $tagname\n" if $tagname;
7973 print "X-Git-Url: " . $cgi->self_url() . "\n\n";
7975 foreach my $line (@{$co{'comment'}}) {
7976 print to_utf8($line) . "\n";
7978 print "---\n\n";
7979 } elsif ($format eq 'patch') {
7980 my $filename = basename($project) . "-$hash.patch";
7982 print $cgi->header(
7983 -type => 'text/plain',
7984 -charset => 'utf-8',
7985 -expires => $expires,
7986 -content_disposition => 'inline; filename="' . "$filename" . '"');
7989 # write patch
7990 if ($format eq 'html') {
7991 my $use_parents = !defined $hash_parent ||
7992 $hash_parent eq '-c' || $hash_parent eq '--cc';
7993 git_difftree_body(\@difftree, $hash,
7994 $use_parents ? @{$co{'parents'}} : $hash_parent);
7995 print "<br/>\n";
7997 git_patchset_body($fd, $diff_style,
7998 \@difftree, $hash,
7999 $use_parents ? @{$co{'parents'}} : $hash_parent);
8000 close $fd;
8001 print "</div>\n"; # class="page_body"
8002 git_footer_html();
8004 } elsif ($format eq 'plain') {
8005 local $/ = undef;
8006 print <$fd>;
8007 close $fd
8008 or print "Reading git-diff-tree failed\n";
8009 } elsif ($format eq 'patch') {
8010 local $/ = undef;
8011 print <$fd>;
8012 close $fd
8013 or print "Reading git-format-patch failed\n";
8017 sub git_commitdiff_plain {
8018 git_commitdiff(-format => 'plain');
8021 # format-patch-style patches
8022 sub git_patch {
8023 git_commitdiff(-format => 'patch', -single => 1);
8026 sub git_patches {
8027 git_commitdiff(-format => 'patch');
8030 sub git_history {
8031 git_log_generic('history', \&git_history_body,
8032 $hash_base, $hash_parent_base,
8033 $file_name, $hash);
8036 sub git_search {
8037 $searchtype ||= 'commit';
8039 # check if appropriate features are enabled
8040 gitweb_check_feature('search')
8041 or die_error(403, "Search is disabled");
8042 if ($searchtype eq 'pickaxe') {
8043 # pickaxe may take all resources of your box and run for several minutes
8044 # with every query - so decide by yourself how public you make this feature
8045 gitweb_check_feature('pickaxe')
8046 or die_error(403, "Pickaxe search is disabled");
8048 if ($searchtype eq 'grep') {
8049 # grep search might be potentially CPU-intensive, too
8050 gitweb_check_feature('grep')
8051 or die_error(403, "Grep search is disabled");
8054 if (!defined $searchtext) {
8055 die_error(400, "Text field is empty");
8057 if (!defined $hash) {
8058 $hash = git_get_head_hash($project);
8060 my %co = parse_commit($hash);
8061 if (!%co) {
8062 die_error(404, "Unknown commit object");
8064 if (!defined $page) {
8065 $page = 0;
8068 if ($searchtype eq 'commit' ||
8069 $searchtype eq 'author' ||
8070 $searchtype eq 'committer') {
8071 git_search_message(%co);
8072 } elsif ($searchtype eq 'pickaxe') {
8073 git_search_changes(%co);
8074 } elsif ($searchtype eq 'grep') {
8075 git_search_files(%co);
8076 } else {
8077 die_error(400, "Unknown search type");
8081 sub git_search_help {
8082 git_header_html();
8083 git_print_page_nav('','', $hash,$hash,$hash);
8084 print <<EOT;
8085 <p><strong>Pattern</strong> is by default a normal string that is matched precisely (but without
8086 regard to case, except in the case of pickaxe). However, when you check the <em>re</em> checkbox,
8087 the pattern entered is recognized as the POSIX extended
8088 <a href="http://en.wikipedia.org/wiki/Regular_expression">regular expression</a> (also case
8089 insensitive).</p>
8090 <dl>
8091 <dt><b>commit</b></dt>
8092 <dd>The commit messages and authorship information will be scanned for the given pattern.</dd>
8094 my $have_grep = gitweb_check_feature('grep');
8095 if ($have_grep) {
8096 print <<EOT;
8097 <dt><b>grep</b></dt>
8098 <dd>All files in the currently selected tree (HEAD unless you are explicitly browsing
8099 a different one) are searched for the given pattern. On large trees, this search can take
8100 a while and put some strain on the server, so please use it with some consideration. Note that
8101 due to git-grep peculiarity, currently if regexp mode is turned off, the matches are
8102 case-sensitive.</dd>
8105 print <<EOT;
8106 <dt><b>author</b></dt>
8107 <dd>Name and e-mail of the change author and date of birth of the patch will be scanned for the given pattern.</dd>
8108 <dt><b>committer</b></dt>
8109 <dd>Name and e-mail of the committer and date of commit will be scanned for the given pattern.</dd>
8111 my $have_pickaxe = gitweb_check_feature('pickaxe');
8112 if ($have_pickaxe) {
8113 print <<EOT;
8114 <dt><b>pickaxe</b></dt>
8115 <dd>All commits that caused the string to appear or disappear from any file (changes that
8116 added, removed or "modified" the string) will be listed. This search can take a while and
8117 takes a lot of strain on the server, so please use it wisely. Note that since you may be
8118 interested even in changes just changing the case as well, this search is case sensitive.</dd>
8121 print "</dl>\n";
8122 git_footer_html();
8125 sub git_shortlog {
8126 git_log_generic('shortlog', \&git_shortlog_body,
8127 $hash, $hash_parent);
8130 ## ......................................................................
8131 ## feeds (RSS, Atom; OPML)
8133 sub git_feed {
8134 my $format = shift || 'atom';
8135 my $have_blame = gitweb_check_feature('blame');
8137 # Atom: http://www.atomenabled.org/developers/syndication/
8138 # RSS: http://www.notestips.com/80256B3A007F2692/1/NAMO5P9UPQ
8139 if ($format ne 'rss' && $format ne 'atom') {
8140 die_error(400, "Unknown web feed format");
8143 # log/feed of current (HEAD) branch, log of given branch, history of file/directory
8144 my $head = $hash || 'HEAD';
8145 my @commitlist = parse_commits($head, 150, 0, $file_name);
8147 my %latest_commit;
8148 my %latest_date;
8149 my $content_type = "application/$format+xml";
8150 if (defined $cgi->http('HTTP_ACCEPT') &&
8151 $cgi->Accept('text/xml') > $cgi->Accept($content_type)) {
8152 # browser (feed reader) prefers text/xml
8153 $content_type = 'text/xml';
8155 if (defined($commitlist[0])) {
8156 %latest_commit = %{$commitlist[0]};
8157 my $latest_epoch = $latest_commit{'committer_epoch'};
8158 exit_if_unmodified_since($latest_epoch);
8159 %latest_date = parse_date($latest_epoch, $latest_commit{'committer_tz'});
8161 print $cgi->header(
8162 -type => $content_type,
8163 -charset => 'utf-8',
8164 %latest_date ? (-last_modified => $latest_date{'rfc2822'}) : (),
8165 -status => '200 OK');
8167 # Optimization: skip generating the body if client asks only
8168 # for Last-Modified date.
8169 return if ($cgi->request_method() eq 'HEAD');
8171 # header variables
8172 my $title = "$site_name - $project/$action";
8173 my $feed_type = 'log';
8174 if (defined $hash) {
8175 $title .= " - '$hash'";
8176 $feed_type = 'branch log';
8177 if (defined $file_name) {
8178 $title .= " :: $file_name";
8179 $feed_type = 'history';
8181 } elsif (defined $file_name) {
8182 $title .= " - $file_name";
8183 $feed_type = 'history';
8185 $title .= " $feed_type";
8186 $title = esc_html($title);
8187 my $descr = git_get_project_description($project);
8188 if (defined $descr) {
8189 $descr = esc_html($descr);
8190 } else {
8191 $descr = "$project " .
8192 ($format eq 'rss' ? 'RSS' : 'Atom') .
8193 " feed";
8195 my $owner = git_get_project_owner($project);
8196 $owner = esc_html($owner);
8198 #header
8199 my $alt_url;
8200 if (defined $file_name) {
8201 $alt_url = href(-full=>1, action=>"history", hash=>$hash, file_name=>$file_name);
8202 } elsif (defined $hash) {
8203 $alt_url = href(-full=>1, action=>"log", hash=>$hash);
8204 } else {
8205 $alt_url = href(-full=>1, action=>"summary");
8207 print qq!<?xml version="1.0" encoding="utf-8"?>\n!;
8208 if ($format eq 'rss') {
8209 print <<XML;
8210 <rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/">
8211 <channel>
8213 print "<title>$title</title>\n" .
8214 "<link>$alt_url</link>\n" .
8215 "<description>$descr</description>\n" .
8216 "<language>en</language>\n" .
8217 # project owner is responsible for 'editorial' content
8218 "<managingEditor>$owner</managingEditor>\n";
8219 if (defined $logo || defined $favicon) {
8220 # prefer the logo to the favicon, since RSS
8221 # doesn't allow both
8222 my $img = esc_url($logo || $favicon);
8223 print "<image>\n" .
8224 "<url>$img</url>\n" .
8225 "<title>$title</title>\n" .
8226 "<link>$alt_url</link>\n" .
8227 "</image>\n";
8229 if (%latest_date) {
8230 print "<pubDate>$latest_date{'rfc2822'}</pubDate>\n";
8231 print "<lastBuildDate>$latest_date{'rfc2822'}</lastBuildDate>\n";
8233 print "<generator>gitweb v.$version/$git_version</generator>\n";
8234 } elsif ($format eq 'atom') {
8235 print <<XML;
8236 <feed xmlns="http://www.w3.org/2005/Atom">
8238 print "<title>$title</title>\n" .
8239 "<subtitle>$descr</subtitle>\n" .
8240 '<link rel="alternate" type="text/html" href="' .
8241 $alt_url . '" />' . "\n" .
8242 '<link rel="self" type="' . $content_type . '" href="' .
8243 $cgi->self_url() . '" />' . "\n" .
8244 "<id>" . href(-full=>1) . "</id>\n" .
8245 # use project owner for feed author
8246 "<author><name>$owner</name></author>\n";
8247 if (defined $favicon) {
8248 print "<icon>" . esc_url($favicon) . "</icon>\n";
8250 if (defined $logo) {
8251 # not twice as wide as tall: 72 x 27 pixels
8252 print "<logo>" . esc_url($logo) . "</logo>\n";
8254 if (! %latest_date) {
8255 # dummy date to keep the feed valid until commits trickle in:
8256 print "<updated>1970-01-01T00:00:00Z</updated>\n";
8257 } else {
8258 print "<updated>$latest_date{'iso-8601'}</updated>\n";
8260 print "<generator version='$version/$git_version'>gitweb</generator>\n";
8263 # contents
8264 for (my $i = 0; $i <= $#commitlist; $i++) {
8265 my %co = %{$commitlist[$i]};
8266 my $commit = $co{'id'};
8267 # we read 150, we always show 30 and the ones more recent than 48 hours
8268 if (($i >= 20) && ((time - $co{'author_epoch'}) > 48*60*60)) {
8269 last;
8271 my %cd = parse_date($co{'author_epoch'}, $co{'author_tz'});
8273 # get list of changed files
8274 open my $fd, "-|", git_cmd(), "diff-tree", '-r', @diff_opts,
8275 $co{'parent'} || "--root",
8276 $co{'id'}, "--", (defined $file_name ? $file_name : ())
8277 or next;
8278 my @difftree = map { chomp; $_ } <$fd>;
8279 close $fd
8280 or next;
8282 # print element (entry, item)
8283 my $co_url = href(-full=>1, action=>"commitdiff", hash=>$commit);
8284 if ($format eq 'rss') {
8285 print "<item>\n" .
8286 "<title>" . esc_html($co{'title'}) . "</title>\n" .
8287 "<author>" . esc_html($co{'author'}) . "</author>\n" .
8288 "<pubDate>$cd{'rfc2822'}</pubDate>\n" .
8289 "<guid isPermaLink=\"true\">$co_url</guid>\n" .
8290 "<link>$co_url</link>\n" .
8291 "<description>" . esc_html($co{'title'}) . "</description>\n" .
8292 "<content:encoded>" .
8293 "<![CDATA[\n";
8294 } elsif ($format eq 'atom') {
8295 print "<entry>\n" .
8296 "<title type=\"html\">" . esc_html($co{'title'}) . "</title>\n" .
8297 "<updated>$cd{'iso-8601'}</updated>\n" .
8298 "<author>\n" .
8299 " <name>" . esc_html($co{'author_name'}) . "</name>\n";
8300 if ($co{'author_email'}) {
8301 print " <email>" . esc_html($co{'author_email'}) . "</email>\n";
8303 print "</author>\n" .
8304 # use committer for contributor
8305 "<contributor>\n" .
8306 " <name>" . esc_html($co{'committer_name'}) . "</name>\n";
8307 if ($co{'committer_email'}) {
8308 print " <email>" . esc_html($co{'committer_email'}) . "</email>\n";
8310 print "</contributor>\n" .
8311 "<published>$cd{'iso-8601'}</published>\n" .
8312 "<link rel=\"alternate\" type=\"text/html\" href=\"$co_url\" />\n" .
8313 "<id>$co_url</id>\n" .
8314 "<content type=\"xhtml\" xml:base=\"" . esc_url($my_url) . "\">\n" .
8315 "<div xmlns=\"http://www.w3.org/1999/xhtml\">\n";
8317 my $comment = $co{'comment'};
8318 print "<pre>\n";
8319 foreach my $line (@$comment) {
8320 $line = esc_html($line);
8321 print "$line\n";
8323 print "</pre><ul>\n";
8324 foreach my $difftree_line (@difftree) {
8325 my %difftree = parse_difftree_raw_line($difftree_line);
8326 next if !$difftree{'from_id'};
8328 my $file = $difftree{'file'} || $difftree{'to_file'};
8330 print "<li>" .
8331 "[" .
8332 $cgi->a({-href => href(-full=>1, action=>"blobdiff",
8333 hash=>$difftree{'to_id'}, hash_parent=>$difftree{'from_id'},
8334 hash_base=>$co{'id'}, hash_parent_base=>$co{'parent'},
8335 file_name=>$file, file_parent=>$difftree{'from_file'}),
8336 -title => "diff"}, 'D');
8337 if ($have_blame) {
8338 print $cgi->a({-href => href(-full=>1, action=>"blame",
8339 file_name=>$file, hash_base=>$commit),
8340 -title => "blame"}, 'B');
8342 # if this is not a feed of a file history
8343 if (!defined $file_name || $file_name ne $file) {
8344 print $cgi->a({-href => href(-full=>1, action=>"history",
8345 file_name=>$file, hash=>$commit),
8346 -title => "history"}, 'H');
8348 $file = esc_path($file);
8349 print "] ".
8350 "$file</li>\n";
8352 if ($format eq 'rss') {
8353 print "</ul>]]>\n" .
8354 "</content:encoded>\n" .
8355 "</item>\n";
8356 } elsif ($format eq 'atom') {
8357 print "</ul>\n</div>\n" .
8358 "</content>\n" .
8359 "</entry>\n";
8363 # end of feed
8364 if ($format eq 'rss') {
8365 print "</channel>\n</rss>\n";
8366 } elsif ($format eq 'atom') {
8367 print "</feed>\n";
8371 sub git_rss {
8372 git_feed('rss');
8375 sub git_atom {
8376 git_feed('atom');
8379 sub git_opml {
8380 my @list = git_get_projects_list($project_filter, $strict_export);
8381 if (!@list) {
8382 die_error(404, "No projects found");
8385 print $cgi->header(
8386 -type => 'text/xml',
8387 -charset => 'utf-8',
8388 -content_disposition => 'inline; filename="opml.xml"');
8390 my $title = esc_html($site_name);
8391 my $filter = " within subdirectory ";
8392 if (defined $project_filter) {
8393 $filter .= esc_html($project_filter);
8394 } else {
8395 $filter = "";
8397 print <<XML;
8398 <?xml version="1.0" encoding="utf-8"?>
8399 <opml version="1.0">
8400 <head>
8401 <title>$title OPML Export$filter</title>
8402 </head>
8403 <body>
8404 <outline text="git RSS feeds">
8407 foreach my $pr (@list) {
8408 my %proj = %$pr;
8409 my $head = git_get_head_hash($proj{'path'});
8410 if (!defined $head) {
8411 next;
8413 $git_dir = "$projectroot/$proj{'path'}";
8414 my %co = parse_commit($head);
8415 if (!%co) {
8416 next;
8419 my $path = esc_html(chop_str($proj{'path'}, 25, 5));
8420 my $rss = href('project' => $proj{'path'}, 'action' => 'rss', -full => 1);
8421 my $html = href('project' => $proj{'path'}, 'action' => 'summary', -full => 1);
8422 print "<outline type=\"rss\" text=\"$path\" title=\"$path\" xmlUrl=\"$rss\" htmlUrl=\"$html\"/>\n";
8424 print <<XML;
8425 </outline>
8426 </body>
8427 </opml>