child_process.exec wrapper as reaction with additional abilities:
- replaces placeholders(
{something}
) in commands - reaction/continuation style passing
var reaction = require("shellreactions-exec")
reaction(c, next)
Example:
reaction({
cmd: "echo test",
waitForExit: true,
}, function(err, result){
// result == "test"
})
reaction({
cmd: "echo {value}",
cmdData: {
value: "test"
},
waitForExit: true
}, function(err, result){
// result == "test"
})
{
cmd: String || Array,
cmdOptions: Object,
cmdData: Object,
output: Stream,
waitForExit: Boolean,
dontExecute: Boolean
}
-
cmd
- This is the value passed tochidl_process.exec(value)
Any{placeholder}
will be replaced with the correspnding value from thecmdData
object. -
cmdData
- optional Object containing command related data. Keys from it are replaced incmd
with their values. -
cmdOptions
- optional If set will be directly passed tochild_process.exec(value, options)
-
output
- optional Stream ChildProcess stdout and stderr will be pipe'd tooutput
if present. -
waitForExit
- optional When set will wait the childProcess to close. The result of the reaction will be the combined stderr and stdout of the closed child process. If the child process exits with code different than0
, it is assumed as Error. -
dontExecute
- optional When set will not execute the producedcmd
, but will just callnext(false, false)
. Useful for debugging purposes ;)
function(err, result){
// err instanceof Error || null
// result instanceof String || instanceof ChildProcess
}
require("shellreactions-exec").exec(cmd [, options, next])
Examples:
var exec = require("shellreactions-exec").exec
exec("echo test", {}, function(err, result){
// result == "test"
})
exec("echo {value}", {value: "test"}, function(err, result){
// result == "test"
})
exec(["echo {value}","echo {value}2"], {value: "test"}, function(err, result){
// result is Array["test","test2"]
})
var options = {
cmdData: { value: "test" },
verbose: true
}
exec("echo {value}", options, function(){...})
var reaction = require("shellreactions-exec").exec("echo {value}")
reaction({value: "test"}, function(err, result){ ... })
Executes commands and waits them to finish by aggregating the stderr and stdout output.
require("shellreaactions-exec").start(cmd [, options, next])
Example:
var start = require("shellreactions-exec").start
start("echo test", {}, function(err, child){
child.on("data", function(){ ... })
child.on("close", function(code){
// ...
})
})
start("echo {value}",{value: "test"}, function(){ ... })
Executes commands and returns a ChildProcess as result of next
.
This doesn't waits for commands to finish.
require("shellreactions-exec").ssh_exec(remote, cmd [, options, next])
-
remote
- String The passed value will be used to get fromcmdData
the corresponding remote server
Example:
var ssh_exec = require("shellreactions-exec").ssh_exec
ssh_exec("remote", "echo test", {remote: "user@server"}, function(err, result){
// result == "test", from user@server via ssh
})
ssh_exec("target", "echo {value}", {target: "user@server", value:"test"}, function(err, result){
// result == "test", from user@server via ssh
})
Executes commands to cmdData[remote]
and waits for them to exit.
This is wrapper of exec
helper, however it executes all the commands via ssh
.
The helper generates a single command in form:
ssh {remote} '{commands}'
require("shellreactions-exec").ssh_start(remote, cmd [, cmdData, next])
Example:
var ssh_start = require("shellreactions-exec").ssh_start
ssh_start("remote", "echo test", {remote: "user@server"}, function(err, child){
child.on("data", ... )
child.on("close", ... )
})
Executes commands to cmdData[remote]
and returns wrapper ChildProcess.
This is similar to ssh_exec
helper, but doesn't waits for exit.
var ssh = require("shellreactions-exec").ssh
var async = require("async")
var servers = [
{
cmdData: {
remote: "user@server1",
cwd: "~/app"
}
},
{
cmdData: {
remote: "user@server2",
cwd: "~/app"
}
}
]
var updateAndRestart = ssh("remote",[
"cd {cwd}",
"git pull",
"service restart app.js"
])
async.each(servers, updateAndRestart, function(err){
console.log(err || "done")
})