index :: system

system.command

aliases: [system.cmd]

run commands with pipes on Unix and Windows

available since version: 0.9.8

---

information

Note: this is simplest unix shell simulation, do not expect too much from it, if you need powerfull shell capabilities - write shell script and run it. The pipe symbol should be separated by whitespaces.

arguments:

• ARGS execution program chain
  type: list
  

methods:

• stdin run the program with given input values
  parameters:
  • [ARGS] the input values
    type: list
    
• terminate terminate the running process
  

properties:

• @args Get/set execution program chain
  type: list
  

• @mode Get/set output processing mode. 'pd': output each output line as Pd atom list, 'str': output whole as data:string, 'lines': output each output line as data:string, 'bytes': output as byte stream
  type: symbol
  enum: pd, str, lines, bytes
  default: pd
  

• @pwd Get/set process working directory
  type: symbol
  

• @stderr Get/set capture stderr
  type: bool
  default: 1
  

• @stdout Get/set capture stdout
  type: bool
  default: 1
  

• @t Get/set period to check program output
  type: int
  units: ms
  range: 5..500
  default: 100
  

inlets:

• run the program
  type: control

outlets:

• int: output process exit code
  type: control
• stdout output, format depends from @mode
  type: control

keywords:

system execute pipe command shell

Authors: Serge Poltavsky

License: GPL3 or later