NAME

MooseX::Declare::Syntax::MooseSetup - Common Moose namespaces declarations

DESCRIPTION

This role is basically an extension to NamespaceHandling. It adds all the common parts for Moose namespace definitions. Examples of this role can be found in the class and role keywords.

METHODS

auto_make_immutable

Bool Object->auto_make_immutable ()

Since Moose::Roles can't be made immutable (this is not a bug or a missing feature, it would make no sense), this always returns false.

imported_moose_symbols

List Object->imported_moose_symbols ()

This will return confess and blessed by default to provide as additional imports to the namespace.

import_symbols_from

Str Object->import_symbols_from ()

The namespace from which the additional imports will be imported. This will return Moose by default.

CONSUMES

MODIFIED METHODS

default_inner

ArrayRef default_inner ()

This will provide the following default inner-handlers to the namspace:

  • method

    A simple Method handler.

  • around

    This is a MethodModifier handler that will start the signature of the generated method with $orig: $self to provide the original method in $orig.

  • after

  • before

  • override

  • augment

    These four handlers are MethodModifier instances.

  • clean

    This is an instance of the Clean keyword handler.

The original method will never be called and all arguments are ignored at the moment.

setup_inner_for

Object->setup_inner_for (ClassName $class)

This will install a with function that will push its arguments onto a global storage array holding the roles of the current namespace.

add_namespace_customizations

Object->add_namespace_customizations (Object $context, Str $package, HashRef $options)

After all other customizations, this will first add code to import the "imported_moose_symbols" from the package returned in "import_symbols_from" to the preamble.

Then it will add a code part that will immutabilize the class to the cleanup code if the "auto_make_immutable" method returned a true value and $options-{is}{mutable}> does not exist.

handle_post_parsing

CodeRef Object->handle_post_parsing (Object $context, Str $package, Str|Object $name)

Generates a callback that sets up the roles in the global role storage for the current namespace. The $name parameter will be the specified name (in contrast to $package which will always be the fully qualified name) or the anonymous metaclass instance if none was specified.

SEE ALSO

AUTHORS

  • Florian Ragwitz <rafl@debian.org>

  • Ash Berlin <ash@cpan.org>

  • Chas. J. Owens IV <chas.owens@gmail.com>

  • Chris Prather <chris@prather.org>

  • Dave Rolsky <autarch@urth.org>

  • Devin Austin <dhoss@cpan.org>

  • Hans Dieter Pearcey <hdp@cpan.org>

  • Justin Hunter <justin.d.hunter@gmail.com>

  • Matt Kraai <kraai@ftbfs.org>

  • Michele Beltrame <arthas@cpan.org>

  • Nelo Onyiah <nelo.onyiah@gmail.com>

  • nperez <nperez@cpan.org>

  • Piers Cawley <pdcawley@bofh.org.uk>

  • Rafael Kitover <rkitover@io.com>

  • Robert 'phaylon' Sedlacek <rs@474.at>

  • Stevan Little <stevan.little@iinteractive.com>

  • Tomas Doran <bobtfish@bobtfish.net>

  • Yanick Champoux <yanick@babyl.dyndns.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Florian Ragwitz.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.