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.
34 use lib (split(/:/, $ENV{GITPERLLIB}));
40 my $MAX_PACKET_CONTENT_SIZE = 65516;
41 my $log_file = shift @ARGV;
42 my @capabilities = @ARGV;
44 open my $debug, ">>", $log_file or die "cannot open log file: $!";
47 'test-delay10.a' => { "requested" => 0, "count" => 1 },
48 'test-delay11.a' => { "requested" => 0, "count" => 1 },
49 'test-delay20.a' => { "requested" => 0, "count" => 2 },
50 'test-delay10.b' => { "requested" => 0, "count" => 1 },
51 'missing-delay.a' => { "requested" => 0, "count" => 1 },
52 'invalid-delay.a' => { "requested" => 0, "count" => 1 },
57 $str =~ y/A-Za-z/N-ZA-Mn-za-m/;
61 print $debug "START\n";
64 packet_initialize("git-filter", 2);
66 my %remote_caps = packet_read_and_check_capabilities("clean", "smudge", "delay");
67 packet_check_and_write_capabilities(\%remote_caps, @capabilities);
69 print $debug "init handshake complete\n";
73 my ( $res, $command ) = packet_required_key_val_read("command");
75 print $debug "STOP\n";
78 print $debug "IN: $command";
81 if ( $command eq "list_available_blobs" ) {
83 packet_compare_lists([1, ""], packet_bin_read()) ||
84 die "bad list_available_blobs end";
86 foreach my $pathname ( sort keys %DELAY ) {
87 if ( $DELAY{$pathname}{"requested"} >= 1 ) {
88 $DELAY{$pathname}{"count"} = $DELAY{$pathname}{"count"} - 1;
89 if ( $pathname eq "invalid-delay.a" ) {
90 # Send Git a pathname that was not delayed earlier
91 packet_txt_write("pathname=unfiltered");
93 if ( $pathname eq "missing-delay.a" ) {
94 # Do not signal Git that this file is available
95 } elsif ( $DELAY{$pathname}{"count"} == 0 ) {
96 print $debug " $pathname";
97 packet_txt_write("pathname=$pathname");
104 print $debug " [OK]\n";
106 packet_txt_write("status=success");
109 my ( $res, $pathname ) = packet_required_key_val_read("pathname");
111 die "unexpected EOF while expecting pathname";
113 print $debug " $pathname";
117 my ( $done, $buffer ) = packet_txt_read();
118 while ( $buffer ne '' ) {
119 if ( $buffer eq "can-delay=1" ) {
120 if ( exists $DELAY{$pathname} and $DELAY{$pathname}{"requested"} == 0 ) {
121 $DELAY{$pathname}{"requested"} = 1;
124 die "Unknown message '$buffer'";
127 ( $done, $buffer ) = packet_txt_read();
130 die "unexpected EOF after pathname '$pathname'";
139 ( $done, $buffer ) = packet_bin_read();
143 die "unexpected EOF while reading input for '$pathname'";
145 print $debug " " . length($input) . " [OK] -- ";
150 if ( exists $DELAY{$pathname} and exists $DELAY{$pathname}{"output"} ) {
151 $output = $DELAY{$pathname}{"output"}
152 } elsif ( $pathname eq "error.r" or $pathname eq "abort.r" ) {
154 } elsif ( $command eq "clean" and grep( /^clean$/, @capabilities ) ) {
155 $output = rot13($input);
156 } elsif ( $command eq "smudge" and grep( /^smudge$/, @capabilities ) ) {
157 $output = rot13($input);
159 die "bad command '$command'";
162 if ( $pathname eq "error.r" ) {
163 print $debug "[ERROR]\n";
165 packet_txt_write("status=error");
167 } elsif ( $pathname eq "abort.r" ) {
168 print $debug "[ABORT]\n";
170 packet_txt_write("status=abort");
172 } elsif ( $command eq "smudge" and
173 exists $DELAY{$pathname} and
174 $DELAY{$pathname}{"requested"} == 1 ) {
175 print $debug "[DELAYED]\n";
177 packet_txt_write("status=delayed");
179 $DELAY{$pathname}{"requested"} = 2;
180 $DELAY{$pathname}{"output"} = $output;
182 packet_txt_write("status=success");
185 if ( $pathname eq "${command}-write-fail.r" ) {
186 print $debug "[WRITE FAIL]\n";
188 die "${command} write error";
191 print $debug "OUT: " . length($output) . " ";
194 while ( length($output) > 0 ) {
195 my $packet = substr( $output, 0, $MAX_PACKET_CONTENT_SIZE );
196 packet_bin_write($packet);
197 # dots represent the number of packets
199 if ( length($output) > $MAX_PACKET_CONTENT_SIZE ) {
200 $output = substr( $output, $MAX_PACKET_CONTENT_SIZE );
206 print $debug " [OK]\n";