|
|
WAM --The Weighted Average Method for Predicting the Performance of Systems with Burs
|
|
Method::Signatures::Modifiers(3pm) User Contributed Perl Documentation Method::Signatures::Modifiers(3pm) NAME
Method::Signatures::Modifiers - use Method::Signatures from within MooseX::Declare SYNOPSIS
use MooseX::Declare; use Method::Signatures::Modifiers; class Foo { method bar (Int $thing) { # this method is declared with Method::Signatures instead of MooseX::Method::Signatures } } # -- OR -- use MooseX::Declare; class My::Declare extends MooseX::Declare { use Method::Signatures::Modifiers; } # ... later ... use My::Declare; class Fizz { method baz (Int $thing) { # this method also declared with Method::Signatures instead of MooseX::Method::Signatures } } DESCRIPTION
Allows you to use Method::Signatures from within MooseX::Declare, both for the "method" keyword and also for any method modifiers ("before", "after", "around", "override", and "augment"). Typically method signatures within MooseX::Declare are provided by MooseX::Method::Signatures. Using Method::Signatures instead provides several advantages: o MooseX::Method::Signatures has a known bug with Perl 5.12.x which does not plague Method::Signatures. o Method::Signatures may provide substantially better performance when calling methods, depending on your circumstances. o Method::Signatures error messages are somewhat easier to read (and can be overridden more easily). However, Method::Signatures cannot be considered a drop-in replacement for MooseX::Method::Signatures. Specifically, the following features of MooseX::Method::Signatures are not available to you (or work differently) if you substitute Method::Signatures: Types for Invocants MooseX::Method::Signatures allows code such as this: method foo (ClassName $class: Int $bar) { } Method::Signatures does not allow you to specify a type for the invocant, so your code would change to: method foo ($class: Int $bar) { } "where" Constraints MooseX::Method::Signatures allows code like this: # only allow even integers method foo (Int $bar where { $_ % 2 == 0 }) { } Method::Signatures does not currently allow this, although it is a planned feature for a future release. Parameter Aliasing (Labels) MooseX::Method::Signatures allows code like this: # call this as $obj->foo(bar => $baz) method foo (Int :bar($baz)) { } This feature is not currently planned for Method::Signatures. Placeholders MooseX::Method::Signatures allows code like this: method foo (Int $bar, $, Int $baz)) { # second parameter not available as a variable here } This feature is not currently planned for Method::Signatures. Traits In MooseX::Method::Signatures, "does" is a synonym for "is". Method::Signatures does not honor this. Method::Signatures supports several traits that MooseX::Method::Signatures does not. MooseX::Method::Signatures supports the "coerce" trait. Method::Signatures does not currently support this, although it is a planned feature for a future release, potentially using the "does coerce" syntax. BUGS, CAVEATS and NOTES Note that although this module causes all calls to MooseX::Method::Signatures from within MooseX::Declare to be completely replaced by calls to Method::Signatures (or calls to Method::Signatures::Modifiers), MooseX::Method::Signatures is still loaded by MooseX::Declare. It's just never used. The "compile_at_BEGIN" flag to Method::Signatures is ignored by Method::Signatures::Modifiers. This is because parsing at compile-time can cause method modifiers to be added before the methods they are modifying are composed into the Moose classes. Parsing of methods at run- time is compatible with MooseX::Method::Signatures. THANKS
This code was written by Buddy Burden (barefootcoder). The import code for replacing MooseX::Method::Signatures is based on a suggestion from Nick Perez. LICENSE
Copyright 2011 by Michael G Schwern <schwern@pobox.com>. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See http://www.perl.com/perl/misc/Artistic.html SEE ALSO
MooseX::Declare, Method::Signatures, MooseX::Method::Signatures. perl v5.14.2 2012-06-03 Method::Signatures::Modifiers(3pm)
