Module::Provision::TraitFor::CreatingDistributions - Create distributions
use Moose; extends 'Module::Provision::Base'; with 'Module::Provision::TraitFor::CreatingDistributions';
Create distributions using either Git or SVN for the VCS
Requires these attributes to be defined in the consuming class; appbase, appldir, builder, exec_perms, homedir, incdir, project_file, render_templates, stash, testdir, and vcs
appbase
appldir
builder
exec_perms
homedir
incdir
project_file
render_templates
stash
testdir
vcs
Defines the following attributes;
Which text editor to use. It is a read only, lazily evaluated, simple string that cannot be null. It defaults to the editor configuration variable
editor
$self->build_distribution( $verbose );
Builds a CPAN distribution tarball
$self->clean_distribution( $verbose );
Cleans up after a distribution build
$exit_code = $self->cover;
Returns the exit code. Runs the distributions coverage tests
$self->create_directories;
Creates the required directories for the new distribution. If subclassed this method can be modified to include additional directories
$exit_code = $self->dist;
The distributions main module name is specified on the command line
$self->dist_post_hook;
Runs after the new distribution has been created. If subclassed this method can be modified to perform additional actions after the templates have been rendered
$self->dist_pre_hook;
Runs before the new distribution is created. If subclassed this method can be modified to perform additional actions before the project directories are created
$exit_code = $self->edit_project;
The project file is one of; dist.ini, Build.PL, or Makefile.PL in the current directory
$markdown_file = $self->generate_metadata( $create_flag );
Generates the distribution metadata files. If the create_flag is TRUE returns the name of the README.md file
TRUE
$exit_code = $self->metadata;
Calls "generate_metadata" with the create flag set to FALSE
FALSE
$exit_code = $self->prove;
Returns the exit code. Runs the distributions tests. If a specific test file is given on the command line, run only that that test
$exit_code = $self->select_project
Use from the shell like this:
cd $(module_provision -q select_project 2>&1 1>/dev/tty)
Display a list of projects, select one and edit it's project file
$exit_code = $self->show_tab_title;
Print the tab title for the current project to STDOUT
STDOUT
None
There are no known incompatibilities in this module
There are no known bugs in this module. Please report problems to the address below. Patches are welcome
Larry Wall - For the Perl programming language
Peter Flanigan, <pjfl@cpan.org>
<pjfl@cpan.org>
Copyright (c) 2017 Peter Flanigan. All rights reserved
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic
This program is distributed in the hope that it will be useful, but WITHOUT WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE
To install Module::Provision, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Module::Provision
CPAN shell
perl -MCPAN -e shell install Module::Provision
For more information on module installation, please visit the detailed CPAN module installation guide.