File Coverage

blib/lib/BLAH/Role/BLAH.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 bran cond sub pod 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::BLAH;
11             our $AUTHORITY = 'cpan:RSRCHBOY';
12             $BLAH::Role::BLAH::VERSION = '0.001'; # TRIAL
13             # ABSTRACT: A BLAH "command"
14              
15 2     2   360344 use Moose::Role;
  2         150190  
  2         14  
16 2     2   25665 use namespace::autoclean 0.24;
  2         7721  
  2         17  
17              
18              
19             requires 'execute';
20             requires 'name';
21              
22             !!42;
23              
24             __END__
25              
26             =pod
27              
28             =encoding UTF-8
29              
30             =for :stopwords Chris Weyl
31              
32             =for :stopwords Wishlist flattr flattr'ed gittip gittip'ed
33              
34             =head1 NAME
35              
36             BLAH::Role::BLAH - A BLAH "command"
37              
38             =head1 VERSION
39              
40             This document describes version 0.001 of BLAH::Role::BLAH - released August 26, 2015 as part of BLAH.
41              
42             =head1 DESCRIPTION
43              
44             Drink this if you're a BLAH -- that is, you implement a means to call your
45             application's business logic.
46              
47             =head1 REQUIRED METHODS
48              
49             =head2 execute
50              
51             This is the core of your BLAH. It should implement your command -- whether
52             embedded, a simple call/delegation to some other package, or hideously
53             complex -- in its entirety.
54              
55             C<execute()> should die on failure, and return otherwise.
56              
57             =head2 name
58              
59             The "name" of this BLAH. BLAH implementers are left to define this on their own,
60             but it is anticipated that the name here will be something like the package name with
61             a namespace prefix removed; e.g. if your BLAH namespace is "Organic::Produce::BLAH"
62             and the BLAH package is "Organic::Produce::BLAH::Relabel::Pesticides", then the BLAH name would be
63             -- surprise! -- "Relabel::Pesticides".
64              
65             =head1 SEE ALSO
66              
67             Please see those modules/websites for more information related to this module.
68              
69             =over 4
70              
71             =item *
72              
73             L<BLAH|BLAH>
74              
75             =back
76              
77             =head1 BUGS
78              
79             Please report any bugs or feature requests on the bugtracker website
80             https://github.com/RsrchBoy/blah/issues
81              
82             When submitting a bug or request, please include a test-file or a
83             patch to an existing test-file that illustrates the bug or desired
84             feature.
85              
86             =head1 AUTHOR
87              
88             Chris Weyl <cweyl@alumni.drew.edu>
89              
90             =head2 I'm a material boy in a material world
91              
92             =begin html
93              
94             <a href="https://gratipay.com/RsrchBoy/"><img src="http://img.shields.io/gratipay/RsrchBoy.svg" /></a>
95             <a href="http://bit.ly/rsrchboys-wishlist"><img src="http://wps.io/wp-content/uploads/2014/05/amazon_wishlist.resized.png" /></a>
96             <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>
97              
98             =end html
99              
100             Please note B<I do not expect to be gittip'ed or flattr'ed for this work>,
101             rather B<it is simply a very pleasant surprise>. I largely create and release
102             works like this because I need them or I find it enjoyable; however, don't let
103             that stop you if you feel like it ;)
104              
105             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>,
106             L<Gratipay|https://gratipay.com/RsrchBoy/>, or indulge my
107             L<Amazon Wishlist|http://bit.ly/rsrchboys-wishlist>... If and *only* if you so desire.
108              
109             =head1 COPYRIGHT AND LICENSE
110              
111             This software is Copyright (c) 2015 by Chris Weyl.
112              
113             This is free software, licensed under:
114              
115             The GNU Lesser General Public License, Version 2.1, February 1999
116              
117             =cut