| 1 | #!/usr/bin/perl |
| 2 | # |
| 3 | # $Cambridge: exim/release-process/scripts/mk_exim_release.pl,v 1.1 2010/06/03 12:00:38 nm4 Exp $ |
| 4 | # |
| 5 | use strict; |
| 6 | use warnings; |
| 7 | use Carp; |
| 8 | use File::Copy; |
| 9 | use File::Spec; |
| 10 | use File::Path; |
| 11 | use File::Temp; |
| 12 | use Getopt::Long; |
| 13 | use Pod::Usage; |
| 14 | |
| 15 | my $debug = 0; |
| 16 | my $verbose = 0; |
| 17 | |
| 18 | # ------------------------------------------------------------------ |
| 19 | |
| 20 | sub get_and_check_version { |
| 21 | my $release = shift; |
| 22 | |
| 23 | # make sure this looks like a real release version |
| 24 | # which should (currently) be 4.xx or 4.xx_RCx |
| 25 | unless ( $release =~ /^(4\.\d\d(?:_RC\d+)?)$/ ) { |
| 26 | croak "The given version number does not look right - $release"; |
| 27 | } |
| 28 | return $1; # untainted here... |
| 29 | } |
| 30 | |
| 31 | # ------------------------------------------------------------------ |
| 32 | |
| 33 | sub build_tag { |
| 34 | my $context = shift; |
| 35 | |
| 36 | # The CVS tag consists of exim-$version where $version |
| 37 | # is the version number with . replaced with _ |
| 38 | my $modversion = $context->{release}; |
| 39 | $modversion =~ tr/0-9RC/_/cs; |
| 40 | |
| 41 | return sprintf( 'exim-%s', $modversion ); |
| 42 | } |
| 43 | |
| 44 | # ------------------------------------------------------------------ |
| 45 | |
| 46 | sub deal_with_working_directory { |
| 47 | my $context = shift; |
| 48 | my $delete = shift; |
| 49 | |
| 50 | # Set default directory |
| 51 | $context->{directory} ||= File::Spec->rel2abs( sprintf( 'exim-packaging-%s', $context->{release} ) ); |
| 52 | my $directory = $context->{directory}; |
| 53 | |
| 54 | # ensure the working directory is not in place |
| 55 | if ( -d $directory ) { |
| 56 | if ($delete) { |
| 57 | print "Deleting existing $directory\n" if ($verbose); |
| 58 | rmtree( $directory, { verbose => $debug } ); |
| 59 | } |
| 60 | if ( -d $directory ) { |
| 61 | croak "Working directory $directory exists"; |
| 62 | } |
| 63 | } |
| 64 | |
| 65 | mkpath( $context->{directory}, { verbose => ( $verbose || $debug ) } ); |
| 66 | } |
| 67 | |
| 68 | # ------------------------------------------------------------------ |
| 69 | |
| 70 | sub export_git_tree { |
| 71 | my $context = shift; |
| 72 | |
| 73 | # build git command |
| 74 | my $archive_file = sprintf( '%s/%s-%s.tar', $context->{tmp_dir}, $context->{pkgname}, $context->{release} ); |
| 75 | $context->{tmp_archive_file} = $archive_file; |
| 76 | my @cmd = ( 'git', 'archive', '--format=tar', "--output=$archive_file", $context->{tag} ); |
| 77 | |
| 78 | # run git command |
| 79 | print( "Running: ", join( ' ', @cmd ), "\n" ) if ($verbose); |
| 80 | system(@cmd) == 0 || croak "Export failed"; |
| 81 | } |
| 82 | |
| 83 | # ------------------------------------------------------------------ |
| 84 | |
| 85 | sub unpack_tree { |
| 86 | my $context = shift; |
| 87 | |
| 88 | die "Cannot see archive file\n" unless ( -f $context->{tmp_archive_file} ); |
| 89 | my @cmd = ( 'tar', 'xf', $context->{tmp_archive_file} ); |
| 90 | |
| 91 | # run command |
| 92 | print( "Running: ", join( ' ', @cmd ), "\n" ) if ($verbose); |
| 93 | system(@cmd) == 0 || croak "Unpack failed"; |
| 94 | } |
| 95 | |
| 96 | # ------------------------------------------------------------------ |
| 97 | |
| 98 | sub build_documentation { |
| 99 | system("cd doc/doc-docbook && ./OS-Fixups && make everything") == 0 |
| 100 | || croak "Doc build failed"; |
| 101 | } |
| 102 | |
| 103 | # ------------------------------------------------------------------ |
| 104 | |
| 105 | sub move_text_docs_into_pkg { |
| 106 | my $context = shift; |
| 107 | |
| 108 | my $old_docdir = 'doc/doc-docbook'; |
| 109 | my $new_docdir = File::Spec->catdir( $context->{pkgdir}, 'doc' ); |
| 110 | mkpath( $new_docdir, { verbose => ( $verbose || $debug ) } ); |
| 111 | |
| 112 | # move generated documents from docbook stuff |
| 113 | foreach my $file (qw/exim.8 spec.txt filter.txt/) { |
| 114 | move( File::Spec->catfile( $old_docdir, $file ), File::Spec->catfile( $new_docdir, $file ) ); |
| 115 | } |
| 116 | |
| 117 | # move text documents across |
| 118 | foreach my $file ( glob( File::Spec->catfile( 'doc/doc-txt', '*' ) ) ) { |
| 119 | |
| 120 | # skip a few we dont want |
| 121 | my $fn = ( File::Spec->splitpath($file) )[2]; |
| 122 | next |
| 123 | if ( ( $fn eq 'ABOUT' ) |
| 124 | || ( $fn eq 'ChangeLog.0' ) |
| 125 | || ( $fn eq 'test-harness.txt' ) ); |
| 126 | move( $file, File::Spec->catfile( $new_docdir, $fn ) ); |
| 127 | } |
| 128 | } |
| 129 | |
| 130 | # ------------------------------------------------------------------ |
| 131 | |
| 132 | sub build_pspdfinfo_directory { |
| 133 | my $context = shift; |
| 134 | |
| 135 | ##foreach my $format (qw/pdf postscript texinfo info/) { |
| 136 | foreach my $format (qw/pdf postscript/) { |
| 137 | my $dir = sprintf( 'exim-%s-%s', $format, $context->{release} ); |
| 138 | my $target = File::Spec->catdir( $dir, 'doc' ); |
| 139 | mkpath( $target, { verbose => ( $verbose || $debug ) } ); |
| 140 | |
| 141 | # move documents across |
| 142 | foreach my $file ( |
| 143 | glob( |
| 144 | File::Spec->catfile( |
| 145 | 'doc/doc-docbook', |
| 146 | ( |
| 147 | ( $format eq 'postscript' ) |
| 148 | ? '*.ps' |
| 149 | : ( '*.' . $format ) |
| 150 | ) |
| 151 | ) |
| 152 | ) |
| 153 | ) |
| 154 | { |
| 155 | my $fn = ( File::Spec->splitpath($file) )[2]; |
| 156 | move( $file, File::Spec->catfile( $target, $fn ) ); |
| 157 | } |
| 158 | } |
| 159 | } |
| 160 | |
| 161 | # ------------------------------------------------------------------ |
| 162 | |
| 163 | sub build_main_package_directory { |
| 164 | my $context = shift; |
| 165 | |
| 166 | # initially we move the exim-src directory to the new directory name |
| 167 | my $pkgdir = sprintf( 'exim-%s', $context->{release} ); |
| 168 | $context->{pkgdir} = $pkgdir; |
| 169 | rename( 'src', $pkgdir ) || croak "Rename of src dir failed - $!"; |
| 170 | |
| 171 | # add Local subdirectory |
| 172 | my $target = File::Spec->catdir( $pkgdir, 'Local' ); |
| 173 | mkpath( $target, { verbose => ( $verbose || $debug ) } ); |
| 174 | |
| 175 | # now add the text docs |
| 176 | move_text_docs_into_pkg($context); |
| 177 | } |
| 178 | |
| 179 | # ------------------------------------------------------------------ |
| 180 | |
| 181 | sub build_package_directories { |
| 182 | my $context = shift; |
| 183 | |
| 184 | build_main_package_directory($context); |
| 185 | build_pspdfinfo_directory($context); |
| 186 | } |
| 187 | |
| 188 | # ------------------------------------------------------------------ |
| 189 | |
| 190 | sub create_tar_files { |
| 191 | my $context = shift; |
| 192 | |
| 193 | foreach my $dir ( glob( 'exim*-' . $context->{release} ) ) { |
| 194 | system("tar cfz ${dir}.tar.gz ${dir}"); |
| 195 | system("tar cfj ${dir}.tar.bz2 ${dir}"); |
| 196 | } |
| 197 | } |
| 198 | |
| 199 | # ------------------------------------------------------------------ |
| 200 | { |
| 201 | my $man; |
| 202 | my $help; |
| 203 | my $context = { |
| 204 | pkgname => 'exim', |
| 205 | orig_dir => File::Spec->curdir(), |
| 206 | tmp_dir => File::Temp->newdir(), |
| 207 | }; |
| 208 | my $delete; |
| 209 | ##$ENV{'PATH'} = '/opt/local/bin:' . $ENV{'PATH'}; |
| 210 | |
| 211 | unless ( |
| 212 | GetOptions( |
| 213 | 'directory=s' => \$context->{directory}, |
| 214 | 'verbose!' => \$verbose, |
| 215 | 'debug!' => \$debug, |
| 216 | 'help|?' => \$help, |
| 217 | 'man!' => \$man, |
| 218 | 'delete!' => \$delete, |
| 219 | ) |
| 220 | ) |
| 221 | { |
| 222 | pod2usage( -exitval => 1, -verbose => 0 ); |
| 223 | } |
| 224 | pod2usage(0) if $help; |
| 225 | pod2usage( -verbose => 2 ) if $man; |
| 226 | |
| 227 | $context->{release} = get_and_check_version(shift); |
| 228 | $context->{tag} = build_tag($context); |
| 229 | deal_with_working_directory( $context, $delete ); |
| 230 | export_git_tree($context); |
| 231 | chdir( $context->{directory} ) || die; |
| 232 | unpack_tree($context); |
| 233 | build_documentation($context); |
| 234 | build_package_directories($context); |
| 235 | create_tar_files($context); |
| 236 | } |
| 237 | |
| 238 | 1; |
| 239 | |
| 240 | __END__ |
| 241 | |
| 242 | =head1 NAME |
| 243 | |
| 244 | mk_exim_release.pl - Build an exim release |
| 245 | |
| 246 | =head1 SYNOPSIS |
| 247 | |
| 248 | mk_exim_release.pl [options] version |
| 249 | |
| 250 | Options: |
| 251 | --debug force debug mode (SQL Trace) |
| 252 | --verbose force verbose mode |
| 253 | --help display this help and exits |
| 254 | --man displays man page |
| 255 | --directory=dir dir to package |
| 256 | --delete Delete packaging directory at start |
| 257 | |
| 258 | =head1 OPTIONS |
| 259 | |
| 260 | =over 4 |
| 261 | |
| 262 | =item B<--debug> |
| 263 | |
| 264 | Forces debug mode cause all SQL statements generated by L<DBIx::Class> |
| 265 | to be output. |
| 266 | |
| 267 | =item B<--verbose> |
| 268 | |
| 269 | Force verbose mode - currently this has no effect |
| 270 | |
| 271 | =item B<--help> |
| 272 | |
| 273 | Display help and exits |
| 274 | |
| 275 | =item B<--man> |
| 276 | |
| 277 | Display man page |
| 278 | |
| 279 | =back |
| 280 | |
| 281 | =head1 DESCRIPTION |
| 282 | |
| 283 | Builds an exim release. |
| 284 | |
| 285 | Starting in a populated git repo that has already been tagged for |
| 286 | release, build docs, build packages etc. |
| 287 | |
| 288 | Parameter is the version number to build as - ie 4.72 4.72RC1 etc |
| 289 | |
| 290 | =head1 AUTHOR |
| 291 | |
| 292 | Nigel Metheringham <Nigel.Metheringham@dev.intechnology.co.uk> |
| 293 | |
| 294 | =head1 COPYRIGHT |
| 295 | |
| 296 | Copyright 2010 Exim Maintainers. All rights reserved. |
| 297 | |
| 298 | =cut |