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
13 use CGI qw(:standard :escapeHTML -nosticky);
14 use CGI::Util qw(unescape);
15 use CGI::Carp qw(fatalsToBrowser set_message);
19 use File::Basename qw(basename);
20 use Time::HiRes qw(gettimeofday tv_interval);
21 binmode STDOUT, ':utf8';
23 our $t0 = [ gettimeofday() ];
24 our $number_of_git_cmds = 0;
27 CGI->compile() if $ENV{'MOD_PERL'};
30 our $version = "++GIT_VERSION++";
32 our ($my_url, $my_uri, $base_url, $path_info, $home_link);
36 our $my_url = $cgi->url();
37 our $my_uri = $cgi->url(-absolute => 1);
39 # Base URL for relative URLs in gitweb ($logo, $favicon, ...),
40 # needed and used only for URLs with nonempty PATH_INFO
41 our $base_url = $my_url;
43 # When the script is used as DirectoryIndex, the URL does not contain the name
44 # of the script file itself, and $cgi->url() fails to strip PATH_INFO, so we
45 # have to do it ourselves. We make $path_info global because it's also used
48 # Another issue with the script being the DirectoryIndex is that the resulting
49 # $my_url data is not the full script URL: this is good, because we want
50 # generated links to keep implying the script name if it wasn't explicitly
51 # indicated in the URL we're handling, but it means that $my_url cannot be used
53 # Therefore, if we needed to strip PATH_INFO, then we know that we have
54 # to build the base URL ourselves:
55 our $path_info = decode_utf8($ENV{"PATH_INFO"});
57 # $path_info has already been URL-decoded by the web server, but
58 # $my_url and $my_uri have not. URL-decode them so we can properly
60 $my_url = unescape($my_url);
61 $my_uri = unescape($my_uri);
62 if ($my_url =~ s,\Q$path_info\E$,, &&
63 $my_uri =~ s,\Q$path_info\E$,, &&
64 defined $ENV{'SCRIPT_NAME'}) {
65 $base_url = $cgi->url(-base => 1) . $ENV{'SCRIPT_NAME'};
69 # target of the home link on top of all pages
70 our $home_link = $my_uri || "/";
73 # core git executable to use
74 # this can just be "git" if your webserver has a sensible PATH
75 our $GIT = "++GIT_BINDIR++/git";
77 # absolute fs-path which will be prepended to the project path
78 #our $projectroot = "/pub/scm";
79 our $projectroot = "++GITWEB_PROJECTROOT++";
81 # fs traversing limit for getting project list
82 # the number is relative to the projectroot
83 our $project_maxdepth = "++GITWEB_PROJECT_MAXDEPTH++";
85 # string of the home link on top of all pages
86 our $home_link_str = "++GITWEB_HOME_LINK_STR++";
88 # name of your site or organization to appear in page titles
89 # replace this with something more descriptive for clearer bookmarks
90 our $site_name = "++GITWEB_SITENAME++"
91 || ($ENV{'SERVER_NAME'} || "Untitled") . " Git";
93 # html snippet to include in the <head> section of each page
94 our $site_html_head_string = "++GITWEB_SITE_HTML_HEAD_STRING++";
95 # filename of html text to include at top of each page
96 our $site_header = "++GITWEB_SITE_HEADER++";
97 # html text to include at home page
98 our $home_text = "++GITWEB_HOMETEXT++";
99 # filename of html text to include at bottom of each page
100 our $site_footer = "++GITWEB_SITE_FOOTER++";
103 our @stylesheets = ("++GITWEB_CSS++");
104 # URI of a single stylesheet, which can be overridden in GITWEB_CONFIG.
105 our $stylesheet = undef;
106 # URI of GIT logo (72x27 size)
107 our $logo = "++GITWEB_LOGO++";
108 # URI of GIT favicon, assumed to be image/png type
109 our $favicon = "++GITWEB_FAVICON++";
110 # URI of gitweb.js (JavaScript code for gitweb)
111 our $javascript = "++GITWEB_JS++";
113 # URI and label (title) of GIT logo link
114 #our $logo_url = "http://www.kernel.org/pub/software/scm/git/docs/";
115 #our $logo_label = "git documentation";
116 our $logo_url = "http://git-scm.com/";
117 our $logo_label = "git homepage";
119 # source of projects list
120 our $projects_list = "++GITWEB_LIST++";
122 # the width (in characters) of the projects list "Description" column
123 our $projects_list_description_width = 25;
125 # group projects by category on the projects list
126 # (enabled if this variable evaluates to true)
127 our $projects_list_group_categories = 0;
129 # default category if none specified
130 # (leave the empty string for no category)
131 our $project_list_default_category = "";
133 # default order of projects list
134 # valid values are none, project, descr, owner, and age
135 our $default_projects_order = "project";
137 # show repository only if this file exists
138 # (only effective if this variable evaluates to true)
139 our $export_ok = "++GITWEB_EXPORT_OK++";
141 # don't generate age column on the projects list page
142 our $omit_age_column = 0;
144 # don't generate information about owners of repositories
147 # show repository only if this subroutine returns true
148 # when given the path to the project, for example:
149 # sub { return -e "$_[0]/git-daemon-export-ok"; }
150 our $export_auth_hook = undef;
152 # only allow viewing of repositories also shown on the overview page
153 our $strict_export = "++GITWEB_STRICT_EXPORT++";
155 # list of git base URLs used for URL to where fetch project from,
156 # i.e. full URL is "$git_base_url/$project"
157 our @git_base_url_list = grep { $_ ne '' } ("++GITWEB_BASE_URL++");
159 # default blob_plain mimetype and default charset for text/plain blob
160 our $default_blob_plain_mimetype = 'text/plain';
161 our $default_text_plain_charset = undef;
163 # file to use for guessing MIME types before trying /etc/mime.types
164 # (relative to the current git repository)
165 our $mimetypes_file = undef;
167 # assume this charset if line contains non-UTF-8 characters;
168 # it should be valid encoding (see Encoding::Supported(3pm) for list),
169 # for which encoding all byte sequences are valid, for example
170 # 'iso-8859-1' aka 'latin1' (it is decoded without checking, so it
171 # could be even 'utf-8' for the old behavior)
172 our $fallback_encoding = 'latin1';
174 # rename detection options for git-diff and git-diff-tree
175 # - default is '-M', with the cost proportional to
176 # (number of removed files) * (number of new files).
177 # - more costly is '-C' (which implies '-M'), with the cost proportional to
178 # (number of changed files + number of removed files) * (number of new files)
179 # - even more costly is '-C', '--find-copies-harder' with cost
180 # (number of files in the original tree) * (number of new files)
181 # - one might want to include '-B' option, e.g. '-B', '-M'
182 our @diff_opts = ('-M'); # taken from git_commit
184 # Disables features that would allow repository owners to inject script into
186 our $prevent_xss = 0;
188 # Path to the highlight executable to use (must be the one from
189 # http://www.andre-simon.de due to assumptions about parameters and output).
190 # Useful if highlight is not installed on your webserver's PATH.
191 # [Default: highlight]
192 our $highlight_bin = "++HIGHLIGHT_BIN++";
194 # information about snapshot formats that gitweb is capable of serving
195 our %known_snapshot_formats = (
197 # 'display' => display name,
198 # 'type' => mime type,
199 # 'suffix' => filename suffix,
200 # 'format' => --format for git-archive,
201 # 'compressor' => [compressor command and arguments]
202 # (array reference, optional)
203 # 'disabled' => boolean (optional)}
206 'display' => 'tar.gz',
207 'type' => 'application/x-gzip',
208 'suffix' => '.tar.gz',
210 'compressor' => ['gzip', '-n']},
213 'display' => 'tar.bz2',
214 'type' => 'application/x-bzip2',
215 'suffix' => '.tar.bz2',
217 'compressor' => ['bzip2']},
220 'display' => 'tar.xz',
221 'type' => 'application/x-xz',
222 'suffix' => '.tar.xz',
224 'compressor' => ['xz'],
229 'type' => 'application/x-zip',
234 # Aliases so we understand old gitweb.snapshot values in repository
236 our %known_snapshot_format_aliases = (
241 # backward compatibility: legacy gitweb config support
242 'x-gzip' => undef, 'gz' => undef,
243 'x-bzip2' => undef, 'bz2' => undef,
244 'x-zip' => undef, '' => undef,
247 # Pixel sizes for icons and avatars. If the default font sizes or lineheights
248 # are changed, it may be appropriate to change these values too via
255 # Used to set the maximum load that we will still respond to gitweb queries.
256 # If server load exceed this value then return "503 server busy" error.
257 # If gitweb cannot determined server load, it is taken to be 0.
258 # Leave it undefined (or set to 'undef') to turn off load checking.
261 # configuration for 'highlight' (http://www.andre-simon.de/)
263 our %highlight_basename = (
266 'SConstruct' => 'py', # SCons equivalent of Makefile
267 'Makefile' => 'make',
270 our %highlight_ext = (
271 # main extensions, defining name of syntax;
272 # see files in /usr/share/highlight/langDefs/ directory
274 qw(py c cpp rb java css php sh pl js tex bib xml awk bat ini spec tcl sql make),
275 # alternate extensions, see /etc/highlight/filetypes.conf
277 map { $_ => 'sh' } qw(bash zsh ksh),
278 map { $_ => 'cpp' } qw(cxx c++ cc),
279 map { $_ => 'php' } qw(php3 php4 php5 phps),
280 map { $_ => 'pl' } qw(perl pm), # perhaps also 'cgi'
281 map { $_ => 'make'} qw(mak mk),
282 map { $_ => 'xml' } qw(xhtml html htm),
285 # You define site-wide feature defaults here; override them with
286 # $GITWEB_CONFIG as necessary.
289 # 'sub' => feature-sub (subroutine),
290 # 'override' => allow-override (boolean),
291 # 'default' => [ default options...] (array reference)}
293 # if feature is overridable (it means that allow-override has true value),
294 # then feature-sub will be called with default options as parameters;
295 # return value of feature-sub indicates if to enable specified feature
297 # if there is no 'sub' key (no feature-sub), then feature cannot be
300 # use gitweb_get_feature(<feature>) to retrieve the <feature> value
301 # (an array) or gitweb_check_feature(<feature>) to check if <feature>
304 # Enable the 'blame' blob view, showing the last commit that modified
305 # each line in the file. This can be very CPU-intensive.
307 # To enable system wide have in $GITWEB_CONFIG
308 # $feature{'blame'}{'default'} = [1];
309 # To have project specific config enable override in $GITWEB_CONFIG
310 # $feature{'blame'}{'override'} = 1;
311 # and in project config gitweb.blame = 0|1;
313 'sub' => sub { feature_bool('blame', @_) },
317 # Enable the 'snapshot' link, providing a compressed archive of any
318 # tree. This can potentially generate high traffic if you have large
321 # Value is a list of formats defined in %known_snapshot_formats that
323 # To disable system wide have in $GITWEB_CONFIG
324 # $feature{'snapshot'}{'default'} = [];
325 # To have project specific config enable override in $GITWEB_CONFIG
326 # $feature{'snapshot'}{'override'} = 1;
327 # and in project config, a comma-separated list of formats or "none"
328 # to disable. Example: gitweb.snapshot = tbz2,zip;
330 'sub' => \&feature_snapshot,
332 'default' => ['tgz']},
334 # Enable text search, which will list the commits which match author,
335 # committer or commit text to a given string. Enabled by default.
336 # Project specific override is not supported.
338 # Note that this controls all search features, which means that if
339 # it is disabled, then 'grep' and 'pickaxe' search would also be
345 # Enable grep search, which will list the files in currently selected
346 # tree containing the given string. Enabled by default. This can be
347 # potentially CPU-intensive, of course.
348 # Note that you need to have 'search' feature enabled too.
350 # To enable system wide have in $GITWEB_CONFIG
351 # $feature{'grep'}{'default'} = [1];
352 # To have project specific config enable override in $GITWEB_CONFIG
353 # $feature{'grep'}{'override'} = 1;
354 # and in project config gitweb.grep = 0|1;
356 'sub' => sub { feature_bool('grep', @_) },
360 # Enable the pickaxe search, which will list the commits that modified
361 # a given string in a file. This can be practical and quite faster
362 # alternative to 'blame', but still potentially CPU-intensive.
363 # Note that you need to have 'search' feature enabled too.
365 # To enable system wide have in $GITWEB_CONFIG
366 # $feature{'pickaxe'}{'default'} = [1];
367 # To have project specific config enable override in $GITWEB_CONFIG
368 # $feature{'pickaxe'}{'override'} = 1;
369 # and in project config gitweb.pickaxe = 0|1;
371 'sub' => sub { feature_bool('pickaxe', @_) },
375 # Enable showing size of blobs in a 'tree' view, in a separate
376 # column, similar to what 'ls -l' does. This cost a bit of IO.
378 # To disable system wide have in $GITWEB_CONFIG
379 # $feature{'show-sizes'}{'default'} = [0];
380 # To have project specific config enable override in $GITWEB_CONFIG
381 # $feature{'show-sizes'}{'override'} = 1;
382 # and in project config gitweb.showsizes = 0|1;
384 'sub' => sub { feature_bool('showsizes', @_) },
388 # Make gitweb use an alternative format of the URLs which can be
389 # more readable and natural-looking: project name is embedded
390 # directly in the path and the query string contains other
391 # auxiliary information. All gitweb installations recognize
392 # URL in either format; this configures in which formats gitweb
395 # To enable system wide have in $GITWEB_CONFIG
396 # $feature{'pathinfo'}{'default'} = [1];
397 # Project specific override is not supported.
399 # Note that you will need to change the default location of CSS,
400 # favicon, logo and possibly other files to an absolute URL. Also,
401 # if gitweb.cgi serves as your indexfile, you will need to force
402 # $my_uri to contain the script name in your $GITWEB_CONFIG.
407 # Make gitweb consider projects in project root subdirectories
408 # to be forks of existing projects. Given project $projname.git,
409 # projects matching $projname/*.git will not be shown in the main
410 # projects list, instead a '+' mark will be added to $projname
411 # there and a 'forks' view will be enabled for the project, listing
412 # all the forks. If project list is taken from a file, forks have
413 # to be listed after the main project.
415 # To enable system wide have in $GITWEB_CONFIG
416 # $feature{'forks'}{'default'} = [1];
417 # Project specific override is not supported.
422 # Insert custom links to the action bar of all project pages.
423 # This enables you mainly to link to third-party scripts integrating
424 # into gitweb; e.g. git-browser for graphical history representation
425 # or custom web-based repository administration interface.
427 # The 'default' value consists of a list of triplets in the form
428 # (label, link, position) where position is the label after which
429 # to insert the link and link is a format string where %n expands
430 # to the project name, %f to the project path within the filesystem,
431 # %h to the current hash (h gitweb parameter) and %b to the current
432 # hash base (hb gitweb parameter); %% expands to %.
434 # To enable system wide have in $GITWEB_CONFIG e.g.
435 # $feature{'actions'}{'default'} = [('graphiclog',
436 # '/git-browser/by-commit.html?r=%n', 'summary')];
437 # Project specific override is not supported.
442 # Allow gitweb scan project content tags of project repository,
443 # and display the popular Web 2.0-ish "tag cloud" near the projects
444 # list. Note that this is something COMPLETELY different from the
447 # gitweb by itself can show existing tags, but it does not handle
448 # tagging itself; you need to do it externally, outside gitweb.
449 # The format is described in git_get_project_ctags() subroutine.
450 # You may want to install the HTML::TagCloud Perl module to get
451 # a pretty tag cloud instead of just a list of tags.
453 # To enable system wide have in $GITWEB_CONFIG
454 # $feature{'ctags'}{'default'} = [1];
455 # Project specific override is not supported.
457 # In the future whether ctags editing is enabled might depend
458 # on the value, but using 1 should always mean no editing of ctags.
463 # The maximum number of patches in a patchset generated in patch
464 # view. Set this to 0 or undef to disable patch view, or to a
465 # negative number to remove any limit.
467 # To disable system wide have in $GITWEB_CONFIG
468 # $feature{'patches'}{'default'} = [0];
469 # To have project specific config enable override in $GITWEB_CONFIG
470 # $feature{'patches'}{'override'} = 1;
471 # and in project config gitweb.patches = 0|n;
472 # where n is the maximum number of patches allowed in a patchset.
474 'sub' => \&feature_patches,
478 # Avatar support. When this feature is enabled, views such as
479 # shortlog or commit will display an avatar associated with
480 # the email of the committer(s) and/or author(s).
482 # Currently available providers are gravatar and picon.
483 # If an unknown provider is specified, the feature is disabled.
485 # Gravatar depends on Digest::MD5.
486 # Picon currently relies on the indiana.edu database.
488 # To enable system wide have in $GITWEB_CONFIG
489 # $feature{'avatar'}{'default'} = ['<provider>'];
490 # where <provider> is either gravatar or picon.
491 # To have project specific config enable override in $GITWEB_CONFIG
492 # $feature{'avatar'}{'override'} = 1;
493 # and in project config gitweb.avatar = <provider>;
495 'sub' => \&feature_avatar,
499 # Enable displaying how much time and how many git commands
500 # it took to generate and display page. Disabled by default.
501 # Project specific override is not supported.
506 # Enable turning some links into links to actions which require
507 # JavaScript to run (like 'blame_incremental'). Not enabled by
508 # default. Project specific override is currently not supported.
509 'javascript-actions' => {
513 # Enable and configure ability to change common timezone for dates
514 # in gitweb output via JavaScript. Enabled by default.
515 # Project specific override is not supported.
516 'javascript-timezone' => {
519 'local', # default timezone: 'utc', 'local', or '(-|+)HHMM' format,
520 # or undef to turn off this feature
521 'gitweb_tz', # name of cookie where to store selected timezone
522 'datetime', # CSS class used to mark up dates for manipulation
525 # Syntax highlighting support. This is based on Daniel Svensson's
526 # and Sham Chukoury's work in gitweb-xmms2.git.
527 # It requires the 'highlight' program present in $PATH,
528 # and therefore is disabled by default.
530 # To enable system wide have in $GITWEB_CONFIG
531 # $feature{'highlight'}{'default'} = [1];
534 'sub' => sub { feature_bool('highlight', @_) },
538 # Enable displaying of remote heads in the heads list
540 # To enable system wide have in $GITWEB_CONFIG
541 # $feature{'remote_heads'}{'default'} = [1];
542 # To have project specific config enable override in $GITWEB_CONFIG
543 # $feature{'remote_heads'}{'override'} = 1;
544 # and in project config gitweb.remote_heads = 0|1;
546 'sub' => sub { feature_bool('remote_heads', @_) },
551 sub gitweb_get_feature {
553 return unless exists $feature{$name};
554 my ($sub, $override, @defaults) = (
555 $feature{$name}{'sub'},
556 $feature{$name}{'override'},
557 @{$feature{$name}{'default'}});
558 # project specific override is possible only if we have project
559 our $git_dir; # global variable, declared later
560 if (!$override || !defined $git_dir) {
564 warn "feature $name is not overridable";
567 return $sub->(@defaults);
570 # A wrapper to check if a given feature is enabled.
571 # With this, you can say
573 # my $bool_feat = gitweb_check_feature('bool_feat');
574 # gitweb_check_feature('bool_feat') or somecode;
578 # my ($bool_feat) = gitweb_get_feature('bool_feat');
579 # (gitweb_get_feature('bool_feat'))[0] or somecode;
581 sub gitweb_check_feature {
582 return (gitweb_get_feature(@_))[0];
588 my ($val) = git_get_project_config($key, '--bool');
592 } elsif ($val eq 'true') {
594 } elsif ($val eq 'false') {
599 sub feature_snapshot {
602 my ($val) = git_get_project_config('snapshot');
605 @fmts = ($val eq 'none' ? () : split /\s*[,\s]\s*/, $val);
611 sub feature_patches {
612 my @val = (git_get_project_config('patches', '--int'));
622 my @val = (git_get_project_config('avatar'));
624 return @val ? @val : @_;
627 # checking HEAD file with -e is fragile if the repository was
628 # initialized long time ago (i.e. symlink HEAD) and was pack-ref'ed
630 sub check_head_link {
632 my $headfile = "$dir/HEAD";
633 return ((-e $headfile) ||
634 (-l $headfile && readlink($headfile) =~ /^refs\/heads\//));
637 sub check_export_ok {
639 return (check_head_link($dir) &&
640 (!$export_ok || -e "$dir/$export_ok") &&
641 (!$export_auth_hook || $export_auth_hook->($dir)));
644 # process alternate names for backward compatibility
645 # filter out unsupported (unknown) snapshot formats
646 sub filter_snapshot_fmts {
650 exists $known_snapshot_format_aliases{$_} ?
651 $known_snapshot_format_aliases{$_} : $_} @fmts;
653 exists $known_snapshot_formats{$_} &&
654 !$known_snapshot_formats{$_}{'disabled'}} @fmts;
657 # If it is set to code reference, it is code that it is to be run once per
658 # request, allowing updating configurations that change with each request,
659 # while running other code in config file only once.
661 # Otherwise, if it is false then gitweb would process config file only once;
662 # if it is true then gitweb config would be run for each request.
663 our $per_request_config = 1;
665 # read and parse gitweb config file given by its parameter.
666 # returns true on success, false on recoverable error, allowing
667 # to chain this subroutine, using first file that exists.
668 # dies on errors during parsing config file, as it is unrecoverable.
669 sub read_config_file {
670 my $filename = shift;
671 return unless defined $filename;
672 # die if there are errors parsing config file
681 our ($GITWEB_CONFIG, $GITWEB_CONFIG_SYSTEM, $GITWEB_CONFIG_COMMON);
682 sub evaluate_gitweb_config {
683 our $GITWEB_CONFIG = $ENV{'GITWEB_CONFIG'} || "++GITWEB_CONFIG++";
684 our $GITWEB_CONFIG_SYSTEM = $ENV{'GITWEB_CONFIG_SYSTEM'} || "++GITWEB_CONFIG_SYSTEM++";
685 our $GITWEB_CONFIG_COMMON = $ENV{'GITWEB_CONFIG_COMMON'} || "++GITWEB_CONFIG_COMMON++";
687 # Protect agains duplications of file names, to not read config twice.
688 # Only one of $GITWEB_CONFIG and $GITWEB_CONFIG_SYSTEM is used, so
689 # there possibility of duplication of filename there doesn't matter.
690 $GITWEB_CONFIG = "" if ($GITWEB_CONFIG eq $GITWEB_CONFIG_COMMON);
691 $GITWEB_CONFIG_SYSTEM = "" if ($GITWEB_CONFIG_SYSTEM eq $GITWEB_CONFIG_COMMON);
693 # Common system-wide settings for convenience.
694 # Those settings can be ovverriden by GITWEB_CONFIG or GITWEB_CONFIG_SYSTEM.
695 read_config_file($GITWEB_CONFIG_COMMON);
697 # Use first config file that exists. This means use the per-instance
698 # GITWEB_CONFIG if exists, otherwise use GITWEB_SYSTEM_CONFIG.
699 read_config_file($GITWEB_CONFIG) and return;
700 read_config_file($GITWEB_CONFIG_SYSTEM);
703 # Get loadavg of system, to compare against $maxload.
704 # Currently it requires '/proc/loadavg' present to get loadavg;
705 # if it is not present it returns 0, which means no load checking.
707 if( -e '/proc/loadavg' ){
708 open my $fd, '<', '/proc/loadavg'
710 my @load = split(/\s+/, scalar <$fd>);
713 # The first three columns measure CPU and IO utilization of the last one,
714 # five, and 10 minute periods. The fourth column shows the number of
715 # currently running processes and the total number of processes in the m/n
716 # format. The last column displays the last process ID used.
717 return $load[0] || 0;
719 # additional checks for load average should go here for things that don't export
725 # version of the core git binary
727 sub evaluate_git_version {
728 our $git_version = qx("$GIT" --version) =~ m/git version (.*)$/ ? $1 : "unknown";
729 $number_of_git_cmds++;
733 if (defined $maxload && get_loadavg() > $maxload) {
734 die_error(503, "The load average on the server is too high");
738 # ======================================================================
739 # input validation and dispatch
741 # input parameters can be collected from a variety of sources (presently, CGI
742 # and PATH_INFO), so we define an %input_params hash that collects them all
743 # together during validation: this allows subsequent uses (e.g. href()) to be
744 # agnostic of the parameter origin
746 our %input_params = ();
748 # input parameters are stored with the long parameter name as key. This will
749 # also be used in the href subroutine to convert parameters to their CGI
750 # equivalent, and since the href() usage is the most frequent one, we store
751 # the name -> CGI key mapping here, instead of the reverse.
753 # XXX: Warning: If you touch this, check the search form for updating,
756 our @cgi_param_mapping = (
764 hash_parent_base => "hpb",
769 snapshot_format => "sf",
770 extra_options => "opt",
771 search_use_regexp => "sr",
774 project_filter => "pf",
775 # this must be last entry (for manipulation from JavaScript)
778 our %cgi_param_mapping = @cgi_param_mapping;
780 # we will also need to know the possible actions, for validation
782 "blame" => \&git_blame,
783 "blame_incremental" => \&git_blame_incremental,
784 "blame_data" => \&git_blame_data,
785 "blobdiff" => \&git_blobdiff,
786 "blobdiff_plain" => \&git_blobdiff_plain,
787 "blob" => \&git_blob,
788 "blob_plain" => \&git_blob_plain,
789 "commitdiff" => \&git_commitdiff,
790 "commitdiff_plain" => \&git_commitdiff_plain,
791 "commit" => \&git_commit,
792 "forks" => \&git_forks,
793 "heads" => \&git_heads,
794 "history" => \&git_history,
796 "patch" => \&git_patch,
797 "patches" => \&git_patches,
798 "remotes" => \&git_remotes,
800 "atom" => \&git_atom,
801 "search" => \&git_search,
802 "search_help" => \&git_search_help,
803 "shortlog" => \&git_shortlog,
804 "summary" => \&git_summary,
806 "tags" => \&git_tags,
807 "tree" => \&git_tree,
808 "snapshot" => \&git_snapshot,
809 "object" => \&git_object,
810 # those below don't need $project
811 "opml" => \&git_opml,
812 "project_list" => \&git_project_list,
813 "project_index" => \&git_project_index,
816 # finally, we have the hash of allowed extra_options for the commands that
818 our %allowed_options = (
819 "--no-merges" => [ qw(rss atom log shortlog history) ],
822 # fill %input_params with the CGI parameters. All values except for 'opt'
823 # should be single values, but opt can be an array. We should probably
824 # build an array of parameters that can be multi-valued, but since for the time
825 # being it's only this one, we just single it out
826 sub evaluate_query_params {
829 while (my ($name, $symbol) = each %cgi_param_mapping) {
830 if ($symbol eq 'opt') {
831 $input_params{$name} = [ map { decode_utf8($_) } $cgi->param($symbol) ];
833 $input_params{$name} = decode_utf8($cgi->param($symbol));
838 # now read PATH_INFO and update the parameter list for missing parameters
839 sub evaluate_path_info {
840 return if defined $input_params{'project'};
841 return if !$path_info;
842 $path_info =~ s,^/+,,;
843 return if !$path_info;
845 # find which part of PATH_INFO is project
846 my $project = $path_info;
848 while ($project && !check_head_link("$projectroot/$project")) {
849 $project =~ s,/*[^/]*$,,;
851 return unless $project;
852 $input_params{'project'} = $project;
854 # do not change any parameters if an action is given using the query string
855 return if $input_params{'action'};
856 $path_info =~ s,^\Q$project\E/*,,;
858 # next, check if we have an action
859 my $action = $path_info;
861 if (exists $actions{$action}) {
862 $path_info =~ s,^$action/*,,;
863 $input_params{'action'} = $action;
866 # list of actions that want hash_base instead of hash, but can have no
867 # pathname (f) parameter
873 # we want to catch, among others
874 # [$hash_parent_base[:$file_parent]..]$hash_parent[:$file_name]
875 my ($parentrefname, $parentpathname, $refname, $pathname) =
876 ($path_info =~ /^(?:(.+?)(?::(.+))?\.\.)?([^:]+?)?(?::(.+))?$/);
878 # first, analyze the 'current' part
879 if (defined $pathname) {
880 # we got "branch:filename" or "branch:dir/"
881 # we could use git_get_type(branch:pathname), but:
882 # - it needs $git_dir
883 # - it does a git() call
884 # - the convention of terminating directories with a slash
885 # makes it superfluous
886 # - embedding the action in the PATH_INFO would make it even
888 $pathname =~ s,^/+,,;
889 if (!$pathname || substr($pathname, -1) eq "/") {
890 $input_params{'action'} ||= "tree";
893 # the default action depends on whether we had parent info
895 if ($parentrefname) {
896 $input_params{'action'} ||= "blobdiff_plain";
898 $input_params{'action'} ||= "blob_plain";
901 $input_params{'hash_base'} ||= $refname;
902 $input_params{'file_name'} ||= $pathname;
903 } elsif (defined $refname) {
904 # we got "branch". In this case we have to choose if we have to
905 # set hash or hash_base.
907 # Most of the actions without a pathname only want hash to be
908 # set, except for the ones specified in @wants_base that want
909 # hash_base instead. It should also be noted that hand-crafted
910 # links having 'history' as an action and no pathname or hash
911 # set will fail, but that happens regardless of PATH_INFO.
912 if (defined $parentrefname) {
913 # if there is parent let the default be 'shortlog' action
914 # (for http://git.example.com/repo.git/A..B links); if there
915 # is no parent, dispatch will detect type of object and set
916 # action appropriately if required (if action is not set)
917 $input_params{'action'} ||= "shortlog";
919 if ($input_params{'action'} &&
920 grep { $_ eq $input_params{'action'} } @wants_base) {
921 $input_params{'hash_base'} ||= $refname;
923 $input_params{'hash'} ||= $refname;
927 # next, handle the 'parent' part, if present
928 if (defined $parentrefname) {
929 # a missing pathspec defaults to the 'current' filename, allowing e.g.
930 # someproject/blobdiff/oldrev..newrev:/filename
931 if ($parentpathname) {
932 $parentpathname =~ s,^/+,,;
933 $parentpathname =~ s,/$,,;
934 $input_params{'file_parent'} ||= $parentpathname;
936 $input_params{'file_parent'} ||= $input_params{'file_name'};
938 # we assume that hash_parent_base is wanted if a path was specified,
939 # or if the action wants hash_base instead of hash
940 if (defined $input_params{'file_parent'} ||
941 grep { $_ eq $input_params{'action'} } @wants_base) {
942 $input_params{'hash_parent_base'} ||= $parentrefname;
944 $input_params{'hash_parent'} ||= $parentrefname;
948 # for the snapshot action, we allow URLs in the form
949 # $project/snapshot/$hash.ext
950 # where .ext determines the snapshot and gets removed from the
951 # passed $refname to provide the $hash.
953 # To be able to tell that $refname includes the format extension, we
954 # require the following two conditions to be satisfied:
955 # - the hash input parameter MUST have been set from the $refname part
956 # of the URL (i.e. they must be equal)
957 # - the snapshot format MUST NOT have been defined already (e.g. from
959 # It's also useless to try any matching unless $refname has a dot,
960 # so we check for that too
961 if (defined $input_params{'action'} &&
962 $input_params{'action'} eq 'snapshot' &&
963 defined $refname && index($refname, '.') != -1 &&
964 $refname eq $input_params{'hash'} &&
965 !defined $input_params{'snapshot_format'}) {
966 # We loop over the known snapshot formats, checking for
967 # extensions. Allowed extensions are both the defined suffix
968 # (which includes the initial dot already) and the snapshot
969 # format key itself, with a prepended dot
970 while (my ($fmt, $opt) = each %known_snapshot_formats) {
972 unless ($hash =~ s/(\Q$opt->{'suffix'}\E|\Q.$fmt\E)$//) {
976 # a valid suffix was found, so set the snapshot format
977 # and reset the hash parameter
978 $input_params{'snapshot_format'} = $fmt;
979 $input_params{'hash'} = $hash;
980 # we also set the format suffix to the one requested
981 # in the URL: this way a request for e.g. .tgz returns
982 # a .tgz instead of a .tar.gz
983 $known_snapshot_formats{$fmt}{'suffix'} = $sfx;
989 our ($action, $project, $file_name, $file_parent, $hash, $hash_parent, $hash_base,
990 $hash_parent_base, @extra_options, $page, $searchtype, $search_use_regexp,
991 $searchtext, $search_regexp, $project_filter);
992 sub evaluate_and_validate_params {
993 our $action = $input_params{'action'};
994 if (defined $action) {
995 if (!validate_action($action)) {
996 die_error(400, "Invalid action parameter");
1000 # parameters which are pathnames
1001 our $project = $input_params{'project'};
1002 if (defined $project) {
1003 if (!validate_project($project)) {
1005 die_error(404, "No such project");
1009 our $project_filter = $input_params{'project_filter'};
1010 if (defined $project_filter) {
1011 if (!validate_pathname($project_filter)) {
1012 die_error(404, "Invalid project_filter parameter");
1016 our $file_name = $input_params{'file_name'};
1017 if (defined $file_name) {
1018 if (!validate_pathname($file_name)) {
1019 die_error(400, "Invalid file parameter");
1023 our $file_parent = $input_params{'file_parent'};
1024 if (defined $file_parent) {
1025 if (!validate_pathname($file_parent)) {
1026 die_error(400, "Invalid file parent parameter");
1030 # parameters which are refnames
1031 our $hash = $input_params{'hash'};
1032 if (defined $hash) {
1033 if (!validate_refname($hash)) {
1034 die_error(400, "Invalid hash parameter");
1038 our $hash_parent = $input_params{'hash_parent'};
1039 if (defined $hash_parent) {
1040 if (!validate_refname($hash_parent)) {
1041 die_error(400, "Invalid hash parent parameter");
1045 our $hash_base = $input_params{'hash_base'};
1046 if (defined $hash_base) {
1047 if (!validate_refname($hash_base)) {
1048 die_error(400, "Invalid hash base parameter");
1052 our @extra_options = @{$input_params{'extra_options'}};
1053 # @extra_options is always defined, since it can only be (currently) set from
1054 # CGI, and $cgi->param() returns the empty array in array context if the param
1056 foreach my $opt (@extra_options) {
1057 if (not exists $allowed_options{$opt}) {
1058 die_error(400, "Invalid option parameter");
1060 if (not grep(/^$action$/, @{$allowed_options{$opt}})) {
1061 die_error(400, "Invalid option parameter for this action");
1065 our $hash_parent_base = $input_params{'hash_parent_base'};
1066 if (defined $hash_parent_base) {
1067 if (!validate_refname($hash_parent_base)) {
1068 die_error(400, "Invalid hash parent base parameter");
1073 our $page = $input_params{'page'};
1074 if (defined $page) {
1075 if ($page =~ m/[^0-9]/) {
1076 die_error(400, "Invalid page parameter");
1080 our $searchtype = $input_params{'searchtype'};
1081 if (defined $searchtype) {
1082 if ($searchtype =~ m/[^a-z]/) {
1083 die_error(400, "Invalid searchtype parameter");
1087 our $search_use_regexp = $input_params{'search_use_regexp'};
1089 our $searchtext = $input_params{'searchtext'};
1091 if (defined $searchtext) {
1092 if (length($searchtext) < 2) {
1093 die_error(403, "At least two characters are required for search parameter");
1095 if ($search_use_regexp) {
1096 $search_regexp = $searchtext;
1097 if (!eval { qr/$search_regexp/; 1; }) {
1098 (my $error = $@) =~ s/ at \S+ line \d+.*\n?//;
1099 die_error(400, "Invalid search regexp '$search_regexp'",
1103 $search_regexp = quotemeta $searchtext;
1108 # path to the current git repository
1110 sub evaluate_git_dir {
1111 our $git_dir = "$projectroot/$project" if $project;
1114 our (@snapshot_fmts, $git_avatar);
1115 sub configure_gitweb_features {
1116 # list of supported snapshot formats
1117 our @snapshot_fmts = gitweb_get_feature('snapshot');
1118 @snapshot_fmts = filter_snapshot_fmts(@snapshot_fmts);
1120 # check that the avatar feature is set to a known provider name,
1121 # and for each provider check if the dependencies are satisfied.
1122 # if the provider name is invalid or the dependencies are not met,
1123 # reset $git_avatar to the empty string.
1124 our ($git_avatar) = gitweb_get_feature('avatar');
1125 if ($git_avatar eq 'gravatar') {
1126 $git_avatar = '' unless (eval { require Digest::MD5; 1; });
1127 } elsif ($git_avatar eq 'picon') {
1134 # custom error handler: 'die <message>' is Internal Server Error
1135 sub handle_errors_html {
1136 my $msg = shift; # it is already HTML escaped
1138 # to avoid infinite loop where error occurs in die_error,
1139 # change handler to default handler, disabling handle_errors_html
1140 set_message("Error occured when inside die_error:\n$msg");
1142 # you cannot jump out of die_error when called as error handler;
1143 # the subroutine set via CGI::Carp::set_message is called _after_
1144 # HTTP headers are already written, so it cannot write them itself
1145 die_error(undef, undef, $msg, -error_handler => 1, -no_http_header => 1);
1147 set_message(\&handle_errors_html);
1151 if (!defined $action) {
1152 if (defined $hash) {
1153 $action = git_get_type($hash);
1154 $action or die_error(404, "Object does not exist");
1155 } elsif (defined $hash_base && defined $file_name) {
1156 $action = git_get_type("$hash_base:$file_name");
1157 $action or die_error(404, "File or directory does not exist");
1158 } elsif (defined $project) {
1159 $action = 'summary';
1161 $action = 'project_list';
1164 if (!defined($actions{$action})) {
1165 die_error(400, "Unknown action");
1167 if ($action !~ m/^(?:opml|project_list|project_index)$/ &&
1169 die_error(400, "Project needed");
1171 $actions{$action}->();
1175 our $t0 = [ gettimeofday() ]
1177 our $number_of_git_cmds = 0;
1180 our $first_request = 1;
1185 if ($first_request) {
1186 evaluate_gitweb_config();
1187 evaluate_git_version();
1189 if ($per_request_config) {
1190 if (ref($per_request_config) eq 'CODE') {
1191 $per_request_config->();
1192 } elsif (!$first_request) {
1193 evaluate_gitweb_config();
1198 # $projectroot and $projects_list might be set in gitweb config file
1199 $projects_list ||= $projectroot;
1201 evaluate_query_params();
1202 evaluate_path_info();
1203 evaluate_and_validate_params();
1206 configure_gitweb_features();
1211 our $is_last_request = sub { 1 };
1212 our ($pre_dispatch_hook, $post_dispatch_hook, $pre_listen_hook);
1215 sub configure_as_fcgi {
1217 our $CGI = 'CGI::Fast';
1219 my $request_number = 0;
1220 # let each child service 100 requests
1221 our $is_last_request = sub { ++$request_number > 100 };
1224 my $script_name = $ENV{'SCRIPT_NAME'} || $ENV{'SCRIPT_FILENAME'} || __FILE__;
1226 if $script_name =~ /\.fcgi$/;
1228 return unless (@ARGV);
1230 require Getopt::Long;
1231 Getopt::Long::GetOptions(
1232 'fastcgi|fcgi|f' => \&configure_as_fcgi,
1233 'nproc|n=i' => sub {
1234 my ($arg, $val) = @_;
1235 return unless eval { require FCGI::ProcManager; 1; };
1236 my $proc_manager = FCGI::ProcManager->new({
1237 n_processes => $val,
1239 our $pre_listen_hook = sub { $proc_manager->pm_manage() };
1240 our $pre_dispatch_hook = sub { $proc_manager->pm_pre_dispatch() };
1241 our $post_dispatch_hook = sub { $proc_manager->pm_post_dispatch() };
1250 $pre_listen_hook->()
1251 if $pre_listen_hook;
1254 while ($cgi = $CGI->new()) {
1255 $pre_dispatch_hook->()
1256 if $pre_dispatch_hook;
1260 $post_dispatch_hook->()
1261 if $post_dispatch_hook;
1264 last REQUEST if ($is_last_request->());
1273 if (defined caller) {
1274 # wrapped in a subroutine processing requests,
1275 # e.g. mod_perl with ModPerl::Registry, or PSGI with Plack::App::WrapCGI
1278 # pure CGI script, serving single request
1282 ## ======================================================================
1285 # possible values of extra options
1286 # -full => 0|1 - use absolute/full URL ($my_uri/$my_url as base)
1287 # -replay => 1 - start from a current view (replay with modifications)
1288 # -path_info => 0|1 - don't use/use path_info URL (if possible)
1289 # -anchor => ANCHOR - add #ANCHOR to end of URL, implies -replay if used alone
1292 # default is to use -absolute url() i.e. $my_uri
1293 my $href = $params{-full} ? $my_url : $my_uri;
1295 # implicit -replay, must be first of implicit params
1296 $params{-replay} = 1 if (keys %params == 1 && $params{-anchor});
1298 $params{'project'} = $project unless exists $params{'project'};
1300 if ($params{-replay}) {
1301 while (my ($name, $symbol) = each %cgi_param_mapping) {
1302 if (!exists $params{$name}) {
1303 $params{$name} = $input_params{$name};
1308 my $use_pathinfo = gitweb_check_feature('pathinfo');
1309 if (defined $params{'project'} &&
1310 (exists $params{-path_info} ? $params{-path_info} : $use_pathinfo)) {
1311 # try to put as many parameters as possible in PATH_INFO:
1314 # - hash_parent or hash_parent_base:/file_parent
1315 # - hash or hash_base:/filename
1316 # - the snapshot_format as an appropriate suffix
1318 # When the script is the root DirectoryIndex for the domain,
1319 # $href here would be something like http://gitweb.example.com/
1320 # Thus, we strip any trailing / from $href, to spare us double
1321 # slashes in the final URL
1324 # Then add the project name, if present
1325 $href .= "/".esc_path_info($params{'project'});
1326 delete $params{'project'};
1328 # since we destructively absorb parameters, we keep this
1329 # boolean that remembers if we're handling a snapshot
1330 my $is_snapshot = $params{'action'} eq 'snapshot';
1332 # Summary just uses the project path URL, any other action is
1334 if (defined $params{'action'}) {
1335 $href .= "/".esc_path_info($params{'action'})
1336 unless $params{'action'} eq 'summary';
1337 delete $params{'action'};
1340 # Next, we put hash_parent_base:/file_parent..hash_base:/file_name,
1341 # stripping nonexistent or useless pieces
1342 $href .= "/" if ($params{'hash_base'} || $params{'hash_parent_base'}
1343 || $params{'hash_parent'} || $params{'hash'});
1344 if (defined $params{'hash_base'}) {
1345 if (defined $params{'hash_parent_base'}) {
1346 $href .= esc_path_info($params{'hash_parent_base'});
1347 # skip the file_parent if it's the same as the file_name
1348 if (defined $params{'file_parent'}) {
1349 if (defined $params{'file_name'} && $params{'file_parent'} eq $params{'file_name'}) {
1350 delete $params{'file_parent'};
1351 } elsif ($params{'file_parent'} !~ /\.\./) {
1352 $href .= ":/".esc_path_info($params{'file_parent'});
1353 delete $params{'file_parent'};
1357 delete $params{'hash_parent'};
1358 delete $params{'hash_parent_base'};
1359 } elsif (defined $params{'hash_parent'}) {
1360 $href .= esc_path_info($params{'hash_parent'}). "..";
1361 delete $params{'hash_parent'};
1364 $href .= esc_path_info($params{'hash_base'});
1365 if (defined $params{'file_name'} && $params{'file_name'} !~ /\.\./) {
1366 $href .= ":/".esc_path_info($params{'file_name'});
1367 delete $params{'file_name'};
1369 delete $params{'hash'};
1370 delete $params{'hash_base'};
1371 } elsif (defined $params{'hash'}) {
1372 $href .= esc_path_info($params{'hash'});
1373 delete $params{'hash'};
1376 # If the action was a snapshot, we can absorb the
1377 # snapshot_format parameter too
1379 my $fmt = $params{'snapshot_format'};
1380 # snapshot_format should always be defined when href()
1381 # is called, but just in case some code forgets, we
1382 # fall back to the default
1383 $fmt ||= $snapshot_fmts[0];
1384 $href .= $known_snapshot_formats{$fmt}{'suffix'};
1385 delete $params{'snapshot_format'};
1389 # now encode the parameters explicitly
1391 for (my $i = 0; $i < @cgi_param_mapping; $i += 2) {
1392 my ($name, $symbol) = ($cgi_param_mapping[$i], $cgi_param_mapping[$i+1]);
1393 if (defined $params{$name}) {
1394 if (ref($params{$name}) eq "ARRAY") {
1395 foreach my $par (@{$params{$name}}) {
1396 push @result, $symbol . "=" . esc_param($par);
1399 push @result, $symbol . "=" . esc_param($params{$name});
1403 $href .= "?" . join(';', @result) if scalar @result;
1405 # final transformation: trailing spaces must be escaped (URI-encoded)
1406 $href =~ s/(\s+)$/CGI::escape($1)/e;
1408 if ($params{-anchor}) {
1409 $href .= "#".esc_param($params{-anchor});
1416 ## ======================================================================
1417 ## validation, quoting/unquoting and escaping
1419 sub validate_action {
1420 my $input = shift || return undef;
1421 return undef unless exists $actions{$input};
1425 sub validate_project {
1426 my $input = shift || return undef;
1427 if (!validate_pathname($input) ||
1428 !(-d "$projectroot/$input") ||
1429 !check_export_ok("$projectroot/$input") ||
1430 ($strict_export && !project_in_list($input))) {
1437 sub validate_pathname {
1438 my $input = shift || return undef;
1440 # no '.' or '..' as elements of path, i.e. no '.' nor '..'
1441 # at the beginning, at the end, and between slashes.
1442 # also this catches doubled slashes
1443 if ($input =~ m!(^|/)(|\.|\.\.)(/|$)!) {
1446 # no null characters
1447 if ($input =~ m!\0!) {
1453 sub validate_refname {
1454 my $input = shift || return undef;
1456 # textual hashes are O.K.
1457 if ($input =~ m/^[0-9a-fA-F]{40}$/) {
1460 # it must be correct pathname
1461 $input = validate_pathname($input)
1463 # restrictions on ref name according to git-check-ref-format
1464 if ($input =~ m!(/\.|\.\.|[\000-\040\177 ~^:?*\[]|/$)!) {
1470 # decode sequences of octets in utf8 into Perl's internal form,
1471 # which is utf-8 with utf8 flag set if needed. gitweb writes out
1472 # in utf-8 thanks to "binmode STDOUT, ':utf8'" at beginning
1475 return undef unless defined $str;
1477 if (utf8::is_utf8($str) || utf8::decode($str)) {
1480 return decode($fallback_encoding, $str, Encode::FB_DEFAULT);
1484 # quote unsafe chars, but keep the slash, even when it's not
1485 # correct, but quoted slashes look too horrible in bookmarks
1488 return undef unless defined $str;
1489 $str =~ s/([^A-Za-z0-9\-_.~()\/:@ ]+)/CGI::escape($1)/eg;
1494 # the quoting rules for path_info fragment are slightly different
1497 return undef unless defined $str;
1499 # path_info doesn't treat '+' as space (specially), but '?' must be escaped
1500 $str =~ s/([^A-Za-z0-9\-_.~();\/;:@&= +]+)/CGI::escape($1)/eg;
1505 # quote unsafe chars in whole URL, so some characters cannot be quoted
1508 return undef unless defined $str;
1509 $str =~ s/([^A-Za-z0-9\-_.~();\/;?:@&= ]+)/CGI::escape($1)/eg;
1514 # quote unsafe characters in HTML attributes
1517 # for XHTML conformance escaping '"' to '"' is not enough
1518 return esc_html(@_);
1521 # replace invalid utf8 character with SUBSTITUTION sequence
1526 return undef unless defined $str;
1528 $str = to_utf8($str);
1529 $str = $cgi->escapeHTML($str);
1530 if ($opts{'-nbsp'}) {
1531 $str =~ s/ / /g;
1533 $str =~ s|([[:cntrl:]])|(($1 ne "\t") ? quot_cec($1) : $1)|eg;
1537 # quote control characters and escape filename to HTML
1542 return undef unless defined $str;
1544 $str = to_utf8($str);
1545 $str = $cgi->escapeHTML($str);
1546 if ($opts{'-nbsp'}) {
1547 $str =~ s/ / /g;
1549 $str =~ s|([[:cntrl:]])|quot_cec($1)|eg;
1553 # Sanitize for use in XHTML + application/xml+xhtm (valid XML 1.0)
1557 return undef unless defined $str;
1559 $str = to_utf8($str);
1560 $str =~ s|([[:cntrl:]])|($1 =~ /[\t\n\r]/ ? $1 : quot_cec($1))|eg;
1564 # Make control characters "printable", using character escape codes (CEC)
1568 my %es = ( # character escape codes, aka escape sequences
1569 "\t" => '\t', # tab (HT)
1570 "\n" => '\n', # line feed (LF)
1571 "\r" => '\r', # carrige return (CR)
1572 "\f" => '\f', # form feed (FF)
1573 "\b" => '\b', # backspace (BS)
1574 "\a" => '\a', # alarm (bell) (BEL)
1575 "\e" => '\e', # escape (ESC)
1576 "\013" => '\v', # vertical tab (VT)
1577 "\000" => '\0', # nul character (NUL)
1579 my $chr = ( (exists $es{$cntrl})
1581 : sprintf('\%2x', ord($cntrl)) );
1582 if ($opts{-nohtml}) {
1585 return "<span class=\"cntrl\">$chr</span>";
1589 # Alternatively use unicode control pictures codepoints,
1590 # Unicode "printable representation" (PR)
1595 my $chr = sprintf('&#%04d;', 0x2400+ord($cntrl));
1596 if ($opts{-nohtml}) {
1599 return "<span class=\"cntrl\">$chr</span>";
1603 # git may return quoted and escaped filenames
1609 my %es = ( # character escape codes, aka escape sequences
1610 't' => "\t", # tab (HT, TAB)
1611 'n' => "\n", # newline (NL)
1612 'r' => "\r", # return (CR)
1613 'f' => "\f", # form feed (FF)
1614 'b' => "\b", # backspace (BS)
1615 'a' => "\a", # alarm (bell) (BEL)
1616 'e' => "\e", # escape (ESC)
1617 'v' => "\013", # vertical tab (VT)
1620 if ($seq =~ m/^[0-7]{1,3}$/) {
1621 # octal char sequence
1622 return chr(oct($seq));
1623 } elsif (exists $es{$seq}) {
1624 # C escape sequence, aka character escape code
1627 # quoted ordinary character
1631 if ($str =~ m/^"(.*)"$/) {
1634 $str =~ s/\\([^0-7]|[0-7]{1,3})/unq($1)/eg;
1639 # escape tabs (convert tabs to spaces)
1643 while ((my $pos = index($line, "\t")) != -1) {
1644 if (my $count = (8 - ($pos % 8))) {
1645 my $spaces = ' ' x $count;
1646 $line =~ s/\t/$spaces/;
1653 sub project_in_list {
1654 my $project = shift;
1655 my @list = git_get_projects_list();
1656 return @list && scalar(grep { $_->{'path'} eq $project } @list);
1659 ## ----------------------------------------------------------------------
1660 ## HTML aware string manipulation
1662 # Try to chop given string on a word boundary between position
1663 # $len and $len+$add_len. If there is no word boundary there,
1664 # chop at $len+$add_len. Do not chop if chopped part plus ellipsis
1665 # (marking chopped part) would be longer than given string.
1669 my $add_len = shift || 10;
1670 my $where = shift || 'right'; # 'left' | 'center' | 'right'
1672 # Make sure perl knows it is utf8 encoded so we don't
1673 # cut in the middle of a utf8 multibyte char.
1674 $str = to_utf8($str);
1676 # allow only $len chars, but don't cut a word if it would fit in $add_len
1677 # if it doesn't fit, cut it if it's still longer than the dots we would add
1678 # remove chopped character entities entirely
1680 # when chopping in the middle, distribute $len into left and right part
1681 # return early if chopping wouldn't make string shorter
1682 if ($where eq 'center') {
1683 return $str if ($len + 5 >= length($str)); # filler is length 5
1686 return $str if ($len + 4 >= length($str)); # filler is length 4
1689 # regexps: ending and beginning with word part up to $add_len
1690 my $endre = qr/.{$len}\w{0,$add_len}/;
1691 my $begre = qr/\w{0,$add_len}.{$len}/;
1693 if ($where eq 'left') {
1694 $str =~ m/^(.*?)($begre)$/;
1695 my ($lead, $body) = ($1, $2);
1696 if (length($lead) > 4) {
1699 return "$lead$body";
1701 } elsif ($where eq 'center') {
1702 $str =~ m/^($endre)(.*)$/;
1703 my ($left, $str) = ($1, $2);
1704 $str =~ m/^(.*?)($begre)$/;
1705 my ($mid, $right) = ($1, $2);
1706 if (length($mid) > 5) {
1709 return "$left$mid$right";
1712 $str =~ m/^($endre)(.*)$/;
1715 if (length($tail) > 4) {
1718 return "$body$tail";
1722 # takes the same arguments as chop_str, but also wraps a <span> around the
1723 # result with a title attribute if it does get chopped. Additionally, the
1724 # string is HTML-escaped.
1725 sub chop_and_escape_str {
1728 my $chopped = chop_str(@_);
1729 $str = to_utf8($str);
1730 if ($chopped eq $str) {
1731 return esc_html($chopped);
1733 $str =~ s/[[:cntrl:]]/?/g;
1734 return $cgi->span({-title=>$str}, esc_html($chopped));
1738 # Highlight selected fragments of string, using given CSS class,
1739 # and escape HTML. It is assumed that fragments do not overlap.
1740 # Regions are passed as list of pairs (array references).
1742 # Example: esc_html_hl_regions("foobar", "mark", [ 0, 3 ]) returns
1743 # '<span class="mark">foo</span>bar'
1744 sub esc_html_hl_regions {
1745 my ($str, $css_class, @sel) = @_;
1746 my %opts = grep { ref($_) ne 'ARRAY' } @sel;
1747 @sel = grep { ref($_) eq 'ARRAY' } @sel;
1748 return esc_html($str, %opts) unless @sel;
1754 my ($begin, $end) = @$s;
1756 # Don't create empty <span> elements.
1757 next if $end <= $begin;
1759 my $escaped = esc_html(substr($str, $begin, $end - $begin),
1762 $out .= esc_html(substr($str, $pos, $begin - $pos), %opts)
1763 if ($begin - $pos > 0);
1764 $out .= $cgi->span({-class => $css_class}, $escaped);
1768 $out .= esc_html(substr($str, $pos), %opts)
1769 if ($pos < length($str));
1774 # return positions of beginning and end of each match
1776 my ($str, $regexp) = @_;
1777 return unless (defined $str && defined $regexp);
1780 while ($str =~ /$regexp/g) {
1781 push @matches, [$-[0], $+[0]];
1786 # highlight match (if any), and escape HTML
1787 sub esc_html_match_hl {
1788 my ($str, $regexp) = @_;
1789 return esc_html($str) unless defined $regexp;
1791 my @matches = matchpos_list($str, $regexp);
1792 return esc_html($str) unless @matches;
1794 return esc_html_hl_regions($str, 'match', @matches);
1798 # highlight match (if any) of shortened string, and escape HTML
1799 sub esc_html_match_hl_chopped {
1800 my ($str, $chopped, $regexp) = @_;
1801 return esc_html_match_hl($str, $regexp) unless defined $chopped;
1803 my @matches = matchpos_list($str, $regexp);
1804 return esc_html($chopped) unless @matches;
1806 # filter matches so that we mark chopped string
1807 my $tail = "... "; # see chop_str
1808 unless ($chopped =~ s/\Q$tail\E$//) {
1811 my $chop_len = length($chopped);
1812 my $tail_len = length($tail);
1815 for my $m (@matches) {
1816 if ($m->[0] > $chop_len) {
1817 push @filtered, [ $chop_len, $chop_len + $tail_len ] if ($tail_len > 0);
1819 } elsif ($m->[1] > $chop_len) {
1820 push @filtered, [ $m->[0], $chop_len + $tail_len ];
1826 return esc_html_hl_regions($chopped . $tail, 'match', @filtered);
1829 ## ----------------------------------------------------------------------
1830 ## functions returning short strings
1832 # CSS class for given age value (in seconds)
1836 if (!defined $age) {
1838 } elsif ($age < 60*60*2) {
1840 } elsif ($age < 60*60*24*2) {
1847 # convert age in seconds to "nn units ago" string
1852 if ($age > 60*60*24*365*2) {
1853 $age_str = (int $age/60/60/24/365);
1854 $age_str .= " years ago";
1855 } elsif ($age > 60*60*24*(365/12)*2) {
1856 $age_str = int $age/60/60/24/(365/12);
1857 $age_str .= " months ago";
1858 } elsif ($age > 60*60*24*7*2) {
1859 $age_str = int $age/60/60/24/7;
1860 $age_str .= " weeks ago";
1861 } elsif ($age > 60*60*24*2) {
1862 $age_str = int $age/60/60/24;
1863 $age_str .= " days ago";
1864 } elsif ($age > 60*60*2) {
1865 $age_str = int $age/60/60;
1866 $age_str .= " hours ago";
1867 } elsif ($age > 60*2) {
1868 $age_str = int $age/60;
1869 $age_str .= " min ago";
1870 } elsif ($age > 2) {
1871 $age_str = int $age;
1872 $age_str .= " sec ago";
1874 $age_str .= " right now";
1880 S_IFINVALID => 0030000,
1881 S_IFGITLINK => 0160000,
1884 # submodule/subproject, a commit object reference
1888 return (($mode & S_IFMT) == S_IFGITLINK)
1891 # convert file mode in octal to symbolic file mode string
1893 my $mode = oct shift;
1895 if (S_ISGITLINK($mode)) {
1896 return 'm---------';
1897 } elsif (S_ISDIR($mode & S_IFMT)) {
1898 return 'drwxr-xr-x';
1899 } elsif (S_ISLNK($mode)) {
1900 return 'lrwxrwxrwx';
1901 } elsif (S_ISREG($mode)) {
1902 # git cares only about the executable bit
1903 if ($mode & S_IXUSR) {
1904 return '-rwxr-xr-x';
1906 return '-rw-r--r--';
1909 return '----------';
1913 # convert file mode in octal to file type string
1917 if ($mode !~ m/^[0-7]+$/) {
1923 if (S_ISGITLINK($mode)) {
1925 } elsif (S_ISDIR($mode & S_IFMT)) {
1927 } elsif (S_ISLNK($mode)) {
1929 } elsif (S_ISREG($mode)) {
1936 # convert file mode in octal to file type description string
1937 sub file_type_long {
1940 if ($mode !~ m/^[0-7]+$/) {
1946 if (S_ISGITLINK($mode)) {
1948 } elsif (S_ISDIR($mode & S_IFMT)) {
1950 } elsif (S_ISLNK($mode)) {
1952 } elsif (S_ISREG($mode)) {
1953 if ($mode & S_IXUSR) {
1954 return "executable";
1964 ## ----------------------------------------------------------------------
1965 ## functions returning short HTML fragments, or transforming HTML fragments
1966 ## which don't belong to other sections
1968 # format line of commit message.
1969 sub format_log_line_html {
1972 $line = esc_html($line, -nbsp=>1);
1973 $line =~ s{\b([0-9a-fA-F]{8,40})\b}{
1974 $cgi->a({-href => href(action=>"object", hash=>$1),
1975 -class => "text"}, $1);
1981 # format marker of refs pointing to given object
1983 # the destination action is chosen based on object type and current context:
1984 # - for annotated tags, we choose the tag view unless it's the current view
1985 # already, in which case we go to shortlog view
1986 # - for other refs, we keep the current view if we're in history, shortlog or
1987 # log view, and select shortlog otherwise
1988 sub format_ref_marker {
1989 my ($refs, $id) = @_;
1992 if (defined $refs->{$id}) {
1993 foreach my $ref (@{$refs->{$id}}) {
1994 # this code exploits the fact that non-lightweight tags are the
1995 # only indirect objects, and that they are the only objects for which
1996 # we want to use tag instead of shortlog as action
1997 my ($type, $name) = qw();
1998 my $indirect = ($ref =~ s/\^\{\}$//);
1999 # e.g. tags/v2.6.11 or heads/next
2000 if ($ref =~ m!^(.*?)s?/(.*)$!) {
2009 $class .= " indirect" if $indirect;
2011 my $dest_action = "shortlog";
2014 $dest_action = "tag" unless $action eq "tag";
2015 } elsif ($action =~ /^(history|(short)?log)$/) {
2016 $dest_action = $action;
2020 $dest .= "refs/" unless $ref =~ m!^refs/!;
2023 my $link = $cgi->a({
2025 action=>$dest_action,
2029 $markers .= " <span class=\"".esc_attr($class)."\" title=\"".esc_attr($ref)."\">" .
2035 return ' <span class="refs">'. $markers . '</span>';
2041 # format, perhaps shortened and with markers, title line
2042 sub format_subject_html {
2043 my ($long, $short, $href, $extra) = @_;
2044 $extra = '' unless defined($extra);
2046 if (length($short) < length($long)) {
2047 $long =~ s/[[:cntrl:]]/?/g;
2048 return $cgi->a({-href => $href, -class => "list subject",
2049 -title => to_utf8($long)},
2050 esc_html($short)) . $extra;
2052 return $cgi->a({-href => $href, -class => "list subject"},
2053 esc_html($long)) . $extra;
2057 # Rather than recomputing the url for an email multiple times, we cache it
2058 # after the first hit. This gives a visible benefit in views where the avatar
2059 # for the same email is used repeatedly (e.g. shortlog).
2060 # The cache is shared by all avatar engines (currently gravatar only), which
2061 # are free to use it as preferred. Since only one avatar engine is used for any
2062 # given page, there's no risk for cache conflicts.
2063 our %avatar_cache = ();
2065 # Compute the picon url for a given email, by using the picon search service over at
2066 # http://www.cs.indiana.edu/picons/search.html
2068 my $email = lc shift;
2069 if (!$avatar_cache{$email}) {
2070 my ($user, $domain) = split('@', $email);
2071 $avatar_cache{$email} =
2072 "http://www.cs.indiana.edu/cgi-pub/kinzler/piconsearch.cgi/" .
2074 "users+domains+unknown/up/single";
2076 return $avatar_cache{$email};
2079 # Compute the gravatar url for a given email, if it's not in the cache already.
2080 # Gravatar stores only the part of the URL before the size, since that's the
2081 # one computationally more expensive. This also allows reuse of the cache for
2082 # different sizes (for this particular engine).
2084 my $email = lc shift;
2086 $avatar_cache{$email} ||=
2087 "http://www.gravatar.com/avatar/" .
2088 Digest::MD5::md5_hex($email) . "?s=";
2089 return $avatar_cache{$email} . $size;
2092 # Insert an avatar for the given $email at the given $size if the feature
2094 sub git_get_avatar {
2095 my ($email, %opts) = @_;
2096 my $pre_white = ($opts{-pad_before} ? " " : "");
2097 my $post_white = ($opts{-pad_after} ? " " : "");
2098 $opts{-size} ||= 'default';
2099 my $size = $avatar_size{$opts{-size}} || $avatar_size{'default'};
2101 if ($git_avatar eq 'gravatar') {
2102 $url = gravatar_url($email, $size);
2103 } elsif ($git_avatar eq 'picon') {
2104 $url = picon_url($email);
2106 # Other providers can be added by extending the if chain, defining $url
2107 # as needed. If no variant puts something in $url, we assume avatars
2108 # are completely disabled/unavailable.
2111 "<img width=\"$size\" " .
2112 "class=\"avatar\" " .
2113 "src=\"".esc_url($url)."\" " .
2121 sub format_search_author {
2122 my ($author, $searchtype, $displaytext) = @_;
2123 my $have_search = gitweb_check_feature('search');
2127 if ($searchtype eq 'author') {
2128 $performed = "authored";
2129 } elsif ($searchtype eq 'committer') {
2130 $performed = "committed";
2133 return $cgi->a({-href => href(action=>"search", hash=>$hash,
2134 searchtext=>$author,
2135 searchtype=>$searchtype), class=>"list",
2136 title=>"Search for commits $performed by $author"},
2140 return $displaytext;
2144 # format the author name of the given commit with the given tag
2145 # the author name is chopped and escaped according to the other
2146 # optional parameters (see chop_str).
2147 sub format_author_html {
2150 my $author = chop_and_escape_str($co->{'author_name'}, @_);
2151 return "<$tag class=\"author\">" .
2152 format_search_author($co->{'author_name'}, "author",
2153 git_get_avatar($co->{'author_email'}, -pad_after => 1) .
2158 # format git diff header line, i.e. "diff --(git|combined|cc) ..."
2159 sub format_git_diff_header_line {
2161 my $diffinfo = shift;
2162 my ($from, $to) = @_;
2164 if ($diffinfo->{'nparents'}) {
2166 $line =~ s!^(diff (.*?) )"?.*$!$1!;
2167 if ($to->{'href'}) {
2168 $line .= $cgi->a({-href => $to->{'href'}, -class => "path"},
2169 esc_path($to->{'file'}));
2170 } else { # file was deleted (no href)
2171 $line .= esc_path($to->{'file'});
2175 $line =~ s!^(diff (.*?) )"?a/.*$!$1!;
2176 if ($from->{'href'}) {
2177 $line .= $cgi->a({-href => $from->{'href'}, -class => "path"},
2178 'a/' . esc_path($from->{'file'}));
2179 } else { # file was added (no href)
2180 $line .= 'a/' . esc_path($from->{'file'});
2183 if ($to->{'href'}) {
2184 $line .= $cgi->a({-href => $to->{'href'}, -class => "path"},
2185 'b/' . esc_path($to->{'file'}));
2186 } else { # file was deleted
2187 $line .= 'b/' . esc_path($to->{'file'});
2191 return "<div class=\"diff header\">$line</div>\n";
2194 # format extended diff header line, before patch itself
2195 sub format_extended_diff_header_line {
2197 my $diffinfo = shift;
2198 my ($from, $to) = @_;
2201 if ($line =~ s!^((copy|rename) from ).*$!$1! && $from->{'href'}) {
2202 $line .= $cgi->a({-href=>$from->{'href'}, -class=>"path"},
2203 esc_path($from->{'file'}));
2205 if ($line =~ s!^((copy|rename) to ).*$!$1! && $to->{'href'}) {
2206 $line .= $cgi->a({-href=>$to->{'href'}, -class=>"path"},
2207 esc_path($to->{'file'}));
2209 # match single <mode>
2210 if ($line =~ m/\s(\d{6})$/) {
2211 $line .= '<span class="info"> (' .
2212 file_type_long($1) .
2216 if ($line =~ m/^index [0-9a-fA-F]{40},[0-9a-fA-F]{40}/) {
2217 # can match only for combined diff
2219 for (my $i = 0; $i < $diffinfo->{'nparents'}; $i++) {
2220 if ($from->{'href'}[$i]) {
2221 $line .= $cgi->a({-href=>$from->{'href'}[$i],
2223 substr($diffinfo->{'from_id'}[$i],0,7));
2228 $line .= ',' if ($i < $diffinfo->{'nparents'} - 1);
2231 if ($to->{'href'}) {
2232 $line .= $cgi->a({-href=>$to->{'href'}, -class=>"hash"},
2233 substr($diffinfo->{'to_id'},0,7));
2238 } elsif ($line =~ m/^index [0-9a-fA-F]{40}..[0-9a-fA-F]{40}/) {
2239 # can match only for ordinary diff
2240 my ($from_link, $to_link);
2241 if ($from->{'href'}) {
2242 $from_link = $cgi->a({-href=>$from->{'href'}, -class=>"hash"},
2243 substr($diffinfo->{'from_id'},0,7));
2245 $from_link = '0' x 7;
2247 if ($to->{'href'}) {
2248 $to_link = $cgi->a({-href=>$to->{'href'}, -class=>"hash"},
2249 substr($diffinfo->{'to_id'},0,7));
2253 my ($from_id, $to_id) = ($diffinfo->{'from_id'}, $diffinfo->{'to_id'});
2254 $line =~ s!$from_id\.\.$to_id!$from_link..$to_link!;
2257 return $line . "<br/>\n";
2260 # format from-file/to-file diff header
2261 sub format_diff_from_to_header {
2262 my ($from_line, $to_line, $diffinfo, $from, $to, @parents) = @_;
2267 #assert($line =~ m/^---/) if DEBUG;
2268 # no extra formatting for "^--- /dev/null"
2269 if (! $diffinfo->{'nparents'}) {
2270 # ordinary (single parent) diff
2271 if ($line =~ m!^--- "?a/!) {
2272 if ($from->{'href'}) {
2274 $cgi->a({-href=>$from->{'href'}, -class=>"path"},
2275 esc_path($from->{'file'}));
2278 esc_path($from->{'file'});
2281 $result .= qq!<div class="diff from_file">$line</div>\n!;
2284 # combined diff (merge commit)
2285 for (my $i = 0; $i < $diffinfo->{'nparents'}; $i++) {
2286 if ($from->{'href'}[$i]) {
2288 $cgi->a({-href=>href(action=>"blobdiff",
2289 hash_parent=>$diffinfo->{'from_id'}[$i],
2290 hash_parent_base=>$parents[$i],
2291 file_parent=>$from->{'file'}[$i],
2292 hash=>$diffinfo->{'to_id'},
2294 file_name=>$to->{'file'}),
2296 -title=>"diff" . ($i+1)},
2299 $cgi->a({-href=>$from->{'href'}[$i], -class=>"path"},
2300 esc_path($from->{'file'}[$i]));
2302 $line = '--- /dev/null';
2304 $result .= qq!<div class="diff from_file">$line</div>\n!;
2309 #assert($line =~ m/^\+\+\+/) if DEBUG;
2310 # no extra formatting for "^+++ /dev/null"
2311 if ($line =~ m!^\+\+\+ "?b/!) {
2312 if ($to->{'href'}) {
2314 $cgi->a({-href=>$to->{'href'}, -class=>"path"},
2315 esc_path($to->{'file'}));
2318 esc_path($to->{'file'});
2321 $result .= qq!<div class="diff to_file">$line</div>\n!;
2326 # create note for patch simplified by combined diff
2327 sub format_diff_cc_simplified {
2328 my ($diffinfo, @parents) = @_;
2331 $result .= "<div class=\"diff header\">" .
2333 if (!is_deleted($diffinfo)) {
2334 $result .= $cgi->a({-href => href(action=>"blob",
2336 hash=>$diffinfo->{'to_id'},
2337 file_name=>$diffinfo->{'to_file'}),
2339 esc_path($diffinfo->{'to_file'}));
2341 $result .= esc_path($diffinfo->{'to_file'});
2343 $result .= "</div>\n" . # class="diff header"
2344 "<div class=\"diff nodifferences\">" .
2346 "</div>\n"; # class="diff nodifferences"
2351 sub diff_line_class {
2352 my ($line, $from, $to) = @_;
2357 if ($from && $to && ref($from->{'href'}) eq "ARRAY") {
2358 $num_sign = scalar @{$from->{'href'}};
2361 my @diff_line_classifier = (
2362 { regexp => qr/^\@\@{$num_sign} /, class => "chunk_header"},
2363 { regexp => qr/^\\/, class => "incomplete" },
2364 { regexp => qr/^ {$num_sign}/, class => "ctx" },
2365 # classifier for context must come before classifier add/rem,
2366 # or we would have to use more complicated regexp, for example
2367 # qr/(?= {0,$m}\+)[+ ]{$num_sign}/, where $m = $num_sign - 1;
2368 { regexp => qr/^[+ ]{$num_sign}/, class => "add" },
2369 { regexp => qr/^[- ]{$num_sign}/, class => "rem" },
2371 for my $clsfy (@diff_line_classifier) {
2372 return $clsfy->{'class'}
2373 if ($line =~ $clsfy->{'regexp'});
2380 # assumes that $from and $to are defined and correctly filled,
2381 # and that $line holds a line of chunk header for unified diff
2382 sub format_unidiff_chunk_header {
2383 my ($line, $from, $to) = @_;
2385 my ($from_text, $from_start, $from_lines, $to_text, $to_start, $to_lines, $section) =
2386 $line =~ m/^\@{2} (-(\d+)(?:,(\d+))?) (\+(\d+)(?:,(\d+))?) \@{2}(.*)$/;
2388 $from_lines = 0 unless defined $from_lines;
2389 $to_lines = 0 unless defined $to_lines;
2391 if ($from->{'href'}) {
2392 $from_text = $cgi->a({-href=>"$from->{'href'}#l$from_start",
2393 -class=>"list"}, $from_text);
2395 if ($to->{'href'}) {
2396 $to_text = $cgi->a({-href=>"$to->{'href'}#l$to_start",
2397 -class=>"list"}, $to_text);
2399 $line = "<span class=\"chunk_info\">@@ $from_text $to_text @@</span>" .
2400 "<span class=\"section\">" . esc_html($section, -nbsp=>1) . "</span>";
2404 # assumes that $from and $to are defined and correctly filled,
2405 # and that $line holds a line of chunk header for combined diff
2406 sub format_cc_diff_chunk_header {
2407 my ($line, $from, $to) = @_;
2409 my ($prefix, $ranges, $section) = $line =~ m/^(\@+) (.*?) \@+(.*)$/;
2410 my (@from_text, @from_start, @from_nlines, $to_text, $to_start, $to_nlines);
2412 @from_text = split(' ', $ranges);
2413 for (my $i = 0; $i < @from_text; ++$i) {
2414 ($from_start[$i], $from_nlines[$i]) =
2415 (split(',', substr($from_text[$i], 1)), 0);
2418 $to_text = pop @from_text;
2419 $to_start = pop @from_start;
2420 $to_nlines = pop @from_nlines;
2422 $line = "<span class=\"chunk_info\">$prefix ";
2423 for (my $i = 0; $i < @from_text; ++$i) {
2424 if ($from->{'href'}[$i]) {
2425 $line .= $cgi->a({-href=>"$from->{'href'}[$i]#l$from_start[$i]",
2426 -class=>"list"}, $from_text[$i]);
2428 $line .= $from_text[$i];
2432 if ($to->{'href'}) {
2433 $line .= $cgi->a({-href=>"$to->{'href'}#l$to_start",
2434 -class=>"list"}, $to_text);
2438 $line .= " $prefix</span>" .
2439 "<span class=\"section\">" . esc_html($section, -nbsp=>1) . "</span>";
2443 # process patch (diff) line (not to be used for diff headers),
2444 # returning HTML-formatted (but not wrapped) line.
2445 # If the line is passed as a reference, it is treated as HTML and not
2447 sub format_diff_line {
2448 my ($line, $diff_class, $from, $to) = @_;
2454 $line = untabify($line);
2456 if ($from && $to && $line =~ m/^\@{2} /) {
2457 $line = format_unidiff_chunk_header($line, $from, $to);
2458 } elsif ($from && $to && $line =~ m/^\@{3}/) {
2459 $line = format_cc_diff_chunk_header($line, $from, $to);
2461 $line = esc_html($line, -nbsp=>1);
2465 my $diff_classes = "diff";
2466 $diff_classes .= " $diff_class" if ($diff_class);
2467 $line = "<div class=\"$diff_classes\">$line</div>\n";
2472 # Generates undef or something like "_snapshot_" or "snapshot (_tbz2_ _zip_)",
2473 # linked. Pass the hash of the tree/commit to snapshot.
2474 sub format_snapshot_links {
2476 my $num_fmts = @snapshot_fmts;
2477 if ($num_fmts > 1) {
2478 # A parenthesized list of links bearing format names.
2479 # e.g. "snapshot (_tar.gz_ _zip_)"
2480 return "snapshot (" . join(' ', map
2487 }, $known_snapshot_formats{$_}{'display'})
2488 , @snapshot_fmts) . ")";
2489 } elsif ($num_fmts == 1) {
2490 # A single "snapshot" link whose tooltip bears the format name.
2492 my ($fmt) = @snapshot_fmts;
2498 snapshot_format=>$fmt
2500 -title => "in format: $known_snapshot_formats{$fmt}{'display'}"
2502 } else { # $num_fmts == 0
2507 ## ......................................................................
2508 ## functions returning values to be passed, perhaps after some
2509 ## transformation, to other functions; e.g. returning arguments to href()
2511 # returns hash to be passed to href to generate gitweb URL
2512 # in -title key it returns description of link
2514 my $format = shift || 'Atom';
2515 my %res = (action => lc($format));
2517 # feed links are possible only for project views
2518 return unless (defined $project);
2519 # some views should link to OPML, or to generic project feed,
2520 # or don't have specific feed yet (so they should use generic)
2521 return if (!$action || $action =~ /^(?:tags|heads|forks|tag|search)$/x);
2524 # branches refs uses 'refs/heads/' prefix (fullname) to differentiate
2525 # from tag links; this also makes possible to detect branch links
2526 if ((defined $hash_base && $hash_base =~ m!^refs/heads/(.*)$!) ||
2527 (defined $hash && $hash =~ m!^refs/heads/(.*)$!)) {
2530 # find log type for feed description (title)
2532 if (defined $file_name) {
2533 $type = "history of $file_name";
2534 $type .= "/" if ($action eq 'tree');
2535 $type .= " on '$branch'" if (defined $branch);
2537 $type = "log of $branch" if (defined $branch);
2540 $res{-title} = $type;
2541 $res{'hash'} = (defined $branch ? "refs/heads/$branch" : undef);
2542 $res{'file_name'} = $file_name;
2547 ## ----------------------------------------------------------------------
2548 ## git utility subroutines, invoking git commands
2550 # returns path to the core git executable and the --git-dir parameter as list
2552 $number_of_git_cmds++;
2553 return $GIT, '--git-dir='.$git_dir;
2556 # quote the given arguments for passing them to the shell
2557 # quote_command("command", "arg 1", "arg with ' and ! characters")
2558 # => "'command' 'arg 1' 'arg with '\'' and '\!' characters'"
2559 # Try to avoid using this function wherever possible.
2562 map { my $a = $_; $a =~ s/(['!])/'\\$1'/g; "'$a'" } @_ );
2565 # get HEAD ref of given project as hash
2566 sub git_get_head_hash {
2567 return git_get_full_hash(shift, 'HEAD');
2570 sub git_get_full_hash {
2571 return git_get_hash(@_);
2574 sub git_get_short_hash {
2575 return git_get_hash(@_, '--short=7');
2579 my ($project, $hash, @options) = @_;
2580 my $o_git_dir = $git_dir;
2582 $git_dir = "$projectroot/$project";
2583 if (open my $fd, '-|', git_cmd(), 'rev-parse',
2584 '--verify', '-q', @options, $hash) {
2586 chomp $retval if defined $retval;
2589 if (defined $o_git_dir) {
2590 $git_dir = $o_git_dir;
2595 # get type of given object
2599 open my $fd, "-|", git_cmd(), "cat-file", '-t', $hash or return;
2601 close $fd or return;
2606 # repository configuration
2607 our $config_file = '';
2610 # store multiple values for single key as anonymous array reference
2611 # single values stored directly in the hash, not as [ <value> ]
2612 sub hash_set_multi {
2613 my ($hash, $key, $value) = @_;
2615 if (!exists $hash->{$key}) {
2616 $hash->{$key} = $value;
2617 } elsif (!ref $hash->{$key}) {
2618 $hash->{$key} = [ $hash->{$key}, $value ];
2620 push @{$hash->{$key}}, $value;
2624 # return hash of git project configuration
2625 # optionally limited to some section, e.g. 'gitweb'
2626 sub git_parse_project_config {
2627 my $section_regexp = shift;
2632 open my $fh, "-|", git_cmd(), "config", '-z', '-l',
2635 while (my $keyval = <$fh>) {
2637 my ($key, $value) = split(/\n/, $keyval, 2);
2639 hash_set_multi(\%config, $key, $value)
2640 if (!defined $section_regexp || $key =~ /^(?:$section_regexp)\./o);
2647 # convert config value to boolean: 'true' or 'false'
2648 # no value, number > 0, 'true' and 'yes' values are true
2649 # rest of values are treated as false (never as error)
2650 sub config_to_bool {
2653 return 1 if !defined $val; # section.key
2655 # strip leading and trailing whitespace
2659 return (($val =~ /^\d+$/ && $val) || # section.key = 1
2660 ($val =~ /^(?:true|yes)$/i)); # section.key = true
2663 # convert config value to simple decimal number
2664 # an optional value suffix of 'k', 'm', or 'g' will cause the value
2665 # to be multiplied by 1024, 1048576, or 1073741824
2669 # strip leading and trailing whitespace
2673 if (my ($num, $unit) = ($val =~ /^([0-9]*)([kmg])$/i)) {
2675 # unknown unit is treated as 1
2676 return $num * ($unit eq 'g' ? 1073741824 :
2677 $unit eq 'm' ? 1048576 :
2678 $unit eq 'k' ? 1024 : 1);
2683 # convert config value to array reference, if needed
2684 sub config_to_multi {
2687 return ref($val) ? $val : (defined($val) ? [ $val ] : []);
2690 sub git_get_project_config {
2691 my ($key, $type) = @_;
2693 return unless defined $git_dir;
2696 return unless ($key);
2697 # only subsection, if exists, is case sensitive,
2698 # and not lowercased by 'git config -z -l'
2699 if (my ($hi, $mi, $lo) = ($key =~ /^([^.]*)\.(.*)\.([^.]*)$/)) {
2700 $key = join(".", lc($hi), $mi, lc($lo));
2704 $key =~ s/^gitweb\.//;
2705 return if ($key =~ m/\W/);
2708 if (defined $type) {
2711 unless ($type eq 'bool' || $type eq 'int');
2715 if (!defined $config_file ||
2716 $config_file ne "$git_dir/config") {
2717 %config = git_parse_project_config('gitweb');
2718 $config_file = "$git_dir/config";
2721 # check if config variable (key) exists
2722 return unless exists $config{"gitweb.$key"};
2725 if (!defined $type) {
2726 return $config{"gitweb.$key"};
2727 } elsif ($type eq 'bool') {
2728 # backward compatibility: 'git config --bool' returns true/false
2729 return config_to_bool($config{"gitweb.$key"}) ? 'true' : 'false';
2730 } elsif ($type eq 'int') {
2731 return config_to_int($config{"gitweb.$key"});
2733 return $config{"gitweb.$key"};
2736 # get hash of given path at given ref
2737 sub git_get_hash_by_path {
2739 my $path = shift || return undef;
2744 open my $fd, "-|", git_cmd(), "ls-tree", $base, "--", $path
2745 or die_error(500, "Open git-ls-tree failed");
2747 close $fd or return undef;
2749 if (!defined $line) {
2750 # there is no tree or hash given by $path at $base
2754 #'100644 blob 0fa3f3a66fb6a137f6ec2c19351ed4d807070ffa panic.c'
2755 $line =~ m/^([0-9]+) (.+) ([0-9a-fA-F]{40})\t/;
2756 if (defined $type && $type ne $2) {
2757 # type doesn't match
2763 # get path of entry with given hash at given tree-ish (ref)
2764 # used to get 'from' filename for combined diff (merge commit) for renames
2765 sub git_get_path_by_hash {
2766 my $base = shift || return;
2767 my $hash = shift || return;
2771 open my $fd, "-|", git_cmd(), "ls-tree", '-r', '-t', '-z', $base
2773 while (my $line = <$fd>) {
2776 #'040000 tree 595596a6a9117ddba9fe379b6b012b558bac8423 gitweb'
2777 #'100644 blob e02e90f0429be0d2a69b76571101f20b8f75530f gitweb/README'
2778 if ($line =~ m/(?:[0-9]+) (?:.+) $hash\t(.+)$/) {
2787 ## ......................................................................
2788 ## git utility functions, directly accessing git repository
2790 # get the value of config variable either from file named as the variable
2791 # itself in the repository ($GIT_DIR/$name file), or from gitweb.$name
2792 # configuration variable in the repository config file.
2793 sub git_get_file_or_project_config {
2794 my ($path, $name) = @_;
2796 $git_dir = "$projectroot/$path";
2797 open my $fd, '<', "$git_dir/$name"
2798 or return git_get_project_config($name);
2801 if (defined $conf) {
2807 sub git_get_project_description {
2809 return git_get_file_or_project_config($path, 'description');
2812 sub git_get_project_category {
2814 return git_get_file_or_project_config($path, 'category');
2818 # supported formats:
2819 # * $GIT_DIR/ctags/<tagname> file (in 'ctags' subdirectory)
2820 # - if its contents is a number, use it as tag weight,
2821 # - otherwise add a tag with weight 1
2822 # * $GIT_DIR/ctags file, each line is a tag (with weight 1)
2823 # the same value multiple times increases tag weight
2824 # * `gitweb.ctag' multi-valued repo config variable
2825 sub git_get_project_ctags {
2826 my $project = shift;
2829 $git_dir = "$projectroot/$project";
2830 if (opendir my $dh, "$git_dir/ctags") {
2831 my @files = grep { -f $_ } map { "$git_dir/ctags/$_" } readdir($dh);
2832 foreach my $tagfile (@files) {
2833 open my $ct, '<', $tagfile
2839 (my $ctag = $tagfile) =~ s#.*/##;
2840 if ($val =~ /^\d+$/) {
2841 $ctags->{$ctag} = $val;
2843 $ctags->{$ctag} = 1;
2848 } elsif (open my $fh, '<', "$git_dir/ctags") {
2849 while (my $line = <$fh>) {
2851 $ctags->{$line}++ if $line;
2856 my $taglist = config_to_multi(git_get_project_config('ctag'));
2857 foreach my $tag (@$taglist) {
2865 # return hash, where keys are content tags ('ctags'),
2866 # and values are sum of weights of given tag in every project
2867 sub git_gather_all_ctags {
2868 my $projects = shift;
2871 foreach my $p (@$projects) {
2872 foreach my $ct (keys %{$p->{'ctags'}}) {
2873 $ctags->{$ct} += $p->{'ctags'}->{$ct};
2880 sub git_populate_project_tagcloud {
2883 # First, merge different-cased tags; tags vote on casing
2885 foreach (keys %$ctags) {
2886 $ctags_lc{lc $_}->{count} += $ctags->{$_};
2887 if (not $ctags_lc{lc $_}->{topcount}
2888 or $ctags_lc{lc $_}->{topcount} < $ctags->{$_}) {
2889 $ctags_lc{lc $_}->{topcount} = $ctags->{$_};
2890 $ctags_lc{lc $_}->{topname} = $_;
2895 my $matched = $input_params{'ctag'};
2896 if (eval { require HTML::TagCloud; 1; }) {
2897 $cloud = HTML::TagCloud->new;
2898 foreach my $ctag (sort keys %ctags_lc) {
2899 # Pad the title with spaces so that the cloud looks
2901 my $title = esc_html($ctags_lc{$ctag}->{topname});
2902 $title =~ s/ / /g;
2903 $title =~ s/^/ /g;
2904 $title =~ s/$/ /g;
2905 if (defined $matched && $matched eq $ctag) {
2906 $title = qq(<span class="match">$title</span>);
2908 $cloud->add($title, href(project=>undef, ctag=>$ctag),
2909 $ctags_lc{$ctag}->{count});
2913 foreach my $ctag (keys %ctags_lc) {
2914 my $title = esc_html($ctags_lc{$ctag}->{topname}, -nbsp=>1);
2915 if (defined $matched && $matched eq $ctag) {
2916 $title = qq(<span class="match">$title</span>);
2918 $cloud->{$ctag}{count} = $ctags_lc{$ctag}->{count};
2919 $cloud->{$ctag}{ctag} =
2920 $cgi->a({-href=>href(project=>undef, ctag=>$ctag)}, $title);
2926 sub git_show_project_tagcloud {
2927 my ($cloud, $count) = @_;
2928 if (ref $cloud eq 'HTML::TagCloud') {
2929 return $cloud->html_and_css($count);
2931 my @tags = sort { $cloud->{$a}->{'count'} <=> $cloud->{$b}->{'count'} } keys %$cloud;
2933 '<div id="htmltagcloud"'.($project ? '' : ' align="center"').'>' .
2935 $cloud->{$_}->{'ctag'}
2936 } splice(@tags, 0, $count)) .
2941 sub git_get_project_url_list {
2944 $git_dir = "$projectroot/$path";
2945 open my $fd, '<', "$git_dir/cloneurl"
2946 or return wantarray ?
2947 @{ config_to_multi(git_get_project_config('url')) } :
2948 config_to_multi(git_get_project_config('url'));
2949 my @git_project_url_list = map { chomp; $_ } <$fd>;
2952 return wantarray ? @git_project_url_list : \@git_project_url_list;
2955 sub git_get_projects_list {
2956 my $filter = shift || '';
2957 my $paranoid = shift;
2960 if (-d $projects_list) {
2961 # search in directory
2962 my $dir = $projects_list;
2963 # remove the trailing "/"
2965 my $pfxlen = length("$dir");
2966 my $pfxdepth = ($dir =~ tr!/!!);
2967 # when filtering, search only given subdirectory
2968 if ($filter && !$paranoid) {
2974 follow_fast => 1, # follow symbolic links
2975 follow_skip => 2, # ignore duplicates
2976 dangling_symlinks => 0, # ignore dangling symlinks, silently
2979 our $project_maxdepth;
2981 # skip project-list toplevel, if we get it.
2982 return if (m!^[/.]$!);
2983 # only directories can be git repositories
2984 return unless (-d $_);
2985 # don't traverse too deep (Find is super slow on os x)
2986 # $project_maxdepth excludes depth of $projectroot
2987 if (($File::Find::name =~ tr!/!!) - $pfxdepth > $project_maxdepth) {
2988 $File::Find::prune = 1;
2992 my $path = substr($File::Find::name, $pfxlen + 1);
2993 # paranoidly only filter here
2994 if ($paranoid && $filter && $path !~ m!^\Q$filter\E/!) {
2997 # we check related file in $projectroot
2998 if (check_export_ok("$projectroot/$path")) {
2999 push @list, { path => $path };
3000 $File::Find::prune = 1;
3005 } elsif (-f $projects_list) {
3006 # read from file(url-encoded):
3007 # 'git%2Fgit.git Linus+Torvalds'
3008 # 'libs%2Fklibc%2Fklibc.git H.+Peter+Anvin'
3009 # 'linux%2Fhotplug%2Fudev.git Greg+Kroah-Hartman'
3010 open my $fd, '<', $projects_list or return;
3012 while (my $line = <$fd>) {
3014 my ($path, $owner) = split ' ', $line;
3015 $path = unescape($path);
3016 $owner = unescape($owner);
3017 if (!defined $path) {
3020 # if $filter is rpovided, check if $path begins with $filter
3021 if ($filter && $path !~ m!^\Q$filter\E/!) {
3024 if (check_export_ok("$projectroot/$path")) {
3029 $pr->{'owner'} = to_utf8($owner);
3039 # written with help of Tree::Trie module (Perl Artistic License, GPL compatibile)
3040 # as side effects it sets 'forks' field to list of forks for forked projects
3041 sub filter_forks_from_projects_list {
3042 my $projects = shift;
3044 my %trie; # prefix tree of directories (path components)
3045 # generate trie out of those directories that might contain forks
3046 foreach my $pr (@$projects) {
3047 my $path = $pr->{'path'};
3048 $path =~ s/\.git$//; # forks of 'repo.git' are in 'repo/' directory
3049 next if ($path =~ m!/$!); # skip non-bare repositories, e.g. 'repo/.git'
3050 next unless ($path); # skip '.git' repository: tests, git-instaweb
3051 next unless (-d "$projectroot/$path"); # containing directory exists
3052 $pr->{'forks'} = []; # there can be 0 or more forks of project
3055 my @dirs = split('/', $path);
3056 # walk the trie, until either runs out of components or out of trie
3058 while (scalar @dirs &&
3059 exists($ref->{$dirs[0]})) {
3060 $ref = $ref->{shift @dirs};
3062 # create rest of trie structure from rest of components
3063 foreach my $dir (@dirs) {
3064 $ref = $ref->{$dir} = {};
3066 # create end marker, store $pr as a data
3067 $ref->{''} = $pr if (!exists $ref->{''});
3070 # filter out forks, by finding shortest prefix match for paths
3073 foreach my $pr (@$projects) {
3077 foreach my $dir (split('/', $pr->{'path'})) {
3078 if (exists $ref->{''}) {
3079 # found [shortest] prefix, is a fork - skip it
3080 push @{$ref->{''}{'forks'}}, $pr;
3083 if (!exists $ref->{$dir}) {
3084 # not in trie, cannot have prefix, not a fork
3085 push @filtered, $pr;
3088 # If the dir is there, we just walk one step down the trie.
3089 $ref = $ref->{$dir};
3091 # we ran out of trie
3092 # (shouldn't happen: it's either no match, or end marker)
3093 push @filtered, $pr;
3099 # note: fill_project_list_info must be run first,
3100 # for 'descr_long' and 'ctags' to be filled
3101 sub search_projects_list {
3102 my ($projlist, %opts) = @_;
3103 my $tagfilter = $opts{'tagfilter'};
3104 my $search_re = $opts{'search_regexp'};
3107 unless ($tagfilter || $search_re);
3109 # searching projects require filling to be run before it;
3110 fill_project_list_info($projlist,
3111 $tagfilter ? 'ctags' : (),
3112 $search_re ? ('path', 'descr') : ());
3115 foreach my $pr (@$projlist) {
3118 next unless ref($pr->{'ctags'}) eq 'HASH';
3120 grep { lc($_) eq lc($tagfilter) } keys %{$pr->{'ctags'}};
3125 $pr->{'path'} =~ /$search_re/ ||
3126 $pr->{'descr_long'} =~ /$search_re/;
3129 push @projects, $pr;
3135 our $gitweb_project_owner = undef;
3136 sub git_get_project_list_from_file {
3138 return if (defined $gitweb_project_owner);
3140 $gitweb_project_owner = {};
3141 # read from file (url-encoded):
3142 # 'git%2Fgit.git Linus+Torvalds'
3143 # 'libs%2Fklibc%2Fklibc.git H.+Peter+Anvin'
3144 # 'linux%2Fhotplug%2Fudev.git Greg+Kroah-Hartman'
3145 if (-f $projects_list) {
3146 open(my $fd, '<', $projects_list);
3147 while (my $line = <$fd>) {
3149 my ($pr, $ow) = split ' ', $line;
3150 $pr = unescape($pr);
3151 $ow = unescape($ow);
3152 $gitweb_project_owner->{$pr} = to_utf8($ow);
3158 sub git_get_project_owner {
3159 my $project = shift;
3162 return undef unless $project;
3163 $git_dir = "$projectroot/$project";
3165 if (!defined $gitweb_project_owner) {
3166 git_get_project_list_from_file();
3169 if (exists $gitweb_project_owner->{$project}) {
3170 $owner = $gitweb_project_owner->{$project};
3172 if (!defined $owner){
3173 $owner = git_get_project_config('owner');
3175 if (!defined $owner) {
3176 $owner = get_file_owner("$git_dir");
3182 sub git_get_last_activity {
3186 $git_dir = "$projectroot/$path";
3187 open($fd, "-|", git_cmd(), 'for-each-ref',
3188 '--format=%(committer)',
3189 '--sort=-committerdate',
3191 'refs/heads') or return;
3192 my $most_recent = <$fd>;
3193 close $fd or return;
3194 if (defined $most_recent &&
3195 $most_recent =~ / (\d+) [-+][01]\d\d\d$/) {
3197 my $age = time - $timestamp;
3198 return ($age, age_string($age));
3200 return (undef, undef);
3203 # Implementation note: when a single remote is wanted, we cannot use 'git
3204 # remote show -n' because that command always work (assuming it's a remote URL
3205 # if it's not defined), and we cannot use 'git remote show' because that would
3206 # try to make a network roundtrip. So the only way to find if that particular
3207 # remote is defined is to walk the list provided by 'git remote -v' and stop if
3208 # and when we find what we want.
3209 sub git_get_remotes_list {
3213 open my $fd, '-|' , git_cmd(), 'remote', '-v';
3215 while (my $remote = <$fd>) {
3217 $remote =~ s!\t(.*?)\s+\((\w+)\)$!!;
3218 next if $wanted and not $remote eq $wanted;
3219 my ($url, $key) = ($1, $2);
3221 $remotes{$remote} ||= { 'heads' => () };
3222 $remotes{$remote}{$key} = $url;
3224 close $fd or return;
3225 return wantarray ? %remotes : \%remotes;
3228 # Takes a hash of remotes as first parameter and fills it by adding the
3229 # available remote heads for each of the indicated remotes.
3230 sub fill_remote_heads {
3231 my $remotes = shift;
3232 my @heads = map { "remotes/$_" } keys %$remotes;
3233 my @remoteheads = git_get_heads_list(undef, @heads);
3234 foreach my $remote (keys %$remotes) {
3235 $remotes->{$remote}{'heads'} = [ grep {
3236 $_->{'name'} =~ s!^$remote/!!
3241 sub git_get_references {
3242 my $type = shift || "";
3244 # 5dc01c595e6c6ec9ccda4f6f69c131c0dd945f8c refs/tags/v2.6.11
3245 # c39ae07f393806ccf406ef966e9a15afc43cc36a refs/tags/v2.6.11^{}
3246 open my $fd, "-|", git_cmd(), "show-ref", "--dereference",
3247 ($type ? ("--", "refs/$type") : ()) # use -- <pattern> if $type
3250 while (my $line = <$fd>) {
3252 if ($line =~ m!^([0-9a-fA-F]{40})\srefs/($type.*)$!) {
3253 if (defined $refs{$1}) {
3254 push @{$refs{$1}}, $2;
3260 close $fd or return;
3264 sub git_get_rev_name_tags {
3265 my $hash = shift || return undef;
3267 open my $fd, "-|", git_cmd(), "name-rev", "--tags", $hash
3269 my $name_rev = <$fd>;
3272 if ($name_rev =~ m|^$hash tags/(.*)$|) {
3275 # catches also '$hash undefined' output
3280 ## ----------------------------------------------------------------------
3281 ## parse to hash functions
3285 my $tz = shift || "-0000";
3288 my @months = ("Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec");
3289 my @days = ("Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat");
3290 my ($sec, $min, $hour, $mday, $mon, $year, $wday, $yday) = gmtime($epoch);
3291 $date{'hour'} = $hour;
3292 $date{'minute'} = $min;
3293 $date{'mday'} = $mday;
3294 $date{'day'} = $days[$wday];
3295 $date{'month'} = $months[$mon];
3296 $date{'rfc2822'} = sprintf "%s, %d %s %4d %02d:%02d:%02d +0000",
3297 $days[$wday], $mday, $months[$mon], 1900+$year, $hour ,$min, $sec;
3298 $date{'mday-time'} = sprintf "%d %s %02d:%02d",
3299 $mday, $months[$mon], $hour ,$min;
3300 $date{'iso-8601'} = sprintf "%04d-%02d-%02dT%02d:%02d:%02dZ",
3301 1900+$year, 1+$mon, $mday, $hour ,$min, $sec;
3303 my ($tz_sign, $tz_hour, $tz_min) =
3304 ($tz =~ m/^([-+])(\d\d)(\d\d)$/);
3305 $tz_sign = ($tz_sign eq '-' ? -1 : +1);
3306 my $local = $epoch + $tz_sign*((($tz_hour*60) + $tz_min)*60);
3307 ($sec, $min, $hour, $mday, $mon, $year, $wday, $yday) = gmtime($local);
3308 $date{'hour_local'} = $hour;
3309 $date{'minute_local'} = $min;
3310 $date{'tz_local'} = $tz;
3311 $date{'iso-tz'} = sprintf("%04d-%02d-%02d %02d:%02d:%02d %s",
3312 1900+$year, $mon+1, $mday,
3313 $hour, $min, $sec, $tz);
3322 open my $fd, "-|", git_cmd(), "cat-file", "tag", $tag_id or return;
3323 $tag{'id'} = $tag_id;
3324 while (my $line = <$fd>) {
3326 if ($line =~ m/^object ([0-9a-fA-F]{40})$/) {
3327 $tag{'object'} = $1;
3328 } elsif ($line =~ m/^type (.+)$/) {
3330 } elsif ($line =~ m/^tag (.+)$/) {
3332 } elsif ($line =~ m/^tagger (.*) ([0-9]+) (.*)$/) {
3333 $tag{'author'} = $1;
3334 $tag{'author_epoch'} = $2;
3335 $tag{'author_tz'} = $3;
3336 if ($tag{'author'} =~ m/^([^<]+) <([^>]*)>/) {
3337 $tag{'author_name'} = $1;
3338 $tag{'author_email'} = $2;
3340 $tag{'author_name'} = $tag{'author'};
3342 } elsif ($line =~ m/--BEGIN/) {
3343 push @comment, $line;
3345 } elsif ($line eq "") {
3349 push @comment, <$fd>;
3350 $tag{'comment'} = \@comment;
3351 close $fd or return;
3352 if (!defined $tag{'name'}) {
3358 sub parse_commit_text {
3359 my ($commit_text, $withparents) = @_;
3360 my @commit_lines = split '\n', $commit_text;
3363 pop @commit_lines; # Remove '\0'
3365 if (! @commit_lines) {
3369 my $header = shift @commit_lines;
3370 if ($header !~ m/^[0-9a-fA-F]{40}/) {
3373 ($co{'id'}, my @parents) = split ' ', $header;
3374 while (my $line = shift @commit_lines) {
3375 last if $line eq "\n";
3376 if ($line =~ m/^tree ([0-9a-fA-F]{40})$/) {
3378 } elsif ((!defined $withparents) && ($line =~ m/^parent ([0-9a-fA-F]{40})$/)) {
3380 } elsif ($line =~ m/^author (.*) ([0-9]+) (.*)$/) {
3381 $co{'author'} = to_utf8($1);
3382 $co{'author_epoch'} = $2;
3383 $co{'author_tz'} = $3;
3384 if ($co{'author'} =~ m/^([^<]+) <([^>]*)>/) {
3385 $co{'author_name'} = $1;
3386 $co{'author_email'} = $2;
3388 $co{'author_name'} = $co{'author'};
3390 } elsif ($line =~ m/^committer (.*) ([0-9]+) (.*)$/) {
3391 $co{'committer'} = to_utf8($1);
3392 $co{'committer_epoch'} = $2;
3393 $co{'committer_tz'} = $3;
3394 if ($co{'committer'} =~ m/^([^<]+) <([^>]*)>/) {
3395 $co{'committer_name'} = $1;
3396 $co{'committer_email'} = $2;
3398 $co{'committer_name'} = $co{'committer'};
3402 if (!defined $co{'tree'}) {
3405 $co{'parents'} = \@parents;
3406 $co{'parent'} = $parents[0];
3408 foreach my $title (@commit_lines) {
3411 $co{'title'} = chop_str($title, 80, 5);
3412 # remove leading stuff of merges to make the interesting part visible
3413 if (length($title) > 50) {
3414 $title =~ s/^Automatic //;
3415 $title =~ s/^merge (of|with) /Merge ... /i;
3416 if (length($title) > 50) {
3417 $title =~ s/(http|rsync):\/\///;
3419 if (length($title) > 50) {
3420 $title =~ s/(master|www|rsync)\.//;
3422 if (length($title) > 50) {
3423 $title =~ s/kernel.org:?//;
3425 if (length($title) > 50) {
3426 $title =~ s/\/pub\/scm//;
3429 $co{'title_short'} = chop_str($title, 50, 5);
3433 if (! defined $co{'title'} || $co{'title'} eq "") {
3434 $co{'title'} = $co{'title_short'} = '(no commit message)';
3436 # remove added spaces
3437 foreach my $line (@commit_lines) {
3440 $co{'comment'} = \@commit_lines;
3442 my $age = time - $co{'committer_epoch'};
3444 $co{'age_string'} = age_string($age);
3445 my ($sec, $min, $hour, $mday, $mon, $year, $wday, $yday) = gmtime($co{'committer_epoch'});
3446 if ($age > 60*60*24*7*2) {
3447 $co{'age_string_date'} = sprintf "%4i-%02u-%02i", 1900 + $year, $mon+1, $mday;
3448 $co{'age_string_age'} = $co{'age_string'};
3450 $co{'age_string_date'} = $co{'age_string'};
3451 $co{'age_string_age'} = sprintf "%4i-%02u-%02i", 1900 + $year, $mon+1, $mday;
3457 my ($commit_id) = @_;
3462 open my $fd, "-|", git_cmd(), "rev-list",
3468 or die_error(500, "Open git-rev-list failed");
3469 %co = parse_commit_text(<$fd>, 1);
3476 my ($commit_id, $maxcount, $skip, $filename, @args) = @_;
3484 open my $fd, "-|", git_cmd(), "rev-list",
3487 ("--max-count=" . $maxcount),
3488 ("--skip=" . $skip),
3492 ($filename ? ($filename) : ())
3493 or die_error(500, "Open git-rev-list failed");
3494 while (my $line = <$fd>) {
3495 my %co = parse_commit_text($line);
3500 return wantarray ? @cos : \@cos;
3503 # parse line of git-diff-tree "raw" output
3504 sub parse_difftree_raw_line {
3508 # ':100644 100644 03b218260e99b78c6df0ed378e59ed9205ccc96d 3b93d5e7cc7f7dd4ebed13a5cc1a4ad976fc94d8 M ls-files.c'
3509 # ':100644 100644 7f9281985086971d3877aca27704f2aaf9c448ce bc190ebc71bbd923f2b728e505408f5e54bd073a M rev-tree.c'
3510 if ($line =~ m/^:([0-7]{6}) ([0-7]{6}) ([0-9a-fA-F]{40}) ([0-9a-fA-F]{40}) (.)([0-9]{0,3})\t(.*)$/) {
3511 $res{'from_mode'} = $1;
3512 $res{'to_mode'} = $2;
3513 $res{'from_id'} = $3;
3515 $res{'status'} = $5;
3516 $res{'similarity'} = $6;
3517 if ($res{'status'} eq 'R' || $res{'status'} eq 'C') { # renamed or copied
3518 ($res{'from_file'}, $res{'to_file'}) = map { unquote($_) } split("\t", $7);
3520 $res{'from_file'} = $res{'to_file'} = $res{'file'} = unquote($7);
3523 # '::100755 100755 100755 60e79ca1b01bc8b057abe17ddab484699a7f5fdb 94067cc5f73388f33722d52ae02f44692bc07490 94067cc5f73388f33722d52ae02f44692bc07490 MR git-gui/git-gui.sh'
3524 # combined diff (for merge commit)
3525 elsif ($line =~ s/^(::+)((?:[0-7]{6} )+)((?:[0-9a-fA-F]{40} )+)([a-zA-Z]+)\t(.*)$//) {
3526 $res{'nparents'} = length($1);
3527 $res{'from_mode'} = [ split(' ', $2) ];
3528 $res{'to_mode'} = pop @{$res{'from_mode'}};
3529 $res{'from_id'} = [ split(' ', $3) ];
3530 $res{'to_id'} = pop @{$res{'from_id'}};
3531 $res{'status'} = [ split('', $4) ];
3532 $res{'to_file'} = unquote($5);
3534 # 'c512b523472485aef4fff9e57b229d9d243c967f'
3535 elsif ($line =~ m/^([0-9a-fA-F]{40})$/) {
3536 $res{'commit'} = $1;
3539 return wantarray ? %res : \%res;
3542 # wrapper: return parsed line of git-diff-tree "raw" output
3543 # (the argument might be raw line, or parsed info)
3544 sub parsed_difftree_line {
3545 my $line_or_ref = shift;
3547 if (ref($line_or_ref) eq "HASH") {
3548 # pre-parsed (or generated by hand)
3549 return $line_or_ref;
3551 return parse_difftree_raw_line($line_or_ref);
3555 # parse line of git-ls-tree output
3556 sub parse_ls_tree_line {
3562 #'100644 blob 0fa3f3a66fb6a137f6ec2c19351ed4d807070ffa 16717 panic.c'
3563 $line =~ m/^([0-9]+) (.+) ([0-9a-fA-F]{40}) +(-|[0-9]+)\t(.+)$/s;
3572 $res{'name'} = unquote($5);
3575 #'100644 blob 0fa3f3a66fb6a137f6ec2c19351ed4d807070ffa panic.c'
3576 $line =~ m/^([0-9]+) (.+) ([0-9a-fA-F]{40})\t(.+)$/s;
3584 $res{'name'} = unquote($4);
3588 return wantarray ? %res : \%res;
3591 # generates _two_ hashes, references to which are passed as 2 and 3 argument
3592 sub parse_from_to_diffinfo {
3593 my ($diffinfo, $from, $to, @parents) = @_;
3595 if ($diffinfo->{'nparents'}) {
3597 $from->{'file'} = [];
3598 $from->{'href'} = [];
3599 fill_from_file_info($diffinfo, @parents)
3600 unless exists $diffinfo->{'from_file'};
3601 for (my $i = 0; $i < $diffinfo->{'nparents'}; $i++) {
3602 $from->{'file'}[$i] =
3603 defined $diffinfo->{'from_file'}[$i] ?
3604 $diffinfo->{'from_file'}[$i] :
3605 $diffinfo->{'to_file'};
3606 if ($diffinfo->{'status'}[$i] ne "A") { # not new (added) file
3607 $from->{'href'}[$i] = href(action=>"blob",
3608 hash_base=>$parents[$i],
3609 hash=>$diffinfo->{'from_id'}[$i],
3610 file_name=>$from->{'file'}[$i]);
3612 $from->{'href'}[$i] = undef;
3616 # ordinary (not combined) diff
3617 $from->{'file'} = $diffinfo->{'from_file'};
3618 if ($diffinfo->{'status'} ne "A") { # not new (added) file
3619 $from->{'href'} = href(action=>"blob", hash_base=>$hash_parent,
3620 hash=>$diffinfo->{'from_id'},
3621 file_name=>$from->{'file'});
3623 delete $from->{'href'};
3627 $to->{'file'} = $diffinfo->{'to_file'};
3628 if (!is_deleted($diffinfo)) { # file exists in result
3629 $to->{'href'} = href(action=>"blob", hash_base=>$hash,
3630 hash=>$diffinfo->{'to_id'},
3631 file_name=>$to->{'file'});
3633 delete $to->{'href'};
3637 ## ......................................................................
3638 ## parse to array of hashes functions
3640 sub git_get_heads_list {
3641 my ($limit, @classes) = @_;
3642 @classes = ('heads') unless @classes;
3643 my @patterns = map { "refs/$_" } @classes;
3646 open my $fd, '-|', git_cmd(), 'for-each-ref',
3647 ($limit ? '--count='.($limit+1) : ()), '--sort=-committerdate',
3648 '--format=%(objectname) %(refname) %(subject)%00%(committer)',
3651 while (my $line = <$fd>) {
3655 my ($refinfo, $committerinfo) = split(/\0/, $line);
3656 my ($hash, $name, $title) = split(' ', $refinfo, 3);
3657 my ($committer, $epoch, $tz) =
3658 ($committerinfo =~ /^(.*) ([0-9]+) (.*)$/);
3659 $ref_item{'fullname'} = $name;
3660 $name =~ s!^refs/(?:head|remote)s/!!;
3662 $ref_item{'name'} = $name;
3663 $ref_item{'id'} = $hash;
3664 $ref_item{'title'} = $title || '(no commit message)';
3665 $ref_item{'epoch'} = $epoch;
3667 $ref_item{'age'} = age_string(time - $ref_item{'epoch'});
3669 $ref_item{'age'} = "unknown";
3672 push @headslist, \%ref_item;
3676 return wantarray ? @headslist : \@headslist;
3679 sub git_get_tags_list {
3683 open my $fd, '-|', git_cmd(), 'for-each-ref',
3684 ($limit ? '--count='.($limit+1) : ()), '--sort=-creatordate',
3685 '--format=%(objectname) %(objecttype) %(refname) '.
3686 '%(*objectname) %(*objecttype) %(subject)%00%(creator)',
3689 while (my $line = <$fd>) {
3693 my ($refinfo, $creatorinfo) = split(/\0/, $line);
3694 my ($id, $type, $name, $refid, $reftype, $title) = split(' ', $refinfo, 6);
3695 my ($creator, $epoch, $tz) =
3696 ($creatorinfo =~ /^(.*) ([0-9]+) (.*)$/);
3697 $ref_item{'fullname'} = $name;
3698 $name =~ s!^refs/tags/!!;
3700 $ref_item{'type'} = $type;
3701 $ref_item{'id'} = $id;
3702 $ref_item{'name'} = $name;
3703 if ($type eq "tag") {
3704 $ref_item{'subject'} = $title;
3705 $ref_item{'reftype'} = $reftype;
3706 $ref_item{'refid'} = $refid;
3708 $ref_item{'reftype'} = $type;
3709 $ref_item{'refid'} = $id;
3712 if ($type eq "tag" || $type eq "commit") {
3713 $ref_item{'epoch'} = $epoch;
3715 $ref_item{'age'} = age_string(time - $ref_item{'epoch'});
3717 $ref_item{'age'} = "unknown";
3721 push @tagslist, \%ref_item;
3725 return wantarray ? @tagslist : \@tagslist;
3728 ## ----------------------------------------------------------------------
3729 ## filesystem-related functions
3731 sub get_file_owner {
3734 my ($dev, $ino, $mode, $nlink, $st_uid, $st_gid, $rdev, $size) = stat($path);
3735 my ($name, $passwd, $uid, $gid, $quota, $comment, $gcos, $dir, $shell) = getpwuid($st_uid);
3736 if (!defined $gcos) {
3740 $owner =~ s/[,;].*$//;
3741 return to_utf8($owner);
3744 # assume that file exists
3746 my $filename = shift;
3748 open my $fd, '<', $filename;
3749 print map { to_utf8($_) } <$fd>;
3753 ## ......................................................................
3754 ## mimetype related functions
3756 sub mimetype_guess_file {
3757 my $filename = shift;
3758 my $mimemap = shift;
3759 -r $mimemap or return undef;
3762 open(my $mh, '<', $mimemap) or return undef;
3764 next if m/^#/; # skip comments
3765 my ($mimetype, @exts) = split(/\s+/);
3766 foreach my $ext (@exts) {
3767 $mimemap{$ext} = $mimetype;
3772 $filename =~ /\.([^.]*)$/;
3773 return $mimemap{$1};
3776 sub mimetype_guess {
3777 my $filename = shift;
3779 $filename =~ /\./ or return undef;
3781 if ($mimetypes_file) {
3782 my $file = $mimetypes_file;
3783 if ($file !~ m!^/!) { # if it is relative path
3784 # it is relative to project
3785 $file = "$projectroot/$project/$file";
3787 $mime = mimetype_guess_file($filename, $file);
3789 $mime ||= mimetype_guess_file($filename, '/etc/mime.types');
3795 my $filename = shift;
3798 my $mime = mimetype_guess($filename);
3799 $mime and return $mime;
3803 return $default_blob_plain_mimetype unless $fd;
3806 return 'text/plain';
3807 } elsif (! $filename) {
3808 return 'application/octet-stream';
3809 } elsif ($filename =~ m/\.png$/i) {
3811 } elsif ($filename =~ m/\.gif$/i) {
3813 } elsif ($filename =~ m/\.jpe?g$/i) {
3814 return 'image/jpeg';
3816 return 'application/octet-stream';
3820 sub blob_contenttype {
3821 my ($fd, $file_name, $type) = @_;
3823 $type ||= blob_mimetype($fd, $file_name);
3824 if ($type eq 'text/plain' && defined $default_text_plain_charset) {
3825 $type .= "; charset=$default_text_plain_charset";
3831 # guess file syntax for syntax highlighting; return undef if no highlighting
3832 # the name of syntax can (in the future) depend on syntax highlighter used
3833 sub guess_file_syntax {
3834 my ($highlight, $mimetype, $file_name) = @_;
3835 return undef unless ($highlight && defined $file_name);
3836 my $basename = basename($file_name, '.in');
3837 return $highlight_basename{$basename}
3838 if exists $highlight_basename{$basename};
3840 $basename =~ /\.([^.]*)$/;
3841 my $ext = $1 or return undef;
3842 return $highlight_ext{$ext}
3843 if exists $highlight_ext{$ext};
3848 # run highlighter and return FD of its output,
3849 # or return original FD if no highlighting
3850 sub run_highlighter {
3851 my ($fd, $highlight, $syntax) = @_;
3852 return $fd unless ($highlight && defined $syntax);
3855 open $fd, quote_command(git_cmd(), "cat-file", "blob", $hash)." | ".
3856 quote_command($highlight_bin).
3857 " --replace-tabs=8 --fragment --syntax $syntax |"
3858 or die_error(500, "Couldn't open file or run syntax highlighter");
3862 ## ======================================================================
3863 ## functions printing HTML: header, footer, error page
3865 sub get_page_title {
3866 my $title = to_utf8($site_name);
3868 unless (defined $project) {
3869 if (defined $project_filter) {
3870 $title .= " - projects in '" . esc_path($project_filter) . "'";
3874 $title .= " - " . to_utf8($project);
3876 return $title unless (defined $action);
3877 $title .= "/$action"; # $action is US-ASCII (7bit ASCII)
3879 return $title unless (defined $file_name);
3880 $title .= " - " . esc_path($file_name);
3881 if ($action eq "tree" && $file_name !~ m|/$|) {
3888 sub get_content_type_html {
3889 # require explicit support from the UA if we are to send the page as
3890 # 'application/xhtml+xml', otherwise send it as plain old 'text/html'.
3891 # we have to do this because MSIE sometimes globs '*/*', pretending to
3892 # support xhtml+xml but choking when it gets what it asked for.
3893 if (defined $cgi->http('HTTP_ACCEPT') &&
3894 $cgi->http('HTTP_ACCEPT') =~ m/(,|;|\s|^)application\/xhtml\+xml(,|;|\s|$)/ &&
3895 $cgi->Accept('application/xhtml+xml') != 0) {
3896 return 'application/xhtml+xml';
3902 sub print_feed_meta {
3903 if (defined $project) {
3904 my %href_params = get_feed_info();
3905 if (!exists $href_params{'-title'}) {
3906 $href_params{'-title'} = 'log';
3909 foreach my $format (qw(RSS Atom)) {
3910 my $type = lc($format);
3912 '-rel' => 'alternate',
3913 '-title' => esc_attr("$project - $href_params{'-title'} - $format feed"),
3914 '-type' => "application/$type+xml"
3917 $href_params{'extra_options'} = undef;
3918 $href_params{'action'} = $type;
3919 $link_attr{'-href'} = href(%href_params);
3921 "rel=\"$link_attr{'-rel'}\" ".
3922 "title=\"$link_attr{'-title'}\" ".
3923 "href=\"$link_attr{'-href'}\" ".
3924 "type=\"$link_attr{'-type'}\" ".
3927 $href_params{'extra_options'} = '--no-merges';
3928 $link_attr{'-href'} = href(%href_params);
3929 $link_attr{'-title'} .= ' (no merges)';
3931 "rel=\"$link_attr{'-rel'}\" ".
3932 "title=\"$link_attr{'-title'}\" ".
3933 "href=\"$link_attr{'-href'}\" ".
3934 "type=\"$link_attr{'-type'}\" ".
3939 printf('<link rel="alternate" title="%s projects list" '.
3940 'href="%s" type="text/plain; charset=utf-8" />'."\n",
3941 esc_attr($site_name), href(project=>undef, action=>"project_index"));
3942 printf('<link rel="alternate" title="%s projects feeds" '.
3943 'href="%s" type="text/x-opml" />'."\n",
3944 esc_attr($site_name), href(project=>undef, action=>"opml"));
3948 sub print_header_links {
3951 # print out each stylesheet that exist, providing backwards capability
3952 # for those people who defined $stylesheet in a config file
3953 if (defined $stylesheet) {
3954 print '<link rel="stylesheet" type="text/css" href="'.esc_url($stylesheet).'"/>'."\n";
3956 foreach my $stylesheet (@stylesheets) {
3957 next unless $stylesheet;
3958 print '<link rel="stylesheet" type="text/css" href="'.esc_url($stylesheet).'"/>'."\n";
3962 if ($status eq '200 OK');
3963 if (defined $favicon) {
3964 print qq(<link rel="shortcut icon" href=").esc_url($favicon).qq(" type="image/png" />\n);
3968 sub print_nav_breadcrumbs_path {
3969 my $dirprefix = undef;
3970 while (my $part = shift) {
3971 $dirprefix .= "/" if defined $dirprefix;
3972 $dirprefix .= $part;
3973 print $cgi->a({-href => href(project => undef,
3974 project_filter => $dirprefix,
3975 action => "project_list")},
3976 esc_html($part)) . " / ";
3980 sub print_nav_breadcrumbs {
3983 print $cgi->a({-href => esc_url($home_link)}, $home_link_str) . " / ";
3984 if (defined $project) {
3985 my @dirname = split '/', $project;
3986 my $projectbasename = pop @dirname;
3987 print_nav_breadcrumbs_path(@dirname);
3988 print $cgi->a({-href => href(action=>"summary")}, esc_html($projectbasename));
3989 if (defined $action) {
3990 my $action_print = $action ;
3991 if (defined $opts{-action_extra}) {
3992 $action_print = $cgi->a({-href => href(action=>$action)},
3995 print " / $action_print";
3997 if (defined $opts{-action_extra}) {
3998 print " / $opts{-action_extra}";
4001 } elsif (defined $project_filter) {
4002 print_nav_breadcrumbs_path(split '/', $project_filter);
4006 sub print_search_form {
4007 if (!defined $searchtext) {
4011 if (defined $hash_base) {
4012 $search_hash = $hash_base;
4013 } elsif (defined $hash) {
4014 $search_hash = $hash;
4016 $search_hash = "HEAD";
4018 my $action = $my_uri;
4019 my $use_pathinfo = gitweb_check_feature('pathinfo');
4020 if ($use_pathinfo) {
4021 $action .= "/".esc_url($project);
4023 print $cgi->startform(-method => "get", -action => $action) .
4024 "<div class=\"search\">\n" .
4026 $cgi->input({-name=>"p", -value=>$project, -type=>"hidden"}) . "\n") .
4027 $cgi->input({-name=>"a", -value=>"search", -type=>"hidden"}) . "\n" .
4028 $cgi->input({-name=>"h", -value=>$search_hash, -type=>"hidden"}) . "\n" .
4029 $cgi->popup_menu(-name => 'st', -default => 'commit',
4030 -values => ['commit', 'grep', 'author', 'committer', 'pickaxe']) .
4031 $cgi->sup($cgi->a({-href => href(action=>"search_help")}, "?")) .
4033 $cgi->textfield(-name => "s", -value => $searchtext, -override => 1) . "\n" .
4034 "<span title=\"Extended regular expression\">" .
4035 $cgi->checkbox(-name => 'sr', -value => 1, -label => 're',
4036 -checked => $search_use_regexp) .
4039 $cgi->end_form() . "\n";
4042 sub git_header_html {
4043 my $status = shift || "200 OK";
4044 my $expires = shift;
4047 my $title = get_page_title();
4048 my $content_type = get_content_type_html();
4049 print $cgi->header(-type=>$content_type, -charset => 'utf-8',
4050 -status=> $status, -expires => $expires)
4051 unless ($opts{'-no_http_header'});
4052 my $mod_perl_version = $ENV{'MOD_PERL'} ? " $ENV{'MOD_PERL'}" : '';
4054 <?xml version="1.0" encoding="utf-8"?>
4055 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4056 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US" lang="en-US">
4057 <!-- git web interface version $version, (C) 2005-2006, Kay Sievers <kay.sievers\@vrfy.org>, Christian Gierke -->
4058 <!-- git core binaries version $git_version -->
4060 <meta http-equiv="content-type" content="$content_type; charset=utf-8"/>
4061 <meta name="generator" content="gitweb/$version git/$git_version$mod_perl_version"/>
4062 <meta name="robots" content="index, nofollow"/>
4063 <title>$title</title>
4065 # the stylesheet, favicon etc urls won't work correctly with path_info
4066 # unless we set the appropriate base URL
4067 if ($ENV{'PATH_INFO'}) {
4068 print "<base href=\"".esc_url($base_url)."\" />\n";
4070 print_header_links($status);
4072 if (defined $site_html_head_string) {
4073 print to_utf8($site_html_head_string);
4079 if (defined $site_header && -f $site_header) {
4080 insert_file($site_header);
4083 print "<div class=\"page_header\">\n";
4084 if (defined $logo) {
4085 print $cgi->a({-href => esc_url($logo_url),
4086 -title => $logo_label},
4087 $cgi->img({-src => esc_url($logo),
4088 -width => 72, -height => 27,
4090 -class => "logo"}));
4092 print_nav_breadcrumbs(%opts);
4095 my $have_search = gitweb_check_feature('search');
4096 if (defined $project && $have_search) {
4097 print_search_form();
4101 sub git_footer_html {
4102 my $feed_class = 'rss_logo';
4104 print "<div class=\"page_footer\">\n";
4105 if (defined $project) {
4106 my $descr = git_get_project_description($project);
4107 if (defined $descr) {
4108 print "<div class=\"page_footer_text\">" . esc_html($descr) . "</div>\n";
4111 my %href_params = get_feed_info();
4112 if (!%href_params) {
4113 $feed_class .= ' generic';
4115 $href_params{'-title'} ||= 'log';
4117 foreach my $format (qw(RSS Atom)) {
4118 $href_params{'action'} = lc($format);
4119 print $cgi->a({-href => href(%href_params),
4120 -title => "$href_params{'-title'} $format feed",
4121 -class => $feed_class}, $format)."\n";
4125 print $cgi->a({-href => href(project=>undef, action=>"opml",
4126 project_filter => $project_filter),
4127 -class => $feed_class}, "OPML") . " ";
4128 print $cgi->a({-href => href(project=>undef, action=>"project_index",
4129 project_filter => $project_filter),
4130 -class => $feed_class}, "TXT") . "\n";
4132 print "</div>\n"; # class="page_footer"
4134 if (defined $t0 && gitweb_check_feature('timed')) {
4135 print "<div id=\"generating_info\">\n";
4136 print 'This page took '.
4137 '<span id="generating_time" class="time_span">'.
4138 tv_interval($t0, [ gettimeofday() ]).
4141 '<span id="generating_cmd">'.
4142 $number_of_git_cmds.
4143 '</span> git commands '.
4145 print "</div>\n"; # class="page_footer"
4148 if (defined $site_footer && -f $site_footer) {
4149 insert_file($site_footer);
4152 print qq!<script type="text/javascript" src="!.esc_url($javascript).qq!"></script>\n!;
4153 if (defined $action &&
4154 $action eq 'blame_incremental') {
4155 print qq!<script type="text/javascript">\n!.
4156 qq!startBlame("!. href(action=>"blame_data", -replay=>1) .qq!",\n!.
4157 qq! "!. href() .qq!");\n!.
4160 my ($jstimezone, $tz_cookie, $datetime_class) =
4161 gitweb_get_feature('javascript-timezone');
4163 print qq!<script type="text/javascript">\n!.
4164 qq!window.onload = function () {\n!;
4165 if (gitweb_check_feature('javascript-actions')) {
4166 print qq! fixLinks();\n!;
4168 if ($jstimezone && $tz_cookie && $datetime_class) {
4169 print qq! var tz_cookie = { name: '$tz_cookie', expires: 14, path: '/' };\n!. # in days
4170 qq! onloadTZSetup('$jstimezone', tz_cookie, '$datetime_class');\n!;
4180 # die_error(<http_status_code>, <error_message>[, <detailed_html_description>])
4181 # Example: die_error(404, 'Hash not found')
4182 # By convention, use the following status codes (as defined in RFC 2616):
4183 # 400: Invalid or missing CGI parameters, or
4184 # requested object exists but has wrong type.
4185 # 403: Requested feature (like "pickaxe" or "snapshot") not enabled on
4186 # this server or project.
4187 # 404: Requested object/revision/project doesn't exist.
4188 # 500: The server isn't configured properly, or
4189 # an internal error occurred (e.g. failed assertions caused by bugs), or
4190 # an unknown error occurred (e.g. the git binary died unexpectedly).
4191 # 503: The server is currently unavailable (because it is overloaded,
4192 # or down for maintenance). Generally, this is a temporary state.
4194 my $status = shift || 500;
4195 my $error = esc_html(shift) || "Internal Server Error";
4199 my %http_responses = (
4200 400 => '400 Bad Request',
4201 403 => '403 Forbidden',
4202 404 => '404 Not Found',
4203 500 => '500 Internal Server Error',
4204 503 => '503 Service Unavailable',
4206 git_header_html($http_responses{$status}, undef, %opts);
4208 <div class="page_body">
4213 if (defined $extra) {
4221 unless ($opts{'-error_handler'});
4224 ## ----------------------------------------------------------------------
4225 ## functions printing or outputting HTML: navigation
4227 sub git_print_page_nav {
4228 my ($current, $suppress, $head, $treehead, $treebase, $extra) = @_;
4229 $extra = '' if !defined $extra; # pager or formats
4231 my @navs = qw(summary shortlog log commit commitdiff tree);
4233 @navs = grep { $_ ne $suppress } @navs;
4236 my %arg = map { $_ => {action=>$_} } @navs;
4237 if (defined $head) {
4238 for (qw(commit commitdiff)) {
4239 $arg{$_}{'hash'} = $head;
4241 if ($current =~ m/^(tree | log | shortlog | commit | commitdiff | search)$/x) {
4242 for (qw(shortlog log)) {
4243 $arg{$_}{'hash'} = $head;
4248 $arg{'tree'}{'hash'} = $treehead if defined $treehead;
4249 $arg{'tree'}{'hash_base'} = $treebase if defined $treebase;
4251 my @actions = gitweb_get_feature('actions');
4254 'n' => $project, # project name
4255 'f' => $git_dir, # project path within filesystem
4256 'h' => $treehead || '', # current hash ('h' parameter)
4257 'b' => $treebase || '', # hash base ('hb' parameter)
4260 my ($label, $link, $pos) = splice(@actions,0,3);
4262 @navs = map { $_ eq $pos ? ($_, $label) : $_ } @navs;
4264 $link =~ s/%([%nfhb])/$repl{$1}/g;
4265 $arg{$label}{'_href'} = $link;
4268 print "<div class=\"page_nav\">\n" .
4270 map { $_ eq $current ?
4271 $_ : $cgi->a({-href => ($arg{$_}{_href} ? $arg{$_}{_href} : href(%{$arg{$_}}))}, "$_")
4273 print "<br/>\n$extra<br/>\n" .
4277 # returns a submenu for the nagivation of the refs views (tags, heads,
4278 # remotes) with the current view disabled and the remotes view only
4279 # available if the feature is enabled
4280 sub format_ref_views {
4282 my @ref_views = qw{tags heads};
4283 push @ref_views, 'remotes' if gitweb_check_feature('remote_heads');
4284 return join " | ", map {
4285 $_ eq $current ? $_ :
4286 $cgi->a({-href => href(action=>$_)}, $_)
4290 sub format_paging_nav {
4291 my ($action, $page, $has_next_link) = @_;
4297 $cgi->a({-href => href(-replay=>1, page=>undef)}, "first") .
4299 $cgi->a({-href => href(-replay=>1, page=>$page-1),
4300 -accesskey => "p", -title => "Alt-p"}, "prev");
4302 $paging_nav .= "first ⋅ prev";
4305 if ($has_next_link) {
4306 $paging_nav .= " ⋅ " .
4307 $cgi->a({-href => href(-replay=>1, page=>$page+1),
4308 -accesskey => "n", -title => "Alt-n"}, "next");
4310 $paging_nav .= " ⋅ next";
4316 ## ......................................................................
4317 ## functions printing or outputting HTML: div
4319 sub git_print_header_div {
4320 my ($action, $title, $hash, $hash_base) = @_;
4323 $args{'action'} = $action;
4324 $args{'hash'} = $hash if $hash;
4325 $args{'hash_base'} = $hash_base if $hash_base;
4327 print "<div class=\"header\">\n" .
4328 $cgi->a({-href => href(%args), -class => "title"},
4329 $title ? $title : $action) .
4333 sub format_repo_url {
4334 my ($name, $url) = @_;
4335 return "<tr class=\"metadata_url\"><td>$name</td><td>$url</td></tr>\n";
4338 # Group output by placing it in a DIV element and adding a header.
4339 # Options for start_div() can be provided by passing a hash reference as the
4340 # first parameter to the function.
4341 # Options to git_print_header_div() can be provided by passing an array
4342 # reference. This must follow the options to start_div if they are present.
4343 # The content can be a scalar, which is output as-is, a scalar reference, which
4344 # is output after html escaping, an IO handle passed either as *handle or
4345 # *handle{IO}, or a function reference. In the latter case all following
4346 # parameters will be taken as argument to the content function call.
4347 sub git_print_section {
4348 my ($div_args, $header_args, $content);
4350 if (ref($arg) eq 'HASH') {
4354 if (ref($arg) eq 'ARRAY') {
4355 $header_args = $arg;
4360 print $cgi->start_div($div_args);
4361 git_print_header_div(@$header_args);
4363 if (ref($content) eq 'CODE') {
4365 } elsif (ref($content) eq 'SCALAR') {
4366 print esc_html($$content);
4367 } elsif (ref($content) eq 'GLOB' or ref($content) eq 'IO::Handle') {
4369 } elsif (!ref($content) && defined($content)) {
4373 print $cgi->end_div;
4376 sub format_timestamp_html {
4378 my $strtime = $date->{'rfc2822'};
4380 my (undef, undef, $datetime_class) =
4381 gitweb_get_feature('javascript-timezone');
4382 if ($datetime_class) {
4383 $strtime = qq!<span class="$datetime_class">$strtime</span>!;
4386 my $localtime_format = '(%02d:%02d %s)';
4387 if ($date->{'hour_local'} < 6) {
4388 $localtime_format = '(<span class="atnight">%02d:%02d</span> %s)';
4391 sprintf($localtime_format,
4392 $date->{'hour_local'}, $date->{'minute_local'}, $date->{'tz_local'});
4397 # Outputs the author name and date in long form
4398 sub git_print_authorship {
4401 my $tag = $opts{-tag} || 'div';
4402 my $author = $co->{'author_name'};
4404 my %ad = parse_date($co->{'author_epoch'}, $co->{'author_tz'});
4405 print "<$tag class=\"author_date\">" .
4406 format_search_author($author, "author", esc_html($author)) .
4407 " [".format_timestamp_html(\%ad)."]".
4408 git_get_avatar($co->{'author_email'}, -pad_before => 1) .
4412 # Outputs table rows containing the full author or committer information,
4413 # in the format expected for 'commit' view (& similar).
4414 # Parameters are a commit hash reference, followed by the list of people
4415 # to output information for. If the list is empty it defaults to both
4416 # author and committer.
4417 sub git_print_authorship_rows {
4419 # too bad we can't use @people = @_ || ('author', 'committer')
4421 @people = ('author', 'committer') unless @people;
4422 foreach my $who (@people) {
4423 my %wd = parse_date($co->{"${who}_epoch"}, $co->{"${who}_tz"});
4424 print "<tr><td>$who</td><td>" .
4425 format_search_author($co->{"${who}_name"}, $who,
4426 esc_html($co->{"${who}_name"})) . " " .
4427 format_search_author($co->{"${who}_email"}, $who,
4428 esc_html("<" . $co->{"${who}_email"} . ">")) .
4429 "</td><td rowspan=\"2\">" .
4430 git_get_avatar($co->{"${who}_email"}, -size => 'double') .
4434 format_timestamp_html(\%wd) .
4440 sub git_print_page_path {
4446 print "<div class=\"page_path\">";
4447 print $cgi->a({-href => href(action=>"tree", hash_base=>$hb),
4448 -title => 'tree root'}, to_utf8("[$project]"));
4450 if (defined $name) {
4451 my @dirname = split '/', $name;
4452 my $basename = pop @dirname;
4455 foreach my $dir (@dirname) {
4456 $fullname .= ($fullname ? '/' : '') . $dir;
4457 print $cgi->a({-href => href(action=>"tree", file_name=>$fullname,
4459 -title => $fullname}, esc_path($dir));
4462 if (defined $type && $type eq 'blob') {
4463 print $cgi->a({-href => href(action=>"blob_plain", file_name=>$file_name,
4465 -title => $name}, esc_path($basename));
4466 } elsif (defined $type && $type eq 'tree') {
4467 print $cgi->a({-href => href(action=>"tree", file_name=>$file_name,
4469 -title => $name}, esc_path($basename));
4472 print esc_path($basename);
4475 print "<br/></div>\n";
4482 if ($opts{'-remove_title'}) {
4483 # remove title, i.e. first line of log
4486 # remove leading empty lines
4487 while (defined $log->[0] && $log->[0] eq "") {
4492 my $skip_blank_line = 0;
4493 foreach my $line (@$log) {
4494 if ($line =~ m/^\s*([A-Z][-A-Za-z]*-[Bb]y|C[Cc]): /) {
4495 if (! $opts{'-remove_signoff'}) {
4496 print "<span class=\"signoff\">" . esc_html($line) . "</span><br/>\n";
4497 $skip_blank_line = 1;
4502 if ($line =~ m,\s*([a-z]*link): (https?://\S+),i) {
4503 if (! $opts{'-remove_signoff'}) {
4504 print "<span class=\"signoff\">" . esc_html($1) . ": " .
4505 "<a href=\"" . esc_html($2) . "\">" . esc_html($2) . "</a>" .
4507 $skip_blank_line = 1;
4512 # print only one empty line
4513 # do not print empty line after signoff
4515 next if ($skip_blank_line);
4516 $skip_blank_line = 1;
4518 $skip_blank_line = 0;
4521 print format_log_line_html($line) . "<br/>\n";
4524 if ($opts{'-final_empty_line'}) {
4525 # end with single empty line
4526 print "<br/>\n" unless $skip_blank_line;
4530 # return link target (what link points to)
4531 sub git_get_link_target {
4536 open my $fd, "-|", git_cmd(), "cat-file", "blob", $hash
4540 $link_target = <$fd>;
4545 return $link_target;
4548 # given link target, and the directory (basedir) the link is in,
4549 # return target of link relative to top directory (top tree);
4550 # return undef if it is not possible (including absolute links).
4551 sub normalize_link_target {
4552 my ($link_target, $basedir) = @_;
4554 # absolute symlinks (beginning with '/') cannot be normalized
4555 return if (substr($link_target, 0, 1) eq '/');
4557 # normalize link target to path from top (root) tree (dir)
4560 $path = $basedir . '/' . $link_target;
4562 # we are in top (root) tree (dir)
4563 $path = $link_target;
4566 # remove //, /./, and /../
4568 foreach my $part (split('/', $path)) {
4569 # discard '.' and ''
4570 next if (!$part || $part eq '.');
4572 if ($part eq '..') {
4576 # link leads outside repository (outside top dir)
4580 push @path_parts, $part;
4583 $path = join('/', @path_parts);
4588 # print tree entry (row of git_tree), but without encompassing <tr> element
4589 sub git_print_tree_entry {
4590 my ($t, $basedir, $hash_base, $have_blame) = @_;
4593 $base_key{'hash_base'} = $hash_base if defined $hash_base;
4595 # The format of a table row is: mode list link. Where mode is
4596 # the mode of the entry, list is the name of the entry, an href,
4597 # and link is the action links of the entry.
4599 print "<td class=\"mode\">" . mode_str($t->{'mode'}) . "</td>\n";
4600 if (exists $t->{'size'}) {
4601 print "<td class=\"size\">$t->{'size'}</td>\n";
4603 if ($t->{'type'} eq "blob") {
4604 print "<td class=\"list\">" .
4605 $cgi->a({-href => href(action=>"blob", hash=>$t->{'hash'},
4606 file_name=>"$basedir$t->{'name'}", %base_key),
4607 -class => "list"}, esc_path($t->{'name'}));
4608 if (S_ISLNK(oct $t->{'mode'})) {
4609 my $link_target = git_get_link_target($t->{'hash'});
4611 my $norm_target = normalize_link_target($link_target, $basedir);
4612 if (defined $norm_target) {
4614 $cgi->a({-href => href(action=>"object", hash_base=>$hash_base,
4615 file_name=>$norm_target),
4616 -title => $norm_target}, esc_path($link_target));
4618 print " -> " . esc_path($link_target);
4623 print "<td class=\"link\">";
4624 print $cgi->a({-href => href(action=>"blob", hash=>$t->{'hash'},
4625 file_name=>"$basedir$t->{'name'}", %base_key)},
4629 $cgi->a({-href => href(action=>"blame", hash=>$t->{'hash'},
4630 file_name=>"$basedir$t->{'name'}", %base_key)},
4633 if (defined $hash_base) {
4635 $cgi->a({-href => href(action=>"history", hash_base=>$hash_base,
4636 hash=>$t->{'hash'}, file_name=>"$basedir$t->{'name'}")},
4640 $cgi->a({-href => href(action=>"blob_plain", hash_base=>$hash_base,
4641 file_name=>"$basedir$t->{'name'}")},
4645 } elsif ($t->{'type'} eq "tree") {
4646 print "<td class=\"list\">";
4647 print $cgi->a({-href => href(action=>"tree", hash=>$t->{'hash'},
4648 file_name=>"$basedir$t->{'name'}",
4650 esc_path($t->{'name'}));
4652 print "<td class=\"link\">";
4653 print $cgi->a({-href => href(action=>"tree", hash=>$t->{'hash'},
4654 file_name=>"$basedir$t->{'name'}",
4657 if (defined $hash_base) {
4659 $cgi->a({-href => href(action=>"history", hash_base=>$hash_base,
4660 file_name=>"$basedir$t->{'name'}")},
4665 # unknown object: we can only present history for it
4666 # (this includes 'commit' object, i.e. submodule support)
4667 print "<td class=\"list\">" .
4668 esc_path($t->{'name'}) .
4670 print "<td class=\"link\">";
4671 if (defined $hash_base) {
4672 print $cgi->a({-href => href(action=>"history",
4673 hash_base=>$hash_base,
4674 file_name=>"$basedir$t->{'name'}")},
4681 ## ......................................................................
4682 ## functions printing large fragments of HTML
4684 # get pre-image filenames for merge (combined) diff
4685 sub fill_from_file_info {
4686 my ($diff, @parents) = @_;
4688 $diff->{'from_file'} = [ ];
4689 $diff->{'from_file'}[$diff->{'nparents'} - 1] = undef;
4690 for (my $i = 0; $i < $diff->{'nparents'}; $i++) {
4691 if ($diff->{'status'}[$i] eq 'R' ||
4692 $diff->{'status'}[$i] eq 'C') {
4693 $diff->{'from_file'}[$i] =
4694 git_get_path_by_hash($parents[$i], $diff->{'from_id'}[$i]);
4701 # is current raw difftree line of file deletion
4703 my $diffinfo = shift;
4705 return $diffinfo->{'to_id'} eq ('0' x 40);
4708 # does patch correspond to [previous] difftree raw line
4709 # $diffinfo - hashref of parsed raw diff format
4710 # $patchinfo - hashref of parsed patch diff format
4711 # (the same keys as in $diffinfo)
4712 sub is_patch_split {
4713 my ($diffinfo, $patchinfo) = @_;
4715 return defined $diffinfo && defined $patchinfo
4716 && $diffinfo->{'to_file'} eq $patchinfo->{'to_file'};
4720 sub git_difftree_body {
4721 my ($difftree, $hash, @parents) = @_;
4722 my ($parent) = $parents[0];
4723 my $have_blame = gitweb_check_feature('blame');
4724 print "<div class=\"list_head\">\n";
4725 if ($#{$difftree} > 10) {
4726 print(($#{$difftree} + 1) . " files changed:\n");
4730 print "<table class=\"" .
4731 (@parents > 1 ? "combined " : "") .
4734 # header only for combined diff in 'commitdiff' view
4735 my $has_header = @$difftree && @parents > 1 && $action eq 'commitdiff';
4738 print "<thead><tr>\n" .
4739 "<th></th><th></th>\n"; # filename, patchN link
4740 for (my $i = 0; $i < @parents; $i++) {
4741 my $par = $parents[$i];
4743 $cgi->a({-href => href(action=>"commitdiff",
4744 hash=>$hash, hash_parent=>$par),
4745 -title => 'commitdiff to parent number ' .
4746 ($i+1) . ': ' . substr($par,0,7)},
4750 print "</tr></thead>\n<tbody>\n";
4755 foreach my $line (@{$difftree}) {
4756 my $diff = parsed_difftree_line($line);
4759 print "<tr class=\"dark\">\n";
4761 print "<tr class=\"light\">\n";
4765 if (exists $diff->{'nparents'}) { # combined diff
4767 fill_from_file_info($diff, @parents)
4768 unless exists $diff->{'from_file'};
4770 if (!is_deleted($diff)) {
4771 # file exists in the result (child) commit
4773 $cgi->a({-href => href(action=>"blob", hash=>$diff->{'to_id'},
4774 file_name=>$diff->{'to_file'},
4776 -class => "list"}, esc_path($diff->{'to_file'})) .
4780 esc_path($diff->{'to_file'}) .
4784 if ($action eq 'commitdiff') {
4787 print "<td class=\"link\">" .
4788 $cgi->a({-href => href(-anchor=>"patch$patchno")},
4794 my $has_history = 0;
4795 my $not_deleted = 0;
4796 for (my $i = 0; $i < $diff->{'nparents'}; $i++) {
4797 my $hash_parent = $parents[$i];
4798 my $from_hash = $diff->{'from_id'}[$i];
4799 my $from_path = $diff->{'from_file'}[$i];
4800 my $status = $diff->{'status'}[$i];
4802 $has_history ||= ($status ne 'A');
4803 $not_deleted ||= ($status ne 'D');
4805 if ($status eq 'A') {
4806 print "<td class=\"link\" align=\"right\"> | </td>\n";
4807 } elsif ($status eq 'D') {
4808 print "<td class=\"link\">" .
4809 $cgi->a({-href => href(action=>"blob",
4812 file_name=>$from_path)},
4816 if ($diff->{'to_id'} eq $from_hash) {
4817 print "<td class=\"link nochange\">";
4819 print "<td class=\"link\">";
4821 print $cgi->a({-href => href(action=>"blobdiff",
4822 hash=>$diff->{'to_id'},
4823 hash_parent=>$from_hash,
4825 hash_parent_base=>$hash_parent,
4826 file_name=>$diff->{'to_file'},
4827 file_parent=>$from_path)},
4833 print "<td class=\"link\">";
4835 print $cgi->a({-href => href(action=>"blob",
4836 hash=>$diff->{'to_id'},
4837 file_name=>$diff->{'to_file'},
4840 print " | " if ($has_history);
4843 print $cgi->a({-href => href(action=>"history",
4844 file_name=>$diff->{'to_file'},
4851 next; # instead of 'else' clause, to avoid extra indent
4853 # else ordinary diff
4855 my ($to_mode_oct, $to_mode_str, $to_file_type);
4856 my ($from_mode_oct, $from_mode_str, $from_file_type);
4857 if ($diff->{'to_mode'} ne ('0' x 6)) {
4858 $to_mode_oct = oct $diff->{'to_mode'};
4859 if (S_ISREG($to_mode_oct)) { # only for regular file
4860 $to_mode_str = sprintf("%04o", $to_mode_oct & 0777); # permission bits
4862 $to_file_type = file_type($diff->{'to_mode'});
4864 if ($diff->{'from_mode'} ne ('0' x 6)) {
4865 $from_mode_oct = oct $diff->{'from_mode'};
4866 if (S_ISREG($from_mode_oct)) { # only for regular file
4867 $from_mode_str = sprintf("%04o", $from_mode_oct & 0777); # permission bits
4869 $from_file_type = file_type($diff->{'from_mode'});
4872 if ($diff->{'status'} eq "A") { # created
4873 my $mode_chng = "<span class=\"file_status new\">[new $to_file_type";
4874 $mode_chng .= " with mode: $to_mode_str" if $to_mode_str;
4875 $mode_chng .= "]</span>";
4877 print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'to_id'},
4878 hash_base=>$hash, file_name=>$diff->{'file'}),
4879 -class => "list"}, esc_path($diff->{'file'}));
4881 print "<td>$mode_chng</td>\n";
4882 print "<td class=\"link\">";
4883 if ($action eq 'commitdiff') {
4886 print $cgi->a({-href => href(-anchor=>"patch$patchno")},
4890 print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'to_id'},
4891 hash_base=>$hash, file_name=>$diff->{'file'})},
4895 } elsif ($diff->{'status'} eq "D") { # deleted
4896 my $mode_chng = "<span class=\"file_status deleted\">[deleted $from_file_type]</span>";
4898 print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'from_id'},
4899 hash_base=>$parent, file_name=>$diff->{'file'}),
4900 -class => "list"}, esc_path($diff->{'file'}));
4902 print "<td>$mode_chng</td>\n";
4903 print "<td class=\"link\">";
4904 if ($action eq 'commitdiff') {
4907 print $cgi->a({-href => href(-anchor=>"patch$patchno")},
4911 print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'from_id'},
4912 hash_base=>$parent, file_name=>$diff->{'file'})},
4915 print $cgi->a({-href => href(action=>"blame", hash_base=>$parent,
4916 file_name=>$diff->{'file'})},
4919 print $cgi->a({-href => href(action=>"history", hash_base=>$parent,
4920 file_name=>$diff->{'file'})},
4924 } elsif ($diff->{'status'} eq "M" || $diff->{'status'} eq "T") { # modified, or type changed
4925 my $mode_chnge = "";
4926 if ($diff->{'from_mode'} != $diff->{'to_mode'}) {
4927 $mode_chnge = "<span class=\"file_status mode_chnge\">[changed";
4928 if ($from_file_type ne $to_file_type) {
4929 $mode_chnge .= " from $from_file_type to $to_file_type";
4931 if (($from_mode_oct & 0777) != ($to_mode_oct & 0777)) {
4932 if ($from_mode_str && $to_mode_str) {
4933 $mode_chnge .= " mode: $from_mode_str->$to_mode_str";
4934 } elsif ($to_mode_str) {
4935 $mode_chnge .= " mode: $to_mode_str";
4938 $mode_chnge .= "]</span>\n";
4941 print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'to_id'},
4942 hash_base=>$hash, file_name=>$diff->{'file'}),
4943 -class => "list"}, esc_path($diff->{'file'}));
4945 print "<td>$mode_chnge</td>\n";
4946 print "<td class=\"link\">";
4947 if ($action eq 'commitdiff') {
4950 print $cgi->a({-href => href(-anchor=>"patch$patchno")},
4953 } elsif ($diff->{'to_id'} ne $diff->{'from_id'}) {
4954 # "commit" view and modified file (not onlu mode changed)
4955 print $cgi->a({-href => href(action=>"blobdiff",
4956 hash=>$diff->{'to_id'}, hash_parent=>$diff->{'from_id'},
4957 hash_base=>$hash, hash_parent_base=>$parent,
4958 file_name=>$diff->{'file'})},
4962 print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'to_id'},
4963 hash_base=>$hash, file_name=>$diff->{'file'})},
4966 print $cgi->a({-href => href(action=>"blame", hash_base=>$hash,
4967 file_name=>$diff->{'file'})},
4970 print $cgi->a({-href => href(action=>"history", hash_base=>$hash,
4971 file_name=>$diff->{'file'})},
4975 } elsif ($diff->{'status'} eq "R" || $diff->{'status'} eq "C") { # renamed or copied
4976 my %status_name = ('R' => 'moved', 'C' => 'copied');
4977 my $nstatus = $status_name{$diff->{'status'}};
4979 if ($diff->{'from_mode'} != $diff->{'to_mode'}) {
4980 # mode also for directories, so we cannot use $to_mode_str
4981 $mode_chng = sprintf(", mode: %04o", $to_mode_oct & 0777);
4984 $cgi->a({-href => href(action=>"blob", hash_base=>$hash,
4985 hash=>$diff->{'to_id'}, file_name=>$diff->{'to_file'}),
4986 -class => "list"}, esc_path($diff->{'to_file'})) . "</td>\n" .
4987 "<td><span class=\"file_status $nstatus\">[$nstatus from " .
4988 $cgi->a({-href => href(action=>"blob", hash_base=>$parent,
4989 hash=>$diff->{'from_id'}, file_name=>$diff->{'from_file'}),
4990 -class => "list"}, esc_path($diff->{'from_file'})) .
4991 " with " . (int $diff->{'similarity'}) . "% similarity$mode_chng]</span></td>\n" .
4992 "<td class=\"link\">";
4993 if ($action eq 'commitdiff') {
4996 print $cgi->a({-href => href(-anchor=>"patch$patchno")},
4999 } elsif ($diff->{'to_id'} ne $diff->{'from_id'}) {
5000 # "commit" view and modified file (not only pure rename or copy)
5001 print $cgi->a({-href => href(action=>"blobdiff",
5002 hash=>$diff->{'to_id'}, hash_parent=>$diff->{'from_id'},
5003 hash_base=>$hash, hash_parent_base=>$parent,
5004 file_name=>$diff->{'to_file'}, file_parent=>$diff->{'from_file'})},
5008 print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'to_id'},
5009 hash_base=>$parent, file_name=>$diff->{'to_file'})},
5012 print $cgi->a({-href => href(action=>"blame", hash_base=>$hash,
5013 file_name=>$diff->{'to_file'})},
5016 print $cgi->a({-href => href(action=>"history", hash_base=>$hash,
5017 file_name=>$diff->{'to_file'})},
5021 } # we should not encounter Unmerged (U) or Unknown (X) status
5024 print "</tbody>" if $has_header;
5028 # Print context lines and then rem/add lines in a side-by-side manner.
5029 sub print_sidebyside_diff_lines {
5030 my ($ctx, $rem, $add) = @_;
5032 # print context block before add/rem block
5035 '<div class="chunk_block ctx">',
5036 '<div class="old">',
5039 '<div class="new">',
5048 '<div class="chunk_block rem">',
5049 '<div class="old">',
5056 '<div class="chunk_block add">',
5057 '<div class="new">',
5063 '<div class="chunk_block chg">',
5064 '<div class="old">',
5067 '<div class="new">',
5074 # Print context lines and then rem/add lines in inline manner.
5075 sub print_inline_diff_lines {
5076 my ($ctx, $rem, $add) = @_;
5078 print @$ctx, @$rem, @$add;
5081 # Format removed and added line, mark changed part and HTML-format them.
5082 # Implementation is based on contrib/diff-highlight
5083 sub format_rem_add_lines_pair {
5084 my ($rem, $add, $num_parents) = @_;
5086 # We need to untabify lines before split()'ing them;
5087 # otherwise offsets would be invalid.
5090 $rem = untabify($rem);
5091 $add = untabify($add);
5093 my @rem = split(//, $rem);
5094 my @add = split(//, $add);
5095 my ($esc_rem, $esc_add);
5096 # Ignore leading +/- characters for each parent.
5097 my ($prefix_len, $suffix_len) = ($num_parents, 0);
5098 my ($prefix_has_nonspace, $suffix_has_nonspace);
5100 my $shorter = (@rem < @add) ? @rem : @add;
5101 while ($prefix_len < $shorter) {
5102 last if ($rem[$prefix_len] ne $add[$prefix_len]);
5104 $prefix_has_nonspace = 1 if ($rem[$prefix_len] !~ /\s/);
5108 while ($prefix_len + $suffix_len < $shorter) {
5109 last if ($rem[-1 - $suffix_len] ne $add[-1 - $suffix_len]);
5111 $suffix_has_nonspace = 1 if ($rem[-1 - $suffix_len] !~ /\s/);
5115 # Mark lines that are different from each other, but have some common
5116 # part that isn't whitespace. If lines are completely different, don't
5117 # mark them because that would make output unreadable, especially if
5118 # diff consists of multiple lines.
5119 if ($prefix_has_nonspace || $suffix_has_nonspace) {
5120 $esc_rem = esc_html_hl_regions($rem, 'marked',
5121 [$prefix_len, @rem - $suffix_len], -nbsp=>1);
5122 $esc_add = esc_html_hl_regions($add, 'marked',
5123 [$prefix_len, @add - $suffix_len], -nbsp=>1);
5125 $esc_rem = esc_html($rem, -nbsp=>1);
5126 $esc_add = esc_html($add, -nbsp=>1);
5129 return format_diff_line(\$esc_rem, 'rem'),
5130 format_diff_line(\$esc_add, 'add');
5133 # HTML-format diff context, removed and added lines.
5134 sub format_ctx_rem_add_lines {
5135 my ($ctx, $rem, $add, $num_parents) = @_;
5136 my (@new_ctx, @new_rem, @new_add);
5137 my $can_highlight = 0;
5138 my $is_combined = ($num_parents > 1);
5140 # Highlight if every removed line has a corresponding added line.
5141 if (@$add > 0 && @$add == @$rem) {
5144 # Highlight lines in combined diff only if the chunk contains
5145 # diff between the same version, e.g.
5152 # Otherwise the highlightling would be confusing.
5154 for (my $i = 0; $i < @$add; $i++) {
5155 my $prefix_rem = substr($rem->[$i], 0, $num_parents);
5156 my $prefix_add = substr($add->[$i], 0, $num_parents);
5158 $prefix_rem =~ s/-/+/g;
5160 if ($prefix_rem ne $prefix_add) {
5168 if ($can_highlight) {
5169 for (my $i = 0; $i < @$add; $i++) {
5170 my ($line_rem, $line_add) = format_rem_add_lines_pair(
5171 $rem->[$i], $add->[$i], $num_parents);
5172 push @new_rem, $line_rem;
5173 push @new_add, $line_add;
5176 @new_rem = map { format_diff_line($_, 'rem') } @$rem;
5177 @new_add = map { format_diff_line($_, 'add') } @$add;
5180 @new_ctx = map { format_diff_line($_, 'ctx') } @$ctx;
5182 return (\@new_ctx, \@new_rem, \@new_add);
5185 # Print context lines and then rem/add lines.
5186 sub print_diff_lines {
5187 my ($ctx, $rem, $add, $diff_style, $num_parents) = @_;
5188 my $is_combined = $num_parents > 1;
5190 ($ctx, $rem, $add) = format_ctx_rem_add_lines($ctx, $rem, $add,
5193 if ($diff_style eq 'sidebyside' && !$is_combined) {
5194 print_sidebyside_diff_lines($ctx, $rem, $add);
5196 # default 'inline' style and unknown styles
5197 print_inline_diff_lines($ctx, $rem, $add);
5201 sub print_diff_chunk {
5202 my ($diff_style, $num_parents, $from, $to, @chunk) = @_;
5203 my (@ctx, @rem, @add);
5205 # The class of the previous line.
5206 my $prev_class = '';
5208 return unless @chunk;
5210 # incomplete last line might be among removed or added lines,
5211 # or both, or among context lines: find which
5212 for (my $i = 1; $i < @chunk; $i++) {
5213 if ($chunk[$i][0] eq 'incomplete') {
5214 $chunk[$i][0] = $chunk[$i-1][0];
5219 push @chunk, ["", ""];
5221 foreach my $line_info (@chunk) {
5222 my ($class, $line) = @$line_info;
5224 # print chunk headers
5225 if ($class && $class eq 'chunk_header') {
5226 print format_diff_line($line, $class, $from, $to);
5230 ## print from accumulator when have some add/rem lines or end
5231 # of chunk (flush context lines), or when have add and rem
5232 # lines and new block is reached (otherwise add/rem lines could
5234 if (!$class || ((@rem || @add) && $class eq 'ctx') ||
5235 (@rem && @add && $class ne $prev_class)) {
5236 print_diff_lines(\@ctx, \@rem, \@add,
5237 $diff_style, $num_parents);
5238 @ctx = @rem = @add = ();
5241 ## adding lines to accumulator
5244 # rem, add or change
5245 if ($class eq 'rem') {
5247 } elsif ($class eq 'add') {
5251 if ($class eq 'ctx') {
5255 $prev_class = $class;
5259 sub git_patchset_body {
5260 my ($fd, $diff_style, $difftree, $hash, @hash_parents) = @_;
5261 my ($hash_parent) = $hash_parents[0];
5263 my $is_combined = (@hash_parents > 1);
5265 my $patch_number = 0;
5270 my @chunk; # for side-by-side diff
5272 print "<div class=\"patchset\">\n";
5274 # skip to first patch
5275 while ($patch_line = <$fd>) {
5278 last if ($patch_line =~ m/^diff /);
5282 while ($patch_line) {
5284 # parse "git diff" header line
5285 if ($patch_line =~ m/^diff --git (\"(?:[^\\\"]*(?:\\.[^\\\"]*)*)\"|[^ "]*) (.*)$/) {
5286 # $1 is from_name, which we do not use
5287 $to_name = unquote($2);
5288 $to_name =~ s!^b/!!;
5289 } elsif ($patch_line =~ m/^diff --(cc|combined) ("?.*"?)$/) {
5290 # $1 is 'cc' or 'combined', which we do not use
5291 $to_name = unquote($2);
5296 # check if current patch belong to current raw line
5297 # and parse raw git-diff line if needed
5298 if (is_patch_split($diffinfo, { 'to_file' => $to_name })) {
5299 # this is continuation of a split patch
5300 print "<div class=\"patch cont\">\n";
5302 # advance raw git-diff output if needed
5303 $patch_idx++ if defined $diffinfo;
5305 # read and prepare patch information
5306 $diffinfo = parsed_difftree_line($difftree->[$patch_idx]);
5308 # compact combined diff output can have some patches skipped
5309 # find which patch (using pathname of result) we are at now;
5311 while ($to_name ne $diffinfo->{'to_file'}) {
5312 print "<div class=\"patch\" id=\"patch". ($patch_idx+1) ."\">\n" .
5313 format_diff_cc_simplified($diffinfo, @hash_parents) .
5314 "</div>\n"; # class="patch"
5319 last if $patch_idx > $#$difftree;
5320 $diffinfo = parsed_difftree_line($difftree->[$patch_idx]);
5324 # modifies %from, %to hashes
5325 parse_from_to_diffinfo($diffinfo, \%from, \%to, @hash_parents);
5327 # this is first patch for raw difftree line with $patch_idx index
5328 # we index @$difftree array from 0, but number patches from 1
5329 print "<div class=\"patch\" id=\"patch". ($patch_idx+1) ."\">\n";
5333 #assert($patch_line =~ m/^diff /) if DEBUG;
5334 #assert($patch_line !~ m!$/$!) if DEBUG; # is chomp-ed
5336 # print "git diff" header
5337 print format_git_diff_header_line($patch_line, $diffinfo,
5340 # print extended diff header
5341 print "<div class=\"diff extended_header\">\n";
5343 while ($patch_line = <$fd>) {
5346 last EXTENDED_HEADER if ($patch_line =~ m/^--- |^diff /);
5348 print format_extended_diff_header_line($patch_line, $diffinfo,
5351 print "</div>\n"; # class="diff extended_header"
5353 # from-file/to-file diff header
5354 if (! $patch_line) {
5355 print "</div>\n"; # class="patch"
5358 next PATCH if ($patch_line =~ m/^diff /);
5359 #assert($patch_line =~ m/^---/) if DEBUG;
5361 my $last_patch_line = $patch_line;
5362 $patch_line = <$fd>;
5364 #assert($patch_line =~ m/^\+\+\+/) if DEBUG;
5366 print format_diff_from_to_header($last_patch_line, $patch_line,
5367 $diffinfo, \%from, \%to,
5372 while ($patch_line = <$fd>) {
5375 next PATCH if ($patch_line =~ m/^diff /);
5377 my $class = diff_line_class($patch_line, \%from, \%to);
5379 if ($class eq 'chunk_header') {
5380 print_diff_chunk($diff_style, scalar @hash_parents, \%from, \%to, @chunk);
5384 push @chunk, [ $class, $patch_line ];
5389 print_diff_chunk($diff_style, scalar @hash_parents, \%from, \%to, @chunk);
5392 print "</div>\n"; # class="patch"
5395 # for compact combined (--cc) format, with chunk and patch simplification
5396 # the patchset might be empty, but there might be unprocessed raw lines
5397 for (++$patch_idx if $patch_number > 0;
5398 $patch_idx < @$difftree;
5400 # read and prepare patch information
5401 $diffinfo = parsed_difftree_line($difftree->[$patch_idx]);
5403 # generate anchor for "patch" links in difftree / whatchanged part
5404 print "<div class=\"patch\" id=\"patch". ($patch_idx+1) ."\">\n" .
5405 format_diff_cc_simplified($diffinfo, @hash_parents) .
5406 "</div>\n"; # class="patch"
5411 if ($patch_number == 0) {
5412 if (@hash_parents > 1) {
5413 print "<div class=\"diff nodifferences\">Trivial merge</div>\n";
5415 print "<div class=\"diff nodifferences\">No differences found</div>\n";
5419 print "</div>\n"; # class="patchset"
5422 # . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5424 sub git_project_search_form {
5425 my ($searchtext, $search_use_regexp) = @_;
5428 if ($project_filter) {
5429 $limit = " in '$project_filter/'";
5432 print "<div class=\"projsearch\">\n";
5433 print $cgi->startform(-method => 'get', -action => $my_uri) .
5434 $cgi->hidden(-name => 'a', -value => 'project_list') . "\n";
5435 print $cgi->hidden(-name => 'pf', -value => $project_filter). "\n"
5436 if (defined $project_filter);
5437 print $cgi->textfield(-name => 's', -value => $searchtext,
5438 -title => "Search project by name and description$limit",
5439 -size => 60) . "\n" .
5440 "<span title=\"Extended regular expression\">" .
5441 $cgi->checkbox(-name => 'sr', -value => 1, -label => 're',
5442 -checked => $search_use_regexp) .
5444 $cgi->submit(-name => 'btnS', -value => 'Search') .
5445 $cgi->end_form() . "\n" .
5446 $cgi->a({-href => href(project => undef, searchtext => undef,
5447 project_filter => $project_filter)},
5448 esc_html("List all projects$limit")) . "<br />\n";
5452 # entry for given @keys needs filling if at least one of keys in list
5453 # is not present in %$project_info
5454 sub project_info_needs_filling {
5455 my ($project_info, @keys) = @_;
5457 # return List::MoreUtils::any { !exists $project_info->{$_} } @keys;
5458 foreach my $key (@keys) {
5459 if (!exists $project_info->{$key}) {
5466 # fills project list info (age, description, owner, category, forks, etc.)
5467 # for each project in the list, removing invalid projects from
5468 # returned list, or fill only specified info.
5470 # Invalid projects are removed from the returned list if and only if you
5471 # ask 'age' or 'age_string' to be filled, because they are the only fields
5472 # that run unconditionally git command that requires repository, and
5473 # therefore do always check if project repository is invalid.
5476 # * fill_project_list_info(\@project_list, 'descr_long', 'ctags')
5477 # ensures that 'descr_long' and 'ctags' fields are filled
5478 # * @project_list = fill_project_list_info(\@project_list)
5479 # ensures that all fields are filled (and invalid projects removed)
5481 # NOTE: modifies $projlist, but does not remove entries from it
5482 sub fill_project_list_info {
5483 my ($projlist, @wanted_keys) = @_;
5485 my $filter_set = sub { return @_; };
5487 my %wanted_keys = map { $_ => 1 } @wanted_keys;
5488 $filter_set = sub { return grep { $wanted_keys{$_} } @_; };
5491 my $show_ctags = gitweb_check_feature('ctags');
5493 foreach my $pr (@$projlist) {
5494 if (project_info_needs_filling($pr, $filter_set->('age', 'age_string'))) {
5495 my (@activity) = git_get_last_activity($pr->{'path'});
5496 unless (@activity) {
5499 ($pr->{'age'}, $pr->{'age_string'}) = @activity;
5501 if (project_info_needs_filling($pr, $filter_set->('descr', 'descr_long'))) {
5502 my $descr = git_get_project_description($pr->{'path'}) || "";
5503 $descr = to_utf8($descr);
5504 $pr->{'descr_long'} = $descr;
5505 $pr->{'descr'} = chop_str($descr, $projects_list_description_width, 5);
5507 if (project_info_needs_filling($pr, $filter_set->('owner'))) {
5508 $pr->{'owner'} = git_get_project_owner("$pr->{'path'}") || "";
5511 project_info_needs_filling($pr, $filter_set->('ctags'))) {
5512 $pr->{'ctags'} = git_get_project_ctags($pr->{'path'});
5514 if ($projects_list_group_categories &&
5515 project_info_needs_filling($pr, $filter_set->('category'))) {
5516 my $cat = git_get_project_category($pr->{'path'}) ||
5517 $project_list_default_category;
5518 $pr->{'category'} = to_utf8($cat);
5521 push @projects, $pr;
5527 sub sort_projects_list {
5528 my ($projlist, $order) = @_;
5532 project => { key => 'path', type => 'str' },
5533 descr => { key => 'descr_long', type => 'str' },
5534 owner => { key => 'owner', type => 'str' },
5535 age => { key => 'age', type => 'num' }
5537 my $oi = $order_info{$order};
5538 return @$projlist unless defined $oi;
5539 if ($oi->{'type'} eq 'str') {
5540 @projects = sort {$a->{$oi->{'key'}} cmp $b->{$oi->{'key'}}} @$projlist;
5542 @projects = sort {$a->{$oi->{'key'}} <=> $b->{$oi->{'key'}}} @$projlist;
5548 # returns a hash of categories, containing the list of project
5549 # belonging to each category
5550 sub build_projlist_by_category {
5551 my ($projlist, $from, $to) = @_;
5554 $from = 0 unless defined $from;
5555 $to = $#$projlist if (!defined $to || $#$projlist < $to);
5557 for (my $i = $from; $i <= $to; $i++) {
5558 my $pr = $projlist->[$i];
5559 push @{$categories{ $pr->{'category'} }}, $pr;
5562 return wantarray ? %categories : \%categories;
5565 # print 'sort by' <th> element, generating 'sort by $name' replay link
5566 # if that order is not selected
5568 print format_sort_th(@_);
5571 sub format_sort_th {
5572 my ($name, $order, $header) = @_;
5574 $header ||= ucfirst($name);
5576 if ($order eq $name) {
5577 $sort_th .= "<th>$header</th>\n";
5579 $sort_th .= "<th>" .
5580 $cgi->a({-href => href(-replay=>1, order=>$name),
5581 -class => "header"}, $header) .
5588 sub git_project_list_rows {
5589 my ($projlist, $from, $to, $check_forks) = @_;
5591 $from = 0 unless defined $from;
5592 $to = $#$projlist if (!defined $to || $#$projlist < $to);
5595 for (my $i = $from; $i <= $to; $i++) {
5596 my $pr = $projlist->[$i];
5599 print "<tr class=\"dark\">\n";
5601 print "<tr class=\"light\">\n";
5607 if ($pr->{'forks'}) {
5608 my $nforks = scalar @{$pr->{'forks'}};
5610 print $cgi->a({-href => href(project=>$pr->{'path'}, action=>"forks"),
5611 -title => "$nforks forks"}, "+");
5613 print $cgi->span({-title => "$nforks forks"}, "+");
5618 print "<td>" . $cgi->a({-href => href(project=>$pr->{'path'}, action=>"summary"),
5620 esc_html_match_hl($pr->{'path'}, $search_regexp)) .
5622 "<td>" . $cgi->a({-href => href(project=>$pr->{'path'}, action=>"summary"),
5624 -title => $pr->{'descr_long'}},
5626 ? esc_html_match_hl_chopped($pr->{'descr_long'},
5627 $pr->{'descr'}, $search_regexp)
5628 : esc_html($pr->{'descr'})) .
5630 unless ($omit_owner) {
5631 print "<td><i>" . chop_and_escape_str($pr->{'owner'}, 15) . "</i></td>\n";
5633 unless ($omit_age_column) {
5634 print "<td class=\"". age_class($pr->{'age'}) . "\">" .
5635 (defined $pr->{'age_string'} ? $pr->{'age_string'} : "No commits") . "</td>\n";
5637 print"<td class=\"link\">" .
5638 $cgi->a({-href => href(project=>$pr->{'path'}, action=>"summary")}, "summary") . " | " .
5639 $cgi->a({-href => href(project=>$pr->{'path'}, action=>"shortlog")}, "shortlog") . " | " .
5640 $cgi->a({-href => href(project=>$pr->{'path'}, action=>"log")}, "log") . " | " .
5641 $cgi->a({-href => href(project=>$pr->{'path'}, action=>"tree")}, "tree") .
5642 ($pr->{'forks'} ? " | " . $cgi->a({-href => href(project=>$pr->{'path'}, action=>"forks")}, "forks") : '') .
5648 sub git_project_list_body {
5649 # actually uses global variable $project
5650 my ($projlist, $order, $from, $to, $extra, $no_header) = @_;
5651 my @projects = @$projlist;
5653 my $check_forks = gitweb_check_feature('forks');
5654 my $show_ctags = gitweb_check_feature('ctags');
5655 my $tagfilter = $show_ctags ? $input_params{'ctag'} : undef;
5656 $check_forks = undef
5657 if ($tagfilter || $search_regexp);
5659 # filtering out forks before filling info allows to do less work
5660 @projects = filter_forks_from_projects_list(\@projects)
5662 # search_projects_list pre-fills required info
5663 @projects = search_projects_list(\@projects,
5664 'search_regexp' => $search_regexp,
5665 'tagfilter' => $tagfilter)
5666 if ($tagfilter || $search_regexp);
5668 my @all_fields = ('descr', 'descr_long', 'ctags', 'category');
5669 push @all_fields, ('age', 'age_string') unless($omit_age_column);
5670 push @all_fields, 'owner' unless($omit_owner);
5671 @projects = fill_project_list_info(\@projects, @all_fields);
5673 $order ||= $default_projects_order;
5674 $from = 0 unless defined $from;
5675 $to = $#projects if (!defined $to || $#projects < $to);
5680 "<b>No such projects found</b><br />\n".
5681 "Click ".$cgi->a({-href=>href(project=>undef)},"here")." to view all projects<br />\n".
5682 "</center>\n<br />\n";
5686 @projects = sort_projects_list(\@projects, $order);
5689 my $ctags = git_gather_all_ctags(\@projects);
5690 my $cloud = git_populate_project_tagcloud($ctags);
5691 print git_show_project_tagcloud($cloud, 64);
5694 print "<table class=\"project_list\">\n";
5695 unless ($no_header) {
5698 print "<th></th>\n";
5700 print_sort_th('project', $order, 'Project');
5701 print_sort_th('descr', $order, 'Description');
5702 print_sort_th('owner', $order, 'Owner') unless $omit_owner;
5703 print_sort_th('age', $order, 'Last Change') unless $omit_age_column;
5704 print "<th></th>\n" . # for links
5708 if ($projects_list_group_categories) {
5709 # only display categories with projects in the $from-$to window
5710 @projects = sort {$a->{'category'} cmp $b->{'category'}} @projects[$from..$to];
5711 my %categories = build_projlist_by_category(\@projects, $from, $to);
5712 foreach my $cat (sort keys %categories) {
5713 unless ($cat eq "") {
5716 print "<td></td>\n";
5718 print "<td class=\"category\" colspan=\"5\">".esc_html($cat)."</td>\n";
5722 git_project_list_rows($categories{$cat}, undef, undef, $check_forks);
5725 git_project_list_rows(\@projects, $from, $to, $check_forks);
5728 if (defined $extra) {
5731 print "<td></td>\n";
5733 print "<td colspan=\"5\">$extra</td>\n" .
5740 # uses global variable $project
5741 my ($commitlist, $from, $to, $refs, $extra) = @_;
5743 $from = 0 unless defined $from;
5744 $to = $#{$commitlist} if (!defined $to || $#{$commitlist} < $to);
5746 for (my $i = 0; $i <= $to; $i++) {
5747 my %co = %{$commitlist->[$i]};
5749 my $commit = $co{'id'};
5750 my $ref = format_ref_marker($refs, $commit);
5751 git_print_header_div('commit',
5752 "<span class=\"age\">$co{'age_string'}</span>" .
5753 esc_html($co{'title'}) . $ref,
5755 print "<div class=\"title_text\">\n" .
5756 "<div class=\"log_link\">\n" .
5757 $cgi->a({-href => href(action=>"commit", hash=>$commit)}, "commit") .
5759 $cgi->a({-href => href(action=>"commitdiff", hash=>$commit)}, "commitdiff") .
5761 $cgi->a({-href => href(action=>"tree", hash=>$commit, hash_base=>$commit)}, "tree") .
5764 git_print_authorship(\%co, -tag => 'span');
5765 print "<br/>\n</div>\n";
5767 print "<div class=\"log_body\">\n";
5768 git_print_log($co{'comment'}, -final_empty_line=> 1);
5772 print "<div class=\"page_nav\">\n";
5778 sub git_shortlog_body {
5779 # uses global variable $project
5780 my ($commitlist, $from, $to, $refs, $extra) = @_;
5782 $from = 0 unless defined $from;
5783 $to = $#{$commitlist} if (!defined $to || $#{$commitlist} < $to);
5785 print "<table class=\"shortlog\">\n";
5787 for (my $i = $from; $i <= $to; $i++) {
5788 my %co = %{$commitlist->[$i]};
5789 my $commit = $co{'id'};
5790 my $ref = format_ref_marker($refs, $commit);
5792 print "<tr class=\"dark\">\n";
5794 print "<tr class=\"light\">\n";
5797 # git_summary() used print "<td><i>$co{'age_string'}</i></td>\n" .
5798 print "<td title=\"$co{'age_string_age'}\"><i>$co{'age_string_date'}</i></td>\n" .
5799 format_author_html('td', \%co, 10) . "<td>";
5800 print format_subject_html($co{'title'}, $co{'title_short'},
5801 href(action=>"commit", hash=>$commit), $ref);
5803 "<td class=\"link\">" .
5804 $cgi->a({-href => href(action=>"commit", hash=>$commit)}, "commit") . " | " .
5805 $cgi->a({-href => href(action=>"commitdiff", hash=>$commit)}, "commitdiff") . " | " .
5806 $cgi->a({-href => href(action=>"tree", hash=>$commit, hash_base=>$commit)}, "tree");
5807 my $snapshot_links = format_snapshot_links($commit);
5808 if (defined $snapshot_links) {
5809 print " | " . $snapshot_links;
5814 if (defined $extra) {
5816 "<td colspan=\"4\">$extra</td>\n" .
5822 sub git_history_body {
5823 # Warning: assumes constant type (blob or tree) during history
5824 my ($commitlist, $from, $to, $refs, $extra,
5825 $file_name, $file_hash, $ftype) = @_;
5827 $from = 0 unless defined $from;
5828 $to = $#{$commitlist} unless (defined $to && $to <= $#{$commitlist});
5830 print "<table class=\"history\">\n";
5832 for (my $i = $from; $i <= $to; $i++) {
5833 my %co = %{$commitlist->[$i]};
5837 my $commit = $co{'id'};
5839 my $ref = format_ref_marker($refs, $commit);
5842 print "<tr class=\"dark\">\n";
5844 print "<tr class=\"light\">\n";
5847 print "<td title=\"$co{'age_string_age'}\"><i>$co{'age_string_date'}</i></td>\n" .
5848 # shortlog: format_author_html('td', \%co, 10)
5849 format_author_html('td', \%co, 15, 3) . "<td>";
5850 # originally git_history used chop_str($co{'title'}, 50)
5851 print format_subject_html($co{'title'}, $co{'title_short'},
5852 href(action=>"commit", hash=>$commit), $ref);
5854 "<td class=\"link\">" .
5855 $cgi->a({-href => href(action=>$ftype, hash_base=>$commit, file_name=>$file_name)}, $ftype) . " | " .
5856 $cgi->a({-href => href(action=>"commitdiff", hash=>$commit)}, "commitdiff");
5858 if ($ftype eq 'blob') {
5859 my $blob_current = $file_hash;
5860 my $blob_parent = git_get_hash_by_path($commit, $file_name);
5861 if (defined $blob_current && defined $blob_parent &&
5862 $blob_current ne $blob_parent) {
5864 $cgi->a({-href => href(action=>"blobdiff",
5865 hash=>$blob_current, hash_parent=>$blob_parent,
5866 hash_base=>$hash_base, hash_parent_base=>$commit,
5867 file_name=>$file_name)},
5874 if (defined $extra) {
5876 "<td colspan=\"4\">$extra</td>\n" .
5883 # uses global variable $project
5884 my ($taglist, $from, $to, $extra) = @_;
5885 $from = 0 unless defined $from;
5886 $to = $#{$taglist} if (!defined $to || $#{$taglist} < $to);
5888 print "<table class=\"tags\">\n";
5890 for (my $i = $from; $i <= $to; $i++) {
5891 my $entry = $taglist->[$i];
5893 my $comment = $tag{'subject'};
5895 if (defined $comment) {
5896 $comment_short = chop_str($comment, 30, 5);
5899 print "<tr class=\"dark\">\n";
5901 print "<tr class=\"light\">\n";
5904 if (defined $tag{'age'}) {
5905 print "<td><i>$tag{'age'}</i></td>\n";
5907 print "<td></td>\n";
5910 $cgi->a({-href => href(action=>$tag{'reftype'}, hash=>$tag{'refid'}),
5911 -class => "list name"}, esc_html($tag{'name'})) .
5914 if (defined $comment) {
5915 print format_subject_html($comment, $comment_short,
5916 href(action=>"tag", hash=>$tag{'id'}));
5919 "<td class=\"selflink\">";
5920 if ($tag{'type'} eq "tag") {
5921 print $cgi->a({-href => href(action=>"tag", hash=>$tag{'id'})}, "tag");
5926 "<td class=\"link\">" . " | " .
5927 $cgi->a({-href => href(action=>$tag{'reftype'}, hash=>$tag{'refid'})}, $tag{'reftype'});
5928 if ($tag{'reftype'} eq "commit") {
5929 print " | " . $cgi->a({-href => href(action=>"shortlog", hash=>$tag{'fullname'})}, "shortlog") .
5930 " | " . $cgi->a({-href => href(action=>"log", hash=>$tag{'fullname'})}, "log");
5931 } elsif ($tag{'reftype'} eq "blob") {
5932 print " | " . $cgi->a({-href => href(action=>"blob_plain", hash=>$tag{'refid'})}, "raw");
5937 if (defined $extra) {
5939 "<td colspan=\"5\">$extra</td>\n" .
5945 sub git_heads_body {
5946 # uses global variable $project
5947 my ($headlist, $head_at, $from, $to, $extra) = @_;
5948 $from = 0 unless defined $from;
5949 $to = $#{$headlist} if (!defined $to || $#{$headlist} < $to);
5951 print "<table class=\"heads\">\n";
5953 for (my $i = $from; $i <= $to; $i++) {
5954 my $entry = $headlist->[$i];
5956 my $curr = defined $head_at && $ref{'id'} eq $head_at;
5958 print "<tr class=\"dark\">\n";
5960 print "<tr class=\"light\">\n";
5963 print "<td><i>$ref{'age'}</i></td>\n" .
5964 ($curr ? "<td class=\"current_head\">" : "<td>") .
5965 $cgi->a({-href => href(action=>"shortlog", hash=>$ref{'fullname'}),
5966 -class => "list name"},esc_html($ref{'name'})) .
5968 "<td class=\"link\">" .
5969 $cgi->a({-href => href(action=>"shortlog", hash=>$ref{'fullname'})}, "shortlog") . " | " .
5970 $cgi->a({-href => href(action=>"log", hash=>$ref{'fullname'})}, "log") . " | " .
5971 $cgi->a({-href => href(action=>"tree", hash=>$ref{'fullname'}, hash_base=>$ref{'fullname'})}, "tree") .
5975 if (defined $extra) {
5977 "<td colspan=\"3\">$extra</td>\n" .
5983 # Display a single remote block
5984 sub git_remote_block {
5985 my ($remote, $rdata, $limit, $head) = @_;
5987 my $heads = $rdata->{'heads'};
5988 my $fetch = $rdata->{'fetch'};
5989 my $push = $rdata->{'push'};
5991 my $urls_table = "<table class=\"projects_list\">\n" ;
5993 if (defined $fetch) {
5994 if ($fetch eq $push) {
5995 $urls_table .= format_repo_url("URL", $fetch);
5997 $urls_table .= format_repo_url("Fetch URL", $fetch);
5998 $urls_table .= format_repo_url("Push URL", $push) if defined $push;
6000 } elsif (defined $push) {
6001 $urls_table .= format_repo_url("Push URL", $push);
6003 $urls_table .= format_repo_url("", "No remote URL");
6006 $urls_table .= "</table>\n";
6009 if (defined $limit && $limit < @$heads) {
6010 $dots = $cgi->a({-href => href(action=>"remotes", hash=>$remote)}, "...");
6014 git_heads_body($heads, $head, 0, $limit, $dots);
6017 # Display a list of remote names with the respective fetch and push URLs
6018 sub git_remotes_list {
6019 my ($remotedata, $limit) = @_;
6020 print "<table class=\"heads\">\n";
6022 my @remotes = sort keys %$remotedata;
6024 my $limited = $limit && $limit < @remotes;
6026 $#remotes = $limit - 1 if $limited;
6028 while (my $remote = shift @remotes) {
6029 my $rdata = $remotedata->{$remote};
6030 my $fetch = $rdata->{'fetch'};
6031 my $push = $rdata->{'push'};
6033 print "<tr class=\"dark\">\n";
6035 print "<tr class=\"light\">\n";
6039 $cgi->a({-href=> href(action=>'remotes', hash=>$remote),
6040 -class=> "list name"},esc_html($remote)) .
6042 print "<td class=\"link\">" .
6043 (defined $fetch ? $cgi->a({-href=> $fetch}, "fetch") : "fetch") .
6045 (defined $push ? $cgi->a({-href=> $push}, "push") : "push") .
6053 "<td colspan=\"3\">" .
6054 $cgi->a({-href => href(action=>"remotes")}, "...") .
6055 "</td>\n" . "</tr>\n";
6061 # Display remote heads grouped by remote, unless there are too many
6062 # remotes, in which case we only display the remote names
6063 sub git_remotes_body {
6064 my ($remotedata, $limit, $head) = @_;
6065 if ($limit and $limit < keys %$remotedata) {
6066 git_remotes_list($remotedata, $limit);
6068 fill_remote_heads($remotedata);
6069 while (my ($remote, $rdata) = each %$remotedata) {
6070 git_print_section({-class=>"remote", -id=>$remote},
6071 ["remotes", $remote, $remote], sub {
6072 git_remote_block($remote, $rdata, $limit, $head);
6078 sub git_search_message {
6082 if ($searchtype eq 'commit') {
6083 $greptype = "--grep=";
6084 } elsif ($searchtype eq 'author') {
6085 $greptype = "--author=";
6086 } elsif ($searchtype eq 'committer') {
6087 $greptype = "--committer=";
6089 $greptype .= $searchtext;
6090 my @commitlist = parse_commits($hash, 101, (100 * $page), undef,
6091 $greptype, '--regexp-ignore-case',
6092 $search_use_regexp ? '--extended-regexp' : '--fixed-strings');
6094 my $paging_nav = '';
6097 $cgi->a({-href => href(-replay=>1, page=>undef)},
6100 $cgi->a({-href => href(-replay=>1, page=>$page-1),
6101 -accesskey => "p", -title => "Alt-p"}, "prev");
6103 $paging_nav .= "first ⋅ prev";
6106 if ($#commitlist >= 100) {
6108 $cgi->a({-href => href(-replay=>1, page=>$page+1),
6109 -accesskey => "n", -title => "Alt-n"}, "next");
6110 $paging_nav .= " ⋅ $next_link";
6112 $paging_nav .= " ⋅ next";
6117 git_print_page_nav('','', $hash,$co{'tree'},$hash, $paging_nav);
6118 git_print_header_div('commit', esc_html($co{'title'}), $hash);
6119 if ($page == 0 && !@commitlist) {
6120 print "<p>No match.</p>\n";
6122 git_search_grep_body(\@commitlist, 0, 99, $next_link);
6128 sub git_search_changes {
6132 open my $fd, '-|', git_cmd(), '--no-pager', 'log', @diff_opts,
6133 '--pretty=format:%H', '--no-abbrev', '--raw', "-S$searchtext",
6134 ($search_use_regexp ? '--pickaxe-regex' : ())
6135 or die_error(500, "Open git-log failed");
6139 git_print_page_nav('','', $hash,$co{'tree'},$hash);
6140 git_print_header_div('commit', esc_html($co{'title'}), $hash);
6142 print "<table class=\"pickaxe search\">\n";
6146 while (my $line = <$fd>) {
6150 my %set = parse_difftree_raw_line($line);
6151 if (defined $set{'commit'}) {
6152 # finish previous commit
6155 "<td class=\"link\">" .
6156 $cgi->a({-href => href(action=>"commit", hash=>$co{'id'})},
6159 $cgi->a({-href => href(action=>"tree", hash=>$co{'tree'},
6160 hash_base=>$co{'id'})},
6167 print "<tr class=\"dark\">\n";
6169 print "<tr class=\"light\">\n";
6172 %co = parse_commit($set{'commit'});
6173 my $author = chop_and_escape_str($co{'author_name'}, 15, 5);
6174 print "<td title=\"$co{'age_string_age'}\"><i>$co{'age_string_date'}</i></td>\n" .
6175 "<td><i>$author</i></td>\n" .
6177 $cgi->a({-href => href(action=>"commit", hash=>$co{'id'}),
6178 -class => "list subject"},
6179 chop_and_escape_str($co{'title'}, 50) . "<br/>");
6180 } elsif (defined $set{'to_id'}) {
6181 next if ($set{'to_id'} =~ m/^0{40}$/);
6183 print $cgi->a({-href => href(action=>"blob", hash_base=>$co{'id'},
6184 hash=>$set{'to_id'}, file_name=>$set{'to_file'}),
6186 "<span class=\"match\">" . esc_path($set{'file'}) . "</span>") .
6192 # finish last commit (warning: repetition!)
6195 "<td class=\"link\">" .
6196 $cgi->a({-href => href(action=>"commit", hash=>$co{'id'})},
6199 $cgi->a({-href => href(action=>"tree", hash=>$co{'tree'},
6200 hash_base=>$co{'id'})},
6211 sub git_search_files {
6215 open my $fd, "-|", git_cmd(), 'grep', '-n', '-z',
6216 $search_use_regexp ? ('-E', '-i') : '-F',
6217 $searchtext, $co{'tree'}
6218 or die_error(500, "Open git-grep failed");
6222 git_print_page_nav('','', $hash,$co{'tree'},$hash);
6223 git_print_header_div('commit', esc_html($co{'title'}), $hash);
6225 print "<table class=\"grep_search\">\n";
6230 while (my $line = <$fd>) {
6232 my ($file, $lno, $ltext, $binary);
6233 last if ($matches++ > 1000);
6234 if ($line =~ /^Binary file (.+) matches$/) {
6238 ($file, $lno, $ltext) = split(/\0/, $line, 3);
6239 $file =~ s/^$co{'tree'}://;
6241 if ($file ne $lastfile) {
6242 $lastfile and print "</td></tr>\n";
6244 print "<tr class=\"dark\">\n";
6246 print "<tr class=\"light\">\n";
6248 $file_href = href(action=>"blob", hash_base=>$co{'id'},
6250 print "<td class=\"list\">".
6251 $cgi->a({-href => $file_href, -class => "list"}, esc_path($file));
6252 print "</td><td>\n";
6256 print "<div class=\"binary\">Binary file</div>\n";
6258 $ltext = untabify($ltext);
6259 if ($ltext =~ m/^(.*)($search_regexp)(.*)$/i) {
6260 $ltext = esc_html($1, -nbsp=>1);
6261 $ltext .= '<span class="match">';
6262 $ltext .= esc_html($2, -nbsp=>1);
6263 $ltext .= '</span>';
6264 $ltext .= esc_html($3, -nbsp=>1);
6266 $ltext = esc_html($ltext, -nbsp=>1);
6268 print "<div class=\"pre\">" .
6269 $cgi->a({-href => $file_href.'#l'.$lno,
6270 -class => "linenr"}, sprintf('%4i', $lno)) .
6271 ' ' . $ltext . "</div>\n";
6275 print "</td></tr>\n";
6276 if ($matches > 1000) {
6277 print "<div class=\"diff nodifferences\">Too many matches, listing trimmed</div>\n";
6280 print "<div class=\"diff nodifferences\">No matches found</div>\n";
6289 sub git_search_grep_body {
6290 my ($commitlist, $from, $to, $extra) = @_;
6291 $from = 0 unless defined $from;
6292 $to = $#{$commitlist} if (!defined $to || $#{$commitlist} < $to);
6294 print "<table class=\"commit_search\">\n";
6296 for (my $i = $from; $i <= $to; $i++) {
6297 my %co = %{$commitlist->[$i]};
6301 my $commit = $co{'id'};
6303 print "<tr class=\"dark\">\n";
6305 print "<tr class=\"light\">\n";
6308 print "<td title=\"$co{'age_string_age'}\"><i>$co{'age_string_date'}</i></td>\n" .
6309 format_author_html('td', \%co, 15, 5) .
6311 $cgi->a({-href => href(action=>"commit", hash=>$co{'id'}),
6312 -class => "list subject"},
6313 chop_and_escape_str($co{'title'}, 50) . "<br/>");
6314 my $comment = $co{'comment'};
6315 foreach my $line (@$comment) {
6316 if ($line =~ m/^(.*?)($search_regexp)(.*)$/i) {
6317 my ($lead, $match, $trail) = ($1, $2, $3);
6318 $match = chop_str($match, 70, 5, 'center');
6319 my $contextlen = int((80 - length($match))/2);
6320 $contextlen = 30 if ($contextlen > 30);
6321 $lead = chop_str($lead, $contextlen, 10, 'left');
6322 $trail = chop_str($trail, $contextlen, 10, 'right');
6324 $lead = esc_html($lead);
6325 $match = esc_html($match);
6326 $trail = esc_html($trail);
6328 print "$lead<span class=\"match\">$match</span>$trail<br />";
6332 "<td class=\"link\">" .
6333 $cgi->a({-href => href(action=>"commit", hash=>$co{'id'})}, "commit") .
6335 $cgi->a({-href => href(action=>"commitdiff", hash=>$co{'id'})}, "commitdiff") .
6337 $cgi->a({-href => href(action=>"tree", hash=>$co{'tree'}, hash_base=>$co{'id'})}, "tree");
6341 if (defined $extra) {
6343 "<td colspan=\"3\">$extra</td>\n" .
6349 ## ======================================================================
6350 ## ======================================================================
6353 sub git_project_list {
6354 my $order = $input_params{'order'};
6355 if (defined $order && $order !~ m/none|project|descr|owner|age/) {
6356 die_error(400, "Unknown order parameter");
6359 my @list = git_get_projects_list($project_filter, $strict_export);
6361 die_error(404, "No projects found");
6365 if (defined $home_text && -f $home_text) {
6366 print "<div class=\"index_include\">\n";
6367 insert_file($home_text);
6371 git_project_search_form($searchtext, $search_use_regexp);
6372 git_project_list_body(\@list, $order);
6377 my $order = $input_params{'order'};
6378 if (defined $order && $order !~ m/none|project|descr|owner|age/) {
6379 die_error(400, "Unknown order parameter");
6382 my $filter = $project;
6383 $filter =~ s/\.git$//;
6384 my @list = git_get_projects_list($filter);
6386 die_error(404, "No forks found");
6390 git_print_page_nav('','');
6391 git_print_header_div('summary', "$project forks");
6392 git_project_list_body(\@list, $order);
6396 sub git_project_index {
6397 my @projects = git_get_projects_list($project_filter, $strict_export);
6399 die_error(404, "No projects found");
6403 -type => 'text/plain',
6404 -charset => 'utf-8',
6405 -content_disposition => 'inline; filename="index.aux"');
6407 foreach my $pr (@projects) {
6408 if (!exists $pr->{'owner'}) {
6409 $pr->{'owner'} = git_get_project_owner("$pr->{'path'}");
6412 my ($path, $owner) = ($pr->{'path'}, $pr->{'owner'});
6413 # quote as in CGI::Util::encode, but keep the slash, and use '+' for ' '
6414 $path =~ s/([^a-zA-Z0-9_.\-\/ ])/sprintf("%%%02X", ord($1))/eg;
6415 $owner =~ s/([^a-zA-Z0-9_.\-\/ ])/sprintf("%%%02X", ord($1))/eg;
6419 print "$path $owner\n";
6424 my $descr = git_get_project_description($project) || "none";
6425 my %co = parse_commit("HEAD");
6426 my %cd = %co ? parse_date($co{'committer_epoch'}, $co{'committer_tz'}) : ();
6427 my $head = $co{'id'};
6428 my $remote_heads = gitweb_check_feature('remote_heads');
6430 my $owner = git_get_project_owner($project);
6432 my $refs = git_get_references();
6433 # These get_*_list functions return one more to allow us to see if
6434 # there are more ...
6435 my @taglist = git_get_tags_list(16);
6436 my @headlist = git_get_heads_list(16);
6437 my %remotedata = $remote_heads ? git_get_remotes_list() : ();
6439 my $check_forks = gitweb_check_feature('forks');
6442 # find forks of a project
6443 my $filter = $project;
6444 $filter =~ s/\.git$//;
6445 @forklist = git_get_projects_list($filter);
6446 # filter out forks of forks
6447 @forklist = filter_forks_from_projects_list(\@forklist)
6452 git_print_page_nav('summary','', $head);
6454 print "<div class=\"title\"> </div>\n";
6455 print "<table class=\"projects_list\">\n" .
6456 "<tr id=\"metadata_desc\"><td>description</td><td>" . esc_html($descr) . "</td></tr>\n";
6457 unless ($omit_owner) {
6458 print "<tr id=\"metadata_owner\"><td>owner</td><td>" . esc_html($owner) . "</td></tr>\n";
6460 if (defined $cd{'rfc2822'}) {
6461 print "<tr id=\"metadata_lchange\"><td>last change</td>" .
6462 "<td>".format_timestamp_html(\%cd)."</td></tr>\n";
6465 # use per project git URL list in $projectroot/$project/cloneurl
6466 # or make project git URL from git base URL and project name
6467 my $url_tag = "URL";
6468 my @url_list = git_get_project_url_list($project);
6469 @url_list = map { "$_/$project" } @git_base_url_list unless @url_list;
6470 foreach my $git_url (@url_list) {
6471 next unless $git_url;
6472 print format_repo_url($url_tag, $git_url);
6477 my $show_ctags = gitweb_check_feature('ctags');
6479 my $ctags = git_get_project_ctags($project);
6481 # without ability to add tags, don't show if there are none
6482 my $cloud = git_populate_project_tagcloud($ctags);
6483 print "<tr id=\"metadata_ctags\">" .
6484 "<td>content tags</td>" .
6485 "<td>".git_show_project_tagcloud($cloud, 48)."</td>" .
6492 # If XSS prevention is on, we don't include README.html.
6493 # TODO: Allow a readme in some safe format.
6494 if (!$prevent_xss && -s "$projectroot/$project/README.html") {
6495 print "<div class=\"title\">readme</div>\n" .
6496 "<div class=\"readme\">\n";
6497 insert_file("$projectroot/$project/README.html");
6498 print "\n</div>\n"; # class="readme"
6501 # we need to request one more than 16 (0..15) to check if
6503 my @commitlist = $head ? parse_commits($head, 17) : ();
6505 git_print_header_div('shortlog');
6506 git_shortlog_body(\@commitlist, 0, 15, $refs,
6507 $#commitlist <= 15 ? undef :
6508 $cgi->a({-href => href(action=>"shortlog")}, "..."));
6512 git_print_header_div('tags');
6513 git_tags_body(\@taglist, 0, 15,
6514 $#taglist <= 15 ? undef :
6515 $cgi->a({-href => href(action=>"tags")}, "..."));
6519 git_print_header_div('heads');
6520 git_heads_body(\@headlist, $head, 0, 15,
6521 $#headlist <= 15 ? undef :
6522 $cgi->a({-href => href(action=>"heads")}, "..."));
6526 git_print_header_div('remotes');
6527 git_remotes_body(\%remotedata, 15, $head);
6531 git_print_header_div('forks');
6532 git_project_list_body(\@forklist, 'age', 0, 15,
6533 $#forklist <= 15 ? undef :
6534 $cgi->a({-href => href(action=>"forks")}, "..."),
6542 my %tag = parse_tag($hash);
6545 die_error(404, "Unknown tag object");
6548 my $head = git_get_head_hash($project);
6550 git_print_page_nav('','', $head,undef,$head);
6551 git_print_header_div('commit', esc_html($tag{'name'}), $hash);
6552 print "<div class=\"title_text\">\n" .
6553 "<table class=\"object_header\">\n" .
6555 "<td>object</td>\n" .
6556 "<td>" . $cgi->a({-class => "list", -href => href(action=>$tag{'type'}, hash=>$tag{'object'})},
6557 $tag{'object'}) . "</td>\n" .
6558 "<td class=\"link\">" . $cgi->a({-href => href(action=>$tag{'type'}, hash=>$tag{'object'})},
6559 $tag{'type'}) . "</td>\n" .
6561 if (defined($tag{'author'})) {
6562 git_print_authorship_rows(\%tag, 'author');
6564 print "</table>\n\n" .
6566 print "<div class=\"page_body\">";
6567 my $comment = $tag{'comment'};
6568 foreach my $line (@$comment) {
6570 print esc_html($line, -nbsp=>1) . "<br/>\n";
6576 sub git_blame_common {
6577 my $format = shift || 'porcelain';
6578 if ($format eq 'porcelain' && $input_params{'javascript'}) {
6579 $format = 'incremental';
6580 $action = 'blame_incremental'; # for page title etc
6584 gitweb_check_feature('blame')
6585 or die_error(403, "Blame view not allowed");
6588 die_error(400, "No file name given") unless $file_name;
6589 $hash_base ||= git_get_head_hash($project);
6590 die_error(404, "Couldn't find base commit") unless $hash_base;
6591 my %co = parse_commit($hash_base)
6592 or die_error(404, "Commit not found");
6594 if (!defined $hash) {
6595 $hash = git_get_hash_by_path($hash_base, $file_name, "blob")
6596 or die_error(404, "Error looking up file");
6598 $ftype = git_get_type($hash);
6599 if ($ftype !~ "blob") {
6600 die_error(400, "Object is not a blob");
6605 if ($format eq 'incremental') {
6606 # get file contents (as base)
6607 open $fd, "-|", git_cmd(), 'cat-file', 'blob', $hash
6608 or die_error(500, "Open git-cat-file failed");
6609 } elsif ($format eq 'data') {
6610 # run git-blame --incremental
6611 open $fd, "-|", git_cmd(), "blame", "--incremental",
6612 $hash_base, "--", $file_name
6613 or die_error(500, "Open git-blame --incremental failed");
6615 # run git-blame --porcelain
6616 open $fd, "-|", git_cmd(), "blame", '-p',
6617 $hash_base, '--', $file_name
6618 or die_error(500, "Open git-blame --porcelain failed");
6621 # incremental blame data returns early
6622 if ($format eq 'data') {
6624 -type=>"text/plain", -charset => "utf-8",
6625 -status=> "200 OK");
6626 local $| = 1; # output autoflush
6627 while (my $line = <$fd>) {
6628 print to_utf8($line);
6631 or print "ERROR $!\n";
6634 if (defined $t0 && gitweb_check_feature('timed')) {
6636 tv_interval($t0, [ gettimeofday() ]).
6637 ' '.$number_of_git_cmds;
6647 $cgi->a({-href => href(action=>"blob", -replay=>1)},
6650 if ($format eq 'incremental') {
6652 $cgi->a({-href => href(action=>"blame", javascript=>0, -replay=>1)},
6653 "blame") . " (non-incremental)";
6656 $cgi->a({-href => href(action=>"blame_incremental", -replay=>1)},
6657 "blame") . " (incremental)";
6661 $cgi->a({-href => href(action=>"history", -replay=>1)},
6664 $cgi->a({-href => href(action=>$action, file_name=>$file_name)},
6666 git_print_page_nav('','', $hash_base,$co{'tree'},$hash_base, $formats_nav);
6667 git_print_header_div('commit', esc_html($co{'title'}), $hash_base);
6668 git_print_page_path($file_name, $ftype, $hash_base);
6671 if ($format eq 'incremental') {
6672 print "<noscript>\n<div class=\"error\"><center><b>\n".
6673 "This page requires JavaScript to run.\n Use ".
6674 $cgi->a({-href => href(action=>'blame',javascript=>0,-replay=>1)},
6677 "</b></center></div>\n</noscript>\n";
6679 print qq!<div id="progress_bar" style="width: 100%; background-color: yellow"></div>\n!;
6682 print qq!<div class="page_body">\n!;
6683 print qq!<div id="progress_info">... / ...</div>\n!
6684 if ($format eq 'incremental');
6685 print qq!<table id="blame_table" class="blame" width="100%">\n!.
6686 #qq!<col width="5.5em" /><col width="2.5em" /><col width="*" />\n!.
6688 qq!<tr><th>Commit</th><th>Line</th><th>Data</th></tr>\n!.
6692 my @rev_color = qw(light dark);
6693 my $num_colors = scalar(@rev_color);
6694 my $current_color = 0;
6696 if ($format eq 'incremental') {
6697 my $color_class = $rev_color[$current_color];
6702 while (my $line = <$fd>) {
6706 print qq!<tr id="l$linenr" class="$color_class">!.
6707 qq!<td class="sha1"><a href=""> </a></td>!.
6708 qq!<td class="linenr">!.
6709 qq!<a class="linenr" href="">$linenr</a></td>!;
6710 print qq!<td class="pre">! . esc_html($line) . "</td>\n";
6714 } else { # porcelain, i.e. ordinary blame
6715 my %metainfo = (); # saves information about commits
6719 while (my $line = <$fd>) {
6721 # the header: <SHA-1> <src lineno> <dst lineno> [<lines in group>]
6722 # no <lines in group> for subsequent lines in group of lines
6723 my ($full_rev, $orig_lineno, $lineno, $group_size) =
6724 ($line =~ /^([0-9a-f]{40}) (\d+) (\d+)(?: (\d+))?$/);
6725 if (!exists $metainfo{$full_rev}) {
6726 $metainfo{$full_rev} = { 'nprevious' => 0 };
6728 my $meta = $metainfo{$full_rev};
6730 while ($data = <$fd>) {
6732 last if ($data =~ s/^\t//); # contents of line
6733 if ($data =~ /^(\S+)(?: (.*))?$/) {
6734 $meta->{$1} = $2 unless exists $meta->{$1};
6736 if ($data =~ /^previous /) {
6737 $meta->{'nprevious'}++;
6740 my $short_rev = substr($full_rev, 0, 8);
6741 my $author = $meta->{'author'};
6743 parse_date($meta->{'author-time'}, $meta->{'author-tz'});
6744 my $date = $date{'iso-tz'};
6746 $current_color = ($current_color + 1) % $num_colors;
6748 my $tr_class = $rev_color[$current_color];
6749 $tr_class .= ' boundary' if (exists $meta->{'boundary'});
6750 $tr_class .= ' no-previous' if ($meta->{'nprevious'} == 0);
6751 $tr_class .= ' multiple-previous' if ($meta->{'nprevious'} > 1);
6752 print "<tr id=\"l$lineno\" class=\"$tr_class\">\n";
6754 print "<td class=\"sha1\"";
6755 print " title=\"". esc_html($author) . ", $date\"";
6756 print " rowspan=\"$group_size\"" if ($group_size > 1);
6758 print $cgi->a({-href => href(action=>"commit",
6760 file_name=>$file_name)},
6761 esc_html($short_rev));
6762 if ($group_size >= 2) {
6763 my @author_initials = ($author =~ /\b([[:upper:]])\B/g);
6764 if (@author_initials) {
6766 esc_html(join('', @author_initials));
6772 # 'previous' <sha1 of parent commit> <filename at commit>
6773 if (exists $meta->{'previous'} &&
6774 $meta->{'previous'} =~ /^([a-fA-F0-9]{40}) (.*)$/) {
6775 $meta->{'parent'} = $1;
6776 $meta->{'file_parent'} = unquote($2);
6779 exists($meta->{'parent'}) ?
6780 $meta->{'parent'} : $full_rev;
6781 my $linenr_filename =
6782 exists($meta->{'file_parent'}) ?
6783 $meta->{'file_parent'} : unquote($meta->{'filename'});
6784 my $blamed = href(action => 'blame',
6785 file_name => $linenr_filename,
6786 hash_base => $linenr_commit);
6787 print "<td class=\"linenr\">";
6788 print $cgi->a({ -href => "$blamed#l$orig_lineno",
6789 -class => "linenr" },
6792 print "<td class=\"pre\">" . esc_html($data) . "</td>\n";
6800 "</table>\n"; # class="blame"
6801 print "</div>\n"; # class="blame_body"
6803 or print "Reading blob failed\n";
6812 sub git_blame_incremental {
6813 git_blame_common('incremental');
6816 sub git_blame_data {
6817 git_blame_common('data');
6821 my $head = git_get_head_hash($project);
6823 git_print_page_nav('','', $head,undef,$head,format_ref_views('tags'));
6824 git_print_header_div('summary', $project);
6826 my @tagslist = git_get_tags_list();
6828 git_tags_body(\@tagslist);
6834 my $head = git_get_head_hash($project);
6836 git_print_page_nav('','', $head,undef,$head,format_ref_views('heads'));
6837 git_print_header_div('summary', $project);
6839 my @headslist = git_get_heads_list();
6841 git_heads_body(\@headslist, $head);
6846 # used both for single remote view and for list of all the remotes
6848 gitweb_check_feature('remote_heads')
6849 or die_error(403, "Remote heads view is disabled");
6851 my $head = git_get_head_hash($project);
6852 my $remote = $input_params{'hash'};
6854 my $remotedata = git_get_remotes_list($remote);
6855 die_error(500, "Unable to get remote information") unless defined $remotedata;
6857 unless (%$remotedata) {
6858 die_error(404, defined $remote ?
6859 "Remote $remote not found" :
6860 "No remotes found");
6863 git_header_html(undef, undef, -action_extra => $remote);
6864 git_print_page_nav('', '', $head, undef, $head,
6865 format_ref_views($remote ? '' : 'remotes'));
6867 fill_remote_heads($remotedata);
6868 if (defined $remote) {
6869 git_print_header_div('remotes', "$remote remote for $project");
6870 git_remote_block($remote, $remotedata->{$remote}, undef, $head);
6872 git_print_header_div('summary', "$project remotes");
6873 git_remotes_body($remotedata, undef, $head);
6879 sub git_blob_plain {
6883 if (!defined $hash) {
6884 if (defined $file_name) {
6885 my $base = $hash_base || git_get_head_hash($project);
6886 $hash = git_get_hash_by_path($base, $file_name, "blob")
6887 or die_error(404, "Cannot find file");
6889 die_error(400, "No file name defined");
6891 } elsif ($hash =~ m/^[0-9a-fA-F]{40}$/) {
6892 # blobs defined by non-textual hash id's can be cached
6896 open my $fd, "-|", git_cmd(), "cat-file", "blob", $hash
6897 or die_error(500, "Open git-cat-file blob '$hash' failed");
6899 # content-type (can include charset)
6900 $type = blob_contenttype($fd, $file_name, $type);
6902 # "save as" filename, even when no $file_name is given
6903 my $save_as = "$hash";
6904 if (defined $file_name) {
6905 $save_as = $file_name;
6906 } elsif ($type =~ m/^text\//) {
6910 # With XSS prevention on, blobs of all types except a few known safe
6911 # ones are served with "Content-Disposition: attachment" to make sure
6912 # they don't run in our security domain. For certain image types,
6913 # blob view writes an <img> tag referring to blob_plain view, and we
6914 # want to be sure not to break that by serving the image as an
6915 # attachment (though Firefox 3 doesn't seem to care).
6916 my $sandbox = $prevent_xss &&
6917 $type !~ m!^(?:text/[a-z]+|image/(?:gif|png|jpeg))(?:[ ;]|$)!;
6919 # serve text/* as text/plain
6921 ($type =~ m!^text/[a-z]+\b(.*)$! ||
6922 ($type =~ m!^[a-z]+/[a-z]\+xml\b(.*)$! && -T $fd))) {
6924 $rest = defined $rest ? $rest : '';
6925 $type = "text/plain$rest";
6930 -expires => $expires,
6931 -content_disposition =>
6932 ($sandbox ? 'attachment' : 'inline')
6933 . '; filename="' . $save_as . '"');
6935 binmode STDOUT, ':raw';
6937 binmode STDOUT, ':utf8'; # as set at the beginning of gitweb.cgi
6944 if (!defined $hash) {
6945 if (defined $file_name) {
6946 my $base = $hash_base || git_get_head_hash($project);
6947 $hash = git_get_hash_by_path($base, $file_name, "blob")
6948 or die_error(404, "Cannot find file");
6950 die_error(400, "No file name defined");
6952 } elsif ($hash =~ m/^[0-9a-fA-F]{40}$/) {
6953 # blobs defined by non-textual hash id's can be cached
6957 my $have_blame = gitweb_check_feature('blame');
6958 open my $fd, "-|", git_cmd(), "cat-file", "blob", $hash
6959 or die_error(500, "Couldn't cat $file_name, $hash");
6960 my $mimetype = blob_mimetype($fd, $file_name);
6961 # use 'blob_plain' (aka 'raw') view for files that cannot be displayed
6962 if ($mimetype !~ m!^(?:text/|image/(?:gif|png|jpeg)$)! && -B $fd) {
6964 return git_blob_plain($mimetype);
6966 # we can have blame only for text/* mimetype
6967 $have_blame &&= ($mimetype =~ m!^text/!);
6969 my $highlight = gitweb_check_feature('highlight');
6970 my $syntax = guess_file_syntax($highlight, $mimetype, $file_name);
6971 $fd = run_highlighter($fd, $highlight, $syntax)
6974 git_header_html(undef, $expires);
6975 my $formats_nav = '';
6976 if (defined $hash_base && (my %co = parse_commit($hash_base))) {
6977 if (defined $file_name) {
6980 $cgi->a({-href => href(action=>"blame", -replay=>1)},
6985 $cgi->a({-href => href(action=>"history", -replay=>1)},
6988 $cgi->a({-href => href(action=>"blob_plain", -replay=>1)},
6991 $cgi->a({-href => href(action=>"blob",
6992 hash_base=>"HEAD", file_name=>$file_name)},
6996 $cgi->a({-href => href(action=>"blob_plain", -replay=>1)},
6999 git_print_page_nav('','', $hash_base,$co{'tree'},$hash_base, $formats_nav);
7000 git_print_header_div('commit', esc_html($co{'title'}), $hash_base);
7002 print "<div class=\"page_nav\">\n" .
7003 "<br/><br/></div>\n" .
7004 "<div class=\"title\">".esc_html($hash)."</div>\n";
7006 git_print_page_path($file_name, "blob", $hash_base);
7007 print "<div class=\"page_body\">\n";
7008 if ($mimetype =~ m!^image/!) {
7009 print qq!<img type="!.esc_attr($mimetype).qq!"!;
7011 print qq! alt="!.esc_attr($file_name).qq!" title="!.esc_attr($file_name).qq!"!;
7014 href(action=>"blob_plain", hash=>$hash,
7015 hash_base=>$hash_base, file_name=>$file_name) .
7019 while (my $line = <$fd>) {
7022 $line = untabify($line);
7023 printf qq!<div class="pre"><a id="l%i" href="%s#l%i" class="linenr">%4i</a> %s</div>\n!,
7024 $nr, esc_attr(href(-replay => 1)), $nr, $nr,
7025 $syntax ? sanitize($line) : esc_html($line, -nbsp=>1);
7029 or print "Reading blob failed.\n";
7035 if (!defined $hash_base) {
7036 $hash_base = "HEAD";
7038 if (!defined $hash) {
7039 if (defined $file_name) {
7040 $hash = git_get_hash_by_path($hash_base, $file_name, "tree");
7045 die_error(404, "No such tree") unless defined($hash);
7047 my $show_sizes = gitweb_check_feature('show-sizes');
7048 my $have_blame = gitweb_check_feature('blame');
7053 open my $fd, "-|", git_cmd(), "ls-tree", '-z',
7054 ($show_sizes ? '-l' : ()), @extra_options, $hash
7055 or die_error(500, "Open git-ls-tree failed");
7056 @entries = map { chomp; $_ } <$fd>;
7058 or die_error(404, "Reading tree failed");
7061 my $refs = git_get_references();
7062 my $ref = format_ref_marker($refs, $hash_base);
7065 if (defined $hash_base && (my %co = parse_commit($hash_base))) {
7067 if (defined $file_name) {
7069 $cgi->a({-href => href(action=>"history", -replay=>1)},
7071 $cgi->a({-href => href(action=>"tree",
7072 hash_base=>"HEAD", file_name=>$file_name)},
7075 my $snapshot_links = format_snapshot_links($hash);
7076 if (defined $snapshot_links) {
7077 # FIXME: Should be available when we have no hash base as well.
7078 push @views_nav, $snapshot_links;
7080 git_print_page_nav('tree','', $hash_base, undef, undef,
7081 join(' | ', @views_nav));
7082 git_print_header_div('commit', esc_html($co{'title'}) . $ref, $hash_base);
7085 print "<div class=\"page_nav\">\n";
7086 print "<br/><br/></div>\n";
7087 print "<div class=\"title\">".esc_html($hash)."</div>\n";
7089 if (defined $file_name) {
7090 $basedir = $file_name;
7091 if ($basedir ne '' && substr($basedir, -1) ne '/') {
7094 git_print_page_path($file_name, 'tree', $hash_base);
7096 print "<div class=\"page_body\">\n";
7097 print "<table class=\"tree\">\n";
7099 # '..' (top directory) link if possible
7100 if (defined $hash_base &&
7101 defined $file_name && $file_name =~ m![^/]+$!) {
7103 print "<tr class=\"dark\">\n";
7105 print "<tr class=\"light\">\n";
7109 my $up = $file_name;
7110 $up =~ s!/?[^/]+$!!;
7111 undef $up unless $up;
7112 # based on git_print_tree_entry
7113 print '<td class="mode">' . mode_str('040000') . "</td>\n";
7114 print '<td class="size"> </td>'."\n" if $show_sizes;
7115 print '<td class="list">';
7116 print $cgi->a({-href => href(action=>"tree",
7117 hash_base=>$hash_base,
7121 print "<td class=\"link\"></td>\n";
7125 foreach my $line (@entries) {
7126 my %t = parse_ls_tree_line($line, -z => 1, -l => $show_sizes);
7129 print "<tr class=\"dark\">\n";
7131 print "<tr class=\"light\">\n";
7135 git_print_tree_entry(\%t, $basedir, $hash_base, $have_blame);
7139 print "</table>\n" .
7145 my ($project, $hash) = @_;
7147 # path/to/project.git -> project
7148 # path/to/project/.git -> project
7149 my $name = to_utf8($project);
7150 $name =~ s,([^/])/*\.git$,$1,;
7151 $name = basename($name);
7153 $name =~ s/[[:cntrl:]]/?/g;
7156 if ($hash =~ /^[0-9a-fA-F]+$/) {
7157 # shorten SHA-1 hash
7158 my $full_hash = git_get_full_hash($project, $hash);
7159 if ($full_hash =~ /^$hash/ && length($hash) > 7) {
7160 $ver = git_get_short_hash($project, $hash);
7162 } elsif ($hash =~ m!^refs/tags/(.*)$!) {
7163 # tags don't need shortened SHA-1 hash
7166 # branches and other need shortened SHA-1 hash
7167 if ($hash =~ m!^refs/(?:heads|remotes)/(.*)$!) {
7170 $ver .= '-' . git_get_short_hash($project, $hash);
7172 # in case of hierarchical branch names
7175 # name = project-version_string
7176 $name = "$name-$ver";
7178 return wantarray ? ($name, $name) : $name;
7181 sub exit_if_unmodified_since {
7182 my ($latest_epoch) = @_;
7185 my $if_modified = $cgi->http('IF_MODIFIED_SINCE');
7186 if (defined $if_modified) {
7188 if (eval { require HTTP::Date; 1; }) {
7189 $since = HTTP::Date::str2time($if_modified);
7190 } elsif (eval { require Time::ParseDate; 1; }) {
7191 $since = Time::ParseDate::parsedate($if_modified, GMT => 1);
7193 if (defined $since && $latest_epoch <= $since) {
7194 my %latest_date = parse_date($latest_epoch);
7196 -last_modified => $latest_date{'rfc2822'},
7197 -status => '304 Not Modified');
7204 my $format = $input_params{'snapshot_format'};
7205 if (!@snapshot_fmts) {
7206 die_error(403, "Snapshots not allowed");
7208 # default to first supported snapshot format
7209 $format ||= $snapshot_fmts[0];
7210 if ($format !~ m/^[a-z0-9]+$/) {
7211 die_error(400, "Invalid snapshot format parameter");
7212 } elsif (!exists($known_snapshot_formats{$format})) {
7213 die_error(400, "Unknown snapshot format");
7214 } elsif ($known_snapshot_formats{$format}{'disabled'}) {
7215 die_error(403, "Snapshot format not allowed");
7216 } elsif (!grep($_ eq $format, @snapshot_fmts)) {
7217 die_error(403, "Unsupported snapshot format");
7220 my $type = git_get_type("$hash^{}");
7222 die_error(404, 'Object does not exist');
7223 } elsif ($type eq 'blob') {
7224 die_error(400, 'Object is not a tree-ish');
7227 my ($name, $prefix) = snapshot_name($project, $hash);
7228 my $filename = "$name$known_snapshot_formats{$format}{'suffix'}";
7230 my %co = parse_commit($hash);
7231 exit_if_unmodified_since($co{'committer_epoch'}) if %co;
7233 my $cmd = quote_command(
7234 git_cmd(), 'archive',
7235 "--format=$known_snapshot_formats{$format}{'format'}",
7236 "--prefix=$prefix/", $hash);
7237 if (exists $known_snapshot_formats{$format}{'compressor'}) {
7238 $cmd .= ' | ' . quote_command(@{$known_snapshot_formats{$format}{'compressor'}});
7241 $filename =~ s/(["\\])/\\$1/g;
7244 %latest_date = parse_date($co{'committer_epoch'}, $co{'committer_tz'});
7248 -type => $known_snapshot_formats{$format}{'type'},
7249 -content_disposition => 'inline; filename="' . $filename . '"',
7250 %co ? (-last_modified => $latest_date{'rfc2822'}) : (),
7251 -status => '200 OK');
7253 open my $fd, "-|", $cmd
7254 or die_error(500, "Execute git-archive failed");
7255 binmode STDOUT, ':raw';
7257 binmode STDOUT, ':utf8'; # as set at the beginning of gitweb.cgi
7261 sub git_log_generic {
7262 my ($fmt_name, $body_subr, $base, $parent, $file_name, $file_hash) = @_;
7264 my $head = git_get_head_hash($project);
7265 if (!defined $base) {
7268 if (!defined $page) {
7271 my $refs = git_get_references();
7273 my $commit_hash = $base;
7274 if (defined $parent) {
7275 $commit_hash = "$parent..$base";
7278 parse_commits($commit_hash, 101, (100 * $page),
7279 defined $file_name ? ($file_name, "--full-history") : ());
7282 if (!defined $file_hash && defined $file_name) {
7283 # some commits could have deleted file in question,
7284 # and not have it in tree, but one of them has to have it
7285 for (my $i = 0; $i < @commitlist; $i++) {
7286 $file_hash = git_get_hash_by_path($commitlist[$i]{'id'}, $file_name);
7287 last if defined $file_hash;
7290 if (defined $file_hash) {
7291 $ftype = git_get_type($file_hash);
7293 if (defined $file_name && !defined $ftype) {
7294 die_error(500, "Unknown type of object");
7297 if (defined $file_name) {
7298 %co = parse_commit($base)
7299 or die_error(404, "Unknown commit object");
7303 my $paging_nav = format_paging_nav($fmt_name, $page, $#commitlist >= 100);
7305 if ($#commitlist >= 100) {
7307 $cgi->a({-href => href(-replay=>1, page=>$page+1),
7308 -accesskey => "n", -title => "Alt-n"}, "next");
7310 my $patch_max = gitweb_get_feature('patches');
7311 if ($patch_max && !defined $file_name) {
7312 if ($patch_max < 0 || @commitlist <= $patch_max) {
7313 $paging_nav .= " ⋅ " .
7314 $cgi->a({-href => href(action=>"patches", -replay=>1)},
7320 git_print_page_nav($fmt_name,'', $hash,$hash,$hash, $paging_nav);
7321 if (defined $file_name) {
7322 git_print_header_div('commit', esc_html($co{'title'}), $base);
7324 git_print_header_div('summary', $project)
7326 git_print_page_path($file_name, $ftype, $hash_base)
7327 if (defined $file_name);
7329 $body_subr->(\@commitlist, 0, 99, $refs, $next_link,
7330 $file_name, $file_hash, $ftype);
7336 git_log_generic('log', \&git_log_body,
7337 $hash, $hash_parent);
7341 $hash ||= $hash_base || "HEAD";
7342 my %co = parse_commit($hash)
7343 or die_error(404, "Unknown commit object");
7345 my $parent = $co{'parent'};
7346 my $parents = $co{'parents'}; # listref
7348 # we need to prepare $formats_nav before any parameter munging
7350 if (!defined $parent) {
7352 $formats_nav .= '(initial)';
7353 } elsif (@$parents == 1) {
7354 # single parent commit
7357 $cgi->a({-href => href(action=>"commit",
7359 esc_html(substr($parent, 0, 7))) .
7366 $cgi->a({-href => href(action=>"commit",
7368 esc_html(substr($_, 0, 7)));
7372 if (gitweb_check_feature('patches') && @$parents <= 1) {
7373 $formats_nav .= " | " .
7374 $cgi->a({-href => href(action=>"patch", -replay=>1)},
7378 if (!defined $parent) {
7382 open my $fd, "-|", git_cmd(), "diff-tree", '-r', "--no-commit-id",
7384 (@$parents <= 1 ? $parent : '-c'),
7386 or die_error(500, "Open git-diff-tree failed");
7387 @difftree = map { chomp; $_ } <$fd>;
7388 close $fd or die_error(404, "Reading git-diff-tree failed");
7390 # non-textual hash id's can be cached
7392 if ($hash =~ m/^[0-9a-fA-F]{40}$/) {
7395 my $refs = git_get_references();
7396 my $ref = format_ref_marker($refs, $co{'id'});
7398 git_header_html(undef, $expires);
7399 git_print_page_nav('commit', '',
7400 $hash, $co{'tree'}, $hash,
7403 if (defined $co{'parent'}) {
7404 git_print_header_div('commitdiff', esc_html($co{'title'}) . $ref, $hash);
7406 git_print_header_div('tree', esc_html($co{'title'}) . $ref, $co{'tree'}, $hash);
7408 print "<div class=\"title_text\">\n" .
7409 "<table class=\"object_header\">\n";
7410 git_print_authorship_rows(\%co);
7411 print "<tr><td>commit</td><td class=\"sha1\">$co{'id'}</td></tr>\n";
7414 "<td class=\"sha1\">" .
7415 $cgi->a({-href => href(action=>"tree", hash=>$co{'tree'}, hash_base=>$hash),
7416 class => "list"}, $co{'tree'}) .
7418 "<td class=\"link\">" .
7419 $cgi->a({-href => href(action=>"tree", hash=>$co{'tree'}, hash_base=>$hash)},
7421 my $snapshot_links = format_snapshot_links($hash);
7422 if (defined $snapshot_links) {
7423 print " | " . $snapshot_links;
7428 foreach my $par (@$parents) {
7431 "<td class=\"sha1\">" .
7432 $cgi->a({-href => href(action=>"commit", hash=>$par),
7433 class => "list"}, $par) .
7435 "<td class=\"link\">" .
7436 $cgi->a({-href => href(action=>"commit", hash=>$par)}, "commit") .
7438 $cgi->a({-href => href(action=>"commitdiff", hash=>$hash, hash_parent=>$par)}, "diff") .
7445 print "<div class=\"page_body\">\n";
7446 git_print_log($co{'comment'});
7449 git_difftree_body(\@difftree, $hash, @$parents);
7455 # object is defined by:
7456 # - hash or hash_base alone
7457 # - hash_base and file_name
7460 # - hash or hash_base alone
7461 if ($hash || ($hash_base && !defined $file_name)) {
7462 my $object_id = $hash || $hash_base;
7464 open my $fd, "-|", quote_command(
7465 git_cmd(), 'cat-file', '-t', $object_id) . ' 2> /dev/null'
7466 or die_error(404, "Object does not exist");
7470 or die_error(404, "Object does not exist");
7472 # - hash_base and file_name
7473 } elsif ($hash_base && defined $file_name) {
7474 $file_name =~ s,/+$,,;
7476 system(git_cmd(), "cat-file", '-e', $hash_base) == 0
7477 or die_error(404, "Base object does not exist");
7479 # here errors should not hapen
7480 open my $fd, "-|", git_cmd(), "ls-tree", $hash_base, "--", $file_name
7481 or die_error(500, "Open git-ls-tree failed");
7485 #'100644 blob 0fa3f3a66fb6a137f6ec2c19351ed4d807070ffa panic.c'
7486 unless ($line && $line =~ m/^([0-9]+) (.+) ([0-9a-fA-F]{40})\t/) {
7487 die_error(404, "File or directory for given base does not exist");
7492 die_error(400, "Not enough information to find object");
7495 print $cgi->redirect(-uri => href(action=>$type, -full=>1,
7496 hash=>$hash, hash_base=>$hash_base,
7497 file_name=>$file_name),
7498 -status => '302 Found');
7502 my $format = shift || 'html';
7503 my $diff_style = $input_params{'diff_style'} || 'inline';
7510 # preparing $fd and %diffinfo for git_patchset_body
7512 if (defined $hash_base && defined $hash_parent_base) {
7513 if (defined $file_name) {
7515 open $fd, "-|", git_cmd(), "diff-tree", '-r', @diff_opts,
7516 $hash_parent_base, $hash_base,
7517 "--", (defined $file_parent ? $file_parent : ()), $file_name
7518 or die_error(500, "Open git-diff-tree failed");
7519 @difftree = map { chomp; $_ } <$fd>;
7521 or die_error(404, "Reading git-diff-tree failed");
7523 or die_error(404, "Blob diff not found");
7525 } elsif (defined $hash &&
7526 $hash =~ /[0-9a-fA-F]{40}/) {
7527 # try to find filename from $hash
7529 # read filtered raw output
7530 open $fd, "-|", git_cmd(), "diff-tree", '-r', @diff_opts,
7531 $hash_parent_base, $hash_base, "--"
7532 or die_error(500, "Open git-diff-tree failed");
7534 # ':100644 100644 03b21826... 3b93d5e7... M ls-files.c'
7536 grep { /^:[0-7]{6} [0-7]{6} [0-9a-fA-F]{40} $hash/ }
7537 map { chomp; $_ } <$fd>;
7539 or die_error(404, "Reading git-diff-tree failed");
7541 or die_error(404, "Blob diff not found");
7544 die_error(400, "Missing one of the blob diff parameters");
7547 if (@difftree > 1) {
7548 die_error(400, "Ambiguous blob diff specification");
7551 %diffinfo = parse_difftree_raw_line($difftree[0]);
7552 $file_parent ||= $diffinfo{'from_file'} || $file_name;
7553 $file_name ||= $diffinfo{'to_file'};
7555 $hash_parent ||= $diffinfo{'from_id'};
7556 $hash ||= $diffinfo{'to_id'};
7558 # non-textual hash id's can be cached
7559 if ($hash_base =~ m/^[0-9a-fA-F]{40}$/ &&
7560 $hash_parent_base =~ m/^[0-9a-fA-F]{40}$/) {
7565 open $fd, "-|", git_cmd(), "diff-tree", '-r', @diff_opts,
7566 '-p', ($format eq 'html' ? "--full-index" : ()),
7567 $hash_parent_base, $hash_base,
7568 "--", (defined $file_parent ? $file_parent : ()), $file_name
7569 or die_error(500, "Open git-diff-tree failed");
7572 # old/legacy style URI -- not generated anymore since 1.4.3.
7574 die_error('404 Not Found', "Missing one of the blob diff parameters")
7578 if ($format eq 'html') {
7580 $cgi->a({-href => href(action=>"blobdiff_plain", -replay=>1)},
7582 $formats_nav .= diff_style_nav($diff_style);
7583 git_header_html(undef, $expires);
7584 if (defined $hash_base && (my %co = parse_commit($hash_base))) {
7585 git_print_page_nav('','', $hash_base,$co{'tree'},$hash_base, $formats_nav);
7586 git_print_header_div('commit', esc_html($co{'title'}), $hash_base);
7588 print "<div class=\"page_nav\"><br/>$formats_nav<br/></div>\n";
7589 print "<div class=\"title\">".esc_html("$hash vs $hash_parent")."</div>\n";
7591 if (defined $file_name) {
7592 git_print_page_path($file_name, "blob", $hash_base);
7594 print "<div class=\"page_path\"></div>\n";
7597 } elsif ($format eq 'plain') {
7599 -type => 'text/plain',
7600 -charset => 'utf-8',
7601 -expires => $expires,
7602 -content_disposition => 'inline; filename="' . "$file_name" . '.patch"');
7604 print "X-Git-Url: " . $cgi->self_url() . "\n\n";
7607 die_error(400, "Unknown blobdiff format");
7611 if ($format eq 'html') {
7612 print "<div class=\"page_body\">\n";
7614 git_patchset_body($fd, $diff_style,
7615 [ \%diffinfo ], $hash_base, $hash_parent_base);
7618 print "</div>\n"; # class="page_body"
7622 while (my $line = <$fd>) {
7623 $line =~ s!a/($hash|$hash_parent)!'a/'.esc_path($diffinfo{'from_file'})!eg;
7624 $line =~ s!b/($hash|$hash_parent)!'b/'.esc_path($diffinfo{'to_file'})!eg;
7628 last if $line =~ m!^\+\+\+!;
7636 sub git_blobdiff_plain {
7637 git_blobdiff('plain');
7640 # assumes that it is added as later part of already existing navigation,
7641 # so it returns "| foo | bar" rather than just "foo | bar"
7642 sub diff_style_nav {
7643 my ($diff_style, $is_combined) = @_;
7644 $diff_style ||= 'inline';
7646 return "" if ($is_combined);
7648 my @styles = (inline => 'inline', 'sidebyside' => 'side by side');
7649 my %styles = @styles;
7651 @styles[ map { $_ * 2 } 0..$#styles/2 ];
7656 $_ eq $diff_style ? $styles{$_} :
7657 $cgi->a({-href => href(-replay=>1, diff_style => $_)}, $styles{$_})
7661 sub git_commitdiff {
7663 my $format = $params{-format} || 'html';
7664 my $diff_style = $input_params{'diff_style'} || 'inline';
7666 my ($patch_max) = gitweb_get_feature('patches');
7667 if ($format eq 'patch') {
7668 die_error(403, "Patch view not allowed") unless $patch_max;
7671 $hash ||= $hash_base || "HEAD";
7672 my %co = parse_commit($hash)
7673 or die_error(404, "Unknown commit object");
7675 # choose format for commitdiff for merge
7676 if (! defined $hash_parent && @{$co{'parents'}} > 1) {
7677 $hash_parent = '--cc';
7679 # we need to prepare $formats_nav before almost any parameter munging
7681 if ($format eq 'html') {
7683 $cgi->a({-href => href(action=>"commitdiff_plain", -replay=>1)},
7685 if ($patch_max && @{$co{'parents'}} <= 1) {
7686 $formats_nav .= " | " .
7687 $cgi->a({-href => href(action=>"patch", -replay=>1)},
7690 $formats_nav .= diff_style_nav($diff_style, @{$co{'parents'}} > 1);
7692 if (defined $hash_parent &&
7693 $hash_parent ne '-c' && $hash_parent ne '--cc') {
7694 # commitdiff with two commits given
7695 my $hash_parent_short = $hash_parent;
7696 if ($hash_parent =~ m/^[0-9a-fA-F]{40}$/) {
7697 $hash_parent_short = substr($hash_parent, 0, 7);
7701 for (my $i = 0; $i < @{$co{'parents'}}; $i++) {
7702 if ($co{'parents'}[$i] eq $hash_parent) {
7703 $formats_nav .= ' parent ' . ($i+1);
7707 $formats_nav .= ': ' .
7708 $cgi->a({-href => href(-replay=>1,
7709 hash=>$hash_parent, hash_base=>undef)},
7710 esc_html($hash_parent_short)) .
7712 } elsif (!$co{'parent'}) {
7714 $formats_nav .= ' (initial)';
7715 } elsif (scalar @{$co{'parents'}} == 1) {
7716 # single parent commit
7719 $cgi->a({-href => href(-replay=>1,
7720 hash=>$co{'parent'}, hash_base=>undef)},
7721 esc_html(substr($co{'parent'}, 0, 7))) .
7725 if ($hash_parent eq '--cc') {
7726 $formats_nav .= ' | ' .
7727 $cgi->a({-href => href(-replay=>1,
7728 hash=>$hash, hash_parent=>'-c')},
7730 } else { # $hash_parent eq '-c'
7731 $formats_nav .= ' | ' .
7732 $cgi->a({-href => href(-replay=>1,
7733 hash=>$hash, hash_parent=>'--cc')},
7739 $cgi->a({-href => href(-replay=>1,
7740 hash=>$_, hash_base=>undef)},
7741 esc_html(substr($_, 0, 7)));
7742 } @{$co{'parents'}} ) .
7747 my $hash_parent_param = $hash_parent;
7748 if (!defined $hash_parent_param) {
7749 # --cc for multiple parents, --root for parentless
7750 $hash_parent_param =
7751 @{$co{'parents'}} > 1 ? '--cc' : $co{'parent'} || '--root';
7757 if ($format eq 'html') {
7758 open $fd, "-|", git_cmd(), "diff-tree", '-r', @diff_opts,
7759 "--no-commit-id", "--patch-with-raw", "--full-index",
7760 $hash_parent_param, $hash, "--"
7761 or die_error(500, "Open git-diff-tree failed");
7763 while (my $line = <$fd>) {
7765 # empty line ends raw part of diff-tree output
7767 push @difftree, scalar parse_difftree_raw_line($line);
7770 } elsif ($format eq 'plain') {
7771 open $fd, "-|", git_cmd(), "diff-tree", '-r', @diff_opts,
7772 '-p', $hash_parent_param, $hash, "--"
7773 or die_error(500, "Open git-diff-tree failed");
7774 } elsif ($format eq 'patch') {
7775 # For commit ranges, we limit the output to the number of
7776 # patches specified in the 'patches' feature.
7777 # For single commits, we limit the output to a single patch,
7778 # diverging from the git-format-patch default.
7779 my @commit_spec = ();
7781 if ($patch_max > 0) {
7782 push @commit_spec, "-$patch_max";
7784 push @commit_spec, '-n', "$hash_parent..$hash";
7786 if ($params{-single}) {
7787 push @commit_spec, '-1';
7789 if ($patch_max > 0) {
7790 push @commit_spec, "-$patch_max";
7792 push @commit_spec, "-n";
7794 push @commit_spec, '--root', $hash;
7796 open $fd, "-|", git_cmd(), "format-patch", @diff_opts,
7797 '--encoding=utf8', '--stdout', @commit_spec
7798 or die_error(500, "Open git-format-patch failed");
7800 die_error(400, "Unknown commitdiff format");
7803 # non-textual hash id's can be cached
7805 if ($hash =~ m/^[0-9a-fA-F]{40}$/) {
7809 # write commit message
7810 if ($format eq 'html') {
7811 my $refs = git_get_references();
7812 my $ref = format_ref_marker($refs, $co{'id'});
7814 git_header_html(undef, $expires);
7815 git_print_page_nav('commitdiff','', $hash,$co{'tree'},$hash, $formats_nav);
7816 git_print_header_div('commit', esc_html($co{'title'}) . $ref, $hash);
7817 print "<div class=\"title_text\">\n" .
7818 "<table class=\"object_header\">\n";
7819 git_print_authorship_rows(\%co);
7822 print "<div class=\"page_body\">\n";
7823 if (@{$co{'comment'}} > 1) {
7824 print "<div class=\"log\">\n";
7825 git_print_log($co{'comment'}, -final_empty_line=> 1, -remove_title => 1);
7826 print "</div>\n"; # class="log"
7829 } elsif ($format eq 'plain') {
7830 my $refs = git_get_references("tags");
7831 my $tagname = git_get_rev_name_tags($hash);
7832 my $filename = basename($project) . "-$hash.patch";
7835 -type => 'text/plain',
7836 -charset => 'utf-8',
7837 -expires => $expires,
7838 -content_disposition => 'inline; filename="' . "$filename" . '"');
7839 my %ad = parse_date($co{'author_epoch'}, $co{'author_tz'});
7840 print "From: " . to_utf8($co{'author'}) . "\n";
7841 print "Date: $ad{'rfc2822'} ($ad{'tz_local'})\n";
7842 print "Subject: " . to_utf8($co{'title'}) . "\n";
7844 print "X-Git-Tag: $tagname\n" if $tagname;
7845 print "X-Git-Url: " . $cgi->self_url() . "\n\n";
7847 foreach my $line (@{$co{'comment'}}) {
7848 print to_utf8($line) . "\n";
7851 } elsif ($format eq 'patch') {
7852 my $filename = basename($project) . "-$hash.patch";
7855 -type => 'text/plain',
7856 -charset => 'utf-8',
7857 -expires => $expires,
7858 -content_disposition => 'inline; filename="' . "$filename" . '"');
7862 if ($format eq 'html') {
7863 my $use_parents = !defined $hash_parent ||
7864 $hash_parent eq '-c' || $hash_parent eq '--cc';
7865 git_difftree_body(\@difftree, $hash,
7866 $use_parents ? @{$co{'parents'}} : $hash_parent);
7869 git_patchset_body($fd, $diff_style,
7871 $use_parents ? @{$co{'parents'}} : $hash_parent);
7873 print "</div>\n"; # class="page_body"
7876 } elsif ($format eq 'plain') {
7880 or print "Reading git-diff-tree failed\n";
7881 } elsif ($format eq 'patch') {
7885 or print "Reading git-format-patch failed\n";
7889 sub git_commitdiff_plain {
7890 git_commitdiff(-format => 'plain');
7893 # format-patch-style patches
7895 git_commitdiff(-format => 'patch', -single => 1);
7899 git_commitdiff(-format => 'patch');
7903 git_log_generic('history', \&git_history_body,
7904 $hash_base, $hash_parent_base,
7909 $searchtype ||= 'commit';
7911 # check if appropriate features are enabled
7912 gitweb_check_feature('search')
7913 or die_error(403, "Search is disabled");
7914 if ($searchtype eq 'pickaxe') {
7915 # pickaxe may take all resources of your box and run for several minutes
7916 # with every query - so decide by yourself how public you make this feature
7917 gitweb_check_feature('pickaxe')
7918 or die_error(403, "Pickaxe search is disabled");
7920 if ($searchtype eq 'grep') {
7921 # grep search might be potentially CPU-intensive, too
7922 gitweb_check_feature('grep')
7923 or die_error(403, "Grep search is disabled");
7926 if (!defined $searchtext) {
7927 die_error(400, "Text field is empty");
7929 if (!defined $hash) {
7930 $hash = git_get_head_hash($project);
7932 my %co = parse_commit($hash);
7934 die_error(404, "Unknown commit object");
7936 if (!defined $page) {
7940 if ($searchtype eq 'commit' ||
7941 $searchtype eq 'author' ||
7942 $searchtype eq 'committer') {
7943 git_search_message(%co);
7944 } elsif ($searchtype eq 'pickaxe') {
7945 git_search_changes(%co);
7946 } elsif ($searchtype eq 'grep') {
7947 git_search_files(%co);
7949 die_error(400, "Unknown search type");
7953 sub git_search_help {
7955 git_print_page_nav('','', $hash,$hash,$hash);
7957 <p><strong>Pattern</strong> is by default a normal string that is matched precisely (but without
7958 regard to case, except in the case of pickaxe). However, when you check the <em>re</em> checkbox,
7959 the pattern entered is recognized as the POSIX extended
7960 <a href="http://en.wikipedia.org/wiki/Regular_expression">regular expression</a> (also case
7963 <dt><b>commit</b></dt>
7964 <dd>The commit messages and authorship information will be scanned for the given pattern.</dd>
7966 my $have_grep = gitweb_check_feature('grep');
7969 <dt><b>grep</b></dt>
7970 <dd>All files in the currently selected tree (HEAD unless you are explicitly browsing
7971 a different one) are searched for the given pattern. On large trees, this search can take
7972 a while and put some strain on the server, so please use it with some consideration. Note that
7973 due to git-grep peculiarity, currently if regexp mode is turned off, the matches are
7974 case-sensitive.</dd>
7978 <dt><b>author</b></dt>
7979 <dd>Name and e-mail of the change author and date of birth of the patch will be scanned for the given pattern.</dd>
7980 <dt><b>committer</b></dt>
7981 <dd>Name and e-mail of the committer and date of commit will be scanned for the given pattern.</dd>
7983 my $have_pickaxe = gitweb_check_feature('pickaxe');
7984 if ($have_pickaxe) {
7986 <dt><b>pickaxe</b></dt>
7987 <dd>All commits that caused the string to appear or disappear from any file (changes that
7988 added, removed or "modified" the string) will be listed. This search can take a while and
7989 takes a lot of strain on the server, so please use it wisely. Note that since you may be
7990 interested even in changes just changing the case as well, this search is case sensitive.</dd>
7998 git_log_generic('shortlog', \&git_shortlog_body,
7999 $hash, $hash_parent);
8002 ## ......................................................................
8003 ## feeds (RSS, Atom; OPML)
8006 my $format = shift || 'atom';
8007 my $have_blame = gitweb_check_feature('blame');
8009 # Atom: http://www.atomenabled.org/developers/syndication/
8010 # RSS: http://www.notestips.com/80256B3A007F2692/1/NAMO5P9UPQ
8011 if ($format ne 'rss' && $format ne 'atom') {
8012 die_error(400, "Unknown web feed format");
8015 # log/feed of current (HEAD) branch, log of given branch, history of file/directory
8016 my $head = $hash || 'HEAD';
8017 my @commitlist = parse_commits($head, 150, 0, $file_name);
8021 my $content_type = "application/$format+xml";
8022 if (defined $cgi->http('HTTP_ACCEPT') &&
8023 $cgi->Accept('text/xml') > $cgi->Accept($content_type)) {
8024 # browser (feed reader) prefers text/xml
8025 $content_type = 'text/xml';
8027 if (defined($commitlist[0])) {
8028 %latest_commit = %{$commitlist[0]};
8029 my $latest_epoch = $latest_commit{'committer_epoch'};
8030 exit_if_unmodified_since($latest_epoch);
8031 %latest_date = parse_date($latest_epoch, $latest_commit{'comitter_tz'});
8034 -type => $content_type,
8035 -charset => 'utf-8',
8036 %latest_date ? (-last_modified => $latest_date{'rfc2822'}) : (),
8037 -status => '200 OK');
8039 # Optimization: skip generating the body if client asks only
8040 # for Last-Modified date.
8041 return if ($cgi->request_method() eq 'HEAD');
8044 my $title = "$site_name - $project/$action";
8045 my $feed_type = 'log';
8046 if (defined $hash) {
8047 $title .= " - '$hash'";
8048 $feed_type = 'branch log';
8049 if (defined $file_name) {
8050 $title .= " :: $file_name";
8051 $feed_type = 'history';
8053 } elsif (defined $file_name) {
8054 $title .= " - $file_name";
8055 $feed_type = 'history';
8057 $title .= " $feed_type";
8058 my $descr = git_get_project_description($project);
8059 if (defined $descr) {
8060 $descr = esc_html($descr);
8062 $descr = "$project " .
8063 ($format eq 'rss' ? 'RSS' : 'Atom') .
8066 my $owner = git_get_project_owner($project);
8067 $owner = esc_html($owner);
8071 if (defined $file_name) {
8072 $alt_url = href(-full=>1, action=>"history", hash=>$hash, file_name=>$file_name);
8073 } elsif (defined $hash) {
8074 $alt_url = href(-full=>1, action=>"log", hash=>$hash);
8076 $alt_url = href(-full=>1, action=>"summary");
8078 print qq!<?xml version="1.0" encoding="utf-8"?>\n!;
8079 if ($format eq 'rss') {
8081 <rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/">
8084 print "<title>$title</title>\n" .
8085 "<link>$alt_url</link>\n" .
8086 "<description>$descr</description>\n" .
8087 "<language>en</language>\n" .
8088 # project owner is responsible for 'editorial' content
8089 "<managingEditor>$owner</managingEditor>\n";
8090 if (defined $logo || defined $favicon) {
8091 # prefer the logo to the favicon, since RSS
8092 # doesn't allow both
8093 my $img = esc_url($logo || $favicon);
8095 "<url>$img</url>\n" .
8096 "<title>$title</title>\n" .
8097 "<link>$alt_url</link>\n" .
8101 print "<pubDate>$latest_date{'rfc2822'}</pubDate>\n";
8102 print "<lastBuildDate>$latest_date{'rfc2822'}</lastBuildDate>\n";
8104 print "<generator>gitweb v.$version/$git_version</generator>\n";
8105 } elsif ($format eq 'atom') {
8107 <feed xmlns="http://www.w3.org/2005/Atom">
8109 print "<title>$title</title>\n" .
8110 "<subtitle>$descr</subtitle>\n" .
8111 '<link rel="alternate" type="text/html" href="' .
8112 $alt_url . '" />' . "\n" .
8113 '<link rel="self" type="' . $content_type . '" href="' .
8114 $cgi->self_url() . '" />' . "\n" .
8115 "<id>" . href(-full=>1) . "</id>\n" .
8116 # use project owner for feed author
8117 "<author><name>$owner</name></author>\n";
8118 if (defined $favicon) {
8119 print "<icon>" . esc_url($favicon) . "</icon>\n";
8121 if (defined $logo) {
8122 # not twice as wide as tall: 72 x 27 pixels
8123 print "<logo>" . esc_url($logo) . "</logo>\n";
8125 if (! %latest_date) {
8126 # dummy date to keep the feed valid until commits trickle in:
8127 print "<updated>1970-01-01T00:00:00Z</updated>\n";
8129 print "<updated>$latest_date{'iso-8601'}</updated>\n";
8131 print "<generator version='$version/$git_version'>gitweb</generator>\n";
8135 for (my $i = 0; $i <= $#commitlist; $i++) {
8136 my %co = %{$commitlist[$i]};
8137 my $commit = $co{'id'};
8138 # we read 150, we always show 30 and the ones more recent than 48 hours
8139 if (($i >= 20) && ((time - $co{'author_epoch'}) > 48*60*60)) {
8142 my %cd = parse_date($co{'author_epoch'}, $co{'author_tz'});
8144 # get list of changed files
8145 open my $fd, "-|", git_cmd(), "diff-tree", '-r', @diff_opts,
8146 $co{'parent'} || "--root",
8147 $co{'id'}, "--", (defined $file_name ? $file_name : ())
8149 my @difftree = map { chomp; $_ } <$fd>;
8153 # print element (entry, item)
8154 my $co_url = href(-full=>1, action=>"commitdiff", hash=>$commit);
8155 if ($format eq 'rss') {
8157 "<title>" . esc_html($co{'title'}) . "</title>\n" .
8158 "<author>" . esc_html($co{'author'}) . "</author>\n" .
8159 "<pubDate>$cd{'rfc2822'}</pubDate>\n" .
8160 "<guid isPermaLink=\"true\">$co_url</guid>\n" .
8161 "<link>$co_url</link>\n" .
8162 "<description>" . esc_html($co{'title'}) . "</description>\n" .
8163 "<content:encoded>" .
8165 } elsif ($format eq 'atom') {
8167 "<title type=\"html\">" . esc_html($co{'title'}) . "</title>\n" .
8168 "<updated>$cd{'iso-8601'}</updated>\n" .
8170 " <name>" . esc_html($co{'author_name'}) . "</name>\n";
8171 if ($co{'author_email'}) {
8172 print " <email>" . esc_html($co{'author_email'}) . "</email>\n";
8174 print "</author>\n" .
8175 # use committer for contributor
8177 " <name>" . esc_html($co{'committer_name'}) . "</name>\n";
8178 if ($co{'committer_email'}) {
8179 print " <email>" . esc_html($co{'committer_email'}) . "</email>\n";
8181 print "</contributor>\n" .
8182 "<published>$cd{'iso-8601'}</published>\n" .
8183 "<link rel=\"alternate\" type=\"text/html\" href=\"$co_url\" />\n" .
8184 "<id>$co_url</id>\n" .
8185 "<content type=\"xhtml\" xml:base=\"" . esc_url($my_url) . "\">\n" .
8186 "<div xmlns=\"http://www.w3.org/1999/xhtml\">\n";
8188 my $comment = $co{'comment'};
8190 foreach my $line (@$comment) {
8191 $line = esc_html($line);
8194 print "</pre><ul>\n";
8195 foreach my $difftree_line (@difftree) {
8196 my %difftree = parse_difftree_raw_line($difftree_line);
8197 next if !$difftree{'from_id'};
8199 my $file = $difftree{'file'} || $difftree{'to_file'};
8203 $cgi->a({-href => href(-full=>1, action=>"blobdiff",
8204 hash=>$difftree{'to_id'}, hash_parent=>$difftree{'from_id'},
8205 hash_base=>$co{'id'}, hash_parent_base=>$co{'parent'},
8206 file_name=>$file, file_parent=>$difftree{'from_file'}),
8207 -title => "diff"}, 'D');
8209 print $cgi->a({-href => href(-full=>1, action=>"blame",
8210 file_name=>$file, hash_base=>$commit),
8211 -title => "blame"}, 'B');
8213 # if this is not a feed of a file history
8214 if (!defined $file_name || $file_name ne $file) {
8215 print $cgi->a({-href => href(-full=>1, action=>"history",
8216 file_name=>$file, hash=>$commit),
8217 -title => "history"}, 'H');
8219 $file = esc_path($file);
8223 if ($format eq 'rss') {
8224 print "</ul>]]>\n" .
8225 "</content:encoded>\n" .
8227 } elsif ($format eq 'atom') {
8228 print "</ul>\n</div>\n" .
8235 if ($format eq 'rss') {
8236 print "</channel>\n</rss>\n";
8237 } elsif ($format eq 'atom') {
8251 my @list = git_get_projects_list($project_filter, $strict_export);
8253 die_error(404, "No projects found");
8257 -type => 'text/xml',
8258 -charset => 'utf-8',
8259 -content_disposition => 'inline; filename="opml.xml"');
8261 my $title = esc_html($site_name);
8262 my $filter = " within subdirectory ";
8263 if (defined $project_filter) {
8264 $filter .= esc_html($project_filter);
8269 <?xml version="1.0" encoding="utf-8"?>
8270 <opml version="1.0">
8272 <title>$title OPML Export$filter</title>
8275 <outline text="git RSS feeds">
8278 foreach my $pr (@list) {
8280 my $head = git_get_head_hash($proj{'path'});
8281 if (!defined $head) {
8284 $git_dir = "$projectroot/$proj{'path'}";
8285 my %co = parse_commit($head);
8290 my $path = esc_html(chop_str($proj{'path'}, 25, 5));
8291 my $rss = href('project' => $proj{'path'}, 'action' => 'rss', -full => 1);
8292 my $html = href('project' => $proj{'path'}, 'action' => 'summary', -full => 1);
8293 print "<outline type=\"rss\" text=\"$path\" title=\"$path\" xmlUrl=\"$rss\" htmlUrl=\"$html\"/>\n";