MooseX::AlwaysCoerce - Automatically enable coercions for Moose attributes


MooseX-AlwaysCoerce documentation Contained in the MooseX-AlwaysCoerce distribution.

Index


Code Index:

NAME

Top

MooseX::AlwaysCoerce - Automatically enable coercions for Moose attributes

VERSION

Top

Version 0.16

SYNOPSIS

Top

    package MyClass;

    use Moose;
    use MooseX::AlwaysCoerce;
    use MyTypeLib 'SomeType';

    has foo => (is => 'rw', isa => SomeType); # coerce => 1 automatically added

    # same, MooseX::ClassAttribute is automatically applied
    class_has bar => (is => 'rw', isa => SomeType);

DESCRIPTION

Top

Have you ever spent an hour or more trying to figure out "WTF, why did my coercion not run?" only to find out that you forgot coerce => 1 ?

Just load this module in your Moose class and coerce => 1 will be enabled for every attribute and class attribute automatically.

Use coerce => 0 to disable a coercion explicitly.

AUTHOR

Top

Rafael Kitover, <rkitover at cpan.org>

CONTRIBUTORS

Top

Schwern: Michael G. Schwern <mschwern@cpan.org> Ether: Karen Etheridge <ether@cpan.org>

BUGS

Top

Please report any bugs or feature requests to bug-moosex-alwayscoerce at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=MooseX-AlwaysCoerce. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

Top

You can find more information at:

* RT: CPAN's request tracker

http://rt.cpan.org/NoAuth/Bugs.html?Dist=MooseX-AlwaysCoerce

* AnnoCPAN: Annotated CPAN documentation

http://annocpan.org/dist/MooseX-AlwaysCoerce

* CPAN Ratings

http://cpanratings.perl.org/d/MooseX-AlwaysCoerce

* Search CPAN

http://search.cpan.org/dist/MooseX-AlwaysCoerce/

ACKNOWLEDGEMENTS

Top

My own stupidity, for inspiring me to write this module.

Dave Rolsky, for telling me how to do it the Moose way.

COPYRIGHT & LICENSE

Top


MooseX-AlwaysCoerce documentation Contained in the MooseX-AlwaysCoerce distribution.
package MooseX::AlwaysCoerce;

use strict;
use warnings;

use namespace::autoclean;
use Moose ();
use MooseX::ClassAttribute ();
use Moose::Exporter;
use Moose::Util::MetaRole;
use Carp;

Moose::Exporter->setup_import_methods;

our $VERSION = '0.16';

{
    package MooseX::AlwaysCoerce::Role::Meta::Attribute;
    use namespace::autoclean;
    use Moose::Role;

    around should_coerce => sub {
        my $orig = shift;
        my $self = shift;

        my $current_val = $self->$orig(@_);

        return $current_val if defined $current_val;

        return 1 if $self->type_constraint && $self->type_constraint->has_coercion;
        return 0;
    };

    package MooseX::AlwaysCoerce::Role::Meta::Class;
    use namespace::autoclean;
    use Moose::Role;
    use Moose::Util::TypeConstraints;

    around add_class_attribute => sub {
        my $next = shift;
        my $self = shift;
        my ($what, %opts) = @_;

        if (exists $opts{isa}) {
            my $type = Moose::Util::TypeConstraints::find_or_parse_type_constraint($opts{isa});
            $opts{coerce} = 1 if not exists $opts{coerce} and $type->has_coercion;
        }

        $self->$next($what, %opts);
    };
}

my (undef, undef, $init_meta) = Moose::Exporter->build_import_methods(

    install => [ qw(import unimport) ],

    class_metaroles => {
        attribute   => ['MooseX::AlwaysCoerce::Role::Meta::Attribute'],
        class       => ['MooseX::AlwaysCoerce::Role::Meta::Class'],
    },

    role_metaroles => {
        (Moose->VERSION >= 1.9900
            ? (applied_attribute => ['MooseX::AlwaysCoerce::Role::Meta::Attribute'])
            : ()),
        role                => ['MooseX::AlwaysCoerce::Role::Meta::Class'],
    }
);

sub init_meta {
    my ($class, %options) = @_;
    my $for_class = $options{for_class};

    MooseX::ClassAttribute->import({ into => $for_class });

    # call generated method to do the rest of the work.
    goto $init_meta;
}

1; # End of MooseX::AlwaysCoerce
# vim:et sts=4 sw=4 tw=0: