string::rewriteprefix(3) [mojave man page]

String::RewritePrefix(3)				User Contributed Perl Documentation				  String::RewritePrefix(3)

NAME

       String::RewritePrefix - rewrite strings based on a set of known prefixes

VERSION

       version 0.007

SYNOPSIS

	 use String::RewritePrefix;
	 my @to_load = String::RewritePrefix->rewrite(
	   { '' => 'MyApp::', '+' => '' },
	   qw(Plugin Mixin Addon +Corporate::Thinger),
	 );

	 # now you have:
	 qw(MyApp::Plugin MyApp::Mixin MyApp::Addon Corporate::Thinger)

       You can also import a rewrite routine:

	 use String::RewritePrefix rewrite => {
	   -as => 'rewrite_dt_prefix',
	   prefixes => { '' => 'MyApp::', '+' => '' },
	 };

	 my @to_load = rewrite_dt_prefix( qw(Plugin Mixin Addon +Corporate::Thinger));

	 # now you have:
	 qw(MyApp::Plugin MyApp::Mixin MyApp::Addon Corporate::Thinger)

METHODS

   rewrite
	 String::RewritePrefix->rewrite(\%prefix, @strings);

       This rewrites all the given strings using the rules in %prefix.	Its keys are known prefixes for which its values will be substituted.
       This is performed in longest-first order, and only one prefix will be rewritten.

       If the prefix value is a coderef, it will be executed with the remaining string as its only argument.  The return value will be used as the
       prefix.

AUTHOR

       Ricardo Signes <rjbs@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2013 by Ricardo Signes.

       This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

perl v5.18.2							    2013-10-15						  String::RewritePrefix(3)

App::Cmd::Setup(3pm)					User Contributed Perl Documentation				      App::Cmd::Setup(3pm)

NAME

       App::Cmd::Setup - helper for setting up App::Cmd classes

VERSION

       version 0.318

OVERVIEW

       App::Cmd::Setup is a helper library, used to set up base classes that will be used as part of an App::Cmd program.  For the most part you
       should refer to the tutorial for how you should use this library.

       This class is useful in three scenarios:

       when writing your App::Cmd subclass
	   Instead of writing:

	     package MyApp;
	     use base 'App::Cmd';

	   ...you can write:

	     package MyApp;
	     use App::Cmd::Setup -app;

	   The benefits of doing this are mostly minor, and relate to sanity-checking your class.  The significant benefit is that this form
	   allows you to specify plugins, as in:

	     package MyApp;
	     use App::Cmd::Setup -app => { plugins => [ 'Prompt' ] };

	   Plugins are described in App::Cmd::Tutorial and App::Cmd::Plugin.

       when writing abstract base classes for commands
	   That is: when you write a subclass of App::Cmd::Command that is intended for other commands to use as their base class, you should use
	   App::Cmd::Setup.  For example, if you want all the commands in MyApp to inherit from MyApp::Command, you may want to write that package
	   like this:

	     package MyApp::Command;
	     use App::Cmd::Setup -command;

	   Do not confuse this with the way you will write specific commands:

	     package MyApp::Command::mycmd;
	     use MyApp -command;

	   Again, this form mostly performs some validation and setup behind the scenes for you.  You can use "base" if you prefer.

       when writing App::Cmd plugins
	   App::Cmd::Plugin is a mechanism that allows an App::Cmd class to inject code into all its command classes, providing them with utility
	   routines.

	   To write a plugin, you must use App::Cmd::Setup.  As seen above, you must also use App::Cmd::Setup to set up your App::Cmd subclass if
	   you wish to consume plugins.

	   For more information on writing plugins, see App::Cmd::Manual and App::Cmd::Plugin.

AUTHOR

       Ricardo Signes <rjbs@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2012 by Ricardo Signes.

       This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

perl v5.14.2							    2012-05-05						      App::Cmd::Setup(3pm)