NAME

MooseX::AuthorizedMethods - Syntax sugar for authorized methods

SYNOPSIS

  package Foo::Bar;
  use MooseX::AuthorizedMethods; # includes Moose
  
  has user => (is => 'ro');
  
  authorized foo => ['foo'], sub {
     # this is going to happen only if the user has the 'foo' role
  };

DESCRIPTION

This method exports the "authorized" declarator that makes a verification if the user has the required permissions before the acual invocation. The default verification method will take the "user" method result and call "roles" to list the roles given to that user.

DECLARATOR

authorized $name => [qw(required permissions)], $code

This declarator will use the default verifier to check if the user has one of the given roles, it will die otherwise.

CUSTOM VERIFIERS

The default verifier used is MooseX::Meta::Method::Authorized::CheckRoles, you might send an additional "verifier" option to the declarator with another object or class. A verifier is simply a duck type with the "authorized_do" method that is called as:

  $verifier->authorized_do($method, $code, @_)

It is expected that the verifier code die if the user doesn't fulfill the authorization requests.

AUTHORS

Daniel Ruoso <daniel@ruoso.com>

COPYRIGHT AND LICENSE

Copyright 2010 by Daniel Ruoso et al

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