The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Proc-Async-0.2.0
River stage zero No dependents
2 ++
/ procasync

NAME

procasync - script for testing Proc::Async module

SYNOPSIS

   procasync -start '<program-name> [<args...>]'
   procasync -start <program-name> -start '<args>'

   procasync -jobid [-status] [-stdout] [-stderr] [-wdir] [-rlist] [-done]
   procasync -jobid [-result <file-name>]

   procasync -help
   procasync -version

DESCRIPTION

A simple script that tests all functions of the Proc::Async module.

  • it can start an external program, together with its arguments:

       procasync -start 'date -u'
   procasync -start date -start -u

      ID of the started job 'date' '-u':
      /tmp/q4Gi2VNroQ

  • it can show the status of started external program

       procasync -jobid /tmp/q4Gi2VNroQ -status

      Status of /tmp/q4Gi2VNroQ:
      completed, exit code 0, completed at Sat May 18 18:54:24 2013, elapsed time 0 seconds

  • it can fetch what was written to the standard output streams by the started external program

       procasync -jobid /tmp/q4Gi2VNroQ -stdout -stderr

      STDOUT of the job '/tmp/q4Gi2VNroQ':
      Sat May 18 15:54:24 UTC 2013
      STDERR of the job '/tmp/q4Gi2VNroQ':

  • it can show the working directory and the existing result names of the started external program

       procasync -jobid /tmp/q4Gi2VNroQ -wdir -rlist

      Working directory for the job '/tmp/q4Gi2VNroQ':
      /tmp/q4Gi2VNroQ
      List of files with results for the job '/tmp/q4Gi2VNroQ':
      a.file
      b.file

  • it can fetch a result itself

       procasync -jobid /tmp/q4Gi2VNroQ -result a.file
   procasync -jobid /tmp/q4Gi2VNroQ -result b.file

  • it can show whether the external program finished or not

       procasync -jobid /tmp/q4Gi2VNroQ -done

      Process finished

  • it can kill the running external program and clean up its results

       procasync -jobid /tmp/q4Gi2VNroQ -kill -clean

      Killing job '/tmp/q4Gi2VNroQ': failure
      Cleaning data for the job /tmp/q4Gi2VNroQ:
      4 files for job /tmp/q4Gi2VNroQ have been deleted.

OPTIONS

General options

-help

Print documentation and exits.

-version

Print the version and exits.

-quiet

Do not pollute STDERR with decorative message.