File Coverage

blib/lib/BLAH/Role/Authorization.pm

Criterion	Covered	Total	%
statement	6	6	100.0
branch			n/a
condition			n/a
subroutine	2	2	100.0
pod			n/a
total	8	8	100.0

line	stmt	sub	time	code
1				#
2				# This file is part of BLAH
3				#
4				# This software is Copyright (c) 2015 by Chris Weyl.
5				#
6				# This is free software, licensed under:
7				#
8				# The GNU Lesser General Public License, Version 2.1, February 1999
9				#
10				package BLAH::Role::Authorization;
11				our $AUTHORITY = 'cpan:RSRCHBOY';
12				$BLAH::Role::Authorization::VERSION = '0.001'; # TRIAL
13				# ABSTRACT: BLAH base authorization role
14
15	2	2	346595	use Moose::Role;
	2		168736
	2		12
16	2	2	11004	use namespace::autoclean 0.24;
	2		7798
	2		11
17
18
19				requires 'callable';
20
21				!!42;
22
23				__END__
24
25				=pod
26
27				=encoding UTF-8
28
29				=for :stopwords Chris Weyl
30
31				=for :stopwords Wishlist flattr flattr'ed gittip gittip'ed
32
33				=head1 NAME
34
35				BLAH::Role::Authorization - BLAH base authorization role
36
37				=head1 VERSION
38
39				This document describes version 0.001 of BLAH::Role::Authorization - released August 26, 2015 as part of BLAH.
40
41				=head1 SYNOPSIS
42
43				=head1 DESCRIPTION
44
45				A BLAH class exhibits this trait to indicate that it can tell you if it
46				believes you should be able to invoke it -- that is, if you are authorized to
47				call the C<execute()> method.
48
49				=head1 REQUIRED METHODS
50
51				=head2 callable
52
53				A BLAH authenticator role must implement the callable method.
54
55				Returns true if the authorizing authority determines that the BLAH (that is,
56				C<execute()>) may be called.
57
58				("Called by what" is left as an exercise for the implementer.)
59
60				=head1 SEE ALSO
61
62				Please see those modules/websites for more information related to this module.
63
64				=over 4
65
66				=item *
67
68				L<BLAH\|BLAH>
69
70				=item *
71
72				L<BLAH\|BLAH>
73
74				=back
75
76				=head1 BUGS
77
78				Please report any bugs or feature requests on the bugtracker website
79				https://github.com/RsrchBoy/blah/issues
80
81				When submitting a bug or request, please include a test-file or a
82				patch to an existing test-file that illustrates the bug or desired
83				feature.
84
85				=head1 AUTHOR
86
87				Chris Weyl <cweyl@alumni.drew.edu>
88
89				=head2 I'm a material boy in a material world
90
91				=begin html
92
93				<a href="https://gratipay.com/RsrchBoy/"><img src="http://img.shields.io/gratipay/RsrchBoy.svg" /></a>
94				<a href="http://bit.ly/rsrchboys-wishlist"><img src="http://wps.io/wp-content/uploads/2014/05/amazon_wishlist.resized.png" /></a>
95				<a href="https://flattr.com/submit/auto?user_id=RsrchBoy&url=https%3A%2F%2Fgithub.com%2FRsrchBoy%2Fblah&title=RsrchBoy's%20CPAN%20BLAH&tags=%22RsrchBoy's%20BLAH%20in%20the%20CPAN%22"><img src="http://api.flattr.com/button/flattr-badge-large.png" /></a>
96
97				=end html
98
99				Please note B<I do not expect to be gittip'ed or flattr'ed for this work>,
100				rather B<it is simply a very pleasant surprise>. I largely create and release
101				works like this because I need them or I find it enjoyable; however, don't let
102				that stop you if you feel like it ;)
103
104				L<Flattr\|https://flattr.com/submit/auto?user_id=RsrchBoy&url=https%3A%2F%2Fgithub.com%2FRsrchBoy%2Fblah&title=RsrchBoy's%20CPAN%20BLAH&tags=%22RsrchBoy's%20BLAH%20in%20the%20CPAN%22>,
105				L<Gratipay\|https://gratipay.com/RsrchBoy/>, or indulge my
106				L<Amazon Wishlist\|http://bit.ly/rsrchboys-wishlist>... If and only if you so desire.
107
108				=head1 COPYRIGHT AND LICENSE
109
110				This software is Copyright (c) 2015 by Chris Weyl.
111
112				This is free software, licensed under:
113
114				The GNU Lesser General Public License, Version 2.1, February 1999
115
116				=cut