# # 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(); } } }