Manfred Stock

NAME

App::Scaffolder::Command - Base class for App::Scaffolder commands

VERSION

version 0.002000

SYNOPSIS

        package App::Scaffolder::Command::mycommand;
        use parent qw(App::Scaffolder::Command);

        sub get_dist_name {
                return 'App-Scaffolder-MyDist';
        }

        1;

DESCRIPTION

App::Scaffolder::Command is a base class for App::Scaffolder commands. Among other things, it provides access to the templates that belong to the command and provides the execute method which handles some basic parameters like --list and also evaluates the selected template.

contains_base_args

Check if options contain a base argument like --list or --create-template-dir.

Result

True if yes, false otherwise.

get_options

Getter for the options. Should be implemented by subclasses.

Result

A list with additional options for the command.

get_template_dirs

Getter for the directories where templates are searched. Uses File::HomeDir and File::ShareDir using the distribution name and appends the command name to the directory. If get_extra_template_dirs returns a non-empty list, this will be put between these two default directories.

Result

A list with the directories.

get_extra_template_dirs

Method to insert additional template directories between the 'local', File::HomeDir-based directory and the 'global', File::ShareDir-based one into the search path. By default, this takes the directories from the SCAFFOLDER_TEMPLATE_PATH environment variable.

Parameters

This method expects positional parameters.

command

Name of the command template directories should be returned for.

Result

A potentially empty list with the additional directories.

get_templates

Reads the template directories and creates a App::Scaffolder::Template object for each template that is found.

Result

A hash reference with the found templates.

get_template

Get the template with a given name.

Parameters

This method expects positional parameters.

name

Name of the template.

Result

The App::Scaffolder::Template with the given name if it exists, an exception otherwise.

get_target

Extract the target directory from the options.

Parameters

This method expects positional parameters.

opt

Options as passed to execute.

Result

A Path::Class::Dir object with the target directory.

get_variables

Get variables that should be passed to templates. Should be overridden by subclasses.

Result

A hash reference with template variables.

get_dist_name

Getter for the distribution name. Must be implemented by subclasses.

Result

The name of the distribution the command belongs to.

execute

Execute the command using the given command line options.

Result

Nothing on success, an exception otherwise.

AUTHOR

Manfred Stock <mstock@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by Manfred Stock.

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