2 # Example implementation for the Git filter protocol version 2
3 # See Documentation/gitattributes.txt, section "Filter Protocol"
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).
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
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.
35 # Git assumes that all path lists are Unix-y colon-separated ones. But
36 # when the Git for Windows executes the test suite, its MSYS2 Bash
37 # calls git.exe, and colon-separated path lists are converted into
38 # Windows-y semicolon-separated lists of *Windows* paths (which
39 # naturally contain a colon after the drive letter, so splitting by
40 # colons simply does not cut it).
42 # Detect semicolon-separated path list and handle them appropriately.
44 if ($ENV{GITPERLLIB} =~ /;/) {
45 return split(/;/, $ENV{GITPERLLIB});
47 return split(/:/, $ENV{GITPERLLIB});
49 use lib (gitperllib());
55 my $MAX_PACKET_CONTENT_SIZE = 65516;
56 my $log_file = shift @ARGV;
57 my @capabilities = @ARGV;
59 open my $debug, ">>", $log_file or die "cannot open log file: $!";
62 'test-delay10.a' => { "requested" => 0, "count" => 1 },
63 'test-delay11.a' => { "requested" => 0, "count" => 1 },
64 'test-delay20.a' => { "requested" => 0, "count" => 2 },
65 'test-delay10.b' => { "requested" => 0, "count" => 1 },
66 'missing-delay.a' => { "requested" => 0, "count" => 1 },
67 'invalid-delay.a' => { "requested" => 0, "count" => 1 },
72 $str =~ y/A-Za-z/N-ZA-Mn-za-m/;
76 print $debug "START\n";
79 packet_initialize("git-filter", 2);
81 my %remote_caps = packet_read_and_check_capabilities("clean", "smudge", "delay");
82 packet_check_and_write_capabilities(\%remote_caps, @capabilities);
84 print $debug "init handshake complete\n";
88 my ( $res, $command ) = packet_key_val_read("command");
90 print $debug "STOP\n";
93 print $debug "IN: $command";
96 if ( $command eq "list_available_blobs" ) {
98 packet_compare_lists([1, ""], packet_bin_read()) ||
99 die "bad list_available_blobs end";
101 foreach my $pathname ( sort keys %DELAY ) {
102 if ( $DELAY{$pathname}{"requested"} >= 1 ) {
103 $DELAY{$pathname}{"count"} = $DELAY{$pathname}{"count"} - 1;
104 if ( $pathname eq "invalid-delay.a" ) {
105 # Send Git a pathname that was not delayed earlier
106 packet_txt_write("pathname=unfiltered");
108 if ( $pathname eq "missing-delay.a" ) {
109 # Do not signal Git that this file is available
110 } elsif ( $DELAY{$pathname}{"count"} == 0 ) {
111 print $debug " $pathname";
112 packet_txt_write("pathname=$pathname");
119 print $debug " [OK]\n";
121 packet_txt_write("status=success");
124 my ( $res, $pathname ) = packet_key_val_read("pathname");
126 die "unexpected EOF while expecting pathname";
128 print $debug " $pathname";
132 my ( $done, $buffer ) = packet_txt_read();
133 while ( $buffer ne '' ) {
134 if ( $buffer eq "can-delay=1" ) {
135 if ( exists $DELAY{$pathname} and $DELAY{$pathname}{"requested"} == 0 ) {
136 $DELAY{$pathname}{"requested"} = 1;
139 die "Unknown message '$buffer'";
142 ( $done, $buffer ) = packet_txt_read();
145 die "unexpected EOF after pathname '$pathname'";
154 ( $done, $buffer ) = packet_bin_read();
158 die "unexpected EOF while reading input for '$pathname'";
160 print $debug " " . length($input) . " [OK] -- ";
165 if ( exists $DELAY{$pathname} and exists $DELAY{$pathname}{"output"} ) {
166 $output = $DELAY{$pathname}{"output"}
167 } elsif ( $pathname eq "error.r" or $pathname eq "abort.r" ) {
169 } elsif ( $command eq "clean" and grep( /^clean$/, @capabilities ) ) {
170 $output = rot13($input);
171 } elsif ( $command eq "smudge" and grep( /^smudge$/, @capabilities ) ) {
172 $output = rot13($input);
174 die "bad command '$command'";
177 if ( $pathname eq "error.r" ) {
178 print $debug "[ERROR]\n";
180 packet_txt_write("status=error");
182 } elsif ( $pathname eq "abort.r" ) {
183 print $debug "[ABORT]\n";
185 packet_txt_write("status=abort");
187 } elsif ( $command eq "smudge" and
188 exists $DELAY{$pathname} and
189 $DELAY{$pathname}{"requested"} == 1 ) {
190 print $debug "[DELAYED]\n";
192 packet_txt_write("status=delayed");
194 $DELAY{$pathname}{"requested"} = 2;
195 $DELAY{$pathname}{"output"} = $output;
197 packet_txt_write("status=success");
200 if ( $pathname eq "${command}-write-fail.r" ) {
201 print $debug "[WRITE FAIL]\n";
203 die "${command} write error";
206 print $debug "OUT: " . length($output) . " ";
209 while ( length($output) > 0 ) {
210 my $packet = substr( $output, 0, $MAX_PACKET_CONTENT_SIZE );
211 packet_bin_write($packet);
212 # dots represent the number of packets
214 if ( length($output) > $MAX_PACKET_CONTENT_SIZE ) {
215 $output = substr( $output, $MAX_PACKET_CONTENT_SIZE );
221 print $debug " [OK]\n";