Name

Connector::Builtin::System::Exec

Description

Run a command using Proc::SafeExec.

Allows passing of arguments, stdin and env, each item of those lists is parsed as a template with the path arguments set in ARGS. In set mode the filename generated from content is set to FILE.

Usage

Configuration

my $con = Connector::Proxy::DBI->new({
    LOCATION => '/usr/bin/script',
    args     => ['--foo','ARGS.0'],
    content  => '[% payload %]',
    env => {
        BAR => 'bar'
    },
    chomp_output  => 1,
    timeout  => 2,
});

Parameters

args

List of parameters that are passed as arguments to the command.

timeout

Timeout to wait for the command in seconds, default is 5

chomp_output

stdin

A string or an array of strings to pipe as stdin to the command. Items are joined with a newline.

env

Expects a HashRef where the key is the name of the ENV variable.

content

A template string used to generate a tempfile when set mode is used.

The following call will create a tempfile with the content 'Hello World' and afterwards runs the systems copy command using the first path argument from the connector call as target filename.

my $con = Connector::Proxy::DBI->new({
    LOCATION => '/usr/bin/cp',
    args     => ['[% FILE %]', '[% ARGS.0 %]''],
    content  => '[% payload %]',
});
$conn->set('foo.txt', { payload => 'Hello World' } );