blib/lib/POE/Component/PluginManager.pm

filter: Statementstmt 10.9% 23 / 210 Branchbran 0.0% 0 / 60 Conditioncond 0.0% 0 / 12 MC/DCmcdc 0.0% 0 / 5 Subroutinesub 21.4% 6 / 28 Podpod 0.0% 0 / 17 totaltotal 8.7% 29 / 332 CC 39 SCAR 31.0
CC
39
Cov
8%
add_plugin
56.0
new
42.0
remove_plugin
42.0
CRAP 22.3
↑ Summary
1 package POE::Component::PluginManager::PluginAPI;
2  
3 # this is the plugin API.
4 # i decided to put it in its own class
5 # so that nobody can mess up with calling
6 # the wrong methods.
7 # it also made the design somewhat clearer.
8 0 ▶sub new {
Subroutine new: not called CC=1 SCAR=6.9
9 0 my ( $class, $kernel, $alias ) = @_;
10 0 my $self = {};
11 0 $self->{kernel} = $kernel;
12 0 $self->{alias} = $alias;
13 0 bless $self, $class;
14 }
15  
16 0 ▶sub warning {
Subroutine warning: not called CC=1 SCAR=6.9
17 0 my $self = shift;
18 0 my $string = shift;
19 0 $self->{kernel}->post( $self->{alias}, 'plugin_warning', $string );
20  
21 # maybe i should rather use poe callbacks here?
22 }
23  
24 0 ▶sub error {
Subroutine error: not called CC=1 SCAR=6.9
25 0 my $self = shift;
26 0 my $ex = shift;
27 0 $self->{kernel}->post( $self->{alias}, 'plugin_error', $ex );
28 }
29  
30 package POE::Component::PluginManager;
31 1 our $VERSION = "0.67";
32  
33 1 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
34 1 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
35 1 ▶use POE;
Subroutine BEGIN: called CC=1 SCAR=0.0
36 1 ▶use Carp;
Subroutine BEGIN: called CC=1 SCAR=0.0
37 1 ▶use Data::Dumper;
Subroutine BEGIN: called CC=1 SCAR=0.0
38 1 ▶use Class::Unload;
Subroutine BEGIN: called CC=1 SCAR=0.0
39  
40 # we need this to unload classes, otherwise
41 # plugins can't be "reloaded". Maybe in the
42 # future there should be an option to disable
43 # this feature, so that PluginManager doesn't
44 # necesarily depend on this module.
45 # However, its just working fine for me, so far.
46  
47 1 my $pluginmanager_shutdown = 0;
48 1 my $DEBUG = 0;
49 1 my $alias;
50  
51 0 ▶sub debug {
Subroutine debug: not called CC=2 SCAR=17.9
Pod undocumented
52 0 ▶ print @_ if $DEBUG;
Branch: 1 branch
BranchTrueFalseTotal
if $DEBUG 0 0 0
53 }
54  
55 0 ▶sub new {
Subroutine new: not called CC=6 SCAR=37.4
Pod undocumented
56 0 my $type = shift;
57 0 ▶ if ( @_ & 1 ) {
Branch: 1 branch
BranchTrueFalseTotal
if (@_ & 1) 0 0 0
58 0 carp('PluginManager->new needs even number of options');
59 }
60 0 my %options = @_;
61  
62 0 ▶ if ( exists $options{'Alias'} ) { # the alias
Branch: 1 branch
BranchTrueFalseTotal
if (exists $options{'Alias'}) { } 0 0 0
63 0 $alias = $options{'Alias'};
64 0 delete $options{'Alias'};
65 }
66 else {
67 0 carp '[pluginmanager] Using default Alias \'pluginmanager\'';
68 0 $alias = 'pluginmanager';
69 }
70 0 ▶ if ( exists $options{'Debug'} ) { # debugging on/off
Branch: 1 branch
BranchTrueFalseTotal
if (exists $options{"Debug"}) 0 0 0
71 0 $DEBUG = $options{'Debug'};
72 0 delete $options{'Debug'};
73 }
74 0 ▶ if ( keys %options > 0 ) {
Branch: 1 branch
BranchTrueFalseTotal
if (keys %options > 0) 0 0 0
75 0 carp '[$alias]: Unrecognized options in new(): ' . join( ', ', keys %options );
76 }
77  
78 # Create a new session for ourself
79 POE::Session->create(
80  
81 # Our subroutines
82 0 ▶ 'inline_states' => {
Branch: 1 branch
BranchTrueFalseTotal
"POE::Session"->create("inline_states", {"_start", \&POE::Component::PluginManager::start, "_stop", \&POE::Component::PluginManager::stop, "_dump", \&POE::Component::PluginManager::_dump, "_generate_event", \&POE::Component::PluginManager::_generate_event, "_child", \&POE::Component::PluginManager::child, "shutdown", \&POE::Component::PluginManager::component_shutdown, "unload", \&POE::Component::PluginManager::unload_plugin, "load", \&POE::Component::PluginManager::load_plugin, "show_plugin_table", \&POE::Component::PluginManager::show_plugin_table, "register", \&POE::Component::PluginManager::register, "unregister", \&POE::Component::PluginManager::unregister, "unregister_all", \&POE::Component::PluginManager::unregister_all, "add_plugin", \&POE::Component::PluginManager::add_plugin, "remove_plugin", \&POE::Component::PluginManager::remove_plugin, "plugin_error", \&POE::Component::PluginManager::plugin_error, "plugin_warning", \&POE::Component::PluginManager::plugin_warning, "relayed_warning", \&POE::Component::PluginManager::relayed_warning}) or die "Unable to create a new session!" 0 0 0
83  
84 # Maintenance events
85 '_start' => \&start, # initial startup
86 '_stop' => \&stop, # cleanup, if needed
87 '_dump' => \&_dump, # for debugging purposes
88 '_generate_event' => \&_generate_event, # for broadcasting events
89 '_child' => \&child, # to catch _child events
90 'shutdown' => \&component_shutdown, # shuts down the component
91 'unload' => \&unload_plugin, # unload a plugin
92 'load' => \&load_plugin, # load a plugin.
93 'show_plugin_table' => \&show_plugin_table, # sends a hash
94 'register' => \&register, # registers your session
95 'unregister' => \&unregister, # unregisters your session
96 'unregister_all' => \&unregister_all, # unregisters all sessions.
97  
98 'add_plugin' => \&add_plugin, # internally used
99 'remove_plugin' => \&remove_plugin, # internally used
100 'plugin_error' => \&plugin_error, # internally used
101 'plugin_warning' => \&plugin_warning, # internally used
102 'relayed_warning'=> \&relayed_warning, # to delay warnings.
103 },
104 ) or die 'Unable to create a new session!';
105  
106 # Return success
107 0 return 1;
108 }
109  
110 0 ▶sub child {
Subroutine child: not called CC=3 SCAR=24.8
Pod undocumented
111 0 my ( $reason, $child, $return ) = @_[ ARG0 .. ARG2 ];
112 0 my $plugin_id = $child->ID();
113  
114 0 ▶ if ( $reason eq 'create' ) {
Branch: 2 branches
BranchTrueFalseTotal
if ($reason eq 'create') { } 0 0 0
elsif ($reason eq 'lose') { } 0 0 0
115  
116 # a new plugin session has been started.
117 0 POE::Kernel->yield( 'add_plugin', $plugin_id, $return );
118 }
119 elsif ( $reason eq 'lose' ) {
120  
121 # a plugin session has stopped
122 0 POE::Kernel->yield( 'remove_plugin', $plugin_id, $return );
123 }
124 }
125  
126 0 ▶sub start {
Subroutine start: not called CC=1 SCAR=6.9
Pod undocumented
127 0 debug( "[$alias] Plugin manager session has started. Alias: " . $alias . "\n" );
128 0 POE::Kernel->alias_set($alias);
129  
130 # make an alias, so that this session won't go away.
131 # maybe a feature for later versions: if no alias is specified, increase
132 # refcount and return session object.
133 0 my $plugin_api = POE::Component::PluginManager::PluginAPI->new( $_[KERNEL], $alias );
134  
135 # create the plugin API (seperate class)
136 0 $_[HEAP]->{plugin_api} = $plugin_api;
137  
138 }
139  
140 0 ▶sub stop {
Subroutine stop: not called CC=1 SCAR=6.9
Pod undocumented
141 0 debug "[$alias] plugin manager session stopped.\n";
142 }
143  
144 0 ▶sub add_plugin {
Subroutine add_plugin: not called CC=7 SCAR=40.3
Pod undocumented
145 0 my $plugin_id = $_[ARG0];
146 0 my $arguments = $_[ARG1];
147  
148 # a new plugin has come to life. register it to the plugin table.
149 0 ▶ my ( $name, $longname, $license, $version, $author ) = @{$arguments} unless ref($arguments) ne 'ARRAY';
Branch: 1 branch
BranchTrueFalseTotal
unless ref $arguments ne "ARRAY" 0 0 0
150 0 ▶ unless ( $name && $longname && $license && $version && $author ) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($name and $longname and $license and $version and $author) 0 0 0
Condition0%0/12
$name and $longname and $license and $version and $author
!ll&&!rl&&r
000
$name and $longname and $license and $version
!ll&&!rl&&r
000
$name and $longname and $license
!ll&&!rl&&r
000
$name and $longname
!ll&&!rl&&r
000
MC/DC0%0/5
$name and $longname and $license and $version and $author
$name $longname $license $version $author
Truth table0%0/6
A and B and C and D and E
A= $nameB= $longnameC= $licenseD= $versionE= $author
ABCDEresult
0XXXX0
10XXX0
110XX0
1110X0
111100
111111
151 0 warn "[$alias] $name did not correctly set all values (name, longname, license and version)";
152 0 POE::Kernel->yield( '_generate_event', 'plugin_invalid_values', $name );
153  
154 # if a plugin didn't specify at least the name correctly, we will not be able
155 # to unload it.
156 }
157 0 $_[HEAP]->{plugins}->{$name}->{id} = $plugin_id;
158 0 $_[HEAP]->{plugins}->{$name}->{longname} = $longname;
159 0 $_[HEAP]->{plugins}->{$name}->{license} = $license;
160 0 $_[HEAP]->{plugins}->{$name}->{version} = $version;
161 0 $_[HEAP]->{plugins}->{$name}->{author} = $author;
162 0 $_[HEAP]->{lookup}->{$plugin_id} = $name;
163  
164 # $_[HEAP]->{lookup} is a reverse lookup table for looking up plugin names by their ID
165 0 POE::Kernel->yield( '_generate_event', 'plugin_started', $name );
166 }
167  
168 0 ▶sub remove_plugin {
Subroutine remove_plugin: not called CC=6 SCAR=37.4
Pod undocumented
169 0 my $plugin_id = $_[ARG0];
170 0 my $quit_message = $_[ARG1];
171 0 my $name = $_[HEAP]->{lookup}->{$plugin_id};
172  
173 # a plugin has died away.
174 # $quit_message is the returned value, if any.
175 0 ▶ $quit_message = "quit" unless $quit_message;
Branch: 1 branch
BranchTrueFalseTotal
unless $quit_message 0 0 0
176 0 ▶ unless ($name) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($name) 0 0 0
177 0 warn "[$alias] WARNING: plugin $plugin_id unregistered, but the pluginmanager didn't knew about it.";
178 0 warn "[$alias] WARNING: this might have been caused by a plugin not registering correctly.";
179 }
180 0 delete $_[HEAP]->{plugins}->{$name};
181 0 delete $_[HEAP]->{lookup}->{$plugin_id};
182 0 Class::Unload->unload($name);
183  
184 # all of this pretty printing is a bit superfluous.
185 # remove it.
186 0 my $spaces = 34 - length($name);
187 0 my $spacer = " " x $spaces;
188 0 debug "[$alias] Plugin unloaded: $name$spacer Quitmsg: $quit_message\n";
189 0 POE::Kernel->yield( '_generate_event', 'plugin_unloaded', $name, $quit_message );
190  
191 #check if we want to shutdown
192 0 my $plugin_count = 0;
193 0 ▶ if ($pluginmanager_shutdown) {
Branch: 1 branch
BranchTrueFalseTotal
if ($pluginmanager_shutdown) 0 0 0
194 0 foreach ( keys %{ $_[HEAP]->{plugins} } ) {
195 0 $plugin_count++;
196 }
197 0 ▶ if ( $plugin_count == 0 ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($plugin_count == 0) { } 0 0 0
198  
199 # there are no plugins left, shutdown
200 # shut down component here: remove alias
201 0 POE::Kernel->alias_remove($alias);
202 0 POE::Kernel->yield( '_generate_event', 'plugin_manager_shutdown', $plugin_count );
203 0 POE::Kernel->yield("unregister_all");
204 }
205 else {
206 0 debug "[$alias] waiting for plugins to shut down. Remaining: $plugin_count\n";
207 0 POE::Kernel->yield( '_generate_event', 'plugin_waiting', $plugin_count );
208 }
209 }
210 }
211  
212 0 ▶sub load_plugin {
Subroutine load_plugin: not called CC=6 SCAR=37.4
Pod undocumented
213  
214 # loads a plugin, parameter: Classname (f.ex YourProgram::Plugins::Foobarplugin)
215 0 my $plugin = $_[ARG0];
216 0 my $data = $_[ARG1];
217 0 ▶ warn "[$alias] warning: no plugin name specified" unless $plugin;
Branch: 1 branch
BranchTrueFalseTotal
unless $plugin 0 0 0
218 0 my $classname = $plugin; # the classname equals the plugin name supplied
219 0 my $filename = $classname;
220 0 $filename =~ s#::#/#g;
221 0 $filename .= ".pm";
222 0 ▶ if ( $_[HEAP]->{plugins}->{$classname} ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($_[3]{"plugins"}{$classname}) 0 0 0
223 0 warn "[$alias] warning: plugin $classname already loaded!\n";
224 0 POE::Kernel->yield( '_generate_event', 'plugin_compile_failed', $classname, "plugin already loaded" );
225 0 return;
226 }
227  
228 #my $classname = ( split( /\./, $filename ) )[0];
229  
230 0 my $spaces = 40 - length($classname);
231 0 my $spacer = " " x $spaces;
232 0 my ( $name, $longname, $license, $version ); #name, longname, license, version (all strings)
233 0 debug "[$alias] loading $classname...$spacer compile: ";
234 # this makes the load_plugin signal re-entrant. Thanks to Tim Esselens for the patch.
235 0 ▶ if ($INC{$filename}) { delete $INC{$filename};
Branch: 1 branch
BranchTrueFalseTotal
if ($INC{$filename}) 0 0 0
236 0 debug "[$alias] class was still in \@INC, removing...\n";
237 };
238 0 eval { require $filename; };
239 0 ▶ if ($@) {
Branch: 1 branch
BranchTrueFalseTotal
if ($@) { } 0 0 0
240 0 debug "FAIL\n";
241 0 debug "[$alias] Error: $@\n";
242 0 POE::Kernel->yield( '_generate_event', 'plugin_compile_failed', $classname, $@ );
243 0 Class::Unload->unload($classname); # fixes the "attempt to reload $plugin" warnings
244 }
245 else {
246 0 debug "OK ";
247 0 debug "run: ";
248 0 eval { $classname->new( $_[HEAP]->{plugin_api}, $data ); };
249 0 ▶ if ($@) {
Branch: 1 branch
BranchTrueFalseTotal
if ($@) { } 0 0 0
250 0 debug "FAIL\n";
251 0 debug "[$alias] Error: $@\n";
252 0 POE::Kernel->yield( '_generate_event', 'plugin_init_failed', $classname, $@ );
253 0 Class::Unload->unload($classname);
254 }
255 else {
256 0 debug "OK\n";
257 }
258 }
259 }
260  
261 0 ▶sub unload_plugin {
Subroutine unload_plugin: not called CC=4 SCAR=30.0
Pod undocumented
262 0 my $plugin = $_[ARG0];
263 0 my $mode = $_[ARG1];
264 0 my $reason = $_[ARG2];
265  
266 # checking
267 0 ▶ warn "[$alias] warning: no plugin name specified" unless $plugin;
Branch: 1 branch
BranchTrueFalseTotal
unless $plugin 0 0 0
268 0 ▶ $mode = 'smart' unless $mode; # fallback to "smart" if no mode is specified
Branch: 1 branch
BranchTrueFalseTotal
unless $mode 0 0 0
269 0 ▶ if ( exists $_[HEAP]->{plugins}->{$plugin} ) {
Branch: 1 branch
BranchTrueFalseTotal
if (exists $_[3]{'plugins'}{$plugin}) { } 0 0 0
270 0 my $sid = $_[HEAP]->{plugins}->{$plugin}->{id};
271 0 POE::Kernel->post( $sid, 'shutdown', $mode, $reason );
272 }
273 else {
274 0 warn "[$alias] the plugin $plugin wasn't registered to the pluginmanager";
275 0 POE::Kernel->yield( '_generate_event', 'plugin_unload_failed', $plugin, "no such plugin" );
276 }
277 }
278  
279 0 ▶sub plugin_error {
Subroutine plugin_error: not called CC=2 SCAR=17.9
Pod undocumented
280  
281 # a plugin reported an error.
282 0 my $id = $_[SENDER]->ID();
283 0 my $name = $_[HEAP]->{lookup}->{$id};
284 0 ▶ $name = $id unless $name;
Branch: 1 branch
BranchTrueFalseTotal
unless $name 0 0 0
285  
286 # $name may be unspecified, if a plugin reports an error
287 # in _start, because the pluginmanager didn't have a chance
288 # to register the plugin yet. In this case, we simply return
289 # the session ID. Anyone interested could look up the corresponding
290 # plugin name in the plugin list later on.
291 0 my $error_hashref = $_[ARG0];
292 0 POE::Kernel->yield( '_generate_event', 'plugin_error', $name, $error_hashref );
293 }
294  
295 0 ▶sub plugin_warning {
Subroutine plugin_warning: not called CC=2 SCAR=17.9
Pod undocumented
296 0 my $id = $_[SENDER]->ID();
297 0 my $name = $_[HEAP]->{lookup}->{$id};
298 0 ▶ if(!$name){ # were delaying a bit
Branch: 1 branch
BranchTrueFalseTotal
unless ($name) 0 0 0
299 0 print "unresolved warning!\n";
300 0 $_[KERNEL]->yield('relayed_warning', $id, $_[ARG0]);
301 0 return 1;
302 }
303  
304 # see above, the same goes for warnings.
305 0 my $string = $_[ARG0];
306 0 POE::Kernel->yield( '_generate_event', 'plugin_warning', $name, $string );
307 }
308  
309 0 ▶sub relayed_warning { # a little helper function, that delays warnings until the _child
Subroutine relayed_warning: not called CC=2 SCAR=17.9
Pod undocumented
310 0 my $id = $_[ARG0]; # event had time to be dispatched
311 0 my $string = $_[ARG1];
312 0 my $name = $_[HEAP]->{lookup}->{$id};
313 0 ▶ $name = 'unresolved' unless $name;
Branch: 1 branch
BranchTrueFalseTotal
unless $name 0 0 0
314 0 POE::Kernel->yield( '_generate_event', 'plugin_warning', $name, $string );
315 }
316  
317 0 ▶sub _dump {
Subroutine _dump: not called CC=1 SCAR=6.9
318  
319 # for debugging purposes, outputting the plugin and the lookup table.
320 0 debug "[$alias] Dumping plugin table to STDOUT...\n";
321 0 debug Dumper $_[HEAP]->{plugins};
322 0 debug "[$alias] Dumping lookup table to STDOUT...\n";
323 0 debug Dumper $_[HEAP]->{lookup};
324 }
325  
326 0 ▶sub component_shutdown {
Subroutine component_shutdown: not called CC=4 SCAR=30.0
Pod undocumented
327 0 debug "[$alias] received shutdown signal, shutting down all plugins...\n";
328 0 my $mode = $_[ARG0];
329 0 ▶ $mode = 'smart' unless $mode; # fallback
Branch: 1 branch
BranchTrueFalseTotal
unless $mode 0 0 0
330 0 my $plugins_pending = 0;
331 0 $pluginmanager_shutdown = 1; # setting the global shutdown flag
332 # sending the shutdown signal to all plugins.
333 # then, when all plugins are shut down, the plugin manager will go away.
334 0 foreach my $plugin ( keys %{ $_[HEAP]->{plugins} } ) {
335 0 debug "shutting down $plugin, id: " . $_[HEAP]->{plugins}->{$plugin}->{id} . "\n";
336 0 POE::Kernel->post( $_[HEAP]->{plugins}->{$plugin}->{id}, 'shutdown', $mode, 'pluginmanager shutdown' );
337 0 $plugins_pending++;
338 }
339 0 ▶ if ( $plugins_pending == 0 ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($plugins_pending == 0) 0 0 0
340  
341 # no plugins pending, shut down immediately
342 0 POE::Kernel->alias_remove($alias);
343 0 POE::Kernel->yield( '_generate_event', 'plugin_manager_shutdown', 0 );
344 #POE::Kernel->delay("unregister_all", 1);
345 0 POE::Kernel->yield("unregister_all");
346 }
347 #$_[KERNEL]->delay("unregister_all", 1);
348 }
349  
350 0 ▶sub show_plugin_table {
Subroutine show_plugin_table: not called CC=2 SCAR=17.9
Pod undocumented
351  
352 # renamed from "show_plugin_list" to "show_plugin_table", since
353 # "list" implies we would send back a list, or an arrayref.
354 0 my $plugins = {};
355 0 foreach my $plugin ( keys %{ $_[HEAP]->{plugins} } ) {
356 0 $plugins->{$plugin}->{id} = $_[HEAP]->{plugins}->{$plugin}->{id};
357 0 $plugins->{$plugin}->{longname} = $_[HEAP]->{plugins}->{$plugin}->{longname};
358 0 $plugins->{$plugin}->{license} = $_[HEAP]->{plugins}->{$plugin}->{license};
359 0 $plugins->{$plugin}->{version} = $_[HEAP]->{plugins}->{$plugin}->{version};
360 0 $plugins->{$plugin}->{author} = $_[HEAP]->{plugins}->{$plugin}->{author};
361 }
362 0 POE::Kernel->yield( '_generate_event', 'plugin_table', $plugins );
363 0 return $plugins;
364 }
365  
366 0 ▶sub register {
Subroutine register: not called CC=2 SCAR=17.9
Pod undocumented
367 0 my $session = $_[ARG0];
368 0 ▶ if ( !$session ) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($session) 0 0 0
369 0 $session = $_[SENDER]->ID();
370 }
371 0 $_[HEAP]->{RecvSessions}->{$session} = 1;
372 0 POE::Kernel->refcount_increment($session);
373  
374 # incrementing the refcount, so that the session can't go away
375 # as long as we are sending events.
376  
377 }
378  
379 0 ▶sub unregister {
Subroutine unregister: not called CC=2 SCAR=17.9
Pod undocumented
380 0 my $session = $_[ARG0];
381 0 ▶ if ( !$session ) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($session) 0 0 0
382 0 $session = $_[SENDER]->ID();
383 }
384 0 delete $_[HEAP]->{RecvSessions}->{$session};
385 0 POE::Kernel->refcount_decrement($session);
386  
387 # now you can go away.
388 }
389 0 ▶sub unregister_all {
Subroutine unregister_all: not called CC=2 SCAR=17.9
Pod undocumented
390 0 foreach(keys %{$_[HEAP]->{RecvSessions}}){
391 0 $_[KERNEL]->refcount_decrement($_);
392 }
393 0 delete $_[HEAP]->{RecvSessions};
394 }
395  
396 0 ▶sub _generate_event {
Subroutine _generate_event: not called CC=2 SCAR=17.9
397  
398 #function to generate events. this events receives the event that is to be broad
399 #casted via ARG0 and ARG1 - $#_ are the arguments. then it iterates through
400 #the hash of registered sessions and sends the event to all sessions.
401 0 my $event = $_[ARG0];
402 0 my @arguments = @_[ ARG1 .. $#_ ];
403 0 ▶ while ( my ( $key, $value ) = each %{ $_[HEAP]->{RecvSessions} } ) {
Branch: 1 branch
BranchTrueFalseTotal
if (() = each %{$_[3]{"RecvSessions"};}) 0 0 0
404 0 POE::Kernel->post( $key, $event, @arguments );
405 }
406  
407 }
408 1 return 1;
409  
410 __END__
↑ Summary