Tom Molesworth
and 1 contributors

NAME

IO::AsyncX::System - fork+exec, capturing STDOUT/STDERR

VERSION

version 0.003

SYNOPSIS

 use feature qw(say);
 use IO::Async::Loop;
 use IO::AsyncX::System;
 my $loop = IO::Async::Loop->new;
 $loop->add(
  my $system = IO::AsyncX::System->new
 );
 my ($code, $stdout, $stderr) = $system->run([qw(ls)])->get;
 say for @$stdout;

DESCRIPTION

Intended as a replacement for "system" in IO::Async-using code. Provides a single "run" method which will fork+exec (via IO::Async::Process), capturing STDOUT/STDERR, and returning a Future holding the exit code and output.

METHODS

run

Takes a single parameter defining the command to run:

 $system->run(['ls']);

plus optional named parameters:

  • utf8 - interprets all input/output as UTF-8, so STDOUT/STDERR will be returned as arrayrefs containing Perl strings rather than raw bytes

  • binary - the reverse of utf8 (and the default)

  • stdin - an arrayref of data to pass as STDIN

  • timeout - kill the process if it doesn't complete within this many seconds

Returns a Future which resolves to the exit code, STDOUT and STDERR arrayrefs:

 $system->run([...]) ==> ($exitcode, $stdout_arrayref, $stderr_arrayref)

STDIN/STDOUT/STDERR are arrayrefs split by line. In binary mode, they will hold a single element each.

SEE ALSO

INHERITED METHODS

IO::Async::Notifier

add_child, adopt_future, can_event, children, configure, configure_unknown, debug_printf, get_loop, invoke_error, invoke_event, loop, make_event_cb, maybe_invoke_event, maybe_make_event_cb, new, notifier_name, parent, remove_child, remove_from_parent

AUTHOR

Tom Molesworth <cpan@perlsite.co.uk>

LICENSE

Copyright Tom Molesworth 2015. Licensed under the same terms as Perl itself.