X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;ds=sidebyside;f=Debian%2FDgit.pm;h=fa85374150288cc53a1ef363042262315b76ab52;hb=9acb31a971d4f653836bbcf07410f51d3f80dbdd;hp=211bae3a6626d503b6452864aa5815769ba1c6e9;hpb=e1adbc736603409551756653090e4455562833af;p=dgit.git diff --git a/Debian/Dgit.pm b/Debian/Dgit.pm index 211bae3a..fa853741 100644 --- a/Debian/Dgit.pm +++ b/Debian/Dgit.pm @@ -1,46 +1,293 @@ -# +# -*- perl -*- package Debian::Dgit; use strict; use warnings; +use POSIX; +use IO::Handle; +use Config; + BEGIN { use Exporter (); our ($VERSION, @ISA, @EXPORT, @EXPORT_OK, %EXPORT_TAGS); $VERSION = 1.00; @ISA = qw(Exporter); - @EXPORT = qw(debiantag server_branch server_ref - $package_re $branchprefix); - %EXPORT_TAGS = ( policyflags => qw() ); - @EXPORT_OK = qw(); + @EXPORT = qw(setup_sigwarn + debiantag server_branch server_ref + stat_exists link_ltarget + fail ensuredir executable_on_path + waitstatusmsg failedcmd + cmdoutput cmdoutput_errok + git_rev_parse 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 messagequote); + # implicitly uses $main::us + %EXPORT_TAGS = ( policyflags => [qw(NOFFCHECK FRESHREPO)] ); + @EXPORT_OK = @{ $EXPORT_TAGS{policyflags} }; } our @EXPORT_OK; our $package_re = '[0-9a-z][-+.0-9a-z]*'; +our $component_re = '[0-9a-zA-Z][-+.0-9a-zA-Z]*'; +our $deliberately_re = "(?:TEST-)?$package_re"; our $branchprefix = 'dgit'; - # policy hook exit status bits -# any unexpected bits mean failure, and then known set bits are ignored +# see dgit-repos-server head comment for documentation +# 1 is reserved in case something fails with `exit 1' and to spot +# dynamic loader, runtime, etc., failures, which report 127 or 255 +sub NOFFCHECK () { return 0x2; } +sub FRESHREPO () { return 0x4; } + +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 $!; +} + +sub enabledebug () { + open DEBUG, ">&STDERR" or die $!; + DEBUG->autoflush(1); + $debuglevel ||= 1; +} + +sub enabledebuglevel ($) { + my ($newlevel) = @_; # may be undef (eg from env var) + die if $debuglevel; + $newlevel //= 0; + $newlevel += 0; + return unless $newlevel; + $debuglevel = $newlevel; + enabledebug(); +} + +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 NOFFCHECK () { return 2; } -# suppress dgit-repos-server's ff check ("push" only) +sub shellquote { + my @out; + local $_; + foreach my $a (@_) { + $_ = $a; + if (!length || m{[^-=_./:0-9a-z]}i) { + s{['\\]}{'\\$&'}g; + push @out, "'$_'"; + } else { + push @out, $_; + } + } + return join ' ', @out; +} -sub FRESHREPO () { return 4; } -# blow away repo right away (ie, as if before push or fetch) -# ("check-package" and "push" only) +sub printcmd { + my $fh = shift @_; + my $intro = shift @_; + print $fh $intro," " or die $!; + print $fh shellquote @_ or die $!; + print $fh "\n" or die $!; +} +sub debugcmd { + my $extraprefix = shift @_; + printcmd(\*DEBUG,$debugprefix.$extraprefix,@_) if $debuglevel>0; +} -sub debiantag ($) { - my ($v) = @_; +sub debiantag ($$) { + my ($v,$distro) = @_; $v =~ y/~:/_%/; - return "debian/$v"; + return "$distro/$v"; } sub server_branch ($) { return "$branchprefix/$_[0]"; } sub server_ref ($) { return "refs/".server_branch($_[0]); } +sub stat_exists ($) { + my ($f) = @_; + return 1 if stat $f; + return 0 if $!==&ENOENT; + die "stat $f: $!"; +} + +sub _us () { + $::us // ($0 =~ m#[^/]*$#, $&); +} + +sub fail { + my $s = "@_\n"; + my $prefix = _us().": "; + $s =~ s/^/$prefix/gm; + die $s; +} + +sub ensuredir ($) { + my ($dir) = @_; # does not create parents + return if mkdir $dir; + return if $! == EEXIST; + 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 () { + if (!$?) { + return "terminated, reporting successful completion"; + } elsif (!($? & 255)) { + return "failed with error exit status ".WEXITSTATUS($?); + } elsif (WIFSIGNALED($?)) { + my $signum=WTERMSIG($?); + return "died due to fatal signal ". + ($signames[$signum] // "number $signum"). + ($? & 128 ? " (core dumped)" : ""); # POSIX(3pm) has no WCOREDUMP + } else { + return "failed with unknown wait status ".$?; + } +} + +sub failedcmd { + { local ($!); printcmd \*STDERR, _us().": failed command:", @_ or die $!; }; + if ($!) { + fail "failed to fork/exec: $!"; + } elsif ($?) { + fail "subprocess ".waitstatusmsg(); + } else { + fail "subprocess produced invalid output"; + } +} + +sub cmdoutput_errok { + die Dumper(\@_)." ?" if grep { !defined } @_; + debugcmd "|",@_; + 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;
+ if ($debuglevel > 0) {
+ $d =~ m/^.*/;
+ my $dd = $&;
+ my $more = (length $' ? '...' : ''); #');
+ $dd =~ s{[^\n -~]|\\}{ sprintf "\\x%02x", ord $& }ge;
+ printdebug "=> \`$dd'",$more,"\n";
+ }
+ return $d;
+}
+
+sub cmdoutput {
+ my $d = cmdoutput_errok @_;
+ defined $d or failedcmd @_;
+ return $d;
+}
+
+sub link_ltarget ($$) {
+ my ($old,$new) = @_;
+ lstat $old or return undef;
+ if (-l _) {
+ $old = cmdoutput qw(realpath --), $old;
+ }
+ link $old, $new or die "link $old $new: $!";
+}
+
+sub git_rev_parse ($) {
+ return cmdoutput qw(git rev-parse), "$_[0]~0";
+}
+
+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);
+ if (defined $gitdir) {
+ @cmd = ('sh','-ec','cd "$1"; shift; exec "$@"','x', $gitdir, @cmd);
+ }
+ open GFER, "-|", @cmd or die $!;
+ debugcmd "|", @cmd;
+ while (