smartshell/ts/smartshell.classes.smartshell.ts

159 lines
4.5 KiB
TypeScript
Raw Normal View History

// -- imports --
import * as plugins from './smartshell.plugins';
2018-07-30 14:08:14 +00:00
import { ShellEnv, IShellEnvContructorOptions, TExecutor } from './smartshell.classes.shellenv';
import { ShellLog } from './smartshell.classes.shelllog';
2017-03-08 15:51:02 +00:00
2018-07-30 14:08:14 +00:00
import * as cp from 'child_process';
import { Deferred } from '@pushrocks/smartpromise';
2017-03-08 15:51:02 +00:00
// -- interfaces --
/**
* interface for ExecResult
*/
export interface IExecResult {
exitCode: number;
stdout: string;
2017-03-08 15:51:02 +00:00
}
/**
* interface for streaming ExecResult
*/
export interface IExecResultStreaming {
childProcess: cp.ChildProcess;
finalPromise: Promise<IExecResult>;
2018-10-28 18:18:42 +00:00
kill: () => void;
}
// -- SmartShell --
2017-03-08 15:51:02 +00:00
export class Smartshell {
2019-05-19 20:41:20 +00:00
public shellEnv: ShellEnv;
public smartexit = new plugins.smartexit.SmartExit();
constructor(optionsArg: IShellEnvContructorOptions) {
this.shellEnv = new ShellEnv(optionsArg);
2018-11-26 16:55:15 +00:00
}
2017-03-10 19:14:40 +00:00
/**
* executes a given command async
* @param commandStringArg
*/
2018-07-30 14:08:14 +00:00
private async _exec(
commandStringArg: string,
silentArg: boolean = false,
strictArg = false,
streamingArg = false
): Promise<IExecResult | IExecResultStreaming> {
// flow control promises
const done = plugins.smartpromise.defer<IExecResult | IExecResultStreaming>();
const childProcessEnded = plugins.smartpromise.defer<IExecResult>();
// build commandToExecute
2018-07-30 14:08:14 +00:00
let commandToExecute = commandStringArg;
commandToExecute = this.shellEnv.createEnvExecString(commandStringArg);
const spawnlogInstance = new ShellLog();
const execChildProcess = cp.spawn(commandToExecute, [], {
shell: true,
2018-10-28 18:12:15 +00:00
env: process.env,
2019-05-27 13:30:52 +00:00
detached: false
});
2019-05-19 20:41:20 +00:00
this.smartexit.addProcess(execChildProcess);
2018-07-30 14:08:14 +00:00
execChildProcess.stdout.on('data', data => {
if (!silentArg) {
spawnlogInstance.logToConsole(data);
}
spawnlogInstance.addToBuffer(data);
});
2018-07-30 14:08:14 +00:00
execChildProcess.stderr.on('data', data => {
if (!silentArg) {
spawnlogInstance.logToConsole(data);
}
spawnlogInstance.addToBuffer(data);
});
2018-07-30 14:08:14 +00:00
if (streamingArg) {
done.resolve({
childProcess: execChildProcess,
2018-10-28 18:18:42 +00:00
finalPromise: childProcessEnded.promise,
kill: () => {
// this notation with the - kills the whole process group
process.kill(-execChildProcess.pid);
}
});
}
2017-03-10 21:08:04 +00:00
2018-07-30 14:08:14 +00:00
execChildProcess.on('exit', (code, signal) => {
2019-05-19 20:41:20 +00:00
this.smartexit.removeProcess(execChildProcess);
2018-07-30 14:08:14 +00:00
if (strictArg && code === 1) {
done.reject();
}
const execResult = {
exitCode: code,
stdout: spawnlogInstance.logStore.toString()
2018-07-30 14:08:14 +00:00
};
2018-07-30 14:08:14 +00:00
if (!streamingArg) {
done.resolve(execResult);
}
childProcessEnded.resolve(execResult);
});
const result = await done.promise;
return result;
2018-07-30 14:08:14 +00:00
}
2018-07-30 14:08:14 +00:00
async exec(commandStringArg: string): Promise<IExecResult> {
return (await this._exec(commandStringArg, false)) as IExecResult;
2018-07-30 14:08:14 +00:00
}
2017-03-10 21:08:04 +00:00
/**
* executes a given command async and silent
* @param commandStringArg
2017-03-10 21:08:04 +00:00
*/
2018-07-30 14:08:14 +00:00
async execSilent(commandStringArg: string): Promise<IExecResult> {
return (await this._exec(commandStringArg, true)) as IExecResult;
2018-07-30 14:08:14 +00:00
}
2017-03-10 21:08:04 +00:00
2017-03-11 01:36:27 +00:00
/**
* executes a command async and strict, meaning it rejects the promise if something happens
2017-03-11 01:36:27 +00:00
*/
2018-07-30 14:08:14 +00:00
async execStrict(commandStringArg: string): Promise<IExecResult> {
return (await this._exec(commandStringArg, true, true)) as IExecResult;
}
2017-03-11 01:36:27 +00:00
2017-03-10 21:08:04 +00:00
/**
* executes a command and allows you to stream output
2017-03-10 21:08:04 +00:00
*/
2018-07-30 14:08:14 +00:00
async execStreaming(
commandStringArg: string,
silentArg: boolean = false
): Promise<IExecResultStreaming> {
return (await this._exec(commandStringArg, silentArg, false, true)) as IExecResultStreaming;
2018-07-30 14:08:14 +00:00
}
2018-07-30 14:08:14 +00:00
async execStreamingSilent(commandStringArg: string) {
return (await this.execStreaming(commandStringArg, true)) as IExecResultStreaming;
2018-07-30 14:08:14 +00:00
}
/**
* executes a command and returns promise that will be fullfilled once an putput line matches RegexArg
* @param commandStringArg
* @param regexArg
*/
2018-07-30 14:08:14 +00:00
async execAndWaitForLine(commandStringArg: string, regexArg: RegExp, silentArg: boolean = false) {
let done = plugins.smartpromise.defer();
let execStreamingResult = await this.execStreaming(commandStringArg, silentArg);
2018-07-30 14:08:14 +00:00
execStreamingResult.childProcess.stdout.on('data', (stdOutChunk: string) => {
if (regexArg.test(stdOutChunk)) {
done.resolve();
2017-03-10 21:08:04 +00:00
}
});
return done.promise;
2018-07-30 14:08:14 +00:00
}
2018-07-30 14:08:14 +00:00
async execAndWaitForLineSilent(commandStringArg: string, regexArg: RegExp) {
this.execAndWaitForLine(commandStringArg, regexArg, true);
2018-07-30 14:08:14 +00:00
}
2017-03-10 21:08:04 +00:00
}