=encoding utf8

=head1 NAME

Mojo::Role - Tiny and simple role system for Mojo

=head1 SYNOPSIS

  # role class
  package MojoCoreMantainer;
  use Mojo::Role;

  sub mantaining_mojo {
    say "I'm making improvements for Mojolicious..."
  }


  # base class
  package Developer;
  use Mojo::Base -base;

  sub make_code {
    say "I'm making code for Mojolicious ecosystem..."
  }


  # class
  package People;
  use Mojo::Base 'Developer';

  # using roles
  use Mojo::Role -with;
  with 'MojoCoreMantainer';

  # method
  sub what_can_i_do {
    my $self = shift;
    say "I can do people things...";
    $self->make_code;
    $self->mantaining_mojo;
  }


=head1 DESCRIPTION

This module provide a simple and light dependence way to use roles in
L<Mojolicious|http://mojolicious.org/> classes.

  # For a role class
  use Mojo::Role;

  # To use/consume a role
  use Mojo::Role -with;
  with 'Role::SomeRoleClass';


=head1 FUNCTIONS

Mojo::Role optionally exports a C<with> function, that can be imported with the C<-with> flag.
When exported the caller is not implementing a role but rather consuming them.

=head2 with

  with 'SomeRoleClass';

Import a role or a list of roles to use.


=head1 AUTHOR

Daniel Vinciguerra <daniel.vinciguerra at bivee.com.br>

=head1 CONTRIBUTORS

Joel Berger (jberger)

Matt S. Trout (mst)

=head1 COPYRIGHT AND LICENSE

Copyright (C) 2016, Daniel Vinciguerra and L</CONTRIBUTORS>.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.


=head1 SEE ALSO

L<https://github.com/kraih/mojo>, L<Mojo::Base>, L<Role::Tiny>, L<http://mojolicious.org>.


