remote.txt: update documentation for 'update' command

[git.git] / t / t0021 / rot13-filter.pl

#
# Example implementation for the Git filter protocol version 2
# See Documentation/gitattributes.txt, section "Filter Protocol"
#
# The first argument defines a debug log file that the script write to.
# All remaining arguments define a list of supported protocol
# capabilities ("clean", "smudge", etc).
#
# This implementation supports special test cases:
# (1) If data with the pathname "clean-write-fail.r" is processed with
#     a "clean" operation then the write operation will die.
# (2) If data with the pathname "smudge-write-fail.r" is processed with
#     a "smudge" operation then the write operation will die.
# (3) If data with the pathname "error.r" is processed with any
#     operation then the filter signals that it cannot or does not want
#     to process the file.
# (4) If data with the pathname "abort.r" is processed with any
#     operation then the filter signals that it cannot or does not want
#     to process the file and any file after that is processed with the
#     same command.
# (5) If data with a pathname that is a key in the DELAY hash is
#     requested (e.g. "test-delay10.a") then the filter responds with
#     a "delay" status and sets the "requested" field in the DELAY hash.
#     The filter will signal the availability of this object after
#     "count" (field in DELAY hash) "list_available_blobs" commands.
# (6) If data with the pathname "missing-delay.a" is processed that the
#     filter will drop the path from the "list_available_blobs" response.
# (7) If data with the pathname "invalid-delay.a" is processed that the
#     filter will add the path "unfiltered" which was not delayed before
#     to the "list_available_blobs" response.
#

use 5.008;
sub gitperllib {
        # Git assumes that all path lists are Unix-y colon-separated ones. But
        # when the Git for Windows executes the test suite, its MSYS2 Bash
        # calls git.exe, and colon-separated path lists are converted into
        # Windows-y semicolon-separated lists of *Windows* paths (which
        # naturally contain a colon after the drive letter, so splitting by
        # colons simply does not cut it).
        #
        # Detect semicolon-separated path list and handle them appropriately.

        if ($ENV{GITPERLLIB} =~ /;/) {
                return split(/;/, $ENV{GITPERLLIB});
        }
        return split(/:/, $ENV{GITPERLLIB});
}
use lib (gitperllib());
use strict;
use warnings;
use IO::File;
use Git::Packet;

my $MAX_PACKET_CONTENT_SIZE = 65516;
my $log_file                = shift @ARGV;
my @capabilities            = @ARGV;

open my $debug, ">>", $log_file or die "cannot open log file: $!";

my %DELAY = (
        'test-delay10.a' => { "requested" => 0, "count" => 1 },
        'test-delay11.a' => { "requested" => 0, "count" => 1 },
        'test-delay20.a' => { "requested" => 0, "count" => 2 },
        'test-delay10.b' => { "requested" => 0, "count" => 1 },
        'missing-delay.a' => { "requested" => 0, "count" => 1 },
        'invalid-delay.a' => { "requested" => 0, "count" => 1 },
);

sub rot13 {
        my $str = shift;
        $str =~ y/A-Za-z/N-ZA-Mn-za-m/;
        return $str;
}

print $debug "START\n";
$debug->flush();

packet_initialize("git-filter", 2);

my %remote_caps = packet_read_and_check_capabilities("clean", "smudge", "delay");
packet_check_and_write_capabilities(\%remote_caps, @capabilities);

print $debug "init handshake complete\n";
$debug->flush();

while (1) {
        my ( $res, $command ) = packet_key_val_read("command");
        if ( $res == -1 ) {
                print $debug "STOP\n";
                exit();
        }
        print $debug "IN: $command";
        $debug->flush();

        if ( $command eq "list_available_blobs" ) {
                # Flush
                packet_compare_lists([1, ""], packet_bin_read()) ||
                        die "bad list_available_blobs end";

                foreach my $pathname ( sort keys %DELAY ) {
                        if ( $DELAY{$pathname}{"requested"} >= 1 ) {
                                $DELAY{$pathname}{"count"} = $DELAY{$pathname}{"count"} - 1;
                                if ( $pathname eq "invalid-delay.a" ) {
                                        # Send Git a pathname that was not delayed earlier
                                        packet_txt_write("pathname=unfiltered");
                                }
                                if ( $pathname eq "missing-delay.a" ) {
                                        # Do not signal Git that this file is available
                                } elsif ( $DELAY{$pathname}{"count"} == 0 ) {
                                        print $debug " $pathname";
                                        packet_txt_write("pathname=$pathname");
                                }
                        }
                }

                packet_flush();

                print $debug " [OK]\n";
                $debug->flush();
                packet_txt_write("status=success");
                packet_flush();
        } else {
                my ( $res, $pathname ) = packet_key_val_read("pathname");
                if ( $res == -1 ) {
                        die "unexpected EOF while expecting pathname";
                }
                print $debug " $pathname";
                $debug->flush();

                # Read until flush
                my ( $done, $buffer ) = packet_txt_read();
                while ( $buffer ne '' ) {
                        if ( $buffer eq "can-delay=1" ) {
                                if ( exists $DELAY{$pathname} and $DELAY{$pathname}{"requested"} == 0 ) {
                                        $DELAY{$pathname}{"requested"} = 1;
                                }
                        } else {
                                die "Unknown message '$buffer'";
                        }

                        ( $done, $buffer ) = packet_txt_read();
                }
                if ( $done == -1 ) {
                        die "unexpected EOF after pathname '$pathname'";
                }

                my $input = "";
                {
                        binmode(STDIN);
                        my $buffer;
                        my $done = 0;
                        while ( !$done ) {
                                ( $done, $buffer ) = packet_bin_read();
                                $input .= $buffer;
                        }
                        if ( $done == -1 ) {
                                die "unexpected EOF while reading input for '$pathname'";
                        }                       
                        print $debug " " . length($input) . " [OK] -- ";
                        $debug->flush();
                }

                my $output;
                if ( exists $DELAY{$pathname} and exists $DELAY{$pathname}{"output"} ) {
                        $output = $DELAY{$pathname}{"output"}
                } elsif ( $pathname eq "error.r" or $pathname eq "abort.r" ) {
                        $output = "";
                } elsif ( $command eq "clean" and grep( /^clean$/, @capabilities ) ) {
                        $output = rot13($input);
                } elsif ( $command eq "smudge" and grep( /^smudge$/, @capabilities ) ) {
                        $output = rot13($input);
                } else {
                        die "bad command '$command'";
                }

                if ( $pathname eq "error.r" ) {
                        print $debug "[ERROR]\n";
                        $debug->flush();
                        packet_txt_write("status=error");
                        packet_flush();
                } elsif ( $pathname eq "abort.r" ) {
                        print $debug "[ABORT]\n";
                        $debug->flush();
                        packet_txt_write("status=abort");
                        packet_flush();
                } elsif ( $command eq "smudge" and
                        exists $DELAY{$pathname} and
                        $DELAY{$pathname}{"requested"} == 1 ) {
                        print $debug "[DELAYED]\n";
                        $debug->flush();
                        packet_txt_write("status=delayed");
                        packet_flush();
                        $DELAY{$pathname}{"requested"} = 2;
                        $DELAY{$pathname}{"output"} = $output;
                } else {
                        packet_txt_write("status=success");
                        packet_flush();

                        if ( $pathname eq "${command}-write-fail.r" ) {
                                print $debug "[WRITE FAIL]\n";
                                $debug->flush();
                                die "${command} write error";
                        }

                        print $debug "OUT: " . length($output) . " ";
                        $debug->flush();

                        while ( length($output) > 0 ) {
                                my $packet = substr( $output, 0, $MAX_PACKET_CONTENT_SIZE );
                                packet_bin_write($packet);
                                # dots represent the number of packets
                                print $debug ".";
                                if ( length($output) > $MAX_PACKET_CONTENT_SIZE ) {
                                        $output = substr( $output, $MAX_PACKET_CONTENT_SIZE );
                                } else {
                                        $output = "";
                                }
                        }
                        packet_flush();
                        print $debug " [OK]\n";
                        $debug->flush();
                        packet_flush();
                }
        }
}