NAME

Command::Template::Instance

SYNOPSIS

            

              
              
use Command::Template::Instance;
my @template = qw{ ls [options=-l] <dir> };
my $instance = Command::Template::Instance->new(@template);
# @c1 = qw< ls -l / >
my @c1 = $ct->generate(dir => '/');
# @c2 = qw< ls -la / >
my @c2 = $ct->generate(dir => '/etc', options => '-la');
# @c3 = @c4 = qw< ls /usr/bin >
my @c3 = $ct->generate(dir => '/usr/bin', options => undef);
my @c4 = $ct->generate(dir => '/usr/bin', options => []);
# @c5 = qw< ls -l -a /usr/bin >
my @c5 = $ct->generate(dir => '/usr/bin', options => [qw< -l -a >]);
            
          

DESCRIPTION

This class implements the main expansion mechanism for command templates.

INTERFACE

defaults

            

              
              
my $href = $obj->defaults;
$obj->defaults({...});
            
          

Get or set the default bindings for expansion. Returns or accepts a hash reference with key/value pairs representing the default bindings.

generate

            

              
              
my @command = $obj->generate(%bindings); # OR
my $command = $obj->generate(%bindings);
            
          

Expand the template according to the provided bindings and, if set, the default ones.

Returns a list of strings in list context, a reference to an array containing the list otherwise.

new

            

              
              
my $instance = Command::Template::Instance(@template);
            
          

Generate a new object, suitable for serially expand the provided @template.

template

            

              
              
my $aref = $obj->template;
            
          

Get a copy of the template used for the expansion.

ANYTHING ELSE (INCLUDING AUTHOR, COPYRIGHT AND LICENSE)

See documentation for Command::Template.