]>
git.ipfire.org Git - thirdparty/git.git/blob - git-cvsserver.perl
4 #### This application is a CVS emulation layer for git.
5 #### It is intended for clients to connect over SSH.
6 #### See the documentation for more details.
8 #### Copyright The Open University UK - 2006.
10 #### Authors: Martyn Smith <martyn@catalyst.net.nz>
11 #### Martin Langhoff <martin@catalyst.net.nz>
14 #### Released under the GNU Public License, version 2.
23 use File
:: Temp qw
/tempdir tempfile/ ;
25 use Getopt
:: Long
qw(:config require_order no_ignore_case) ;
27 my $VERSION = '@ @GIT_VERSION @@' ;
29 my $log = GITCVS
:: log -> new ();
47 # Enable autoflush for STDOUT (otherwise the whole thing falls apart)
50 #### Definition and mappings of functions ####
54 'Valid-responses' => \
& req_Validresponses
,
55 'valid-requests' => \
& req_validrequests
,
56 'Directory' => \
& req_Directory
,
57 'Entry' => \
& req_Entry
,
58 'Modified' => \
& req_Modified
,
59 'Unchanged' => \
& req_Unchanged
,
60 'Questionable' => \
& req_Questionable
,
61 'Argument' => \
& req_Argument
,
62 'Argumentx' => \
& req_Argument
,
63 'expand-modules' => \
& req_expandmodules
,
65 'remove' => \
& req_remove
,
67 'update' => \
& req_update
,
72 'tag' => \
& req_CATCHALL
,
73 'status' => \
& req_status
,
74 'admin' => \
& req_CATCHALL
,
75 'history' => \
& req_CATCHALL
,
76 'watchers' => \
& req_CATCHALL
,
77 'editors' => \
& req_CATCHALL
,
78 'annotate' => \
& req_annotate
,
79 'Global_option' => \
& req_Globaloption
,
80 #'annotate' => \&req_CATCHALL,
83 ##############################################
86 # $state holds all the bits of information the clients sends us that could
87 # potentially be useful when it comes to actually _doing_ something.
88 my $state = { prependdir
=> '' };
89 $log -> info ( "--------------- STARTING -----------------" );
92 "Usage: git-cvsserver [options] [pserver|server] [<directory> ...] \n " .
93 " --base-path <path> : Prepend to requested CVSROOT \n " .
94 " --strict-paths : Don't allow recursing into subdirectories \n " .
95 " --export-all : Don't check for gitcvs.enabled in config \n " .
96 " --version, -V : Print version information and exit \n " .
97 " --help, -h, -H : Print usage information and exit \n " .
99 "<directory> ... is a list of allowed directories. If no directories \n " .
100 "are given, all are allowed. This is an additional restriction, gitcvs \n " .
101 "access still needs to be enabled by the gitcvs.enabled config option. \n " ;
103 my @opts = ( 'help|h|H' , 'version|V' ,
104 'base-path=s' , 'strict-paths' , 'export-all' );
105 GetOptions
( $state , @opts )
108 if ( $state ->{ version
}) {
109 print "git-cvsserver version $VERSION \n " ;
112 if ( $state ->{ help
}) {
117 my $TEMP_DIR = tempdir
( CLEANUP
=> 1 );
118 $log -> debug ( "Temporary directory is ' $TEMP_DIR '" );
120 $state ->{ method
} = 'ext' ;
122 if ( $ARGV [ 0 ] eq 'pserver' ) {
123 $state ->{ method
} = 'pserver' ;
125 } elsif ( $ARGV [ 0 ] eq 'server' ) {
130 # everything else is a directory
131 $state ->{ allowed_roots
} = [ @ARGV ];
133 # don't export the whole system unless the users requests it
134 if ( $state ->{ 'export-all' } && ! @
{ $state ->{ allowed_roots
}}) {
135 die "--export-all can only be used together with an explicit whitelist \n " ;
138 # if we are called with a pserver argument,
139 # deal with the authentication cat before entering the
141 if ( $state ->{ method
} eq 'pserver' ) {
142 my $line = < STDIN
>; chomp $line ;
143 unless ( $line =~ /^BEGIN (AUTH|VERIFICATION) REQUEST$/ ) {
144 die "E Do not understand $line - expecting BEGIN AUTH REQUEST \n " ;
147 $line = < STDIN
>; chomp $line ;
148 req_Root
( 'root' , $line ) # reuse Root
149 or die "E Invalid root $line \n " ;
150 $line = < STDIN
>; chomp $line ;
151 unless ( $line eq 'anonymous' ) {
152 print "E Only anonymous user allowed via pserver \n " ;
153 print "I HATE YOU \n " ;
156 $line = < STDIN
>; chomp $line ; # validate the password?
157 $line = < STDIN
>; chomp $line ;
158 unless ( $line eq "END $request REQUEST" ) {
159 die "E Do not understand $line -- expecting END $request REQUEST \n " ;
161 print "I LOVE YOU \n " ;
162 exit if $request eq 'VERIFICATION' ; # cvs login
163 # and now back to our regular programme...
166 # Keep going until the client closes the connection
171 # Check to see if we've seen this method, and call appropriate function.
172 if ( /^([\w-]+)(?:\s+(.*))?$/ and defined ( $methods ->{ $1 }) )
174 # use the $methods hash to call the appropriate sub for this command
175 #$log->info("Method : $1");
176 &{ $methods ->{ $1 }}( $1 , $2 );
178 # log fatal because we don't understand this function. If this happens
179 # we're fairly screwed because we don't know if the client is expecting
180 # a response. If it is, the client will hang, we'll hang, and the whole
181 # thing will be custard.
182 $log -> fatal ( "Don't understand command $_ \n " );
183 die ( "Unknown command $_ " );
187 $log -> debug ( "Processing time : user=" . ( times )[ 0 ] . " system=" . ( times )[ 1 ]);
188 $log -> info ( "--------------- FINISH -----------------" );
190 # Magic catchall method.
191 # This is the method that will handle all commands we haven't yet
192 # implemented. It simply sends a warning to the log file indicating a
193 # command that hasn't been implemented has been invoked.
196 my ( $cmd , $data ) = @_ ;
197 $log -> warn ( "Unhandled command : req_ $cmd : $data " );
202 # Response expected: no. Tell the server which CVSROOT to use. Note that
203 # pathname is a local directory and not a fully qualified CVSROOT variable.
204 # pathname must already exist; if creating a new root, use the init
205 # request, not Root. pathname does not include the hostname of the server,
206 # how to access the server, etc.; by the time the CVS protocol is in use,
207 # connection, authentication, etc., are already taken care of. The Root
208 # request must be sent only once, and it must be sent before any requests
209 # other than Valid-responses, valid-requests, UseUnchanged, Set or init.
212 my ( $cmd , $data ) = @_ ;
213 $log -> debug ( "req_Root : $data " );
215 unless ( $data =~ m
#^/#) {
216 print "error 1 Root must be an absolute pathname \n " ;
220 my $cvsroot = $state ->{ 'base-path' } || '' ;
224 if ( $state ->{ CVSROOT
}
225 && ( $state ->{ CVSROOT
} ne $cvsroot )) {
226 print "error 1 Conflicting roots specified \n " ;
230 $state ->{ CVSROOT
} = $cvsroot ;
232 $ENV { GIT_DIR
} = $state ->{ CVSROOT
} . "/" ;
234 if ( @
{ $state ->{ allowed_roots
}}) {
236 foreach my $dir ( @
{ $state ->{ allowed_roots
}}) {
237 next unless $dir =~ m
#^/#;
239 if ( $state ->{ 'strict-paths' }) {
240 if ( $ENV { GIT_DIR
} =~ m
#^\Q$dir\E/?$#) {
244 } elsif ( $ENV { GIT_DIR
} =~ m
#^\Q$dir\E(/?$|/)#) {
251 print "E $ENV {GIT_DIR} does not seem to be a valid GIT repository \n " ;
253 print "error 1 $ENV {GIT_DIR} is not a valid repository \n " ;
258 unless (- d
$ENV { GIT_DIR
} && - e
$ENV { GIT_DIR
}. 'HEAD' ) {
259 print "E $ENV {GIT_DIR} does not seem to be a valid GIT repository \n " ;
261 print "error 1 $ENV {GIT_DIR} is not a valid repository \n " ;
265 my @gitvars = `git-config -l` ;
267 print "E problems executing git-config on the server -- this is not a git repository or the PATH is not set correctly. \n " ;
269 print "error 1 - problem executing git-config \n " ;
272 foreach my $line ( @gitvars )
274 next unless ( $line =~ /^(gitcvs)\.(?:(ext|pserver)\.)?([\w-]+)=(.*)$/ );
278 $cfg ->{ $1 }{ $2 }{ $3 } = $4 ;
282 my $enabled = ( $cfg ->{ gitcvs
}{ $state ->{ method
}}{ enabled
}
283 || $cfg ->{ gitcvs
}{ enabled
});
284 unless ( $state ->{ 'export-all' } ||
285 ( $enabled && $enabled =~ /^\s*(1|true|yes)\s*$/i )) {
286 print "E GITCVS emulation needs to be enabled on this repo \n " ;
287 print "E the repo config file needs a [gitcvs] section added, and the parameter 'enabled' set to 1 \n " ;
289 print "error 1 GITCVS emulation disabled \n " ;
293 my $logfile = $cfg ->{ gitcvs
}{ $state ->{ method
}}{ logfile
} || $cfg ->{ gitcvs
}{ logfile
};
296 $log -> setfile ( $logfile );
304 # Global_option option \n
305 # Response expected: no. Transmit one of the global options `-q', `-Q',
306 # `-l', `-t', `-r', or `-n'. option must be one of those strings, no
307 # variations (such as combining of options) are allowed. For graceful
308 # handling of valid-requests, it is probably better to make new global
309 # options separate requests, rather than trying to add them to this
313 my ( $cmd , $data ) = @_ ;
314 $log -> debug ( "req_Globaloption : $data " );
315 $state ->{ globaloptions
}{ $data } = 1 ;
318 # Valid-responses request-list \n
319 # Response expected: no. Tell the server what responses the client will
320 # accept. request-list is a space separated list of tokens.
321 sub req_Validresponses
323 my ( $cmd , $data ) = @_ ;
324 $log -> debug ( "req_Validresponses : $data " );
326 # TODO : re-enable this, currently it's not particularly useful
327 #$state->{validresponses} = [ split /\s+/, $data ];
331 # Response expected: yes. Ask the server to send back a Valid-requests
333 sub req_validrequests
335 my ( $cmd , $data ) = @_ ;
337 $log -> debug ( "req_validrequests" );
339 $log -> debug ( "SEND : Valid-requests " . join ( " " , keys % $methods ));
340 $log -> debug ( "SEND : ok" );
342 print "Valid-requests " . join ( " " , keys % $methods ) . " \n " ;
346 # Directory local-directory \n
347 # Additional data: repository \n. Response expected: no. Tell the server
348 # what directory to use. The repository should be a directory name from a
349 # previous server response. Note that this both gives a default for Entry
350 # and Modified and also for ci and the other commands; normal usage is to
351 # send Directory for each directory in which there will be an Entry or
352 # Modified, and then a final Directory for the original directory, then the
353 # command. The local-directory is relative to the top level at which the
354 # command is occurring (i.e. the last Directory which is sent before the
355 # command); to indicate that top level, `.' should be sent for
359 my ( $cmd , $data ) = @_ ;
361 my $repository = < STDIN
>;
365 $state ->{ localdir
} = $data ;
366 $state ->{ repository
} = $repository ;
367 $state ->{ path
} = $repository ;
368 $state ->{ path
} =~ s/^$state->{CVSROOT}\// /;
369 $state ->{ module
} = $1 if ( $state ->{ path
} =~ s/^(.*?)(\/|$)/ /);
370 $state ->{ path
} .= "/" if ( $state ->{ path
} =~ / \S
/ );
372 $state ->{ directory
} = $state ->{ localdir
};
373 $state ->{ directory
} = "" if ( $state ->{ directory
} eq "." );
374 $state ->{ directory
} .= "/" if ( $state ->{ directory
} =~ / \S
/ );
376 if ( ( not defined ( $state ->{ prependdir
}) or $state ->{ prependdir
} eq '' ) and $state ->{ localdir
} eq "." and $state ->{ path
} =~ /\S/ )
378 $log -> info ( "Setting prepend to ' $state ->{path}'" );
379 $state ->{ prependdir
} = $state ->{ path
};
380 foreach my $entry ( keys %{ $state ->{ entries
}} )
382 $state ->{ entries
}{ $state ->{ prependdir
} . $entry } = $state ->{ entries
}{ $entry };
383 delete $state ->{ entries
}{ $entry };
387 if ( defined ( $state ->{ prependdir
} ) )
389 $log -> debug ( "Prepending ' $state ->{prependdir}' to state|directory" );
390 $state ->{ directory
} = $state ->{ prependdir
} . $state ->{ directory
}
392 $log -> debug ( "req_Directory : localdir= $data repository= $repository path= $state ->{path} directory= $state ->{directory} module= $state ->{module}" );
395 # Entry entry-line \n
396 # Response expected: no. Tell the server what version of a file is on the
397 # local machine. The name in entry-line is a name relative to the directory
398 # most recently specified with Directory. If the user is operating on only
399 # some files in a directory, Entry requests for only those files need be
400 # included. If an Entry request is sent without Modified, Is-modified, or
401 # Unchanged, it means the file is lost (does not exist in the working
402 # directory). If both Entry and one of Modified, Is-modified, or Unchanged
403 # are sent for the same file, Entry must be sent first. For a given file,
404 # one can send Modified, Is-modified, or Unchanged, but not more than one
408 my ( $cmd , $data ) = @_ ;
410 #$log->debug("req_Entry : $data");
412 my @data = split ( /\/ /, $data );
414 $state ->{ entries
}{ $state ->{ directory
}. $data [ 1 ]} = {
415 revision
=> $data [ 2 ],
416 conflict
=> $data [ 3 ],
418 tag_or_date
=> $data [ 5 ],
421 $log -> info ( "Received entry line ' $data ' => '" . $state ->{ directory
} . $data [ 1 ] . "'" );
424 # Questionable filename \n
425 # Response expected: no. Additional data: no. Tell the server to check
426 # whether filename should be ignored, and if not, next time the server
427 # sends responses, send (in a M response) `?' followed by the directory and
428 # filename. filename must not contain `/'; it needs to be a file in the
429 # directory named by the most recent Directory request.
432 my ( $cmd , $data ) = @_ ;
434 $log -> debug ( "req_Questionable : $data " );
435 $state ->{ entries
}{ $state ->{ directory
}. $data }{ questionable
} = 1 ;
439 # Response expected: yes. Add a file or directory. This uses any previous
440 # Argument, Directory, Entry, or Modified requests, if they have been sent.
441 # The last Directory sent specifies the working directory at the time of
442 # the operation. To add a directory, send the directory to be added using
443 # Directory and Argument requests.
446 my ( $cmd , $data ) = @_ ;
450 my $updater = GITCVS
:: updater
-> new ( $state ->{ CVSROOT
}, $state ->{ module
}, $log );
453 argsfromdir
( $updater );
457 foreach my $filename ( @
{ $state ->{ args
}} )
459 $filename = filecleanup
( $filename );
461 my $meta = $updater -> getmeta ( $filename );
462 my $wrev = revparse
( $filename );
464 if ( $wrev && $meta && ( $wrev < 0 ))
466 # previously removed file, add back
467 $log -> info ( "added file $filename was previously removed, send 1. $meta ->{revision}" );
469 print "MT +updated \n " ;
470 print "MT text U \n " ;
471 print "MT fname $filename \n " ;
472 print "MT newline \n " ;
473 print "MT -updated \n " ;
475 unless ( $state ->{ globaloptions
}{- n
} )
477 my ( $filepart , $dirpart ) = filenamesplit
( $filename , 1 );
479 print "Created $dirpart \n " ;
480 print $state ->{ CVSROOT
} . "/ $state ->{module}/ $filename \n " ;
482 # this is an "entries" line
483 my $kopts = kopts_from_path
( $filepart );
484 $log -> debug ( "/ $filepart /1. $meta ->{revision}// $kopts /" );
485 print "/ $filepart /1. $meta ->{revision}// $kopts / \n " ;
487 $log -> debug ( "SEND : u= $meta ->{mode},g= $meta ->{mode},o= $meta ->{mode}" );
488 print "u= $meta ->{mode},g= $meta ->{mode},o= $meta ->{mode} \n " ;
490 transmitfile
( $meta ->{ filehash
});
496 unless ( defined ( $state ->{ entries
}{ $filename }{ modified_filename
} ) )
498 print "E cvs add: nothing known about ` $filename ' \n " ;
501 # TODO : check we're not squashing an already existing file
502 if ( defined ( $state ->{ entries
}{ $filename }{ revision
} ) )
504 print "E cvs add: ` $filename ' has already been entered \n " ;
508 my ( $filepart , $dirpart ) = filenamesplit
( $filename , 1 );
510 print "E cvs add: scheduling file ` $filename ' for addition \n " ;
512 print "Checked-in $dirpart \n " ;
514 my $kopts = kopts_from_path
( $filepart );
515 print "/ $filepart /0// $kopts / \n " ;
520 if ( $addcount == 1 )
522 print "E cvs add: use `cvs commit' to add this file permanently \n " ;
524 elsif ( $addcount > 1 )
526 print "E cvs add: use `cvs commit' to add these files permanently \n " ;
533 # Response expected: yes. Remove a file. This uses any previous Argument,
534 # Directory, Entry, or Modified requests, if they have been sent. The last
535 # Directory sent specifies the working directory at the time of the
536 # operation. Note that this request does not actually do anything to the
537 # repository; the only effect of a successful remove request is to supply
538 # the client with a new entries line containing `-' to indicate a removed
539 # file. In fact, the client probably could perform this operation without
540 # contacting the server, although using remove may cause the server to
541 # perform a few more checks. The client sends a subsequent ci request to
542 # actually record the removal in the repository.
545 my ( $cmd , $data ) = @_ ;
549 # Grab a handle to the SQLite db and do any necessary updates
550 my $updater = GITCVS
:: updater
-> new ( $state ->{ CVSROOT
}, $state ->{ module
}, $log );
553 #$log->debug("add state : " . Dumper($state));
557 foreach my $filename ( @
{ $state ->{ args
}} )
559 $filename = filecleanup
( $filename );
561 if ( defined ( $state ->{ entries
}{ $filename }{ unchanged
} ) or defined ( $state ->{ entries
}{ $filename }{ modified_filename
} ) )
563 print "E cvs remove: file ` $filename ' still in working directory \n " ;
567 my $meta = $updater -> getmeta ( $filename );
568 my $wrev = revparse
( $filename );
570 unless ( defined ( $wrev ) )
572 print "E cvs remove: nothing known about ` $filename ' \n " ;
576 if ( defined ( $wrev ) and $wrev < 0 )
578 print "E cvs remove: file ` $filename ' already scheduled for removal \n " ;
582 unless ( $wrev == $meta ->{ revision
} )
584 # TODO : not sure if the format of this message is quite correct.
585 print "E cvs remove: Up to date check failed for ` $filename ' \n " ;
590 my ( $filepart , $dirpart ) = filenamesplit
( $filename , 1 );
592 print "E cvs remove: scheduling ` $filename ' for removal \n " ;
594 print "Checked-in $dirpart \n " ;
596 my $kopts = kopts_from_path
( $filepart );
597 print "/ $filepart /-1. $wrev // $kopts / \n " ;
604 print "E cvs remove: use `cvs commit' to remove this file permanently \n " ;
606 elsif ( $rmcount > 1 )
608 print "E cvs remove: use `cvs commit' to remove these files permanently \n " ;
614 # Modified filename \n
615 # Response expected: no. Additional data: mode, \n, file transmission. Send
616 # the server a copy of one locally modified file. filename is a file within
617 # the most recent directory sent with Directory; it must not contain `/'.
618 # If the user is operating on only some files in a directory, only those
619 # files need to be included. This can also be sent without Entry, if there
620 # is no entry for the file.
623 my ( $cmd , $data ) = @_ ;
627 or ( print "E end of file reading mode for $data \n " ), return ;
631 or ( print "E end of file reading size of $data \n " ), return ;
634 # Grab config information
635 my $blocksize = 8192 ;
636 my $bytesleft = $size ;
639 # Get a filehandle/name to write it to
640 my ( $fh , $filename ) = tempfile
( DIR
=> $TEMP_DIR );
642 # Loop over file data writing out to temporary file.
645 $blocksize = $bytesleft if ( $bytesleft < $blocksize );
646 read STDIN
, $tmp , $blocksize ;
648 $bytesleft -= $blocksize ;
652 or ( print "E failed to write temporary, $filename : $! \n " ), return ;
654 # Ensure we have something sensible for the file mode
655 if ( $mode =~ /u=(\w+)/ )
662 # Save the file data in $state
663 $state ->{ entries
}{ $state ->{ directory
}. $data }{ modified_filename
} = $filename ;
664 $state ->{ entries
}{ $state ->{ directory
}. $data }{ modified_mode
} = $mode ;
665 $state ->{ entries
}{ $state ->{ directory
}. $data }{ modified_hash
} = `git-hash-object $filename ` ;
666 $state ->{ entries
}{ $state ->{ directory
}. $data }{ modified_hash
} =~ s/\s.*$//s ;
668 #$log->debug("req_Modified : file=$data mode=$mode size=$size");
671 # Unchanged filename \n
672 # Response expected: no. Tell the server that filename has not been
673 # modified in the checked out directory. The filename is a file within the
674 # most recent directory sent with Directory; it must not contain `/'.
677 my ( $cmd , $data ) = @_ ;
679 $state ->{ entries
}{ $state ->{ directory
}. $data }{ unchanged
} = 1 ;
681 #$log->debug("req_Unchanged : $data");
685 # Response expected: no. Save argument for use in a subsequent command.
686 # Arguments accumulate until an argument-using command is given, at which
687 # point they are forgotten.
689 # Response expected: no. Append \n followed by text to the current argument
693 my ( $cmd , $data ) = @_ ;
695 # Argumentx means: append to last Argument (with a newline in front)
697 $log -> debug ( " $cmd : $data " );
699 if ( $cmd eq 'Argumentx' ) {
700 ${ $state ->{ arguments
}}[$ #{$state->{arguments}}] .= "\n" . $data;
702 push @
{ $state ->{ arguments
}}, $data ;
707 # Response expected: yes. Expand the modules which are specified in the
708 # arguments. Returns the data in Module-expansion responses. Note that the
709 # server can assume that this is checkout or export, not rtag or rdiff; the
710 # latter do not access the working directory and thus have no need to
711 # expand modules on the client side. Expand may not be the best word for
712 # what this request does. It does not necessarily tell you all the files
713 # contained in a module, for example. Basically it is a way of telling you
714 # which working directories the server needs to know about in order to
715 # handle a checkout of the specified modules. For example, suppose that the
716 # server has a module defined by
717 # aliasmodule -a 1dir
718 # That is, one can check out aliasmodule and it will take 1dir in the
719 # repository and check it out to 1dir in the working directory. Now suppose
720 # the client already has this module checked out and is planning on using
721 # the co request to update it. Without using expand-modules, the client
722 # would have two bad choices: it could either send information about all
723 # working directories under the current directory, which could be
724 # unnecessarily slow, or it could be ignorant of the fact that aliasmodule
725 # stands for 1dir, and neglect to send information for 1dir, which would
726 # lead to incorrect operation. With expand-modules, the client would first
727 # ask for the module to be expanded:
728 sub req_expandmodules
730 my ( $cmd , $data ) = @_ ;
734 $log -> debug ( "req_expandmodules : " . ( defined ( $data ) ?
$data : "[NULL]" ) );
736 unless ( ref $state ->{ arguments
} eq "ARRAY" )
742 foreach my $module ( @
{ $state ->{ arguments
}} )
744 $log -> debug ( "SEND : Module-expansion $module " );
745 print "Module-expansion $module \n " ;
753 # Response expected: yes. Get files from the repository. This uses any
754 # previous Argument, Directory, Entry, or Modified requests, if they have
755 # been sent. Arguments to this command are module names; the client cannot
756 # know what directories they correspond to except by (1) just sending the
757 # co request, and then seeing what directory names the server sends back in
758 # its responses, and (2) the expand-modules request.
761 my ( $cmd , $data ) = @_ ;
765 my $module = $state ->{ args
}[ 0 ];
766 my $checkout_path = $module ;
768 # use the user specified directory if we're given it
769 $checkout_path = $state ->{ opt
}{ d
} if ( exists ( $state ->{ opt
}{ d
} ) );
771 $log -> debug ( "req_co : " . ( defined ( $data ) ?
$data : "[NULL]" ) );
773 $log -> info ( "Checking out module ' $module ' ( $state ->{CVSROOT}) to ' $checkout_path '" );
775 $ENV { GIT_DIR
} = $state ->{ CVSROOT
} . "/" ;
777 # Grab a handle to the SQLite db and do any necessary updates
778 my $updater = GITCVS
:: updater
-> new ( $state ->{ CVSROOT
}, $module , $log );
781 $checkout_path =~ s
|/$||; # get rid of trailing slashes
783 # Eclipse seems to need the Clear-sticky command
784 # to prepare the 'Entries' file for the new directory.
785 print "Clear-sticky $checkout_path / \n " ;
786 print $state ->{ CVSROOT
} . "/ $module / \n " ;
787 print "Clear-static-directory $checkout_path / \n " ;
788 print $state ->{ CVSROOT
} . "/ $module / \n " ;
789 print "Clear-sticky $checkout_path / \n " ; # yes, twice
790 print $state ->{ CVSROOT
} . "/ $module / \n " ;
791 print "Template $checkout_path / \n " ;
792 print $state ->{ CVSROOT
} . "/ $module / \n " ;
795 # instruct the client that we're checking out to $checkout_path
796 print "E cvs checkout: Updating $checkout_path \n " ;
803 my ( $dir , $repodir , $remotedir , $seendirs ) = @_ ;
804 my $parent = dirname
( $dir );
807 $remotedir =~ s
|/+$||;
809 $log -> debug ( "announcedir $dir , $repodir , $remotedir " );
811 if ( $parent eq '.' || $parent eq './' ) {
814 # recurse to announce unseen parents first
815 if ( length ( $parent ) && ! exists ( $seendirs ->{ $parent })) {
816 prepdir
( $parent , $repodir , $remotedir , $seendirs );
818 # Announce that we are going to modify at the parent level
820 print "E cvs checkout: Updating $remotedir / $parent \n " ;
822 print "E cvs checkout: Updating $remotedir \n " ;
824 print "Clear-sticky $remotedir / $parent / \n " ;
825 print " $repodir / $parent / \n " ;
827 print "Clear-static-directory $remotedir / $dir / \n " ;
828 print " $repodir / $dir / \n " ;
829 print "Clear-sticky $remotedir / $parent / \n " ; # yes, twice
830 print " $repodir / $parent / \n " ;
831 print "Template $remotedir / $dir / \n " ;
832 print " $repodir / $dir / \n " ;
835 $seendirs ->{ $dir } = 1 ;
838 foreach my $git ( @
{ $updater -> gethead } )
840 # Don't want to check out deleted files
841 next if ( $git ->{ filehash
} eq "deleted" );
843 ( $git ->{ name
}, $git ->{ dir
} ) = filenamesplit
( $git ->{ name
});
845 if ( length ( $git ->{ dir
}) && $git ->{ dir
} ne './'
846 && $git ->{ dir
} ne $lastdir ) {
847 unless ( exists ( $seendirs { $git ->{ dir
}})) {
848 prepdir
( $git ->{ dir
}, $state ->{ CVSROOT
} . "/ $module /" ,
849 $checkout_path , \
%seendirs );
850 $lastdir = $git ->{ dir
};
851 $seendirs { $git ->{ dir
}} = 1 ;
853 print "E cvs checkout: Updating / $checkout_path / $git ->{dir} \n " ;
856 # modification time of this file
857 print "Mod-time $git ->{modified} \n " ;
859 # print some information to the client
860 if ( defined ( $git ->{ dir
} ) and $git ->{ dir
} ne "./" )
862 print "M U $checkout_path / $git ->{dir} $git ->{name} \n " ;
864 print "M U $checkout_path / $git ->{name} \n " ;
867 # instruct client we're sending a file to put in this path
868 print "Created $checkout_path /" . ( defined ( $git ->{ dir
} ) and $git ->{ dir
} ne "./" ?
$git ->{ dir
} . "/" : "" ) . " \n " ;
870 print $state ->{ CVSROOT
} . "/ $module /" . ( defined ( $git ->{ dir
} ) and $git ->{ dir
} ne "./" ?
$git ->{ dir
} . "/" : "" ) . " $git ->{name} \n " ;
872 # this is an "entries" line
873 my $kopts = kopts_from_path
( $git ->{ name
});
874 print "/ $git ->{name}/1. $git ->{revision}// $kopts / \n " ;
876 print "u= $git ->{mode},g= $git ->{mode},o= $git ->{mode} \n " ;
879 transmitfile
( $git ->{ filehash
});
888 # Response expected: yes. Actually do a cvs update command. This uses any
889 # previous Argument, Directory, Entry, or Modified requests, if they have
890 # been sent. The last Directory sent specifies the working directory at the
891 # time of the operation. The -I option is not used--files which the client
892 # can decide whether to ignore are not mentioned and the client sends the
893 # Questionable request for others.
896 my ( $cmd , $data ) = @_ ;
898 $log -> debug ( "req_update : " . ( defined ( $data ) ?
$data : "[NULL]" ));
903 # It may just be a client exploring the available heads/modules
904 # in that case, list them as top level directories and leave it
905 # at that. Eclipse uses this technique to offer you a list of
906 # projects (heads in this case) to checkout.
908 if ( $state ->{ module
} eq '' ) {
909 my $heads_dir = $state ->{ CVSROOT
} . '/refs/heads' ;
910 if (! opendir HEADS
, $heads_dir ) {
911 print "E [server aborted]: Failed to open directory, "
912 . " $heads_dir : $! \n error \n " ;
915 print "E cvs update: Updating . \n " ;
916 while ( my $head = readdir ( HEADS
)) {
917 if (- f
$state ->{ CVSROOT
} . '/refs/heads/' . $head ) {
918 print "E cvs update: New directory ` $head ' \n " ;
927 # Grab a handle to the SQLite db and do any necessary updates
928 my $updater = GITCVS
:: updater
-> new ( $state ->{ CVSROOT
}, $state ->{ module
}, $log );
932 argsfromdir
( $updater );
934 #$log->debug("update state : " . Dumper($state));
936 # foreach file specified on the command line ...
937 foreach my $filename ( @
{ $state ->{ args
}} )
939 $filename = filecleanup
( $filename );
941 $log -> debug ( "Processing file $filename " );
943 # if we have a -C we should pretend we never saw modified stuff
944 if ( exists ( $state ->{ opt
}{ C
} ) )
946 delete $state ->{ entries
}{ $filename }{ modified_hash
};
947 delete $state ->{ entries
}{ $filename }{ modified_filename
};
948 $state ->{ entries
}{ $filename }{ unchanged
} = 1 ;
952 if ( defined ( $state ->{ opt
}{ r
}) and $state ->{ opt
}{ r
} =~ /^1\.(\d+)/ )
954 $meta = $updater -> getmeta ( $filename , $1 );
956 $meta = $updater -> getmeta ( $filename );
959 if ( ! defined $meta )
970 my $wrev = revparse
( $filename );
972 # If the working copy is an old revision, lets get that version too for comparison.
973 if ( defined ( $wrev ) and $wrev != $meta ->{ revision
} )
975 $oldmeta = $updater -> getmeta ( $filename , $wrev );
978 #$log->debug("Target revision is $meta->{revision}, current working revision is $wrev");
980 # Files are up to date if the working copy and repo copy have the same revision,
981 # and the working copy is unmodified _and_ the user hasn't specified -C
982 next if ( defined ( $wrev )
983 and defined ( $meta ->{ revision
})
984 and $wrev == $meta ->{ revision
}
985 and $state ->{ entries
}{ $filename }{ unchanged
}
986 and not exists ( $state ->{ opt
}{ C
} ) );
988 # If the working copy and repo copy have the same revision,
989 # but the working copy is modified, tell the client it's modified
990 if ( defined ( $wrev )
991 and defined ( $meta ->{ revision
})
992 and $wrev == $meta ->{ revision
}
993 and defined ( $state ->{ entries
}{ $filename }{ modified_hash
})
994 and not exists ( $state ->{ opt
}{ C
} ) )
996 $log -> info ( "Tell the client the file is modified" );
997 print "MT text M \n " ;
998 print "MT fname $filename \n " ;
999 print "MT newline \n " ;
1003 if ( $meta ->{ filehash
} eq "deleted" )
1005 my ( $filepart , $dirpart ) = filenamesplit
( $filename , 1 );
1007 $log -> info ( "Removing ' $filename ' from working copy (no longer in the repo)" );
1009 print "E cvs update: ` $filename ' is no longer in the repository \n " ;
1010 # Don't want to actually _DO_ the update if -n specified
1011 unless ( $state ->{ globaloptions
}{- n
} ) {
1012 print "Removed $dirpart \n " ;
1013 print " $filepart \n " ;
1016 elsif ( not defined ( $state ->{ entries
}{ $filename }{ modified_hash
} )
1017 or $state ->{ entries
}{ $filename }{ modified_hash
} eq $oldmeta ->{ filehash
}
1018 or $meta ->{ filehash
} eq 'added' )
1020 # normal update, just send the new revision (either U=Update,
1021 # or A=Add, or R=Remove)
1022 if ( defined ( $wrev ) && $wrev < 0 )
1024 $log -> info ( "Tell the client the file is scheduled for removal" );
1025 print "MT text R \n " ;
1026 print "MT fname $filename \n " ;
1027 print "MT newline \n " ;
1030 elsif ( (! defined ( $wrev ) || $wrev == 0 ) && (! defined ( $meta ->{ revision
}) || $meta ->{ revision
} == 0 ) )
1032 $log -> info ( "Tell the client the file is scheduled for addition" );
1033 print "MT text A \n " ;
1034 print "MT fname $filename \n " ;
1035 print "MT newline \n " ;
1040 $log -> info ( "Updating ' $filename ' to " . $meta ->{ revision
});
1041 print "MT +updated \n " ;
1042 print "MT text U \n " ;
1043 print "MT fname $filename \n " ;
1044 print "MT newline \n " ;
1045 print "MT -updated \n " ;
1048 my ( $filepart , $dirpart ) = filenamesplit
( $filename , 1 );
1050 # Don't want to actually _DO_ the update if -n specified
1051 unless ( $state ->{ globaloptions
}{- n
} )
1053 if ( defined ( $wrev ) )
1055 # instruct client we're sending a file to put in this path as a replacement
1056 print "Update-existing $dirpart \n " ;
1057 $log -> debug ( "Updating existing file 'Update-existing $dirpart '" );
1059 # instruct client we're sending a file to put in this path as a new file
1060 print "Clear-static-directory $dirpart \n " ;
1061 print $state ->{ CVSROOT
} . "/ $state ->{module}/ $dirpart \n " ;
1062 print "Clear-sticky $dirpart \n " ;
1063 print $state ->{ CVSROOT
} . "/ $state ->{module}/ $dirpart \n " ;
1065 $log -> debug ( "Creating new file 'Created $dirpart '" );
1066 print "Created $dirpart \n " ;
1068 print $state ->{ CVSROOT
} . "/ $state ->{module}/ $filename \n " ;
1070 # this is an "entries" line
1071 my $kopts = kopts_from_path
( $filepart );
1072 $log -> debug ( "/ $filepart /1. $meta ->{revision}// $kopts /" );
1073 print "/ $filepart /1. $meta ->{revision}// $kopts / \n " ;
1076 $log -> debug ( "SEND : u= $meta ->{mode},g= $meta ->{mode},o= $meta ->{mode}" );
1077 print "u= $meta ->{mode},g= $meta ->{mode},o= $meta ->{mode} \n " ;
1080 transmitfile
( $meta ->{ filehash
});
1083 $log -> info ( "Updating ' $filename '" );
1084 my ( $filepart , $dirpart ) = filenamesplit
( $meta ->{ name
}, 1 );
1086 my $dir = tempdir
( DIR
=> $TEMP_DIR , CLEANUP
=> 1 ) . "/" ;
1089 my $file_local = $filepart . ".mine" ;
1090 system ( "ln" , "-s" , $state ->{ entries
}{ $filename }{ modified_filename
}, $file_local );
1091 my $file_old = $filepart . "." . $oldmeta ->{ revision
};
1092 transmitfile
( $oldmeta ->{ filehash
}, $file_old );
1093 my $file_new = $filepart . "." . $meta ->{ revision
};
1094 transmitfile
( $meta ->{ filehash
}, $file_new );
1096 # we need to merge with the local changes ( M=successful merge, C=conflict merge )
1097 $log -> info ( "Merging $file_local , $file_old , $file_new " );
1098 print "M Merging differences between 1. $oldmeta ->{revision} and 1. $meta ->{revision} into $filename \n " ;
1100 $log -> debug ( "Temporary directory for merge is $dir " );
1102 my $return = system ( "git" , "merge-file" , $file_local , $file_old , $file_new );
1107 $log -> info ( "Merged successfully" );
1108 print "M M $filename \n " ;
1109 $log -> debug ( "Merged $dirpart " );
1111 # Don't want to actually _DO_ the update if -n specified
1112 unless ( $state ->{ globaloptions
}{- n
} )
1114 print "Merged $dirpart \n " ;
1115 $log -> debug ( $state ->{ CVSROOT
} . "/ $state ->{module}/ $filename " );
1116 print $state ->{ CVSROOT
} . "/ $state ->{module}/ $filename \n " ;
1117 my $kopts = kopts_from_path
( $filepart );
1118 $log -> debug ( "/ $filepart /1. $meta ->{revision}// $kopts /" );
1119 print "/ $filepart /1. $meta ->{revision}// $kopts / \n " ;
1122 elsif ( $return == 1 )
1124 $log -> info ( "Merged with conflicts" );
1125 print "E cvs update: conflicts found in $filename \n " ;
1126 print "M C $filename \n " ;
1128 # Don't want to actually _DO_ the update if -n specified
1129 unless ( $state ->{ globaloptions
}{- n
} )
1131 print "Merged $dirpart \n " ;
1132 print $state ->{ CVSROOT
} . "/ $state ->{module}/ $filename \n " ;
1133 my $kopts = kopts_from_path
( $filepart );
1134 print "/ $filepart /1. $meta ->{revision}/+/ $kopts / \n " ;
1139 $log -> warn ( "Merge failed" );
1143 # Don't want to actually _DO_ the update if -n specified
1144 unless ( $state ->{ globaloptions
}{- n
} )
1147 $log -> debug ( "SEND : u= $meta ->{mode},g= $meta ->{mode},o= $meta ->{mode}" );
1148 print "u= $meta ->{mode},g= $meta ->{mode},o= $meta ->{mode} \n " ;
1150 # transmit file, format is single integer on a line by itself (file
1151 # size) followed by the file contents
1152 # TODO : we should copy files in blocks
1153 my $data = `cat $file_local ` ;
1154 $log -> debug ( "File size : " . length ( $data ));
1155 print length ( $data ) . " \n " ;
1169 my ( $cmd , $data ) = @_ ;
1173 #$log->debug("State : " . Dumper($state));
1175 $log -> info ( "req_ci : " . ( defined ( $data ) ?
$data : "[NULL]" ));
1177 if ( $state ->{ method
} eq 'pserver' )
1179 print "error 1 pserver access cannot commit \n " ;
1183 if ( - e
$state ->{ CVSROOT
} . "/index" )
1185 $log -> warn ( "file 'index' already exists in the git repository" );
1186 print "error 1 Index already exists in git repo \n " ;
1190 # Grab a handle to the SQLite db and do any necessary updates
1191 my $updater = GITCVS
:: updater
-> new ( $state ->{ CVSROOT
}, $state ->{ module
}, $log );
1194 my $tmpdir = tempdir
( DIR
=> $TEMP_DIR );
1195 my ( undef , $file_index ) = tempfile
( DIR
=> $TEMP_DIR , OPEN
=> 0 );
1196 $log -> info ( "Lockless commit start, basing commit on ' $tmpdir ', index file is ' $file_index '" );
1198 $ENV { GIT_DIR
} = $state ->{ CVSROOT
} . "/" ;
1199 $ENV { GIT_WORK_TREE
} = "." ;
1200 $ENV { GIT_INDEX_FILE
} = $file_index ;
1202 # Remember where the head was at the beginning.
1203 my $parenthash = `git show-ref -s refs/heads/ $state ->{module}` ;
1205 if ( $parenthash !~ /^[0-9a-f]{40}$/ ) {
1206 print "error 1 pserver cannot find the current HEAD of module" ;
1212 # populate the temporary index based
1213 system ( "git-read-tree" , $parenthash );
1216 die "Error running git-read-tree $state ->{module} $file_index $!" ;
1218 $log -> info ( "Created index ' $file_index ' with for head $state ->{module} - exit status $?" );
1220 my @committedfiles = ();
1223 # foreach file specified on the command line ...
1224 foreach my $filename ( @
{ $state ->{ args
}} )
1226 my $committedfile = $filename ;
1227 $filename = filecleanup
( $filename );
1229 next unless ( exists $state ->{ entries
}{ $filename }{ modified_filename
} or not $state ->{ entries
}{ $filename }{ unchanged
} );
1231 my $meta = $updater -> getmeta ( $filename );
1232 $oldmeta { $filename } = $meta ;
1234 my $wrev = revparse
( $filename );
1236 my ( $filepart , $dirpart ) = filenamesplit
( $filename );
1238 # do a checkout of the file if it part of this tree
1240 system ( 'git-checkout-index' , '-f' , '-u' , $filename );
1242 die "Error running git-checkout-index -f -u $filename : $!" ;
1248 $rmflag = 1 if ( defined ( $wrev ) and $wrev < 0 );
1249 $addflag = 1 unless ( - e
$filename );
1251 # Do up to date checking
1252 unless ( $addflag or $wrev == $meta ->{ revision
} or ( $rmflag and - $wrev == $meta ->{ revision
} ) )
1254 # fail everything if an up to date check fails
1255 print "error 1 Up to date check failed for $filename \n " ;
1260 push @committedfiles , $committedfile ;
1261 $log -> info ( "Committing $filename " );
1263 system ( "mkdir" , "-p" , $dirpart ) unless ( - d
$dirpart );
1267 $log -> debug ( "rename $state ->{entries}{ $filename }{modified_filename} $filename " );
1268 rename $state ->{ entries
}{ $filename }{ modified_filename
}, $filename ;
1270 # Calculate modes to remove
1272 foreach ( qw
( r w x
) ) { $invmode .= $_ unless ( $state ->{ entries
}{ $filename }{ modified_mode
} =~ /$_/ ); }
1274 $log -> debug ( "chmod u+" . $state ->{ entries
}{ $filename }{ modified_mode
} . "-" . $invmode . " $filename " );
1275 system ( "chmod" , "u+" . $state ->{ entries
}{ $filename }{ modified_mode
} . "-" . $invmode , $filename );
1280 $log -> info ( "Removing file ' $filename '" );
1282 system ( "git-update-index" , "--remove" , $filename );
1286 $log -> info ( "Adding file ' $filename '" );
1287 system ( "git-update-index" , "--add" , $filename );
1289 $log -> info ( "Updating file ' $filename '" );
1290 system ( "git-update-index" , $filename );
1294 unless ( scalar ( @committedfiles ) > 0 )
1296 print "E No files to commit \n " ;
1302 my $treehash = `git-write-tree` ;
1305 $log -> debug ( "Treehash : $treehash , Parenthash : $parenthash " );
1307 # write our commit message out if we have one ...
1308 my ( $msg_fh , $msg_filename ) = tempfile
( DIR
=> $TEMP_DIR );
1309 print $msg_fh $state ->{ opt
}{ m
}; # if ( exists ( $state->{opt}{m} ) );
1310 print $msg_fh " \n\n via git-CVS emulator \n " ;
1313 my $commithash = `git-commit-tree $treehash -p $parenthash < $msg_filename ` ;
1315 $log -> info ( "Commit hash : $commithash " );
1317 unless ( $commithash =~ /[a-zA-Z0-9]{40}/ )
1319 $log -> warn ( "Commit failed (Invalid commit hash)" );
1320 print "error 1 Commit failed (unknown reason) \n " ;
1325 # Check that this is allowed, just as we would with a receive-pack
1326 my @cmd = ( $ENV { GIT_DIR
}. 'hooks/update' , "refs/heads/ $state ->{module}" ,
1327 $parenthash , $commithash );
1329 unless ( system ( @cmd ) == 0 )
1331 $log -> warn ( "Commit failed (update hook declined to update ref)" );
1332 print "error 1 Commit failed (update hook declined) \n " ;
1338 if ( system ( qw(git update-ref -m) , "cvsserver ci" ,
1339 "refs/heads/ $state ->{module}" , $commithash , $parenthash )) {
1340 $log -> warn ( "update-ref for $state ->{module} failed." );
1341 print "error 1 Cannot commit -- update first \n " ;
1347 # foreach file specified on the command line ...
1348 foreach my $filename ( @committedfiles )
1350 $filename = filecleanup
( $filename );
1352 my $meta = $updater -> getmeta ( $filename );
1353 unless ( defined $meta ->{ revision
}) {
1354 $meta ->{ revision
} = 1 ;
1357 my ( $filepart , $dirpart ) = filenamesplit
( $filename , 1 );
1359 $log -> debug ( "Checked-in $dirpart : $filename " );
1361 print "M $state ->{CVSROOT}/ $state ->{module}/ $filename ,v <-- $dirpart $filepart \n " ;
1362 if ( defined $meta ->{ filehash
} && $meta ->{ filehash
} eq "deleted" )
1364 print "M new revision: delete; previous revision: 1. $oldmeta { $filename }{revision} \n " ;
1365 print "Remove-entry $dirpart \n " ;
1366 print " $filename \n " ;
1368 if ( $meta ->{ revision
} == 1 ) {
1369 print "M initial revision: 1.1 \n " ;
1371 print "M new revision: 1. $meta ->{revision}; previous revision: 1. $oldmeta { $filename }{revision} \n " ;
1373 print "Checked-in $dirpart \n " ;
1374 print " $filename \n " ;
1375 my $kopts = kopts_from_path
( $filepart );
1376 print "/ $filepart /1. $meta ->{revision}// $kopts / \n " ;
1386 my ( $cmd , $data ) = @_ ;
1390 $log -> info ( "req_status : " . ( defined ( $data ) ?
$data : "[NULL]" ));
1391 #$log->debug("status state : " . Dumper($state));
1393 # Grab a handle to the SQLite db and do any necessary updates
1394 my $updater = GITCVS
:: updater
-> new ( $state ->{ CVSROOT
}, $state ->{ module
}, $log );
1397 # if no files were specified, we need to work out what files we should be providing status on ...
1398 argsfromdir
( $updater );
1400 # foreach file specified on the command line ...
1401 foreach my $filename ( @
{ $state ->{ args
}} )
1403 $filename = filecleanup
( $filename );
1405 my $meta = $updater -> getmeta ( $filename );
1406 my $oldmeta = $meta ;
1408 my $wrev = revparse
( $filename );
1410 # If the working copy is an old revision, lets get that version too for comparison.
1411 if ( defined ( $wrev ) and $wrev != $meta ->{ revision
} )
1413 $oldmeta = $updater -> getmeta ( $filename , $wrev );
1416 # TODO : All possible statuses aren't yet implemented
1418 # Files are up to date if the working copy and repo copy have the same revision, and the working copy is unmodified
1419 $status = "Up-to-date" if ( defined ( $wrev ) and defined ( $meta ->{ revision
}) and $wrev == $meta ->{ revision
}
1421 ( ( $state ->{ entries
}{ $filename }{ unchanged
} and ( not defined ( $state ->{ entries
}{ $filename }{ conflict
} ) or $state ->{ entries
}{ $filename }{ conflict
} !~ /^\+=/ ) )
1422 or ( defined ( $state ->{ entries
}{ $filename }{ modified_hash
}) and $state ->{ entries
}{ $filename }{ modified_hash
} eq $meta ->{ filehash
} ) )
1425 # Need checkout if the working copy has an older revision than the repo copy, and the working copy is unmodified
1426 $status ||= "Needs Checkout" if ( defined ( $wrev ) and defined ( $meta ->{ revision
} ) and $meta ->{ revision
} > $wrev
1428 ( $state ->{ entries
}{ $filename }{ unchanged
}
1429 or ( defined ( $state ->{ entries
}{ $filename }{ modified_hash
}) and $state ->{ entries
}{ $filename }{ modified_hash
} eq $oldmeta ->{ filehash
} ) )
1432 # Need checkout if it exists in the repo but doesn't have a working copy
1433 $status ||= "Needs Checkout" if ( not defined ( $wrev ) and defined ( $meta ->{ revision
} ) );
1435 # Locally modified if working copy and repo copy have the same revision but there are local changes
1436 $status ||= "Locally Modified" if ( defined ( $wrev ) and defined ( $meta ->{ revision
}) and $wrev == $meta ->{ revision
} and $state ->{ entries
}{ $filename }{ modified_filename
} );
1438 # Needs Merge if working copy revision is less than repo copy and there are local changes
1439 $status ||= "Needs Merge" if ( defined ( $wrev ) and defined ( $meta ->{ revision
} ) and $meta ->{ revision
} > $wrev and $state ->{ entries
}{ $filename }{ modified_filename
} );
1441 $status ||= "Locally Added" if ( defined ( $state ->{ entries
}{ $filename }{ revision
} ) and not defined ( $meta ->{ revision
} ) );
1442 $status ||= "Locally Removed" if ( defined ( $wrev ) and defined ( $meta ->{ revision
} ) and - $wrev == $meta ->{ revision
} );
1443 $status ||= "Unresolved Conflict" if ( defined ( $state ->{ entries
}{ $filename }{ conflict
} ) and $state ->{ entries
}{ $filename }{ conflict
} =~ /^\+=/ );
1444 $status ||= "File had conflicts on merge" if ( 0 );
1446 $status ||= "Unknown" ;
1448 print "M =================================================================== \n " ;
1449 print "M File: $filename \t Status: $status \n " ;
1450 if ( defined ( $state ->{ entries
}{ $filename }{ revision
}) )
1452 print "M Working revision: \t " . $state ->{ entries
}{ $filename }{ revision
} . " \n " ;
1454 print "M Working revision: \t No entry for $filename \n " ;
1456 if ( defined ( $meta ->{ revision
}) )
1458 print "M Repository revision: \t 1." . $meta ->{ revision
} . " \t $state ->{CVSROOT}/ $state ->{module}/ $filename ,v \n " ;
1459 print "M Sticky Tag: \t\t (none) \n " ;
1460 print "M Sticky Date: \t\t (none) \n " ;
1461 print "M Sticky Options: \t\t (none) \n " ;
1463 print "M Repository revision: \t No revision control file \n " ;
1473 my ( $cmd , $data ) = @_ ;
1477 $log -> debug ( "req_diff : " . ( defined ( $data ) ?
$data : "[NULL]" ));
1478 #$log->debug("status state : " . Dumper($state));
1480 my ( $revision1 , $revision2 );
1481 if ( defined ( $state ->{ opt
}{ r
} ) and ref $state ->{ opt
}{ r
} eq "ARRAY" )
1483 $revision1 = $state ->{ opt
}{ r
}[ 0 ];
1484 $revision2 = $state ->{ opt
}{ r
}[ 1 ];
1486 $revision1 = $state ->{ opt
}{ r
};
1489 $revision1 =~ s/^1\.// if ( defined ( $revision1 ) );
1490 $revision2 =~ s/^1\.// if ( defined ( $revision2 ) );
1492 $log -> debug ( "Diffing revisions " . ( defined ( $revision1 ) ?
$revision1 : "[NULL]" ) . " and " . ( defined ( $revision2 ) ?
$revision2 : "[NULL]" ) );
1494 # Grab a handle to the SQLite db and do any necessary updates
1495 my $updater = GITCVS
:: updater
-> new ( $state ->{ CVSROOT
}, $state ->{ module
}, $log );
1498 # if no files were specified, we need to work out what files we should be providing status on ...
1499 argsfromdir
( $updater );
1501 # foreach file specified on the command line ...
1502 foreach my $filename ( @
{ $state ->{ args
}} )
1504 $filename = filecleanup
( $filename );
1506 my ( $fh , $file1 , $file2 , $meta1 , $meta2 , $filediff );
1508 my $wrev = revparse
( $filename );
1510 # We need _something_ to diff against
1511 next unless ( defined ( $wrev ) );
1513 # if we have a -r switch, use it
1514 if ( defined ( $revision1 ) )
1516 ( undef , $file1 ) = tempfile
( DIR
=> $TEMP_DIR , OPEN
=> 0 );
1517 $meta1 = $updater -> getmeta ( $filename , $revision1 );
1518 unless ( defined ( $meta1 ) and $meta1 ->{ filehash
} ne "deleted" )
1520 print "E File $filename at revision 1. $revision1 doesn't exist \n " ;
1523 transmitfile
( $meta1 ->{ filehash
}, $file1 );
1525 # otherwise we just use the working copy revision
1528 ( undef , $file1 ) = tempfile
( DIR
=> $TEMP_DIR , OPEN
=> 0 );
1529 $meta1 = $updater -> getmeta ( $filename , $wrev );
1530 transmitfile
( $meta1 ->{ filehash
}, $file1 );
1533 # if we have a second -r switch, use it too
1534 if ( defined ( $revision2 ) )
1536 ( undef , $file2 ) = tempfile
( DIR
=> $TEMP_DIR , OPEN
=> 0 );
1537 $meta2 = $updater -> getmeta ( $filename , $revision2 );
1539 unless ( defined ( $meta2 ) and $meta2 ->{ filehash
} ne "deleted" )
1541 print "E File $filename at revision 1. $revision2 doesn't exist \n " ;
1545 transmitfile
( $meta2 ->{ filehash
}, $file2 );
1547 # otherwise we just use the working copy
1550 $file2 = $state ->{ entries
}{ $filename }{ modified_filename
};
1553 # if we have been given -r, and we don't have a $file2 yet, lets get one
1554 if ( defined ( $revision1 ) and not defined ( $file2 ) )
1556 ( undef , $file2 ) = tempfile
( DIR
=> $TEMP_DIR , OPEN
=> 0 );
1557 $meta2 = $updater -> getmeta ( $filename , $wrev );
1558 transmitfile
( $meta2 ->{ filehash
}, $file2 );
1561 # We need to have retrieved something useful
1562 next unless ( defined ( $meta1 ) );
1564 # Files to date if the working copy and repo copy have the same revision, and the working copy is unmodified
1565 next if ( not defined ( $meta2 ) and $wrev == $meta1 ->{ revision
}
1567 ( ( $state ->{ entries
}{ $filename }{ unchanged
} and ( not defined ( $state ->{ entries
}{ $filename }{ conflict
} ) or $state ->{ entries
}{ $filename }{ conflict
} !~ /^\+=/ ) )
1568 or ( defined ( $state ->{ entries
}{ $filename }{ modified_hash
}) and $state ->{ entries
}{ $filename }{ modified_hash
} eq $meta1 ->{ filehash
} ) )
1571 # Apparently we only show diffs for locally modified files
1572 next unless ( defined ( $meta2 ) or defined ( $state ->{ entries
}{ $filename }{ modified_filename
} ) );
1574 print "M Index: $filename \n " ;
1575 print "M =================================================================== \n " ;
1576 print "M RCS file: $state ->{CVSROOT}/ $state ->{module}/ $filename ,v \n " ;
1577 print "M retrieving revision 1. $meta1 ->{revision} \n " if ( defined ( $meta1 ) );
1578 print "M retrieving revision 1. $meta2 ->{revision} \n " if ( defined ( $meta2 ) );
1580 foreach my $opt ( keys %{ $state ->{ opt
}} )
1582 if ( ref $state ->{ opt
}{ $opt } eq "ARRAY" )
1584 foreach my $value ( @
{ $state ->{ opt
}{ $opt }} )
1586 print "- $opt $value " ;
1590 print " $state ->{opt}{ $opt } " if ( defined ( $state ->{ opt
}{ $opt } ) );
1593 print " $filename \n " ;
1595 $log -> info ( "Diffing $filename -r $meta1 ->{revision} -r " . ( $meta2 ->{ revision
} or "workingcopy" ));
1597 ( $fh , $filediff ) = tempfile
( DIR
=> $TEMP_DIR );
1599 if ( exists $state ->{ opt
}{ u
} )
1601 system ( "diff -u -L ' $filename revision 1. $meta1 ->{revision}' -L ' $filename " . ( defined ( $meta2 ->{ revision
}) ?
"revision 1. $meta2 ->{revision}" : "working copy" ) . "' $file1 $file2 > $filediff " );
1603 system ( "diff $file1 $file2 > $filediff " );
1618 my ( $cmd , $data ) = @_ ;
1622 $log -> debug ( "req_log : " . ( defined ( $data ) ?
$data : "[NULL]" ));
1623 #$log->debug("log state : " . Dumper($state));
1625 my ( $minrev , $maxrev );
1626 if ( defined ( $state ->{ opt
}{ r
} ) and $state ->{ opt
}{ r
} =~ /([\d.]+)?(::?)([\d.]+)?/ )
1631 $minrev =~ s/^1\.// if ( defined ( $minrev ) );
1632 $maxrev =~ s/^1\.// if ( defined ( $maxrev ) );
1633 $minrev ++ if ( defined ( $minrev ) and $control eq "::" );
1636 # Grab a handle to the SQLite db and do any necessary updates
1637 my $updater = GITCVS
:: updater
-> new ( $state ->{ CVSROOT
}, $state ->{ module
}, $log );
1640 # if no files were specified, we need to work out what files we should be providing status on ...
1641 argsfromdir
( $updater );
1643 # foreach file specified on the command line ...
1644 foreach my $filename ( @
{ $state ->{ args
}} )
1646 $filename = filecleanup
( $filename );
1648 my $headmeta = $updater -> getmeta ( $filename );
1650 my $revisions = $updater -> getlog ( $filename );
1651 my $totalrevisions = scalar ( @
$revisions );
1653 if ( defined ( $minrev ) )
1655 $log -> debug ( "Removing revisions less than $minrev " );
1656 while ( scalar ( @
$revisions ) > 0 and $revisions ->[- 1 ]{ revision
} < $minrev )
1661 if ( defined ( $maxrev ) )
1663 $log -> debug ( "Removing revisions greater than $maxrev " );
1664 while ( scalar ( @
$revisions ) > 0 and $revisions ->[ 0 ]{ revision
} > $maxrev )
1670 next unless ( scalar ( @
$revisions ) );
1673 print "M RCS file: $state ->{CVSROOT}/ $state ->{module}/ $filename ,v \n " ;
1674 print "M Working file: $filename \n " ;
1675 print "M head: 1. $headmeta ->{revision} \n " ;
1676 print "M branch: \n " ;
1677 print "M locks: strict \n " ;
1678 print "M access list: \n " ;
1679 print "M symbolic names: \n " ;
1680 print "M keyword substitution: kv \n " ;
1681 print "M total revisions: $totalrevisions ; \t selected revisions: " . scalar ( @
$revisions ) . " \n " ;
1682 print "M description: \n " ;
1684 foreach my $revision ( @
$revisions )
1686 print "M ---------------------------- \n " ;
1687 print "M revision 1. $revision ->{revision} \n " ;
1688 # reformat the date for log output
1689 $revision ->{ modified
} = sprintf ( ' %04d / %02d / %02d %s ' , $3 , $DATE_LIST ->{ $2 }, $1 , $4 ) if ( $revision ->{ modified
} =~ /(\d+)\s+(\w+)\s+(\d+)\s+(\S+)/ and defined ( $DATE_LIST ->{ $2 }) );
1690 $revision ->{ author
} =~ s/\s+.*// ;
1691 $revision ->{ author
} =~ s/^(.{8}).*/$1/ ;
1692 print "M date: $revision ->{modified}; author: $revision ->{author}; state: " . ( $revision ->{ filehash
} eq "deleted" ?
"dead" : "Exp" ) . "; lines: +2 -3 \n " ;
1693 my $commitmessage = $updater -> commitmessage ( $revision ->{ commithash
});
1694 $commitmessage =~ s/^/M /mg ;
1695 print $commitmessage . " \n " ;
1697 print "M ============================================================================= \n " ;
1705 my ( $cmd , $data ) = @_ ;
1707 argsplit
( "annotate" );
1709 $log -> info ( "req_annotate : " . ( defined ( $data ) ?
$data : "[NULL]" ));
1710 #$log->debug("status state : " . Dumper($state));
1712 # Grab a handle to the SQLite db and do any necessary updates
1713 my $updater = GITCVS
:: updater
-> new ( $state ->{ CVSROOT
}, $state ->{ module
}, $log );
1716 # if no files were specified, we need to work out what files we should be providing annotate on ...
1717 argsfromdir
( $updater );
1719 # we'll need a temporary checkout dir
1720 my $tmpdir = tempdir
( DIR
=> $TEMP_DIR );
1721 my ( undef , $file_index ) = tempfile
( DIR
=> $TEMP_DIR , OPEN
=> 0 );
1722 $log -> info ( "Temp checkoutdir creation successful, basing annotate session work on ' $tmpdir ', index file is ' $file_index '" );
1724 $ENV { GIT_DIR
} = $state ->{ CVSROOT
} . "/" ;
1725 $ENV { GIT_WORK_TREE
} = "." ;
1726 $ENV { GIT_INDEX_FILE
} = $file_index ;
1730 # foreach file specified on the command line ...
1731 foreach my $filename ( @
{ $state ->{ args
}} )
1733 $filename = filecleanup
( $filename );
1735 my $meta = $updater -> getmeta ( $filename );
1737 next unless ( $meta ->{ revision
} );
1739 # get all the commits that this file was in
1740 # in dense format -- aka skip dead revisions
1741 my $revisions = $updater -> gethistorydense ( $filename );
1742 my $lastseenin = $revisions ->[ 0 ][ 2 ];
1744 # populate the temporary index based on the latest commit were we saw
1745 # the file -- but do it cheaply without checking out any files
1746 # TODO: if we got a revision from the client, use that instead
1747 # to look up the commithash in sqlite (still good to default to
1748 # the current head as we do now)
1749 system ( "git-read-tree" , $lastseenin );
1752 print "E error running git-read-tree $lastseenin $file_index $! \n " ;
1755 $log -> info ( "Created index ' $file_index ' with commit $lastseenin - exit status $?" );
1757 # do a checkout of the file
1758 system ( 'git-checkout-index' , '-f' , '-u' , $filename );
1760 print "E error running git-checkout-index -f -u $filename : $! \n " ;
1764 $log -> info ( "Annotate $filename " );
1766 # Prepare a file with the commits from the linearized
1767 # history that annotate should know about. This prevents
1768 # git-jsannotate telling us about commits we are hiding
1771 my $a_hints = " $tmpdir /.annotate_hints" ;
1772 if (! open ( ANNOTATEHINTS
, '>' , $a_hints )) {
1773 print "E failed to open ' $a_hints ' for writing: $! \n " ;
1776 for ( my $i = 0 ; $i < @
$revisions ; $i ++)
1778 print ANNOTATEHINTS
$revisions ->[ $i ][ 2 ];
1779 if ( $i + 1 < @
$revisions ) { # have we got a parent?
1780 print ANNOTATEHINTS
' ' . $revisions ->[ $i + 1 ][ 2 ];
1782 print ANNOTATEHINTS
" \n " ;
1785 print ANNOTATEHINTS
" \n " ;
1787 or ( print "E failed to write $a_hints : $! \n " ), return ;
1789 my @cmd = ( qw(git-annotate -l -S) , $a_hints , $filename );
1790 if (! open ( ANNOTATE
, "-|" , @cmd )) {
1791 print "E error invoking " . join ( ' ' , @cmd ) . ": $! \n " ;
1795 print "E Annotations for $filename \n " ;
1796 print "E *************** \n " ;
1797 while ( < ANNOTATE
> )
1799 if ( m/^([a-zA-Z0-9]{40})\t\([^\)]*\)(.*)$/i )
1801 my $commithash = $1 ;
1803 unless ( defined ( $metadata ->{ $commithash } ) )
1805 $metadata ->{ $commithash } = $updater -> getmeta ( $filename , $commithash );
1806 $metadata ->{ $commithash }{ author
} =~ s/\s+.*// ;
1807 $metadata ->{ $commithash }{ author
} =~ s/^(.{8}).*/$1/ ;
1808 $metadata ->{ $commithash }{ modified
} = sprintf ( " %02d - %s - %02d " , $1 , $2 , $3 ) if ( $metadata ->{ $commithash }{ modified
} =~ /^(\d+)\s(\w+)\s\d\d(\d\d)/ );
1810 printf ( "M 1.%-5d (%-8s %10s ): %s \n " ,
1811 $metadata ->{ $commithash }{ revision
},
1812 $metadata ->{ $commithash }{ author
},
1813 $metadata ->{ $commithash }{ modified
},
1817 $log -> warn ( "Error in annotate output! LINE: $_ " );
1818 print "E Annotate error \n " ;
1825 # done; get out of the tempdir
1832 # This method takes the state->{arguments} array and produces two new arrays.
1833 # The first is $state->{args} which is everything before the '--' argument, and
1834 # the second is $state->{files} which is everything after it.
1837 $state ->{ args
} = [];
1838 $state ->{ files
} = [];
1841 return unless ( defined ( $state ->{ arguments
}) and ref $state ->{ arguments
} eq "ARRAY" );
1845 if ( defined ( $type ) )
1848 $opt = { A
=> 0 , N
=> 0 , P
=> 0 , R
=> 0 , c
=> 0 , f
=> 0 , l
=> 0 , n
=> 0 , p
=> 0 , s
=> 0 , r
=> 1 , D
=> 1 , d
=> 1 , k
=> 1 , j
=> 1 , } if ( $type eq "co" );
1849 $opt = { v
=> 0 , l
=> 0 , R
=> 0 } if ( $type eq "status" );
1850 $opt = { A
=> 0 , P
=> 0 , C
=> 0 , d
=> 0 , f
=> 0 , l
=> 0 , R
=> 0 , p
=> 0 , k
=> 1 , r
=> 1 , D
=> 1 , j
=> 1 , I
=> 1 , W
=> 1 } if ( $type eq "update" );
1851 $opt = { l
=> 0 , R
=> 0 , k
=> 1 , D
=> 1 , D
=> 1 , r
=> 2 } if ( $type eq "diff" );
1852 $opt = { c
=> 0 , R
=> 0 , l
=> 0 , f
=> 0 , F
=> 1 , m
=> 1 , r
=> 1 } if ( $type eq "ci" );
1853 $opt = { k
=> 1 , m
=> 1 } if ( $type eq "add" );
1854 $opt = { f
=> 0 , l
=> 0 , R
=> 0 } if ( $type eq "remove" );
1855 $opt = { l
=> 0 , b
=> 0 , h
=> 0 , R
=> 0 , t
=> 0 , N
=> 0 , S
=> 0 , r
=> 1 , d
=> 1 , s
=> 1 , w
=> 1 } if ( $type eq "log" );
1858 while ( scalar ( @
{ $state ->{ arguments
}} ) > 0 )
1860 my $arg = shift @
{ $state ->{ arguments
}};
1862 next if ( $arg eq "--" );
1863 next unless ( $arg =~ /\S/ );
1865 # if the argument looks like a switch
1866 if ( $arg =~ /^-(\w)(.*)/ )
1868 # if it's a switch that takes an argument
1871 # If this switch has already been provided
1872 if ( $opt ->{ $1 } > 1 and exists ( $state ->{ opt
}{ $1 } ) )
1874 $state ->{ opt
}{ $1 } = [ $state ->{ opt
}{ $1 } ];
1875 if ( length ( $2 ) > 0 )
1877 push @
{ $state ->{ opt
}{ $1 }}, $2 ;
1879 push @
{ $state ->{ opt
}{ $1 }}, shift @
{ $state ->{ arguments
}};
1882 # if there's extra data in the arg, use that as the argument for the switch
1883 if ( length ( $2 ) > 0 )
1885 $state ->{ opt
}{ $1 } = $2 ;
1887 $state ->{ opt
}{ $1 } = shift @
{ $state ->{ arguments
}};
1891 $state ->{ opt
}{ $1 } = undef ;
1896 push @
{ $state ->{ args
}}, $arg ;
1904 foreach my $value ( @
{ $state ->{ arguments
}} )
1906 if ( $value eq "--" )
1911 push @
{ $state ->{ args
}}, $value if ( $mode == 0 );
1912 push @
{ $state ->{ files
}}, $value if ( $mode == 1 );
1917 # This method uses $state->{directory} to populate $state->{args} with a list of filenames
1920 my $updater = shift ;
1922 $state ->{ args
} = [] if ( scalar ( @
{ $state ->{ args
}}) == 1 and $state ->{ args
}[ 0 ] eq "." );
1924 return if ( scalar ( @
{ $state ->{ args
}} ) > 1 );
1926 my @gethead = @
{ $updater -> gethead };
1929 foreach my $file ( keys %{ $state ->{ entries
}}) {
1930 if ( exists $state ->{ entries
}{ $file }{ revision
} &&
1931 $state ->{ entries
}{ $file }{ revision
} == 0 )
1933 push @gethead , { name
=> $file , filehash
=> 'added' };
1937 if ( scalar ( @
{ $state ->{ args
}}) == 1 )
1939 my $arg = $state ->{ args
}[ 0 ];
1940 $arg .= $state ->{ prependdir
} if ( defined ( $state ->{ prependdir
} ) );
1942 $log -> info ( "Only one arg specified, checking for directory expansion on ' $arg '" );
1944 foreach my $file ( @gethead )
1946 next if ( $file ->{ filehash
} eq "deleted" and not defined ( $state ->{ entries
}{ $file ->{ name
}} ) );
1947 next unless ( $file ->{ name
} =~ /^$arg\/ / or $file ->{ name
} eq $arg );
1948 push @
{ $state ->{ args
}}, $file ->{ name
};
1951 shift @
{ $state ->{ args
}} if ( scalar ( @
{ $state ->{ args
}}) > 1 );
1953 $log -> info ( "Only one arg specified, populating file list automatically" );
1955 $state ->{ args
} = [];
1957 foreach my $file ( @gethead )
1959 next if ( $file ->{ filehash
} eq "deleted" and not defined ( $state ->{ entries
}{ $file ->{ name
}} ) );
1960 next unless ( $file ->{ name
} =~ s/^$state->{prependdir}// );
1961 push @
{ $state ->{ args
}}, $file ->{ name
};
1966 # This method cleans up the $state variable after a command that uses arguments has run
1969 $state ->{ files
} = [];
1970 $state ->{ args
} = [];
1971 $state ->{ arguments
} = [];
1972 $state ->{ entries
} = {};
1977 my $filename = shift ;
1979 return undef unless ( defined ( $state ->{ entries
}{ $filename }{ revision
} ) );
1981 return $1 if ( $state ->{ entries
}{ $filename }{ revision
} =~ /^1\.(\d+)/ );
1982 return - $1 if ( $state ->{ entries
}{ $filename }{ revision
} =~ /^-1\.(\d+)/ );
1987 # This method takes a file hash and does a CVS "file transfer" which transmits the
1988 # size of the file, and then the file contents.
1989 # If a second argument $targetfile is given, the file is instead written out to
1990 # a file by the name of $targetfile
1993 my $filehash = shift ;
1994 my $targetfile = shift ;
1996 if ( defined ( $filehash ) and $filehash eq "deleted" )
1998 $log -> warn ( "filehash is 'deleted'" );
2002 die "Need filehash" unless ( defined ( $filehash ) and $filehash =~ /^[a-zA-Z0-9]{40}$/ );
2004 my $type = `git-cat-file -t $filehash ` ;
2007 die ( "Invalid type ' $type ' (expected 'blob')" ) unless ( defined ( $type ) and $type eq "blob" );
2009 my $size = `git-cat-file -s $filehash ` ;
2012 $log -> debug ( "transmitfile( $filehash ) size= $size , type= $type " );
2014 if ( open my $fh , '-|' , "git-cat-file" , "blob" , $filehash )
2016 if ( defined ( $targetfile ) )
2018 open NEWFILE
, ">" , $targetfile or die ( "Couldn't open ' $targetfile ' for writing : $!" );
2019 print NEWFILE
$_ while ( < $fh > );
2020 close NEWFILE
or die ( "Failed to write ' $targetfile ': $!" );
2023 print while ( < $fh > );
2025 close $fh or die ( "Couldn't close filehandle for transmitfile(): $!" );
2027 die ( "Couldn't execute git-cat-file" );
2031 # This method takes a file name, and returns ( $dirpart, $filepart ) which
2032 # refers to the directory portion and the file portion of the filename
2036 my $filename = shift ;
2037 my $fixforlocaldir = shift ;
2039 my ( $filepart , $dirpart ) = ( $filename , "." );
2040 ( $filepart , $dirpart ) = ( $2 , $1 ) if ( $filename =~ /(.*)\/ (.*)/ );
2043 if ( $fixforlocaldir )
2045 $dirpart =~ s/^$state->{prependdir}// ;
2048 return ( $filepart , $dirpart );
2053 my $filename = shift ;
2055 return undef unless ( defined ( $filename ));
2056 if ( $filename =~ /^\/ / )
2058 print "E absolute filenames ' $filename ' not supported by server \n " ;
2062 $filename =~ s/^\.\// / g
;
2063 $filename = $state ->{ prependdir
} . $filename ;
2067 # Given a path, this function returns a string containing the kopts
2068 # that should go into that path's Entries line. For example, a binary
2069 # file should get -kb.
2074 # Once it exists, the git attributes system should be used to look up
2075 # what attributes apply to this path.
2077 # Until then, take the setting from the config file
2078 unless ( defined ( $cfg ->{ gitcvs
}{ allbinary
} ) and $cfg ->{ gitcvs
}{ allbinary
} =~ /^\s*(1|true|yes)\s*$/i )
2080 # Return "" to give no special treatment to any path
2083 # Alternatively, to have all files treated as if they are binary (which
2084 # is more like git itself), always return the "-kb" option
2089 package GITCVS
:: log ;
2092 #### Copyright The Open University UK - 2006.
2094 #### Authors: Martyn Smith <martyn@catalyst.net.nz>
2095 #### Martin Langhoff <martin@catalyst.net.nz>
2108 This module provides very crude logging with a similar interface to
2117 Creates a new log object, optionally you can specify a filename here to
2118 indicate the file to log to. If no log file is specified, you can specify one
2119 later with method setfile, or indicate you no longer want logging with method
2122 Until one of these methods is called, all log calls will buffer messages ready
2129 my $filename = shift ;
2133 bless $self , $class ;
2135 if ( defined ( $filename ) )
2137 open $self ->{ fh
}, ">>" , $filename or die ( "Couldn't open ' $filename ' for writing : $!" );
2145 This methods takes a filename, and attempts to open that file as the log file.
2146 If successful, all buffered data is written out to the file, and any further
2147 logging is written directly to the file.
2153 my $filename = shift ;
2155 if ( defined ( $filename ) )
2157 open $self ->{ fh
}, ">>" , $filename or die ( "Couldn't open ' $filename ' for writing : $!" );
2160 return unless ( defined ( $self ->{ buffer
} ) and ref $self ->{ buffer
} eq "ARRAY" );
2162 while ( my $line = shift @
{ $self ->{ buffer
}} )
2164 print { $self ->{ fh
}} $line ;
2170 This method indicates no logging is going to be used. It flushes any entries in
2171 the internal buffer, and sets a flag to ensure no further data is put there.
2180 return unless ( defined ( $self ->{ buffer
} ) and ref $self ->{ buffer
} eq "ARRAY" );
2182 $self ->{ buffer
} = [];
2187 Internal method. Returns true if the log file is open, false otherwise.
2194 return 1 if ( defined ( $self ->{ fh
} ) and ref $self ->{ fh
} eq "GLOB" );
2198 =head2 debug info warn fatal
2200 These four methods are wrappers to _log. They provide the actual interface for
2204 sub debug
{ my $self = shift ; $self -> _log ( "debug" , @_ ); }
2205 sub info
{ my $self = shift ; $self -> _log ( "info" , @_ ); }
2206 sub warn { my $self = shift ; $self -> _log ( "warn" , @_ ); }
2207 sub fatal
{ my $self = shift ; $self -> _log ( "fatal" , @_ ); }
2211 This is an internal method called by the logging functions. It generates a
2212 timestamp and pushes the logged line either to file, or internal buffer.
2220 return if ( $self ->{ nolog
} );
2222 my @time = localtime ;
2223 my $timestring = sprintf ( " %4d - %02d - %02d %02d : %02d : %02d : %-5s" ,
2233 if ( $self -> _logopen )
2235 print { $self ->{ fh
}} $timestring . " - " . join ( " " , @_ ) . " \n " ;
2237 push @
{ $self ->{ buffer
}}, $timestring . " - " . join ( " " , @_ ) . " \n " ;
2243 This method simply closes the file handle if one is open
2250 if ( $self -> _logopen )
2256 package GITCVS
:: updater
;
2259 #### Copyright The Open University UK - 2006.
2261 #### Authors: Martyn Smith <martyn@catalyst.net.nz>
2262 #### Martin Langhoff <martin@catalyst.net.nz>
2284 die "Need to specify a git repository" unless ( defined ( $config ) and - d
$config );
2285 die "Need to specify a module" unless ( defined ( $module ) );
2287 $class = ref ( $class ) || $class ;
2291 bless $self , $class ;
2293 $self ->{ module
} = $module ;
2294 $self ->{ git_path
} = $config . "/" ;
2296 $self ->{ log } = $log ;
2298 die "Git repo ' $self ->{git_path}' doesn't exist" unless ( - d
$self ->{ git_path
} );
2300 $self ->{ dbdriver
} = $cfg ->{ gitcvs
}{ $state ->{ method
}}{ dbdriver
} ||
2301 $cfg ->{ gitcvs
}{ dbdriver
} || "SQLite" ;
2302 $self ->{ dbname
} = $cfg ->{ gitcvs
}{ $state ->{ method
}}{ dbname
} ||
2303 $cfg ->{ gitcvs
}{ dbname
} || " %Ggitcvs . %m .sqlite" ;
2304 $self ->{ dbuser
} = $cfg ->{ gitcvs
}{ $state ->{ method
}}{ dbuser
} ||
2305 $cfg ->{ gitcvs
}{ dbuser
} || "" ;
2306 $self ->{ dbpass
} = $cfg ->{ gitcvs
}{ $state ->{ method
}}{ dbpass
} ||
2307 $cfg ->{ gitcvs
}{ dbpass
} || "" ;
2308 my %mapping = ( m
=> $module ,
2309 a
=> $state ->{ method
},
2310 u
=> getlogin || getpwuid ($<) || $<,
2311 G
=> $self ->{ git_path
},
2312 g
=> mangle_dirname
( $self ->{ git_path
}),
2314 $self ->{ dbname
} =~ s/%([mauGg])/$mapping{$1}/eg ;
2315 $self ->{ dbuser
} =~ s/%([mauGg])/$mapping{$1}/eg ;
2317 die "Invalid char ':' in dbdriver" if $self ->{ dbdriver
} =~ /:/ ;
2318 die "Invalid char ';' in dbname" if $self ->{ dbname
} =~ /;/ ;
2319 $self ->{ dbh
} = DBI
-> connect ( "dbi: $self ->{dbdriver}:dbname= $self ->{dbname}" ,
2322 die "Error connecting to database \n " unless defined $self ->{ dbh
};
2324 $self ->{ tables
} = {};
2325 foreach my $table ( keys %{ $self ->{ dbh
}-> table_info ( undef , undef , undef , 'TABLE' )-> fetchall_hashref ( 'TABLE_NAME' )} )
2327 $self ->{ tables
}{ $table } = 1 ;
2330 # Construct the revision table if required
2331 unless ( $self ->{ tables
}{ revision
} )
2334 CREATE TABLE revision (
2336 revision INTEGER NOT NULL,
2337 filehash TEXT NOT NULL,
2338 commithash TEXT NOT NULL,
2339 author TEXT NOT NULL,
2340 modified TEXT NOT NULL,
2345 CREATE INDEX revision_ix1
2346 ON revision (name,revision)
2349 CREATE INDEX revision_ix2
2350 ON revision (name,commithash)
2354 # Construct the head table if required
2355 unless ( $self ->{ tables
}{ head
} )
2360 revision INTEGER NOT NULL,
2361 filehash TEXT NOT NULL,
2362 commithash TEXT NOT NULL,
2363 author TEXT NOT NULL,
2364 modified TEXT NOT NULL,
2369 CREATE INDEX head_ix1
2374 # Construct the properties table if required
2375 unless ( $self ->{ tables
}{ properties
} )
2378 CREATE TABLE properties (
2379 key TEXT NOT NULL PRIMARY KEY,
2385 # Construct the commitmsgs table if required
2386 unless ( $self ->{ tables
}{ commitmsgs
} )
2389 CREATE TABLE commitmsgs (
2390 key TEXT NOT NULL PRIMARY KEY,
2406 # first lets get the commit list
2407 $ENV { GIT_DIR
} = $self ->{ git_path
};
2409 my $commitsha1 = `git rev-parse $self ->{module}` ;
2412 my $commitinfo = `git cat-file commit $self ->{module} 2>&1` ;
2413 unless ( $commitinfo =~ /tree\s+[a-zA-Z0-9]{40}/ )
2415 die ( "Invalid module ' $self ->{module}'" );
2420 my $lastcommit = $self -> _get_prop ( "last_commit" );
2422 if ( defined $lastcommit && $lastcommit eq $commitsha1 ) { # up-to-date
2426 # Start exclusive lock here...
2427 $self ->{ dbh
}-> begin_work () or die "Cannot lock database for BEGIN" ;
2429 # TODO: log processing is memory bound
2430 # if we can parse into a 2nd file that is in reverse order
2431 # we can probably do something really efficient
2432 my @git_log_params = ( '--pretty' , '--parents' , '--topo-order' );
2434 if ( defined $lastcommit ) {
2435 push @git_log_params , " $lastcommit .. $self ->{module}" ;
2437 push @git_log_params , $self ->{ module
};
2439 # git-rev-list is the backend / plumbing version of git-log
2440 open ( GITLOG
, '-|' , 'git-rev-list' , @git_log_params ) or die "Cannot call git-rev-list: $!" ;
2449 if ( m/^commit\s+(.*)$/ ) {
2450 # on ^commit lines put the just seen commit in the stack
2451 # and prime things for the next one
2454 unshift @commits , \
%copy ;
2457 my @parents = split ( m/\s+/ , $1 );
2458 $commit { hash
} = shift @parents ;
2459 $commit { parents
} = \
@parents ;
2460 } elsif ( m/^(\w+?):\s+(.*)$/ && ! exists ( $commit { message
})) {
2461 # on rfc822-like lines seen before we see any message,
2462 # lowercase the entry and put it in the hash as key-value
2463 $commit { lc ( $1 )} = $2 ;
2465 # message lines - skip initial empty line
2466 # and trim whitespace
2467 if (! exists ( $commit { message
}) && m/^\s*$/ ) {
2468 # define it to mark the end of headers
2469 $commit { message
} = '' ;
2472 s/^\s+// ; s/\s+$// ; # trim ws
2473 $commit { message
} .= $_ . " \n " ;
2478 unshift @commits , \
%commit if ( keys %commit );
2480 # Now all the commits are in the @commits bucket
2481 # ordered by time DESC. for each commit that needs processing,
2482 # determine whether it's following the last head we've seen or if
2483 # it's on its own branch, grab a file list, and add whatever's changed
2484 # NOTE: $lastcommit refers to the last commit from previous run
2485 # $lastpicked is the last commit we picked in this run
2488 if ( defined $lastcommit ) {
2489 $lastpicked = $lastcommit ;
2492 my $committotal = scalar ( @commits );
2493 my $commitcount = 0 ;
2495 # Load the head table into $head (for cached lookups during the update process)
2496 foreach my $file ( @
{ $self -> gethead ()} )
2498 $head ->{ $file ->{ name
}} = $file ;
2501 foreach my $commit ( @commits )
2503 $self ->{ log }-> debug ( "GITCVS::updater - Processing commit $commit ->{hash} (" . (++ $commitcount ) . " of $committotal )" );
2504 if ( defined $lastpicked )
2506 if (! in_array
( $lastpicked , @
{ $commit ->{ parents
}}))
2508 # skip, we'll see this delta
2509 # as part of a merge later
2510 # warn "skipping off-track $commit->{hash}\n";
2512 } elsif ( @
{ $commit ->{ parents
}} > 1 ) {
2513 # it is a merge commit, for each parent that is
2514 # not $lastpicked, see if we can get a log
2515 # from the merge-base to that parent to put it
2516 # in the message as a merge summary.
2517 my @parents = @
{ $commit ->{ parents
}};
2518 foreach my $parent ( @parents ) {
2519 # git-merge-base can potentially (but rarely) throw
2520 # several candidate merge bases. let's assume
2521 # that the first one is the best one.
2522 if ( $parent eq $lastpicked ) {
2525 my $base = safe_pipe_capture
( 'git-merge-base' ,
2526 $lastpicked , $parent );
2530 # print "want to log between $base $parent \n";
2531 open ( GITLOG
, '-|' , 'git-log' , " $base .. $parent " )
2532 or die "Cannot call git-log: $!" ;
2536 if (! defined $mergedhash ) {
2537 if ( m/^commit\s+(.+)$/ ) {
2543 # grab the first line that looks non-rfc822
2544 # aka has content after leading space
2545 if ( m/^\s+(\S.*)$/ ) {
2547 $title = substr ( $title , 0 , 100 ); # truncate
2548 unshift @merged , " $mergedhash $title " ;
2555 $commit ->{ mergemsg
} = $commit ->{ message
};
2556 $commit ->{ mergemsg
} .= " \n Summary of merged commits: \n\n " ;
2557 foreach my $summary ( @merged ) {
2558 $commit ->{ mergemsg
} .= " \t $summary \n " ;
2560 $commit ->{ mergemsg
} .= " \n\n " ;
2561 # print "Message for $commit->{hash} \n$commit->{mergemsg}";
2568 # convert the date to CVS-happy format
2569 $commit ->{ date
} = " $2 $1 $4 $3 $5 " if ( $commit ->{ date
} =~ /^\w+\s+(\w+)\s+(\d+)\s+(\d+:\d+:\d+)\s+(\d+)\s+([+-]\d+)$/ );
2571 if ( defined ( $lastpicked ) )
2573 my $filepipe = open ( FILELIST
, '-|' , 'git-diff-tree' , '-z' , '-r' , $lastpicked , $commit ->{ hash
}) or die ( "Cannot call git-diff-tree : $!" );
2575 while ( < FILELIST
> )
2578 unless ( /^:\d{6}\s+\d{3}(\d)\d{2}\s+[a-zA-Z0-9]{40}\s+([a-zA-Z0-9]{40})\s+(\w)$/o )
2580 die ( "Couldn't process git-diff-tree line : $_ " );
2582 my ( $mode , $hash , $change ) = ( $1 , $2 , $3 );
2583 my $name = < FILELIST
>;
2586 # $log->debug("File mode=$mode, hash=$hash, change=$change, name=$name");
2589 $git_perms .= "r" if ( $mode & 4 );
2590 $git_perms .= "w" if ( $mode & 2 );
2591 $git_perms .= "x" if ( $mode & 1 );
2592 $git_perms = "rw" if ( $git_perms eq "" );
2594 if ( $change eq "D" )
2596 #$log->debug("DELETE $name");
2599 revision
=> $head ->{ $name }{ revision
} + 1 ,
2600 filehash
=> "deleted" ,
2601 commithash
=> $commit ->{ hash
},
2602 modified
=> $commit ->{ date
},
2603 author
=> $commit ->{ author
},
2606 $self -> insert_rev ( $name , $head ->{ $name }{ revision
}, $hash , $commit ->{ hash
}, $commit ->{ date
}, $commit ->{ author
}, $git_perms );
2608 elsif ( $change eq "M" )
2610 #$log->debug("MODIFIED $name");
2613 revision
=> $head ->{ $name }{ revision
} + 1 ,
2615 commithash
=> $commit ->{ hash
},
2616 modified
=> $commit ->{ date
},
2617 author
=> $commit ->{ author
},
2620 $self -> insert_rev ( $name , $head ->{ $name }{ revision
}, $hash , $commit ->{ hash
}, $commit ->{ date
}, $commit ->{ author
}, $git_perms );
2622 elsif ( $change eq "A" )
2624 #$log->debug("ADDED $name");
2627 revision
=> $head ->{ $name }{ revision
} ?
$head ->{ $name }{ revision
}+ 1 : 1 ,
2629 commithash
=> $commit ->{ hash
},
2630 modified
=> $commit ->{ date
},
2631 author
=> $commit ->{ author
},
2634 $self -> insert_rev ( $name , $head ->{ $name }{ revision
}, $hash , $commit ->{ hash
}, $commit ->{ date
}, $commit ->{ author
}, $git_perms );
2638 $log -> warn ( "UNKNOWN FILE CHANGE mode= $mode , hash= $hash , change= $change , name= $name " );
2644 # this is used to detect files removed from the repo
2645 my $seen_files = {};
2647 my $filepipe = open ( FILELIST
, '-|' , 'git-ls-tree' , '-z' , '-r' , $commit ->{ hash
}) or die ( "Cannot call git-ls-tree : $!" );
2649 while ( < FILELIST
> )
2652 unless ( /^(\d+)\s+(\w+)\s+([a-zA-Z0-9]+)\t(.*)$/o )
2654 die ( "Couldn't process git-ls-tree line : $_ " );
2657 my ( $git_perms , $git_type , $git_hash , $git_filename ) = ( $1 , $2 , $3 , $4 );
2659 $seen_files ->{ $git_filename } = 1 ;
2661 my ( $oldhash , $oldrevision , $oldmode ) = (
2662 $head ->{ $git_filename }{ filehash
},
2663 $head ->{ $git_filename }{ revision
},
2664 $head ->{ $git_filename }{ mode
}
2667 if ( $git_perms =~ /^\d\d\d(\d)\d\d/o )
2670 $git_perms .= "r" if ( $1 & 4 );
2671 $git_perms .= "w" if ( $1 & 2 );
2672 $git_perms .= "x" if ( $1 & 1 );
2677 # unless the file exists with the same hash, we need to update it ...
2678 unless ( defined ( $oldhash ) and $oldhash eq $git_hash and defined ( $oldmode ) and $oldmode eq $git_perms )
2680 my $newrevision = ( $oldrevision or 0 ) + 1 ;
2682 $head ->{ $git_filename } = {
2683 name
=> $git_filename ,
2684 revision
=> $newrevision ,
2685 filehash
=> $git_hash ,
2686 commithash
=> $commit ->{ hash
},
2687 modified
=> $commit ->{ date
},
2688 author
=> $commit ->{ author
},
2693 $self -> insert_rev ( $git_filename , $newrevision , $git_hash , $commit ->{ hash
}, $commit ->{ date
}, $commit ->{ author
}, $git_perms );
2698 # Detect deleted files
2699 foreach my $file ( keys % $head )
2701 unless ( exists $seen_files ->{ $file } or $head ->{ $file }{ filehash
} eq "deleted" )
2703 $head ->{ $file }{ revision
}++;
2704 $head ->{ $file }{ filehash
} = "deleted" ;
2705 $head ->{ $file }{ commithash
} = $commit ->{ hash
};
2706 $head ->{ $file }{ modified
} = $commit ->{ date
};
2707 $head ->{ $file }{ author
} = $commit ->{ author
};
2709 $self -> insert_rev ( $file , $head ->{ $file }{ revision
}, $head ->{ $file }{ filehash
}, $commit ->{ hash
}, $commit ->{ date
}, $commit ->{ author
}, $head ->{ $file }{ mode
});
2712 # END : "Detect deleted files"
2716 if ( exists $commit ->{ mergemsg
})
2718 $self -> insert_mergelog ( $commit ->{ hash
}, $commit ->{ mergemsg
});
2721 $lastpicked = $commit ->{ hash
};
2723 $self -> _set_prop ( "last_commit" , $commit ->{ hash
});
2726 $self -> delete_head ();
2727 foreach my $file ( keys % $head )
2731 $head ->{ $file }{ revision
},
2732 $head ->{ $file }{ filehash
},
2733 $head ->{ $file }{ commithash
},
2734 $head ->{ $file }{ modified
},
2735 $head ->{ $file }{ author
},
2736 $head ->{ $file }{ mode
},
2739 # invalidate the gethead cache
2740 $self ->{ gethead_cache
} = undef ;
2743 # Ending exclusive lock here
2744 $self ->{ dbh
}-> commit () or die "Failed to commit changes to SQLite" ;
2751 my $revision = shift ;
2752 my $filehash = shift ;
2753 my $commithash = shift ;
2754 my $modified = shift ;
2758 my $insert_rev = $self ->{ dbh
}-> prepare_cached ( "INSERT INTO revision (name, revision, filehash, commithash, modified, author, mode) VALUES (?,?,?,?,?,?,?)" ,{}, 1 );
2759 $insert_rev -> execute ( $name , $revision , $filehash , $commithash , $modified , $author , $mode );
2768 my $insert_mergelog = $self ->{ dbh
}-> prepare_cached ( "INSERT INTO commitmsgs (key, value) VALUES (?,?)" ,{}, 1 );
2769 $insert_mergelog -> execute ( $key , $value );
2776 my $delete_head = $self ->{ dbh
}-> prepare_cached ( "DELETE FROM head" ,{}, 1 );
2777 $delete_head -> execute ();
2784 my $revision = shift ;
2785 my $filehash = shift ;
2786 my $commithash = shift ;
2787 my $modified = shift ;
2791 my $insert_head = $self ->{ dbh
}-> prepare_cached ( "INSERT INTO head (name, revision, filehash, commithash, modified, author, mode) VALUES (?,?,?,?,?,?,?)" ,{}, 1 );
2792 $insert_head -> execute ( $name , $revision , $filehash , $commithash , $modified , $author , $mode );
2798 my $filename = shift ;
2800 my $db_query = $self ->{ dbh
}-> prepare_cached ( "SELECT filehash, revision, mode FROM head WHERE name=?" ,{}, 1 );
2801 $db_query -> execute ( $filename );
2802 my ( $hash , $revision , $mode ) = $db_query -> fetchrow_array ;
2804 return ( $hash , $revision , $mode );
2812 my $db_query = $self ->{ dbh
}-> prepare_cached ( "SELECT value FROM properties WHERE key=?" ,{}, 1 );
2813 $db_query -> execute ( $key );
2814 my ( $value ) = $db_query -> fetchrow_array ;
2825 my $db_query = $self ->{ dbh
}-> prepare_cached ( "UPDATE properties SET value=? WHERE key=?" ,{}, 1 );
2826 $db_query -> execute ( $value , $key );
2828 unless ( $db_query -> rows )
2830 $db_query = $self ->{ dbh
}-> prepare_cached ( "INSERT INTO properties (key, value) VALUES (?,?)" ,{}, 1 );
2831 $db_query -> execute ( $key , $value );
2845 return $self ->{ gethead_cache
} if ( defined ( $self ->{ gethead_cache
} ) );
2847 my $db_query = $self ->{ dbh
}-> prepare_cached ( "SELECT name, filehash, mode, revision, modified, commithash, author FROM head ORDER BY name ASC" ,{}, 1 );
2848 $db_query -> execute ();
2851 while ( my $file = $db_query -> fetchrow_hashref )
2856 $self ->{ gethead_cache
} = $tree ;
2868 my $filename = shift ;
2870 my $db_query = $self ->{ dbh
}-> prepare_cached ( "SELECT name, filehash, author, mode, revision, modified, commithash FROM revision WHERE name=? ORDER BY revision DESC" ,{}, 1 );
2871 $db_query -> execute ( $filename );
2874 while ( my $file = $db_query -> fetchrow_hashref )
2884 This function takes a filename (with path) argument and returns a hashref of
2885 metadata for that file.
2892 my $filename = shift ;
2893 my $revision = shift ;
2896 if ( defined ( $revision ) and $revision =~ /^\d+$/ )
2898 $db_query = $self ->{ dbh
}-> prepare_cached ( "SELECT * FROM revision WHERE name=? AND revision=?" ,{}, 1 );
2899 $db_query -> execute ( $filename , $revision );
2901 elsif ( defined ( $revision ) and $revision =~ /^[a-zA-Z0-9]{40}$/ )
2903 $db_query = $self ->{ dbh
}-> prepare_cached ( "SELECT * FROM revision WHERE name=? AND commithash=?" ,{}, 1 );
2904 $db_query -> execute ( $filename , $revision );
2906 $db_query = $self ->{ dbh
}-> prepare_cached ( "SELECT * FROM head WHERE name=?" ,{}, 1 );
2907 $db_query -> execute ( $filename );
2910 return $db_query -> fetchrow_hashref ;
2913 =head2 commitmessage
2915 this function takes a commithash and returns the commit message for that commit
2921 my $commithash = shift ;
2923 die ( "Need commithash" ) unless ( defined ( $commithash ) and $commithash =~ /^[a-zA-Z0-9]{40}$/ );
2926 $db_query = $self ->{ dbh
}-> prepare_cached ( "SELECT value FROM commitmsgs WHERE key=?" ,{}, 1 );
2927 $db_query -> execute ( $commithash );
2929 my ( $message ) = $db_query -> fetchrow_array ;
2931 if ( defined ( $message ) )
2933 $message .= " " if ( $message =~ /\n$/ );
2937 my @lines = safe_pipe_capture
( "git-cat-file" , "commit" , $commithash );
2938 shift @lines while ( $lines [ 0 ] =~ /\S/ );
2939 $message = join ( "" , @lines );
2940 $message .= " " if ( $message =~ /\n$/ );
2946 This function takes a filename (with path) argument and returns an arrayofarrays
2947 containing revision,filehash,commithash ordered by revision descending
2953 my $filename = shift ;
2956 $db_query = $self ->{ dbh
}-> prepare_cached ( "SELECT revision, filehash, commithash FROM revision WHERE name=? ORDER BY revision DESC" ,{}, 1 );
2957 $db_query -> execute ( $filename );
2959 return $db_query -> fetchall_arrayref ;
2962 =head2 gethistorydense
2964 This function takes a filename (with path) argument and returns an arrayofarrays
2965 containing revision,filehash,commithash ordered by revision descending.
2967 This version of gethistory skips deleted entries -- so it is useful for annotate.
2968 The 'dense' part is a reference to a '--dense' option available for git-rev-list
2969 and other git tools that depend on it.
2975 my $filename = shift ;
2978 $db_query = $self ->{ dbh
}-> prepare_cached ( "SELECT revision, filehash, commithash FROM revision WHERE name=? AND filehash!='deleted' ORDER BY revision DESC" ,{}, 1 );
2979 $db_query -> execute ( $filename );
2981 return $db_query -> fetchall_arrayref ;
2986 from Array::PAT - mimics the in_array() function
2987 found in PHP. Yuck but works for small arrays.
2992 my ( $check , @array ) = @_ ;
2994 foreach my $test ( @array ){
2995 if ( $check eq $test ){
3002 =head2 safe_pipe_capture
3004 an alternative to `command` that allows input to be passed as an array
3005 to work around shell problems with weird characters in arguments
3008 sub safe_pipe_capture
{
3012 if ( my $pid = open my $child , '-|' ) {
3013 @output = (< $child >);
3014 close $child or die join ( ' ' , @_ ). ": $! $?" ;
3016 exec ( @_ ) or die "$! $?" ; # exec() can fail the executable can't be found
3018 return wantarray ?
@output : join ( '' , @output );
3021 =head2 mangle_dirname
3023 create a string from a directory name that is suitable to use as
3024 part of a filename, mainly by converting all chars except \w.- to _
3027 sub mangle_dirname
{
3028 my $dirname = shift ;
3029 return unless defined $dirname ;
3031 $dirname =~ s/[^\w.-]/_/g ;