X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMooseX%2FGetopt%2FMeta%2FAttribute.pm;h=6a37acd32ac3cbf5c7c5bf15e6d11a64bbe7850c;hb=195fb408a61ad34e0e41887b4f9f8dc384dd5da5;hp=fdcc5ce47f70547fa91a45d35407d772b85efa96;hpb=3d9a716d3b164a29df44de04ceb99711c0583420;p=gitmo%2FMooseX-Getopt.git

diff --git a/lib/MooseX/Getopt/Meta/Attribute.pm b/lib/MooseX/Getopt/Meta/Attribute.pm
index fdcc5ce..6a37acd 100644
--- a/lib/MooseX/Getopt/Meta/Attribute.pm
+++ b/lib/MooseX/Getopt/Meta/Attribute.pm
@@ -1,67 +1,36 @@
+package MooseX::Getopt::Meta::Attribute;
+# ABSTRACT: Optional meta attribute for custom option names
 
-package ;
 use Moose;
 use Moose::Util::TypeConstraints;
 
-our $VERSION   = '0.02';
-our $AUTHORITY = 'cpan:STEVAN';
-
 extends 'Moose::Meta::Attribute'; # << Moose extending Moose :)
-
-has 'cmd_flag' => (
-    is        => 'rw',
-    isa       => 'Str',
-    predicate => 'has_cmd_flag',
-);
-
-# This subtype is to support scalar -> arrayref coercion
-#  without polluting the built-in types
-subtype '_MooseX_Getopt_CmdAliases'
-    => as 'ArrayRef'
-    => where { 1 };
-    
-coerce '_MooseX_Getopt_CmdAliases'
-    => from 'Str'
-        => via { [$_] };
-
-has 'cmd_aliases' => (
-    is        => 'rw',
-    isa       => '_MooseX_Getopt_CmdAliases',
-    predicate => 'has_cmd_aliases',
-    coerce    => 1,
-);
+   with 'MooseX::Getopt::Meta::Attribute::Trait';
 
 no Moose;
 
 # register this as a metaclass alias ...
-package Moose::Meta::Attribute::Custom::Getopt;
+package # stop confusing PAUSE
+    Moose::Meta::Attribute::Custom::Getopt;
 sub register_implementation { 'MooseX::Getopt::Meta::Attribute' }
 
 1;
 
-__END__
-
-=pod
-
-=head1 NAME
-
-MooseX::Getopt::Meta::Attribute - Optional meta attribute for custom option names
-
 =head1 SYNOPSIS
 
   package App;
   use Moose;
-  
+
   with 'MooseX::Getopt';
-  
+
   has 'data' => (
-      metaclass => 'MooseX::Getopt::Meta::Attribute',     
+      metaclass => ['Getopt'],
       is        => 'ro',
       isa       => 'Str',
       default   => 'file.dat',
 
-      # tells MooseX::Getopt to use --somedata as the 
-      # command line flag instead of the normal 
+      # tells MooseX::Getopt to use --somedata as the
+      # command line flag instead of the normal
       # autogenerated one (--data)
       cmd_flag  => 'somedata',
 
@@ -76,65 +45,44 @@ MooseX::Getopt::Meta::Attribute - Optional meta attribute for custom option name
 
 =head1 DESCRIPTION
 
-This is a custom attribute metaclass which can be used to specify a 
-the specific command line flag to use instead of the default one 
-which L<MooseX::Getopt> will create for you. 
+This is a custom attribute metaclass which can be used to specify a
+the specific command line flag to use instead of the default one
+which L<MooseX::Getopt> will create for you.
 
-This is certainly not the prettiest way to go about this, but for 
+This is certainly not the prettiest way to go about this, but for
 now it works for those who might need such a feature.
 
+=head2 Use 'traits' instead of 'metaclass'
+
+You should rarely need to explicitly set the attribute metaclass. It is much
+preferred to simply provide a trait (a role applied to the attribute
+metaclass), which allows other code to futher modify the attribute by applying
+additional roles.
+
+Therefore, you should first try to do this:
+
+  has 'foo' => (traits => ['Getopt'], cmd_flag => 'f');
+
 =head2 Custom Metaclass alias
 
-This now takes advantage of the Moose 0.19 feature to support 
+This now takes advantage of the Moose 0.19 feature to support
 custom attribute metaclass aliases. This means you can also
 use this as the B<Getopt> alias, like so:
 
   has 'foo' => (metaclass => 'Getopt', cmd_flag => 'f');
 
-=head1 METHODS
-
-These methods are of little use to most users, they are used interally 
-within L<MooseX::Getopt>.
-
-=over 4
-
-=item B<cmd_flag>
+=method B<cmd_flag>
 
 Changes the commandline flag to be this value, instead of the default,
 which is the same as the attribute name.
 
-=item B<cmd_aliases>
+=method B<cmd_aliases>
 
 Adds more aliases for this commandline flag, useful for short options
 and such.
 
-=item B<has_cmd_flag>
-
-=item B<has_cmd_aliases>
-
-=item B<meta>
-
-=back
-
-=head1 BUGS
-
-All complex software has bugs lurking in it, and this module is no 
-exception. If you find a bug please either email me, or add the bug
-to cpan-RT.
-
-=head1 AUTHOR
-
-Stevan Little E<lt>stevan@iinteractive.comE<gt>
-
-Brandon L. Black, E<lt>blblack@gmail.comE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2007 by Infinity Interactive, Inc.
-
-L<http://www.iinteractive.com>
+=method B<has_cmd_flag>
 
-This library is free software; you can redistribute it and/or modify
-it under the same terms as Perl itself.
+=method B<has_cmd_aliases>
 
 =cut