bionic (3) Moo::Role.3pm.gz

Provided by: libmoo-perl_2.003004-1_all bug

NAME
       Moo::Role - Minimal Object Orientation support for Roles


SYNOPSIS
         package My::Role;

         use Moo::Role;
         use strictures 2;

         sub foo { ... }

         sub bar { ... }

         has baz => (
           is => 'ro',
         );

         1;

       And elsewhere:

         package Some::Class;

         use Moo;
         use strictures 2;

         # bar gets imported, but not foo
         with('My::Role');

         sub foo { ... }

         1;


DESCRIPTION
       "Moo::Role" builds upon Role::Tiny, so look there for most of the documentation on how this works.  The
       main addition here is extra bits to make the roles more "Moosey;" which is to say, it adds "has".


IMPORTED SUBROUTINES
       See "IMPORTED SUBROUTINES" in Role::Tiny for all the other subroutines that are imported by this module.

   has
         has attr => (
           is => 'ro',
         );

       Declares an attribute for the class to be composed into.  See "has" in Moo for all options.


CLEANING UP IMPORTS
       Moo::Role cleans up its own imported methods and any imports declared before the "use Moo::Role"
       statement automatically.  Anything imported after "use Moo::Role" will be composed into consuming
       packages.  A package that consumes this role:

         package My::Role::ID;

         use Digest::MD5 qw(md5_hex);
         use Moo::Role;
         use Digest::SHA qw(sha1_hex);

         requires 'name';

         sub as_md5  { my ($self) = @_; return md5_hex($self->name);  }
         sub as_sha1 { my ($self) = @_; return sha1_hex($self->name); }

         1;

       ..will now have a "$self->sha1_hex()" method available to it that probably does not do what you expect.
       On the other hand, a call to "$self->md5_hex()" will die with the helpful error message: "Can't locate
       object method "md5_hex"".

       See "CLEANING UP IMPORTS" in Moo for more details.


SUPPORT
       See Moo for support and contact information.


AUTHORS
       See Moo for authors.


       See Moo for the copyright and license.