Git::Repository::Plugin - Base class for Git::Repository plugins
version 1.301
package Git::Repository::Plugin::Hello; use Git::Repository::Plugin; our @ISA = qw( Git::Repository::Plugin ); sub _keywords { return qw( hello hello_gitdir ) } sub hello { return "Hello, git world!\n"; } sub hello_gitdir { return "Hello, " . $_[0]->git_dir . "!\n"; } 1;
Git::Repository::Plugin allows one to define new methods for Git::Repository, that will be imported in the Git::Repository namespace.
The SYNOPSIS provides a full example.
The documentation of Git::Repository describes how to load plugins with all the methods they provide, or only a selection of them.
Git::Repository::Plugin provides a single method:
Install all keywords provided in the Git::Repository namespace.
If called with an empty list, will install all available keywords.
When creating a plugin, the new keywords that are added by the plugin to Git::Repository must be returned by a _keywords() method.
_keywords()
Thanks to Todd Rinalo, who wanted to add more methods to Git::Repository, which made me look for a solution that would preserve the minimalism of Git::Repository.
After a not-so-good design using @ISA (so Git::Repository would inherit the extra methods), further discussions with Aristotle Pagaltzis and a quick peek at Dancer's plugin management helped me come up with the current design. Thank you Aristotle and the Dancer team.
Further improvements to the plugin system proposed by Aristotle Pagaltzis.
Philippe Bruhat (BooK) <book@cpan.org>
This software is copyright (c) 2013 by Philippe Bruhat (BooK).
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Git::Repository, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Git::Repository
CPAN shell
perl -MCPAN -e shell install Git::Repository
For more information on module installation, please visit the detailed CPAN module installation guide.