]> Sergey Matveev's repositories - public-inbox.git/blob - lib/PublicInbox/GitAsyncCat.pm
git_async_cat: fix outdated comment
[public-inbox.git] / lib / PublicInbox / GitAsyncCat.pm
1 # Copyright (C) 2020 all contributors <meta@public-inbox.org>
2 # License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>
3 #
4 # internal class used by PublicInbox::Git + PublicInbox::DS
5 # This parses the output pipe of "git cat-file --batch"
6 #
7 # Note: this does NOT set the non-blocking flag, we expect `git cat-file'
8 # to be a local process, and git won't start writing a blob until it's
9 # fully read.  So minimize context switching and read as much as possible
10 # and avoid holding a buffer in our heap any longer than it has to live.
11 package PublicInbox::GitAsyncCat;
12 use strict;
13 use parent qw(PublicInbox::DS Exporter);
14 use PublicInbox::Syscall qw(EPOLLIN EPOLLET);
15 our @EXPORT = qw(git_async_cat);
16
17 sub _add {
18         my ($class, $git) = @_;
19         $git->batch_prepare;
20         my $self = bless { git => $git }, $class;
21         $self->SUPER::new($git->{in}, EPOLLIN|EPOLLET);
22         \undef; # this is a true ref()
23 }
24
25 sub event_step {
26         my ($self) = @_;
27         my $git = $self->{git};
28         return $self->close if ($git->{in} // 0) != ($self->{sock} // 1);
29         my $inflight = $git->{inflight};
30         if ($inflight && @$inflight) {
31                 $git->cat_async_step($inflight);
32                 $self->requeue if @$inflight || exists $git->{cat_rbuf};
33         }
34 }
35
36 sub git_async_cat ($$$$) {
37         my ($git, $oid, $cb, $arg) = @_;
38         $git->cat_async($oid, $cb, $arg);
39         $git->{async_cat} //= _add(__PACKAGE__, $git);
40 }
41
42 1;