Jonathan Rockway > AnyEvent-Subprocess-1.102912 > AnyEvent::Subprocess::DefaultDelegates

Download:
AnyEvent-Subprocess-1.102912.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  1
View/Report Bugs
Module Version: 1.102912   Source  

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.

syntax highlighting: