Module::Pluggable::Ordered - Call module plugins in a specified order
package Foo; use Module::Pluggable::Ordered; Foo->call_plugins("some_event", @stuff);
Meanwhile, in a nearby module...
package Foo::Plugin::One; sub some_event_order { 99 } # I get called last of all sub some_event { my ($self, @stuff) = @_; warn "Hello!" }
And in another:
package Foo::Plugin::Two; sub some_event_order { 13 } # I get called relatively early sub some_event { ... }
This module behaves exactly the same as Module::Pluggable, supporting all of its options, but also mixes in the call_plugins method to your class. call_plugins acts a little like Class::Trigger; it takes the name of a method, and some parameters. Let's say we call it like so:
Module::Pluggable
call_plugins
Class::Trigger
__PACKAGE__->call_plugins("my_method", @something);
call_plugins looks at the plugin modules found using Module::Pluggable for ones which provide my_method_order. It sorts the modules numerically based on the result of this method, and then calls $_->my_method(@something) on them in order. This produces an effect a little like the System V init process, where files can specify where in the init sequence they want to be called.
my_method_order
$_->my_method(@something)
The package option can be used to put the pluggability into another package, to be used for modules building on the functionality of this one.
package
It also provides the only and except options.
only
except
# will only return the Foo::Plugin::Quux plugin use Module::Pluggable::Ordered only => [ "Foo::Plugin::Quux" ]; # will not return the Foo::Plugin::Quux plugin use Module::Pluggable::Ordered except => [ "Foo::Plugin::Quux" ];
Module::Pluggable, Class::Trigger
Simon Cozens, <simon@cpan.org>; please report bugs via the CPAN Request Tracker.
Copyright 2004 by Simon Cozens
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Module::Pluggable::Ordered, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Module::Pluggable::Ordered
CPAN shell
perl -MCPAN -e shell install Module::Pluggable::Ordered
For more information on module installation, please visit the detailed CPAN module installation guide.