t / t0021 / rot13-filter.plon commit Merge branch 'ah/doc-wserrorhighlight' (4c244c2)
   1#
   2# Example implementation for the Git filter protocol version 2
   3# See Documentation/gitattributes.txt, section "Filter Protocol"
   4#
   5# The first argument defines a debug log file that the script write to.
   6# All remaining arguments define a list of supported protocol
   7# capabilities ("clean", "smudge", etc).
   8#
   9# This implementation supports special test cases:
  10# (1) If data with the pathname "clean-write-fail.r" is processed with
  11#     a "clean" operation then the write operation will die.
  12# (2) If data with the pathname "smudge-write-fail.r" is processed with
  13#     a "smudge" operation then the write operation will die.
  14# (3) If data with the pathname "error.r" is processed with any
  15#     operation then the filter signals that it cannot or does not want
  16#     to process the file.
  17# (4) If data with the pathname "abort.r" is processed with any
  18#     operation then the filter signals that it cannot or does not want
  19#     to process the file and any file after that is processed with the
  20#     same command.
  21# (5) If data with a pathname that is a key in the DELAY hash is
  22#     requested (e.g. "test-delay10.a") then the filter responds with
  23#     a "delay" status and sets the "requested" field in the DELAY hash.
  24#     The filter will signal the availability of this object after
  25#     "count" (field in DELAY hash) "list_available_blobs" commands.
  26# (6) If data with the pathname "missing-delay.a" is processed that the
  27#     filter will drop the path from the "list_available_blobs" response.
  28# (7) If data with the pathname "invalid-delay.a" is processed that the
  29#     filter will add the path "unfiltered" which was not delayed before
  30#     to the "list_available_blobs" response.
  31#
  32
  33use strict;
  34use warnings;
  35use IO::File;
  36
  37my $MAX_PACKET_CONTENT_SIZE = 65516;
  38my $log_file                = shift @ARGV;
  39my @capabilities            = @ARGV;
  40
  41open my $debug, ">>", $log_file or die "cannot open log file: $!";
  42
  43my %DELAY = (
  44        'test-delay10.a' => { "requested" => 0, "count" => 1 },
  45        'test-delay11.a' => { "requested" => 0, "count" => 1 },
  46        'test-delay20.a' => { "requested" => 0, "count" => 2 },
  47        'test-delay10.b' => { "requested" => 0, "count" => 1 },
  48        'missing-delay.a' => { "requested" => 0, "count" => 1 },
  49        'invalid-delay.a' => { "requested" => 0, "count" => 1 },
  50);
  51
  52sub rot13 {
  53        my $str = shift;
  54        $str =~ y/A-Za-z/N-ZA-Mn-za-m/;
  55        return $str;
  56}
  57
  58sub packet_bin_read {
  59        my $buffer;
  60        my $bytes_read = read STDIN, $buffer, 4;
  61        if ( $bytes_read == 0 ) {
  62                # EOF - Git stopped talking to us!
  63                print $debug "STOP\n";
  64                exit();
  65        }
  66        elsif ( $bytes_read != 4 ) {
  67                die "invalid packet: '$buffer'";
  68        }
  69        my $pkt_size = hex($buffer);
  70        if ( $pkt_size == 0 ) {
  71                return ( 1, "" );
  72        }
  73        elsif ( $pkt_size > 4 ) {
  74                my $content_size = $pkt_size - 4;
  75                $bytes_read = read STDIN, $buffer, $content_size;
  76                if ( $bytes_read != $content_size ) {
  77                        die "invalid packet ($content_size bytes expected; $bytes_read bytes read)";
  78                }
  79                return ( 0, $buffer );
  80        }
  81        else {
  82                die "invalid packet size: $pkt_size";
  83        }
  84}
  85
  86sub packet_txt_read {
  87        my ( $res, $buf ) = packet_bin_read();
  88        unless ( $buf eq '' or $buf =~ s/\n$// ) {
  89                die "A non-binary line MUST be terminated by an LF.";
  90        }
  91        return ( $res, $buf );
  92}
  93
  94sub packet_bin_write {
  95        my $buf = shift;
  96        print STDOUT sprintf( "%04x", length($buf) + 4 );
  97        print STDOUT $buf;
  98        STDOUT->flush();
  99}
 100
 101sub packet_txt_write {
 102        packet_bin_write( $_[0] . "\n" );
 103}
 104
 105sub packet_flush {
 106        print STDOUT sprintf( "%04x", 0 );
 107        STDOUT->flush();
 108}
 109
 110print $debug "START\n";
 111$debug->flush();
 112
 113( packet_txt_read() eq ( 0, "git-filter-client" ) ) || die "bad initialize";
 114( packet_txt_read() eq ( 0, "version=2" ) )         || die "bad version";
 115( packet_bin_read() eq ( 1, "" ) )                  || die "bad version end";
 116
 117packet_txt_write("git-filter-server");
 118packet_txt_write("version=2");
 119packet_flush();
 120
 121( packet_txt_read() eq ( 0, "capability=clean" ) )  || die "bad capability";
 122( packet_txt_read() eq ( 0, "capability=smudge" ) ) || die "bad capability";
 123( packet_txt_read() eq ( 0, "capability=delay" ) )  || die "bad capability";
 124( packet_bin_read() eq ( 1, "" ) )                  || die "bad capability end";
 125
 126foreach (@capabilities) {
 127        packet_txt_write( "capability=" . $_ );
 128}
 129packet_flush();
 130print $debug "init handshake complete\n";
 131$debug->flush();
 132
 133while (1) {
 134        my ( $command ) = packet_txt_read() =~ /^command=(.+)$/;
 135        print $debug "IN: $command";
 136        $debug->flush();
 137
 138        if ( $command eq "list_available_blobs" ) {
 139                # Flush
 140                packet_bin_read();
 141
 142                foreach my $pathname ( sort keys %DELAY ) {
 143                        if ( $DELAY{$pathname}{"requested"} >= 1 ) {
 144                                $DELAY{$pathname}{"count"} = $DELAY{$pathname}{"count"} - 1;
 145                                if ( $pathname eq "invalid-delay.a" ) {
 146                                        # Send Git a pathname that was not delayed earlier
 147                                        packet_txt_write("pathname=unfiltered");
 148                                }
 149                                if ( $pathname eq "missing-delay.a" ) {
 150                                        # Do not signal Git that this file is available
 151                                } elsif ( $DELAY{$pathname}{"count"} == 0 ) {
 152                                        print $debug " $pathname";
 153                                        packet_txt_write("pathname=$pathname");
 154                                }
 155                        }
 156                }
 157
 158                packet_flush();
 159
 160                print $debug " [OK]\n";
 161                $debug->flush();
 162                packet_txt_write("status=success");
 163                packet_flush();
 164        }
 165        else {
 166                my ( $pathname ) = packet_txt_read() =~ /^pathname=(.+)$/;
 167                print $debug " $pathname";
 168                $debug->flush();
 169
 170                if ( $pathname eq "" ) {
 171                        die "bad pathname '$pathname'";
 172                }
 173
 174                # Read until flush
 175                my ( $done, $buffer ) = packet_txt_read();
 176                while ( $buffer ne '' ) {
 177                        if ( $buffer eq "can-delay=1" ) {
 178                                if ( exists $DELAY{$pathname} and $DELAY{$pathname}{"requested"} == 0 ) {
 179                                        $DELAY{$pathname}{"requested"} = 1;
 180                                }
 181                        } else {
 182                                die "Unknown message '$buffer'";
 183                        }
 184
 185                        ( $done, $buffer ) = packet_txt_read();
 186                }
 187
 188                my $input = "";
 189                {
 190                        binmode(STDIN);
 191                        my $buffer;
 192                        my $done = 0;
 193                        while ( !$done ) {
 194                                ( $done, $buffer ) = packet_bin_read();
 195                                $input .= $buffer;
 196                        }
 197                        print $debug " " . length($input) . " [OK] -- ";
 198                        $debug->flush();
 199                }
 200
 201                my $output;
 202                if ( exists $DELAY{$pathname} and exists $DELAY{$pathname}{"output"} ) {
 203                        $output = $DELAY{$pathname}{"output"}
 204                }
 205                elsif ( $pathname eq "error.r" or $pathname eq "abort.r" ) {
 206                        $output = "";
 207                }
 208                elsif ( $command eq "clean" and grep( /^clean$/, @capabilities ) ) {
 209                        $output = rot13($input);
 210                }
 211                elsif ( $command eq "smudge" and grep( /^smudge$/, @capabilities ) ) {
 212                        $output = rot13($input);
 213                }
 214                else {
 215                        die "bad command '$command'";
 216                }
 217
 218                if ( $pathname eq "error.r" ) {
 219                        print $debug "[ERROR]\n";
 220                        $debug->flush();
 221                        packet_txt_write("status=error");
 222                        packet_flush();
 223                }
 224                elsif ( $pathname eq "abort.r" ) {
 225                        print $debug "[ABORT]\n";
 226                        $debug->flush();
 227                        packet_txt_write("status=abort");
 228                        packet_flush();
 229                }
 230                elsif ( $command eq "smudge" and
 231                        exists $DELAY{$pathname} and
 232                        $DELAY{$pathname}{"requested"} == 1
 233                ) {
 234                        print $debug "[DELAYED]\n";
 235                        $debug->flush();
 236                        packet_txt_write("status=delayed");
 237                        packet_flush();
 238                        $DELAY{$pathname}{"requested"} = 2;
 239                        $DELAY{$pathname}{"output"} = $output;
 240                }
 241                else {
 242                        packet_txt_write("status=success");
 243                        packet_flush();
 244
 245                        if ( $pathname eq "${command}-write-fail.r" ) {
 246                                print $debug "[WRITE FAIL]\n";
 247                                $debug->flush();
 248                                die "${command} write error";
 249                        }
 250
 251                        print $debug "OUT: " . length($output) . " ";
 252                        $debug->flush();
 253
 254                        while ( length($output) > 0 ) {
 255                                my $packet = substr( $output, 0, $MAX_PACKET_CONTENT_SIZE );
 256                                packet_bin_write($packet);
 257                                # dots represent the number of packets
 258                                print $debug ".";
 259                                if ( length($output) > $MAX_PACKET_CONTENT_SIZE ) {
 260                                        $output = substr( $output, $MAX_PACKET_CONTENT_SIZE );
 261                                }
 262                                else {
 263                                        $output = "";
 264                                }
 265                        }
 266                        packet_flush();
 267                        print $debug " [OK]\n";
 268                        $debug->flush();
 269                        packet_flush();
 270                }
 271        }
 272}