cgit: support running cgit as a standalone CGI

We depend on git-http-backend for smart HTTP clone support,
however; since cgit does not support smart clones natively.
WWW.pm will be able to cascade down to this as a 404 handler in
the future.

1 files changed, 87 insertions, 0 deletions

diff --git a/lib/PublicInbox/Cgit.pm b/lib/PublicInbox/Cgit.pm
new file mode 100644
index 00000000..3d1a0d54
--- /dev/null
+++ b/lib/PublicInbox/Cgit.pm
@@ -0,0 +1,87 @@
+# Copyright (C) 2019 all contributors <meta@public-inbox.org>
+# License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>
+
+# wrapper for cgit(1) and git-http-backend(1) for browsing and
+# serving git code repositories.  Requires 'publicinbox.cgitrc'
+# directive to be set in the public-inbox config file.
+
+package PublicInbox::Cgit;
+use strict;
+use PublicInbox::GitHTTPBackend;
+# not bothering with Exporter for a one-off
+*r = *PublicInbox::GitHTTPBackend::r;
+*input_prepare = *PublicInbox::GitHTTPBackend::input_prepare;
+*parse_cgi_headers = *PublicInbox::GitHTTPBackend::parse_cgi_headers;
+*serve = *PublicInbox::GitHTTPBackend::serve;
+use warnings;
+use PublicInbox::Qspawn;
+
+sub new {
+        my ($class, $pi_config) = @_;
+        my $cgit_bin = $pi_config->{'publicinbox.cgitbin'} ||
+                # Debian default location:
+                '/usr/lib/cgit/cgit.cgi';
+
+        my $self = bless {
+                cmd => [ $cgit_bin ],
+                pi_config => $pi_config,
+        }, $class;
+
+        $pi_config->each_inbox(sub {}); # fill in -code_repos mapped to inboxes
+
+        # some cgit repos may not be mapped to inboxes, so ensure those exist:
+        my $code_repos = $pi_config->{-code_repos};
+        foreach my $k (keys %$pi_config) {
+                $k =~ /\Acoderepo\.(.+)\.dir\z/ or next;
+                my $dir = $pi_config->{$k};
+                $code_repos->{$1} ||= PublicInbox::Git->new($dir);
+        }
+        while (my ($nick, $repo) = each %$code_repos) {
+                $self->{"\0$nick"} = $repo;
+        }
+        $self;
+}
+
+# only what cgit cares about:
+my @PASS_ENV = qw(
+        HTTP_HOST
+        QUERY_STRING
+        REQUEST_METHOD
+        SCRIPT_NAME
+        SERVER_NAME
+        SERVER_PORT
+        HTTP_COOKIE
+        HTTP_REFERER
+        CONTENT_LENGTH
+);
+# XXX: cgit filters may care about more variables...
+
+sub call {
+        my ($self, $env) = @_;
+        my $path_info = $env->{PATH_INFO};
+
+        # handle requests without spawning cgit iff possible:
+        if ($path_info =~ m!\A/(.+?)/($PublicInbox::GitHTTPBackend::ANY)\z!ox) {
+                my ($nick, $path) = ($1, $2);
+                if (my $git = $self->{"\0$nick"}) {
+                        return serve($env, $git, $path);
+                }
+        }
+
+        my $cgi_env = { PATH_INFO => $path_info };
+        foreach (@PASS_ENV) {
+                defined(my $v = $env->{$_}) or next;
+                $cgi_env->{$_} = $v;
+        }
+        $cgi_env->{'HTTPS'} = 'on' if $env->{'psgi.url_scheme'} eq 'https';
+
+        my $rdr = input_prepare($env) or return r(500);
+        my $qsp = PublicInbox::Qspawn->new($self->{cmd}, $cgi_env, $rdr);
+        $qsp->psgi_return($env, undef, sub {
+                my ($r, $bref) = @_;
+                my $res = parse_cgi_headers($r, $bref) or return; # incomplete
+                $res;
+        });
+}
+
+1;