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