Nephia::Plugin - Documentation for Plugins
You may use plugins as followings.
use Nephia plugins => ['Response::YAML', 'Auth::Twitter' => { consumer_key => ..., }];
or
BEGIN { use Nephia; nephia_plugin 'Response::YAML', 'Response::XML'; }
Basic rule is namespace of new module must begins in "Nephia::Plugin::".
If you want to export subroutines, those name must begin in lower alphabetic chars, and it must not be "import" and "load".
import() and load() will execute when plugin is loaded.
And, you can use context() function for set/get some state among request.
For example.
package Nephia::Plugin::Bark; use strict; use warnings; our @EXPORT = qw/bark barkbark/; sub import { my ($class) = @_; ... ### Execute when plugin is loaded. } sub load { my ($class, $app_class, $plugin_option) = @_; ### Execute after import() context(sound => $plugin_option->{sound}); # set sound into context } sub bark () { my $sound = context('sound'); # get sound from context return [200, [], [$sound]]; } sub barkbark (@) { my $sound = context('sound'); # get sound from context return [200, [], [join(' ', $sound, @_)]]; } 1;
You can use plugin in above, as like followings.
package Your::App; use Nephia plugins => [Bark => {sound => 'Bark!'}]; path '/bark' => sub { bark; # 'Bark!' }; path '/barkbark' => sub { barkbark 'hoge', 'fuga'; # 'Bark hoge fuga' };
Rewrite Plack env when build request.
Rewrite response object after response was built.
Rewrite content before responde response.
To install Nephia, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Nephia
CPAN shell
perl -MCPAN -e shell install Nephia
For more information on module installation, please visit the detailed CPAN module installation guide.