| 1 | package Terse::Plugin; | ||
| 2 | |||
| 3 | use strict; | ||
| 4 | use warnings; | ||
| 5 | |||
| 6 | use base 'Terse'; | ||
| 7 | |||
| 8 | sub new { | ||
| 9 | my ($pkg, @args) = @_; | ||
| 10 | my $self = $pkg->SUPER::new(@args); | ||
| 11 | my ($namespace) = $pkg =~ m/([^:]+)$/; | ||
| 12 | $self->namespace = lc( $namespace ); | ||
| 13 | $self->build_plugin($self->app_config) if ($self->can('build_plugin')); | ||
| 14 | return $self; | ||
| 15 | } | ||
| 16 | |||
| 17 | sub connect { | ||
| 18 | return $_[0]; | ||
| 19 | } | ||
| 20 | |||
| 21 | 1; | ||
| 22 | |||
| 23 | =head1 NAME | ||
| 24 | |||
| 25 | Terse::Plugin - plugins made simple. | ||
| 26 | |||
| 27 | =head1 VERSION | ||
| 28 | |||
| 29 | Version 0.28 | ||
| 30 | |||
| 31 | =cut | ||
| 32 | |||
| 33 | =head1 SYNOPSIS | ||
| 34 | |||
| 35 | package My::App::Plugin::ValidateParam; | ||
| 36 | |||
| 37 | use base 'Terse::Plugin'; | ||
| 38 | |||
| 39 | sub az { | ||
| 40 | my ($self, $param) = @_; | ||
| 41 | return 0 if ref $param; | ||
| 42 | return $param =~ m/^[a-z]+$/i; | ||
| 43 | } | ||
| 44 | |||
| 45 | 1; | ||
| 46 | |||
| 47 | ... If using Terse::App | ||
| 48 | |||
| 49 | package My::App; | ||
| 50 | |||
| 51 | use base 'Terse::App'; | ||
| 52 | |||
| 53 | sub build_app { | ||
| 54 | $_[0]->response_view = 'pretty'; # default all requests to use this view. | ||
| 55 | } | ||
| 56 | |||
| 57 | sub auth { | ||
| 58 | shift; | ||
| 59 | unless ($_[0]->plugin('validateparam')->az($_[0]->params->name)) { | ||
| 60 | $_[0]->raiseError('param name contains more than just A-Z'); | ||
| 61 | return 0; | ||
| 62 | } | ||
| 63 | return $_[0]->controller('admin/auth')->authenticate(@_); | ||
| 64 | } | ||
| 65 | |||
| 66 | ... else | ||
| 67 | |||
| 68 | package MyApp; | ||
| 69 | |||
| 70 | use base 'Terse::Controller'; | ||
| 71 | |||
| 72 | use MyAppPlugin; | ||
| 73 | |||
| 74 | sub build_controller { | ||
| 75 | $_[0]->plugins->validate = MyAppPlugin->new(); | ||
| 76 | } | ||
| 77 | |||
| 78 | sub overview :get { | ||
| 79 | unless ($_[1]->plugin('validate')->az($_[1]->params->name)) { | ||
| 80 | $_[1]->raiseError('param name contains more than just A-Z', 400); | ||
| 81 | return 0; | ||
| 82 | } | ||
| 83 | $_[1]->response->data = $_[1]->model('data')->do_something(); | ||
| 84 | } | ||
| 85 | |||
| 86 | |||
| 87 | =cut | ||
| 88 | |||
| 89 | =head1 AUTHOR | ||
| 90 | |||
| 91 | LNATION, C<< <email at lnation.org> >> | ||
| 92 | |||
| 93 | =head1 LICENSE AND COPYRIGHT | ||
| 94 | |||
| 95 | L<Terse>. | ||
| 96 | |||
| 97 | =cut | ||
| 98 |