1#!/usr/bin/perl -w 2 3# A tool to build a perl release tarball 4# Very basic but functional - if you're on a unix system. 5# 6# If you're on Win32 then it should still work, but various Unix command-line 7# tools will need to be available somewhere. An obvious choice is to install 8# Cygwin and ensure its 'bin' folder is on the PATH in the shell where you run 9# this script. The Cygwin 'bin' folder needs to precede the Windows 'system32' 10# folder so that Cygwin's 'find' command is found in preference to the Windows 11# 'find' command. In addition to the commands installed by default, your Cygwin 12# installation will need to contain at least the 'cpio' and '7z' commands. 13# Finally, ensure that the 'awk', 'shasum' (if you have it) and '7z' commands 14# are copies of 'gawk.exe', 'sha1sum.exe' and 'lib\p7zip\7z.exe' respectively, 15# rather than the links to them that only work in a Cygwin bash shell which 16# they are by default. 17# 18# No matter how automated this gets, you'll always need to read 19# and re-read pumpkin.pod and release_managers_guide.pod to 20# check for things to be done at various stages of the process. 21# 22# Tim Bunce, June 1997 23 24use ExtUtils::Manifest qw(fullcheck); 25$ExtUtils::Manifest::Quiet = 1; 26use Getopt::Std; 27 28$|=1; 29 30sub usage { die <<EOF; } 31usage: $0 [ -r rootdir ] [-s suffix ] [ -x ] [ -n ] 32 -r rootdir directory under which to create the build dir and tarball 33 defaults to '..' 34 -s suffix suffix to append to the perl-x.y.z dir and tarball name 35 defaults to the concatenation of the local_patches entry 36 in patchlevel.h (or blank, if none) 37 -x make a .xz file in addition to a .gz file 38 -n do not make any tarballs, just the directory 39EOF 40 41my %opts; 42getopts('xnr:s:', \%opts) or usage; 43@ARGV && usage; 44 45$relroot = defined $opts{r} ? $opts{r} : ".."; 46 47die "Must be in root of the perl source tree.\n" 48 unless -f "./MANIFEST" and -f "patchlevel.h"; 49 50open PATCHLEVEL, '<', 'patchlevel.h' or die; 51my @patchlevel_h = <PATCHLEVEL>; 52close PATCHLEVEL; 53my $patchlevel_h = join "", grep { /^#\s*define/ } @patchlevel_h; 54print $patchlevel_h; 55$revision = $1 if $patchlevel_h =~ /PERL_REVISION\s+(\d+)/; 56$patchlevel = $1 if $patchlevel_h =~ /PERL_VERSION\s+(\d+)/; 57$subversion = $1 if $patchlevel_h =~ /PERL_SUBVERSION\s+(\d+)/; 58die "Unable to parse patchlevel.h" unless $subversion >= 0; 59$vers = sprintf("%d.%d.%d", $revision, $patchlevel, $subversion); 60 61# fetch list of local patches 62my (@local_patches, @lpatch_tags, $lpatch_tags); 63@local_patches = grep { !/^\s*,?NULL/ && ! /,"uncommitted-changes"/ } 64 grep { /^static.*local_patches/../^};/ } 65 @patchlevel_h; 66@lpatch_tags = map { /^\s*,"(\w+)/ } @local_patches; 67$lpatch_tags = join "-", @lpatch_tags; 68 69$perl = "perl-$vers"; 70$reldir = "$perl"; 71 72$lpatch_tags = $opts{s} if defined $opts{s}; 73$reldir .= "-$lpatch_tags" if $lpatch_tags; 74 75print "\nMaking a release for $perl in $relroot/$reldir\n\n"; 76 77print "Cross-checking the MANIFEST...\n"; 78($missfile, $missentry) = fullcheck(); 79@$missentry 80 = grep {$_ !~ m!^\.(?:git|github|mailmap)! and $_ !~ m!(?:/|^)\.gitignore!} @$missentry; 81if (@$missfile ) { 82 warn "Can't make a release with MANIFEST files missing:\n"; 83 warn "\t".$_."\n" for (@$missfile); 84} 85if (@$missentry ) { 86 warn "Can't make a release with files not listed in MANIFEST\n"; 87 warn "\t".$_."\n" for (@$missentry); 88 89} 90if ("@$missentry" =~ m/\.orig\b/) { 91 # Handy listing of find command and .orig files from patching work. 92 # I tend to run 'xargs rm' and copy and paste the file list. 93 my $cmd = "find . -name '*.orig' -print"; 94 print "$cmd\n"; 95 system($cmd); 96} 97die "Aborted.\n" if @$missentry or @$missfile; 98print "\n"; 99 100# VMS no longer has hardcoded version numbers descrip.mms 101 102print "Creating $relroot/$reldir release directory...\n"; 103die "$relroot/$reldir release directory already exists\n" if -e "$relroot/$reldir"; 104die "$relroot/$reldir.tar.gz release file already exists\n" if -e "$relroot/$reldir.tar.gz"; 105mkdir("$relroot/$reldir", 0755) or die "mkdir $relroot/$reldir: $!\n"; 106print "\n"; 107 108 109print "Copying files to release directory...\n"; 110# ExtUtils::Manifest maniread does not preserve the order 111$cmd = "awk '{print \$1}' MANIFEST | cpio -pdm $relroot/$reldir"; 112system($cmd) == 0 113 or die "$cmd failed"; 114print "\n"; 115 116chdir "$relroot/$reldir" or die $!; 117 118 119print "Setting file permissions...\n"; 120system("find . -type f -print | xargs chmod 0444"); 121system("find . -type d -print | xargs chmod 0755"); 122my @exe = map { my ($f) = split; glob($f) } 123 grep { $_ !~ /\A#/ && $_ !~ /\A\s*\z/ } 124 map { split "\n" } 125 do { local (@ARGV, $/) = 'Porting/exec-bit.txt'; <> }; 126 127system("chmod +x @exe") == 0 128 or die "system: $!"; 129 130my @writables = qw( 131 NetWare/config_H.wc 132 NetWare/Makefile 133 feature.h 134 lib/feature.pm 135 keywords.h 136 keywords.c 137 opcode.h 138 opnames.h 139 pp_proto.h 140 proto.h 141 embed.h 142 embedvar.h 143 overload.inc 144 overload.h 145 mg_vtable.h 146 perlapi.h 147 perlapi.c 148 dist/Devel-PPPort/module2.c 149 dist/Devel-PPPort/module3.c 150 cpan/autodie/t/touch_me 151 reentr.c 152 reentr.h 153 regcharclass.h 154 regnodes.h 155 warnings.h 156 lib/warnings.pm 157 win32/GNUmakefile 158 win32/Makefile 159 win32/makefile.mk 160 win32/config_H.gc 161 win32/config_H.vc 162 uconfig.h 163); 164 165my $out = `chmod u+w @writables 2>&1`; 166if ($? != 0) { 167 warn $out; 168 if ($out =~ /no such file/i) { 169 warn "Check that the files above still exist in the Perl core.\n"; 170 warn "If not, remove them from \@writables in Porting/makerel\n"; 171 } 172 exit 1; 173} 174 175warn $out if $out; 176 177chdir ".." or die $!; 178 179exit if $opts{n}; 180 181my $src = (-e $perl) ? $perl : 'perl'; # 'perl' in maint branch 182 183print "Checking if you have 7z...\n"; 184my $output_7z = `7z 2>&1`; 185my $have_7z = defined $output_7z && $output_7z =~ /7-Zip/; 186 187print "Checking if you have advdef...\n"; 188my $output_advdef = `advdef --version 2>&1`; 189my $have_advdef = defined $output_advdef && $output_advdef =~ /advancecomp/; 190 191if ($have_7z) { 192 print "Creating and compressing the tar.gz file with 7z...\n"; 193 $cmd = "tar cf - $reldir | 7z a -tgzip -mx9 -bd -si $reldir.tar.gz"; 194 system($cmd) == 0 or die "$cmd failed"; 195} else { 196 print "Creating and compressing the tar.gz file...\n"; 197 $cmd = "tar cf - $reldir | gzip --best > $reldir.tar.gz"; 198 system($cmd) == 0 or die "$cmd failed"; 199 if ($have_advdef) { 200 print "Recompressing the tar.gz file with advdef...\n"; 201 $cmd = "advdef -z -4 $reldir.tar.gz"; 202 system($cmd) == 0 or die "$cmd failed"; 203 } 204} 205 206if ($opts{x}) { 207 print "Creating and compressing the tar.xz file with xz...\n"; 208 $cmd = "tar cf - $reldir | xz -z -c > $reldir.tar.xz"; 209 system($cmd) == 0 or die "$cmd failed"; 210} 211 212print "\n"; 213 214system("ls -ld $perl*"); 215print "\n"; 216 217my $null = $^O eq 'MSWin32' ? 'NUL' : '/dev/null'; 218for my $sha (qw(sha1 shasum sha1sum)) { 219 if (`which $sha 2>$null`) { 220 system("$sha $perl*.tar.*"); 221 last; 222 } 223} 224