Module::Install::Catalyst(3p)

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.