X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=dgit.git;a=blobdiff_plain;f=Debian%2FDgit.pm;h=314bd8c712c6159fe031bfe8073a62f902666f84;hp=a270cd80836f1206d1033cb5441816dc9cd9f09c;hb=ec7cf6aaf2fce8af943ccdd866e98f805f8a98fe;hpb=c31626414fabe6a00ff9db901f69016d26400cb4 diff --git a/Debian/Dgit.pm b/Debian/Dgit.pm index a270cd80..314bd8c7 100644 --- a/Debian/Dgit.pm +++ b/Debian/Dgit.pm @@ -1,13 +1,34 @@ # -*- perl -*- +# dgit +# Debian::Dgit: functions common to dgit and its helpers and servers +# +# Copyright (C) 2015-2016 Ian Jackson +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 3 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . package Debian::Dgit; use strict; use warnings; +use Carp; use POSIX; use IO::Handle; use Config; +use Digest::SHA; +use Data::Dumper; +use IPC::Open2; BEGIN { use Exporter (); @@ -15,19 +36,27 @@ BEGIN { $VERSION = 1.00; @ISA = qw(Exporter); - @EXPORT = qw(debiantag server_branch server_ref - stat_exists fail ensuredir waitstatusmsg failedcmd + @EXPORT = qw(setup_sigwarn + dep14_version_mangle + debiantags debiantag_old debiantag_new + server_branch server_ref + stat_exists link_ltarget + hashfile + fail ensuredir executable_on_path + waitstatusmsg failedcmd_waitstatus + failedcmd_report_cmd failedcmd cmdoutput cmdoutput_errok - git_rev_parse git_for_each_ref + git_rev_parse git_cat_file + git_get_ref git_for_each_ref git_for_each_tag_referring is_fast_fwd $package_re $component_re $deliberately_re $branchprefix initdebug enabledebug enabledebuglevel printdebug debugcmd $debugprefix *debuglevel *DEBUG - shellquote printcmd); + shellquote printcmd messagequote); # implicitly uses $main::us - %EXPORT_TAGS = ( policyflags => [qw(NOFFCHECK FRESHREPO)] ); + %EXPORT_TAGS = ( policyflags => [qw(NOFFCHECK FRESHREPO NOCOMMITCHECK)] ); @EXPORT_OK = @{ $EXPORT_TAGS{policyflags} }; } @@ -44,10 +73,18 @@ our $branchprefix = 'dgit'; # dynamic loader, runtime, etc., failures, which report 127 or 255 sub NOFFCHECK () { return 0x2; } sub FRESHREPO () { return 0x4; } +sub NOCOMMITCHECK () { return 0x8; } our $debugprefix; our $debuglevel = 0; +sub setup_sigwarn () { + our $sigwarn_mainprocess = $$; + $SIG{__WARN__} = sub { + die $_[0] unless getppid == $sigwarn_mainprocess; + }; +} + sub initdebug ($) { ($debugprefix) = @_; open DEBUG, ">/dev/null" or die $!; @@ -73,12 +110,22 @@ sub printdebug { print DEBUG $debugprefix, @_ or die $! if $debuglevel>0; } +sub messagequote ($) { + local ($_) = @_; + s{\\}{\\\\}g; + s{\n}{\\n}g; + s{\x08}{\\b}g; + s{\t}{\\t}g; + s{[\000-\037\177]}{ sprintf "\\x%02x", ord $& }ge; + $_; +} + sub shellquote { my @out; local $_; foreach my $a (@_) { $_ = $a; - if (!length || m{[^-=_./0-9a-z]}i) { + if (!length || m{[^-=_./:0-9a-z]}i) { s{['\\]}{'\\$&'}g; push @out, "'$_'"; } else { @@ -101,10 +148,27 @@ sub debugcmd { printcmd(\*DEBUG,$debugprefix.$extraprefix,@_) if $debuglevel>0; } -sub debiantag ($) { +sub dep14_version_mangle ($) { my ($v) = @_; + # DEP-14 patch proposed 2016-11-09 "Version Mangling" $v =~ y/~:/_%/; - return "debian/$v"; + $v =~ s/\.(?=\.|$|lock$)/.#/g; + return $v; +} + +sub debiantag_old ($$) { + my ($v,$distro) = @_; + return "$distro/". dep14_version_mangle $v; +} + +sub debiantag_new ($$) { + my ($v,$distro) = @_; + return "archive/$distro/".dep14_version_mangle $v; +} + +sub debiantags ($$) { + my ($version,$distro) = @_; + map { $_->($version, $distro) } (\&debiantag_new, \&debiantag_old); } sub server_branch ($) { return "$branchprefix/$_[0]"; } @@ -123,6 +187,7 @@ sub _us () { sub fail { my $s = "@_\n"; + $s =~ s/\n\n$/\n/; my $prefix = _us().": "; $s =~ s/^/$prefix/gm; die $s; @@ -135,6 +200,17 @@ sub ensuredir ($) { die "mkdir $dir: $!"; } +sub executable_on_path ($) { + my ($program) = @_; + return 1 if $program =~ m{/}; + my @path = split /:/, ($ENV{PATH} // "/usr/local/bin:/bin:/usr/bin"); + foreach my $pe (@path) { + my $here = "$pe/$program"; + return $here if stat_exists $here && -x _; + } + return undef; +} + our @signames = split / /, $Config{sig_name}; sub waitstatusmsg () { @@ -152,29 +228,55 @@ sub waitstatusmsg () { } } -sub failedcmd { - { local ($!); printcmd \*STDERR, _us().": failed command:", @_ or die $!; }; - if ($!) { - fail "failed to fork/exec: $!"; +sub failedcmd_report_cmd { + my $intro = shift @_; + $intro //= "failed command"; + { local ($!); printcmd \*STDERR, _us().": $intro:", @_ or die $!; }; +} + +sub failedcmd_waitstatus { + if ($? < 0) { + return "failed to fork/exec: $!"; } elsif ($?) { - fail "subprocess ".waitstatusmsg(); + return "subprocess ".waitstatusmsg(); } else { - fail "subprocess produced invalid output"; + return "subprocess produced invalid output"; } } +sub failedcmd { + # Expects $!,$? as set by close - see below. + # To use with system(), set $?=-1 first. + # + # Actual behaviour of perl operations: + # success $!==0 $?==0 close of piped open + # program failed $!==0 $? >0 close of piped open + # syscall failure $! >0 $?=-1 close of piped open + # failure $! >0 unchanged close of something else + # success trashed $?==0 system + # program failed trashed $? >0 system + # syscall failure $! >0 unchanged system + failedcmd_report_cmd undef, @_; + fail failedcmd_waitstatus(); +} + sub cmdoutput_errok { - die Dumper(\@_)." ?" if grep { !defined } @_; + confess Dumper(\@_)." ?" if grep { !defined } @_; debugcmd "|",@_; - open P, "-|", @_ or die $!; + open P, "-|", @_ or die "$_[0] $!"; my $d; $!=0; $?=0; { local $/ = undef; $d =

; } die $! if P->error; if (!close P) { printdebug "=>!$?\n"; return undef; } chomp $d; - $d =~ m/^.*/; - printdebug "=> \`$&'",(length $' ? '...' : ''),"\n" if $debuglevel>0; #'; + if ($debuglevel > 0) { + $d =~ m/^.*/; + my $dd = $&; + my $more = (length $' ? '...' : ''); #'); + $dd =~ s{[^\n -~]|\\}{ sprintf "\\x%02x", ord $& }ge; + printdebug "=> \`$dd'",$more,"\n"; + } return $d; } @@ -184,16 +286,61 @@ sub cmdoutput { return $d; } +sub link_ltarget ($$) { + my ($old,$new) = @_; + lstat $old or return undef; + if (-l _) { + $old = cmdoutput qw(realpath --), $old; + } + my $r = link $old, $new; + $r = symlink $old, $new if !$r && $!==EXDEV; + $r or die "(sym)link $old $new: $!"; +} + +sub hashfile ($) { + my ($fn) = @_; + my $h = Digest::SHA->new(256); + $h->addfile($fn); + return $h->hexdigest(); +} + sub git_rev_parse ($) { return cmdoutput qw(git rev-parse), "$_[0]~0"; } -sub git_for_each_ref ($$) { - my ($pattern,$func) = @_; +sub git_cat_file ($) { + my ($objname) = @_; + # => ($type, $data) or ('missing', undef) + our ($gcf_pid, $gcf_i, $gcf_o); + if (!$gcf_pid) { + my @cmd = qw(git cat-file --batch); + debugcmd "GCF|", @cmd; + $gcf_pid = open2 $gcf_o, $gcf_i, @cmd or die $!; + } + printdebug "GCF>| ", $objname, "\n"; + print $gcf_i $objname, "\n" or die $!; + my $x = <$gcf_o>; + printdebug "GCF<| ", $x; + if ($x =~ m/ (missing)$/) { return ($1, undef); } + my ($type, $size) = $x =~ m/^.* (\w+) (\d+)\n/ or die "$objname ?"; + my $data; + (read $gcf_o, $data, $size) == $size or die "$objname $!"; + $x = <$gcf_o>; + $x eq "\n" or die "$objname ($_) $!"; + return ($type, $data); +} + +sub git_for_each_ref ($$;$) { + my ($pattern,$func,$gitdir) = @_; # calls $func->($objid,$objtype,$fullrefname,$reftail); # $reftail is RHS of ref after refs/[^/]+/ # breaks if $pattern matches any ref `refs/blah' where blah has no `/' - my @cmd = (qw(git for-each-ref), $pattern); + # $pattern may be an array ref to mean multiple patterns + $pattern = [ $pattern ] unless ref $pattern; + my @cmd = (qw(git for-each-ref), @$pattern); + if (defined $gitdir) { + @cmd = ('sh','-ec','cd "$1"; shift; exec "$@"','x', $gitdir, @cmd); + } open GFER, "-|", @cmd or die $!; debugcmd "|", @cmd; while () { @@ -205,6 +352,14 @@ sub git_for_each_ref ($$) { $!=0; $?=0; close GFER or die "$pattern $? $!"; } +sub git_get_ref ($) { + # => '' if no such ref + my ($refname) = @_; + local $_ = $refname; + s{^refs/}{[r]efs/} or die "$refname $_ ?"; + return cmdoutput qw(git for-each-ref --format=%(objectname)), $_; +} + sub git_for_each_tag_referring ($$) { my ($objreferring, $func) = @_; # calls $func->($tagobjid,$refobjid,$fullrefname,$tagname);