Module::Install::TemplateInstallPath - templatize installation paths
use inc::Module::Install; name 'Your-Module'; all_from 'lib/Your/Modulepm'; template_install_path( \%options );
This Module::Install plugin rewrites command line arguments of the form
<variable>=<template>
where <variable> is one of
<variable>
INSTALL_BASE PREFIX LIB
(case is not significant and <variable> is rewritten in upper case).
Any of the following tokens found in <template> is replaced by its associated value:
<template>
%n
The name of the module
%v
The version of the module
The recognized tokens may be augmented or overridden.
template_install_path( \%options );
This function will process the command line. It should be run after information about the module is provided to Module::Install (e.g. via name() or version(), etc), but before WriteAll (or equivalent).
name()
version()
WriteAll
The following options are recognized:
This specifies a template to be used if the value passed on the command line is unchanged after processing (implying it contained no template tokens).
If the catdir option is true, the results of filling in this template are appended to the value on the commandline using File::Spec::Functions::catdir.
See template for what this does. It defaults to true.
This specifies a hash containing tokens and their values. Tokens must be the exact string which will be replaced. Token values may be a scalar or a code reference. In the latter case they will be passed a reference to the Module::Install object. For example, here is how the default tokens are specified:
{ '%n' => sub { $_[0]->name }, '%v' => sub { $_[0]->version }, }
To override a token, just provide a new value for it. To delete a token, set it to the undefined value.
%s: no value specified
The named variableC was specified without a value.
No bugs have been reported.
Please report any bugs or feature requests to bug-module-install-graft@rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Module-Install-TemplateInstallPath.
bug-module-install-graft@rt.cpan.org
Module::Install
Version 0.01
Copyright (c) 2011 The Smithsonian Astrophysical Observatory
Module::Install::TemplateInstallPath is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.
Diab Jerius <djerius@cpan.org>
To install Module::Install::TemplateInstallPath, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Module::Install::TemplateInstallPath
CPAN shell
perl -MCPAN -e shell install Module::Install::TemplateInstallPath
For more information on module installation, please visit the detailed CPAN module installation guide.