NAME
AnyEvent::Subprocess::DefaultDelegates - sets up default delegate name/builder mappings
VERSION
version 1.102912
DELEGATES PROVIDED
Handle
Provides connections to an arbitrary filehandle / fd / pipe / socket / etc.
See AnyEvent::Subprocess::Job::Delegate::Handle
StandardHandles
Provides connections to the child's STDIN/STDOUT/STDERR handles. Delegates are named stdin/stdout/stderr. Optional arg prefix adds a prefix string to the delegates' names.
CommHandle
Provides a (bidirectional) socket to be shared between the child and parent. Optional arg name provides delegate name (so you can have more than one, if desired).
Optional arg name controls name; defaults to 'comm.
Pty
Provides the child with stdin and stdout attached to a pseudo-tty, and provides the parent with a delegate to control this. Optional arg stderr controls whether or not the child's stderr will also go to the pty; defaults to no.
Optional arg name controls name; defaults to 'pty'.
CompletionCondvar
Supplies a delegate that is a AnyEvent::Condvar that is sent the child exit information ("Done class") when the child process exits.
Callback
Sets up an AnyEvent::Subprocess::Job::Delegate::Callback delegate. Optional argument name controls callback instance name; defaults to 'callback'.
Capture
Captures a handle. Mandatory arg handle is the name of the handle delegate to capture. The handle must be readable by the parent. (i.e., a socket or a pipe from the child to the parent.)
Delegate is named '[handle name]_capture'.
(Note that you should not use the captured handle for reading anymore; this delegate will steal all input. Captured output is returned in via a delegate in the "done class".)
MonitorHandle
Calls a list of coderefs whenever a line is read from a handle.
PrintError
Delegate that calls a callback in the child to print the exception (if any) the child throws.
Use WithResult if you want to actually get the exception in the parent.
Timeout
Kill the subprocess with a signal kill_with
after timeout
seconds elapse. See AnyEvent::Subprocess::Job::Delegate::Timeout.
SEE ALSO
See the test suite to see all of these shortcuts in use.
AUTHOR
Jonathan Rockway <jrockway@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2011 by Jonathan Rockway.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.