move repository to http://github.com/moose/MooseX-AlwaysCoerce

[gitmo/MooseX-AlwaysCoerce.git] / lib / MooseX / AlwaysCoerce.pm

diff --git a/lib/MooseX/AlwaysCoerce.pm b/lib/MooseX/AlwaysCoerce.pm
index 6ab536e..5ea5559 100644 (file)
--- a/lib/MooseX/AlwaysCoerce.pm
+++ b/lib/MooseX/AlwaysCoerce.pm
@@ -1,19 +1,21 @@
 package MooseX::AlwaysCoerce;
+# ABSTRACT: Automatically enable coercions for Moose attributes
 
 use strict;
 use warnings;
 
-=head1 NAME
+use namespace::autoclean 0.12;
+use Moose ();
+use MooseX::ClassAttribute 0.24 ();
+use Moose::Exporter;
+use Moose::Util::MetaRole;
+use Carp;
 
-MooseX::AlwaysCoerce - Automatically enable coercions for Moose attributes
+Moose::Exporter->setup_import_methods;
 
-=head1 VERSION
+=pod
 
-Version 0.01
-
-=cut
-
-our $VERSION = '0.01';
+=for stopwords coercions
 
 =head1 SYNOPSIS
 
@@ -23,11 +25,92 @@ our $VERSION = '0.01';
     use MooseX::AlwaysCoerce;
     use MyTypeLib 'SomeType';
 
-    has foo => (is => 'rw', isa => SomeType); # will be coerced
+    has foo => (is => 'rw', isa => SomeType); # coerce => 1 automatically added
+
+    # same, MooseX::ClassAttribute is automatically applied
+    class_has bar => (is => 'rw', isa => SomeType);
+
+=head1 DESCRIPTION
+
+Have you ever spent an hour or more trying to figure out "Hey, why did my
+coercion not run?" only to find out that you forgot C<< coerce => 1 >> ?
+
+Just load this module in your L<Moose> class and C<< coerce => 1 >> will be
+enabled for every attribute and class attribute automatically.
+
+Use C<< coerce => 0 >> to disable a coercion explicitly.
+
+=cut
+
+{
+    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;
+    };
 
-=head1 AUTHOR
+    package MooseX::AlwaysCoerce::Role::Meta::Class;
+    use namespace::autoclean;
+    use Moose::Role;
+    use Moose::Util::TypeConstraints;
 
-Rafael Kitover, C<< <rkitover at cpan.org> >>
+    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;
+# vim:et sts=4 sw=4 tw=0:
+__END__
+
+=for Pod::Coverage
+    init_meta
 
 =head1 BUGS
 
@@ -45,6 +128,8 @@ You can find more information at:
 
 L<http://rt.cpan.org/NoAuth/Bugs.html?Dist=MooseX-AlwaysCoerce>
 
+=for stopwords AnnoCPAN
+
 =item * AnnoCPAN: Annotated CPAN documentation
 
 L<http://annocpan.org/dist/MooseX-AlwaysCoerce>
@@ -63,13 +148,8 @@ L<http://search.cpan.org/dist/MooseX-AlwaysCoerce/>
 
 My own stupidity, for inspiring me to write this module.
 
-=head1 COPYRIGHT & LICENSE
-
-Copyright (c) 2009 Rafael Kitover
+=for stopwords Rolsky
 
-This program is free software; you can redistribute it and/or modify it
-under the same terms as Perl itself.
+Dave Rolsky, for telling me how to do it the L<Moose> way.
 
 =cut
-
-1; # End of MooseX::AlwaysCoerce