1 package Module::Install::Catalyst;
6 require Module::Install::Base;
7 @ISA = qw/Module::Install::Base/;
11 use File::Copy::Recursive 'rcopy';
17 qw/Build Build.PL Changes MANIFEST META.yml Makefile.PL Makefile README
18 _build blib lib script t inc .*\.svn \.git _darcs \.bzr \.hg
19 debian build-stamp install-stamp configure-stamp/;
29 Module::Install::Catalyst - Module::Install extension for Catalyst
33 use inc::Module::Install;
36 all_from 'lib/MyApp.pm';
38 requires 'Catalyst::Runtime' => '5.7014';
40 catalyst_ignore('.*temp');
41 catalyst_ignore('.*tmp');
47 L<Module::Install> extension for Catalyst.
53 Calls L<catalyst_files> and L<catalyst_par>. Should be the last catalyst*
54 command called in C<Makefile.PL>.
61 *** Module::Install::Catalyst
63 $self->catalyst_files;
66 *** Module::Install::Catalyst finished.
72 Collect a list of all files a Catalyst application consists of and copy it
73 inside the blib/lib/ directory. Files and directories that match the modules
74 ignore list are excluded (see L<catalyst_ignore> and L<catalyst_ignore_all>).
85 CATFILES: for my $name ( readdir CATDIR ) {
86 for my $ignore (@IGNORE) {
87 next CATFILES if $name =~ /^$ignore$/;
88 next CATFILES if $name !~ /\w/;
93 my @path = split '-', $self->name;
94 for my $orig (@files) {
95 my $path = File::Spec->catdir( 'blib', 'lib', @path, $orig );
96 rcopy( $orig, $path );
100 =head2 catalyst_ignore_all(\@ignore)
102 This function replaces the built-in default ignore list with the given list.
106 sub catalyst_ignore_all {
107 my ( $self, $ignore ) = @_;
111 =head2 catalyst_ignore(\@ignore)
113 Add a regexp to the list of ignored patterns. Can be called multiple times.
117 sub catalyst_ignore {
118 my ( $self, @ignore ) = @_;
119 push @IGNORE, @ignore;
122 =head2 catalyst_par($name)
126 # Workaround for a namespace conflict
128 my ( $self, $par ) = @_;
132 my $name = $self->name;
135 my $class_string = join "', '", @CLASSES;
136 $class_string = "'$class_string'" if $class_string;
137 $self->postamble(<<EOF);
139 \t\$(NOECHO) \$(PERL) -Ilib -Minc::Module::Install -MModule::Install::Catalyst -e"Catalyst::Module::Install::_catalyst_par( '$par', '$name', { CLASSES => [$class_string], CORE => $CORE, ENGINE => '$ENGINE', MULTIARCH => $MULTIARCH, SCRIPT => '$SCRIPT', USAGE => q#$usage# } )"
142 Please run "make catalyst_par" to create the PAR package!
146 =head2 catalyst_par_core($core)
150 sub catalyst_par_core {
151 my ( $self, $core ) = @_;
152 $core ? ( $CORE = $core ) : $CORE++;
155 =head2 catalyst_par_classes(@clases)
159 sub catalyst_par_classes {
160 my ( $self, @classes ) = @_;
161 push @CLASSES, @classes;
164 =head2 catalyst_par_engine($engine)
168 sub catalyst_par_engine {
169 my ( $self, $engine ) = @_;
173 =head2 catalyst_par_multiarch($multiarch)
177 sub catalyst_par_multiarch {
178 my ( $self, $multiarch ) = @_;
179 $multiarch ? ( $MULTIARCH = $multiarch ) : $MULTIARCH++;
182 =head2 catalyst_par_script($script)
186 sub catalyst_par_script {
187 my ( $self, $script ) = @_;
191 =head2 catalyst_par_usage($usage)
195 sub catalyst_par_usage {
196 my ( $self, $usage ) = @_;
200 package Catalyst::Module::Install;
204 use File::Copy::Recursive 'rmove';
208 my ( $par, $class_name, $opts ) = @_;
210 my $ENGINE = $opts->{ENGINE};
211 my $CLASSES = $opts->{CLASSES} || [];
212 my $USAGE = $opts->{USAGE};
213 my $SCRIPT = $opts->{SCRIPT};
214 my $MULTIARCH = $opts->{MULTIARCH};
215 my $CORE = $opts->{CORE};
217 my $name = $class_name;
220 $par ||= "$name.par";
221 my $engine = $ENGINE || 'CGI';
225 die "Please install PAR\n" if $@;
226 eval "use PAR::Packer ()";
227 die "Please install PAR::Packer\n" if $@;
228 eval "use App::Packer::PAR ()";
229 die "Please install App::Packer::PAR\n" if $@;
230 eval "use Module::ScanDeps ()";
231 die "Please install Module::ScanDeps\n" if $@;
233 my $root = $FindBin::Bin;
234 $class_name =~ s/-/::/g;
235 my $path = File::Spec->catfile( 'blib', 'lib', split( '::', $class_name ) );
237 unless ( -f $path ) {
238 print qq/Not writing PAR, "$path" doesn't exist\n/;
241 print qq/Writing PAR "$par"\n/;
242 chdir File::Spec->catdir( $root, 'blib' );
244 my $par_pl = 'par.pl';
247 my $version = $Catalyst::VERSION;
248 my $class = $class_name;
251 $classes .= " require $_;\n" for @$CLASSES;
255 my $usage = $USAGE || <<"EOF";
257 [parl] $name\[.par] [script] [arguments]
260 parl $name.par $name\_server.pl -r
264 my $script = $SCRIPT;
265 my $tmp_file = IO::File->new("> $par_pl ");
266 print $tmp_file <<"EOF";
267 if ( \$ENV{PAR_PROGNAME} ) {
268 my \$zip = \$PAR::LibCache{\$ENV{PAR_PROGNAME}}
269 || Archive::Zip->new(__FILE__);
270 my \$script = '$script';
271 \$ARGV[0] ||= \$script if \$script;
272 if ( ( \@ARGV == 0 ) || ( \$ARGV[0] eq '-h' ) || ( \$ARGV[0] eq '-help' )) {
273 my \@members = \$zip->membersMatching('.*script/.*\.pl');
274 my \$list = " Available scripts:\\n";
275 for my \$member ( \@members ) {
276 my \$name = \$member->fileName;
277 \$name =~ /(\\w+\\.pl)\$/;
279 next if \$name =~ /^main\.pl\$/;
280 next if \$name =~ /^par\.pl\$/;
281 \$list .= " \$name\\n";
288 my \$file = shift \@ARGV;
289 \$file =~ s/^.*[\\/\\\\]//;
290 \$file =~ s/\\.[^.]*\$//i;
291 my \$member = eval { \$zip->memberNamed("./script/\$file.pl") };
292 die qq/Can't open perl script "\$file"\n/ unless \$member;
293 PAR::_run_member( \$member, 1 );
298 \$ENV{CATALYST_ENGINE} = '$engine';
301 require Catalyst::Helper;
302 require Catalyst::Test;
303 require Catalyst::Engine::HTTP;
304 require Catalyst::Engine::CGI;
305 require Catalyst::Controller;
306 require Catalyst::Model;
307 require Catalyst::View;
308 require Getopt::Long;
317 local $SIG{__WARN__} = sub { };
318 open my $olderr, '>&STDERR';
319 open STDERR, '>', File::Spec->devnull;
324 'a' => [ grep( !/par.pl/, glob '.' ) ],
329 App::Packer::PAR->new(
330 frontend => 'Module::ScanDeps',
331 backend => 'PAR::Packer',
337 open STDERR, '>&', $olderr;
341 rmove( File::Spec->catfile( 'blib', $par ), $par );
347 Catalyst Contributors, see Catalyst.pm
351 This library is free software. You can redistribute it and/or modify it under
352 the same terms as Perl itself.