John Napiorkowski > CatalystX-Declare-0.015 > CatalystX::Declare::Keyword::Application

Download:
CatalystX-Declare-0.015.tar.gz

Dependencies

Annotate this POD

Website

CPAN RT

New  2
Open  1
View/Report Bugs
Source  

NAME ^

CatalystX::Declare::Keyword::Application - Declare Catalyst Application Classes

SYNOPSIS ^

    use CatalystX::Declare;

    application MyApp::Web
           with Static::Simple
           with ConfigLoader {

        $CLASS->config(name => 'My App');

        method debug_timestamp {
            $self->log->debug('Timestamp: ' . time)
                if $self->debug;
        }
    }

DESCRIPTION ^

This module provides a keyword handler for the application keyword. It is an extension of "class" in MooseX::Declare. The role application mechanism behind the with specification is hijacked and the arguments are passed to Catalyst's setup method. This hijacking is proably going away someday since in the future plugins will be actual roles.

You don't have to call the setup method yourself, this will be done by the handler after the body has been run.

SUPERCLASSES ^

MooseX::Declare::Syntax::Keyword::Class

METHODS ^

auto_make_immutable

    Bool Object->auto_make_immutable ()

A modified method that returns 0 to signal to MooseX::Declare that it should not make this class immutable. Currently, making application classes immutable isn't supported yet, therefore is mutable is currently a no-op. This will likely change as soon as application classes can be made immutable,

context_traits

    List[ClassName] Object->context_traits ()

This extends the remaining context traits with CatalystX::Declare::Context::AppSetup to manage calls to "MyApp->setup" in Catalyst.

add_with_option_customizations

    Object->add_with_option_customizations (
        Object   $ctx, 
        Str      $package,
        ArrayRef $plugins,
        HashRef  $options
    )

This will prepare "MyApp->setup" in Catalyst to be called with the list of plugins that were specified as roles.

add_namespace_customizations

    Object->add_namespace_customizations (Object $ctx, Str $package)

This will prepare Catalyst as a parent and import CLASS into the application's namespace before the other customizations are run.

add_optional_customizations

    Object->add_optional_customizations (Object $ctx, Str $package)

After all customizations have been done, this modifier will push a call to "MyApp->setup" in Catalyst if this wasn't already done by the plugin specifications.

SEE ALSO ^

CatalystX::Declare
"class" in MooseX::Declare
MooseX::Declare::Syntax::Keyword::Class

AUTHOR ^

See "AUTHOR" in CatalystX::Declare for author information.

LICENSE ^

This program is free software; you can redistribute it and/or modify it under the same terms as perl itself.

syntax highlighting: