NAME
MooX::Ipc::Cmd - Moo role for issuing commands, with debug support, and signal handling
VERSION
version 1.1.1
SYNOPSIS
This role provides the ability to capture system calls, and to execute system calls.
Features
debug switch
Prints output in realtime, in debug mode
Handles signals, and kills via signal if configured too.
Uses Log::Any for logging. If in debug mode, will log output of commands, execution line
Command line option
package Moo_Package;
use Moo;
use MooX::Options; # required before with statement
with qw(MooX::Ipc::Cmd);
has '+_cmd_kill' => (default=>1); # override default
sub run {
my $self=shift
$self->_system(['cmd']);
my @result=$self->_capture(['results']);
}
1;
package main
use Log::Any::Adapter('Stdout'); #setup Log::Any::Adapter;
my $app=Moo_Package->new_with_options(debug=>0,_cmd_kill=>0); #command line processing
my $app=Moo_Package->new(debug=>0,_cmd_kill=>0); #no command line processing
1;
ATTRIBUTES
_cmd_kill
If set to 1 will send the propgate signal when cmd exits due to signal.
Reader: _cmd_kill
Default: 1
mock
Mocks the cmd, does not run
Reader: mock
Default: 0
Command line option, via MooX::Options
METHODS
_system(\@cmd', /%opts);
Runs a command like system call, with the output silently dropped, unless debug is on
- Params:
-
$cmd : arrayref of the command to send to the shell
- %opts
-
valid_exit => [0] - exits to not throw exception, defaults to 0
- Returns:
-
exit code
- Exception
-
Throws an error when case dies, will also log error using log::any category _cmd
_capture(\@cmd',\%opts); Runs a command like qx call. Will display cmd executed
AUTHOR
Eddie Ash <eddie+cpan@ashfamily.net>
COPYRIGHT AND LICENSE
This software is copyright (c) 2015 by Edward Ash.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.