NAME

Module::Install::Catalyst - Module::Install extension for Catalyst

SYNOPSIS

use inc::Module::Install;

name 'MyApp';
all_from 'lib/MyApp.pm';

requires 'Catalyst::Runtime' => '5.7014';

catalyst_ignore('.*temp');
catalyst_ignore('.*tmp');
catalyst;
WriteAll;

DESCRIPTION

Module::Install extension for Catalyst.

METHODS

catalyst

Calls catalyst_files and catalyst_par. Should be the last catalyst* command called in Makefile.PL.

catalyst_files

Collect a list of all files a Catalyst application consists of and copy it inside the blib/lib/ directory. Files and directories that match the modules ignore list are excluded (see catalyst_ignore and catalyst_ignore_all).

catalyst_ignore_all(\@ignore)

This function replaces the built-in default ignore list with the given list.

catalyst_ignore(\@ignore)

Add a regexp to the list of ignored patterns. Can be called multiple times.

catalyst_par($name)

catalyst_par_core($core)

catalyst_par_classes(@clases)

catalyst_par_engine($engine)

catalyst_par_multiarch($multiarch)

catalyst_par_options($optstring)

This command can be used in Makefile.PL to customise the PAR creation process. The parameter "$optstring" contains a string with arguments in identical syntax as arguments of pp command from PAR::Packer package.

Example:

# part of your Makefile.PL

catalyst_par_options("--verbose=2 -f Bleach -z 9");
# verbose mode; use filter 'Bleach'; zip with compression level 9
catalyst;

Note1: There is no reason to use catalyst_par_options() command multiple times as you can spacify in "$optstring" as many options as you want. Still, it is supported to call catalyst_par_options() more than once. In that case the specified options are merged (collisions are handled on principle "later wins"). BEWARE: you are discouraged from using parameters -a -A -X -f -F -I -l -M in multiple catalyst_par_options() as they are not merged but replaced as you would expected.

Note2: By default the options "-x -p -o=<appname>.par" are set and option "-n" is unset. This default always overrides whatever you specify by catalyst_par_options().

catalyst_par_script($script)

catalyst_par_usage($usage)

AUTHORS

Catalyst Contributors, see Catalyst.pm

LICENSE

This library is free software. You can redistribute it and/or modify it under the same terms as Perl itself.