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